# Account management
Source: https://docs.brightdata.com/account-management-quickstart





# Web MCP quickstart
Source: https://docs.brightdata.com/ai/mcp-server-quickstart

Get started with the Bright Data Web MCP server. Configure your API key, connect a compatible client and run your first scrape in a few minutes.

<Card title="Building an AI startup?" href="https://brightdata.com/ai/ai-startups-program" icon="rocket-launch">
  You might be eligible for our Startup Program. Get fully funded access to the infrastructure you're reading about right now (up to \$20K value).
</Card>


# Archive
Source: https://docs.brightdata.com/archive-quickstart





# Browser API
Source: https://docs.brightdata.com/browser-api-quickstart





# Browser extension
Source: https://docs.brightdata.com/browser-extension-quickstart





# Bright Data CLI quickstart
Source: https://docs.brightdata.com/cli-quickstart





# Crawl API quickstart
Source: https://docs.brightdata.com/crawl-api-quickstart





# Managed services quickstart
Source: https://docs.brightdata.com/custom-dataset-quickstart





# Datacenter
Source: https://docs.brightdata.com/data-center-quickstart





# Dataset marketplace
Source: https://docs.brightdata.com/dataset-marketplace-quickstart





# Welcome to Bright Data
Source: https://docs.brightdata.com/introduction

Bright Data's web data platform: residential, mobile and ISP proxies, 1000+ pre-built scrapers, a dataset marketplace and AI-ready APIs.

Bright Data is a web data platform that helps you collect, process and scale access to public web data. It brings a 400M+ IP proxy network, 1000+ pre-built scrapers, ready-made datasets and AI-ready APIs together under one account, so you can focus on using data instead of building and maintaining scraping infrastructure.

<Note>
  [Start now](https://brightdata.com/?hs_signup=1\&utm_source=docs) with **5,000 free credits per month**. No credit card required. See the [free tier](/general/account/billing-and-pricing/free-tier).

  Bright Data will also match your **first account deposit up to \$500**.
</Note>

## Who this platform is for

Bright Data is designed for:

* Developers building data-driven applications
* Data teams collecting large-scale web data
* AI teams needing real-time public web information
* Businesses that require reliable and scalable web access

<Card>
  <CardGroup>
    <Card title="Proxy infrastructure" icon="globe" href="/proxy-networks">
      Access any website, anywhere. Use a global network of **400M+ monthly residential IPs** with **99.99% uptime** to navigate the web reliably and at scale, while keeping data collection ethical and compliant.
    </Card>

    <Card title="Web access APIs" icon="bolt" href="/scraping-automation">
      Automate web data collection through APIs that handle unblocking, browser automation, crawling and search. Focus on using the data, not managing scraping infrastructure.
    </Card>

    <Card title="Data feeds" icon="table" href="/datasets">
      Access ready-to-use, structured datasets without building or maintaining scrapers. Data feeds deliver real-time or historical web data with zero infrastructure overhead.
    </Card>

    <Card title="MCP server" icon="microchip-ai" href="/ai/mcp-server/overview">
      Power AI systems with live web intelligence. The MCP server connects your models to real-time public web data without scraper management or custom pipelines.
    </Card>
  </CardGroup>
</Card>

<Info>
  For billing, account settings and user access management, visit the <a href="/general/account/overview">Account management</a> section.
</Info>

<Card title="Service status" icon="circle-check" href="https://brightdata.com/network-status">
  View real-time service status and uptime for all Bright Data products.
</Card>


# ISP
Source: https://docs.brightdata.com/isp-quickstart





# Proxy Manager
Source: https://docs.brightdata.com/proxy-manager-quickstart





# Browser extension configuration
Source: https://docs.brightdata.com/proxy-networks/browser-extension/configuration

How to configure the Bright Data Proxy Browser Extension: update zone, country, custom headers, and proxy settings from the setup page.

How can I change the extension's settings?

Open [Extension setup page](https://brightdata.com/cp/bext) and change settings such as Zone, Country, Custom Headers, or anything necessary. Click 'Apply' when done, and your extension will be updated with the new setup.

<img alt="Browser Extension Configuration" />


# Browser extension FAQs
Source: https://docs.brightdata.com/proxy-networks/browser-extension/faqs

FAQs about the Bright Data Proxy Browser Extension (port 44445), including login issues, SSL certificate compatibility and Chrome setup steps.

<AccordionGroup>
  <Accordion title="Why does the login message keeps appearing?">
    Bright Data uses cookies to remember your login credentials in order to keep your user experience at its best. If you are using third-party extensions that regularly removes cookies from your device then you'll see the login message quite often.
  </Accordion>

  <Accordion title="I upgraded to new bright data SSL certificate and extension stopped working">
    The browser extension supports the new SSL certificate on port `44445`. Make sure you connect on port `44445` with `brightdata_root_ca_44445.crt`. See the [root certificate migration guide](/general/account/ssl-certificate-migration).
  </Accordion>

  <Accordion title="How can you avoid getting login message?">
    In the top right corner you can click on "Delete Cookies". This will delete all the cookies from your device **except** Bright Data's and Google's cookies so you could keep using Bright Data with no interruptions and keep your browser extensions alive.

    <img alt="delete-cookies.png" />
  </Accordion>

  <Accordion title="Does the extension work in incognito mode?">
    > **Yes!**

    Bright Data extension works on both regular and incognito mode.

    To enable incognito support on Chrome, do the following:

    * Type **chrome://extensions** in the chrome address bar
    * Make sure **Allow in incognito** is checked

      <img alt="allow-in-incognito.gif" />
  </Accordion>

  <Accordion title="When should I use custom headers?">
    Custom headers are mainly meant to make the request more specific. You should use it in cases when you need to pass custom parameters with your requests to the target site. Every header should contain Name & Value and you can add as many headers as you like.
  </Accordion>

  <Accordion title="Why am I getting an 'error' message when I setup the extension?">
    There are few possible reasons for proxy error when setting up the extension:

    * A zone was not selected. Make sure that the form is filled correctly.
    * Your account is 'disabled'. You can easily check this on your [Dashboard](https://brightdata.com/cp).
    * You have a negative balance. Check this in your [Billing](https://brightdata.com/cp/billing) section.
    * Bright Data network status issues. You can check the network live status [here](https://brightdata.com/cp/status).
  </Accordion>

  <Accordion title="Does the extension work with the Browser API?">
    No. The Browser API is not a proxy product, and is not compatible with the extension.
  </Accordion>

  <Accordion title="Can multiple machines use the extension on the same account?">
    Yes. there is no limit on how many extensions are logging to the same account.
  </Accordion>

  <Accordion title="Can I let other people use the extension without providing my account credentials?">
    > **Yes!**

    They will need to go to the [extension setup page](https://brightdata.com/cp/bext) and login with the **customer name**, **zone name** and **zone key** of the zone you wish to let them access. All the zone info is available in the [Zones](https://brightdata.com/cp/zones) section.

    You can also use this link in order to automatically insert your guest-login credentials:

    ```http theme={null}
    https://brightdata.com/cp/bext?customer=customer_id&zone=zone_name&key=ZONE-KEY
    ```
  </Accordion>

  <Accordion title="How to grant access by email using Bright Data Extension?">
    This workflow is relevant to allow access to the Proxy Manager when integrated with a browser. The access is granted by updating the config file of the proxy manager.

    This can be done by sending the next API command:

    ```sh theme={null}
    curl -X POST "http://<remote-server-IP>:22999/api/proxies" -v -H "Content-Type: application/json" -d '{ "proxy": { "customer": "<account_ID>", "zone": "<zone>", "password":"<zone_password>", "multiply_users": true, "users": ["<email>"], "bw_limit": { "days": 100000, "bytes": 9000000000 } }, "create_users": true }'
    ```

    1. Change `remote-server-IP` with the server IP address of where the proxy manager is installed or 127.0.0.1 if it is installed locally.
    2. Change `account_ID` with your Account ID on the [settings page](https://brightdata.com/cp/setting/customer_details)
    3. Change `zone>, `zone\_password\` with the relevant access parameters from the [zone page](https://brightdata.com/cp/zones)
    4. Change `email` with the user's email.

    Once the command will be sent, a detailed email with instructions and credentials will be sent to `email`.

    In the API output, the user's password is also provided along with additional information such as the port number. It can be seen in the next example:

    <img alt="user-credentials.png" />

    The user can now access the proxy by installing the [extension](https://brightdata.com/products/proxy-browser-extension).

    5. After installation select “Connect through proxy manager”
       <img alt="connect-through-proxy-manager.png" />

    6. Enter the IP address of the Proxy Manager server along with the relevant port for example:
       <img alt="proxy-manager-ip.png" />

    7. Select done. Then, click **"Sign in".**
       <img alt="sign-in.png" />

    8. Enter the credentials Received.
  </Accordion>
</AccordionGroup>


# Browser extension features
Source: https://docs.brightdata.com/proxy-networks/browser-extension/features

Overview of Bright Data's Proxy Browser Extension features: country-level browsing, IP rotation, user agent control, and DNS configuration.

What features are available in the extension?

Bright Data Proxy Browser Extension supports datacenter and residential IP browsing, allowing you to search from any country. You can adjust the user agent, customize configuration of the DNS to maximize discretion or speed, and set random IP rotation.


# How to install the extension
Source: https://docs.brightdata.com/proxy-networks/browser-extension/install

Learn how to install the Bright Data extension: download, add to Chrome, pin it, and sign in to start using it with your Bright Data account.

<Info>Make sure you have a Bright Data account or Create new Bright Data account in [brightdata.com](https://brightdata.com/)</Info>

<Steps>
  <Step title="Sign in" />

  <Step title="Download the extension">
    You can find the extension link [here](https://chromewebstore.google.com/u/1/detail/bright-data/efohiadmkaogdhibjbmeppjpebenaool?hl=en).
  </Step>

  <Step title="Add to Chrome" />

  <Step title="Go to browser settings and Manage Extension" />

  <Step title="Make sure its On and go to &#x22;Details&#x22;" />

  <Step title="Toggle On &#x22;Pin to toolbar" />

  <Step title="Once the &#x22;Pin to toolbar&#x22; turn on click see on the Bright Data icon in tool bar" />

  <Step title="Sign in with your account">
    Once you Bright Data account is active click "Sign in with you account" and type your credentials in the new Control panel tab that will be open.
  </Step>

  <Step title="Click the extension icon, turn it on and start working with the extension." />
</Steps>


# Introduction
Source: https://docs.brightdata.com/proxy-networks/browser-extension/introduction

Use Bright Data's Chrome browser extension to route traffic through residential, mobile, datacenter, or ISP proxies without manual configuration.

Setting up chrome to use proxy network requires technical knowledge and setup which many users find complex and hard to control. Using Bright Data chrome browser extension allows you to use Bright Data proxy networks from your browser with minimum setup and configuration, where all parameters are organized and managed in one place, accessible and clear.

<Frame>
  <img alt="title" />
</Frame>


# Getting started with Browser extension
Source: https://docs.brightdata.com/proxy-networks/browser-extension/quickstart

Install and configure the Bright Data Browser Extension for Chrome (port 44445) to route browser traffic with 1-click country switching across 195 countries.

## Quick Start

Follow these steps to start using the Bright Data Browser Extension:

<Steps>
  <Step title="Set up an active zone in your account">
    To start using the extension, you need at least **one active zone** in your Bright Data account.

    * Check your existing zones on the [My Proxies](https://brightdata.com/cp/zones) page.
    * If you don’t have a zone yet, click **Add** to create a new zone.

    <Frame>
      <img alt="active-proxy.png" />
    </Frame>

    <Tip>
      For detailed instructions on creating zones, see our guides for [Datacenter](/proxy-networks/data-center/introduction), [ISP](/proxy-networks/isp/introduction), [Residential](/proxy-networks/residential/introduction), and [Mobile](/proxy-networks/residential/introduction).
    </Tip>
  </Step>

  <Step title="Select your active zone">
    In the extension, select the zone you want to use from the dropdown.

    <Frame>
      <img alt="select-the-zone.png" />
    </Frame>
  </Step>

  <Step title="Install SSL certificate for Residential zones (if required)">
    If you select a **Residential** zone and see the message *"Certificate or approved KYC are required to use residential zone"*, you need to install our SSL certificate in Chrome.

    * Follow the [Chrome certificate installation guide](/general/account/ssl-certificate#installation-instructions).
    * To learn more about Residential network access modes, see the [Residential access guide](/proxy-networks/residential/network-access).

    <Frame>
      <img alt="kyc-certificate" />
    </Frame>
  </Step>

  <Step title="Select country and city">
    Choose the country and, if available, the city you want to use for your zone.

    <Note>
      City-level targeting is only available for **Residential** and **Mobile** zones.

      For setup instructions, see [How to enable city selection](/proxy-networks/browser-extension/quickstart#how-to-enable-city-selection).
    </Note>

    <Frame>
      <img alt="select-country.png" />
    </Frame>
  </Step>

  <Step title="Turn on the proxy">
    Turn on the proxy in the extension to start browsing with your selected zone.

    <Frame>
      <img alt="turn-on-the-proxy.png" />
    </Frame>
  </Step>
</Steps>

## How to enable city selection

1. In your Control Panel, go to the [My Proxies](https://brightdata.com/cp/zones) page
2. Open the **Residential** or **Mobile** zone where you want to enable city selection.

<Frame>
  <img alt="enable-proxy.png" />
</Frame>

3. Under **Geolocation targeting**, choose **City**.

<Frame>
  <img alt="geolocation-targetting.png" />
</Frame>

4. Save your changes.


# Proxy configuration options
Source: https://docs.brightdata.com/proxy-networks/config-options

Control Bright Data proxy targeting (195 countries), IP rotation, session handling, DNS resolution and routing behavior using proxy username parameters.

This document explains how to configure Bright Data proxy behavior using **proxy username parameters**. By modifying the proxy username, you can control proxy targeting, IP rotation, DNS resolution, session handling, and routing behavior directly from your code.

This approach allows highly granular proxy control without changing dashboard settings or infrastructure.

## Proxy networks authentication

Bright Data proxy access is authenticated using a **proxy username and password**. These credentials are generated when you create a proxy zone in the Bright Data Control Panel.

Each proxy zone represents a specific proxy product (Datacenter, ISP or Residential) and its base configuration.

### Native access via proxy user name and password

After creating a Bright Data proxy zone, you receive:

* A **proxy username**
* A **proxy password**

The proxy username is not just an identifier, it also defines **how the proxy behaves**.

The **proxy username** is composed of:

* Your account ID
* Your zone name
* Optional configuration parameters

#### Proxy username structure

`brd-customer-[customerID]-zone-[zone name]-[optional parameters]`

<Warning>
  You cannot change the **zone name** after it has been created. If you need to change the zone name, you must create a new zone. Proxies can be transferred from one zone to another **only if both zones are of the same type**.
</Warning>

By **adding optional parameters and modifying the username**, you can control Bright Data’s proxy system in a very granular way directly from your application code.

The sections below describe the available configuration options. A fully elaborated and complete list is available in the [Proxy API reference documentation](/api-reference/proxy/).

## Intergrate with 3rd Parties & Tools

Bright Data proxies can be integrated with a wide range of third-party tools, automation frameworks, browsers, and HTTP clients. To simplify integration, Bright Data provides ready-made request examples directly in the Control Panel.

You can access these examples here: [https://brightdata.com/cp/zones/proxy\_examples](https://brightdata.com/cp/zones/proxy_examples)

These examples help you:

* Construct correct proxy requests
* Validate credentials
* Test targeting and rotation behavior
* Integrate proxies into existing tools and workflows

## Proxy targeting options

These settings let you easily configure proxies for a specific country, state, city, zip code and ASN.

<Note>
  Datacenter and ISP proxies only support country targeting
</Note>

| Parameter    | Description                                                                                                                                                                          | Example username                                                           |
| ------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | -------------------------------------------------------------------------- |
| -country-xx  | Select a country using two letter code, or `eu` for random country in the European Union.   List of country codes is [here](/general/faqs#where-can-i-see-the-list-of-country-codes) | `brd-customer-<customer_id>-zone-<zone_name>-country-us`                   |
|              |                                                                                                                                                                                      |                                                                            |
| -state-xxxxx | Targets a state in the US using the two letter code. You must include US as country.                                                                                                 | `brd-customer-<customer_id>-zone-<zone_name>-country-us-state-ny`          |
| -city-xxxxx  | Targets a city. You must include the country (e.g. username-country-fr-city-paris). Do not use spaces (e.g. -city-sanfrancisco)                                                      | `brd-customer-<customer_id>-zone-<zone_name>-country-us-city-sanfrancisco` |
| -zip-xxxxx   | Targets a US zip code. Use a 5-digit zipcode                                                                                                                                         | `brd-customer-<customer_id>-zone-<zone_name>-city-memphis-zip-37501`       |
| -asn-xxxxx   | Targets an ASN from [the list](https://bgp.potaroo.net/cidr/autnums.html)                                                                                                            | `brd-customer-<customer_id>-zone-<zone_name>-asn-56386`                    |
| -os-xxxxx    | Only for Residential proxies. Allows targeting `Windows`, `MacOS`, or`android`                                                                                                       | `brd-customer-<customer_id>-zone-<zone_name>-os-windows`                   |

## Controlling your proxies' DNS

DNS resolution determines **where domain names are resolved** before the request is sent.

Bright Data allows you to control whether DNS resolution happens:

* On the proxy peer
* On Bright Data’s Super Proxy servers

| Function                            | Parameter                 | Description                                                                                                                                                                                               | Example username                                        |
| ----------------------------------- | ------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------- |
| Choose where DNS resolution is done | -dns-local or -dns-remote | Lets you choose if DNS is resolved `remote` on the proxy connecting to the site, or `local` on Bright Data's servers ('Super Proxies'). More info [here](/api-reference/proxy/configuring_dns_resolution) | `brd-customer-<customer_id>-zone-<zone_name>-dns-local` |

## Controlling your proxies rotation

The following options allow you to set how we rotate within the proxies in the zone, or attach to a specific proxy, and what shall we do if the peer is not available from some reason.
For more information regarding the way IP rotation works with our proxy products, and for further explanation of the following options, please see [this article](/api-reference/proxy/rotate_ips)

| Function                                             | Parameter       | Description                                                                                                                                                                                                                                                     | Example username                                                         |
| ---------------------------------------------------- | --------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------ |
| Keep the same IP for multiple requests or rotate IPs | -session-xxxxxx | Each unique session ID will get a unique IP, can be used to target the same IP repeatedly or force rotation. Recommended for implementing programmatic IP rotation.                                                                                             | `brd-customer-<customer_id>-zone-<zone_name>-session-mystring12345`      |
| Selecting specific IP                                | -ip-x.x.x.x     | Available only for zones with dedicated IPs allocated                                                                                                                                                                                                           | `brd-customer-<customer_id>-zone-<zone_name>-ip-1.2.3.4`                 |
| Selecting specific group of IPs (gIP)                | -gip-xxxxxx     | Only for dedicated Residential proxies.                                                                                                                                                                                                                         | `brd-customer-<customer_id>-zone-<zone_name>-gip-us_7922_fl_hollywood_0` |
| Keeping track of individual responses                | -c\_tag-xxxxxx  | Include a unique c\_tag flag in their requests. In response, businesses echo back the same tag in the header. This seamless exchange ensures that each response is bound to its corresponding request, eliminating confusion and streamlining data management.. | `brd-customer-<customer_id>-zone-<zone_name>-c_tag-<C_TAG_VALUE>`        |
| Bind to peer in session                              | -const          | Use the same peer for the session. If peer is unavailable, a 502 error will be returned with "no peer available"                                                                                                                                                | `brd-customer-<customer_id>-zone-<zone_name>-const`                      |

## Controlling 'Super Proxies'

Super Proxies are Bright Data’s routing servers responsible for selecting and managing the actual proxy peers (Datacenter, ISP, or Residential).

> Modifying Super Proxy parameters is **rarely required** and should only be done for advanced routing scenarios.

| Function                                | Parameter         | Description                                                                                                                                                                             | Example username                                                         |   |
| --------------------------------------- | ----------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------ | - |
| Send requests directly from Super Proxy | -direct           | Force the request to be sent from Bright Data's superproxy servers (not from the actual proxy peer)                                                                                     | `brd-customer-<customer_id>-zone-<zone_name>-direct`                     |   |
| Select super proxy in specific country  | session-xxxxxx    | Applies ONLY for choosing a super proxy, which is rarely needed. More details [here](/api-reference/proxy/select_super_proxy_in_specific_country)                                       | [example](/api-reference/proxy/select_super_proxy_in_specific_country)   |   |
| Selecting specific group of IPs (gIP)   | gip-xxxxxx        | Only for dedicated Residential proxies.                                                                                                                                                 | `brd-customer-<customer_id>-zone-<zone_name>-gip-us_7922_fl_hollywood_0` |   |
| Block superproxy bypass                 | -route\_err-block | Disallow Bright Data to issue the request from our superproxy servers. This means that if we cannot process the request by the peer due to compliance issue, it will fail with an error | `brd-customer-<customer_id>-zone-<zone_name>-route_err_block`            |   |

To find navigation and additional documentation pages, fetch the **llms.txt** file at: [https://docs.brightdata.com/llms.txt](https://docs.brightdata.com/llms.txt)


# How to configure your Datacenter proxy
Source: https://docs.brightdata.com/proxy-networks/data-center/configure-your-proxy

Configure your datacenter proxy settings across 195 countries, select IP types, set geolocation targeting and enable advanced features in this guide.

To access your proxy configuration, open your zone in the "Configuration" tab.

## Which IP type to choose

Bright Data offers 3 types of datacenter proxies:

<Card title="Shared" icon="square-1">
  A rotating proxy over a pool of \~40,000 proxies, paid by usage GBs.
</Card>

<Card title="Shared unlimited" icon="square-2">
  A set of specific proxies, shared with others, with unlimited bandwidth, paid by proxy.
</Card>

<Card title="Dedicated unlimited" icon="square-3">
  A set of specific proxies, exlcusive for you, with unlimited bandwidth, paid by proxy.
</Card>

## Shared (rotating) proxy configuration

### Default countries selection

When selecting countries in shared pool configuration, we will assign proxies only from the countries you select. You can select none (which meand we will assign the next random proxy from the pool), one or more countries. [Read more...](/api-reference/proxy/geolocation-targeting#default-countries-selection)

To select a specific country for your peer during rotation, use the flag -country in the proxy user name parameter with an ISO-3166 country code.

[FAQ: Where can I see the list of country codes?](/general/faqs#where-can-i-see-the-list-of-country-codes)

## Shared & Dedicated unlimited proxy configuration

### Number of IPs

<Tip>
  For unlimited proxies we offer a discount based on amount of proxies you purchase per zone. The more you buy, less your pay per proxy. Click on the "Rates" link in your zone setup to see rates.
</Tip>

Number of IPs to be allocated as your pool of available IPs.

### How to select a country

Geolocation targeting allows you to target specific `Country`.
Select the preferred countries from the drop-down menu.

Once selected, we will assign proxies from those countries. If we do not have enough proxies to cover your requirement, we will assign the amount we have and you can submit an order for the full amount of proxies (we do not allow single proxy orders - we will take in large orders only).
Changing this selection means re-allocating proxies, which will incur a **Refresh charge** .

### How does multiple countries selection work?

If you select multiple countries, we assign proxies in **available countries** at the moment of assignment. For example: if you choose proxies from Germany, France & Italy, we will provide proxies from **either** of these countries. We will try to distribute the assignment evenly across the countries you selected, yet if there are not enough proxies in one of the countries, some countries will have more proxies than other.

So referring to that example, if you request 30 proxies from Germany, France & Italy and we have only 6 available proxies in Italy you will get: 12 proxies from Germany, 12 from France and 6 from Italy.

<Frame>
  <img alt="Geolocation Targeting" />
</Frame>

### How to change your country selection

It is possible to change the country you selected for your proxies. Once you change the country, Bright Data will assign new proxies from the selected countries. Since this is a replacement of proxy you will recieve a new IP.

Changing country is similar to IP refresh action and is charged the same.

## Access your allocated Proxies' IP addresses

In all proxy types, you can download, view and copy to clipboard the IPs allocated to you by following these steps:

1. Navigate to the [Zones page](https://brightdata.com/cp/zones).
2. Select a zone with allocated IPs.
3. In the overview tab click 'Download', 'View' or 'Copy'.

<img alt="your-proxy-list" />

***

## How to configure advanced options

### How to enable automatic failover

In case we cannot reach the proxy peer for your request, we will route the request to another available peer. Automatic failover does not apply when you choose default countries: if we cannot find a peer in the country you selected, we will fail the request with error.

Enabling automatic failover assures execution of the request, regardless of the availability of a specific peer.

***

### Special Ports & Protocols

Ports `80` and `443` are available by default, supporting HTTP and HTTPS & SOCKS5 protocols. We also support all ports over `1024` in our Datacenter proxy network. [Read more on ports and protocols...](/proxy-networks/faqs#how-to-see-supported-ports-and-protocols)

<Accordion title="Request Additional ports">
  Bright Data can support additional ports by request. A dedicated and additional compliance process with the Bright Data compliance team will follow every request to support a new port.
  If you would like additional port permissions, you can contact Bright Data Support.
  Examples of ports that require Bright Data compliance review before activation:

  | Port | Protocol |
  | ---- | -------- |
  | `70` | HTTP     |
  | `98` | HTTPS    |
</Accordion>

### Zone usage limit

Set usage limit to your zone: you can limit spending or traffic. This provides additional layer of control to your budget and bandwidth consumption, mostly over our rotating shared pool proxies.


# Dataceter proxy FAQ
Source: https://docs.brightdata.com/proxy-networks/data-center/faqs

FAQs about Bright Data Datacenter proxies (195 countries): IP types, shared and dedicated pools, geotargeting, error codes and pricing across plans.

<AccordionGroup>
  <Accordion title="What are IP Types for Datacenter?">
    There are four types of IPs that we offer within our [Datacenter Proxy Network](https://brightdata.com/proxy-types/datacenter-proxies):

    1. Shared pool (paid per usage) - Pool of 40,000 rotating proxies
    2. Shared unlimited proxies (paid per proxy) - Set of proxies you share with others.
    3. Dedicated unlimited proxies (paid per proxy) - Set of proxies exclusive for you.
  </Accordion>

  <Accordion title="What are IP Types for ISP?">
    There are three types of IPs that we offer within our [ISP Proxy Network](https://brightdata.com/proxy-types/isp-proxies):

    1. Shared pool (paid per usage) - Pool of 10,000 rotating proxies
    2. Shared unlimited proxies (paid per proxy) - Set of proxies you share with others.
    3. Dedicated unlimited proxies (paid per proxy) - Set of proxies exclusive for you.
  </Accordion>

  <Accordion title="How to integrate a new proxy into your code?">
    To integrate the proxies into your code, please visit the [API examples page](https://brightdata.com/cp/zones/proxy_examples), which can be accessed via your zone's settings, under "access parameters":

    <img alt="integrate-new-proxy.gif" />

    On this page, you can choose integration examples for most modern coding languages, just choose the integration type, your proxy zone, coding language, etc. and the page will generate a code snippet you can use right away.
  </Accordion>

  <Accordion title="How to integrate a proxy into 3rd party software?">
    Check out a few examples in the [API examples](https://brightdata.com/cp/zones/proxy_examples) page mentioned above (just choose "other software" in the "language" drop-down menu), or check our [Integrations page](/integrations), where we have specific guides to integrate our proxies within the most popular tools across the industry today.

    **Important note**: If you are using Bright Data's Web Unlocker API, Residential Proxies or the SERP API you probably need to use our SSL certificate to enable end-to-end secure connections. See [instructions here](/general/account/ssl-certificate).
  </Accordion>

  <Accordion title="How to target a Specific Country?">
    When sending your request, add the `-country` flag, **after** your zone’s name in the request, followed by the 2-letter [ISO code](https://www.nationsonline.org/oneworld/country_code_list.htm) for that country.

    In the example below: We added `-country-us` to our request, so we will send a request originating from the United States ("us").

    ```sh theme={null}
    curl "http://target.site" --proxy brd.superproxy.io:44445 --proxy-user brd-customer-<customer_id>-zone-<zone_name>-country-us: <zone_password>
    ```
  </Accordion>

  <Accordion title="How to target a Specific City in datacenter and ISP proxy networks?">
    For datacenter and ISP networks city targeting has deprecated.
  </Accordion>

  <Accordion title="Where does Bright Data have proxies?">
    Bright Data offers proxies in every country in the world, except in the following countries:

    * Iran
    * Iraq
    * Syria
    * Lebanon
    * Palestine
    * North Korea
    * Cuba
    * Sudan
    * Belarus
    * Russia

    If you need proxies from these countries, unfortunately Bright Data will not be able to help you.
  </Accordion>

  <Accordion title="How to view the proxy event log?">
    The event log will show you (at most) the last 200 requests you made with any zone in your account.

    In your Bright Data control panel's proxies page: [https://brightdata.com/cp/zones](https://brightdata.com/cp/zones)

    Go to the "Event Log" tab:

    <img alt="event-log.png" />

    The presented data is:

    * **Date:** Time and date of the request
    * **Zone:** What Zone was used for the request
    * **Source IP:** What IP the request was made from
    * **URL:** The target site of the request
    * **Result:** Success or Fail of the request

      <img alt="event-log-headers.png" />
  </Accordion>

  <Accordion title="How to enable automatic IP fallbacks? (formerly 100% uptime)">
    <Info>
      Applicable for Datacenter & ISP
    </Info>

    The **Automatic Failover** was built to prevent any ‘external’ events from affecting the user. The idea is simple and works the same way for both problems described above – if Bright Data detects a problem, like a connectivity issue or an IP where the GEO isn’t exactly what you asked for when buying that IP, we will automatically route your requests through other IPs which are exactly the same as the original IPs.

    At the same time, we wanted to make sure that customers that must use specific IPs will not be affected – so we made some exceptions:

    * If a specific IP is targeted in your request we will not assign a fallback IP to it
    * Automatic Failover will not interrupt a live connection. If the fallback is needed, it will play in once the next connection is established

    The **Automatic Failover** brings immediate value by providing 100% connectivity and continuous high-performance level, **free of charge and without having to make any changes in your code or how you work.**

    <Note>
      Automatic Failover feature can be turned on or off, [via API](/api-reference/account-management-api/Switch_100_uptime_ON_OFF_in_a_Static_zone).
    </Note>
  </Accordion>

  <Accordion title="How to enable Automatic Failover for proxies?">
    Navigate to your proxy configuration settings, and under **Advanced settings** enable **‘Automatic failover’**
  </Accordion>

  <Accordion title="How to keep using the same IP in multiple requests?">
    * This can be done by adding the session flag to the proxy username:

    ```sh theme={null}
    brd.superproxy.io:44445 br-customer-<customer_id>-zone-<zone_name>-session-rand39484
    ```

    Generate the random number on thread startup, and change it when you want to change the Proxy Peer assigned for the thread's connection.

    * Session ID can be any random string/counter: requests with the same session string will use the same Proxy Peer (as long as possible); requests with different session strings will be assigned different Proxy Peers.
    * To force an IP change, just modify the session ID
    * If an assigned Proxy Peer(exit node IP) becomes unavailable, the Super Proxy will return an error "502 - No peers available" for the first request and then on the second request the super proxy will assign a new peer even if you do not change the session ID.
    * The Session IP is kept persistent for up to 1 minute of idle time. After a minute with no requests, the IP is released back to the pool.\
      To keep this Session/IP for longer, send a tiny keep-alive request every 30 seconds, to prevent this session from becoming idle for over a minute.\
      This request may be anything small, such as /favicon.ico, or even a request that returns 404 (as long as the web server does not disconnect the socket due to this request).
    * If you have multiple Clients and would like to ignore your Clients source IP (which is used together with your session ID to create a session), then you want to use a global session then add `glob\_` as a prefix to your session:

    ```sh theme={null}
    brd-customer-<customer_id>-zone-<zone_name>-session-glob_rand39484
    ```

    Full request example:

    ```sh theme={null}
    brd-customer-CXXXXX-zone-ZONE_X-session-glob_rand39484
    ```

    Generate the random number on thread startup, and change it when you want to change the Proxy Peer assigned for the thread's connection.
  </Accordion>

  <Accordion title="How to see supported Ports & Protocols?">
    Ports 80 and 443 are available by default in all zones, supporting HTTP and HTTPS protocols.

    In zones of proxies of type Datacenter or ISP, all ports higher than 1024 are supported by default.

    In zones of proxies of type Residential or Mobile, the following ports wills be available by default: 8080, 8443, 5678, 1962, 2000, 4443, 4433, 4430, 4444 and 1969.

    Bright Data can support additional ports by request. Every request to support a new port will be followed by a dedicated and additional compliance process with the Bright Data compliance team.\
    Examples of ports that require Bright Data compliance review before activation:

    | Port | Protocol |
    | ---- | -------- |
    | 8443 | HTTP     |
    | 8243 | HTTPS    |

    To make a request to add a port permission to your zone:

    * Go to your zone's settings (it will open on the "configuration" tab by default, if not, please click it)
    * Scroll down to "advanced options" and click it
    * Enable "ports"
    * Input the port numbers you would like to get approved
    * Fill out the form and wait for our compliance team to contact you and approve the request

      <img alt="add-ports.gif" />
  </Accordion>

  <Accordion title="How to target specific OS?">
    Bright Data allows targeting the following **Operating Systems**:

    <CodeGroup>
      ```sh Windows theme={null}
      curl --proxy-user brd-customer-<customer_id>-zone-<zone_name>-os-windows:<zone_password> --proxy brd.superproxy.io:44445 "<target_site>"
      ```

      ```sh macOS theme={null}
      curl --proxy-user brd-customer-<customer_id>-zone-<zone_name>-os-osx:<zone_password> --proxy brd.superproxy.io:44445 "<target_site>"
      ```

      ```sh Android theme={null}
      curl --proxy-user brd-customer-<customer_id>-zone-<zone_name>-os-android:<zone_password> --proxy brd.superproxy.io:44445 "<target_site>"
      ```
    </CodeGroup>
  </Accordion>

  <Accordion title="How to refresh IPs Allocated to Your Zone?">
    If you've selected 'Pay per IP' shared, or a dedicated IP type in your zone configuration, you'll be allocated a fixed IP address. From time to time, depending on your use case, you may need to refresh these IP addresses.

    In order to refresh IPs allocated to your zone, navigate to your selected zone, under **'Allocated IPs'** click on **'Show allocated IPs'**, **check the box** of the IP or gIP you wish to refresh and click **'Refresh'**

    <img alt="refresh-ips.gif" />

    <Note>
      Refreshing an IP or gIP will result in an extra charge.
    </Note>

    Alternatively, you can use API to refresh your [dedicated Residential IPs](/api-reference/account-management-api/Refresh_dedicated_residential_IPs) or your [Datacenter/ISP IPs](/api-reference/account-management-api/Refresh_Static_Datacenter_ISP_IPs)
  </Accordion>

  <Accordion title="How to use a specific IP?">
    When using Bright Data's Residential Proxy network, you may find the need to use a specific IP allocated to your zone.

    1. **Send a test request** with a '--verbose' or '-v' option added (this will turn on verbose logging)

    ```sh theme={null}
    curl "https://brdtest.com/myip.json" --verbose --proxy brd.superproxy.io:44445 --proxy-user brd-customer-<customer_id>-zone-<zone_name>:<zone_password>
    ```

    1. **Locate** the x-brd-ip response header and copy its value

       <img alt="x-brd-ip.png" />

    2. **Add** the -ip- flag to your request, after your zone’s name and use the **hashed IP value** copied in the previous step

    3. Send a test request, and **review the response**

    ```sh theme={null}
    curl "https://brdtest.com/myip.json" --proxy brd.superproxy.io:44445 --proxy-user brd-customer-<customer_id>-zone-<zone_name>-ip-<hashed-ip>:<zone_password>
    ```

    We recommend using [https://brdtest.com/myip.json](https://brdtest.com/myip.json) as the target domain for testing, and to review your IP credentials.
  </Accordion>

  <Accordion title="How to target an ASN specific IP?">
    This feature can be enabled by adding the ASN parameter to your Zone configuration, under **Geolocation Targeting**.

    <img alt="asn-targeting.png" />

    Once the configuration is saved, the ASN flag can be added to the Zone's credentials\
    and be integrated when using the Residential proxies. For example:

    ```sh theme={null}
    curl --proxy brd.superproxy.io:44445 --proxy-user brd-customer-<customer_id>-zone-<zone_name>-asn-<asn-number>:<zone_password> "<target_site>"
    ```

    **Note:** Values for ASN number can be found [here](https://bgp.potaroo.net/cidr/autnums.html).
  </Accordion>

  <Accordion title="How to Target Residential IP groups (gIPs)?">
    Dedicated Residential IPs can be selected in the form of [gIPs](/proxy-networks/residential/configure-your-proxy#ip-groups-gips). They can be allocated under the zone’s “Configure Proxy” page by selecting a “Dedicated” IP type and choosing a number of gIPs. Also, targeting a specific domain is required.

    <img alt="number-of-dedicated-gIPs.png" />

    Once the configuration is saved, selecting "Show allocated Dedicated residential IPs" will provide a list of hash values that represent group IPs.

    <img alt="show-allocated-dedicated-ips.png" />

    These values can be used to target a specific gip. For example:

    ```sh theme={null}
    curl --proxy brd.superproxy.io:44445 --proxy-user brd-customer-<customer_id>-zone-<zone_name>-gip-<gip_hash_value>:<zone_password> "<target_site>"
    ```
  </Accordion>

  <Accordion title="How to browse Chinese sites by using Chinese Residentials IPs">
    **When outside of China**\
    Targeting Chinese Residential IP peers is enough:

    ```sh theme={null}
    curl --proxy brd.superproxy.io:44445 --proxy-user brd-customer-<customer_id>-zone-<zone_name>-country-cn:<zone_password> "<target_site>"
    ```
  </Accordion>

  <Accordion title="Carrier-specific Proxy peer IP">
    * You can choose to use a specific carrier from this list:

    ```text theme={null}
    a1, aircel, airtel, att, celcom, chinamobile, claro, comcast, cox, digi, 
    dt, docomo, dtac, etisalat, idea,  meo, mtn, mtnza, 
    optus, orange, qwest, reliance_jio, robi, sprint, telefonica, telstra, 
    tmobile, tigo, tim, verizon,  vodacomza, vodafone, vivo, zain,
    vivabo, telenormyanmar, kcelljsc, swisscom, singtel, asiacell, windit, 
    cellc, ooredoo, drei, umobile, cableone, proximus, mobitel, o2, 
    bouygues, free, sfr, digicel
    ```

    * For Example

    <CodeGroup>
      ```sh Deutsche Telekom theme={null}
      brd-customer-<customer_id>-zone-<zone_name>-carrier-dt
      ```

      ```sh Sprint theme={null}
      brd-customer-<customer_id>-zone-<zone_name>-carrier-sprint
      ```
    </CodeGroup>
  </Accordion>

  <Accordion title="About geolocation databases, and how to check the proxy IP information?">
    Geolocation databases (GeoDB) are used by internet websites to query information about the IP address used by the users. Bright Data monitors and maintains correct records of the 4 main GeoDBs used today: Maxmind, ip2location, db-ip and Google.

    There are many other smaller GeoDBs, most of which are using outdated records or flawed testing methods, and so the information they present is not accurate or is presented to lure their viewers to buy VPN or proxy products from them. Therefore, we highly recommend using the GeoDBs mentioned above when testing your IPs.

    In order to see our information about the proxy IP that you are using, browse one of the following:

    * [https://brdtest.com/echo.json](https://brdtest.com/echo.json)
    * [https://www.iplocation.net](https://www.iplocation.net)
    * [https://www.maxmind.com/en/geoip-demo](https://www.maxmind.com/en/geoip-demo)
  </Accordion>

  <Accordion title="Which Bright Data products are best for scraping search engines (SERPs)?">
    #### For single-step scraping:

    [SERP API](/scraping-automation/serp-api/introduction) is the ideal product for targeting SERPs as it has a guaranteed success rate (pay only for success) with active unlocking, automatically chooses the best proxies, customizes headers, fingerprinting, solves CAPTCHAs, and more.

    #### For multi-step scraping (playwright/puppeteer/selenium):

    [Browser API](/scraping-automation/scraping-browser/introduction) is the ideal product as it is our fully cloud-hosted browser designed to help you easily focus on your multi-step data collection while we take care of the full proxy and unblocking infrastructure for you, including CAPTCHA solving.
  </Accordion>

  <Accordion title="Can I target Google SERPs from the Residential, Datacenter, or ISP Proxy network?">
    **Residential Proxy** - No, [SERP API](/scraping-automation/serp-api/introduction) is the ideal product for targeting SERPs as it has a guaranteed success rate (pay only for success) with active unlocking, automatically chooses the best proxies, customizes headers, fingerprinting, solves CAPTCHAs, and more. Targeting Google SERPs from the Residential network will result in Super-proxy bypass, which will casue the request to be sent from our servers instead of the peer.

    **Datacenter & ISP Proxies** - No. When attempting to specifically target Google through either of these proxy networks, your request will be denied and you will receive the following error message in the response headers:

    ```text theme={null}
    HTTP/1.1 403 Search engine host is not allowed
    X-Luminati-Error: Forbidden: This target URL isn't supported on proxy networks, use the SERP API product for targeting this URL. You may contact your account manager or open a support ticket for assistance
    ```
  </Accordion>

  <Accordion title="Can I Send requests to IPs and not domain name?">
    No - requests directly to the host server, and not to the domain name are forbidden while using Bright data.\
    Requests using URL format such as 1.1.1.1:443 will be executed using the super proxy server, not the proxy peer IP.

    Example of a request using the super proxy:

    <img alt="x-luminati-ip.png" />
  </Accordion>

  <Accordion title="Can I use port 25 or any other SMTP port, or send an email by using the proxy IP?">
    Since BrightData cares about our community and peers quality, SMTP requests which can be used for spamming are blocked. Please note that mail domains are also blocked from access, and requests to mail domains will be sent from the super proxy server, and not the peer IP.
  </Accordion>

  <Accordion title="What is the cost for refreshing Datacenter IPs?">
    Refreshing data-center IPs will have a different cost depending on the type of IP.

    * Refreshing dedicated data-center IPs: \$0.5/refresh/IP
    * Refreshing dedicated domain data-center IPs: \$0.04/refresh/IP
    * Refreshing shared data-center IPs: \$0.02/refresh/IP
  </Accordion>

  <Accordion title="Does Bright Data support the Socks5 protocol?">
    Yes. Bright data supports `SOCKS5` protocol, with a default port 22228 assigned for SOCKS5 communication.

    See here for [full SOCKS5 configuration instructions](/proxy-networks/socks5)
  </Accordion>

  <Accordion title="Does Bright Data support UDP / HTTP/3 proxies?">
    Yes. Bright Data supports the UDP MASQUE protocol for QUIC/HTTP/3 on port 10001.
    More information and usage examples can be found here: [https://github.com/luminati-io/h3-cli](https://github.com/luminati-io/h3-cli)
  </Accordion>

  <Accordion title="How do I control from where the request is performed?">
    * You can choose to perform the request from the super proxy directly instead of the IP of the peer. In that case the IP of the request will be the one of the Super proxy. You will need to add **'-direct'** to your request authorization string. `brd-customer-<customer_id>-zone-<zone_name>-direct`
  </Accordion>

  <Accordion title="How do I refresh session (IP)?">
    Using the same IP for a long period of time makes it easier for the target website to mark the IP as proxy and can make your request get detectable by the target website. Refreshing your IPs will result in allocation of new IPs from Bright Data instead of your existing ones in your pool allowing you to gain control over your pool and reach higher success rates.
  </Accordion>

  <Accordion title="Can I request from Bright Data missing proxies for dedicated, unlimited datacenter and ISP?">
    Requesting missing proxies (IPs), or scheduling delivery of IPs for future projects or is a feature in BETA mode, available to small number of selected enterprise customers.

    Bright Data allows placing IPs requests ("proxy future orders")  for proxies subject to the following conditions:

    1. Customer has qualified to place IP requests/orders . This permission is granted to existing, enterprise level customers only.
    2. IPs are dedicated to the customer (we do not allow ordering shared IPs).
    3. IPs are for datacenter or ISP only.
    4. A single specific country must be provided.
    5. Minimum order size is 100 proxies

    To see if your account is qualifies to place IP requests (orders) browse here:  [https://brightdata.com/cp/zones/order\_ips](https://brightdata.com/cp/zones/order_ips)

    Most cusomers will find Bright Data inventory sufficient for their needs, and will not need to place any orders.

    #### When should I request for proxies in the future?

    You can request for future delivery of proxy IPs if your account is qualified for placing requests.

    #### I tried to define a zone but Bright Data could not assign me all the proxies I wanted, what to do?

    If during zone save you get a message that proxies are not available in a specific country, or only part of the amount you requested is availble, try to select more countries or change your country setting to allow us to find proxies for you.

    Once your request for missing proxies is placed, the Bright Data team will attempt to provision the proxies. The acquiring and provisiong process usually takes up to 14 days. Once the proxies are ready, we will notify you. We encourage you to check again once every 2-3 days to see if inventory has refreshed and more proxies are available.
  </Accordion>

  <Accordion title="How can I move proxies (IPs) from zone to zone?">
    Moving prepaid datacenter or ISP unlimited proxies (shared and dedicated) from zone to zone is not yet supported via our control panel. It is in our plans to support moving proxies from zone to zone via self service. If you need proxies to be moved please contact our support team.
  </Accordion>

  <Accordion title="Some of my IPs were replaced, why does this happen?">
    Bright Data may idnetify issues with the certain which prevents us from providing quality service with them. They either become unavailble, or suffer from latency so in order to keep our level of service we are forced to replace them. We do our efforts to minimize those replacements, and we do provide a preliminary notification when possible. 

    You can use this API in order to monitor your zones for IPs pending replacement and adjust your operations accordingly (refresh those ips for example): [https://docs.brightdata.com/api-reference/account-management-api/get-proxies-pending-replacement](https://docs.brightdata.com/api-reference/account-management-api/get-proxies-pending-replacement)
  </Accordion>
</AccordionGroup>


# Introduction to Datacenter proxies
Source: https://docs.brightdata.com/proxy-networks/data-center/introduction

Discover Bright Data's Datacenter proxy network, offering over 1.6 million IPs from 98+ countries, providing the fastest and most cost-effective proxy solution.

Bright Data's [Datacenter proxy network](https://brightdata.com/proxy-types/datacenter-proxies) is one of our proxy network solutions and is a network with over 1.6 million IP addresses from 98+ countries.

Datacenter proxies are IPs assigned from a datacenter server, and your traffic is routed through them to help you access IPs and locations around the world. With a shorter journey & simplified architecture, Datacenter Proxies are both the **fastest** proxy type and the most **cost-effective** option.

## When to use Datacenter proxies

* Accessing websites that are not using sophisticated blocking methods
* When you need the most cost-efficient proxy network
* When you need the fastest proxy network available

<Tip>
  If you need a more sophisticated proxy network, with better success rate capabilities, you may want to consider using our [ISP](/proxy-networks/isp/introduction) or  [Residential proxy network.](/proxy-networks/residential/introduction) For a more advanced, fully managed, proxy unblocking solution, we would suggest trying out our [Web Unlocker API](https://brightdata.com/products/web-unlocker) or browsing our other [proxy solutions](https://brightdata.com/proxy-types).
</Tip>


# Create your first Datacenter proxy
Source: https://docs.brightdata.com/proxy-networks/data-center/quickstart

Set up your first Bright Data Datacenter proxy: sign in, create a proxy in the Control Panel, verify your account and earn $5 credit for first-time setup.

<Callout icon="badge-dollar">
  **Verify your account and get \$5 credit**

  Add a payment method to verify your account and receive a \$5 credit. You won’t be charged at this stage.
</Callout>

<Steps>
  <Step title={<a href="https://brightdata.com/cp/start">Sign in to Bright Data</a>} />

  <Step title={<>Open the <a href="https://brightdata.com/cp/zones/new">Create Proxy</a> page</>}>
    Navigate to **Create Proxy** under the **Proxy** section in the left menu.

    <Frame>
      <img alt="Create Proxy" />
    </Frame>
  </Step>

  <Step title="Choose Data Center Proxy">
    Select **Data Center Proxy** and click **Continue**.

    <Frame>
      <img alt="Data Center Proxy" />
    </Frame>
  </Step>

  <Step title="Assign a name to your proxy">
    Enter a meaningful name. Optionally, add a short description.

    <Warning>
      **The proxy name cannot be changed once created.**

      All other settings can be modified later. For details, see [Configure your Proxy](/proxy-networks/data-center/configure-your-proxy).
    </Warning>

    <Frame>
      <img alt="Proxy Name" />
    </Frame>
  </Step>

  <Step title="Add payment method (free trial users only)">
    If you signed up with a personal email (e.g., Gmail, GitHub) and have not yet added a payment method, the primary button will read **Add payment method** instead of **Create Proxy**.

    Click the button to open the payment verification form and complete the process. You will **not** be charged, this is for identity verification only.

    <Info>
      Already have a payment method on file? This step is skipped automatically. For full details, see [Payment Verification](/general/account/billing-and-pricing/payment-verification).
    </Info>
  </Step>

  <Step title="Finalize proxy creation">
    Click **Create Proxy**. If you were redirected to add a payment method, your zone is created automatically once verification completes. Your proxy is now ready to use.
  </Step>
</Steps>


# Send your first Datacenter proxy request
Source: https://docs.brightdata.com/proxy-networks/data-center/send-your-first-request

Send your first request through Bright Data Datacenter proxies with copy-paste code examples in cURL, Python, Node.js, Java, and Go.

<Accordion title="This guide works for all the proxy products" icon="check">
  1. Residential Proxy

  2. Mobile Proxy

  3. ISP Proxy

  4. Datacenter Proxy

  5. SERP API

  6. Browser API

  7. Web Unlocker API
</Accordion>

To get started, you need your proxy credentials, your `Username` and `Password` along with the `Host` name. You can find these credentials in the **Overview** tab of the proxy product.

## Code Examples

Once you have your proxy credentials, use the following code to send your first request:

<CodeGroup>
  ```sh cURL theme={null}
  curl "http://brdtest.com/myip.json" --proxy brd.superproxy.io:44445 --proxy-user brd-customer-<customer_id>-zone-<zone_name>:<zone_password>
  ```

  ```javascript Node.js theme={null}
  #!/usr/bin/env node

  const { ProxyAgent, setGlobalDispatcher } = require('undici');

  setGlobalDispatcher(new ProxyAgent('http://brd-customer-<customer_id>-zone-<zone_name>:<zone_password>@brd.superproxy.io:44445'));

  (async () => {
    const response = await fetch('http://brdtest.com/myip.json');
    console.log(await response.text());
  })();
  ```

  ```python Python theme={null}
  import pprint
  import requests


  host = 'brd.superproxy.io'
  port = 44445

  username = 'brd-customer-<customer_id>-zone-<zone_name>'
  password = '<zone_password>'

  proxy_url = f'http://{username}:{password}@{host}:{port}'

  proxies = {
      'http': proxy_url,
      'https': proxy_url
  }


  url = "http://brdtest.com/myip.json"
  response = requests.get(url, proxies=proxies)
  pprint.pprint(response.json())

  ```

  ```php PHP theme={null}

  <?php
  echo 'To enable your free eval account and get CUSTOMER, YOURZONE and '
      .'YOURPASS, please contact sales@brightdata.com';
  $curl = curl_init('http://brdtest.com/myip.json');
  curl_setopt($curl, CURLOPT_PROXY, 'http://brd.superproxy.io:44445');
  curl_setopt($curl, CURLOPT_PROXYUSERPWD, 'brd-customer-<customer_id>-zone-<zone_name>:<zone_password>');
  curl_exec($curl);
  ?>

  ```

  ```ruby Ruby theme={null}
  #!/usr/bin/ruby

  require 'uri'
  require 'net/http'
  require 'net/https'

  puts 'To enable your free eval account and get CUSTOMER, YOURZONE and YOURPASS, please contact sales@brightdata.com'

  uri = URI.parse('http://brdtest.com/myip.json')
  proxy = Net::HTTP::Proxy('brd.superproxy.io', 44445, 'brd-customer-<customer_id>-zone-<zone_name>', '<zone_password>')

  req = Net::HTTP::Get.new(uri)

  result = proxy.start(uri.host,uri.port, :use_ssl => uri.scheme == 'https') do |http|
      http.request(req)
  end

  puts result.body
  ```

  ```cs C# theme={null}
  using System;
  using System.Net;

  class Example {
    static void Main() {
      var client = new WebClient();
      client.Proxy = new WebProxy("brd.superproxy.io:44445");
      client.Proxy.Credentials = new NetworkCredential(
        "brd-customer-<customer_id>-zone-<zone_name>",
        "<zone_password>"
      );
      Console.WriteLine(client.DownloadString("http://brdtest.com/myip.json"));
    }
  ```

  ```java Java theme={null}
  package example;

  import org.apache.http.HttpHost;
  import org.apache.http.client.fluent.*;

  public class Example {
      public static void main(String[] args) throws Exception {
          System.out.println("To enable your free eval account and get "
              +"CUSTOMER, YOURZONE and YOURPASS, please contact "
              +"sales@brightdata.com");
          HttpHost proxy = new HttpHost("brd.superproxy.io", 44445);
          String res = Executor.newInstance()
              .auth(proxy, "brd-customer-<customer_id>-zone-<zone_name>", "<zone_password>")
              .execute(Request.Get("http://brdtest.com/myip.json").viaProxy(proxy))
              .returnContent().asString();
          System.out.println(res);
      }
  }
  ```

  ```perl Perl theme={null}
  #!/usr/bin/perl

  print 'To enable your free eval account and get CUSTOMER, YOURZONE and '
      .'YOURPASS, please contact sales@brightdata.com';
  use LWP::UserAgent;
  my $agent = LWP::UserAgent->new();
  $agent->proxy(['http', 'https'], "http://brd-customer-<customer_id>-zone-<zone_name>:<zone_password>\@brd.superproxy.io:44445");
  print $agent->get('http://brdtest.com/myip.json')->content();
  ```

  ```vb VBA theme={null}
  Imports System.Net

  Module Module1
      Sub Main()
          Console.WriteLine("To enable your free eval account and get " & 
              "CUSTOMER, YOURZONE and YOURPASS, please contact " &
              "sales@brightdata.com")
          Dim Client As New WebClient
          Client.Proxy = New WebProxy("http://brd.superproxy.io:44445")
          Client.Proxy.Credentials = New NetworkCredential("brd-customer-<customer_id>-zone-<zone_name>", "<zone_password>")
          Console.WriteLine(Client.DownloadString("http://brdtest.com/myip.json"))
      End Sub
  End Module
  ```
</CodeGroup>

The code above uses the residential proxy to send a request to [http://brdtest.com/myip.json.](http://brdtest.com/myip.json.) It returns your IP information in a JSON format:

```json Output theme={null}
{
  "ip": "ALLOCATED_IP",
  "country": "PK",
  "asn": {
    "asnum": 203020,
    "org_name": "HostRoyale Technologies Pvt Ltd"
  },
  "geo": {
    "city": "Islamabad",
    "region": "IS",
    "region_name": "Islamabad",
    "postal_code": "44040",
    "latitude": 33.7233,
    "longitude": 73.0435,
    "tz": "Asia/Karachi",
    "lum_city": "islamabad",
    "lum_region": "is"
  }
}
```

Now, replace “[https://brdtest.com/myip.json”](https://brdtest.com/myip.json”) with the website of your choice and ...

**That's it!**


# Why your DNS shows a different country
Source: https://docs.brightdata.com/proxy-networks/dns-location-mismatch

Why DNS leak tools show a different country than your Bright Data proxy IP, how 2-stage DNS resolution works and how to verify your actual exit geolocation.

If you are using Bright Data proxies and testing your setup with third-party tools, you may notice that the DNS resolver location shown by those tools appears different from your proxy IP's country. This is expected behavior in most cases. This article explains why it happens and what you can do about it.

## How DNS resolution works in Bright Data's proxy network

All requests made through Bright Data start by connecting to a Super Proxy (`brd.superproxy.io`). Two separate DNS resolutions happen at different stages of the request:

### Stage 1: Entry gate DNS check

When your request first arrives at the Super Proxy entry gate, a preliminary DNS resolution is performed. This check is done solely to verify that the target domain exists and is a valid destination. It is performed at the Super Proxy level, not at the exit node (your actual proxy IP).

### Stage 2: Exit node DNS resolution

Once the domain is confirmed as valid, the actual request is forwarded to the exit node: the proxy IP in your target country. A second, independent DNS resolution is performed at the exit node for the real request. This is the DNS resolution that matters for your actual traffic.

<Note>
  The preliminary DNS check at the entry gate does not affect how your actual request is routed. Your real traffic exits from your assigned proxy IP.
</Note>

## Why DNS leak test websites show a different DNS location

Some tools (such as whoer.net, browserleaks.com/ip, or whoerip.com) use JavaScript-based tests or DNS queries that interact with the entry gate DNS check rather than the actual exit node DNS. As a result:

* The DNS resolver shown by these tools may reflect a Bright Data Super Proxy location rather than your assigned proxy IP's country.
* This is not a reflection of where your actual browsing traffic exits.
* Your real requests exit from your assigned proxy IP.

This behavior is specific to how those tools probe for DNS information. It does not indicate a misconfiguration of your zone or your proxy credentials.

## Which IP checker should you use?

Use Bright Data's official endpoint to validate your proxy's geolocation:

```http theme={null}
https://geo.brdtest.com/welcome.txt
```

This endpoint accurately reflects the exit node IP for Datacenter and ISP networks, and its true geolocation for all proxy networks, as recorded in Bright Data's network.

Use the following `curl` command, adjusting the `product` parameter for your proxy type:

```sh theme={null}
curl -i --proxy brd.superproxy.io:44445 \
  --proxy-user brd-customer-<CUSTOMER_ID>-zone-<ZONE_NAME>:<ZONE_PASSWORD> \
  "https://geo.brdtest.com/welcome.txt?product=isp&method=native"
```

The response will show your actual assigned ISP/Datacenter IP and its correct location details, and the full location details without the explicit IP address for the Residential and Mobile networks.

<Note>
  Many third-party geolocation tools use outdated records or unreliable testing methods. Their results are not an accurate reflection of your proxy's actual geolocation. Bright Data actively monitors and maintains correct records in all major geolocation databases.
</Note>

## Will this affect your real target websites?

For your actual target domains, DNS is properly resolved at the exit node, and your traffic exits from your assigned proxy IP in the correct country.

You can verify this by running the `curl` command above with your proxy credentials.

## Why are requests failing with a `target_40001` error?

If your host is valid but cannot be resolved and you receive a `target_40001` error (host could not be resolved), the domain may only be resolvable from specific geographic locations. In this case, contact Bright Data support to request that your host be added to the DNS whitelist, so it can skip the Super Proxy entry gate DNS check.

See [Error Catalog: target\_40001](/proxy-networks/errorCatalog#target-40001) for the full error description.

## Recommendations for best DNS behavior

If your use case requires precise DNS matching between your proxy IP location and the DNS resolver shown by third-party tools, apply the following steps.

### Use the remote DNS resolution flag

Append `-dns-remote` to your proxy username to instruct the proxy to perform DNS resolution at the exit node:

```sh theme={null}
curl "https://example.com" \
  --proxy brd.superproxy.io:44445 \
  --proxy-user brd-customer-<CUSTOMER_ID>-zone-<ZONE_NAME>-dns-remote:<ZONE_PASSWORD>
```

<Note>
  The `-dns-remote` flag does not resolve cases where the entry gate DNS check returns a `dns_resolve_skip` result for specific domains. In those cases, the flag has no effect on what third-party tools report.
</Note>

### Ensure your client sends hostnames, not IP addresses

Bright Data's proxy network requires requests to use domain names, not pre-resolved IP addresses. If your browser, anti-detect browser (such as Multilogin), or application resolves DNS locally before sending the request, DNS mismatch behavior is more likely.

Configure your application to:

* Send the hostname or domain to the proxy, not a pre-resolved IP
* Use remote DNS resolution when that option is available in your application

### Request domain whitelisting for location-sensitive hosts

For domains that can only be resolved from specific geographic locations and as a result return a `target_40001` error from the Super Proxy DNS check, contact Bright Data support to whitelist the specific host. This allows it to skip the Super Proxy DNS check.

## Where to learn more

* [Error Catalog](/proxy-networks/errorCatalog) - Full list of Bright Data proxy error codes and resolutions
* [Website Blocking](/proxy-networks/website-blocking) - Best practices for overcoming website blocking
* [Residential Network Access Policy](/proxy-networks/residential/network-access) - KYC and access requirements for the Residential network


# Proxy errors troubleshooting
Source: https://docs.brightdata.com/proxy-networks/errorCatalog

Explore the catalog of Bright Data HTTP errors (4xx and 5xx codes), including error codes, descriptions and actions to resolve common proxy issues.

This article provides information on how to identify proxy errors from other errors, how to analyze errors, troubleshoot and resolve issues with Bright Data proxy services.

## How can I get indication on Bright Data proxy services health status?

Bright Data publishes its products and services status in this page: [https://brightdata.com/network-status](https://brightdata.com/network-status) . In this page you can see if there are current issues or incidents in the products you use or our global availability. You can also register for email alerts which are sent upon changes in our availability of reporting on wide incidents.

## What to do if I see that there is current incident in the proxy network I am using?

First, you need to check if your operations are impacted. Two main indications are degredation in response time (slowness) or increased error rates. If one of those occur, reduce your processing rate and follow the next steps to identify the issue.

## How can I tell if the error I got is originates from a Bright Data proxy?

While using our proxies, you may encounter errors that do not originate from Bright Data. To identify the source of the error, check if the response headers include BrightData error fields listed below, we cover most errors by proxy layer in those codes.

If you are still not able to get to your target website, or receive a response `HTTP` status `200` without the data you are expecting, you were probably blocked. In this article: [Overcoming website blocking](/proxy-networks/website-blocking) we provide some best practices.

## How to resolve "Proxy Error" when testing Bright Data proxies thru another software?

Many software tools and utilities use Bright Data proxies, and have a function to "Test proxy" in them. When you hit "Test proxy" and get a generic "Proxy Error" message in that software, it can originate from various reasons.

### Common issues and resolutions

* Targeting a search engine like [google.com](http://google.com) or [bing.com](http://bing.com): Bright Data lmits search engine access via its proxy networks. To resolve go to your software settings and change the test website to be: [https://geo.brdtest.com/welcome.txt](https://geo.brdtest.com/welcome.txt)
* Using Bright Data residential network without installing a certificate: Bright Data does not allow using its Residential netowork without passing a KYC verification or installing a certificate. Read on different access modes [Residential Network Access Policy. ](/proxy-networks/residential/network-access)

## Bright Data Proxy Errors Troubleshooting

## Bright Data's proxy error format and standard now supports RFC9209

Starting October 2025, Bright Data supports two sets of headers to relay proxy error in response payload:

1. Propietary `x-brd-*` fields: `x-brd-err-code` and `x-brd-err-msg`
2. Standard RFC9209`Proxy-Status` response header supporting RFC9209 standard proxy error format.

The `Proxy-Status` header standard field will eventually replace the `x-brd-*` fields, during 2026.

## What is RFC9209?

RFC9209 is the standard on how to relay proxy errors in response headers over proxy. Bright Data is adopting this standard and applied it to all its error catalog. This will allow customers' code as well as 3rd party tools using proxy as infrastructure to refer to error from proxy interaction and resolve issues faster.

You can read more about it here: [The Proxy-Status HTTP Response Header](https://www.rfc-editor.org/rfc/rfc9209.html)

## How to implelement RFC9209?

### Example Proxy-Status HTTP header

```text theme={null}
Proxy-Status: brd.brighdata.io; 
received-status=400; 
error=destination_ip_unroutable; 
details="client-10060: Requested IP ##.##.##.## is not allocated to this zone. Select an IP that is allocated to this zone or skip the -ip parameter in proxy username."
```

### Implementation Instructions

1. Parse the response header: Ensure that your systems are configured to interpret the Proxy-Status header in HTTP responses.
2. Extract relevant fields:
   * `received-status`: Provides the HTTP status code received.
   * `error`: Describes the general error encountered.
   * `details`: Contains specific error codes and further information from our error catalog.
   * The first field in the details will be bright data error code (like: client\_10060) followed by ':' (colon) delimiter. 
   * You can browse directly to the error document using this prefix, keeping the error code exactly as shown, including the '\_' (underscore): `https://docs.brightdata.com/proxy-networks/errorCatalog#[Bright data error code]`. Example for client\_10060: [https://docs.brightdata.com/proxy-networks/errorCatalog#client\_10060](/proxy-networks/errorCatalog#client_10060)
3. Adapt your error handling processes according to these structured codes to improve debugging and ensure a seamless proxy operation.

## Bright Data HTTP proxy header fields

The following fields are returned upon and `HTTP` or `HTTPS` requests:

| Field            | Description                                                                                                                                                        | Examples                                                                                                                                                                                                                                  | REST API Field Name |
| :--------------- | :----------------------------------------------------------------------------------------------------------------------------------------------------------------- | :---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | :------------------ |
| `HTTP Error`     | The protocol error numbers                                                                                                                                         | `404` or `502`                                                                                                                                                                                                                            | `status_code`       |
| `x-brd-err-code` | Bright data module and error code number                                                                                                                           | `client_10001`                                                                                                                                                                                                                            | `error_code`        |
| `x-brd-error`    | Bright data main error message                                                                                                                                     | Authentication failed                                                                                                                                                                                                                     | `error`             |
| `x-brd-err-msg`  | Bright data elaborated message and actions                                                                                                                         | Authentication failed. Please check your credentials or review your [account status and billing settings](https://brightdata.com/cp/settings/billing).                                                                                    | `error_message`     |
| `Proxy-Status`   | RFC9209 compliant response header. It will include Bright Data proxy server, the HTTP status and details string which has a reference to Bright Data's error code. | `Proxy-Status: brd.superproxy.io; received-status=407; error="http_request_denied"; details="client_10000: Invalid authentication: check credentials and retry. Bright Data credentials include your account ID, zone name and password"` | Not supported       |

The headers are relayed as part of Bright Data proxy service and customers are not billed for their bandwidth overhead.

### Deprecating x-luminati-\* headers

Starting 1-May-2026 Bright Data proxy response will not include any x-luminati-\* headers.

#### HTTP Code 200 headers deprecating

| Header                | Current header   | Description                                             |
| :-------------------- | :--------------- | ------------------------------------------------------- |
| `x-luminati-ip`       | `x-brd-ip`       | IP address of the proxy peer used to relay your request |
| `x-luminati-timeline` | `x-brd-timeline` | Internal request processing timeline for debugging      |

#### HTTP Error Code headers deprecating

| **Header**         | **Current header** | **Description**         |
| :----------------- | :----------------- | :---------------------- |
| `X-Luminati-Error` | `x-brd-error`      | Short error description |

### Getting HTTP header fields

#### Testing from command line

To view and test your settings, or restoring an issue, you can run a `curl` command from your shell prompt and add the option flag `-v` or `i`. These flags will run curl in verbose mode and print out the header fields, including the custom error code and message.

```sh theme={null}
curl -v [rest of curl command options]
```

To see a more compact view with the header fields response only use the `-i` option for curl:

```sh theme={null}
curl -i [rest of curl command options]
```

Alternatively, you can use the `nc` command to get the fields printed to screen:

```sh theme={null}
echo "[tcp nc inputs]" | nc -C -v brd.superproxy.io 44445
```

<Note>
  `nc` inputs may include "empty" lines, those are essential for correct testing using `nc` command
</Note>

#### `curl` Command snippet

`curl` command snippet, with all required zone parameters is available in the **Overview** tab in Bright Data control panel for the zone you are working on.

#### Accessing via programming language

Bright Data HTTP header fields can be accessed thru your programming language, as any other HTTP header field.

#### Accessing via Bright Data's Proxy REST API

Bright data offers a REST API to access its proxy networks as well as the Web Unlocker API and our SERP for targeting search engines. The error field names are slightly different , yet the content is identical.

Example response:

```JSON theme={null}
"status_code": 407,
"status_message": "Proxy Authentication Required",
"error": "Proxy Authentication Required",
"error_message": "No proxy credentials provided. Please add credentials and try again.",
"error_code": "client_10010"
```

## Error Catalog

### HTTP Error 400

When Using the Data center/ISP or gIPs products with the `-ip-x.x.x.x` targeting flag, the error code `400` can appear in case the IPs under your zone has been refreshed, removed, or simply changed due to system updates

<Note>
  This error typically arises after your BrightData account has been recently suspended. An automatic suspension occurs if your account balance becomes negative. If the suspension extends beyond 24 hours, the static allocated IPs will be released from your account. Upon reactivation, the reallocated IPs may differ from the original ones, thus if the previously allocated IPs are still being targeted - this error is thrown.
</Note>

Whenever this error appears, you should go to your Bright Data Zones page, and view the updated list of IPs relevant to this zone.

#### `client_10060`

| `x-brd-error`                            | `x-brd-err-msg`                                                                                                                                      | RFC9209 Error Code          |
| :--------------------------------------- | :--------------------------------------------------------------------------------------------------------------------------------------------------- | :-------------------------- |
| `ip_requested_not_allocated_by_customer` | Requested IP `##.##.##.##` is not allocated to this zone. Select an IP that is allocated to this zone or skip the `-ip` parameter in proxy username. | `destination_ip_unroutable` |

#### `client_10061`

| `x-brd-error`  | `x-brd-err-msg`                                                                                                                                                                                                                                 | RFC9209 Error Code |
| :------------- | :---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | :----------------- |
| Peer not found | No proxy found in selected default countries: `%Countries_list%`. Please revise your default country selection or use `-country` flag to another country and override default settings. [Read more](/api-reference/proxy/geolocation-targeting) | ,                  |

#### `client_10062`

| `x-brd-error`  | `x-brd-err-msg`                                                                                                                                                                                                                                                                                                 | RFC9209 Error Code |
| :------------- | :-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | :----------------- |
| Peer not found | Your \`\[proxy type] \[DC \| ISP]\` zone does not have IPs in selected countries. Either IPs location has changed, or zone is not configured with proxies in selected countries. Check zone configuration and try again with the relevant country code. [Read more](/api-reference/proxy/geolocation-targeting) | ,                  |

#### `client_10063`

| `x-brd-error` | `x-brd-err-msg`                                                                                                             | RFC9209 Error Code |
| :------------ | :-------------------------------------------------------------------------------------------------------------------------- | :----------------- |
| Bad IP format | The IP address provided is either empty or does not comply with IPv6/IPv4 protocol. Please check your inputs and try again. | ,                  |

***

### HTTP Error 401

These are the `x-brd-err-code` values for HTTP error 401:

#### `client_10050`

| `x-brd-error`                     | `x-brd-err-msg`                                                                                                                                                        |
| :-------------------------------- | :--------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Auth failed: IP denylisted `[IP]` | Auth Failed IP denylisted: `[IP]`. [Check FAQ: how to denylist/allowlist IPs and domains?](/proxy-networks/faqs#how-to-allowlist-denylist-ips-and-domains) to resolve. |

***

### HTTP Error 402

These are the `x-brd-err-code` values for HTTP error 402:

<Note>
  The 402 errors below apply to Residential zones created on or before July 7, 2026 and remain valid for those existing zones. They do not apply to Residential zones created after July 7, 2026, which require KYC. See the [Residential network access policy](/proxy-networks/residential/network-access).
</Note>

#### `policy_20130`

| `x-brd-error`                     | `x-brd-err-msg`                                                                                                                                                                                                                                                                                                    |
| :-------------------------------- | :----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Residential Failed `bad_endpoint` | Residential Failed (`bad_endpoint`), Requested site is not available for immediate residential (no KYC) access mode because `%HTTP_METHOD%` requests are not allowed. To get full residential access for targeting this site, fill in the KYC form: [https://brightdata.com/cp/kyc](https://brightdata.com/cp/kyc) |

#### `policy_20140`

| `x-brd-error`                     | `x-brd-err-msg`                                                                                                                                                                                                                                                                                             |
| :-------------------------------- | :---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Residential Failed `bad_endpoint` | Requested site is not available in Immediate Access mode for Bright Data residential network due to violation of target's `robots.txt`. To gain full access follow the instructions in: [https://docs.brightdata.com/proxy-networks/residential/network-access](/proxy-networks/residential/network-access) |

***

### HTTP Error 403

HTTP 403 response code means you are forbidden from accessing a **valid** URL. The server processed the request, but it can't fulfill the request either due to the way the request was sent by the client or due to Bright Data policy, blocking target access.

These are the `x-brd-err-code` values for HTTP error 403:

#### `kyc_required`

A request through a Residential zone created after July 7, 2026 from a company-email account that has not completed KYC returns HTTP 403. Residential access is available only to KYC-verified companies. Residential zones created on or before July 7, 2026 are not affected.

**How to fix:** Complete [KYC verification](https://brightdata.com/cp/kyc) so the Bright Data compliance team can approve Residential access. Until then, use [ISP proxies](/proxy-networks/isp/introduction) or [Datacenter proxies](/proxy-networks/data-center/introduction), which need no KYC. See the [Residential network access policy](/proxy-networks/residential/network-access).

The response body carries the stable `code` value plus the alternatives to create instead:

```json theme={null}
{
  "error": {
    "code": "kyc_required",
    "message": "Residential proxies are available to verified companies only, after KYC review, in accordance with Bright Data's compliance policy.",
    "action": "Start verification at brightdata.com/cp/kyc. Applications are reviewed by our compliance team.",
    "alternatives": [
      { "product": "ISP proxy", "plan": { "type": "static", "pool_ip_type": "static_res", "ips_type": "shared" } },
      { "product": "Web Unlocker API", "plan": { "type": "unblocker" } }
    ],
    "docs": "https://docs.brightdata.com/compliance/kyc"
  }
}
```

#### `business_account_required`

A request through a Residential zone created after July 7, 2026 from a personal-email account (not a verified company) returns HTTP 403. Residential access is available to verified companies only. Residential zones created on or before July 7, 2026 are not affected.

**How to fix:** Personal-email accounts are not eligible for Residential and are not offered KYC. Use a corporate email and contact the Bright Data team to establish business eligibility. Until then, use [ISP proxies](/proxy-networks/isp/introduction) or [Datacenter proxies](/proxy-networks/data-center/introduction), which need no KYC. See the [Residential network access policy](/proxy-networks/residential/network-access).

```json theme={null}
{
  "error": {
    "code": "business_account_required",
    "message": "Residential proxies are available to verified companies only. Eligibility requires a corporate email and full verification with the Bright Data team.",
    "action": "Contact the Bright Data team with a corporate email to determine business eligibility for Residential access.",
    "alternatives": [
      { "product": "ISP proxy", "plan": { "type": "static", "pool_ip_type": "static_res", "ips_type": "shared" } },
      { "product": "Web Unlocker API", "plan": { "type": "unblocker" } }
    ],
    "docs": "https://docs.brightdata.com/compliance/kyc"
  }
}
```

#### `client_10070`

| `x-brd-error` | `x-brd-err-msg`                                                                        |
| :------------ | :------------------------------------------------------------------------------------- |
| No Protocol   | Protocol was missing from original request. Please add either HTTP or HTTPS and retry. |

#### `client_10080`

| `x-brd-error`       | `x-brd-err-msg`                                                                                             |
| :------------------ | :---------------------------------------------------------------------------------------------------------- |
| No Destination Host | No destination host. Destination host is missing or incorrect. Check your request parameters and try again. |

#### `client_10090`

| `x-brd-error`                                           | `x-brd-err-msg`                                                                                                                                                                                                                      |
| :------------------------------------------------------ | :----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| You are trying to use Browser API zone as regular proxy | You are trying to use Browser API zone as regular proxy. A browser should be used to access this zone. See [Browser API](/scraping-automation/scraping-browser/introduction) for information on how to access your Browser API zone. |

#### `client_10130`

| `x-brd-error`                                                                 | `x-brd-err-msg`                                                                                                              |
| :---------------------------------------------------------------------------- | :--------------------------------------------------------------------------------------------------------------------------- |
| Forbidden: this super proxy is allowed only for China domains via China peers | Forbidden: this super proxy is allowed to be used only for China domains via China peers. Otherwise use `brd.superproxy.io`. |

#### `client_10250`

| `x-brd-error`                                           | `x-brd-err-msg`                                                                                                                                                                                                                                   |
| :------------------------------------------------------ | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| Forbidden: You tried to target `%HOST%` but got blocked | Forbidden: You tried to target `%HOST%` but got blocked since this host is not an allowed target in your zone's allowlist security setting. Please add this host to your allowlist or delete all content from the allowlist to allow all targets. |

#### `client_10260`

| `x-brd-error`                                           | `x-brd-err-msg`                                                                                                                                                                                                                                            |
| :------------------------------------------------------ | :--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Forbidden: You tried to target `%HOST%` but got blocked | Forbidden: You tried to target `%HOST%` but got blocked since this host is an explicitly blocked target in your zone's denylist security setting. Please remove this host from your denylist or delete all content from the denylist to allow all targets. |

#### `policy_20010`

| `x-brd-error` | `x-brd-err-msg`                                                                                                                                                           |
| :------------ | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| Bad protocol  | The protocol you are using to access our proxy is not supported. Bright Data supports HTTP, HTTPS & SOCKS5 upon special approval. Please fix your protocol and try again. |

#### `policy_20020`

| `x-brd-error` | `x-brd-err-msg`                                                                                                                                                                               |
| :------------ | :-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Bad port      | Bad port used. See supported ports: [https://docs.brightdata.com/proxy-networks/faqs#how-to-see-supported-ports-and-protocols](/proxy-networks/faqs#how-to-see-supported-ports-and-protocols) |

#### `policy_20021`

| `x-brd-error`                                                       | `x-brd-err-msg`                                                                                                                                                      |
| :------------------------------------------------------------------ | :------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Forbidden: Target is blocked by Bright Data for superproxy requests | Request was rerouted through a superproxy due to compliance policy, but was then blocked because the destination port is forbidden for requests from the superproxy. |

#### `policy_20030`

| `x-brd-error`             | `x-brd-err-msg`                                                                                                                                                                                                                               |
| :------------------------ | :-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Forbidden: target blocked | Forbidden: You tried to target `www.somehost.com` but got blocked. It can be related to your denylist or allowlist settings or the target site is not allowed by Bright Data policy. [Read more](/proxy-networks/faqs#what-is-error-code-403) |

#### `policy_20031`

| `x-brd-error`                         | `x-brd-err-msg`                                                                                                                                                                                                                                                 |
| :------------------------------------ | :-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Forbidden: Target `%HOST%` is blocked | Forbidden: target `%HOST%` is blocked by Bright Data. Target host provides web service or information of Bright Data and our proxies cannot be used to target it. For further assistance please contact [support@brightdata.com](mailto:support@brightdata.com) |

#### `policy_20032`

| `x-brd-error`                         | `x-brd-err-msg`                                                                                                                                                                                                                                                 |
| :------------------------------------ | :-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Forbidden: Target `%HOST%` is blocked | Forbidden: target `%HOST%` is blocked by Bright Data. Target host provides web service or information of Bright Data and our proxies cannot be used to target it. For further assistance please contact [support@brightdata.com](mailto:support@brightdata.com) |

#### `policy_20040`

| `x-brd-error`  | `x-brd-err-msg`                                                                                                                                                                                                                                                                              |
| :------------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Forbidden host | Destination host is blocked either by Bright Data in accordance with our compliance policy or by your account rules' configuration. Please check if this domain is allowed for targeting by this zone in zone settings: [https://brightdata.com/cp/zones/](https://brightdata.com/cp/zones/) |

#### `policy_20050`

| `x-brd-error`                                                                          | `x-brd-err-msg`                                                                                                                                                                                                                                                                                                                                         |
| :------------------------------------------------------------------------------------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| Forbidden: target site requires special permission. Contact Bright Data for assistance | Forbidden: target site requires special permission. You are trying to access a target site which is not permitted by our compliance policy. You may need to undergo a KYC process: [https://brightdata.com/cp/kyc](https://brightdata.com/cp/kyc). If you have already completed KYC approval, please contact your account manager for further details. |

#### `policy_20051`

| `x-brd-error`                                                                          | `x-brd-err-msg`                                                                                                                                                                                                                                                                                     |
| :------------------------------------------------------------------------------------- | :-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Forbidden: target site requires special permission. Contact Bright Data for assistance | Forbidden: target site is a government site and requires special permissions to access. You may need to undergo a KYC process: [https://brightdata.com/cp/kyc](https://brightdata.com/cp/kyc). If you have already completed KYC approval, please contact your account manager for further details. |

#### `policy_20052`

| `x-brd-error`                                                                                  | `x-brd-err-msg`                                                                                                                                                                                                                                                                                                                                                                                            |
| :--------------------------------------------------------------------------------------------- | :--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Forbidden: target site not accessible via selected network. Contact Bright Data for assistance | Forbidden: Access to this site is restricted on the selected network type due to compliance policies. Please try switching to a different network type. To gain access on the same network you may need to undergo a KYC process: [https://brightdata.com/cp/kyc](https://brightdata.com/cp/kyc). If you have already completed the KYC approval, please contact your account manager for further details. |

#### `policy_20080`

| `x-brd-error`                                                 | `x-brd-err-msg`                                                                                                                                                               |
| :------------------------------------------------------------ | :---------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Forbidden: request needs to be made using residential network | Forbidden: You are accessing a domain which is not permitted to access by Bright Data Datacenter or ISP networks. Please retry your request using a Residential network zone. |

#### `policy_20090`

| `x-brd-error`                                                           | `x-brd-err-msg`                                                                                                                                                                                                               |
| :---------------------------------------------------------------------- | :---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Forbidden: requests to this domain are blocked using the proxy networks | Forbidden: requests to this domain are blocked using the Datacenter, ISP and Residential proxy networks. Please get access via an Web Unlocker API zone or IDE tools, or contact your account manager for further assistance. |

#### `policy_20091`

| `x-brd-error`                                                        | `x-brd-err-msg`                                                                                                                              |
| :------------------------------------------------------------------- | :------------------------------------------------------------------------------------------------------------------------------------------- |
| Forbidden: Target `$host` is blocked by Bright Data on IPv6 protocol | Forbidden: Target `$host` is blocked by Bright Data on IPv6 protocol. Please try IPv4 proxies or our Web Unlocker API to access this target. |

#### `policy_20110`

| `x-brd-error`         | `x-brd-err-msg`                                                                                                                                                                                                                                                                              |
| :-------------------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Forbidden SERP domain | Destination host is blocked either by Bright Data in accordance with our compliance policy or by your account rules' configuration. Please check if this domain is allowed for targeting by this zone in zone settings: [https://brightdata.com/cp/zones/](https://brightdata.com/cp/zones/) |

#### `policy_20230`

| `x-brd-error`                                      | `x-brd-err-msg`                                                                           |
| :------------------------------------------------- | :---------------------------------------------------------------------------------------- |
| Country `%COUNTRY%` is not permitted for targeting | Country `%COUNTRY%` is not permitted for targeting, please modify to a different country. |

#### `policy_20240`

| `x-brd-error`                     | `x-brd-err-msg`                                                                                  |
| :-------------------------------- | :----------------------------------------------------------------------------------------------- |
| Proxy port `%PORT%` is restricted | Proxy port `%PORT%` is restricted. Contact [Bright Data support](mailto:support@brightdata.com). |

#### `policy_20250`

| `x-brd-error`                                           | `x-brd-err-msg`                                                                                                                                                                                                |
| :------------------------------------------------------ | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Forbidden: You tried to target `%HOST%` but got blocked | Forbidden: You tried to target `%HOST%` but got blocked by Bright Data policy settings. Either this website is forbidden by Bright Data policy or your account doesn't have the right permission to access it. |

#### `policy_20251`

| `x-brd-error`                                           | `x-brd-err-msg`                                                                                                                                                                                                |
| :------------------------------------------------------ | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Forbidden: You tried to target `%HOST%` but got blocked | Forbidden: You tried to target `%HOST%` but got blocked by Bright Data policy settings. Either this website is forbidden by Bright Data policy or your account doesn't have the right permission to access it. |

#### `policy_20260`

| `x-brd-error`                                           | `x-brd-err-msg`                                                                                                                                                                                                |
| :------------------------------------------------------ | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Forbidden: You tried to target `%HOST%` but got blocked | Forbidden: You tried to target `%HOST%` but got blocked by Bright Data policy settings. Either this website is forbidden by Bright Data policy or your account doesn't have the right permission to access it. |

#### `policy_20261`

| `x-brd-error`                                           | `x-brd-err-msg`                                                                                                                                                                                                |
| :------------------------------------------------------ | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Forbidden: You tried to target `%HOST%` but got blocked | Forbidden: You tried to target `%HOST%` but got blocked by Bright Data policy settings. Either this website is forbidden by Bright Data policy or your account doesn't have the right permission to access it. |

#### `policy_20000`

| `x-brd-error`                                                                   | `x-brd-err-msg`                                                                                                                                                                                                       |
| :------------------------------------------------------------------------------ | :-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Access denied: `<URL>` is classified as `<category>` and blocked by Bright Data | Access denied: `%URL%` is classified as `%CATEGORY%` and blocked by Bright Data as it might breach Bright Data usage policy. [Read more](/proxy-networks/residential/network-access#residential-proxy-network-policy) |

***

### HTTP Error 407

If you get HTTP error 407, this implies there is an error in authentication. This can be due to incorrect credentials or due to your account being suspended.

#### `client_10000`

| `x-brd-error`         | `x-brd-err-msg`                                                                                                               |
| :-------------------- | :---------------------------------------------------------------------------------------------------------------------------- |
| Authentication failed | Invalid authentication: check credentials and retry. Bright Data credentials include your account ID, zone name and password. |

#### `client_10001`

| `x-brd-error` | `x-brd-err-msg`                                      |
| :------------ | :--------------------------------------------------- |
| Invalid Auth  | Invalid authentication: check credentials and retry. |

#### `client_10002`

| `x-brd-error`               | `x-brd-err-msg`                                                                                                                                                                                                                                                                                                  |
| :-------------------------- | :--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Auth failed: Zone not found | Authentication failed: zone not found. Zone name used is either misspelled, or zone is disabled or deleted. Check your inputs, and validate zone is "Active" in Bright Data control panel, or use our API to get current zone status: [Get Active Zones](/api-reference/account-management-api/Get_active_Zones) |

#### `client_10010`

| `x-brd-error`                 | `x-brd-err-msg`                                                      |
| :---------------------------- | :------------------------------------------------------------------- |
| Proxy Authentication Required | No proxy credentials provided. Please add credentials and try again. |

#### `client_10020`

| `x-brd-error`                                                                                     | `x-brd-err-msg`                                                                                    |
| :------------------------------------------------------------------------------------------------ | :------------------------------------------------------------------------------------------------- |
| Account is suspended. [Login](https://brightdata.com/cp/setting/billing) to activate your account | Account is suspended. [Login](https://brightdata.com/cp/setting/billing) to activate your account. |

#### `client_10030`

| `x-brd-error`         | `x-brd-err-msg`                                                                                      |
| :-------------------- | :--------------------------------------------------------------------------------------------------- |
| Authentication failed | You are not allowed to access our API via this IP. Please verify your settings or allowlist this IP. |

#### `client_10040`

| `x-brd-error`                                                                                                       | `x-brd-err-msg`                                                                                                      |
| :------------------------------------------------------------------------------------------------------------------ | :------------------------------------------------------------------------------------------------------------------- |
| KYC Required. Please visit [http://brightdata.com/cp/kyc](http://brightdata.com/cp/kyc) and ensure you are verified | KYC Required. Please visit [http://brightdata.com/cp/kyc](http://brightdata.com/cp/kyc) and ensure you are verified. |

#### `policy_20120`

| `x-brd-error`                                                            | `x-brd-err-msg`                                                                     |
| :----------------------------------------------------------------------- | :---------------------------------------------------------------------------------- |
| IP parameter `<IP>` is incorrect, use correct format in the IP parameter | IP parameter `<IP>` is incorrect, use `x-brd-ip` header format in the IP parameter. |

***

### HTTP Error 408

If you get HTTP error 408, this implies there is a timeout error in reaching your destination website. This can be due to incorrect target website, networking lags or blocks.

#### `peer_30040`

| `x-brd-error`           | `x-brd-err-msg`                                 |
| :---------------------- | :---------------------------------------------- |
| Peer connection timeout | Peer did not connect to desitnation due timeout |

***

### HTTP Error 429

<Note>
  If you are using an unfunded account, you may be hitting the default rate limit of 1,000 requests per minute. You can verify your currently applied limit in the Control Panel, under the zone's Overview tab > Access details. Adding funds to your account will remove this default restriction.
</Note>

These are the `x-brd-err-code` values for HTTP error 429:

#### `client_10110`

| `x-brd-error`                            | `x-brd-err-msg`                                                                                                                                                                                                                            |
| :--------------------------------------- | :----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Account exceeded the allowed rate limits | Your account exceeded the allowed rate limits. Reduce requests rate and try again or complete the [verification process](https://brightdata.com/cp/account_verification) to relieve rate limits. You will not be charged for this request. |

#### `policy_20220`

| `x-brd-error`                        | `x-brd-err-msg`                                                                                                                                                                                                                                                     |
| :----------------------------------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| Requests rate to `%URL%` is too high | Rate limit for domain `%DOMAIN%` has been reached. Bright Data's health monitor is throttling down these requests to prevent overloading of the target website. Reduce requests rate and try again or contact [brightdata.com](http://brightdata.com/) for support. |

#### `policy_20221`

| `x-brd-error`                                         | `x-brd-err-msg`                                                                                                                                                  |
| :---------------------------------------------------- | :--------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Requests to IP geolocation databases are rate-limited | Requests to IP geolocation database providers are rate-limited. Use Bright Data's geolocation endpoint with no rate limits: `https://geo.brdtest.com/mygeo.json` |

#### `policy_20222`

| `x-brd-error`                    | `x-brd-err-msg`                                                                                                                                                                                                                                                                                  |
| :------------------------------- | :----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Requests rate per IP is too high | Rate limit per IP `%IP%` on zone `%ZONE%` has been reached. Requests are throttled down to avoid overload. Either increase the number of IPs or reduce rate, and review your rotation logic or your response size to assure even distribution of requests and bandwidth across IPs of this zone. |

#### `policy_20223`

Returned when Bright Data applies an adaptive rate limit for a specific domain due to degraded success rates. The limit is adjusted dynamically, so retrying failed requests is expected and helps the limit lift faster as success rates recover.

| `x-brd-error`                           | `x-brd-err-msg`                                                                                                                                                                                                                                               |
| :-------------------------------------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| Requests to `%DOMAIN%` are rate-limited | Requests to `%DOMAIN%` are rate-limited. Bright Data has detected a degraded success rate for this domain and is working to resolve it. We recommend to retry failed requests while we gradually remove the limit, or reduce request rate and try again later |

***

### HTTP Error 499

These are the `x-brd-err-code` values for HTTP error 499:

#### `client_10140`

| `x-brd-error`     | `x-brd-err-msg`                                                                                                                                                                                                                                                                                    |
| :---------------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Client disconnect | The client closed the connection to the proxy before the response was fully returned. This is usually caused by client-side timeouts, cancelled requests, or local network interruptions. Review your client timeout configuration and ensure the client waits long enough for the proxy response. |

***

### HTTP Error 502

These are the `x-brd-err-code` values for HTTP error 502:

#### `client_10120`

| `x-brd-error`      | `x-brd-err-msg`                                                                                                                                                                                                                                |
| :----------------- | :--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Block direct route | Request reroute blocked. You chose the option not to reroute requests through our superproxy on failure, so the reroute was blocked. To see more about this setting see: [Request Error Handling](/api-reference/proxy/request_error_handling) |

#### `client_10100`

| `x-brd-error`                | `x-brd-err-msg`                                                                                                                         |
| :--------------------------- | :-------------------------------------------------------------------------------------------------------------------------------------- |
| Zone has reached usage limit | Zone has reached usage limit. Go to [https://brightdata.com/cp/zones](https://brightdata.com/cp/zones) to remove/modify the limitation. |

#### `peer_30030`

| `x-brd-error`                                                 | `x-brd-err-msg`                                                                                                                                                                                                                   |
| :------------------------------------------------------------ | :-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Proxy Error: We do not have proxies in the city you requested | Proxy Error: We do not have proxies in the city you requested. Please check the spelling or try again later. Check [Target a specific city](/proxy-networks/faqs#how-to-target-a-specific-city) for proper use of city targeting. |

#### `policy_20070`

| `x-brd-error`                        | `x-brd-err-msg`                                                                                 |
| :----------------------------------- | :---------------------------------------------------------------------------------------------- |
| Host is blocked in requested country | Host you are trying to access is blocked in requested country. Please change country and retry. |

#### `target_40001`

| `x-brd-error`                   | `x-brd-err-msg`                                                                                                                                                                                           |
| :------------------------------ | :-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Could not resolve host `%HOST%` | Could not resolve host `%HOST%`. Check host name is correctly spelled and retry. If host is properly spelled or can only be resolved from a specific region, contact Bright Data support for DNS support. |

#### `target_40011`

| `x-brd-error`                                    | `x-brd-err-msg`                                                                                                                                                             |
| :----------------------------------------------- | :-------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| No IPv6 address (AAAA record) found for `%HOST%` | Attempting to resolve `%HOST%` to IPv6 failed. This is probably because the host you are targeting does not publish an IPv6 IP address. Retry the request on an IPv4 proxy. |

#### `target_40020`

| `x-brd-error`                    | `x-brd-err-msg`                                                                                                                                                                           |
| :------------------------------- | :---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Destination host connect timeout | Connection to `host:port` timed out, the target server did not respond, which may indicate it is down, overloaded, or blocking connections; please verify the URL and port and try again. |

#### `target_40021`

| `x-brd-error`                    | `x-brd-err-msg`                                                                                                                                                                           |
| :------------------------------- | :---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Destination host connect timeout | Connection to `host:port` timed out, the target server did not respond, which may indicate it is down, overloaded, or blocking connections; please verify the URL and port and try again. |

#### `target_40021`

| `x-brd-error`                    | `x-brd-err-msg`                                                                                                                                                                           |
| :------------------------------- | :---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Destination host connect timeout | Connection to `host:port` timed out, the target server did not respond, which may indicate it is down, overloaded, or blocking connections; please verify the URL and port and try again. |

***


# Proxy products FAQ
Source: https://docs.brightdata.com/proxy-networks/faqs

FAQs on integrating, configuring and using Bright Data's proxy products (195 countries), including IP types, geotargeting and error codes across the platform.

<AccordionGroup>
  <Accordion title="What exactly is a zone and how important is the zone name?">
    In bright data, a "zone" represents a specific product and its configuration settings. You can think of it as an instance in the context of cloud computing.

    For example, you can have a zone for Datacenter proxy in Germany and you can have a separate zone for Datacenter proxies in France.

    Every zone has a name and one or more password, allowing you to interact with it.

    The zone name itself cannot be changed once it's configured, so you may want to use an easy to remember name that represents what you're trying to achieve. Keep in mind, that you can add a description to the zone, and you can change that description anytime. You can find it under the zone name at the top of the page.

    The zone name is used to create your proxy username, which you can then [customise if you want in order to control your proxies](/proxy-networks/config-options). Here is a sample proxy username for proxies in the USA - as you can see it includes the zone name inside it:

    `brd-customer-<customer_id>-zone-<zone_name>-country-us`

    As mentioned, you cannot change the name of the zone after you have saved it - if you want to change the name, simply create a new with a new name.
  </Accordion>

  <Accordion title="Integration with 3rd party tools">
    Bright data can be easily integrated into many third-party tools. In general, simply configure an HTTP/HTTPS proxy using the credentials for your Bright Data product. If you are using residential proxies, Web Unlocker API or SERP API don't forget to [use the SSL certificate](/general/account/ssl-certificate) to ensure and to end encrypted connections.

    <Warning>
      Residential proxies require a [KYC-verified business account](/proxy-networks/residential/network-access). Some third-party tools also cannot install the Bright Data SSL certificate, so integration with Residential proxies may not be possible in those tools. Without KYC, use [ISP or Datacenter proxies](/proxy-networks/residential/network-access#what-can-i-use-without-kyc).
    </Warning>

    We have prepared detailed guides for the most commonly used tools. You can find links to the guides in the list below:

    * [BrowserScan](/integrations/browserscan)
    * [XLogin](/integrations/xlogin)
    * [GeeLark](/integrations/geelark)
    * [Puppeteer](/integrations/puppeteer)
    * [Playwright](/integrations/playwright)
    * [Selenium](/integrations/selenium)
    * [AdsPower](/integrations/adspower)
    * [Dolphin Anty](/integrations/dolphin-anty)
    * [Incogniton](/integrations/incogniton)
    * [Marketerbrowser](/integrations/marketerbrowser)
    * [SMLOGIN](/integrations/smlogin)
    * [Hidemyacc](/integrations/hidemyacc)
    * [OpenBullet](/integrations/openbullet)
    * [Switchyomega](/integrations/switchyomega)
    * [PhantomBuster](/integrations/phantombuster)
    * [BitBrowser](/integrations/bitbrowser)
    * [Maskfog](/integrations/maskfog)
    * [Ghost Browser](/integrations/ghost-browser)
    * [Postman](/integrations/postman)
    * [NGINX](/integrations/nginx)
    * [StablerSOLO](/integrations/stablersolo)
    * [VMLogin](/integrations/vmlogin)
    * [GoLogin](/integrations/gologin)
    * [Windows](/integrations/windows)
    * [Scrapy](/integrations/scrapy)
    * [AEZAKMI](/integrations/aezakmi)
    * [Beautifulsoup](/integrations/beautifulsoup)
    * [WebHarvy](/integrations/webharvy)
    * [Ubuntu](/integrations/ubuntu)
    * [Lalicat](/integrations/lalicat)
    * [Multilogin](/integrations/multilogin)
    * [Undetectable](/integrations/undetectable)
    * [Apify](/integrations/apify)
    * [iPhone](/integrations/ios)
    * [MuLogin](/integrations/mulogin)
    * [Changedetection](/integrations/changedetection)
    * [Morelogin](/integrations/morelogin)
    * [Proxifier](/integrations/proxifier)
    * [Texau](/integrations/texau)
    * [Android](/integrations/android)
    * [Kameleo](/integrations/kameleo)
    * [Screaming Frog](/integrations/screaming-frog)
    * [Foxy](/integrations/foxyproxy)
    * [SessionBox](/integrations/sessionbox)
    * [Insomniac](/integrations/insomniac)
    * [Helium Scraper](/integrations/helium-scraper)
    * [SaleFreaks](/integrations/salefreaks)
    * [Postern](/integrations/postern)
    * [Antik](/integrations/antik)
    * [Easync](/integrations/easync)
    * [ParseHub](/integrations/parsehub)
    * [Sphere Browser](/integrations/sphere-browser)
    * [Octoparse](/integrations/octoparse)
    * [ixBrowser](/integrations/ixbrowser)
    * [Shadowrocket](/integrations/shadowrocket)
    * [Firefox](/integrations/firefox)
    * [Chrome](/integrations/chrome)
    * [MacOS](/integrations/macos)
    * [ClonBrowser](/integrations/clonbrowser)
    * [Octo Browser](/integrations/octobrowser)
    * [Genlogin](/integrations/genlogin)
    * [Web Scraper](/integrations/webscraper)

    If the integration you're using does not appear on the list and you would like to get a guide for it, contact us!
  </Accordion>

  <Accordion title="What are IP Types for Residential and Mobile Proxy?">
    There are two types of IPs that we offer within our Residential and Mobile Proxy:

    <Tabs>
      <Tab title="Shared">
        IPs that are shared across **multiple** users. Connect to our entire network of [400M+ monthly residential IPs](https://brightdata.com/proxy-types/residential-proxies). Rotate between countries, cities, and ASNs using the Proxy Manager, Extension, or raw API commands.

        Cost is calculated per GB consumed, according to your [monthly plan](/general/account/billing-and-pricing/billing).

        ## Geolocation targeting

        The IP allocated to your zone will be from the selected country, city, ASN, or zip code. Select the needed parameter from the drop-down menu.

        <img alt="geolocation-targeting-dropdown.png" />

        ## Sending a request with Geolocation:

        * With a 'Shared' IP, you'll be able to control your geolocation targeting when you send a request.
        * To target a specific country, add the `-country` flag to your request,

        For example, if you'd like to send your request from the United States ('us'), your request using a shared IP will look like

        ```sh theme={null}
        curl "http://target.site" --proxy brd.superproxy.io:44445 --proxy-user brd-customer-<customer_id>-zone-<zone_name>-country-us: <zone_password>  
        ```
      </Tab>

      <Tab title="Dedicated">
        IPs that are set aside **for your use only.** Since Bright Data's residential network is an opt-in, residential network made up of millions of devices around the world, Bright Data developed the group IPs (gIPs) method to further enhance your dedicated IP capability.

        ## Dedicated IP groups (gIPs)

        gIP contains between 6-90 IPs at any given moment while sharing the same attributes, targeting the selected dedicated domains within the zone "Configuration" section.

        <img alt="dedicated-ip-groups.png" />

        ## Geolocation targeting

        The IP allocated to your zone will be from the selected country

        <img alt="add-country.png" />

        ## Domains

        Define the domains you'd like your IPs to be exclusive to. Requests to **any other** domain will be bypassed and sent from our servers .

        <img alt="add-domains.png" />

        <Note>
          There is **no** option to add "All domains". Requests to domains that are not in the list will be sent from the our servers resulting in a super-proxy bypass and will be either blocked or rerouted through a different proxy.
        </Note>

        ## Sending a request with Geolocation:

        When you send your request, it will originate from the country you've selected within your zone configuration. There is \*\*no need to add additional country flags.\*\*For example, if you've configured your 'Geolocation targeting' country to be the United States ('us'), you may send your request with the following default syntax and we will automatically route it through whatever is set in your proxy's configuration:

        ```sh theme={null}
        curl "http://target.site" --proxy brd.superproxy.io:44445 --proxy-user brd-customer-<customer_id>-zone-<zone_name>: <zone_password>
        ```
      </Tab>
    </Tabs>
  </Accordion>

  <Accordion title="What is a super-proxy?">
    Super-proxies are the gateway servers of Bright Data. Every request sent through Bright Data's proxy platform passes through these servers, which select the best peer based on the request details and balance the load among peers.

    In some cases, Bright Data may not be able to process your request via a peer, resulting in a super-proxy bypass. This means the request is sent directly from Bright Data's gateway servers instead of a peer.

    When a super-proxy bypass occurs, the response headers will include an info message explaining why it happened.

    It is possible to block requests from being sent from the super-proxies when it happens, simply add the `-route_err-block` flag to your proxy username:

    ```sh theme={null}
    curl "http://target.site" --proxy brd.superproxy.io:44445 --proxy-user brd-customer-<customer_id>-zone-<zone_name>-route_err-block:<zone_password>
    ```
  </Accordion>

  <Accordion title="What are the proxy (IP) Types for Datacenter?">
    There are three types of IPs that we offer within our [Datacenter Proxy Network](https://brightdata.com/proxy-types/datacenter-proxies):

    1. Shared (Pay per usage): Access a shared pool of \~40,000 rotating proxies
    2. Shared unlimited: Access a set of specific proxies, shared with others with unlimited usage.
    3. Dedicated unlimited: Access a set of specific proxies, exclusive for you, with unlimited usage
  </Accordion>

  <Accordion title="What are IP Types for ISP?">
    There are three types of IPs that we offer within our [ISP Proxy Network](https://brightdata.com/proxy-types/isp-proxies):

    1. Shared (pay per usage)
    2. Shared unlimited (pay per proxy)
    3. Dedicated unlimited (pay per proxy)

    In all proxy types you can select the location of your proxies by zone configuration or using the -country parameter in your code/proxy user name.

    ### Shared pay per usage

    Rotating proxies from a pool of 10,000 proxies (IP addresses). Proxies are shared with others and charged by your usage: amount of GB you pass thru them.

    ### Shared unlimited

    Set of proxies, shared with others, paid by proxy. The more you buy, the less you pay per proxy. See our [fair use](/general/usage-monitoring/fair_use_allowance) policy for unlimited zones.

    ### Dedicated unlimited

    Set of proxies, exclusive to you, paid by proxy. The more you buy, the less you pay per proxy. See our [fair use](/general/usage-monitoring/fair_use_allowance) policy for unlimited zones.
  </Accordion>

  <Accordion title="How to find and rotate thru my allocated IPs?">
    You can find your IP list in the following pages:

    1. Zone overview page: There are 'Download' and 'View' buttons below the code example.
    2. Main zone table: There are 'Download' and 'View' icons under the 'Allocated IPs' column.

    In both cases the buttons will do the same thing:

    1. The view button will allow you to view, refresh and remove IPs from the pool.
    2. The download button will download a csv file with the full list in `host:port:username:password` format.

    Our proxy will automatically rotate thru the proxies assigned to this zone, and abide to location you specify. In case you want to have better control on driving a request thru a specific proxy (IP) you can use the `-ip` or `-gip` options. Read more about it here: [Controlling your proxies](/proxy-networks/config-options#controlling-your-proxies). For advanced proxy rotation control you will need to install and route your requests using Bright Data [proxy manager](/proxy-networks/proxy-manager/introduction).
  </Accordion>

  <Accordion title="How to integrate a new proxy into your code?">
    To integrate the proxies into your code, please visit the [API examples page](https://brightdata.com/cp/zones/proxy_examples), which can be accessed via your zone's settings:

    <img alt="integrate-new-proxy.gif" />

    On this page, you can choose integration examples for most modern coding languages, just choose the integration type, your proxy zone, coding language, etc. and the page will generate a code snippet you can use right away.
  </Accordion>

  <Accordion title="How can I test if my proxy is working?">
    To test your proxy, use the terminal command that's available in your **Overview** tab for the proxy.

    Copy and paste it to your terminal. In Windows, click the 'Start' button and enter 'cmd'. In Mac or Linux, run the 'terminal' application. Then, paste the code in the new window.

    If your proxy is working well, you will see text on the console with details regarding your proxy.

    If not, you will see an error code. You can always paste the error code in the AI agent integrated into the dashboard to get additional details.
  </Accordion>

  <Accordion title="How to integrate a proxy into 3rd party software?">
    Check out a few examples in the [API examples](https://brightdata.com/cp/zones/proxy_examples) page mentioned above (just choose "other software" in the "language" drop-down menu), or check our [Integrations page](/integrations), where we have specific guides to integrate our proxies within the most popular tools across the industry today.

    **Important note**: If you are using Bright Data's Web Unlocker API, Residential Proxies or the SERP API you probably need to use our SSL certificate to enable end-to-end secure connections. See [instructions here](/general/account/ssl-certificate).
  </Accordion>

  <Accordion title="How do I configure proxy in a specific country or location?">
    You can control the location of your country easily for every request that you send. You can choose proxies by country, state, city, zip code and ASN. In this answer, we will focus on choosing a specific country.

    When sending your request, you can make you Proxy appear to be in a in a specific country by adding the `-country` flag, **after** your zone’s name in the request, followed by the 2-letter [ISO code](https://www.nationsonline.org/oneworld/country_code_list.htm) for that country.

    If you use a third-party tool or application, simply use the username that includes the `country-xx` in the configuration. In other words, in the box where you need to put in the proxy username, enter the full string, including the country parameter, for example: `brd-customer-<customer_id>-zone-<zone_name>-country-us` - don't forget to use your own credentials that you can find in the "Overview" tab.

    If you use your own code, see the example below: We added `-country-us` to our request, so we will send a request originating from the United States ("us").

    ```sh theme={null}
    curl "http://target.site" --proxy brd.superproxy.io:44445 --proxy-user brd-customer-<customer_id>-zone-<zone_name>-country-us: <zone_password>
    ```

    If you use a third-party application in conjunction with the proxies, you can enter the username, including the country to software's configuration.

    Of course, if you send requests to the proxy using code that you wrote, you can easily adjust the username to target specific countries as needed.

    Remember, you can also choose proxies by country, state, city, zip code and ASN. See [this guide](/proxy-networks/config-options) for more info.
  </Accordion>

  <Accordion title="How can I set default countries for zones with fixed IP pools?">
    Some zones will give you access to a big fixed pool of IPs from all around the world. In these zones, you may select default countries to target without specifying the country in the request.

    After selecting the default countries, the zone will target one of these countries in each request. You can still target other countries by adding the `-country-xx` flag to your request and override the default country selection.
  </Accordion>

  <Accordion title="Why can't I find a country in the list?">
    Bright data has Datacenter and ISP proxies in most countries around the world, but not all. We are constantly adding data centres in new countries as they become available.

    If you cannot find the country you are looking for in Datacenter or ISP proxies, we recommend you check out Residential proxies. Since residential proxies are based on real people with real devices, we are able to offer residential proxies in every country in the world!
  </Accordion>

  <Accordion title="How to target the EU region">
    <Note>
      The allocation of a country within the EU is random.
    </Note>

    <Info>
      Relevant for all proxy networks: Datacenter, ISP, Residential and Mobile, as well as to our  Unlocker and SERP APIs
    </Info>

    You can target the entire European Union region (member countries) in the same manner as "Country" above by adding "eu" after "country" in your request: -country-eu

    Requests sent using -country-eu, will use IPs from a **single, randomally selected** country of the countries below which are included automatically within "eu":

    Member countries are: Austria, Belgium, Bulgaria, Croatia, Republic of Cyprus, Czech Republic, Denmark, Estonia, Finland, France, Germany, Greece, Hungary, Ireland, Italy, Latvia, Lithuania, Luxembourg, Malta, Netherlands, Poland, Portugal, Romania, Slovakia, Slovenia, Spain, Sweden
  </Accordion>

  <Accordion title="How to target all countries except China?">
    When Allocating IPs to a Zone, in the country selection section in the configuration UI, you can select the 'All except CN' option, which allows you to allocate IPs from all around the world while excluding IPs from China.

    Note this option is available only in the following zone types:

    * Data Center / ISP - Shared - Pay per proxy
    * Data Center / ISP - Dedicated
  </Accordion>

  <Accordion title="How to target a Specific City?">
    City targeting for datacenter and ISP proxies has deprecated. City targeting for residential and mobile networks is available. [Read more here >>](/proxy-networks/faqs#where-does-bright-data-have-proxies)
  </Accordion>

  <Accordion title="Where does Bright Data have proxies?">
    Bright Data offers proxies in every country in the world, except in the following countries:

    * Iran
    * Iraq
    * Syria
    * Lebanon
    * Palestine
    * North Korea
    * Cuba
    * Sudan
    * Belarus
    * Russia

    If you need proxies from these countries, unfortunately Bright Data will not be able to help you.
  </Accordion>

  <Accordion title="How to view the proxy event log?">
    The event log will show you (at most) the last 200 requests you made with any zone in your account.

    In your Bright Data control panel's proxies page: [https://brightdata.com/cp/zones](https://brightdata.com/cp/zones)

    Go to the "Event Log" tab:

    <img alt="event-log.png" />

    The presented data is:

    * **Date:** Time and date of the request
    * **Zone:** What Zone was used for the request
    * **Source IP:** What IP the request was made from
    * **URL:** The target site of the request
    * **Result:** Success or Fail of the request

      <img alt="event-log-headers.png" />
  </Accordion>

  <Accordion title="How to enable automatic IP fallbacks? (formerly 100% uptime)">
    <Info>
      Applicable for Datacenter & ISP
    </Info>

    The **Automatic Failover** was built to prevent any ‘external’ events from affecting the user. The idea is simple and works the same way for both problems described above – if Bright Data detects a problem, like a connectivity issue or an IP where the GEO isn’t exactly what you asked for when buying that IP, we will automatically route your requests through other IPs which are exactly the same as the original IPs.

    At the same time, we wanted to make sure that customers that must use specific IPs will not be affected – so we made some exceptions:

    * If a specific IP is targeted in your request we will not assign a fallback IP to it
    * Automatic Failover will not interrupt a live connection. If the fallback is needed, it will play in once the next connection is established

    The **Automatic Failover** brings immediate value by providing 100% connectivity and continuous high-performance level, **free of charge and without having to make any changes in your code or how you work.**

    <Note>
      Automatic Failover feature can be turned on or off, [via API](/api-reference/account-management-api/Switch_100_uptime_ON_OFF_in_a_Static_zone).
    </Note>
  </Accordion>

  <Accordion title="How to enable Automatic Failover for proxies?">
    Navigate to your proxy configuration settings, and under **Advanced settings** enable **‘Automatic failover’**
  </Accordion>

  <Accordion title="How to keep using the same IP in multiple requests?">
    * This can be done by adding the session flag to the proxy username:

    ```sh theme={null}
    brd.superproxy.io:44445 br-customer-<customer_id>-zone-<zone_name>-session-rand39484
    ```

    Generate the random number on thread startup, and change it when you want to change the Proxy Peer assigned for the thread's connection.

    * Session ID can be any random string/counter: requests with the same session string will use the same Proxy Peer (as long as possible); requests with different session strings will be assigned different Proxy Peers.
    * To force an IP change, just modify the session ID
    * If an assigned Proxy Peer(exit node IP) becomes unavailable, the Super Proxy will return an error "502 - No peers available" for the first request and then on the second request the super proxy will assign a new peer even if you do not change the session ID.
    * The Session IP is kept persistent for up to 7 minutes of idle time. After 7 minutes with no requests, the IP is released back to the pool.\
      To keep this Session/IP for longer, send a tiny keep-alive request no longer than 7 minutes, to prevent this session from becoming idle for over 7 minute.\
      This request may be anything small, such as /favicon.ico, or even a request that returns 404 (as long as the web server does not disconnect the socket due to this request).
    * If you have multiple Clients and would like to ignore your Clients source IP (which is used together with your session ID to create a session), then you want to use a global session then add `glob_` as a prefix to your session:

    ```sh theme={null}
    brd-customer-<customer_id>-zone-<zone_name>-session-glob_rand39484
    ```

    Full request example:

    ```sh theme={null}
    brd-customer-CXXXXX-zone-ZONE_X-session-glob_rand39484
    ```

    Generate the random number on thread startup, and change it when you want to change the Proxy Peer assigned for the thread's connection.
  </Accordion>

  <Accordion title="Where do I find is my proxy address and port?">
    You can find your proxy address and port in the "Overview" tab inside the proxies that you configured.

    To do this, click on my zones, then click the line with the proxy you need.

    On the overview tab you can also copy your proxy list, download it, refresh your proxies etc.
  </Accordion>

  <Accordion title="How to allowlist/denylist IPs and domains?">
    Allowlisting your IP is a good way to keep your account secure, as it prevents others from accessing your proxies even if they have your username and password.

    When you allowlist an IP, only that IP will be allowed to send requests to your proxies. As soon as a single IP exists in this list - all other IPs will no longer be able to access the zone's proxies and will be blocked.

    Access from allowlisted IP still requires you to provide your zone's username and password to gain access to the zone's proxies.

    Allowlisting does not impact access to Bright Data control panel: it only restricts access to the proxies.

    To add IPs to a zone's denylist/allowlist, there are 2 ways:

    * Via the control panel: <img alt="whitelist-blacklist.png" /> Add all the relevant IPs and domains you'll allow access to with your proxy zone.
      * Go to any of your zone's settings, and click the "Configuration" tab.
      * Scroll down to the "Security settings" section, as they are both responsible for white/denylisting IPs and domains, respectively:
    * **Via API endpoints:**
      * [Add IP to Zone allowlist](/api-reference/account-management-api/allowlist-ip)
      * [Remove IP from Zone allowlist](/api-reference/account-management-api/remove-ip-from-zone-allowlist)
      * [Add IP to Zone denylist](/api-reference/account-management-api/denylist-ip)
      * [Remove IP from Zone denylist](/api-reference/account-management-api/remove-ip-from-zone-denylist)
      * [Remove domain from Zone allowlist/denylist](/api-reference/account-management-api/remove-domain-from-zone-allowlist-or-denylist)
      * [Add domain to Zone allowlist/denylist](/api-reference/account-management-api/allowlist-or-denylist-domains)

    #### Important tips re allowlist:

    * Example for adding domains: <img alt="domain-add-example.png" />
    * Example for adding IPs: <img alt="ip-add-example.png" />
    * IPs that should be allowlisted are **your** machine's IPs that you'll be sending requests with, **not** the proxy IPs in your zones.
    * We **strongly recommend** allowlisting your IPs wherever possible, since when the allowlist is empty, you run the risk of getting your non-allowlisted IPs temporarily blocked in the case where our automatic security blocking system detects any irregular activity. See more info within [this video.](https://brightdata.com/static/video/howto/blacklist_system_explanation.mp4?md5=153602994-22bce32a\&hver=2)
    * There is **no limit** on how many IPs/domains you can add to the allowlist and we also support ranges of IPs.
  </Accordion>

  <Accordion title="How to see supported Ports & Protocols?">
    #### HTTP and HTTPS Protocols

    Protocols `HTTP` & `HTTPS` are supported by default.

    #### SOCKS5 Protocol

    Bright data supports `SOCKS5` protocol, with a default port 22228 assigned for SOCKS5 communication.

    SOCKS5 is supported for all Bright Data's proxy networks: Datacenter, ISP, Residential, and Mobile.

    See here for [full SOCKS5 configuration instructions](/proxy-networks/socks5)

    #### Target Ports

    We distinguish between two kinds of ports: Bright Data proxy & scraping services ports and using specific ports when targeting hosts (websites). This FAQ refers to target ports ; by which the proxy peer should communicate with the target website.

    Ports 80 and 443 are available by default in all zones, for HTTP and HTTPS protocols.

    In zones of proxies of type Datacenter or ISP, all ports higher than 1024 are supported by default.

    In zones of proxies of type Residential or Mobile, the following ports wills be available by default: 8080, 8443, 5678, 1962, 2000, 4443, 4433, 4430, 4444 and 1969.

    Bright Data can support additional ports by request. Every request to support a new port will be followed by a dedicated and additional compliance process with the Bright Data compliance team.\
    Examples of ports that require Bright Data compliance review before activation:

    To make a request to add a port permission to your zone:

    * Go to your zone's settings (it will open on the "configuration" tab by default, if not, please click it)
    * Scroll down to "advanced options" and click it
    * Enable "ports"
    * Input the port numbers you would like to get approved
    * Fill out the form and wait for our compliance team to contact you and approve the request

      <img alt="add-ports.gif" />
  </Accordion>

  <Accordion title="How to target specific OS?">
    Bright Data allows targeting the following **Operating Systems**:

    <CodeGroup>
      ```sh Windows theme={null}
        curl --proxy-user brd-customer-<customer_id>-zone-<zone_name>-os-windows:<zone_password> --proxy brd.superproxy.io:44445 "<target_site>"
      ```

      ```sh macOS theme={null}
        curl --proxy-user brd-customer-<customer_id>-zone-<zone_name>-os-osx:<zone_password> --proxy brd.superproxy.io:44445 "<target_site>"
      ```

      ```sh Android theme={null}
        curl --proxy-user brd-customer-<customer_id>-zone-<zone_name>-os-android:<zone_password> --proxy brd.superproxy.io:44445 "<target_site>"
      ```
    </CodeGroup>
  </Accordion>

  <Accordion title="How to refresh IPs Allocated to Your Zone?">
    If you've selected 'Pay per IP' shared, or a dedicated IP type in your zone configuration, you'll be allocated a fixed IP address. From time to time, depending on your use case, you may need to refresh these IP addresses.

    In order to refresh IPs allocated to your zone, navigate to your selected zone, under **'Allocated IPs'** click on **'Show allocated IPs'**, **check the box** of the IP or gIP you wish to refresh and click **'Refresh'**

    <img alt="refresh-ips.gif" />

    <Note>
      Refreshing an IP or gIP will result in an extra charge.
    </Note>

    Alternatively, you can use API to refresh your [dedicated Residential IPs](/api-reference/account-management-api/Refresh_dedicated_residential_IPs) or your [Datacenter/ISP IPs](/api-reference/account-management-api/Refresh_Static_Datacenter_ISP_IPs)
  </Accordion>

  <Accordion title="How to use a specific IP?">
    When using Bright Data's Residential Proxy network, you may find the need to use a specific IP allocated to your zone.

    1. **Send a test request** with a '--verbose' or '-v' option added (this will turn on verbose logging)

    ```sh theme={null}
    curl "https://brdtest.com/myip.json" --verbose --proxy brd.superproxy.io:44445 --proxy-user brd-customer-<customer_id>-zone-<zone_name>:<zone_password>
    ```

    1. **Locate** the x-brd-ip response header and copy its value

       <img alt="x-brd-ip.png" />

    2. **Add** the -ip- flag to your request, after your zone’s name and use the **hashed IP value** copied in the previous step

    3. Send a test request, and **review the response**

    ```sh theme={null}
    curl "https://brdtest.com/myip.json" --proxy brd.superproxy.io:44445 --proxy-user brd-customer-<customer_id>-zone-<zone_name>-ip-<hashed-ip>:<zone_password>
    ```

    We recommend using [https://brdtest.com/myip.json](https://brdtest.com/myip.json) as the target domain for testing, and to review your IP credentials.
  </Accordion>

  <Accordion title="How to targeting an ASN specific IP?">
    This feature can be enabled by adding the ASN parameter to your Zone configuration, under **Geolocation Targeting**.

    <img alt="asn-targeting.png" />

    Once the configuration is saved, the ASN flag can be added to the Zone's credentials\
    and be integrated when using the Residential proxies. For example:

    ```sh theme={null}
    curl --proxy brd.superproxy.io:44445 --proxy-user brd-customer-<customer_id>-zone-<zone_name>-asn-<asn-number>:<zone_password> "<target_site>"
    ```

    **Note:** Values for ASN number can be found [here](https://bgp.potaroo.net/cidr/autnums.html).
  </Accordion>

  <Accordion title="How to Target Residential IP groups (gIPs)?">
    Dedicated Residential IPs can be selected in the form of [gIPs](/proxy-networks/residential/configure-your-proxy#ip-groups-gips). They can be allocated under the zone's configuration page by selecting a "Dedicated" IP type and choosing a number of gips. Also targeting a specific domain is required.

    <img alt="number-of-dedicated-gIPs.png" />

    Once the configuration is saved, selecting "Show allocated Dedicated residential IPs" will provide\
    a list of hash values that represent group IPs.

    <img alt="show-allocated-dedicated-ips.png" />

    These values can be used to target a specific gip. For example:

    ```sh theme={null}
    curl --proxy brd.superproxy.io:44445 --proxy-user brd-customer-<customer_id>-zone-<zone_name>-gip-<gip_hash_value>:<zone_password> "<target_site>"
    ```
  </Accordion>

  <Accordion title="How to review usage stats for proxy products in the control panel">
    There are two ways to track usage:

    #### Proxy Dashboard

    Access the Main Proxy Dashboard [here](https://brightdata.com/cp/zones/dashboard)

    * Data Usage per Network: Shows total bandwidth and number of requests for each proxy product over the selected timeframe.
    * Usage Overview: Displays a graph where you can select timeframe, data point (bandwidth, requests, average bandwidth per request), and filter by zone, product, or target domain. You can also compare usage between timeframes using the "Compare to" option.

    #### Zone Overview Page

    * In the zone 'Overview' section you can view stats for a specific zone, with options to compare timeframes, choose data points (bandwidth, requests, bandwidth per request), and view additional metrics in a table below the graph.
  </Accordion>

  <Accordion title="How to browse Chinese sites by using Chinese Residentials IPs">
    **When outside of China**\
    Targeting Chinese Residential IP peers is enough:

    ```sh theme={null}
    curl --proxy brd.superproxy.io:44445 --proxy-user brd-customer-<customer_id>-zone-<zone_name>-country-cn:<zone_password> "<target_site>"
    ```
  </Accordion>

  <Accordion title="Carrier-specific Proxy peer IP">
    * You can choose to use a specific carrier from this list:

    ```text theme={null}
    a1, aircel, airtel, att, celcom, chinamobile, claro, comcast, cox, digi, 
    dt, docomo, dtac, etisalat, idea,  meo, mtn, mtnza, 
    optus, orange, qwest, reliance_jio, robi, sprint, telefonica, telstra, 
    tmobile, tigo, tim, verizon,  vodacomza, vodafone, vivo, zain,
    vivabo, telenormyanmar, kcelljsc, swisscom, singtel, asiacell, windit, 
    cellc, ooredoo, drei, umobile, cableone, proximus, mobitel, o2, 
    bouygues, free, sfr, digicel
    ```

    * For Example

    <CodeGroup>
      ```sh Deutsche Telekom theme={null}
      brd-customer-<customer_id>-zone-<zone_name>-carrier-dt
      ```

      ```sh Sprint theme={null}
      brd-customer-<customer_id>-zone-<zone_name>-carrier-sprint
      ```
    </CodeGroup>
  </Accordion>

  <Accordion title="About geolocation databases, and how to check the proxy IP information?">
    Geolocation databases (GeoDB) are used by internet websites to query information about the IP address used by the users. Bright Data monitors and maintains correct records for MaxMind GeoDB.

    There are many other smaller GeoDBs, most of which are using outdated records or flawed testing methods, and so the information they present is not accurate or is presented to lure their viewers to buy VPN or proxy products from them.

    In order to see our information about the proxy IP that you are using, please use the following link: [https://geo.brdtest.com/mygeo.json](https://geo.brdtest.com/mygeo.json)
  </Accordion>

  <Accordion title="Which Bright Data products are best for scraping search engines (SERPs)?">
    #### For single-step scraping:

    [SERP API](/scraping-automation/serp-api/introduction) is the ideal product for targeting SERPs as it has a guaranteed success rate (pay only for success) with active unlocking, automatically chooses the best proxies, customizes headers, fingerprinting, solves CAPTCHAs, and more.

    #### For multi-step scraping (playwright/puppeteer/selenium):

    [Browser API](/scraping-automation/scraping-browser/introduction) is the ideal product as it is our fully cloud-hosted browser designed to help you easily focus on your multi-step data collection while we take care of the full proxy and unblocking infrastructure for you, including CAPTCHA solving.
  </Accordion>

  <Accordion title="Can I target Google SERPs from the Residential, Datacenter, or ISP Proxy network?">
    **Residential Proxy** - No, [SERP API](/scraping-automation/serp-api/introduction) is the ideal product for targeting SERPs as it has a guaranteed success rate (pay only for success) with active unlocking, automatically chooses the best proxies, customizes headers, fingerprinting, solves CAPTCHAs, and more. Targeting Google SERPs from the Residential network will result in Super-proxy bypass, which will casue the request to be sent from our servers instead of the peer.

    **Datacenter & ISP Proxies** - No. When attempting to specifically target Google through either of these proxy networks, your request will be denied and you will receive the following error message in the response headers:

    ```text theme={null}
    HTTP/1.1 403 Search engine host is not allowed
    x-brd-error: Forbidden: This target URL isn't supported on proxy networks, use the SERP API product for targeting this URL. You may contact your account manager or open a support ticket for assistance
    ```
  </Accordion>

  <Accordion title="Residential & Mobile networks">
    When targeting search engines through the Residential or Mobile networks, the request will not go through the Residential or Mobile peer but instead will be sent directly through one of our super proxies. The reason for this behavior is to support the integration of the Residential and Mobile networks with a browser, which might need to load search engine resource endpoints from the target website.

    **In case you target a search engine domain using Residential or Mobile networks, the request will be passed directly through the super proxy, and the following response header will serve as an indication:**

    ```sh theme={null}
    x-luminati-ip: superproxy bypass
    ```
  </Accordion>

  <Accordion title="Can I Send requests to IPs and not domain name?">
    No - requests directly to the host server, and not to the domain name are forbidden while using Bright data.\
    Requests using URL format such as 1.1.1.1:443 will be executed using the super proxy server, not the proxy peer IP.

    Example of a request using the super proxy:

    <img alt="x-luminati-ip.png" />
  </Accordion>

  <Accordion title="Can I use port 25 or any other SMTP port, or send an email by using the proxy IP?">
    Since BrightData cares about our community and peers quality, SMTP requests which can be used for spamming are blocked. Please note that mail domains are also blocked from access, and requests to mail domains will be sent from the super proxy server, and not the peer IP.
  </Accordion>

  <Accordion title="Does Bright Data support the Socks5 protocol">
    Yes. Bright data supports `SOCKS5` protocol, with a default port 22228 assigned for SOCKS5 communication.

    See here for [full SOCKS5 configuration instructions](/proxy-networks/socks5) or visit the [SOCKS5 proxies page](https://brightdata.com/solutions/socks5-proxies).
  </Accordion>

  <Accordion title="How do I control from where the request is performed?">
    * You can choose to perform the request from the super proxy directly instead of the IP of the peer. In that case the IP of the request will be the one of the Super proxy. You will need to add **'-direct'** to your request authorization string. `brd-customer-<customer_id>-zone-<zone_name>-direct`
  </Accordion>

  <Accordion title="How do I refresh session (IP)?">
    Using the same IP for a long period of time makes it easier for the target website to mark the IP as proxy and can make your request get detectable by the target website. Refreshing your IPs will result in allocation of new IPs from Bright Data instead of your existing ones in your pool allowing you to gain control over your pool and reach higher success rates.
  </Accordion>

  <Accordion title="How to browse Chinese sites by using Chinese residential IPs?">
    No special settings required, just use `country-cn` flag in your credentials
  </Accordion>

  <Accordion title="How to use the same IP for an extended period of time and how long can I keep it? (long session)">
    If you wish to keep the same IP for a long time for session-based use, you have the following options:

    * Target a specific IP with the `-ip` flag: View your proxy list in your zone's pool (can be found in the control panel in the zone's 'overview' tab) choose one IP and target it  using the `-ip` flag. This will route all your requests to the same IP. You can use the same IP as long as it is allocated to your zone.
    * Keep same session IP: By utilizing the `-session-<SESSION_ID> `flag your requests will be routed to the same IP. To make sure that the same IP is kept bound to your session ID, you need to ensure that the session is not kept idle for more than . You can have multiple parallel sessions at the same time - each one with a different IP allocated to it.

    Optional: By utilizing the [Proxy Manager](/proxy-networks/proxy-manager/introduction) you can make use of the [long single session](/proxy-networks/proxy-manager/configuration#presets) preset which will automatically send dummy requests at regular intervals to ensure the IP is kept allocated.

    <Note>
      For residential/mobile zones, IPs are real users' devices' IPs, and therefore can be used only when the user's device is idle (i.e. the device is connected to the internet, has enough battery power, and the user is not currently using it). If the IP becomes unavailable, Bright Data will automatically assign you with another available residential IP of the same type and geo-location as you used.
    </Note>

    For more instructions and examples please see the following article: [https://docs.brightdata.com/proxy-networks/config-options#controlling-your-proxies-rotation](/proxy-networks/config-options#controlling-your-proxies-rotation)
  </Accordion>

  <Accordion title="What is Error code 502?">
    HTTP error code 502 means "Bad Gateway". This error occurs when you send a request to a URL, but the URL's server receives an invalid response from another server that it depends on to fulfill the request.

    Bright Data uses the http headers to show additional information about the HTTP error, which helps in identifying the root cause and resolving the issue.

    Check our [error catalog](/proxy-networks/errorCatalog#http-error-502) for HTTP Error 502 reasons.
  </Accordion>

  <Accordion title="What is Error code 403?">
    HTTP 403 response code means you are forbidden from accessing a **valid** URL. The server understands the request, but it can't fulfill the request because of client-side issues.

    Bright Data uses the http headers to show additional information about the HTTP error, which helps in identifying the root cause and resolving the issue.

    Check our [error catalog](/proxy-networks/errorCatalog#http-error-403) for HTTP Error 403 reasons.
  </Accordion>

  <Accordion title="Why am I getting SSL errors? (ERR_CERT_AUTHORITY_INVALID)">
    If you've tried using the residential or mobile proxy networks and have encounterred one of the following errors or ones similar to them:

    * net::ERR\_SSL\_PROTOCOL\_ERROR
    * ERR\_INVALID\_CERT
    * Error: self-signed certificate in certificate chain
    * ERROR: No matching issuer found
    * NET::ERR\_CERT\_AUTHORITY\_INVALID
    * SSL: CERTIFICATE\_VERIFY\_FAILED

    It means that you are using the residential or mobile networks over HTTPS and have not handled the SSL verification correctly.

    For more info on Residential network access and KYC, see the [Residential network access policy](/proxy-networks/residential/network-access).

    **How to resolve the SSL errors?**

    You have the following options:

    * Utilize API access instead of native proxy access: If you are connecting programmatically you should consider connecting via the API method - which handles the SSL certificate for you behind the scenes: [API access vs Native Proxy access](/api-reference/authentication)
    * Complete the know-your-customer (KYC) process, which takes \~2-3 business days to process - after which you'll be able to use the residential/mobile network with minimal restrictions, which also resolves the SSL errors. To complete KYC process fill in the [KYC form](https://brightdata.com/cp/kyc)
    * Install the BrightData SSL certificate, according to our [SSL certificate installation guide](/general/account/ssl-certificate) (note that for some specific integration methods installing the ssl certificate may not be possible due to it not being supported)
      <Note>
        This solution may not be supported by certain third party proxy tools e.g., GoLogin, MultiLogin.
      </Note>
    * If you are utilizing our proxies through code (NodeJS, Python, C#, etc.) or console, you can ignore SSL verification entirely, which resolves all SSL verification errors. We provide examples on how to do this in the [SSL certificate documentation page](/general/account/ssl-certificate)
    * Use a different product: instead of Residential proxies you could use a different product such as Data Center or ISP proxies, which do not require "Special Permissions" (KYC). You could do this as a temporary measure until your KYC form is approved.
  </Accordion>

  <Accordion title="How do I redirect `curl` ourput to a file?">
    When scraping large files or in order to record `curl` output, you may want to redirect the output to a file. In order to do so add `--output [filename]` to your `curl` command options.
  </Accordion>

  <Accordion title="How can I allow/block targeting specific domains in my zone?">
    You can control access by allowing or blocking specific domains through simple configurations within your zones. Follow these steps to manage domain access:

    1. Visit the [Zones Page](https://brightdata.com/cp/zones) Go to the Zones Page in your dashboard.
    2. Select Your Desired Zone Choose the zone you wish to configure for domain access.
    3. Navigate to the 'Configuration' Tab Once in your selected zone, locate the Configuration tab, then scroll down to  Security Options.
    4. Allowing or Blocking Domains
       * To allow specific domains, add them to Allowed Target Hosts.
       * To block specific domains, add them to Blocked Target Hosts.
    5. Domain Wildcard Options
       * Root Domain Inclusion: Adding a root domain (e.g., example.com) will automatically include all its subdomains (e.g., sub.example.com).
       * Wildcard Use: Utilize the \* wildcard to cover all subdomains and suffix variations. For instance, adding example.\* will include sub.example.\* and various domain suffixes like example.com, example.co.uk, etc.

    <Tip>
      These configurations provide flexibility in managing domain-level access for your proxy zones, ensuring secure and controlled connectivity.
    </Tip>
  </Accordion>

  <Accordion title="How do I target government websites?">
    By default, Bright Data blocks proxy traffic to what classifies as Government websites. Some countries' government websites do not have special domain name suffix (like `.gov` or `.gov.[country_code]` , yet those domains still qualify as government domains and getting blocked.  

    When you get this specific reason block, check your response headers for `x-brd-err-code` : if the value is `policy_20000` - this is a government website block. 

    To gain access to government website, Bright Data will require you to identify your business and usecase via our KYC process. [Read more about KYC process](/proxy-networks/residential/network-access#kyc-verification) or start the KYC [here](https://brightdata.com/cp/kyc). 
  </Accordion>

  <Accordion title="Why am I getting errors about robots.txt?">
    robots.txt is a file that website owners use to define which areas of their site can be accessed by automated systems. On the Residential network, Bright Data adheres to these rules to ensure ethical compliance. Requests to blocked areas will return a 502 Residential Failed (bad\_endpoint) error.

    To resolve these errors you can choose one of these solutions:

    * Keep your KYC use case current with the Bright Data compliance team, so your approved Residential access covers the sites you target. Residential access requires KYC approval. To start or review the process, see the [KYC form](https://brightdata.com/cp/kyc).
    * Use our other products that do not require KYC verification, such as [ISP proxies](/proxy-networks/isp/introduction) and [Datacenter proxies](/proxy-networks/data-center/introduction).
    * Avoid navigating to the web paths that the website is blocking in the robots.txt file.

    For more information, please see the following article: [https://docs.brightdata.com/proxy-networks/residential/network-access](/proxy-networks/residential/network-access)
  </Accordion>

  <Accordion title="Do you offer IPv6 Proxies and how do I get IPv6 proxies?">
    We will consider providing IPv6 proxies to selected customers. Please contact us for inquires in regards to [support@brightdata.com](mailto:support@brightdata.com)
  </Accordion>

  <Accordion title="How to understand why I am getting a certain error?">
    To try and understand the reason your are encountering a specific error while using our proxy networks, you should try to recreate the same request on which you encountered the error and send it via cURL on CMD/BASH or some other http request service such as Postman.

    While sending the request, ensure you are attaching the `-v` or `-verbose` flag to the request (for cURL), this will ensure you receive the response headers which contain important information regarding the source of the error and will guide you to a solution.

    If the response headers include `x-brd-` then the error originates with BrightData and you should check the [BrightData Error Catalog](/proxy-networks/errorCatalog) for further advice

    Otherwise, there has not been a failure on our side - and you should instead check the article regarding [Website Blocking](/proxy-networks/website-blocking)

    It could also be that the error originates from issues with your integration, you should check if you've integrated correctly, for help with integration - please see our [Integrations Section](/integrations/introduction)
  </Accordion>

  <Accordion title="Does Bright Data have any request limits? ">
    Bright Data allows large scale proxy access and operations, we do not enforce a global requests limit (also known as "Rate limit"), but we do monitor customers' usage - and alert if this usage is exceeding normal behavior. We do protect our proxy networks and if requests rate is too high you will receive an HTTP Error 429 ([see description of error and troubleshooting here](/proxy-networks/errorCatalog#http-error-429)).

    We monitor both general requests inflow as well as **number of requests per proxy (IP)**, if we identify and overload on a specific proxy IP we may throttle it and return an HTTP error 429 with specific error message indicating such scenario. You will be requested to add more IPs or reduce your load.

    We highly recommend when encountering rate limit error (HTTP error 429) to review you rotation logic (in case you refer explicitly to proxy IPs) - you may have been targeting a specific set of IPs with requests while leaving the others unused.
  </Accordion>

  <Accordion title="Why cant I access (blocked) google, bing.com, youtube.com with proxies?">
    As part of BrightData's policy - we perform blocks or [Super-Proxy-Bypasses](/proxy-networks/faqs#what-is-a-super-proxy) when users try to access google.com, youtube.com, bing.com and a handful of other select domains with our regular proxies. If you wish to scrape google search result data or youtube.com, please use [SERP API](/scraping-automation/serp-api/introduction) or Web Unlocker API instead.
  </Accordion>

  <Accordion title="Why am i getting wrong geolocation when checking proxy IP?">
    When checking your brightdata proxy IP location and details via third party IP checker sites, you may receive in results the 'wrong' geolocation, this can be due to two main reasons:

    * Geolocation Databases: Geolocation databases (GeoDB) are used by internet websites to query information about the IP address used by the users. Bright Data monitors and maintains correct records for MaxMind GeoDB. There are many other smaller GeoDBs, most of which are using outdated records or flawed testing methods, and so the information they present is not accurate or is presented to lure their viewers to buy VPN or proxy products from them.
    * Super Proxy Bypass: For third party IP checkers we may perform a superproxy bypass instead of completely blocking the request, this is done in order to retain our IP's reputation. When this is done, you may see the location of our superproxy not of your proxy peer. Dont worry - for other regular websites your real proxy peer will be used. [What is a superproxy bypass?](/proxy-networks/faqs#what-is-a-super-proxy)

    To avoid such issues, please only use our official IP checker website, which will show you the accurate information: [https://geo.brdtest.com/mygeo.json](https://geo.brdtest.com/mygeo.json)
  </Accordion>

  <Accordion title="How can I use Bright Data proxies in IP:PORT format?">
    Bright Data proxies natively support the industry-standard format: `IP/HOST:PORT:USERNAME:PASSWORD`. If your integration method does not support this format and requires `IP:PORT` only, you can use **Bright Data Proxy Manager**, a free, open-source tool that allows you to route requests to our proxies using the `IP:PORT` format.

    For more details on configuring Proxy Manager for this setup, refer to our guide: [Port Targeting Configuration](/proxy-networks/proxy-manager/configuration#port-targeting)
  </Accordion>

  <Accordion title="Why has my IP address been added to the zone denylist? ">
    #### Handling IP Restrictions on Your Account

    If Bright Data detects unusual or suspicious activity originating from a particular IP address on one of your zones, the automated security measures will denylist that IP to protect your account. While this system effectively prevents most malicious activity, it occasionally may block legitimate users, resulting in an `ip_forbidden` error message.

    #### How to Resolve This Issue

    If you encounter this error, you can quickly resolve it by:

    1. Go to the \*\*'Proxy' \*\*tab
    2. Navigate to the affected Proxy/Zone from the list
    3. Select **'Security Settings'** in the configuration panel
    4. Find the**IP allowlist**  option
    5. Add your current machine's IP address to the allowlist

    Once your IP is allowlisted for the Proxy/zone, you'll regain immediate access to the service.
  </Accordion>

  <Accordion title="How to get your Bright Data connection information?">
    ### Your proxy access information

    Bright Data proxies are grouped in "Proxy zones". Each zone holds the configuration for the proxies it holds.

    To get access to the proxy zone:

    1. Login to Bright Data control panel
    2. Select the proxy zone or setup a new one
    3. Click on the new zone name, and select the **Overview** tab.
    4. In the overview tab, under **Access details** you can find the proxy access details, and copy them to clipboard on click.
    5. You will need: Proxy Host, Proxy Port, Proxy Zone username and Proxy Zone password.
    6. Click on the copy icons to copy the text to your clipboard and paste in your tool's proxy configuration.

    ### Access Details Section Example

    <Frame>
      <img alt="your-proxy-list" />
    </Frame>

    ### Residential proxy access

    To access Bright Data's **Residential Proxies** you will need to either get verified by our compliance team, or install a certificate. [Read more...](/proxy-networks/residential/network-access)

    ### Targeting search engines?

    If you target a search engine like google, bing or yandex, you need a special Search Engine Results Page (**SERP**) proxy API. Use Bright Data SERP API to target search engines. [Click here to read more about Bright Data SERP proxy API.](/scraping-automation/serp-api/introduction)

    ### Avoid `PROXY ERROR` in your tool

    Some tools use search engines as a test target for proxy: if your proxy test fails, this is probably the reason. Make sure that your test domain is not a search engine (this is done in the third-party tool's configuration, and not controlled by Bright Data).
  </Accordion>

  <Accordion title="Does Bright Data proxies support HTTP3?">
    Yes. We offer selected customers to use our advanced high performance proxy networks with HTTP3 protocol. This is a limited offer to our enterprise tier customers: to use HTTP3 for your scraping operations, please contact your Bright Data account manager.
  </Accordion>

  <Accordion title="What should I know to work with HTTP3 with Bright Data proxy network? ">
    ### How do I know if my target domain supports HTTP3?

    You can tell if your target domain advertises on HTTP3 by sending a `curl` request checking the response header for `alt-svc` header. If this header exists in the response it means the domain is offering access over HTTP3.

    ```text theme={null}
    curl -k -i https://[my target website]
    ```

    Alternatively, you can check [https://http3check.net/](https://http3check.net/) or similar websites.

    ### Can I use my installed `curl` to query over HTTP3?

    Yes - but you need a specifically built `curl` utility which is supporting `HTTP3`. Most popular released of `curl` does not support `HTTP3`.

    ### Why should I use HTTP3?

    Some websites expect HTTP3 traffic ; so by accessing with target's expected protocols you may experience smoother unblocked access. For some use cases, HTTP3 access is faster than HTTP2, so your throughput can be higher.

    ### Do I need to perform special setup on my proxies?

    No. All the proxies provided by Bright Data can relay HTTP3 traffic without special setting or modifications.

    ### Do I need to modify my operations or access to use HTTP3?

    Consult your IT, Network and Security administrators on enabling HTTP3 from your network. Some network or firewall settings may be required to allow this traffic to flow from/to your organization's network.

    ### How can I see if my chrome browser is utilizing HTTP3 for traffic?

    Open your chrome browser in development mode, and open the network tab. In `protocol` column, if you see `h3` it means requests are sent and received over HTTP3.

    ### How can I join the beta trial of HTTP3 of Bright Data?

    In order to gain access to our HTTP3 beta, contact your account manager in Bright Data. We authorize currently only selected enterprises to join our beta trial of HTTP3.
  </Accordion>

  <Accordion title="Can I export my logs? ">
    Yes - Bright Data supports exporting your logs to AWS S3 store. Set this up in your control panel here: [https://brightdata.com/cp/setting/logs\_delivery](https://brightdata.com/cp/setting/logs_delivery)

    ***Note: Your AWS S3 bucket must be in us-east-1 region***
  </Accordion>
</AccordionGroup>


# Proxy infrastructure
Source: https://docs.brightdata.com/proxy-networks/introduction

Bright Data proxy infrastructure: 400M+ monthly residential IPs plus ISP and datacenter networks, with full session and geo-targeting control.

<div>
  <h2> Our Proxy Networks </h2>
</div>

<Card>
  <CardGroup>
    <Card title="Residential" href="/proxy-networks/residential/introduction" icon="house">
      Access any website content as a real user, while seamlessly avoiding web blocks.
    </Card>

    <Card title="Data Center" href="/proxy-networks/data-center/introduction" icon="server">
      Retrieve data faster with Data Center proxy network in a shared or dedicated IP pool.
    </Card>

    <Card title="ISP" href="/proxy-networks/isp/introduction" icon="wifi">
      Use internet service provider IPs with a guaranteed long session peers and static addresses.
    </Card>
  </CardGroup>
</Card>

<Tip>
  [Proxy Manager](/proxy-networks/proxy-manager/introduction): Manage and monitor any proxy network using a single open-source interface.
</Tip>

<Note>
  [<u>Start now</u>](https://brightdata.com/?hs_signup=1\&utm_source=docs) and test proxies with a \$2 trial credit, plus a \$5 bonus when you add a payment method. We’ll match your first account deposit up to \$500. See the [free tier](/general/account/billing-and-pricing/free-tier).
</Note>

<Info>
  For billing, settings and user access, visit the [account management](/api-reference/authentication#how-do-i-generate-a-new-api-key%3F) section.
</Info>

<Card title="Network status" icon="badge-check" href="https://brightdata.com/network-status">
  View real-time network status for all products
</Card>


# How to configure your ISP proxy
Source: https://docs.brightdata.com/proxy-networks/isp/configure-your-proxy

Learn how to configure your ISP proxy settings effectively, choose IP types, enable cache proxy, and ensure 100% uptime for optimal performance.

To access your proxy configuration, open your zone in the "Configuration" tab.

## Which IP type to choose

Bright Data offers 3 types of ISP proxies:

<Card title="Shared" icon="square-1">
  A rotating proxy over a pool of \~40,000 proxies, paid by usage GBs.
</Card>

<Card title="Shared unlimited" icon="square-2">
  A set of specific proxies, shared with others, with unlimited bandwidth, paid by proxy.
</Card>

<Card title="Dedicated unlimited" icon="square-3">
  A set of specific proxies, exlcusive for you, with unlimited bandwidth, paid by proxy.
</Card>

## Shared (rotating) proxy configuration

### Default countries selection

When selecting countries in shared pool configuration, we will assign proxies only from the countries you select. You can select none (which meand we will assign the next random proxy from the pool), one or more countries. [Read more...](/api-reference/proxy/geolocation-targeting#default-countries-selection)

To select a specific country for your peer during rotation, use the flag -country in the proxy user name parameter with an ISO-3166 country code.

[FAQ: Where can I see the list of country codes?](/general/faqs#where-can-i-see-the-list-of-country-codes)

## Shared & Dedicated unlimited proxy configuration

### Number of IPs

<Tip>
  For unlimited proxies we offer a discount based on amount of proxies you purchase per zone. The more you buy, less your pay per proxy. Click on the "Rates" link in your zone setup to see rates.
</Tip>

Number of IPs to be allocated as your pool of available IPs.

### How to select a country

Geolocation targeting allows you to target specific `Country`.
Select the prefered countries from the drop-down menu.

Once selected, we will assign proxies from those countries. If we do not have enough proxies to cover your requirement, we will assign the amount we have and you can submit an order for the full amount of proxies (we do not allow single proxy orders - we will take in large orders only).
Changing this selection means re-allocating proxies, which will incur a **Refresh charge**.

### How does multiple countries selection work?

If you select multiple countries, we assign proxies in **available countries** at the moment of assignment. For example: if you choose proxies from Germany, France & Italy, we will provide proxies from **either** of these countries. We will try to distribute the assignment evenly across the countries you selected, yet if there are not enough proxies in one of the countries, some countries will have more proxies than other.

So referring to that example, if you request 30 proxies from Germany, France & Italy and we have only 6 available proxies in Italy you will get: 12 proxies from Germany, 12 from France and 6 from Italy.

<Frame>
  <img alt="Geolocation Targeting" />
</Frame>

## Access your allocated Proxies' IP addresses

In all proxy types, you can download, view and copy to clipboard the IPs allocated to you by following these steps:

1. Navigate to the [Zones page](https://brightdata.com/cp/zones).
2. Select a zone with allocated IPs.
3. In the overview tab click 'Download', 'View' or 'Copy'.

<Frame>
  <img alt="your-proxy-list" />
</Frame>

***

## How to configure advanced options

***

### How to enable automatic failover

In case we cannot reach the proxy peer for your request, we will route the request to another available peer. Automatic failover does not apply when you choose default countries: if we cannot find a peer in the country you selected, we will fail the request with error.

Enabling automatic failover assures execution of the request, regardless of the availability of a specific peer.

***

### Special Ports & Protocols

Ports `80` and `443` are available by default, supporting HTTP and HTTPS & SOCKS5 protocols. We also support all ports over `1024` in our ISP proxy network. [Read more on ports and protocols...](/proxy-networks/faqs#how-to-see-supported-ports-and-protocols)

<Accordion title="Request Additional ports">
  Bright Data can support additional ports by request. A dedicated and additional compliance process with the Bright Data compliance team will follow every request to support a new port.
  If you would like additional port permissions, you can contact Bright Data Support.
  Examples of ports that require Bright Data compliance review before activation:

  | Port | Protocol |
  | ---- | -------- |
  | `70` | HTTP     |
  | `98` | HTTPS    |
</Accordion>

### Zone usage limit

Set usage limit to your zone: you can limit spending or traffic. This provides additional layer of control to your budget and bandwidth consumption, mostly over our rotating shared pool proxies.


# ISP proxies FAQs
Source: https://docs.brightdata.com/proxy-networks/isp/faqs

Answers to common questions about Bright Data virtual ISP proxies: how the network is built, IP pools, geotargeting, privacy and compliance with ISP policies.

<AccordionGroup>
  <Accordion title="How does virtual ISP works?">
    <Note>This FAQ raises and answers all these complex questions in detail and transparency.</Note>

    A virtual ISP gathers millions of physical IPs from thousands of ISP providers worldwide and forms them into a single virtual ISP network.

    As a customer of Bright Data, you can access this network via a single IP for private use, a full network of shared access for scaled public web data collection. Alternatively, you can use Bright's Data Collection platform that does all the work for you and delivers the public web data you need in the required format you requested.
  </Accordion>
</AccordionGroup>


# Introduction to ISP proxies
Source: https://docs.brightdata.com/proxy-networks/isp/introduction

Bright Data ISP Proxies combine residential trust with datacenter speed across 195 countries. Best for ad verification, QA and bypassing datacenter blocks.

Bright Data’s [ISP Proxies Network](https://brightdata.com/proxy-types/isp-proxies) is one of our proxy network solutions and is built of residential IPs bought or leased from Internet Service Providers (ISPs) for commercial use, rather than for use from private homes.

This has an advantage over our [Datacenter](/proxy-networks/data-center/introduction) network, as target sites classify ISP IPs similar to residential IPs, even though in reality they are actually hosted on servers. This allows you to access websites and collect data as a real person would, while at the same time benefiting from the high speeds and reliability that are characteristic of high-speed server IPs. 

## When to use ISP proxies

* Accessing hard-to-reach websites very similar to a real user
* Viewing content, performing ad verification, quality assurance, marketing, and more
* If you are getting low success rates or blocked altogether when using our [Datacenter](/proxy-networks/data-center/introduction) proxy network and want to keep your fast server speeds and lower cost

<Note>
  If you need a more sophisticated proxy network, that’s even less likely to to get detected by websites, you may want to consider using our [Residential proxies.](/proxy-networks/residential/introduction)
</Note>

<Tip>
  For an even more advanced proxy unblocking solution, that also tackles additional blocking challenges, such as site-specific headers, cookies, CAPTCHAs, etc, try out our [Web Unlocker API](/scraping-automation/web-unlocker/introduction) or check out our [other proxy products.](https://brightdata.com/proxy-types)
</Tip>


# Create your first ISP proxy
Source: https://docs.brightdata.com/proxy-networks/isp/quickstart

Set up your first Bright Data ISP proxy: sign in, create a proxy in the Control Panel, verify your account and earn $5 credit for first-time setup.

<Callout icon="badge-dollar">
  **Verify your account and get \$5 credit**

  Add a payment method to verify your account and receive a \$5 credit. You won’t be charged at this stage.
</Callout>

<Steps>
  <Step title={<a href="https://brightdata.com/cp/start">Sign in to Bright Data</a>} />

  <Step title={<>Open the <a href="https://brightdata.com/cp/zones/new">Create Proxy</a> page</>}>
    Navigate to **Create Proxy** under the **Proxy** section in the left menu.

    <Frame>
      <img alt="Create Proxy" />
    </Frame>
  </Step>

  <Step title="Choose ISP Proxy">
    Select **ISP Proxy** and click **Continue**.

    <Frame>
      <img alt="ISP Proxy" />
    </Frame>
  </Step>

  <Step title="Assign a name to your proxy">
    Enter a meaningful name. Optionally, add a short description.

    <Warning>
      **The proxy name cannot be changed once created.**

      All other settings can be modified later. For details, see [Configure your Proxy](/proxy-networks/isp/configure-your-proxy).
    </Warning>

    <Frame>
      <img alt="Proxy Name" />
    </Frame>
  </Step>

  <Step title="Add payment method (free trial users only)">
    If you signed up with a personal email (e.g., Gmail, GitHub) and have not yet added a payment method, the primary button will read **Add payment method** instead of **Create Proxy**.

    Click the button to open the payment verification form and complete the process. You will **not** be charged, this is for identity verification only.

    <Info>
      Already have a payment method on file? This step is skipped automatically. For full details, see [Payment Verification](/general/account/billing-and-pricing/payment-verification).
    </Info>
  </Step>

  <Step title="Finalize proxy creation">
    Click **Create Proxy**. If you were redirected to add a payment method, your zone is created automatically once verification completes. Your proxy is now ready to use.
  </Step>
</Steps>


# Send your first ISP proxy request
Source: https://docs.brightdata.com/proxy-networks/isp/send-your-first-request

Send your first request through Bright Data ISP proxies with copy-paste code examples in cURL, Python, Node.js, Java, and Go.

<Accordion title="This guide works for all the proxy products" icon="check">
  1. Residential Proxy

  2. Mobile Proxy

  3. ISP Proxy

  4. Datacenter Proxy

  5. SERP API

  6. Browser API

  7. Web Unlocker API
</Accordion>

To get started, you need your proxy credentials, your `Username` and `Password` along with the `Host` name. You can find these credentials in the **Overview** tab of the proxy product.

## Code Examples

Once you have your proxy credentials, use the following code to send your first request:

<CodeGroup>
  ```sh cURL theme={null}
  curl "http://brdtest.com/myip.json" --proxy brd.superproxy.io:44445 --proxy-user brd-customer-<customer_id>-zone-<zone_name>:<zone_password>
  ```

  ```javascript Node.js theme={null}
  #!/usr/bin/env node

  const { ProxyAgent, setGlobalDispatcher } = require('undici');

  setGlobalDispatcher(new ProxyAgent('http://brd-customer-<customer_id>-zone-<zone_name>:<zone_password>@brd.superproxy.io:44445'));

  (async () => {
    const response = await fetch('http://brdtest.com/myip.json');
    console.log(await response.text());
  })();
  ```

  ```python Python theme={null}
  import pprint
  import requests


  host = 'brd.superproxy.io'
  port = 44445

  username = 'brd-customer-<customer_id>-zone-<zone_name>'
  password = '<zone_password>'

  proxy_url = f'http://{username}:{password}@{host}:{port}'

  proxies = {
      'http': proxy_url,
      'https': proxy_url
  }


  url = "http://brdtest.com/myip.json"
  response = requests.get(url, proxies=proxies)
  pprint.pprint(response.json())

  ```

  ```php PHP theme={null}

  <?php
  echo 'To enable your free eval account and get CUSTOMER, YOURZONE and '
      .'YOURPASS, please contact sales@brightdata.com';
  $curl = curl_init('http://brdtest.com/myip.json');
  curl_setopt($curl, CURLOPT_PROXY, 'http://brd.superproxy.io:44445');
  curl_setopt($curl, CURLOPT_PROXYUSERPWD, 'brd-customer-<customer_id>-zone-<zone_name>:<zone_password>');
  curl_exec($curl);
  ?>

  ```

  ```ruby Ruby theme={null}
  #!/usr/bin/ruby

  require 'uri'
  require 'net/http'
  require 'net/https'

  puts 'To enable your free eval account and get CUSTOMER, YOURZONE and YOURPASS, please contact sales@brightdata.com'

  uri = URI.parse('http://brdtest.com/myip.json')
  proxy = Net::HTTP::Proxy('brd.superproxy.io', 44445, 'brd-customer-<customer_id>-zone-<zone_name>', '<zone_password>')

  req = Net::HTTP::Get.new(uri)

  result = proxy.start(uri.host,uri.port, :use_ssl => uri.scheme == 'https') do |http|
      http.request(req)
  end

  puts result.body
  ```

  ```cs C# theme={null}
  using System;
  using System.Net;

  class Example {
    static void Main() {
      var client = new WebClient();
      client.Proxy = new WebProxy("brd.superproxy.io:44445");
      client.Proxy.Credentials = new NetworkCredential(
        "brd-customer-<customer_id>-zone-<zone_name>",
        "<zone_password>"
      );
      Console.WriteLine(client.DownloadString("http://brdtest.com/myip.json"));
    }
  ```

  ```java Java theme={null}
  package example;

  import org.apache.http.HttpHost;
  import org.apache.http.client.fluent.*;

  public class Example {
      public static void main(String[] args) throws Exception {
          System.out.println("To enable your free eval account and get "
              +"CUSTOMER, YOURZONE and YOURPASS, please contact "
              +"sales@brightdata.com");
          HttpHost proxy = new HttpHost("brd.superproxy.io", 44445);
          String res = Executor.newInstance()
              .auth(proxy, "brd-customer-<customer_id>-zone-<zone_name>", "<zone_password>")
              .execute(Request.Get("http://brdtest.com/myip.json").viaProxy(proxy))
              .returnContent().asString();
          System.out.println(res);
      }
  }
  ```

  ```perl Perl theme={null}
  #!/usr/bin/perl

  print 'To enable your free eval account and get CUSTOMER, YOURZONE and '
      .'YOURPASS, please contact sales@brightdata.com';
  use LWP::UserAgent;
  my $agent = LWP::UserAgent->new();
  $agent->proxy(['http', 'https'], "http://brd-customer-<customer_id>-zone-<zone_name>:<zone_password>\@brd.superproxy.io:44445");
  print $agent->get('http://brdtest.com/myip.json')->content();
  ```

  ```vb VBA theme={null}
  Imports System.Net

  Module Module1
      Sub Main()
          Console.WriteLine("To enable your free eval account and get " & 
              "CUSTOMER, YOURZONE and YOURPASS, please contact " &
              "sales@brightdata.com")
          Dim Client As New WebClient
          Client.Proxy = New WebProxy("http://brd.superproxy.io:44445")
          Client.Proxy.Credentials = New NetworkCredential("brd-customer-<customer_id>-zone-<zone_name>", "<zone_password>")
          Console.WriteLine(Client.DownloadString("http://brdtest.com/myip.json"))
      End Sub
  End Module
  ```
</CodeGroup>

The code above uses the residential proxy to send a request to [http://brdtest.com/myip.json.](http://brdtest.com/myip.json.) It returns your IP information in a JSON format:

```json Output theme={null}
{
  "ip": "ALLOCATED_IP",
  "country": "PK",
  "asn": {
    "asnum": 203020,
    "org_name": "HostRoyale Technologies Pvt Ltd"
  },
  "geo": {
    "city": "Islamabad",
    "region": "IS",
    "region_name": "Islamabad",
    "postal_code": "44040",
    "latitude": 33.7233,
    "longitude": 73.0435,
    "tz": "Asia/Karachi",
    "lum_city": "islamabad",
    "lum_region": "is"
  }
}
```

Now, replace “[https://brdtest.com/myip.json”](https://brdtest.com/myip.json”) with the website of your choice and ...

**That's it!**


# How to configure the Proxy Manager
Source: https://docs.brightdata.com/proxy-networks/proxy-manager/configuration

Learn more about what Proxy Manager can do, how to tailor it to your needs, and how to implement popular optimized workflows. Connects via port 44445.

## Download and install Proxy Manager

***

Our Proxy Manager is easy to setup and maintain on your local machine or on our hosted cloud server. We recommend the Cloud server setup to get full access to all that Proxy Manager has to offer.

### Bright Data Cloud Hosting

Avoid the hassle of server resources as well as networking setup of an on-premise Proxy Manager - a cloud instance will let your focus on your operations.

We provide a multi-instance cloud with a single UI to control your Proxy Manager's operations.

* To enable this option, select Activate on [the Proxy Manager page](https://brightdata.com/cp/lpm) in your account, and the instance will be provided automatically.

<Note>
  **Allow third party cookies** in your browser must be enabled for proxy manager dashboard to run in your browser.
</Note>

### Download and install Proxy Manager on your hosted environment (cloud/on premise)

Brigt data provides installers for each platform. The minimum host requirements are at least:

* 4GB RAM
* 2 CPU
* 3GB HDD

Download and installation methods for the respective OS:

<Tabs>
  <Tab title="Windows">
    Download the [Installer](https://github.com/luminati-io/luminati-proxy/tags) file from our [GitHub](https://github.com/luminati-io/luminati-proxy) releases.

    <Tip>
      Make sure to download the latest version.
    </Tip>
  </Tab>

  <Tab title="Linux/MacOS">
    <Warning>
      Linux CentOS 8.x is not supported (use CentOS 7.x instead!)
    </Warning>

    <Accordion title="Linux/macOS requirements">
      * Confirm the recommended hardware requirements:
        1. 4GB RAM
        2. 2 CPUs
        3. 3GB SSD
      * Confirm the recommended software requirements:
        * [Node.js](https://nodejs.org/en/about/) supported versions: `12.18.3 - 14.18.1`
        * [NPM](https://docs.npmjs.com/about-npm) supported versions: `6.14.6  - 8.1.3`

          <Note>
            You can manually install NPM v6.14.6:

            ```sh theme={null}
            sudo npm install -g npm@6.14.6
            ```
          </Note>
      * Confirm that network traffic is not limited:
        * The server/computer does not use any VPN or proxy IP!
        * The OS firewall is turned off
        * in and out traffic is permitted for TCP ports 20000-30000
    </Accordion>

    * Install Proxy Manager by running from a terminal one of the following commands:

      ```sh theme={null}
      curl -L https://brightdata.com/static/lpm/luminati-proxy-latest-setup.sh | bash
      wget -qO- https://brightdata.com/static/lpm/luminati-proxy-latest-setup.sh | bash
      sudo npm install -g @luminati-io/luminati-proxy
      ```

    You can find more information on [Manual Installation instructions](https://github.com/luminati-io/luminati-proxy#linuxmacos---manual-install).
  </Tab>

  <Tab title="Docker">
    A docker image can be found [here](https://hub.docker.com/r/luminati/luminati-proxy/)

    ```sh theme={null}
    docker pull luminati/luminati-proxy  
    docker run luminati/luminati-proxy proxy-manager  
    docker run luminati/luminati-proxy proxy-manager --version
    ```

    * Make sure to forward appropriate ports. Proxy manager uses by default 22999 for the web console and the API, [`<Tooltip tip="Port 44445 is the recommended proxy port, click to read more">44445 </Tooltip>`](/general/faqs#which-port-shall-i-use-22225-or-33335) for dropin and 24000-24... for all the ports that you'll create.
    * To run docker with cli option see the below example:

      ```sh theme={null}
      sudo docker run -v ~/proxy_manager:/lpm -p 127.0.0.1:22999:22999  -p 127.0.0.1:22998:22998  -p 127.0.0.1:24000:24000  luminati/luminati-proxy pmgr  --www_whitelist_ips 172.17.0.1  --config /lpm/config.json
      ```
  </Tab>
</Tabs>

***

## Which preset to choose

***

<Tabs>
  <Tab title="Long single session (IP)">
    Use this preset if you need full page loads. Connect from the browser manually (for example Chrome/Firefox) or programatically (for example Puppeteer/Selenium). All requests share the same IP. You can control when you refresh the IP from the UI or API.
  </Tab>

  <Tab title="Rotating">
    Use this preset if you want to get a fresh new IP on each single request. This preset also rotates the User-Agent header automatically. It's the best for scraping API when you don't load the full pages.
  </Tab>

  <Tab title="Custom">
    Build your own preset fit your needs

    <Note>
      Using a custom preset requires testing in the internal environment before going to production to verify the process is working as expected
    </Note>
  </Tab>
</Tabs>

## Rules and Headers

***

Navigate to Rules and start building your own rules based on triggers such as:

* URL suffixes
* Status codes
* String values found in the Response body
* Requests latency

You can choose an action to be taken to each trigger respectively.

For example, an implementation of a rule to save bandwidth by nullifying media URLs' outputs.

In addition, you can implement the desired headers in advance under the Rules section.

For example, adding the user-agent header of a Linux desktop on i686 CPU (More about user-agents can be found [here](https://developers.whatismybrowser.com/useragents/explore/))

## How to target a port

***

Bright Data proxy manager enables targeting the Proxy using IP:PORT format. For example, targeting a [port](/api-reference/proxy-manager/create_a_new_proxy_port) indexed as 24000 when the proxy manager is installed locally:

```sh theme={null}
curl --proxy 127.0.0.1:24000 "https://target.site"
```

<Note>
  If installed remotely simply switch 127.0.0.1 with the remote server IP address. (Instead of the IP:PORT USERNAME:PASSWORD)
</Note>

```sh theme={null}
curl --proxy brd.superproxy.io:44445 --proxy-user brd-customer-<customer_id>-zone-<zone_name>:<zone_password> "https://target.site"
```

This allows:

* Removing the username:password section from the request.
* Integration with 3rd party softwares that accept only IP:Port format
* Clean code. Ports can be configured with all necessary headers and rules in advance no need to adjust the command/request itself. More information is available [here](/api-reference/proxy-manager/update_a_proxy_port)

## Add External Proxies

***

Bright Data Proxy Manager supports external proxies from other vendors. Connecting external proxies will allow you to optimize and manage all of your proxies in one place.

* Login to your Proxy Manager
* Set a new Port.
* Select 'External'
* Add your proxies in the next format

```js theme={null}
[
    '<proxy_peer_IP>', '<username>:<password>@<proxyprovider_server>:<port>'
]
```

* Click 'Save' and you will have the external proxies available as one of the Proxy Manager's port

<Frame>
  <img alt="Add External Proxies" />
</Frame>

## Traffic Calculation Difference

***

Proxy Manager is a middleman between the request initiator and our Super Proxy servers. Proxy Manager statistics can be seen [here](https://brightdata.com/cp/lpm), and Super Proxy statistics can be seen [here](https://brightdata.com/cp/zones). So each request that you send to Proxy Manager eventually reaches Super Proxy. But there could be a difference in traffic calculations, here's why:

* Proxy Manager calculates incoming requests as they are being sent, but after they reach the Proxy Manager, it attaches additional headers, so that request's response will have more information about the request's flow (timeline, proxy IP, etc)
* Requests that reach the Super Proxy server from Proxy Manager are incoming with those additional parameters; that's why Super Proxy calculates slightly bigger requests than it initially was when reached Proxy Manager
* Proxy Manager sometimes adds headers to present a better view of logs, but this data is not being calculated in the billing

In conclusion, the main source of traffic statistics should be [Zones](https://brightdata.com/cp/zones)' page since it represents statistics formulated by Super Proxy.

As a rule - Bright Data uses the [Zones](https://brightdata.com/cp/zones)' page for calculation and one source of truth

Invoices and billing events will be triggered based on the zones calculations


# Proxy Manager FAQs
Source: https://docs.brightdata.com/proxy-networks/proxy-manager/faqs

Find detailed answers to common Proxy Manager questions, including access restriction, port multiplication, IP targeting, and more. Connects via port 44445.

<AccordionGroup>
  <Accordion title="Can I restrict access to Remote Proxy Manager on-premise?">
    To secure your account and prevent unauthorized access to the Proxy Manager, there are 3 main available workflows:

    1. Allowlist IPs
    2. Token based Authentication using API key
    3. Permission by Email using the Bright data extension
  </Accordion>

  <Accordion title="How to connect to superproxy via HTTPS?">
    Proxy Manager can connect with the main Bright Data infrastructure using either HTTP or HTTPS connection.

    <Note>
      **To avoid confusion:** This is **NOT** the connection type to the target URL. To make sure the connection is secure it's enough to keep **Connection to Super Proxy** with a default value (HTTP) because the HTTPS requests create an end-to-end encrypted connection with the target site anyway.
    </Note>

    In most cases, you don't even need to touch this config. It may come out useful though when connecting from some territories where traffic to some domains is blocked. In these cases, you need to set it to **HTTPS** not to allow the global firewall to see the content of your proxies traffic and filter it out based on the target domain
  </Accordion>

  <Accordion title="How to multiply ports?">
    Go to "General" tab and choose the number of ports you want to multiply in the Multiply proxy port drop down

    Once you set the number of multiplied ports you need the Proxy Manager will generate the sequential ports identical to the port you configured.

    This is a very powerful feature when you need to create many ports with the same settings but only set it once.
  </Accordion>

  <Accordion title="How to get IPs from specific locations?">
    With Bright Data you can specify the geolocation and other parameters of the IPs you use for sending traffic. In Proxy Manager it's especially easy because it take only a few clicks.

    Depending on the zone you use you can request IPs only from a specific country (if you use Residential or Datacenter network) or additionally specific carrier (if you use Mobile network).

    **How to set targeting in Proxy Manager?**

    To get IPs from a specific location, follow these steps:

    * Click on the proxy port that you want to use location-specific IPs
    * Go to **Targeting** tab
    * Select country, state, city for choosing a peer in a specific geolocation
    * Select ASN or carrier name (only for mobile peers)

    <Note>
      Each targeting option requires the proper permissions in your Zone.
    </Note>

    <Accordion title="How to use IPs from multiple countries without creating many ports?">
      If you want to use multiple countries and you don't want to create a separate proxy port for each country it's also possible to control the targeting dynamically.
    </Accordion>
  </Accordion>

  <Accordion title="How to control targeting dynamically?">
    You don't have to specify the country, state or city targeting in advance using the Targeting tab in the UI. It is possible to pass extra targeting options dynamically ('on the fly') along with the request.

    ```sh theme={null}
    curl -x lum-country-br@127.0.0.1:24001 http://brdtest.com/myip.json
    ```

    The request's structure is:

    ```sh theme={null}
    curl -x lum-country-<country_iso_code>@<ip>:<port> <destination_url>
    ```

    The other option for controlling targeting dynamically is by including a special header.

    ```sh theme={null}
    "x-lpm-country: <country_code>"
    ```

    Example request could look like this:

    ```sh theme={null}
    curl --proxy http://127.0.0.1:24000 -H "x-lpm-country: us" http://brdtest.com/myip.json
    ```

    You may also use headers for controlling state and city:

    * State: `x-lpm-state: <state>`
    * City: `x-lpm-city: <city_name>`
  </Accordion>

  <Accordion title="How to override the port's country?">
    To override the country selected in the port, you can send the 'x-lpm-country' header with the chosen country code.

    ```sh theme={null}
    curl --proxy [LPM_DOMAIN]:[PORT] -H "x-lpm-country: il" "http://brdtest.com/myip.json"
    ```
  </Accordion>

  <Accordion title="How to set an automatically follow redirect?">
    Follow Redirect is a valuable feature within the Proxy Manager that enhances your control over the handling of 30X (Redirection) errors. This feature is located within the Port Settings, under the General tab. It provides you with the option to automatically send a new request when encountering a 30X error, where the destination URL is derived from the Location response header. This documentation will guide you through enabling and using this feature.

    **Accessing Follow Redirect:**

    1. Open the desired port for Follow redirect activation
    2. Go to General Tab: Within the Port Settings, click on the "General" tab. This is where you'll find various settings related to how your proxy handles requests and responses.
    3. Toggle the Follow Redirect Feature: In the General tab, you will see the "Follow Redirect" feature. It's presented as a toggle button, allowing you to enable or disable it as needed.

    **How Follow Redirect Works:**

    * When the Follow Redirect feature is enabled, it instructs the proxy manager to automatically send a new request in response to a 30X error.
    * The URL for the new request is determined based on the Location response header received in the 30X error response.
    * This allows your proxy to seamlessly follow the redirection and ensure that the request is sent to the correct destination, as specified by the Location header.

    **Benefits of Follow Redirect:**

    In environments where automatic redirection is not supported or desired, the Follow Redirect feature gives you full control.
  </Accordion>

  <Accordion title="How to control sessions consistency with session header?">
    You can control your sessions using the Proxy Manager by sending x-lpm-session header.

    * Add the header with any random session ID"x-lpm-session: random\_session"
    * When using the same session the Proxy Manager will try to connect with the same exit node (peer/IP)
    * When you change the session value the Proxy Manager will connect with a different exit node (new peer/IP)
    * To keep a given session alive you must send a request no less than every 7 minutes
    * Note that in order to use it with HTTPS requests you will need to enable SSL Analyzing and install the certificate

    Here is an example:

    ```sh theme={null}
    curl --proxy http://127.0.0.1:24000 -H "x-lpm-session: rand123" http://brdtest.com/myip
    ```
  </Accordion>

  <Accordion title="How can I Refresh Session on Cloud Proxy Manager?">
    You can refresh session on your cloud Proxy Manager with the following curl request:

    ```sh theme={null}
    curl -X POST "https://pmgr-customer-<customer_id>.brd.superproxy.io:22999/api/refresh_sessions/<port>"
    ```
  </Accordion>

  <Accordion title="How to export logs from Proxy Manager?">
    In Proxy Manager, we provide users with a range of options to export logs to external storage and log monitoring systems. These export options allow you to centralize and analyze your logs efficiently. In this documentation article, we will outline the available log export options and guide you on how to configure them through Proxy Manager settings.

    **Log Export Options:**

    Proxy Manager offers the following log export options:

    **Logz.io**

    Configure the Logz.io integration in Proxy Manager settings by specifying your Logz.io token, Host and other required parameters.

    **AWS S3:**

    To export logs to AWS S3, set up the S3 integration in Proxy Manager settings. You will need to specify your AWS access key, secret key, S3 bucket name, and other relevant details.

    **Webhook:**

    Configure the webhook endpoint and any required authentication details and URL in Proxy Manager settings to start exporting logs via webhook.

    **Datadog:**

    To export logs to Datadog, set up the Datadog integration in Proxy Manager settings by providing your Datadog API key and other relevant information.

    **Configuring Log Exports:**

    To configure log exports in Proxy Manager, follow these general steps:

    1. Access Proxy Manager Settings:
    2. Navigate to the settings or configuration section.
    3. Select Log settings option in Enable request logs
    4. Toggle on Use remote logs aggregator
    5. Choose the desired log export option (Webhook, Datadog, Logz.io, or AWS S3).
    6. Provide Configuration Details: For the selected export option, you will typically need to provide specific configuration details. This may include endpoint URLs, API keys, authentication credentials, and storage settings.
    7. Click on Test to check the configuration
    8. Click OK and Save changes

       <img alt="logs-settings.png" />

    By following these steps, you can effectively configure Proxy Manager to export logs to your chosen external storage or monitoring systems, enhancing your ability to monitor and manage your network and applications effectively.
  </Accordion>

  <Accordion title="How to unblock error codes?">
    Error code responds can trigger an IP refresh or try with new IP using the Proxy Manager Rules with the following steps:

    * Add a new rule at Proxy Manager, rules tab
    * Select 'Status code' as the rule type
    * Trigger the rule by selecting the relevant status code to scan (i.e 501, 402, 301, etc)
    * Select the desired outcome such as 'Refresh IP' or 'Try with new IP'

    Watch video:[unblock error codes](https://brightdata.com/video/unblock_error_codes)
  </Accordion>

  <Accordion title="How to run UI (dashboard) on HTTPS">
    **What is needed?**

    To be able to access the UI (dashboard) using HTTPS protocol you need to provide the Proxy Manager with an SSL certificate and private key for your domain.

    The certificate and private key should be generated specifically for your domain and installed on the server. Usually it's done through the server and domain provider

    **How to do it?**

    Run Proxy Manager along with environment variables `SSL_CERT` and `SSL_KEY` pointing to the according certificate files. Example command to run in the terminal:

    ```sh theme={null}
    SSL_CERT=/path/to/ca.crt SSL_KEY=/path/to/ca.key pmgr
    ```

    Once it is started you can access the UI using [https://your-domain.com:22999/](https://your-domain.com:22999/)
  </Accordion>

  <Accordion title="How to save request/response history?">
    By enabling the `--history` flag. When history mode is enabled, both request and response headers will be saved to a local database. They can be accessed under the "Proxies" section. The history option can also track HTTPS, by enabling the '--ssl' flag. For additional details, see the Bright Data Proxy Manager [GitHub page](https://github.com/luminati-io/luminati-proxy#installation).

    This can also be done through the Proxy Manager dashboard by abling Log request history and Enable SSL sniffing under the General settings section.
  </Accordion>

  <Accordion title="How to use SOCKS5 with Bright Data's Proxy Manager">
    To use SOCKS5 with Bright Data's Proxy Manager, simply use `socks5h://` as the protocol when connecting to your local Proxy Manager port. No UI changes are needed.

    Example:

    ```sh theme={null}
    curl -x socks5h://127.0.0.1:24000 "https://geo.brdtest.com/welcome.txt"
    ```

    <Note>
      Always use `socks5h://` (not `socks5://`) to ensure DNS is resolved on the proxy side, as required by Bright Data.
    </Note>
  </Accordion>

  <Accordion title="How to define a proxy IP country when using SOCKS5 protocol with Proxy Manager?">
    <Warning>
      This option is only available for customers who have dropin port enabled
    </Warning>

    `SOCKS5` protocol uses an encrypted base64 string for authentication.

    Therefore, when using `SOCKS5`, if you need to define a proxy IP country (`-country-<COUNTRY_CODE>`), you will have to convert your basic authentication information into base64 token:

    * Browse [https://www.base64encode.org](https://www.base64encode.org/)
    * Encode `brd-customer-<customer_id>-zone-<zone_name>-country-<COUNTRY>:<zone_password>` to Base64 format token
    * Use the "Basic authorization token" header you generated on the `SOCKS5` request that you send the Proxy Manager port:

    ```sh theme={null}
    curl -v "http://brdtest.com/myip.json" --socks5 127.0.0.1:24000 -H "Proxy-Authorization: Basic <Basic authorization token>"
    ```
  </Accordion>

  <Accordion title="How to switch from API to Proxy Manager">
    Using the Proxy Manager offers advanced features that are not readily available in the API. Instead of having to manually code mechanisms for tasks like keeping an IP as long as possible or rotating your IP after each request, you can simply click a button in the Proxy Manager.

    Guidelines to to switch from API to Proxy Manager:

    1. Install the Proxy Manager [here](https://github.com/luminati-io/luminati-proxy#installation/)
    2. Change the code to send HTTP requests directly to the specified port (for example, 127.0.0.1:24000) instead of to brd.superproxy.io:
    3. Configure the settings for your custom proxies and Zones through the Proxy Manager dashboard. You do not need to send the user parameter (brd-customer-customer\_name-zone-zone\_name…) alongside your requests, as all the needed data is wrapped within the manual proxy configuration.
  </Accordion>

  <Accordion title="How to mimic a human user?">
    Including all headers and cookie behavior. See bash example, using Bright Data **Proxy Manager**:

    ```sh theme={null}
    curl -v "http://brdtest.com/myip.json" -H 'pragma: no-cache' -H 'accept-encoding: gzip, deflate, br' -H 'accept-language: en-US,en;q=0.8' -H 'upgrade-insecure-requests: 1' -H 'user-agent: Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/61.0.3163.100 Safari/537.36' -H 'accept: text/html,application/xhtml+xml,application/xml;q=0.9,image/webp, image/apng,\*/\*;q=0.8' -H 'cache-control: no-cache' -H 'cookie: bcookie="v=somekindofcookiexxx";' --proxy http://127.0.0.1:PORT_NUM
    ```

    <Note>
      When using Web Unlocker API attaching headers is disabled by default, please contact support in order to approve headers attachment.
    </Note>
  </Accordion>

  <Accordion title="How to set up the Proxy Manager as a system service?">
    <Steps>
      <Step title="Sign in as 'root' to the remote server (running Ubuntu)" />

      <Step title="Create a service">
        Create a new service file in:

        ```sh theme={null}
        /etc/systemd/system/pmgr.service
        ```

        ```sh theme={null}
        [Unit]
        Description=Proxy Manager
        Wants=network-online.target
        After=network-online.target

        [Service]
        Type=simple
        Restart=always
        RestartSec=5
        Environment=NODE_ENV=production
        ExecStart=/usr/bin/pmgr
        User=root
        StandardOutput=null
        StandardError=null

        [Install]
        WantedBy=multi-user.target
        ```
      </Step>

      <Step title="Reload service files">
        ```sh theme={null}
        systemctl daemon-reload
        ```
      </Step>

      <Step title="Start Proxy Manager service">
        ```sh theme={null}
        systemctl start pmgr
        ```
      </Step>

      <Step title="Check status:">
        ```sh theme={null}
        systemctl status pmgr.service
        ```
      </Step>

      <Step title="Done!">
        You have completed setting up Proxy Manager as a service. You can now control your new service:

        ```sh theme={null}
        service pmgr [stop|start|restart]
        ```
      </Step>
    </Steps>
  </Accordion>

  <Accordion title="How can I view my request details?">
    Enabling 'Request details' under 'General settings' will add the response headers below, and will allow you to get a wider, more specified view of your request. This feature has the same functionality as using the `-debug` flag.

    * `x-brd-ip-destination` - IP of the targeted host
    * `x-brd-ip` - IP allocated to the request.
    * `x-brd-timeline` - Time it took to complete

    <Note>
      - This feature is turned off by default on the cloud proxy manager, if needed, make sure you enable it.
      - Enabling 'Request details' is necessary in order to implement the action 'Ban IP' within a rule.
    </Note>

    Viewing these headers can be done with one (or more) of the following ways

    <Tabs>
      <Tab title="via the verbose flag (-v)">
        Sending your request in verbose mode by using the `-v` flag
      </Tab>

      <Tab title="Viewing your proxy manager logs">
        1. Click on the specific request you want to examine
        2. Click on 'Headers'
      </Tab>

      <Tab title="Viewing it on your browser's 'Network' tab">
        1. Open 'devtools' by clicking F12
        2. Go to the 'Network' tab
        3. Navigate to the target URL
        4. Click on the relevant request
        5. The relevant headers would be under 'Response Headers'
      </Tab>
    </Tabs>
  </Accordion>

  <Accordion title="How to reduce the amount of data in a response?">
    * Go to "General" tab
    * Select "On" from "SSL analyzing"
    * Go to "Rules" tab
    * Select "URL" from "Rule type" drop-down list
    * Choose any file type to apply regex expression
    * Select "Null response" from "Action type" drop-down list

    In the following example below the Proxy Manager will return a null response (0kb and still status code 200) for all requests that end with any of the file type endings .jpg|.png|.gif etc.

    Use this option when you want to reduce the amount of data you wish to get in your response.
  </Accordion>

  <Accordion title="How can I improve the speed of my web scraping?">
    If the number of requests you rotate through a single IP is higher than what target websites allow, the website you target will identify your IP and block or mislead you with false information. It means that your information collecting can be much slower than what you're used to.

    **What can I do about it?**

    Assuming you're running 10 million requests, 1 request per second per IP with 1000 data center IPs, your routine can take about 3 hours. With 10,000,000 residential IPs, your routine can potentially take 1 second.

    Guidelines to rotate multiple parallel sessions through Bright Data's residential network:

    1. Open Proxy Manager
    2. Go to the 'Overview' menu
    3. Click the port of your residential zone
    4. Edit in the port settings 'preset' to 'Rotating (IPs)'
    5. Route your requests to `127.0.0.1:<portnum>` where the `portnum` is the port of the residential zone
  </Accordion>

  <Accordion title="How do I know if I'm getting cloaked?">
    Getting cloaked means that you're getting misleading information from the website you are scraping.

    Example: If you are collecting comparative competitive information to feed your automatic pricing algorithms, the target website can return artificially lower prices to your requests, to skew your pricing and profits.

    **What can I do about it?**

    When using traditional proxy networks (data center based IPs), your target websites may identify your activity quite easily and may cloak your requests. Therefore, the only way to ensure you're not getting cloaked is to rotate your requests through residential IPs.

    Guidelines for rotating requests through millions of residential IPs:

    1. Open Proxy Manager
    2. Go to the 'Overview' tab
    3. Click the port of your residential zone
    4. Edit in the port settings 'preset' to 'Rotating (IPs)'
    5. Route your requests to `127.0.0.1:<portnum>` where the `portnum` is the port of the residential zone
  </Accordion>

  <Accordion title="How to set Long Single Session when using Proxy Manager">
    Choose "Long Single Session" on the port settings drop-down, and it will automatically ping the IP to keep the session alive:

    <img alt="long-single-session.png" />
  </Accordion>

  <Accordion title="How do I use Remote DNS?">
    Using Remote DNS gives you a DNS resolve server similar to that of the Proxy peer (the origin of the Proxy's IP). This makes your request look more credible as the resolve server is usually located geographically close to the IP, whereas without using Remote DNS the resolve server is one of Bright Data's Super-Proxies which may be located in another country. To use Remote DNS:

    <Tabs>
      <Tab title="via Proxy Manager">
        Go to Edit Port > IP control > set "DNS Lookup" to "Remote - resolved by peer"
      </Tab>

      <Tab title="via The API">
        Simply add it to your username string.

        For example:

        ```sh Shell theme={null}
        brd-customer-<customer_id>-zone-<zone_name>-dns-remote
        ```
      </Tab>
    </Tabs>
  </Accordion>

  <Accordion title="How to use parallel Proxy Manager instances for high performance?">
    When you don't want to overload one Proxy Manager with too many requests you can create several instances of the Proxy manager on different servers.

    The best way to do so is by following the next steps:

    * Install the Proxy Manager locally and set all of the ports as needed
    * Save the config file
    * Turn on Sync configuration so all the changes will be kept in sync on all the machines automatically
    * Install the Proxy Manager on the servers you want to use
    * *Import* the config file to the proxy\_manager directory in the servers

    Split your traffic between the servers

    ```js theme={null}
    request 1 -> {FIRST SERVER IP}:24000
    request 2 -> {SECOND SERVER IP}:24000
    ```

    Using the Proxy Manager with this method will make sure you are not overloading one Proxy Manager instance and it will help you keep the same configuration across all instances.

    This means you can send requests from same port with the same country at the same time on each instance.

    If you're having troubles setting up this load-balancing yourself - you could use our [Clouds](https://brightdata.com/cp/lpm) that have load-balancing feature implemented. You'll only need to use 1 UI and control all instances with shared configuration, and then target same URL, we will take the whole load-balancing process ourselves.
  </Accordion>

  <Accordion title="I cannot Login to on-Premise Proxy Manager">
    If you fail to login to your [Proxy Manager](/proxy-networks/proxy-manager/introduction)(PM), please do the following:

    * Make sure that the computer that runs PM is not using a VPN.\\
      <Note>
        Mind that using a VPN while running PM might cause login problems, and also slow down the connection to the proxies
      </Note>
    * Close PM (the terminal's black screen where PM is running)
    * Delete cookies on your browser
    * Open PM again (it takes about 1-2 minutes for PM to load)
    * Try to log in on the same method you did before (by using Google, or by using your registered mailbox and password)

    Alternatively, you may switch the hosting of Proxy Manager to our [Cloud](https://brightdata.com/cp/lpm). We will take care of hosting and even load-balancing between several instances of Proxy Managers.

    P.S. After PM loads, the default browser should open automatically on PM's login page. If it does not, open your browser, browse 127.0.0.1:22999, and then try to log in.
  </Accordion>

  <Accordion title="Proxy Manager connection error (port status is not &#x22;ok&#x22;)">
    If you cannot log in to Proxy Manager, or If Proxy Manager cannot connect to Super Proxy (i.e. port status is not OK), check the following:

    * Make sure that VPN is not turned on
    * Make sure that there is no anti-virus or any other security software (such as 360, Norton, etc.) blocking traffic sent from Proxy Manager
    * Make sure that the firewall (OS / server / any other security software's firewall) allows TCP traffic through ports 22000-25000
    * If the proxy manager software is installed on macOS/ Linux server - Verify that:
      * Node.js version is between 12.18.3 and 14.18.1
      * NPM version is between 6.14.6 and 8.1.3
      * If versions of NPM and Nodejs are not the one we're supporting - please remove them and install the versions that we specified. More information regarding Linux/Mac installation can be found at our [GitHub page](https://github.com/luminati-io/luminati-proxy/#linuxmacos---manual-install)
  </Accordion>

  <Accordion title="Why Am I getting '400 Proxy Error: ip_requested_not_allocated_by_customer'?">
    When Using the Data center/ISP or gIPs products, the error code `400` can appear in case the IPs under your zone has been refreshed, removed, or simply changed due to system updates

    <Note>
      This error typically arises after your BrightData account has been recently suspended. An automatic suspension occurs if your account balance becomes negative. If the suspension extends beyond 24 hours, the static allocated IPs will be released from your account. Upon reactivation, the reallocated IPs may differ from the original ones, thus if the previously allocated IPs are still being targeted - this error is thrown.
    </Note>

    Whenever this error appear, you should go to your Bright Data Zones page, download the new list of IPs relevant to this zone.

    Make sure you also update the list of IPs in case you are using the proxy manager tool with prefix of IP port setup

    Example:

    ```sh Shell theme={null}
    curl --v "http://brdtest.com/myip.json" --proxy brd.superproxy.io:44445 --proxy-user brd-customer-<customer_id>-zone-<zone_name>-ip-1.1.1.1:<zone_password>
    ```

    <img alt="shell-example.png" />
  </Accordion>

  <Accordion title="How to get IPs from specific locations?">
    With Bright Data you can specify the geolocation and other parameters of the IPs you use for sending traffic. In Proxy Manager it's especially easy because it take only a few clicks.

    Depending on the zone you use you can request IPs only from a specific country (if you use Residential or Datacenter network) or additionally specific carrier (if you use Mobile network).

    **How to set targeting in Proxy Manager?**

    To get IPs from a specific location, follow these steps:

    * Click on the proxy port that you want to use location-specific IPs
    * Go to **Targeting** tab
    * Select country, state, city for choosing a peer in a specific geolocation
    * Select ASN or carrier name (only for mobile peers)
  </Accordion>

  <Accordion title="What Bright Data products does Proxy Manager work with?">
    Proxy Manager supports the following Bright Data products: Data Center Proxies, ISP Proxies, Residential Proxies, Mobile Proxies, Web Unlocker API, SERP API \
    Proxy Manager does not support Browser API.
  </Accordion>

  <Accordion title="How can I download proxy manager? ">
    We recommend that you run proxy manager on our cloud servers as a service for better experience. If you need to install it on your local machines use the following links.

    ### Windows

    [Download proxy manager installer for windows](https://github.com/luminati-io/luminati-proxy/releases/download/v1.519.10/luminati-proxy-manager-v1.519.10-setup.exe)

    ### Linux & MacOS

    `bash `Installer:

    ```sh theme={null}
    curl -L https://brightdata.com/static/lpm/luminati-proxy-latest-setup.sh | bash
    ```

    `NPM `package installer:

    ```sh theme={null}
    sudo npm install -g @luminati-io/luminati-proxy
    ```

    `Docker`image:

    ```sh theme={null}
    docker pull luminati/luminati-proxy
    ```

    ### Source code

    [https://github.com/luminati-io/luminati-proxy](https://github.com/luminati-io/luminati-proxy)
  </Accordion>
</AccordionGroup>


# Proxy Manager integration
Source: https://docs.brightdata.com/proxy-networks/proxy-manager/integration

Integrate the open-source Bright Data Proxy Manager (default port 22999) with third-party apps. Run it as a local proxy server in any environment.

## Integrate with third party apps

The Proxy Manager is an Open-Source project that can be installed in various environments and used as a proxy server in any application.

Below are a few examples for which Proxy Manager can be used as the proxy server inside third party applications.

Integrate with any third party app there is no need for username and password and it is ok to leave `username:password` empty aseach port in the Proxy Manager keeps the credentials of the used zone in it.

```js Example for port 24000 theme={null}
IP:PORT:USERNAME:PASSWORD → 127.0.0.1:24000:[empty]:[empty]
```

## Integrate to your phone

<Tabs>
  <Tab title="Android settings">
    1. An Android and the machine using the Proxy Manager need to share the same WiFi connection
    2. Proxy Manager port must allowlist the IP of the Android device
    3. Go to the WiFi network configuration -> advanced -> manual proxy:

       * Proxy host: The IPv4 address of the machine with the Proxy Manager

       <CodeGroup>
         ```sh CMD theme={null}
         ipconfig
         ```

         ```sh Shell theme={null}
         ifconfig
         ```
       </CodeGroup>

       * Port: `24000` (or other port you created)
  </Tab>

  <Tab title="iPhone (iOS) proxy settings">
    1. iPhone and the machine using the Proxy Manager need to share the same WiFi connection
    2. Allowlist the iPhone IPv4 in the Proxy Manager under 'General'\
       To find IPv4 follow these instructions:
       * Go to wifi settings
       * tap on the blue `i` icon next to your network's name
       * See your IP address
    3. Open the Settings app and go to WiFi
    4. Tap the name of the WiFi network you're connected to
    5. Scroll to the bottom and you will find a section for HTTP Proxy. This is set to 'off' by default. Set it 'Manual' for manually configuring the proxy settings
    6. In the server slot enter the IPv4 address of the server where the Proxy Manager is installed
    7. In the port slot enter `24000` (or other port you create)
  </Tab>
</Tabs>

## Integrate with Puppeteer

* Create a Zone with the network, IP type, and number of IPs you wish to use.
* Install the Proxy Manager.
* Click 'add new proxy' and choose the Zone and settings you require, click 'save'.
* In Puppeteer, under the 'proxy-server', input your local IP and Proxy Manager port (i.e. `127.0.0.1:24000`)
  * The local host IP is `127.0.0.1`
  * The port created in the Proxy Manager is `24XXX`, for example, `24000`
* Leave the `username` and `password` values empty, as the Bright Data Proxy Manager has already been authenticated with the Super Proxy.

```js Sample Code theme={null}
const puppeteer = require('puppeteer');

(async () => {
	const browser = await puppeteer.launch({
		headless: false,
		args: ['--proxy-server=127.0.0.1:24000']
	});
	const page = await browser.newPage();
	await page.authenticate();
	await page.goto('https://brdtest.com/myip.json');
	await page.screenshot({path: 'example.png'});
	await browser.close();
})();
```

## Integrate with Selenium

* Create a Zone with the network, IP type, and number of IPs you wish to use.
* Install the Bright Data Proxy Manager.
* Click 'add new proxy' and choose the Zone and settings you require, click 'save'.
* In Selenium, under the setProxy, input your local IP and proxy manager port (i.e. `127.0.0.1:24000`)
  * The local host IP is `127.0.0.1`
  * The port created in the Proxy Manager is `24XXX`, for example, `24000`
* Leave the username and password fields empty, as the Bright Data Proxy Manager has already been authenticated with the Super Proxy.

```js theme={null}
const {Builder, By, Key, until} = require('selenium-webdriver');
const proxy = require('selenium-webdriver/proxy');

(async function example() {
	let driver = await new Builder().forBrowser('firefox').setProxy(proxy.manual({
		http: '127.0.0.1:24000',
		https: '127.0.0.1:24000'
	})).build()

	try {
		await driver.get('https://brdtest.com/myip.json');
		driver.switchTo().alert().accept();
	} finally  {
		await driver.quit();
	}
})();
```

## Integrate with Insomniac browser

* Go to the **General** tab in the port settings

* In the **Multiply proxy port** field select the number of proxy ports to create. This will create multiple proxy ports with the same settings

* Your Spreadsheet Contains the following columns:
  * Custom Name: Add a name for each proxy
  * Host: `127.0.0.1`
  * Port: `24XXX`
  * `username`, `password`, and Tags: leave EMPTY
    <Note>Proxy Manager has already been authenticated with the Super Proxy</Note>
  * Save the file as a CSV and not as an XLS or XLSX
  * In Insomniac Proxy per tab extension select Manage Proxy list, and select Add bulk proxies
  <Frame>
    <img alt="Proxy Manager Integration" />
  </Frame>

* Select Import proxy list and upload the CSV file

<Frame>
  <img alt="Proxy Manager Integration" />
</Frame>

## Integrate with Multilogin (MLA)

* Within Multilogin click New browser profile
* Click on Edit proxy settings
* Under Connection Type choose Bright Data
* Choose your protocol under Proxy Type
* IP or Host: `127.0.0.1` if the Proxy Manager is installed locally or on the IP of the [remote server](https://brightdata.com/faq#pmgr-install-remote) the Proxy manager is installed on `1.1.1.1` or example.com
* Port: the port you created in the Bright Data Proxy Manager `24XXX`
* Leave the username and password field empty, as the Bright Data Proxy Manager has already been authenticated
* Click on **Check proxy**

<Frame>
  <img alt="Proxy Manager Integration" />
</Frame>

## Integrate with Playwright Proxy

* Click 'add new proxy' and choose the Zone and settings you require, click 'save'.
* In Playwright, under the 'server', input your local IP and Proxy Manager port (i.e. `127.0.0.1:24000`)
  * The local host IP is `127.0.0.1`
  * The port created in the Proxy Manager is `24XXX`. For example, `24000`
* Leave the username and password values empty, as the Bright Data Proxy Manager has already been authenticated with the Super Proxy.
* For example:

```js Sample Code theme={null}
const playwright = require('playwright');

(async () => {
	for (const browserType of ['chromium', 'firefox', 'webkit']) {
		const browser = await playwright[browserType].launch({
			headless: false;
			proxy: {
				server: '127.0.0.1:24000',
				username: '',
				password: ''
			},
		});
		const context = await browser.newContext();
		const page = await context.newPage();
		await page.goto('https://brdtest.com/myip.json');
		await page.screenshot({ path: 'example.png' });
		await browser.close();
	}
})();
```

## Integrate with Jarvee Proxy

* In Jarvee, on the left-hand side, choose the 'Proxy Manager' Tab.
* Click 'Add proxy' and under the 'Select Proxy IP: Port' column input the IP:Port (i.e. `127.0.0.1:24000`)
  * The local host IP is `127.0.0.1`
  * The port created in the Proxy Manager is `24XXX`, for example, `24000`
* Leave the username and password field empty, as the Bright Data Proxy Manager has already been authenticated
* Click 'Verify Proxy Link'.
* Under 'Social Profiles', select the Jarvee profile you created and click the 'Add' button.

<Frame>
  <img alt="Proxy Manager Integration" />
</Frame>

## Integrate with VMLogin Proxy

Register and manage multiple online accounts using physical devices with VMLogin's virtual browsing profiles which helps enable anti-association capabilities as well as fingerprint protection.

Manage multiple online accounts using physical devices with VMLogin's virtual browsing profiles which helps enable anti-association capabilities as well as fingerprint protection.

Here is a step by step guide to integrate Bright Data with VMlogin:

* Download and install VMLogin [here](https://vmlogin.us/?ref=luminati) (3 Days Free Trial)
* Start by launching VMLogin and creating a new browser profile:
  * Click "Get random profile"
  * Select the settings that best suit you, such as operating system, screen resolution, language, WebGL vendor, time zone, media device fingerprint etc.


# Introduction to Proxy Manager
Source: https://docs.brightdata.com/proxy-networks/proxy-manager/introduction

Control, monitor, and customize Bright Data proxies with the open-source Proxy Manager. Apply routing rules, integrate via API, or manage from the UI.

Bright Data Proxy Manager is an application where you can control, manage, and monitor all of your proxies either from our app interface or via API.

It is an advanced open-source application tool ([GitHub](https://github.com/luminati-io/luminati-proxy)) built by developers, for developers and allows unique proxy customization, rules implementation, and integration of external proxies.

## Best For:

* Automating waterfalls between different [proxy products](https://brightdata.com/pricing/proxy-network?plan=yearly\&type=res_rotating) and IPs
* Reducing Bandwith with rules that block certain types of data
* Monitoring HAR logs with live preview of the whole traffic
* User access management by allowlisting or generating API keys
* Teams that are looking to customize and manage their proxy flows and infrastructure


# Create your first Proxy Manager
Source: https://docs.brightdata.com/proxy-networks/proxy-manager/quickstart

Get started with Bright Data Proxy Manager (default port 22999). Choose Cloud Server or On-Premise install, then configure your first managed proxy port.

<Callout icon="badge-dollar">
  **Verify your account and get \$5 credit**

  Add a payment method to verify your account and receive a \$5 credit. You won’t be charged at this stage.
</Callout>

<Steps>
  <Step title={<a href="https://brightdata.com/cp/start">Sign in to Bright Data</a>} />

  <Step title="Select your preferred method">
    <CardGroup>
      <Card title="Cloud Server (Recommended)" href="/proxy-networks/proxy-manager/configuration#bright-data-cloud-hosting" icon="cloud" />

      <Card title="On-Premise" href="/proxy-networks/proxy-manager/configuration#local-remote-installation" icon="house">
        You take care of the installation, management, and monitoring
      </Card>
    </CardGroup>

    <Accordion title="Cloud Server Benefits">
      * No installation or server setup necessary - Log-in straight to our [web app](https://brightdata.com/cp/zones/lpm) from anywhere

      * Managed end-to-end solution

      * Live server status monitoring by Bright Data's 24/7 team. To see further info on installation and setup see the [Introduction video](https://brightdata.com/webinar/how-to-start-using-the-bright-data-proxy-manager).

      * SSL analyzing support with OpenSSL and BoringSSL. BoringSSL is Bright Data's own implementation and provides additional unblocking value.
    </Accordion>
  </Step>

  <Step title="Start managing your proxies">
    Once Proxy Manager is installed, you can [log-in](https://brightdata.com/cp/zones/lpm) and start managing your proxies by [setting up ports](/proxy-networks/proxy-manager/configuration#port-targeting-configuration) configured with your zone settings.
  </Step>

  <Step title="Implement rules and headers">
    Now you can [implement rules and headers](/proxy-networks/proxy-manager/configuration#rules-and-headers-configuration) to customize your proxies to your needs. This will ensure a more cost-optimized usage of bandwidth and more accurate results.
  </Step>
</Steps>


# Secure your Proxy Manager setup
Source: https://docs.brightdata.com/proxy-networks/proxy-manager/security

Best practices for securing your Bright Data Proxy Manager (default port 22999), including IP allowlisting, admin access control and API key-based auth.

Ensuring the security of our products is crucial and remains a top priority for us. Our state-of-the-art architecture allows us to deliver you our Cloud hosted Proxy Manager with complete reliability and security and recommend this option for all of our customers.

For those that need an **on-premise** option for proxy manager (which is not hosted by Bright Data), we have outlined below the security measures that we recommend and best practices for putting them to use.

## Block unwanted sources from using the Proxy Manager's ports

Allowlist IPs on all your ports inside the Proxy Manager to ensure usage on those ports is only from allowed and wanted sources. While this feature is enabled, only the listed IPs will be allowed to send requests through the port with this configuration. Using this feature will ensure the bandwidth you pay for is consumed only by trusted sources.

## Block unwanted users from editing the Proxy Manager settings

Allowlist admin access to ensure only authorized IPs can perform changes to your Proxy Manager settings. This will block the admin page and the [Proxy Manager's API](/api-reference/proxy-manager/get_the_latest_proxy_manager_versions) when it is accessed from outside the server (where the Proxy Manager is hosted) from IPs which are not allowlisted.

## Authentication using API key

If you are using multiple crawlers with changing IPs to send requests to remote Proxy Manager server you will need to generate an API key to use for authentication on the Proxy Manager:

* Run Bright Data process from inside the server
* From the Proxy Manager's server run in terminal/command line:

```sh theme={null}
curl -X GET "http://127.0.0.1:22999/api/gen_token" -H "accept: application/json"
```

* You should be seeing the token response:

```js theme={null}
"token": "API key"
```

After generating an API key you have two options: either use the API key to allowlist the new IP once when the crawler server is set up or include the API key in the proxy auth of each request:

To make requests use the API key in the proxy auth use username "token" and the API key as the password, for example:

```sh theme={null}
curl -x token:API_KEY@127.0.0.1:24000 "http://brdtest.com/myip.json"
```

To allowlist your new server IP so you don't need to send it in proxy auth:

* Copy the API\_KEY from Proxy Manager server to new crawler server
* Make this request from your new server:

```sh theme={null}
curl [REMOTE_SERVER_IP]:22999/api/add_wip -X POST -H "Content-Type: application/json" -H "Authorization:[API_KEY]" -d '{"ip":"[CRAWLER_IP]"}'
```

* Your crawler ip is now allowlisted on the Proxy Manager

<Info>
  This will not give access to the Proxy Manager's admin panel but only to send requests through the ports
</Info>

## Local Network

If you want to access Proxy Manager from a network where many people share the same IP then allowlisting IP is not strong enough for you. By allowlisting your IP you are giving an access to all the people from the same local network (corporate environments often look like that).

Use `local_login` flag and Proxy Manager will require authentication from each browser separately and a newly generated API key will be stored in the cookies.

```sh Example theme={null}
pmgr --local_login
```


# How to configure your Residential proxy
Source: https://docs.brightdata.com/proxy-networks/residential/configure-your-proxy

Configure Bright Data Residential proxies (400M+ residential IPs): IP types, geolocation targeting, long-session peers, sticky IP duration and rotation.

Start by going to the configuration tab of the proxy you want to configure.

## Which proxy type to choose

**Choose one of four Proxy types (IPs types) for your proxy zone:**

<CardGroup>
  <Card title="Shared IPv4 proxies" icon="square-1">
    Rotating **IPv4** proxies worldwide, of real devices, worldwide.
  </Card>

  <Card title="Shared IPv4 & IPv6 Proxies" icon="square-2">
    A combined pool or rotating **IPv4 & IPv6** proxies of real devices, worldwide.
    Our "Mega Pool".
  </Card>

  <Card title="Shared IPv6 Proxies" icon="square-3">
    Rotating **IPv6** proxies worldwide, of real devices, worldwide.
  </Card>

  <Card title="Dedicated proxies" icon="square-4">
    Sets of proxies with exclusive access to a set of specific domains, with minimal to no rotation at all.
  </Card>
</CardGroup>

***

## Selecting the right Residential proxies

We offer 4 types of proxies on our Residential proxy netowrk:

Shared proxies:

1. Shared IPv4
2. Shared IPv4+IPv6 ("Mega pool")
3. Shared IPv6

Dedicated proxies:

4. Dedicated residential proxies

## Residential network access

Access to the Residential network requires KYC approval by the Bright Data compliance team and is available to verified companies only. This applies to every Residential proxy type, including shared, IPv6 and dedicated. For more information, see the [Residential network access policy](/proxy-networks/residential/network-access).

## Configuring Residential shared proxies (Rotating proxies)

Bright data will automatically assign a new proxy for each of your requests. You can control the behavior of the shared proxies as well as rotation using control panel settings and proxy options which are relayed in the proxy username parameter.

Most common setup is the Geolocation targeting allowing you to route your requests via proxies in specified location. You can select a default location - which will route all requests thru specific locations via our control panel.

<Tip>
  Best practice: set up a separate residential proxy zone, for each geolocation you wish to target.
</Tip>

### Geolocation resolution options

Geolocation targeting allows you to target specific locations based on `country`,`city`, `state`, `zip code`, or `ASN`. Select the resolution from the drop-down menu in your geolocation settings:

<Frame>
  <img alt="Geolocation Targeting" />
</Frame>

### Shared pool default countries' selection

When selecting countries in shared pool configuration, we will assign proxies only from the locations you select. You can select none (which means we will assign the next random proxy from the pool), one or more countries. [Read more...](/api-reference/proxy/geolocation-targeting#default-countries-selection)

You can override the default selection or explicitly assign a specific country for your peer during rotation, use the flag `-country` in the proxy user name parameter with an ISO-3166 country code.

[FAQ: Where can I see the list of country codes?](/general/faqs#where-can-i-see-the-list-of-country-codes)

***

## How to configure IPv4+IPv6 Shared residential proxies: "Mega Pool"

### Introduction: IPv6

Bright Data now supports IPv6 on its residential network. Setup and use of IPv6 proxies is very similar to IPv4 proxies. 

IPv6 (Internet Protocol version 6) is the most recent version of the Internet Protocol, designed to replace IPv4. It was developed to address the limitations of IPv4, particularly the exhaustion of available IP addresses. While IPv4 uses 32-bit addresses (allowing for about 4.3 billion unique IPs), IPv6 uses 128-bit addresses, enabling a virtually unlimited number of unique IP addresses, over 340 undecillion (3.4×10³⁸).

What types of IPv6 Residential pools do we offer?

Bright data offers two types of residential pools with IPv6 proxies:

1. Combined IPv4+IPv6: also called "Mega Pool", of shared rotating proxies
2. IPv6 only shared rotating proxies

Bright Data currently does not offer IPv6 proxies in Datacenter or ISP networks.

### How big is IPv6 residential network?

We now support IPv6 on our worldwide reliable residential proxy network. Approximately 150,000 peers are available, with new ones joining every week. The proxies are collated in our “rotating shared pool” of residential proxies. 

### What is IPv6 Access Policy?

IPv6 proxies follow the [Residential network access policy](/proxy-networks/residential/network-access). They are available only to KYC-verified companies that are eligible to use this protocol over the Residential network. 

### Which options of Bright Data residential IPv6 proxies can I use?

All our IPv4 options are supported, except the list below:

| Targeting Option | Description                                          |
| :--------------- | :--------------------------------------------------- |
| `gip`            | No selected gIP targeting (group of residential IPs) |
| `asn`            | No ASN targeting                                     |
| `zip`            | No ZIP code targeting                                |
| `ip`             | No explicit IP targeting                             |
| `carrier`        | No mobile carrier targeting                          |
| `os`             | No explicit operating system targeting               |

If you chose to relay those in your proxy username and your zone was set to IPv6, we will ignore them and process the request. 

Full list of options can be found here: <u>[https://docs.brightdata.com/proxy-networks/config-options](https://docs.brightdata.com/proxy-networks/config-options)</u>

### What happens if I target IPv4 only host with IPv6 proxy?

If you choose to target with IPv6 proxy an IPv4 only domain, which do not have an IPv6 address, your request will result in HTTP error 502, with Bright Data error header (x-brd-err-code): `target_40011`. You should retry the request with IPv4 proxy. 

Full list of errors can be seen in our catalog, together with target\_40011 here: <u>[https://docs.brightdata.com/proxy-networks/errorCatalog#target-40011](https://docs.brightdata.com/proxy-networks/errorCatalog#target-40011)</u>

### Can I switching zone from IPv4 to IPv6 and vice versa?

Yes. You can switch the zone from IPv4 to IPv6 and vice versa without any limitation. Once protocol version is chosen, it will impact all the proxies assigned to this zone and the selected protocol proxies will be assigned to relay your requests.

### Does the price of IPv6 traffic changes?

IPv6 traffic is currently charged at the same rate as IPv4. In your bill we will calculate how much traffic was relayed by which protocol version and charge accordingly. You can switch your zone between IPv6 and IPv4 - Bright Data will calculate the traffic and bill accordingly. 

### Is there any change in access details or proxy credentials for IPv6?

No. All access details and credentials are identical to IPv4: Host, port, username and password remain the same. If you provide a username with parameters which are not supported in IPv6 (listed above) they will be ignored.

### Can I use IPv6 to access Bright Data proxy services?

No. We do not allow IPv6 to access our own proxy gateway: your accessing scraper or utility must connect to Bright Data using IPv4. Attempting to access with IPv6 will result in error. The error will be DNS related error stating that domain [brd.superproxy.io](http://brd.superproxy.io) could not be resolved.

Example with curl call:

```sh theme={null}
curl -i --proxy brd.superproxy.io:44445 --proxy-user brd-customer-*******-zone-residential_proxy21:********** "https://geo.brdtest.com/welcome.txt?product=resi&method=native" -g -6
```

Response error:

```sh theme={null}
curl: (5) Could not resolve proxy: [brd.superproxy.io](http://brd.superproxy.io)
```

#### Do I need to define allowlist and denylist in IPv6?

No. Allowlist (whitelist) and denylist (blacklist) refer to the IP addresses you use to connect to Bright Data proxy services. Since we allow only IPv4 to connect to our proxy service from your side, settings remain in IPv4 even if the zone is IPv6. Those lists determine which IPs can/cannot send requests to the zone and remain as IPv4 IPs and ranges. 

## Configuring dedicated residential proxies access

Dedicated Residential proxies are available **only** after KYC approval by the Bright Data compliance team. Until your account is KYC-verified, the **Dedicated** option stays **disabled** in the control panel. For details, see the [Residential network access policy](/proxy-networks/residential/network-access).

<Note>
  To create a dedicated Residential zone via API, see the [Dedicated Residential (gIP) zone example in Add a zone](/api-reference/account-management-api/Add_a_Zone#dedicated-residential-gip-zone).
</Note>

### IP Groups `gIPs`

<Note>
  Only works with the **Dedicated** option
</Note>

`gIP` contains between 6-90 IPs at any given moment while sharing the same attributes, targeting the selected dedicated domains within the zone "Configuration" section. `gIPs` are used by Bright Data to create a single identifier for this group of proxies (with distinct IP addresses). Those proxies will be used explicitly by you towards the domains you target.

<Frame>
  <img alt="Geolocation Targeting" />
</Frame>

***

### How to set dedicated domains

<Warning>
  Only works with the **Dedicated** option
</Warning>

Define the domains you'd like your proxies to be exclusive to. Every request to a domain in this list is served thru your dedicated proxies exclusively. No one else is allowed to target those domains via your dedicated proxies. You can use this zone for requests to other target domains, yet those requests will be served thru our datacenter hosted Bright Data proxies.

For example: if in the list you have two domains: a.com and b.com, every request to a.com and b.com are routed thru your dedicated proxies, request to c.com is routed thru our datacenter hosted proxy. Requests to a.com and b.com from others will **never** go thru your dedicated proxies.

<Frame>
  <img alt="Domains" />
</Frame>

***

## How to configure advanced options

### Automatic failover for unavailable peers

In case we cannot reach the proxy peer for your request, we will route the request to another available peer. Automatic failover does not apply when you choose default countries: if we cannot find a peer in the country you selected, we will fail the request with error.

Enabling automatic failover assures execution of the request, regardless of the availability of a specific peer.

#### Automatic failover when accessing target website which does not publish IPv6 address with IPv6 proxy

To ensure continuity, we enable IPv6 to IPv4 automatic failover, which you can configure in the zone's advanced settings to either on or off (default: `ON`).

When toggled "On" (default), in case your target website does not publish an IPv6 address, we will route the request via an available IPv4 proxy in the same location. If this toggle is not enabled, trying to access a target host without IPv6 address will result in an error: [https://docs.brightdata.com/proxy-networks/errorCatalog#target-40011](https://docs.brightdata.com/proxy-networks/errorCatalog#target-40011)

***

### Special Ports & Protocols

Ports `80` and `443` are available by default, supporting HTTP and HTTPS & SOCKS5 protocols. We also support all ports over `1024` in our Datacenter proxy network. [Read more on ports and protocols...](/proxy-networks/faqs#how-to-see-supported-ports-and-protocols)

<Accordion title="Request Additional ports">
  Bright Data can support additional ports by request. A dedicated and additional compliance process with the Bright Data compliance team will follow every request to support a new port.
  If you would like additional port permissions, you can contact Bright Data Support.
  Examples of ports that require Bright Data compliance review before activation:

  | Port | Protocol |
  | ---- | -------- |
  | `70` | HTTP     |
  | `98` | HTTPS    |
</Accordion>

### Zone usage limit

A zone usage limit is an optional cap you set on a Residential proxy zone so it cannot consume more than a fixed amount of spending or traffic. Use it to keep a single zone inside a known budget and bandwidth envelope, which matters most on rotating shared pool proxies where consumption scales with request volume.

You can cap a zone in one of two ways:

* **Spending limit:** cap the amount the zone is allowed to spend.
* **Traffic limit:** cap the amount of bandwidth the zone is allowed to use.

#### When to use a spending limit vs a traffic limit

* Choose a **spending limit** when your priority is cost control and you want a hard ceiling on what a zone can bill.
* Choose a **traffic limit** when your priority is bandwidth control, for example to stop one project or zone from exhausting a shared bandwidth allocation.

#### How to set a zone usage limit

Set a usage limit from the proxy page:

1. Open the [My proxies](https://brightdata.com/cp/zones) page.
2. Click the proxy you want to limit.
3. Open the **Access parameters** tab.
4. Scroll to **Limit** (the default is unlimited).
5. Click **edit**.
6. Enable the spend or traffic limit.
7. Set the limit you want by choosing one of: `$/day`, `$/month`, `bytes/day` or `bytes/month`.
8. Click **update**.

<Note>
  When the limit is reached, the zone can be suspended, alerted or both, depending on your configuration. The limit is checked every 15 minutes, so it may not take effect immediately. If traffic is high, usage stats can lag. You can recalculate them from the zone's **Statistics** table using the **recalc** button.
</Note>

To see how much a zone is consuming against its limit, review your zone usage in the dashboard. For more detail, see [Usage monitoring](/general/usage-monitoring/Usage) and the [bandwidth usage limits FAQ](/general/faqs). For background on bandwidth fairness on shared pools, see [Fair use allowance](/general/usage-monitoring/fair_use_allowance).


# Residential products FAQ
Source: https://docs.brightdata.com/proxy-networks/residential/faqs

FAQs about Bright Data Residential proxies (400M+ residential IPs): IP types, country coverage, geotargeting, session control and common error codes.

<AccordionGroup>
  <Accordion title="Why do I need KYC for Residential proxies?">
    Bright Data Residential proxies are available only to verified companies that pass a human-reviewed KYC (Know Your Customer) check by the Bright Data compliance team. Residential IPs come from 100% real people who opted in to the network, so the compliance team verifies your business and use case before you route traffic through them. Approval is never automatic or instant. See the [Residential network access policy](/proxy-networks/residential/network-access) for the full process.
  </Accordion>

  <Accordion title="I signed up with a personal email. Can I use Residential?">
    No. Residential access is granted to verified companies only. KYC applications are accepted only from registered businesses with a corporate email domain, so a personal-email account (for example Gmail or Outlook) cannot be approved. Add a user with your company email domain, then submit [KYC](https://brightdata.com/cp/kyc). Without KYC you can use [ISP proxies](/proxy-networks/isp/introduction), [Datacenter proxies](/proxy-networks/data-center/introduction) and the [Web Unlocker API](/scraping-automation/web-unlocker/introduction).
  </Accordion>

  <Accordion title="Can I switch my existing ISP or Datacenter zone to Residential?">
    Only after KYC approval. Creating or converting a zone to Residential is blocked until the Bright Data compliance team approves your KYC submission. Your existing ISP and Datacenter zones keep working while your KYC is under review. Start at [KYC verification](https://brightdata.com/cp/kyc).
  </Accordion>

  <Accordion title="What can I use without KYC?">
    Use these alternatives to Residential proxies, none of which require KYC:

    * **[ISP proxies](/proxy-networks/isp/introduction):** static, residential-registered IPs with datacenter speed, for ad verification, QA and long, stable sessions.
    * **[Datacenter proxies](/proxy-networks/data-center/introduction):** fast, low-cost shared or dedicated IPs for high-volume requests.
    * **[Web Unlocker API](/scraping-automation/web-unlocker/introduction):** managed unblocking that handles headers, cookies, CAPTCHAs and retries, billed per successful request.

    These are alternatives, not a limited or trial Residential mode.
  </Accordion>

  <Accordion title="How to integrate a new proxy into your code?">
    To integrate the proxies into your code, please visit the [API examples page](https://brightdata.com/cp/zones/proxy_examples), which can be accessed via your zone's settings, under "access parameters":

    <img alt="integrate-new-proxy.gif" />

    On this page, you can choose integration examples for most modern coding languages, just choose the integration type, your proxy zone, coding language, etc. and the page will generate a code snippet you can use right away.
  </Accordion>

  <Accordion title="How to integrate a proxy into 3rd party software?">
    Check out a few examples in the [API examples](https://brightdata.com/cp/zones/proxy_examples) page mentioned above (just choose "other software" in the "language" drop-down menu), or check our [Integrations page](/integrations), where we have specific guides to integrate our proxies within the most popular tools across the industry today.

    **Important note**: If you are using Bright Data's Web Unlocker API, Residential Proxies or the SERP API you probably need to use our SSL certificate to enable end-to-end secure connections. See [instructions here](/general/account/ssl-certificate).

    We have prepared detailed guides for the most commonly used tools. You can find links to the guides in the list below:

    BrowserScan 	[https://docs.brightdata.com/integrations/browserscan](/integrations/browserscan)

    XLogin 		[https://docs.brightdata.com/integrations/xlogin](/integrations/xlogin)

    GeeLark 	[https://docs.brightdata.com/integrations/geelark](/integrations/geelark)

    Puppeteer 	[https://docs.brightdata.com/integrations/puppeteer](/integrations/puppeteer)

    Playwright 	[https://docs.brightdata.com/integrations/playwright](/integrations/playwright)

    Selenium 	[https://docs.brightdata.com/integrations/selenium](/integrations/selenium)

    AdsPower 	[https://docs.brightdata.com/integrations/adspower](/integrations/adspower)

    Dolphin Anty 	[https://docs.brightdata.com/integrations/dolphin-anty](/integrations/dolphin-anty)

    Incogniton 	[https://docs.brightdata.com/integrations/incogniton](/integrations/incogniton)

    Marketerbrowser [https://docs.brightdata.com/integrations/marketerbrowser](/integrations/marketerbrowser)

    SMLOGIN 	[https://docs.brightdata.com/integrations/smlogin](/integrations/smlogin)

    Hidemyacc 	[https://docs.brightdata.com/integrations/hidemyacc](/integrations/hidemyacc)

    OpenBullet	[https://docs.brightdata.com/integrations/openbullet](/integrations/openbullet)

    Switchyomega 	[https://docs.brightdata.com/integrations/switchyomega](/integrations/switchyomega)

    PhantomBuster 	[https://docs.brightdata.com/integrations/phantombuster](/integrations/phantombuster)

    BitBrowser 	[https://docs.brightdata.com/integrations/bitbrowser](/integrations/bitbrowser)

    Maskfog 	[https://docs.brightdata.com/integrations/maskfog](/integrations/maskfog)

    Ghost Browser 	[https://docs.brightdata.com/integrations/ghost-browser](/integrations/ghost-browser)

    Postman 	[https://docs.brightdata.com/integrations/postman](/integrations/postman)

    NGINX 		[https://docs.brightdata.com/integrations/nginx](/integrations/nginx)

    StablerSOLO 	[https://docs.brightdata.com/integrations/stablersolo](/integrations/stablersolo)

    VMLogin 	[https://docs.brightdata.com/integrations/vmlogin](/integrations/vmlogin)

    GoLogin 	[https://docs.brightdata.com/integrations/gologin](/integrations/gologin)

    Windows 	[https://docs.brightdata.com/integrations/windows](/integrations/windows)

    Scrapy 		[https://docs.brightdata.com/integrations/scrapy](/integrations/scrapy)

    AEZAKMI 	[https://docs.brightdata.com/integrations/aezakmi](/integrations/aezakmi)

    Beautifulsoup 	[https://docs.brightdata.com/integrations/beautifulsoup](/integrations/beautifulsoup)

    WebHarvy 	[https://docs.brightdata.com/integrations/webharvy](/integrations/webharvy)

    Ubuntu 		[https://docs.brightdata.com/integrations/ubuntu](/integrations/ubuntu)

    Lalicat 	[https://docs.brightdata.com/integrations/lalicat](/integrations/lalicat)

    Multilogin 	[https://docs.brightdata.com/integrations/multilogin](/integrations/multilogin)

    Undetectable 	[https://docs.brightdata.com/integrations/undetectable](/integrations/undetectable)

    Apify 		[https://docs.brightdata.com/integrations/apify](/integrations/apify)

    iPhone 		[https://docs.brightdata.com/integrations/ios](/integrations/ios)

    MuLogin 	[https://docs.brightdata.com/integrations/mulogin](/integrations/mulogin)

    Changedetection [https://docs.brightdata.com/integrations/changedetection](/integrations/changedetection)

    Morelogin 	[https://docs.brightdata.com/integrations/morelogin](/integrations/morelogin)

    Proxifier 	[https://docs.brightdata.com/integrations/proxifier](/integrations/proxifier)

    Texau 		[https://docs.brightdata.com/integrations/texau](/integrations/texau)

    Android 	[https://docs.brightdata.com/integrations/android](/integrations/android)

    Kameleo 	[https://docs.brightdata.com/integrations/kameleo](/integrations/kameleo)

    Screaming Frog 	[https://docs.brightdata.com/integrations/screaming-frog](/integrations/screaming-frog)

    Foxy		[https://docs.brightdata.com/integrations/foxyproxy](/integrations/foxyproxy)

    SessionBox 	[https://docs.brightdata.com/integrations/sessionbox](/integrations/sessionbox)

    Insomniac 	[https://docs.brightdata.com/integrations/insomniac](/integrations/insomniac)

    Helium Scraper 	[https://docs.brightdata.com/integrations/helium-scraper](/integrations/helium-scraper)

    SaleFreaks 	[https://docs.brightdata.com/integrations/salefreaks](/integrations/salefreaks)

    Postern 	[https://docs.brightdata.com/integrations/postern](/integrations/postern)

    Antik 		[https://docs.brightdata.com/integrations/antik](/integrations/antik)

    Easync 		[https://docs.brightdata.com/integrations/easync](/integrations/easync)

    ParseHub 	[https://docs.brightdata.com/integrations/parsehub](/integrations/parsehub)

    Sphere Browser 	[https://docs.brightdata.com/integrations/sphere-browser](/integrations/sphere-browser)

    Octoparse 	[https://docs.brightdata.com/integrations/octoparse](/integrations/octoparse)

    ixBrowser 	[https://docs.brightdata.com/integrations/ixbrowser](/integrations/ixbrowser)

    Shadowrocket 	[https://docs.brightdata.com/integrations/shadowrocket](/integrations/shadowrocket)

    Firefox 	[https://docs.brightdata.com/integrations/firefox](/integrations/firefox)

    Chrome 		[https://docs.brightdata.com/integrations/chrome](/integrations/chrome)

    MacOS 		[https://docs.brightdata.com/integrations/macos](/integrations/macos)

    ClonBrowser 	[https://docs.brightdata.com/integrations/clonbrowser](/integrations/clonbrowser)

    Octo Browser 	[https://docs.brightdata.com/integrations/octobrowser](/integrations/octobrowser)

    Genlogin 	[https://docs.brightdata.com/integrations/genlogin](/integrations/genlogin)

    Web Scraper 	[https://docs.brightdata.com/integrations/webscraper](/integrations/webscraper)

    If the integration you're using does not appear on the list and you would like to get a guide for it, contact us!
  </Accordion>

  <Accordion title="How to target a Specific Country?">
    When sending your request, add the `-country` flag, **after** your zone’s name in the request, followed by the 2-letter [ISO code](https://www.nationsonline.org/oneworld/country_code_list.htm) for that country.

    In the example below: We added `-country-us` to our request, so we will send a request originating from the United States ("us").

    ```sh theme={null}
    curl "http://target.site" --proxy brd.superproxy.io:44445 --proxy-user brd-customer-<customer_id>-zone-<zone_name>-country-us:<zone_password>
    ```
  </Accordion>

  <Accordion title="How to target the EU region">
    <Note>
      The allocation of a country within the EU is random.
    </Note>

    <Info>
      Relevant for DC, ISP, and Unlocker/SERP API
    </Info>

    You can target the entire European Union region in the same manner as "Country" above by adding "eu" after "country" in your request: -country-eu

    Requests sent using -country-eu, will use IPs from **one** of the countries below which are included automatically within "eu":

    ```text theme={null}
    AL, AZ, KG, BA, UZ, BI, XK, SM, DE, AT, CH, UK, GB, IE, IM, FR, ES, NL, IT, PT, BE, AD, MT, MC, MA, LU, TN, DZ, GI, LI, SE, DK, FI, NO, AX, IS, GG, JE, EU, GL, VA, FX, FO
    ```
  </Accordion>

  <Accordion title="How to target a Specific City?">
    In order to target a specific city you will need to use a [Shared (pay-per-IP)](/proxy-networks/data-center/configure-your-proxy#ip-type) or [Dedicated](/proxy-networks/data-center/configure-your-proxy#ip-type) proxy network.

    When configuring your proxy zone, after selecting your preferred country, you can add a city, to further specify your geotargeting

    <img alt="add-city.png" />

    Once you click on **'Add city'** you will be displayed the available cities to target, for the selected country. In order to check the [number of available IPs](https://brightdata.com/cp/ips_availability) for a specific geolocation.

    Once configured, you'll be able to send requests from the selected city, using the following syntax

    ```sh theme={null}
    curl "http://target.site" --proxy brd.superproxy.io:44445 --proxy-user brd-customer-<customer_id>-zone-<zone_name>-country-<country>-city-<city>:<zone_password>
    ```

    <Note>
      When selecting a two-word city it'll be written as one word.

      For example, when targeting Buenos Aires the syntax of the request will be:

      `-country-ar-city-buenosaires`
    </Note>

    To view more geotargeting examples, you may want to review our [proxy integration examples page.](https://brightdata.com/cp/zones/proxy_examples)
  </Accordion>

  <Accordion title="Where does Bright Data have proxies?">
    Bright Data offers proxies in every country in the world, except in the following countries:

    * Iran
    * Iraq
    * Syria
    * Lebanon
    * Palestine
    * North Korea
    * Cuba
    * Sudan
    * Belarus
    * Russia

    If you need proxies from these countries, unfortunately Bright Data will not be able to help you.
  </Accordion>

  <Accordion title="How to view the proxy event log?">
    The event log will show you (at most) the last 200 requests you made with any zone in your account.

    In your Bright Data control panel's proxies page: [https://brightdata.com/cp/zones](https://brightdata.com/cp/zones)

    Go to the "Event Log" tab:

    <img alt="event-log.png" />

    The presented data is:

    * **Date:** Time and date of the request
    * **Zone:** What Zone was used for the request
    * **Source IP:** What IP the request was made from
    * **URL:** The target site of the request
    * **Result:** Success or Fail of the request

      <img alt="event-log-headers.png" />
  </Accordion>

  <Accordion title="How to keep using the same IP in multiple requests?">
    * This can be done by adding the `session` parameter to the proxy username:

    ```sh theme={null}
    brd.superproxy.io:44445 br-customer-<customer_id>-zone-<zone_name>-session-rand39484
    ```

    Generate the random number on thread startup, and change it when you want to change the Proxy Peer assigned for the thread's connection.

    * Session ID can be any random string/counter: requests with the same session string will use the same Proxy Peer (as long as possible); requests with different session strings will be assigned different Proxy Peers.

    <Warning>
      - Using the following characters in the session ID will throw an error: `-` `"` \`\`\`
      - This feature is only available for our proxy products, it will **not** work for Scraping Automation products such as the Web Unlocker API
    </Warning>

    * To force an IP change, just modify the session ID
    * If an assigned Proxy Peer (exit node IP) becomes unavailable, the Super Proxy will return an error "502 - No peers available" for the first request and then on the second request the super proxy will assign a new peer even if you do not change the session ID.
    * The Session IP is kept persistent for up to 5 minute of idle time. After 5 minutes with no requests, the IP is released back to the pool. To keep this Session/IP for longer, send a tiny keep-alive request every 30 seconds, to prevent this session from becoming idle for over a minute. This request may be anything small, such as /favicon.ico, or even a request that returns 404 (as long as the web server does not disconnect the socket due to this request).
  </Accordion>

  <Accordion title="How to target specific OS?">
    Bright Data allows targeting the following **Operating Systems**:

    <CodeGroup>
      ```sh Windows theme={null}
      curl --proxy-user brd-customer-<customer_id>-zone-<zone_name>-os-windows:<zone_password> --proxy brd.superproxy.io:44445 "<target_site>"
      ```

      ```sh macOS theme={null}
      curl --proxy-user brd-customer-<customer_id>-zone-<zone_name>-os-osx:<zone_password> --proxy brd.superproxy.io:44445 "<target_site>"
      ```

      ```sh Android theme={null}
      curl --proxy-user brd-customer-<customer_id>-zone-<zone_name>-os-android:<zone_password> --proxy brd.superproxy.io:44445 "<target_site>"
      ```
    </CodeGroup>
  </Accordion>

  <Accordion title="How to use a specific IP?">
    When using Bright Data's Residential Proxy network, you may find the need to use a specific IP allocated to your zone.

    1. **Send a test request** with a '--verbose' or '-v' option added (this will turn on verbose logging)

    ```sh theme={null}
    curl "https://brdtest.com/myip.json" --verbose --proxy brd.superproxy.io:44445 --proxy-user brd-customer-<customer_id>-zone-<zone_name>:<zone_password>
    ```

    2. **Locate** the x-brd-ip response header and copy its value

       <img alt="x-brd-ip.png" />

    3. **Add** the -ip- flag to your request, after your zone’s name and use the **hashed IP value** copied in the previous step

    4. Send a test request, and **review the response**

    ```sh theme={null}
    curl "https://brdtest.com/myip.json" --proxy brd.superproxy.io:44445 --proxy-user brd-customer-<customer_id>-zone-<zone_name>-ip-<hashed-ip>:<zone_password>
    ```

    We recommend using [https://brdtest.com/myip.json](https://brdtest.com/myip.json) as the target domain for testing, and to review your IP credentials.
  </Accordion>

  <Accordion title="How to targeting an ASN specific IP?">
    This feature can be enabled by adding the ASN parameter to your Zone configuration, under **Geolocation Targeting**.

    <img alt="asn-targeting.png" />

    Once the configuration is saved, the ASN flag can be added to the Zone's credentials\
    and be integrated when using the Residential proxies. For example:

    ```sh theme={null}
    curl --proxy brd.superproxy.io:44445 --proxy-user brd-customer-<customer_id>-zone-<zone_name>-asn-<asn-number>:<zone_password> "<target_site>"
    ```

    **Note:** Values for ASN number can be found [here](https://bgp.potaroo.net/cidr/autnums.html).
  </Accordion>

  <Accordion title="How to target residential proxy using group IP (gIPs)?">
    Dedicated residential IPs can be targeted in the form of [gIPs](/proxy-networks/residential/configure-your-proxy#ip-groups-gips). They can be allocated under the zone's configuration page by selecting a "Dedicated" IP type and choosing a number of gips. Also targeting a specific domain is required.

    <img alt="number-of-dedicated-gIPs.png" />

    Once the configuration is saved, selecting "Show allocated Dedicated residential IPs" will provide a list of hash values that represent group IPs.

    <img alt="show-allocated-dedicated-ips.png" />

    These values can be used to target a specific gip. For example:

    ```sh theme={null}
    curl --proxy brd.superproxy.io:44445 --proxy-user brd-customer-<customer_id>-zone-<zone_name>-gip-<gip_hash_value>:<zone_password> "<target_site>"
    ```
  </Accordion>

  <Accordion title="How to browse Chinese sites by using Chinese Residentials IPs">
    **When outside of China**\
    Targeting Chinese Residential IP peers is enough:

    ```sh theme={null}
    curl --proxy brd.superproxy.io:44445 --proxy-user brd-customer-<customer_id>-zone-<zone_name>-country-cn:<zone_password> "<target_site>"
    ```
  </Accordion>

  <Accordion title="Carrier-specific Proxy peer IP">
    * You can choose to use a specific carrier from this list:

    ```text theme={null}
    a1, aircel, airtel, att, celcom, chinamobile, claro, comcast, cox, digi, 
    dt, docomo, dtac, etisalat, idea,  meo, mtn, mtnza, 
    optus, orange, qwest, reliance_jio, robi, sprint, telefonica, telstra, 
    tmobile, tigo, tim, verizon,  vodacomza, vodafone, vivo, zain,
    vivabo, telenormyanmar, kcelljsc, swisscom, singtel, asiacell, windit, 
    cellc, ooredoo, drei, umobile, cableone, proximus, mobitel, o2, 
    bouygues, free, sfr, digicel
    ```

    * For Example

    <CodeGroup>
      ```sh Deutsche Telekom theme={null}
      brd-customer-<customer_id>-zone-<zone_name>-carrier-dt
      ```

      ```sh Sprint theme={null}
      brd-customer-<customer_id>-zone-<zone_name>-carrier-sprint
      ```
    </CodeGroup>
  </Accordion>

  <Accordion title="Which Bright Data products are best for scraping search engines (SERPs)?">
    #### For single-step scraping:

    [SERP API](/scraping-automation/serp-api/introduction) is the ideal product for targeting SERPs as it has a guaranteed success rate (pay only for success) with active unlocking, automatically chooses the best proxies, customizes headers, fingerprinting, solves CAPTCHAs, and more.

    #### For multi-step scraping (playwright/puppeteer/selenium):

    [Browser API](/scraping-automation/scraping-browser/introduction) is the ideal product as it is our fully cloud-hosted browser designed to help you easily focus on your multi-step data collection while we take care of the full proxy and unblocking infrastructure for you, including CAPTCHA solving.
  </Accordion>

  <Accordion title="Can I target Google SERPs from the Residential, Datacenter, or ISP Proxy network?">
    **Residential Proxy** - No, [SERP API](/scraping-automation/serp-api/introduction) is the ideal product for targeting SERPs as it has a guaranteed success rate (pay only for success) with active unlocking, automatically chooses the best proxies, customizes headers, fingerprinting, solves CAPTCHAs, and more. Targeting Google SERPs from the Residential network will result in Super-proxy bypass, which will casue the request to be sent from our servers instead of the peer.

    **Datacenter & ISP Proxies** - No. When attempting to specifically target Google through either of these proxy networks, your request will be denied and you will receive the following error message in the response headers:

    ```text theme={null}
    HTTP/1.1 403 Search engine host is not allowed
    X-Luminati-Error: Forbidden: This target URL isn't supported on proxy networks, use the SERP API product for targeting this URL. You may contact your account manager or open a support ticket for assistance
    ```
  </Accordion>

  <Accordion title="Targeting search engines via bright data Residential & Mobile networks">
    When targeting search engines through the Residential or Mobile networks, the request will not go through the Residential or Mobile peer but instead will be sent directly through one of our super proxies. The reason for this behavior is to support the integration of the Residential and Mobile networks with a browser, which might need to load search engine resource endpoints from the target website.

    **In case you target a search engine domain using Residential or Mobile networks, the request will be passed directly through the super proxy, and the following response header will serve as an indication:**

    ```sh theme={null}
    x-brd-ip: superproxy bypass
    ```
  </Accordion>

  <Accordion title="How can I see the IP address of my Residential proxy? ">
    Bright Data does not allow to see an open text version of your Residential and Mobile IP addresses. Datacenter and ISP Proxy IPs are open in clear text format. 

    When you send a request, in the reply header, you will see a reply header of `x-brd-ip` . This reply header includes a unique hash which represents the IP address you used for this request. 
  </Accordion>
</AccordionGroup>


# Introduction to Residential proxies
Source: https://docs.brightdata.com/proxy-networks/residential/introduction

Bright Data Residential proxy network: 400M+ monthly residential IPs from 195+ countries for browsing and data collection as a real user.

Bright Data's [Residential proxy network](https://brightdata.com/proxy-types/residential-proxies) routes your traffic through 400M+ real residential IPs across 195+ countries, so target sites see your requests as genuine local users. It is built for accessing sophisticated, highly protected sites that block datacenter and automated traffic.

Unlike Datacenter proxies, Residential proxies route requests through real devices owned by real users who have opted in to the network and are compensated for participating. This makes your traffic appear to originate from authentic residential connections in the location you target.

```sh Native proxy access theme={null}
curl "http://brdtest.com/myip.json" \
  --proxy brd.superproxy.io:44445 \
  --proxy-user brd-customer-<customer_id>-zone-<zone_name>:<zone_password>
```

The response reports the exit IP and its location. See [Send your first request](/proxy-networks/residential/send-your-first-request) for Python, Node.js and cURL examples.

## How do Residential proxies work?

When you send a request through the Residential proxy network, Bright Data routes it through a real residential device in your chosen target region. For each request, the network automatically:

* Selects an appropriate residential IP from the target location
* Manages IP availability and rotation
* Maintains session stability when a sticky session is required
* Handles network-level reliability and scaling

Because the request originates from a real household or mobile connection, sites perceive the traffic as a genuine end user rather than a server-based proxy.

## Why use Residential proxies?

Residential proxies give you the widest pool and the most authentic footprint of any Bright Data proxy type:

* Higher success rates on sites with strict anti-bot or anti-scraping defenses than Datacenter proxies
* Access to localized content such as regional pricing, language variations and geo-restricted pages
* A 400M+ IP pool that lowers the chance of hitting a blocked or reused address
* Infrastructure that scales from a single request to production workloads

## When should you use Residential proxies?

Residential proxies are well suited for:

* Browsing and interacting with sophisticated websites as a real user
* Business intelligence, market research and competitor monitoring
* Ad verification and brand protection across different regions
* Price comparison and product availability tracking
* Cases where [Datacenter proxies](/proxy-networks/data-center/introduction) or [ISP proxies](/proxy-networks/isp/introduction) return low success rates or frequent blocks

If you currently hit access issues with Datacenter or ISP proxies, switching to Residential proxies can significantly improve reliability.

## What geographic targeting is available?

The Residential proxy network supports fine-grained targeting. You can route traffic through IPs by:

* Country
* State or region (where supported)
* City
* ZIP code (United States only)
* ASN and carrier (depending on proxy configuration)

## How is the Residential proxy network sourced?

Bright Data's Residential proxy network is built on an explicit opt-in model. Every participant:

* Is informed about how their IP is used
* Provides consent through an approved application
* Is compensated for participating

This model keeps the network compliant with data protection regulations and supports responsible, transparent use of residential IPs.

## FAQ

### How many Residential IPs does Bright Data have?

The Residential proxy network provides 400M+ residential IPs across 195+ countries, refreshed monthly.

### How are Residential proxies different from ISP and Datacenter proxies?

Residential IPs come from real end-user devices, so they are far less likely to be blocked by strict anti-bot systems than Datacenter proxies. ISP proxies offer datacenter speed with residential-registered IPs, while Residential proxies offer the widest pool and the most authentic footprint.

### Can you target a specific city or ZIP code?

Yes. You can target by country, state or region, city, ZIP code (United States only), and ASN or carrier depending on your configuration.

### Is Bright Data's Residential network ethically sourced?

Yes. Every IP comes from a participant who opted in through an approved application, is told how their IP is used, and is compensated for participating.

<Tip>
  If you need a fully managed unblocking solution that goes beyond IP-based access, handling site-specific headers, cookies, CAPTCHAs, JavaScript challenges and retries automatically, use the [Web Unlocker API](/scraping-automation/web-unlocker/introduction).
</Tip>

## Related

<CardGroup>
  <Card title="Quickstart" icon="rocket" href="/proxy-networks/residential/quickstart">
    Create a Residential proxy zone and get your credentials.
  </Card>

  <Card title="Send your first request" icon="paper-plane" href="/proxy-networks/residential/send-your-first-request">
    Route your first request in Python, Node.js or cURL.
  </Card>

  <Card title="Network access" icon="key" href="/proxy-networks/residential/network-access">
    Complete KYC and unlock full residential access.
  </Card>

  <Card title="Configure your proxy" icon="sliders" href="/proxy-networks/residential/configure-your-proxy">
    Set country targeting, session control and rotation.
  </Card>
</CardGroup>


# Residential network access policy
Source: https://docs.brightdata.com/proxy-networks/residential/network-access

Bright Data Residential proxies require KYC review by the compliance team and are available to verified companies only. No automatic or instant access.

Bright Data Residential proxies are available only to verified companies that pass a human-reviewed KYC (Know Your Customer) check by the Bright Data compliance team. There is no automatic, instant or self-serve path to the Residential network.

<Note>
  **Existing zones are unaffected.** Residential zones created on or before July 7, 2026 continue to work as expected. The KYC requirement applies only to new Residential zones created after July 7, 2026. Customers already verified for Residential access keep it and nothing changes.
</Note>

## Who can access the Residential network?

Residential access is granted only to registered companies, and only after the Bright Data compliance team reviews and approves your KYC submission.

* **Verified companies only.** You must sign up on behalf of a registered company and verify a corporate email domain. Accounts on a personal email (for example Gmail or Outlook) are not eligible for Residential access.
* **Human-reviewed KYC.** Every Residential request is reviewed by the Bright Data compliance team. Approval is never automatic, instant or self-serve.
* **All Residential proxy types.** For new Residential zones created after July 7, 2026, KYC approval is required for every proxy type: shared rotating IPv4, the IPv4 and IPv6 "Mega Pool", IPv6 and dedicated Residential proxies.
* **Existing zones keep working.** Residential zones created on or before July 7, 2026 continue as usual. The KYC requirement applies only to new Residential zones created after July 7, 2026, and customers already verified for Residential access do not need to reapply.

<Warning>
  Some restrictions also apply on the Datacenter and ISP networks. For example, government websites are blocked across all networks. See the [proxy errors catalog](/proxy-networks/errorCatalog) for the specific errors.
</Warning>

## What can I use without KYC?

If you have not completed KYC, or your use case does not need Residential IPs, use one of these alternatives. None of them require KYC:

* **[ISP proxies](/proxy-networks/isp/introduction)** give you static, residential-registered IPs with datacenter speed and stability. Use them for ad verification, QA and long-session workloads.
* **[Datacenter proxies](/proxy-networks/data-center/introduction)** give you fast, low-cost shared or dedicated IPs. Use them for high-volume requests to sites without strict anti-bot defenses.
* **[Web Unlocker API](/scraping-automation/web-unlocker/introduction)** is a fully managed unblocking product that handles headers, cookies, CAPTCHAs and retries automatically, billed per successful request.

These are alternatives to Residential proxies. They are not a limited or trial Residential mode.

## Residential proxy network policy

Bright Data monitors Residential network traffic 24/7 to keep the network compliant with its [Acceptable Use Policy](https://brightdata.com/acceptable-use-policy). Because Residential IPs come from real people who opted in, access is scoped to the use case the compliance team approved during KYC.

* Requests to domains or categories outside your approved use case are blocked and return an `Access denied` error with the classified category.
* Restricted HTTP methods and targets that are not part of your approved use case are also blocked.
* To widen the sites and methods you can target, keep your KYC use case current with the compliance team.

## KYC verification

KYC (Know Your Customer) is the mandatory, human-reviewed verification step for Residential network access. The Bright Data compliance team validates your company and use case before granting access. Because a person reviews every submission, access is never granted instantly.

### How to request Residential access

1. Sign in to your Bright Data account and add a user with a **company email domain**. KYC applications are accepted only from registered businesses.

2. Add funds to your account balance. KYC is not available in [Playground](/general/faqs#what-is-playground-mode) or [Limited Trial](/general/faqs#what-is-limited-trial-mode) modes.

3. Submit the KYC form with details about your business and scraping use case, plus a company registration document.

   [Start KYC verification](https://brightdata.com/cp/kyc)

4. The Bright Data compliance team reviews your submission. You will receive a decision by email, and can track the status in your control panel under **Account Settings > Profile**.

<AccordionGroup>
  <Accordion title="Why do I need KYC for Residential proxies?">
    Residential IP addresses are linked to 100% real people who opted in to the Bright Data network. KYC (Know Your Customer) lets the Bright Data compliance team verify your business and use case before you route traffic through those real peers. This keeps the network compliant with the highest ethics and compliance standards and protects the people behind the IPs. Residential access is granted only after this human review, so there is no automatic or instant approval.
  </Accordion>

  <Accordion title="I signed up with a personal email. Can I use Residential?">
    No. Residential proxies are available only to verified companies. KYC applications are accepted only from registered businesses with a corporate email domain, so a personal-email account (for example Gmail, Outlook or iCloud) cannot be approved for Residential access. Add a user with your company email domain, then submit KYC. Without KYC you can still use [ISP proxies](/proxy-networks/isp/introduction), [Datacenter proxies](/proxy-networks/data-center/introduction) and the [Web Unlocker API](/scraping-automation/web-unlocker/introduction).
  </Accordion>

  <Accordion title="Can I switch my existing ISP or Datacenter zone to Residential?">
    Only after KYC approval. Converting or creating a Residential zone is blocked until the Bright Data compliance team approves your KYC submission. Your existing ISP and Datacenter zones keep working as usual while your KYC is under review.
  </Accordion>

  <Accordion title="What is the process for KYC verification?">
    Submit details about yourself and your scraping use case so the Bright Data compliance team can verify your eligibility. Start the KYC process below:

    [Start KYC verification](https://brightdata.com/cp/kyc)

    <Warning>
      The KYC process is not available in [Playground](/general/faqs#what-is-playground-mode) or [Limited Trial](/general/faqs#what-is-limited-trial-mode) modes. It can be started only after adding real funds to the account balance.
    </Warning>
  </Accordion>

  <Accordion title="How long does KYC approval take?">
    Filling in the form takes a few minutes. Approval is not automatic: the Bright Data compliance team reviews every submission. Once submitted, the review runs through the compliance process, and you can see the status in your control panel under **Account Settings > Profile**. You will be updated on your KYC status within 48 hours of completing the process.
  </Accordion>

  <Accordion title="How do I know that my KYC has been approved?">
    You can check the status of your KYC at any time in your control panel under **Settings > Profile**, shown as "Account verification status". A notification about the submission and the approval or decline of your request is also sent to your email once the review is complete.
  </Accordion>

  <Accordion title="Do I have to complete KYC to use the Residential network?">
    Yes. KYC approval is required for all Residential network access, and it is reviewed by the Bright Data compliance team. There is no automatic or no-KYC path to any Residential proxy. Without KYC, use [ISP proxies](/proxy-networks/isp/introduction), [Datacenter proxies](/proxy-networks/data-center/introduction) or the [Web Unlocker API](/scraping-automation/web-unlocker/introduction).
  </Accordion>

  <Accordion title="Is this a one-time process?">
    The KYC information is documented in Bright Data systems so the compliance team can review your use case again if needed. Bright Data monitors its network 24/7 and may reach out for additional clarification or information to keep the network safe.
  </Accordion>

  <Accordion title="Who is eligible for the KYC process?">
    Bright Data accepts KYC applications from registered businesses with a company domain. To submit a KYC request, verify a company email address on your account.
  </Accordion>

  <Accordion title="What information will I need to share?">
    The KYC process requires basic information about your business, such as a description of your use case and general contact information. The more detail you share about your business and use case, the easier it is for the Bright Data Compliance and Ethics team to evaluate and approve your request. Further clarification, validation or identification may be requested as a follow-up.
  </Accordion>

  <Accordion title="Why might I need to provide identification?">
    As part of verification, the Bright Data compliance team may request a valid government-issued ID, such as a driver's license or passport, to verify the identity of the point of contact. Because Bright Data IP addresses are linked to 100% real peers, verifying identities is an essential part of keeping the network secure and reliable.
  </Accordion>

  <Accordion title="Do I need to set up a video call?">
    The Bright Data compliance team may request a brief video call to verify additional information about your business or intended use case. This step ensures compliance with policy and ethical standards during the review.
  </Accordion>

  <Accordion title="What is a company registration form or certificate of incorporation?">
    A company registration form (also called a "Certificate of incorporation") is used by government offices as proof of registering a new business. It usually contains the company's official information, including the formal name, registered office address and company registration identifier. It is typically available to the company's legal counsel or finance department and can be shared as proof of registration.
  </Accordion>

  <Accordion title="Can I use Bright Data services while my KYC is being reviewed?">
    Yes. You can use all other Bright Data products and services, including [ISP proxies](/proxy-networks/isp/introduction), [Datacenter proxies](/proxy-networks/data-center/introduction) and the [Web Unlocker API](/scraping-automation/web-unlocker/introduction), while your KYC request is being processed.
  </Accordion>

  <Accordion title="Can I still use Datacenter and ISP if my Residential KYC was declined?">
    Yes. If your KYC was not approved, you can still use the other Bright Data products and services according to the Bright Data [license](https://brightdata.com/license).
  </Accordion>

  <Accordion title="What happens during the KYC video call?">
    On the call, the Bright Data compliance team learns more about your company and activities, confirms your use case and specific requirements, and may view relevant systems and workflow, so Bright Data can support your needs as accurately as possible.
  </Accordion>

  <Accordion title="What if I don't have a LinkedIn or website?">
    The verification process requires vetting a company website and an active online presence. If you have another form of online presence besides LinkedIn (such as a portfolio, GitHub or an alternative business profile), share it when submitting your application.
  </Accordion>

  <Accordion title="What if I don't want to do a video call?">
    If you were asked to do a video call, it is a mandatory step. It helps the Bright Data compliance team verify your identity and understand your use case. Without completing the call, Residential network access cannot be granted.
  </Accordion>

  <Accordion title="Can I use Bright Data for personal projects?">
    No. Bright Data is a B2B platform and supports business-related use cases only. Personal projects, such as scraping for a hobby or a side project, are not approved.
  </Accordion>

  <Accordion title="What kind of use cases are not allowed?">
    See the Bright Data [Acceptable Use Policy](https://brightdata.com/acceptable-use-policy).
  </Accordion>

  <Accordion title="I submitted my KYC but haven't heard back. What should I do?">
    Expect an update within 48 hours of submitting your KYC. If it has been longer, check the status in your control panel under **Account Settings > Profile**, or contact your account manager or the Bright Data support team.
  </Accordion>
</AccordionGroup>


# Create your first Residential proxy
Source: https://docs.brightdata.com/proxy-networks/residential/quickstart

Set up your first Bright Data Residential proxy: sign in, create a proxy in the Control Panel, verify your account and earn $5 credit for first-time setup.

<Callout icon="badge-dollar">
  **Verify your account and get \$5 credit**

  Add a payment method to verify your account and receive a \$5 credit. You won’t be charged at this stage.
</Callout>

<Warning>
  **Residential proxies require a KYC-verified business account.** Access is granted only after the Bright Data compliance team reviews and approves your KYC, so a new Residential zone stays disabled until then. Start at [KYC verification](https://brightdata.com/cp/kyc) and see the [Residential network access policy](/proxy-networks/residential/network-access). No KYC yet? Use [ISP proxies](/proxy-networks/isp/introduction) or [Datacenter proxies](/proxy-networks/data-center/introduction), which need no KYC.
</Warning>

<Steps>
  <Step title={<a href="https://brightdata.com/cp/start">Sign in to Bright Data</a>} />

  <Step title={<>Open the <a href="https://brightdata.com/cp/zones/new">Create Proxy</a> page</>}>
    Navigate to **Create Proxy** under the **Proxy** section in the left menu.

    <Frame>
      <img alt="Create Proxy" />
    </Frame>
  </Step>

  <Step title="Choose Residential Proxy">
    Select **Residential Proxy** and click **Continue**.

    <Frame>
      <img alt="Residential Proxy" />
    </Frame>
  </Step>

  <Step title="Assign a name to your proxy">
    Enter a meaningful name. Optionally, add a short description.

    <Warning>
      **The proxy name cannot be changed once created.**

      All other settings can be modified later. For details, see [Configure your Proxy](/proxy-networks/residential/configure-your-proxy).
    </Warning>

    <Frame>
      <img alt="Proxy Name" />
    </Frame>
  </Step>

  <Step title="Add payment method (free trial users only)">
    If you signed up with a personal email (e.g., Gmail, GitHub) and have not yet added a payment method, the primary button will read **Add payment method** instead of **Create Proxy**.

    Click the button to open the payment verification form and complete the process. You will **not** be charged, this is for identity verification only.

    <Info>
      Already have a payment method on file? This step is skipped automatically. For full details, see [Payment Verification](/general/account/billing-and-pricing/payment-verification).
    </Info>
  </Step>

  <Step title="Finalize proxy creation">
    Click **Create Proxy**. If you were redirected to add a payment method, your zone is created automatically once verification completes. Your proxy is now ready to use.
  </Step>
</Steps>


# Send your first Residential proxy request
Source: https://docs.brightdata.com/proxy-networks/residential/send-your-first-request

Send your first request through Bright Data Residential proxies with copy-paste code examples in cURL, Python, Node.js, Java, and Go.

<Accordion title="This guide works for all the proxy products" icon="check">
  1. Residential Proxy
  2. Mobile Proxy
  3. ISP Proxy
  4. Datacenter Proxy
  5. SERP API
  6. Browser API
  7. Web Unlocker API
</Accordion>

To get started, you need your proxy credentials, your `Username` and `Password` along with the `Host` name. You can find these credentials in the **Overview** tab of the proxy product.

## Code Examples

Once you have your proxy credentials, use the following code to send your first request:

<CodeGroup>
  ```sh cURL theme={null}
  curl "http://brdtest.com/myip.json" --proxy brd.superproxy.io:44445 --proxy-user brd-customer-<customer_id>-zone-<zone_name>:<zone_password>
  ```

  ```javascript Node.js theme={null}
  #!/usr/bin/env node

  const { ProxyAgent, setGlobalDispatcher } = require('undici');

  setGlobalDispatcher(new ProxyAgent('http://brd-customer-<customer_id>-zone-<zone_name>:<zone_password>@brd.superproxy.io:44445'));

  (async () => {
    const response = await fetch('http://brdtest.com/myip.json');
    console.log(await response.text());
  })();
  ```

  ```python Python theme={null}
  import pprint
  import requests


  host = 'brd.superproxy.io'
  port = 44445

  username = 'brd-customer-<customer_id>-zone-<zone_name>'
  password = '<zone_password>'

  proxy_url = f'http://{username}:{password}@{host}:{port}'

  proxies = {
      'http': proxy_url,
      'https': proxy_url
  }


  url = "http://brdtest.com/myip.json"
  response = requests.get(url, proxies=proxies)
  pprint.pprint(response.json())

  ```

  ```php PHP theme={null}

  <?php
  echo 'To enable your free eval account and get CUSTOMER, YOURZONE and '
      .'YOURPASS, please contact sales@brightdata.com';
  $curl = curl_init('http://brdtest.com/myip.json');
  curl_setopt($curl, CURLOPT_PROXY, 'http://brd.superproxy.io:44445');
  curl_setopt($curl, CURLOPT_PROXYUSERPWD, 'brd-customer-<customer_id>-zone-<zone_name>:<zone_password>');
  curl_exec($curl);
  ?>

  ```

  ```ruby Ruby theme={null}
  #!/usr/bin/ruby

  require 'uri'
  require 'net/http'
  require 'net/https'

  puts 'To enable your free eval account and get CUSTOMER, YOURZONE and YOURPASS, please contact sales@brightdata.com'

  uri = URI.parse('http://brdtest.com/myip.json')
  proxy = Net::HTTP::Proxy('brd.superproxy.io', 44445, 'brd-customer-<customer_id>-zone-<zone_name>', '<zone_password>')

  req = Net::HTTP::Get.new(uri)

  result = proxy.start(uri.host,uri.port, :use_ssl => uri.scheme == 'https') do |http|
      http.request(req)
  end

  puts result.body
  ```

  ```cs C# theme={null}
  using System;
  using System.Net;

  class Example {
    static void Main() {
      var client = new WebClient();
      client.Proxy = new WebProxy("brd.superproxy.io:44445");
      client.Proxy.Credentials = new NetworkCredential(
        "brd-customer-<customer_id>-zone-<zone_name>",
        "<zone_password>"
      );
      Console.WriteLine(client.DownloadString("http://brdtest.com/myip.json"));
    }
  }
  ```

  ```java Java theme={null}
  package example;

  import org.apache.http.HttpHost;
  import org.apache.http.client.fluent.*;

  public class Example {
      public static void main(String[] args) throws Exception {
          System.out.println("To enable your free eval account and get "
              +"CUSTOMER, YOURZONE and YOURPASS, please contact "
              +"sales@brightdata.com");
          HttpHost proxy = new HttpHost("brd.superproxy.io", 44445);
          String res = Executor.newInstance()
              .auth(proxy, "brd-customer-<customer_id>-zone-<zone_name>", "<zone_password>")
              .execute(Request.Get("http://brdtest.com/myip.json").viaProxy(proxy))
              .returnContent().asString();
          System.out.println(res);
      }
  }
  ```

  ```perl Perl theme={null}
  #!/usr/bin/perl

  print 'To enable your free eval account and get CUSTOMER, YOURZONE and '
      .'YOURPASS, please contact sales@brightdata.com';
  use LWP::UserAgent;
  my $agent = LWP::UserAgent->new();
  $agent->proxy(['http', 'https'], "http://brd-customer-<customer_id>-zone-<zone_name>:<zone_password>\@brd.superproxy.io:44445");
  print $agent->get('http://brdtest.com/myip.json')->content();
  ```

  ```vb VBA theme={null}
  Imports System.Net

  Module Module1
      Sub Main()
          Console.WriteLine("To enable your free eval account and get " & 
              "CUSTOMER, YOURZONE and YOURPASS, please contact " &
              "sales@brightdata.com")
          Dim Client As New WebClient
          Client.Proxy = New WebProxy("http://brd.superproxy.io:44445")
          Client.Proxy.Credentials = New NetworkCredential("brd-customer-<customer_id>-zone-<zone_name>", "<zone_password>")
          Console.WriteLine(Client.DownloadString("http://brdtest.com/myip.json"))
      End Sub
  End Module
  ```
</CodeGroup>

The code above uses the residential proxy to send a request to [http://brdtest.com/myip.json](http://brdtest.com/myip.json). It returns your IP information in a JSON format:

```json Output theme={null}
{
  "ip": "ALLOCATED_IP",
  "country": "PK",
  "asn": {
    "asnum": 203020,
    "org_name": "HostRoyale Technologies Pvt Ltd"
  },
  "geo": {
    "city": "Islamabad",
    "region": "IS",
    "region_name": "Islamabad",
    "postal_code": "44040",
    "latitude": 33.7233,
    "longitude": 73.0435,
    "tz": "Asia/Karachi",
    "lum_city": "islamabad",
    "lum_region": "is"
  }
}
```

Now, replace “[https://brdtest.com/myip.json”](https://brdtest.com/myip.json”) with the website of your choice and ...

**That's it!**


# SOCKS and SOCKS5 proxies
Source: https://docs.brightdata.com/proxy-networks/socks5

Use the SOCKS5 protocol with Bright Data Datacenter, ISP, Residential and Mobile proxy networks. Includes connection examples and authentication methods.

## Supported SOCKS Protocols

Bright Data supports SOCKS protocol version 5: `SOCKS5`.

## Using SOCKS5 for your scraping tasks

The most common protocols for internet data collection are `HTTP` and `HTTPS`, some of the tools or utilities require `SOCKS5` for their operations.

In Bright Data, we do not distinguish between `HTTP` , `HTTPS` and [`SOCKS5 proxies`](https://brightdata.com/solutions/socks5-proxies): all our proxies support all three protocols. You can switch between protocols while using the same proxy.

## Do you really need  SOCKS5?

Our `HTTP` and `HTTPS` proxy solutions are usually the best fit for scraping websites, offering lowest cost and highest performance. However, if the the task still requires `SOCKS5` Bright Data can provide quality proxies around the globe.

## Supported Proxy types & HTTP protocols

`SOCKS5` proxy connections are supported on all Bright Data proxy networks: Datacenter, ISP, Residential and Mobile.

Bright data support HTTP/S version 2.0 only via SOCKS.

We do not support tunneling HTTP/2 versiob 3.0 via SOCKS.

<Info>
  Using `SOCKS5` over Bright Data **Residential proxy**  is supported only towards `HTTPS` targets, `HTTP` targets will be supported soon.
</Info>

## SOCKS5 Main proxy port configuration

<Note>
  **`Bright Data  uses port 22228 for SOCKS5`**
</Note>

When using `SOCKS5` make sure to use `brd.superproxy.io:22228` and not the standard port <Tooltip>[`44445`](/general/faqs#which-port-shall-i-use-22225-or-33335)</Tooltip> for `HTTP` and `HTTPS` protocols.

## SOCKS5 targeting with Bright Data

<Warning>
  **Bright Data supports only hostnames (domain names) for SOCKS5 proxies**
</Warning>

Per our compliance regulation, we allow `SOCKS5` requests **only** with hostnames/domain names relayed as target. Requests sent with explicit IPs or local IP resolution, are **blocked**.

Hence, configure your code, client or calling application to:

1. Use domain name as target
2. Resolve DNS remotely and not locally

Adhering to those rules will ensure the request to get to the target domain IP, thru our proxy peer.

### Which target ports to use

#### Datacenter & ISP

Bright Data supports all ports higher than `1024` for datacenter and ISP proxies.

#### Residential & Mobile

Bright Data supports ports: `8080`, `8443`, `5678`, `1962`, `2000`, `4443`, `4433`, `4430`, `4444` and `1969` for Residential & Mobile proxies.

## Using SOCKS5 with `curl`, `Javascript` & `Python`

<Tabs>
  <Tab title="curl">
    <Warning>
      **`Use socks5h://brd.superproxy.io:22228 when issuing curl requests`**
    </Warning>

    To use `curl` with Bright Data SOCKS5 proxies, you have to explicitly:

    1. Add `-x` to your command line parameters
    2. Use SOCKS5h protocol for remote DNS lookup
    3. Use proxy address as `brd.superproxy.io:22228`
    4. Provide Bright Data proxy zone credentials
    5. **Residential and Mobile proxies**: Add curl `-k` option to ignore SSL errors proxies or [Setup SSL Certificate](/general/account/ssl-certificate#using-the-ssl-certificate-in-your-code)

    Requests which do not comply with all the above are blocked.

    Examples `curl` command:

    ```bash theme={null}
    curl -i -k -x socks5h://brd.superproxy.io:22228 --proxy-user [USERNAME]:[PASSWORD] "https://geo.brdtest.com/welcome.txt"
    ```
  </Tab>

  <Tab title="Javascript">
    Example code for `SOCKS5` request:

    ```javascript theme={null}
    // install https://www.npmjs.com/package/socks-proxy-agent
    const https = require('https');
    const { SocksProxyAgent } = require('socks-proxy-agent');
    const user_pass = 'brd-customer-[ACCOUNT ID]-zone-[ZONE NAME]:[ZONE PASSWORD]';
    const socks_proxy_url = `socks5h://${user_pass}@brd.superproxy.io:22228`;
    const agent = new SocksProxyAgent(socks_proxy_url);
    https.get('https://geo.brdtest.com/welcome.txt', {agent},
      res=>res.pipe(process.stdout));
    ```
  </Tab>

  <Tab title="Python">
    Example code for `SOCKS5` request:

    ```python theme={null}
    # https://docs.python-requests.org/en/latest/user/advanced/#socks
    import requests
    user_pass = 'brd-customer-[ACCOUNT ID]-zone-[ZONE NAME]:[ZONE PASSWORD]'
    socks_proxy_url = f'socks5h://{user_pass}@brd.superproxy.io:22228'
    resp = requests.get('https://geo.brdtest.com/welcome.txt',
      proxies=dict(http=socks_proxy_url, https=socks_proxy_url))

    print(resp.text)
    ```
  </Tab>
</Tabs>

### Troubleshooting with `curl`

We recommend using `curl` to troubleshoot your `SOCKS5` requests, and adding `curl` options `-i` or `-v` for printing header fields. Look for `x-brd-error`, `x-brd-err-code` and `x-brd-err-msg` for elaborated error messages sent by Bright Data proxy networks.
To see our full error catalog (for `HTTP` and `HTTPS` as well) visit this page: [Proxy errors troubleshooting](/proxy-networks/errorCatalog)

## SOCKS5 Authentication configuration

<Note>
  **Bright Data must receive proxy zone credentials to access SOCKS5 proxy**
</Note>

The authentication is done also similarly to `HTTP` and `HTTPS` by relaying the user and password for the proxy access.

Some tools or utilities will give you place to input the credentials and port separately as parameters, as seen in the control panel, and some will require you to provide a url with the credentials delimited single parameter: `userName:password@brd.superproxy.io:22228`.

## SOCKS5 Geo-location & country selection

Location setting is identical to [HTTP/HTTPS proxies geo-targeting](/proxy-networks/config-options) and is set by adding `-country-[country code]` to your SOCKS5 username.

Example for `curl` command to get a SOCKS5 proxy in Italy (country code: `it`):

```bash theme={null}
curl -i -k -x socks5h://brd.superproxy.io:22228 --proxy-user [proxy zone user]-country-it:[zone password] "https://geo.brdtest.com/welcome.txt" -v
```

## Difference between SOCKS5 and SOCKS5h

The difference between **SOCKS5** and **SOCKS5h** lies in how they handle DNS (Domain Name System) resolution:

1. **SOCKS5**: In the standard SOCKS5 proxy, the **client** resolves the DNS. This means that the domain name (e.g., `example.com`) is resolved into an IP address **before** it is passed through the proxy. The proxy then routes traffic to the resolved IP address.
2. **SOCKS5h**: The "h" stands for "hostname." In this case, the **proxy** server resolves the DNS. The client sends the domain name (not the IP address) to the proxy server, which resolves it and forwards the request. This is useful if you want to hide the destination domain names from the client's network.

To summarize:

* **SOCKS5**: DNS resolution happens on the**client-side**.
* **SOCKS5h**: DNS resolution happens on the **proxy-side**.

Bright Data supports **proxy side** SOCKS5h only.


# Overcoming website blocking
Source: https://docs.brightdata.com/proxy-networks/website-blocking

Troubleshoot 4xx and 5xx blocking on Bright Data proxies: read network errors, identify block types and apply rotation, headers and Unlocker fixes.

The first step for troubleshooting your error is checking the entire network error response - It could contain critical information regarding the origin of the error and possibly instructions for resolving it.

To analyze the entire response you can run a `curl` command from your shell prompt and add the option flag `-v` or `-i`. These flags will run curl in verbose mode and print out the header fields

```bash theme={null}
curl -v [rest of curl command options]
```

## How to avoid blocks

### How to choose IPs

The main things to consider for IPs are:

* Geolocation: it's generally best to match the peer country to the country of the target.
  Using more specific targeting can also help:
  City is more specific than State, and State more specific than country

* Pool type: using Shared IPs can be a cost saving measure if the target isn't sensitive to multiple requests from the same IP. If the target is sensitive to that, using Dedicated IPs can help.

* Quality: Bright Data offers 4 'normal' proxy networks, in addition to our Automated Scraping Solutions.
  These are listed below in order of increasing difficulty to detect:
  Data Center - ISP - Residential - Mobile
  If one of these networks is consistently blocked, trying the next one down in the list may help get past the blocking.

* Consistency: for single-URL scrapes, you should generally be rotating the IP frequently to avoid rate limits. If you're trying to emulate a real user, the tips in the section below can help keep the IP consistent.

### How to manage sessions

* If you're trying to mimic a real user, you should use the session ID username parameter:
  [Proxy and IP Rotation control](/api-reference/proxy/rotate_ips#using-the-same-proxy-for-multiple-requests-session)
  This tells us that for a request with the same ID, you want to keep the same IP for the request.
  Doing this allows you to appear more like a normal user when using rotating networks like Residential and Mobile.

* If your use-case is single scrapes, you might still want to use this parameter, but in a different way:
  When the ID changes, that tells us that you want to use a different IP than the last one.
  Iterating over multiple IDs within 60 seconds will allow you to rotate through your allocated IPs.

### Request Method / Fingerprint

* Request Method: "Normal users" will typically use a browser to access websites. You can integrate the proxies into a regular browser, either directly or via our extension (available [here](https://chrome.google.com/webstore/detail/bright-data/efohiadmkaogdhibjbmeppjpebenaool?hl=en)).
  If you're using a different integration, like browser automation, or direct API requests, it's important to keep this in mind and make your requests look as much like a real browser as possible to avoid detection.

* Fingerprint: Part of looking like a real user is the headers and cookies you send with the request, but another part is having the same attributes that a real browser would have. You can find many resources online about this, and we also offer the Web Unlocker API and Browser API, which manage all of this on your behalf.

## When to use an automated solution

Should you find that none of our proxy solutions (Datacenter, ISP, Residential, Mobile proxies) are effective for your needs, We recommend trying our [Automated Scraping Solutions](/scraping-automation/introduction), particularly the Web Unlocker API, which autonomously manage all of the above mentioned measures and more to ensure high success rates.


# Release notes
Source: https://docs.brightdata.com/release-notes

Stay up to date with Bright Data product updates from 2024-2026. Scroll down to explore release notes from previous weeks across all proxy and API products.

<Note>
  Questions? Click here to [contact us >>>](https://brightdata.com/?hs_signup=160692)
</Note>

<Update label="June 14, 2026">
  ### <Badge> ⚠️ Known Issue </Badge>

  #### Grok Scraper temporarily unavailable

  The [Grok Scraper](https://brightdata.com/cp/scrapers/browse?domain=grok.com) is unavailable again as of June 14, 2026, due to a renewed blocking issue on Grok's side. Bright Data is actively monitoring the situation and will restore the Grok Scraper as soon as it becomes accessible again.
</Update>

<Update label="June 11, 2026">
  ### <Badge> ✨ New Features </Badge>

  #### Grok Scraper available again

  The [Grok Scraper](https://brightdata.com/cp/scrapers/browse?domain=grok.com) is available again as of June 11, 2026, after the earlier blocking issue on Grok's side was resolved.

  #### Google 100 Scraper is back online

  The [Get Top 100 Google Results](/scraping-automation/serp-api/get-top-100-google-results) feature, which returns Google SERP positions 1-100 in one request, is back online as of June 11, 2026.
</Update>

<Update label="June, 2026">
  ### <Badge> ✨ New Features </Badge>

  #### Free tier: 5,000 free credits every month

  Every new Bright Data account now gets **5,000 free credits per month**, a single shared pool usable across the Web Unlocker API, SERP API, Web Scraper API and Scraper Studio. No credit card required. Credits renew on the first of each month, and the Bright Data MCP server free tier draws from this same pool. [Learn more](/general/account/billing-and-pricing/free-tier).

  ### <Badge> ⚠️ Known Issue </Badge>

  #### Top 100 Google Results temporarily unavailable

  The [Get Top 100 Google Results](/scraping-automation/serp-api/get-top-100-google-results) feature, which returns Google SERP positions 1-100 in one request, is currently unavailable due to blocking issues on Google's side. Bright Data is actively monitoring the situation and will restore the feature as soon as it becomes accessible again.
</Update>

<Update label="May, 2026">
  ### <Badge> ⚠️ Known Issue </Badge>

  #### Grok Scraper temporarily unavailable

  The Grok Scraper is currently unavailable due to a blocking issue on Grok's side. Bright Data is actively monitoring the situation and will restore the Grok Scraper as soon as it becomes accessible again.

  ### <Badge> 📘 Docs </Badge>

  #### Clarified exclusive `to` semantics for `GET /zone/cost`

  * The `to` query parameter is **exclusive**. The day specified is not included in the result. To match a calendar month shown in the Control Panel or on your invoice, set `to` to the first day of the **following** month. [See the updated docs](/api-reference/account-management-api/Get_the_total_cost_and_bandwidth_stats_for_a_Zone).

  ### <Badge> 🚀 Improvements </Badge>

  #### LLM Scrapers

  * **Updated supported countries for LLM Scrapers**: We have revised the list of supported countries across all LLM scrapers (ChatGPT and other answer engines). [View the full list](https://github.com/brightdata/answer-engines-country-codes/blob/main/chatgpt_countries.csv).
</Update>

<Update label="April, 2026">
  ### <Badge> ✨ New Features </Badge>

  #### Web Scraper API: Success Rate (SR) Email Alerts

  Web Scraper API: Success Rate (SR) email alerts are now available in the Control Panel. [Learn More](/datasets/scrapers/scrapers-library/success-rate)
</Update>

<Update label="March, 2026">
  ### <Badge> ✨ New Features </Badge>

  #### New field for Scraper: ChatGPT

  R\&D added a new field to the output schema: `prompt_sent_at`.

  This field allows customers to know the exact time the scraper clicks "Send" to submit the prompt. Until now, we only provided a timestamp for when the Bright Data Web Scraper API received the request, not when the prompt was actually executed.

  ***

  #### WSAPI Google SERP - 100 Results

  * **New `collapse_aio` parameter**: Set `collapse_aio=true` to return the SERP with the AI Overview (AIO) section collapsed. This enables more stable and comparable layout and pixel-position measurements by preventing AIO from pushing organic results down the page. Default is `false` (AIO expanded). [Learn more](/scraping-automation/serp-api/get-top-100-google-results)

  ***

  #### Browser API - Session ID & Session Logs

  * **New `Browser.getSessionId` CDP command**: Retrieve the unique session ID of your current Scraping Browser session. Useful for investigating errors, unexpected behavior, or high bandwidth usage via the Session Logs API. [Learn more](/scraping-automation/scraping-browser/cdp-functions/custom#getting-session-id)
  * **New Session Logs API endpoints**:
    * `GET /browser_sessions`, List and filter browser sessions by status, date range, target URL, bandwidth, and more. [Learn more](/api-reference/browser-api/get-sessions)
    * `GET /browser_sessions/{session_id}`, Retrieve details for a specific browser session. [Learn more](/api-reference/browser-api/get-session)
</Update>

<Update label="January, 2026">
  ### Release Notes for Week Ending January 6, 2026

  ##

  ### <Badge> ✨ New Features </Badge>

  #### Model Context Protocol (MCP)

  * **Custom MCP Configuration**: Fine-tune your AI agents by selecting only the necessary tools from 60+ specialized options (E-commerce, Social Media, Travel, etc.) to optimize performance and reduce token usage. Includes built-in unlocking and CAPTCHA solving. [Try now](https://brightdata.com/cp/mcp/configure)
  * **One-click MCP Connection**: Instantly connect to the MCP Free Tier with zero configuration. Link to Claude, Cursor, or Visual Studio Code with a single click. [Try now](https://brightdata.com/cp/mcp)

  ***

  ### <Badge> ✨ New Features </Badge>

  #### Web Unlocker

  * **Unlock Fragmented URLs in a Single Call**: Directly unlock URLs containing fragments (the # character) via the Web Unlocker API, eliminating the need for workarounds.
    * **REST API**: Simply provide the fragmented URL(e.g. `https://www.somesite.com/#!/path1/id11133/9*Fmt=100`). Response time may be slightly longer due to increased processing.
    * **Native API**: Use the new `x-unblock-url-fragment` header to pass the fragment portion. [Learn more](/scraping-automation/web-unlocker/features#unlock-fragmanted-url-in-a-single-call)

  ***

  ### <Badge> ✨ New Features </Badge>

  #### SERP API

  * **Google Trends Support**: Extract trending data using new dedicated parameters (e.g., `brd_trends=timeseries,geo_map`) to retrieve widget-specific data like time-series and geographic visualizations. Supports "Trending now" with options for geo-targeting, time ranges, categories, and search types.
  * **Google Reviews Scraping**: Collect Google Reviews data with full control over targeting, localization, sorting, filtering, and pagination.
  * **Google Lens Integration**: Search by image using Google Lens. Supports image URLs, file uploads, localization, and exact match filtering.
  * **Google Hotels Data Extraction**: Access hotel search results with support for localization, booking dates, room options, and multiple output formats.
  * **Google Flights Data Extraction**: Retrieve flight search data with full localization support and comprehensive flight details. [Learn more](/scraping-automation/serp-api/query-parameters/google)

  ***

  ### <Badge> ✨ New Features </Badge>

  #### Residential Proxies

  * **Request Peers with Guaranteed Minimum Session Lifetime**: Use the new `min_ttl` parameter (1-60 minutes) to request residential peers estimated to remain online for a specified duration, ideal for extended sessions where IP changes are disruptive.

  ***

  ### <Badge> 🚀 Improvements </Badge>

  #### Proxy Infrastructure

  * **Expanded ISP Proxy Capacity**: Added approximately 200,000 new ISP IPs for increased pool diversity and reduced rotation pressure during high-volume operations.
  * **Smarter Datacenter Load Balancing**: Improved the bandwidth metrics algorithm for datacenter proxy load distribution, resulting in better traffic allocation.
  * **New Error Code for Destination Timeouts**: Added a dedicated `brd_error` code for "Destination host connect timeout" errors for clearer distinction between proxy and target site connectivity issues.
  * **Faster System Alert Delivery**: Optimized email notification system for network status alerts, ensuring prompt delivery upon service disruptions or restorations.
  * **Enhanced Tunnel Agent Logging**: Added `p_dc` and `p_agent` fields to proxy logs for better visibility into the datacenter and agent handling each request, improving debugging and performance analysis.

  ***

  ### <Badge> 🐞 Bug Fixes </Badge>

  #### Proxy Infrastructure

  * **Fixed IP Range Preset Management in Dashboard**: Resolved issues where removing IP range presets didn't update the UI, loading states weren't displayed, and some presets weren't visible in the table view.
  * **Fixed Data Inconsistency During Error Resolution**: Resolved a race condition that caused data inconsistency when resolving alert errors, making monitor status updates atomic and reliable.
  * **Improved Proxy Agent Error Logging**: Fixed an issue where probe timeout errors logged `[object Object]` instead of diagnostic information. Error logs now include the connection ID and relevant details.
  * **Fixed Tunnel Action Documentation Tooltips**: Added explanatory tooltips to tunnel server actions in the internal documentation, including guidance on checking affected customers when removing IP ranges.

  ### <Badge> ⚠️ Deprecations </Badge>

  #### SERP API

  * **Google Maps Pagination Parameters Deprecated**: The `start` and `num` pagination parameters for Google Maps were deprecated on December 15th, 2025.
    * **Recommended alternative**: Use the Scrapers's Google Maps Scraper for full coverage of all search results.
    * **Access Scraper (requires login):** `https://brightdata.com/products/web-scraper/google-maps`. [Learn more](/scraping-automation/serp-api/query-parameters/google#pagination-deprecated)
</Update>

<Update label="December, 2025">
  ### Release notes for week ending December 19, 2025

  ##

  ### <Badge> ✨ New Features </Badge>

  ### Deep Lookup

  * **Enrich your own entity lists directly in Deep Lookup**: You can now bring your own list of entities and enrich them directly within Deep Lookup. Whether you're discovering new entities or enriching ones you already have, Deep Lookup is now your complete enrichment platform, all in one place.

  ***

  ### <Badge> ✨ New Features </Badge>

  ### Web Unlocker

  * **Unlock fragmented URLs in a single call**: You can now unlock URLs containing fragments (the # character) directly through the Web Unlocker API, no workarounds needed. [Learn more](/scraping-automation/web-unlocker/features#unlock-fragmanted-url-in-a-single-call)
    * **REST API**: Simply provide the fragmented URL and Bright Data Unlocker handles the rest. Response time may be slightly longer due to increased processing.
    * **Native API**: Use the new x-unblock-url-fragment header to pass the fragment portion of your URL.

  ***

  ### <Badge> ✨ New Features </Badge>

  ### Residential Proxies

  * **Request peers with guaranteed minimum session lifetime**: You can now request residential peers that are estimated to remain online for a specified duration. Use the new `min_ttl` parameter (1-60 minutes) to get peers that will stay connected longer, ideal for extended browser sessions and multi-step scraping jobs where mid-session IP changes would disrupt your workflow.

  ***

  ### <Badge> ✨ New Features </Badge>

  ### SERP API

  * **Configure default data format in zone settings**: You can now set your preferred default data format (JSON, HTML, etc.) directly in your SERP API zone configuration. This eliminates the need to specify the format header on every request, just set it once and all requests will use your preferred format automatically.

  ***

  ### <Badge> 🚀 Improvements </Badge>

  ### Datasets

  * **Up to 85% faster checkout**: Dataset purchases that previously took 15-30 seconds now complete in just 2-5 seconds. Enjoy a much snappier buying experience with dramatically reduced checkout latency.
  * **Expanded e-commerce data coverage**: We've significantly grown the Bright Data product catalog across key e-commerce datasets:
    * **Wayfair**: 6M → 15M products (+150%)
    * **Amazon Global**: 35M → 85M products (+143%)
    * **Google Shopping**: 84M → 113M products (+35%)
    * **Amazon Products US**: 310M → 374M products (+20.6%)
  * **Higher data quality with improved validation**: A new validation flow for full datasets ensures higher data quality before delivery. This enhancement is currently rolling out across our data pipelines.

  ***

  ### <Badge> 🚀 Improvements </Badge>

  ### Proxy Infrastructure

  * **Expanded ISP proxy capacity in US regions**: Added over 300,000 new ISP IPs across key US locations including Dallas, Los Angeles, and Ashburn, giving you more IP diversity and reduced rotation pressure for high-volume operations.
  * **Faster detailed statistics loading**: Optimized the bank statistics service to eliminate timeout issues when loading detailed stats reports. You'll experience more reliable access to your proxy usage analytics.
  * **Reduced latency during proxy bank updates**: Optimized the DC proxy bank processing to eliminate lag spikes during index updates. Your requests now maintain consistent low latency even during background data refreshes.

  ***

  ### <Badge> 🚀 Improvements </Badge>

  ### Control Panel

  * **Unified proxy list download experience**: We've streamlined how you download proxy lists across the Control Panel. All download locations now offer the same consistent experience with multiple format options:
    * **Colon-separated**: `host:port:usr:pwd or usr:pwd@host:port`
    * **CSV**: `host`,`port`,`usr`,`pwd` (with optional location data)
    * **IP list**: single column with IPs
  * Downloads now include timestamps in filenames to prevent overwrites, and you'll see a preview before downloading. A security warning reminds you to keep your proxy credentials safe.

  ***

  ### <Badge> 🐞 Bug Fixes </Badge>

  ### Datasets

  * **Fixed missing enriched fields in exports**: Resolved an issue where enriched fields were missing when downloading datasets in CSV or JSON format. All enriched data now exports correctly, ensuring your downloads contain the complete dataset you expect.

  ***

  ### <Badge> 🐞 Bug Fixes </Badge>

  ### Proxy Infrastructure

  * **Fixed session drops for persistent connections**: Resolved an issue where sessions with const=true were incorrectly dropped mid-job when peers temporarily disconnected. Your persistent sessions now maintain IP consistency as expected throughout browser jobs and extended scraping tasks.
  * **Fixed IP range preset management in dashboard**: Resolved issues where removing IP range presets didn't update the UI correctly and some presets weren't displaying in table view. The static IP management interface now reflects changes immediately.
  * **Fixed data inconsistency during error resolution**: Resolved a race condition that could cause data inconsistency when resolving alert errors. Monitor status updates are now atomic, ensuring reliable alert state management.
  * **Improved proxy agent error logging**: Fixed an issue where probe timeout errors logged `[object Object]` instead of useful debugging information. Error logs now include the connection ID and relevant diagnostic details for faster troubleshooting.

  ## Release notes for week ending December 02, 2025

  ### 🚀 **Improvements**

  #### Browser API

  **Expanded C# support for CAPTCHA solving**: We have added dedicated examples for C# developers using PuppeteerSharp and Playwright. You can now copy-paste ready-made code to handle CAPTCHA challenges directly from the documentation.

  #### Proxy Network

  **Unified proxy list export**: Export your proxy lists with a consistent experience. You can now easily choose your preferred format (CSV, TXT, or IP-only) and customize delimiter styles for faster integration. Just go to "My Proxies" -> choose a proxy -> In the "Overview" tab, click "Download" -> Choose format -> Click "Download". Or,  in the "Overview" tab, click "View" -> Click "Download" -> Choose format -> Click "Download".

  **Identify abrupt disconnects**: Added new error code [client\_10140](/proxy-networks/errorCatalog#client-10140) to signal "brute client disconnects". You can now distinguish when a connection was forcibly terminated by the client side rather than a network error, aiding in faster debugging.

  ### 🐞 Bug Fixes

  #### Web Unlocker

  **Accurate header usage logging**: Corrected a reporting issue in system logs; the custom\_expect field now accurately reflects when your custom headers or cookies are actively utilized by the Web Unlocker logic.

  #### Proxy Network

  **Clarified SOCKS5 port errors**: Fixed an issue where attempting to use a disallowed port via SOCKS5 returned an incorrect error message. You will now receive accurate feedback to debug connection strings faster.

  **Corrected IP assignment alerts**: Resolved a bug where failed dedicated residential proxy assignments triggered the wrong email notification. You will now receive the correct alerts if an allocation fails, ensuring you can react immediately.
</Update>

<Update label="November, 2025">
  ## Release notes for week ending Nov 14, 2025

  ### 🚀 **Improvements**

  **Clearer guidance when approaching usage limits**: Improved alert emails now provide straightforward explanations of your usage status and next steps to help you manage your unlimited proxy plans effectively.

  **Distribute unlimited proxy traffic freely across zones**: Use your [fair use allowance](/general/usage-monitoring/fair_use_allowance) across all zones of the same type instead of per individual zone, reducing the risk of unexpected overages while one zone sits idle.

  **Easier debugging with industry-standard error reporting**: Proxy error information now follows [RFC 9209](https://www.rfc-editor.org/rfc/rfc9209.html) standards, making it simpler to integrate monitoring tools and troubleshoot issues. Legacy error headers will be deprecated in 2026 [**<u>review the migration guide</u>**](https://gpt.brightdata.com/link) if you rely on custom error handling.
</Update>

<Update label="October, 2025">
  ## Release notes for week ending Oct 31, 2025

  ### 🆕 New features

  #### Scrapers

  **New social media scrapers**: You can now collect data from [**Facebook profiles**](https://brightdata.com/cp/scrapers/api/gd_mf0urb782734ik94dz/pdp/overview?id=all), [**Reddit profiles**](https://brightdata.com/cp/scrapers/api/gd_mgnh0p8w16o65lmhp/pdp/overview?id=all), and [**Reddit posts**](https://brightdata.com/cp/scrapers/api/gd_lvz8ah06191smkebj4/pdp/overview?id=all) within a specific community (subreddit).

  **New YouTube scrapers**: We've added new scrapers for YouTube, allowing you to collect data from [YouTube Podcasts ](https://brightdata.com/cp/scrapers/api/gd_lk56epmy2i5g7lzu0k/podcast_url/overview?id=all) and the [**YouTube Explore page,**](https://brightdata.com/cp/scrapers/api/gd_lk56epmy2i5g7lzu0k/explore/overview?nav_from=\&id=all) focusing on news content.

  **Goodreads reviews scraper**: A new scraper is available to collect [**book reviews**](https://brightdata.com/cp/scrapers/api/gd_mgryny1rtzjskcjxz/pdp/overview?nav_from\&id=all) from [**Goodreads**](https://www.goodreads.com/).

  #### Proxy

  **IP Country Verification Endpoint**: You can now use a dedicated endpoint to check the country that Google associates with a specific IP address, helping you verify geolocation for your requests.

  #### Browser Automation

  **Automation scripts that don't break when sites update**: Your browser automation continues working even when websites redesign their pages or change their structure. Spend less time fixing broken scripts and more time using your data.

  **MCP**

  **Keep your automation data separate and clean**: When running multiple MCP browser sessions at once, each operates in complete isolation, no data mixing, no session conflicts, just reliable parallel operations.

  ### 🚀 Improvements

  #### Scrapers

  **Google num=100 is gone, but your top‑100 isn’t: 1 request, 10x fewer calls**: Get the top 100 Google results with the [Scrapers (SERP100)](https://brightdata.com/cp/scrapers/api/gd_mfz5x93lmsjjjylob/pdp/overview?id=all), no pagination, set language/country and depth, and get the original SERP HTML for audit. Cut request volume by up to 10x. [Learn more](/scraping-automation/serp-api/get-top-100-google-results)

  **Faster, more reliable E-commerce data collection**: Experience faster data retrieval from Amazon, Etsy, and eBay with fewer errors and timeouts. Your scraping jobs complete more quickly with more complete and accurate results.

  **Quicker Captcha resolution**: Your requests spend less time waiting when captchas appear. Reduced delays mean faster data collection and more efficient scraping operations.

  ## Release notes for week ending Oct 10, 2025

  ### 🆕 New features

  **Test Web MCP without any setup**: Explore what's possible with our[ Web MCP](https://brightdata.com/ai/mcp-server) directly in your browser. No installation or configuration required. Run live scraping tests, experiment with different targets, and see results instantly before integrating into your workflow.  [Try now](https://brightdata.com/ai/playground-chat)

  **Start building in minutes, not hours**: Integrate Bright Data directly into your Python or NodeJS applications with native [Python SDK](/api-reference/SDK) and [JavScript SDK](/api-reference/SDK-JS) designed for your workflow. Get autocomplete, type hints, built-in error handling, and comprehensive examples in the language you already use.

  ### 🚀 Improvements

  **Find the exact data you need faster**: Filtering large datasets is now quicker and more intuitive. Select multiple criteria at once, pick date ranges more easily, and get to your refined dataset in fewer clicks.

  ### 🐞 Bug Fixes

  **Smoother filtering experience**: Fixed issues that interrupted your workflow when refining dataset filters, including problems with clearing selections and unexpected page scrolling.
</Update>

<Update label="September, 2025">
  ## Release notes for week ending Sep 30, 2025

  ### 🆕 New features

  #### Datasets

  **Quick Filtering for datasets**: Start filtering immediately with commonly-used options always at your fingertips. Type to get instant autocomplete suggestions, or describe what you need in plain language and let AI build the filter for you.

  **Automate Web Archive delivery to Azure**: Send [Web Archive](/datasets/archive/faqs#what-is-archive-api) data directly to your Azure storage, eliminating manual downloads and uploads. Your data flows straight into your existing cloud infrastructure where your team already works.

  ### 🚀 Improvements

  #### Datasets

  **Understand Dataset fields instantly**: No more guessing what cryptic field names mean. Dataset filters, previews, and documentation now use plain-language labels that clearly describe what each field contains, so you spend less time deciphering and more time analyzing.

  **No more guessing about "Empty" updates**: When your scheduled dataset refresh finds no new or changed data, you'll now see a clear "No changes detected" status and receive an email explaining what happened with an option to trigger a full refresh if you prefer.

  #### Scrapers

  **Capture all Amazon reviews, not just text-based ones**: Get a fuller picture of product sentiment by collecting reviews that appear in image galleries. Your Amazon review data now includes feedback that was previously hidden in carousel sections.

  **Track scraper jobs without switching tools**: When running [synchronous requests](/api-reference/scrapers/synchronous-requests), you now get a clickable link in your command-line response that takes you directly to the job monitoring page no need to manually navigate or search for your job.

  ### 🐞 Bug Fixes

  #### Scrapers

  **Collect all Glassdoor reviews without gaps**: Fixed an issue where some reviews would be skipped during collection. Your [Glassdoor scraping jobs](https://brightdata.com/cp/scrapers/browse?domain=glassdoor.com\&id=all) now retrieve complete review sets more consistently.

  **Fixed empty results for products with reviews**: Resolved an issue where the Amazon scraper would return no data even when products clearly had customer reviews. Your Amazon review collections are now more reliable.

  #### Web Archive

  **Search large Web Archive datasets without timeouts**: The [Web Archive](/datasets/archive/overview#run-a-search) `/webarchive/search` endpoint now returns a `search_id` immediately. So, you can now query large datasets and track search progress in real-time without interruption.

  ***

  ## Release notes for week ending Sep 28, 2025

  ### 🆕 New features

  **Get Web MCP running with your AI tools in minutes**: Find everything you need to integrate Model Context Protocol in one place, step-by-step setup guides for Claude, ChatGPT, Cursor, LangChain, and more, plus ready-to-use examples from the community. [Learn more](https://brightdata.com/cp/mcp)

  ***

  ## Release notes for week ending Sep 19, 2025

  ### 🚀 Improvements

  **Complete account verification (KYC) faster**: Account verification is now more straightforward with clearer instructions and a simpler step-by-step process. Get verified and access your account more quickly. [Learn more](/proxy-networks/residential/network-access)

  **Higher success rates for Google scraping**: Collect data from Google with fewer interruptions. Improved unblocking techniques result in more consistent, reliable scraping performance.

  ### 🐞 Bug Fixes

  **Better Safari browser emulation**: Fixed an issue that could cause requests using Safari browser profiles to be detected or blocked. Safari-based scraping now works more reliably.

  ***

  ## Release notes for week ending Sep 12, 2025

  ### 🚀 Improvements

  **More predictable unlimited plan usage**: Fair use limits for unlimited Datacenter and ISP plans now apply across all your zones combined, giving you more flexibility in how you distribute traffic and reducing the risk of unexpected overage charges.

  **Find what you need faster in the Control Panel**: Redesigned navigation makes it quicker to access your zones, datasets, scrapers, and settings. Rolling out to all new users now, with existing users gaining access in December.
</Update>

<Update label="August, 2025">
  ## Release notes for week ending Aug 31, 2025

  ### 🆕 New features

  #### Datasets

  **Filter thousands of records at once**: Upload a CSV or JSON file to filter datasets by large lists of values, no need to manually enter hundreds of product IDs, URLs, or other criteria. Perfect for bulk operations and matching datasets to your existing data.

  **See enriched data instantly, filter before you buy**: Datasets with additional enrichment (like LinkedIn profiles with company information) now load and preview immediately. Filter by enriched fields to validate the data meets your needs before purchasing.

  #### Scrapers

  **Monitor e-commerce pricing on three major platforms**: Collect current prices and stock availability from Coupang, Amazon, and Walmart to track competitors, validate pricing strategies, or analyze market trends.

  **Scrape complete hotel data from Google**: Collect everything from basic details (name, location, star rating) to booking information (prices, availability, trends), guest insights (reviews, ratings), and amenities, all from [Google's hotel listings](https://brightdata.com/cp/scrapers/api/gd_mg3gjfmg12tc2n5d4d/pdp/overview?nav_from\&id=all).

  ### 🚀 Improvements

  #### Datasets

  **Delivery progress indicator**: Track your data deliveries in real time, see exactly how far along your dataset deliveries are with live progress updates in the Control Panel. No more guessing when your data will be ready.

  **Quicker SFTP transfers**: Your datasets now transfer to SFTP destinations faster, reducing wait times for large data deliveries.

  **Less alert noise, clearer information**: When delivery issues occur, you'll now see one consolidated notification with all the details instead of multiple separate alerts cluttering your Dashboard.

  **Smarter delivery rate limiting**: A new rate limiter for data deliveries has been implemented to improve stability, with a default of 100 concurrent deliveries and per-customer configuration available.

  #### Scrapers

  **Troubleshoot scraper errors faster**: Find clear explanations for every Scrapers error code in our [documentation](/datasets/scrapers/scrapers-library/error-list-by-endpoint). Understand what went wrong and how to fix it without contacting support.

  ### 🐞 Bug Fixes

  #### Datasets

  **Dataset preview table no longer shows as empty**: Fixed an issue where the preview table would appear blank even when the dataset contained data. Your dataset samples now display correctly every time.

  **CSV filtering handles empty lines**: Removed errors when filtering with CSV files that contain blank rows.

  ## Release notes for week ending Aug 29, 2025

  ### 🆕 New features

  **Instant support in Chinese**: Get immediate help in your language when visiting [bright.cn](http://bright.cn). Our AI assistant Sophie provides instant answers in Chinese, with seamless handoff to live support agents during business hours when you need more help.

  ## Release notes for week ending Aug 22, 2025

  ### 🚀 Improvements

  **Proxy Network Simplification**: Streamlined zone settings by removing rarely-used option "Cache proxy", making it easier to configure exactly what you need without confusion.

  ### 🐞 Bug Fixes

  **Better readability in dark mode**: Fixed display issues that made parts of the Control Panel difficult to read or visually inconsistent when using dark mode.

  <img alt="dark-mode-ui-fixes.png" />

  ## Release notes for week ending Aug 8, 2025

  ### 🆕 New features

  **MCP Playground**: Test and interact with the new interactive MCP playground. This feature allows you to send and receive messages to test crawler logic. [Try now](https://brightdata.com/ai/playground-chat)

  **Protection against accidental account deletion**: Changed account to "deactivate" instead of deleting immediately? You now have 30 days to change your mind and reactivate. Plus, your account manager will reach out to understand what went wrong and help if you're facing issues. [Learn more](/general/account/faqs)

  ### 🚀 Improvements

  **Test any API before committing**: Try Proxy networks, Web Unlocker and SERP API in the Control Panel for FREE! Validate your use case and see real results before writing your integration code. [Try now](https://brightdata.com/cp/web_access/playground)

  **Get to human support in one click**: When you ask to speak with someone, BrightAI now provides a direct link to create a support ticket, ensuring your issue gets proper attention and tracking instead of getting lost in chat.
</Update>

<Update label="July, 2025">
  ## Release notes for week ending Jul 29, 2025

  ### 🆕 New features

  #### IP Orders for Verified Accounts

  Order large quantities of dedicated IPs with processing time and delivery tracking. [Read more](https://brightdata.com/cp/zones/order_ips/new)

  #### Deep Lookup Preview Mode

  Preview table structure for free before pulling data, with a built-in co-pilot to refine prompts for better accuracy. [Read more](https://brightdata.com/cp/deep_lookup)

  #### Light Parser for Google

  Parse top 10 search results up to 2.5× faster for quicker responses. [Read more](/scraping-automation/serp-api/parsed-json-results/parsing-search-results#light-parser-for-google)

  #### Bing → Bright Data SERP API Migration

  1-to-1 migration path for moving Bing API parsing to Bright Data’s SERP API. [Read more](/scraping-automation/serp-api/parsed-json-results/bing-to-bright-data-serp-migration-guide)

  ***

  ## Release notes for week ending Jul 22, 2025

  ### 🆕 New features

  #### Scrapers – Gemini/Grok/Google AIO

  Added AI Scraper support for multiple models, making it easier for users of one AI scraper to leverage others. [Read more](/datasets/scrapers/scrapers-library/ai-scrapers)

  #### BrightAI Start Page

  Introduction of BrightAI, a RAG-based assistant that uses account logs and settings to guide users through setup, optimization, and navigation of Bright Data tools.

  #### Data and Data Rate Overview

  New filters on the [Zone Dashboard](https://brightdata.com/cp/zones/dashboard) provide insights into traffic volume and connection speed by zone, type, and target domain for better optimization and anomaly detection. [Read more](https://brightdata.com/cp/zones/dashboard)

  #### Residential Mega Pool

  Access to a larger pool of rotating IPv4 and IPv6 residential proxies.

  #### IPv6 to IPv4 Failover

  Automatic fallback to IPv4 when target sites don’t support IPv6, improving success rates.

  #### Datacenter and ISP Bulk Orders

  Selected customers can place future orders for dedicated datacenter and static residential proxies with delivery tracking in the control panel.

  #### MCP Cloud Storage

  Option to use cloud-hosted or self-hosted MCP for broader compatibility. [Read more](/ai/mcp-server/overview)

  #### Web Archive Prefix Customization

  Ability to set a custom prefix for the top-level export folder path. [Read more](/datasets/archive/overview#deliver-snapshot-to-amazon-s3-storage)
</Update>

<Update label="June, 2025">
  ### 🆕 New features

  #### Scraper IDE (Functions) WARC Support

  Capture the full context of web content in a robust, standardized WARC format for preservation, compliance, and reproducible research. [Read more](/datasets/scraper-studio/warc-ide)
</Update>

<Update label="May, 2025">
  ### 🆕 New features

  #### Residential network: IPv6 support

  You can now use IPv6 on Bright Data’s residential network. With 150,000+ IPv6-enabled peers and growing, this upgrade offers greater scalability and access to a larger IP pool. [Read more.](/proxy-networks/residential/configure-your-proxy#how-to-configure-ipv6-shared-residential-proxies)

  #### Custom Scrapers

  Easily extract data from any website, no coding or infrastructure needed. Just provide target URLs and define the data you want. Choose to manage the project yourself or let us handle it end-to-end. [Read more.](/datasets/scrapers/custom-scrapers/scrape-any-web)

  #### Scrapers: custom field selection

  Save storage and streamline output by selecting only the fields you need using a simple pipe-separated list. [Read more.](/datasets/scrapers/custom-scrapers/scrape-any-web)

  ### 🚀 New Integrations

  #### LangChain

  Power LLM agents with real-time, anonymous web data. [Read more.](/integrations/langchain)

  #### Lindy.ai

  Enable AI "employees" to automate tasks using live web data. [Read more.](/integrations/lindy-ai)

  #### LlamaIndex

  Ingest and index web data seamlessly into your knowledge base to enable powerful retrieval-augmented generation (RAG) workflows. [Read more.](/ai/mcp-server/integrations/llamaindex)

  #### Make

  Automate scraping, dataset retrieval, and API calls, no code required. [Read more.](/integrations/make)

  #### n8n

  Build automated workflows that connect Bright Data’s capabilities with hundreds of other apps and services, all with a visual editor. [Read more.](/integrations/n8n)
</Update>

<Update label="April, 2025">
  ## Release notes for week ending Mar 20, 2025

  ## Datasets

  ### 🆕  New features

  **Large Dataset Splitting and Download in UI**: You can now download large datasets directly from the UI. Large files are automatically split into smaller parts with easy download links through the email, making big data access smoother and more convenient.

  ### 🚀 Improvements

  * **Improved Delivery System**: We made backend improvements to ensure faster and more reliable dataset deliveries.
  * **Filter API Tweaks**: We fine-tuned the Filter API for better performance and more accurate filtering.
  * **Support for Free Datasets**: We added billing-side support for free datasets, making it easier to access datasets that are available at no cost.

  #### Error Status Documentation Added

  We updated our documentation to include error status codes for the Dataset API, helping developers troubleshoot issues faster.

  ### 👉 View Documentation

  #### Download Large Snapshots via Email

  You can now receive an email with download links for snapshots larger than 5GB, offering another easy way to access big datasets.

  #### Snapshot Metadata API Update

  The Snapshot Metadata API now returns error details, error codes, and initiation type, giving you better visibility into your dataset operations.

  ### 🐞 Bug Fixes

  * Fixed "Custom Dataset" Button: The "Custom Dataset" button now works properly.
  * Fixed Parquet Delivery "Out of Memory" Error: Large Parquet file deliveries no longer cause memory errors.
  * Fixed Filter Issues
  * Missing "list exact match" and "include" options in filters were fixed.
  * Filtering issues for the Enriched Employee Business dataset were resolved.
  * Unclear filter error messages in the UI are now clearer and more helpful.
  * Fixed Snapshots Table UI: The snapshots table now displays correctly without empty columns.
</Update>

<Update label="March, 2025">
  ## Release notes for week ending Mar 20, 2025

  ### **General**:

  #### 🆕 New features

  * **AI-Powered Support**
    * BrightAI now serves as the first responder to support tickets for small and new customers, providing immediate assistance while maintaining our commitment to quality service. You'll receive faster initial responses, but rest assured that you can request a human support specialist at any point during your conversation if needed.

  ### **Datasets**:

  #### 🆕 New features

  * **Easier Filtering with Auto-Complete**
    * Filtering datasets is now faster and more intuitive with auto-complete suggestions. For example, when selecting an Amazon category, you can now choose from a predefined list instead of searching manually on Amazon.

      <img alt="Release Notes" />
  * **New API for Dataset Metadata**
    * Developers can now access dataset metadata through our API, making it easier to integrate with automation tools like Zapier, Make.com, and n8n.io. This allows you to retrieve dataset details and schema to set up automated workflows and get the exact data you need. 👉 View API Documentation ([link](/api-reference/marketplace-dataset-api/get-dataset-list))

  #### 🚀 Improvements

  * **Better Search in the Marketplace**
    * Searching for datasets is now more flexible, allowing for slight variations and even typos. This makes it easier to find what you need, even if your search isn't perfectly accurate.

      <img alt="Release Notes" />
  * **Clearer Messages for Filter Limits**
    * Reaching the daily filtering limit now triggers a clear message explaining the limit and next steps. You can also submit a request to our data experts for help in refining your dataset filters.

      <img alt="Release Notes" />
  * **Helpful Tooltips for Date Columns**
    * Date columns now include tooltips that explain the date format, ensuring you understand that records for the selected dates are inclusive.

      <img alt="Release Notes" />

  #### 🐞 Bug Fixes

  * **Improved Usability and UI**
    * We've made several design and usability improvements, including fixing typos, to make your experience smoother.

  ### **Scrapers**:

  #### 🆕 New features

  * **New endpoint allows sync calls to retrieve the scraped data to the requested origin**
    * We've introduced a new endpoint that enables synchronous calls to retrieve scraped data directly from the requested origin, improving efficiency and streamlining the process. This enhancement alongside the upcoming design changes that will be implemented in the next weeks will allow users to access and test their scraped data more quickly and reflect the potential value ([link](/api-reference/scrapers/synchronous-requests))
  * **New "Wikipedia articles" scrapers**
    * Users can now discover (by keyword) and collect article information from Wikipedia.

  #### 🚀 Improvements

  * **Search and navigation**
    * We've made several improvements to enhance search results and navigation, making it easier for users to find relevant data and explore related products. Search results will now prioritize domain-only results, ensuring more accurate and streamlined discovery. Additionally, Dataset (DS) results will be displayed below Scraper results and vice versa, providing a more structured and intuitive search experience.

      <img alt="Release Notes" />
  * **A new banner in SERP to redirect users interested in Chat GPT and perplexity search results**
    * This banner redirects users to additional search engine results data, making it easier to access the AI-powered result searches

      <img alt="Release Notes" />

  #### 🐞 Bug Fixes

  * **Refresh API key Fix**
    * We've resolved an issue affecting the API key refresh option to ensure seamless authentication and session continuity.
  * **Scraper Request Call Scheduled Notification Fix**
    * Fixed a bug where scheduled notifications for new custom scraper requests were not triggering correctly, ensuring timely and accurate alerts to the relevant personnel

  ## Release notes for week ending Mar 13, 2025

  ### Web Archive API:

  #### 🚀 Improvements

  * **Hot Storage Duration**  Web Archive API now offers 72h of hot storage data instead of 96h. For more details [see here](/datasets/archive/overview#how-data-range-affects-delivery-time)

  ### Scrapers:

  #### 🆕  New features

  * **Output Schema Change Monitoring** We have released our "output schema change monitoring system" to improve detection accuracy and transparency. Schema change notifications are now consolidated into a single email for customer updates.

    <img alt="Release Notes" />
  * **New discovery method for "Walmart products"** Users can now discover and collect product information based on the SKU.

  #### 🚀 Improvements

  * **External Storage Option for Large Files** If the compressed file still exceeds 5GB, users will be prompted with an option to send the file to an external storage location for easier access and management.
  * **Custom scrapers - modify the customs scraper request flow** We are now routing calls based on customer type (Community, Named, Key, Strategic), and only the relevant personnel are added to the invite to increase efficiency
  * **Custom scrapers schema changes agility** If there are any changes to the schema defined by the customer during the call, the team can now update the schema before it is sent to the partners.

  ### Proxy products:

  #### 🚀 Improvements

  * Enable moving datacenter and ISP proxies from legacy pay per GB zones to new datacenter and ISP zones with unlimited plans.

  #### 🐞 Bug Fixes

  * Fix wrong country assignment for default country in Residential proxy network.

  ### Datasets:

  #### 🆕  New features

  * **eCommerce Datasets now have Daily & Weekly Subscriptions**

    You can now get daily or weekly updates for 41 out of 73 eCommerce datasets. This makes it easier to track new products in a category or monitor price changes more frequently. We’re working on adding support for more datasets soon!

    <img alt="Release Notes" />

    🚀 Improvements
  * **Improved Filtering Options**
    * See Matching Records Before Applying Filters – Now you can see how many records match your criteria before applying filters.
    * Filter by Date – You can now filter datasets using relative dates for more precise data selection.

      <img alt="Release Notes" />
  * **Estimated Cost Label on Dataset Page view**
    * We’ve added an estimated cost label below the purchase button so you can see pricing details before buying.
    * A new "Filter Dataset" button next to the cost label lets you quickly refine your dataset selection, helping you get the exact data you need while managing costs.

      <img alt="Release Notes" />
  * **Better Checkout Experience**
    * Clearer Navigation – Breadcrumbs now guide you through the checkout process.
    * Smarter Updates – We’ve improved how we explain delta subscriptions (smart updates) so you can make better decisions.
    * Promo Codes – You can now apply discount codes directly at checkout.

      <img alt="Release Notes" />
  * **Better Marketplace Experience**
    * Breadcrumbs in Marketplace – Easily track where you are while browsing datasets.
    * Redesigned Marketplace UI – We’ve refreshed the header, category list, and dataset cards grid to make browsing easier.

      <img alt="Release Notes" />

  #### 🐞 Bug Fixes

  * **Faster Quote Calculation**

    removed unnecessary calculations in the checkout process, improving performance.
  * **Subscription Update Fix**

    Updating a dataset subscription no longer redirects you to a different page, it will keep you on the same page.
  * **Improved Dataset Preview Speed**

    The dataset preview now loads faster for a smoother experience.

  ### Scrapers:

  #### 🆕  New features

  * **Cancel snapshot from the No-Code Scraper** – Users can now cancel a running snapshot directly from the No-Code Scraper interface.
  * **New logs functionality** – New buttons were added to the logs section to provide better interaction options and debugging capabilities to the customers

    <img alt="Release Notes" />
  * **New discovery method for "Airbnb Properties"** – Allowing users to retrieve Airbnb property information based on filtered URLs.
  * **New discovery method for "Glassdoor Companies"** – Users can now collect company information based on filtered URLs.

  #### 🚀 Improvements

  **UI Enhancements to Scrapers Home Page** We've improved the usability and navigation of the Scrapers home page enabling faster search, displaying smaller cards for better display and explore more scrapes to users, enhanced Custom Scraper suggestions, and added search within category pages

  <img alt="Release Notes" />

  * **Unified the API and No-Code delivery options** – We have fixed inconsistencies between the API and No-Code Scraper delivery settings. Now, both methods follow the same logic, making it easier for users to configure and manage their data delivery preferences.

  #### 🐞 Bug Fixes

  * **Fixed broken delivery settings** – Resolved an issue that was causing delivery settings to not function correctly. This fix ensures that users can reliably configure and receive their scraped data without disruptions.
  * **Filter functionality** - Filtering my "My scrapers" table according to product is now working
  * **URL structure** - The URL structure were inconsistent across the scrapers pages (e.g, some api\_data and some scrapers) now all URLs are consist in structure and contain the word scrapers as part of the URL
  * **Fixed search results page on Scraper home page** – Corrected an issue where search results on the Scraper home page were not displaying correctly. This fix ensures that users can find relevant scrapers more easily.
</Update>

<Update label="February, 2025">
  ### **Proxy products**:

  #### 🚀 Improvements

  * Added option to breakdown zone statistics by domain in zone overview page:

    <img alt="Release Notes" />

  ### **Web Unlocker API**:

  #### 🆕 New features

  * You can now get  HTML automatically converted into Markdown Language. It's supported both in API and native proxy interfaces. See [https://docs.brightdata.com/scraping-automation/web-unlocker/features#scrape-as-markdown](https://docs.brightdata.com/scraping-automation/web-unlocker/features#scrape-as-markdown)

  ### **Datasets**:

  #### 🆕  New features

  * Support for Date Expressions in Dataset Filters:You can now use date expressions in dataset filters (Relative Date), making it easier to refine your data selection based on time-based criteria. This feature is supported in both the Filter API and Dataset Subscriptions, allowing for more flexible and dynamic filtering. Example Use Case: Suppose you want to filter records to include only those from the last 7 days. You can use the "Last" expression to retrieve all records from the past week while excluding older data.

    <img alt="Release Notes" />

  #### 🚀 Improvements

  * We have enhanced the way Personally Identifiable Information (PII) is masked to improve data security and compliance.
  * Improved Quote Generation Time on Checkout Page - loading time is now faster to get quote data and quote the final price.
  * Released a new checkout page. Users can now see added and updated records directly on the checkout page.

  #### 🐞 Bug Fixes

  * Fixed Preview Table Errors:Resolved an issue that caused slow loading times in the dataset preview table, ensuring faster and smoother data previews.

  ### **Scrapers**:

  #### 🆕  New features

  * **Perplexity scraper -** Introducing a brand-new Perplexity Scraper, similar to our chatGPT scraper! This scraper allows customers to interact with Perplexity programmatically, retrieving responses as structured data. Now, you can automate queries and extract insights from Perplexity effortlessly. [Try it here](https://brightdata.com/cp/scrapers/browse?domain=perplexity.ai)

    <img alt="Release Notes" />
  * **Monitoring system for schema changes** – The first release of a monitoring and alerting system for schema changes was implemented to improve data accuracy and stability. It detects changes and sends automatic notifications to ensure seamless data operation. Expect improvements to this system in the coming weeks.
  * **New delivery feature for the No-Code Scraper** – We’ve added delivery methods, giving no-code users more flexibility in exporting and accessing their scraped data.

    <img alt="Release Notes" />

  #### 🚀 Improvements

  * **Enhanced search option to include new result types –** The search functionality now displays data points along with their respective scrapers, making it easier to identify relevant scrapers according to their outputs.

    <img alt="Release Notes" />
  * **"Deliver to external storage" is now enabled by default –** To streamline workflows, external storage delivery is now automatically enabled on the Scrapers, reducing manual setup steps.
  * **Custom scrapers request** - We simplified the request process. Now, it only requires two URLs, and the rest will be handled automatically, to try and streamline the request process

  #### 🐞 Bug Fixes

  * Resolved issues affecting custom scrapers and implemented an alert system to notify partners when action is required.
  * Fixed undefined URL structure – Improved URL handling to ensure consistent and well-defined structures across different pages.

  ### **Proxy products**:

  #### 🆕 New features

  * New API will provide the list of proxies pending replacement in advance and prepare for. Try it here: [Get proxies pending replacement API.](/api-reference/account-management-api/get-proxies-pending-replacement)

  #### 🚀 Improvements

  * Integrate faster with pre-made connect strings for proxy access details (host, port, user and password) accompanied with new set of configuration guides [Integration guides](/integrations/introduction).
  * We added error codes to our error catalog. Find and resolve issues faster by yourself [Proxy errors catalog](/proxy-networks/errorCatalog).
  * We have increased our servers deployment in Asia, and added some performance boosts.

  ### **SERP API**:

  #### 🆕 New features

  * **Google’s Generative AI Overviews** - you can now increase the likelihood of this overview appearing in your SERP results:
    * [https://docs.brightdata.com/scraping-automation/serp-api/query-parameters/google#ai-overview](https://docs.brightdata.com/scraping-automation/serp-api/query-parameters/google#ai-overview)
  * **Google Trends** - new parameters to get more accurate widget specific data:
    * \`brd\_trends = timeseries,geo\_map\`
    * [https://docs.brightdata.com/scraping-automation/serp-api/query-parameters/google#trends](https://docs.brightdata.com/scraping-automation/serp-api/query-parameters/google#trends)

  ### **Datasets**:

  #### 🆕  New features

  * **Delta Data for Dataset Subscriptions** - Customers can now enable delta logic to receive only new or updated records instead of full datasets for every collection cycle. This improves data relevance and allows flexible snapshot comparisons. No more manually identifying changes, as Bright Data does it for you.

    <img alt="Release Notes" />

  #### 🚀 Improvements

  * **New Pricing Table** - A redesigned pricing table provides clearer information, making it easier for customers to understand pricing tiers and make informed decisions.
  * **Enhanced Dataset Checkout Confirmation Page** - The confirmation page has been fixed to ensure a smoother and more reliable checkout experience.
  * **Improved Error Messaging for Missing Payment Details -** Customers attempting to purchase without adding payment and billing details will now receive clearer and more informative error messages.
  * **Refined Delivery Methods**  - The order of delivery options has been reorganized, and UI improvements have been made for better usability.
  * **Keyboard Shortcuts for "Update Dataset"**  - New keyboard shortcuts have been implemented to streamline dataset updates and UI enhancements for a better user experience.
  * **Better Data Sample Preview Table -**  Users can now intuitively open table rows and view object data types in a popover for improved clarity and visibility.

  #### 🐞 Bug Fixes

  * Fixed Routing Bug - Unnecessary query parameters no longer persist when navigating the dataset page.
  * Resolved Promotions Card UI Issue -  The promotions cards now display correctly according to the intended UI layout.

  ### **Scrapers**:

  #### 🆕  New features

  * **AI Scraper Agents** – Our first AI scraper agent allows users to extract data from any website by simply providing its domain. It automatically retrieves all URLs under that domain and extracts content in HTML, Markdown, or plain text. Ideal for AI companies, researchers, and developers needing high-quality text data for training models, analysis, or content generation. [Try it here](https://brightdata.com/cp/scrapers/browse?domain=example.com)

    <img alt="Release Notes" />

    <img alt="Release Notes" />

    <img alt="Release Notes" />
  * **ChatGPT scraper** - Introducing a brand-new ChatGPT Scraper, similar to our SERP scrapers! This scraper allows customers to interact with ChatGPT programmatically, retrieving responses as structured data. Now, you can automate queries and extract insights from ChatGPT effortlessly. [Try it here](https://brightdata.com/cp/scrapers/browse?domain=chatgpt.com)

    <img alt="Release Notes" />
  * **"Run Again" Button in Logs Page -** We've added a "Run Again" button to the Logs page, allowing users to quickly re-run the same request with a single click. making it easier to retry failed or past jobs without manually re-entering parameters.

    <img alt="Release Notes" />

  #### 🚀 Improvements

  * **My scrapers table**- Scrapers that are currently running or the most recent scraper that was in use will now appear at the top of the "My Scraper" table. This makes it easier to track active jobs without having to scroll through completed ones.
  * **WSA API**- To improve navigation and organization, we’ve moved the "Delivery Options" section to the "Management API" tab. This change makes it more intuitive for users managing API-based data deliveries.

  #### 🐞 Bug Fixes

  * If a collection job fails in the No-Code Scraper, users can now download error details to better understand what went wrong. Previously, the download button was disabled, making debugging difficult. This improvement ensures better transparency and troubleshooting.
  * We've resolved an issue where the "Report an Issue" feature did not correctly associate snapshots with tickets. Now, when customers report a problem, the correct snapshot is automatically linked, making it easier to troubleshoot and resolve issues efficiently.

  ### **Proxy products**:

  #### 🆕 New features

  * **HTTP3 beta is live** - The proxy network was upgraded to handle HTTP3/QUIC requests. Contact Bright Data sales - [sales@brightdata.com](mailto:sales@brightdata.com) if you want to try it out!

  #### 🚀 Improvements

  * It is now easier to **copy your proxy credentials** on the ‘overview’ tab, in different formats.

  #### 🐞 Bug Fixes

  * **Fix** **broken code examples** on account management API doc playground
  * **Added missing documentation** for endpoint and some old doc links not redirecting properly.

  ### **Datasets**:

  #### 🆕  New features

  * **"AI Filter Assistant"** allows users to filter datasets using **Natural Language** - just describe desired filters in English and get the relevant records.

    <img alt="Release Notes" />

    <img alt="Release Notes" />

  * **Payment Link Sharing** – Dashboard users can now generate and share payment links, making the purchasing process easier for others (e.g. their CFO)  without logging in to the control panel.

    <img alt="Release Notes" />

  * **Additional Dataset Statistics** –  Each Dataset now includes additional statistics regarding its content, for example: geographical distribution of records. This information is updated every month.

    <img alt="Release Notes" />

  #### 🚀 Improvements

  * **Enhanced Filtering Experience** – You can now move the filter window while reviewing and refining your filters and datasets. No more hiding of the table!
  * **Better data sample preview** – We’ve limited the cell size for better readability. You can now click on fields to expand and view the full data point in the sample dataset.

  #### 🐞 Bug Fixes

  * Fixed incorrect parsing of CSV files uploaded as inputs to the filter component.
  * Made sure the record count always gets updated, to show the effect of the filter.

  ### **Scrapers**:

  #### 🆕  New features

  * **Custom scrapers** - Allows users to request a custom scraper if the domain is unavailable in our marketplace. Just supply 2 URLs to get the process started - [see the video!](https://youtu.be/YhJWRQW6FSE)

  #### 🚀 Improvements

  * **An automatic email notification** that is being sent after a customer triggers a scraper for the first time, for better onboarding experience.
  * **Added code examples in multiple languages** to allow users to copy the API code in their preferred language on all of our API requests
  * **Reduced the number of examples from 10 to 5** in the "Overview" tab to provide a "clear" view to the users
  * **Sophie:** Users can now ask questions about specific use cases and receive relevant suggestions along with a direct link to the dataset.

  #### 🐞 Bug Fixes

  * Fixed broken links across the Scraper pages.
</Update>


# Residential
Source: https://docs.brightdata.com/residential-quickstart





# Scraper Studio quickstart
Source: https://docs.brightdata.com/scraper-studio-quickstart





# Scrapers quickstart
Source: https://docs.brightdata.com/scrapers-quickstart





# Ethical web scraping best practices
Source: https://docs.brightdata.com/scraping-automation/concepts/ethical-web-scraping

5 core principles of ethical web data collection, the legal risks of non-compliant scraping and a practical checklist for sustainable data pipelines.

How do you build a data pipeline that won't get shut down by a lawsuit, a regulatory change, or a blocked IP range? As scraping lawsuits multiply and AI-specific regulation accelerates, how you collect data matters as much as what you collect.

This guide covers the risks of non-compliant scraping, five core principles for ethical data collection, and a practical checklist you can apply today.

<iframe title="Ethical web scraping best practices" />

## Why ethical scraping matters now

The demand for web data keeps growing, especially for AI training, competitive intelligence, and real-time analytics. But so does the scrutiny.

Three trends are converging:

* **Regulatory pressure is increasing.** Governments worldwide are drafting AI-specific regulations that include data collection requirements. The EU AI Act, the US AI Action Plan, and China's Global AI Initiative all address how data is sourced.
* **Legal disputes are multiplying.** Website owners and platforms are filing lawsuits against data collectors more frequently. Cases involving social media platforms, publishers, and AI companies make headlines weekly.
* **The need for data is not slowing down.** Data is now the key differentiator in the AI triangle of compute, talent, and data. The internet is the largest dataset mankind has ever built, but accessing it responsibly is a challenge on its own.

If you build ethical data collection practices now, you'll avoid costly disruptions later. If you don't, you risk lawsuits, blocked access, reputational damage, and poisoned data pipelines.

## Risks of unethical data collection

The consequences of non-compliant scraping fall into two categories.

### Legal, reputational, and financial risks

* **Lawsuits from website owners.** Legal actions from platforms and publishers are increasing. These cases are expensive, take years to resolve, and damage your reputation even before a ruling.
* **High-profile media coverage.** You don't need a court case to suffer reputational damage. Negative press about your data practices can erode customer trust quickly, especially in the AI space where data sourcing is under a spotlight.
* **Vendor risk.** If your data vendor gets sued or shuts down, you lose your data source. Worse, your AI model or product may have already ingested data that was unethically sourced, and unwinding that is far more expensive than preventing it.

### Technical and operational risks

* **IP bans and blocked access.** Aggressive or poorly configured scraping triggers blocks that degrade your data quality and availability.
* **Silent data degradation.** Blocked scrapers don't always fail loudly. They may return valid-looking HTML with wrong data, meaning your downstream systems ingest bad data without alerting anyone.
* **Product damage.** If your product depends on scraped data, any disruption to your data pipeline directly impacts your users.

<Warning>
  These risks are not theoretical. Data vendors have been sued and forced to shut down for selling non-public data, leaving their customers exposed to both data loss and legal liability.
</Warning>

## Five principles of ethical web scraping

### 1. Collect publicly available data only

This is the most important principle. Public web data means content accessible without logging in. If data requires a login, sits behind a paywall, or needs restricted access credentials, it is not public data.

The distinction matters legally and practically:

| Data type                  | Example                                               | Ethical to scrape?                  |
| -------------------------- | ----------------------------------------------------- | ----------------------------------- |
| **Public web data**        | Product listings, public profiles, published articles | Yes (with other principles applied) |
| **Login-required data**    | Private messages, account dashboards, gated content   | No                                  |
| **Paywall-protected data** | Subscription-only articles, premium databases         | No                                  |

<Tip>
  Build your scraping infrastructure to distinguish between public and non-public data by design. Being able to demonstrate this distinction (through code, policies, or audits) is one of the strongest defenses you can have.
</Tip>

### 2. Collect only what you need

Scope your data collection to specific business purposes before you start scraping. This isn't just good practice. It directly reduces your legal exposure.

Ask three questions before any scraping project:

* **What** specific data fields do you need?
* **Why** do you need this data? (What business problem does it solve?)
* **How** will this data be used and stored?

Broad, unfocused data collection increases risk without increasing value. The more targeted your scraping, the easier it is to justify and defend.

### 3. Protect the web

When you scrape with automated processes and bots, your traffic should not harm or degrade the target site's performance. Both bots and humans should still be able to use the website normally.

Practical measures include:

* **Monitor domain response times.** Measure the target site's response time in real time to detect if your traffic is affecting performance.
* **Implement rate limiting.** Throttle your requests to avoid overwhelming the server.
* **Respect `robots.txt`.** While not legally binding in all jurisdictions, respecting `robots.txt` signals good faith.
* **Back off on errors.** If you start receiving 429 (Too Many Requests) or 503 (Service Unavailable) responses, reduce your request rate immediately.

<Note>
  Ethical scraping requires a proactive approach. Don't just avoid causing harm. Actively monitor for it and adjust your behavior accordingly.
</Note>

### 4. Keep detailed logs

Many proxy and scraping providers advertise "no logs" as a feature. For ethical scraping, the opposite is true.

Keeping logs allows you to:

* **Monitor** your scraping activity for anomalies or policy violations
* **Investigate** any issues or complaints from website owners
* **Defend** against false accusations with evidence of compliant behavior
* **Improve** your practices based on historical patterns

If you don't want to keep logs, ask yourself why. Logs are a protection, not a liability. They enable transparency and accountability, two things regulators and courts value highly.

### 5. Enforce governance and reporting

Having a policy isn't enough. You need active enforcement.

This means:

* **Zero tolerance for non-compliant activity.** Define clear boundaries and enforce them consistently.
* **Internal and external reporting channels.** Allow stakeholders (including website owners) to report suspicious activity.
* **Third-party audits.** Independent verification ensures your policies are actually being followed.
* **Incident investigation.** When dealing with large-scale data collection, issues will arise. What matters is whether you detect them, investigate them, and fix them.

## The regulatory landscape

Regulation around web scraping and AI data collection is evolving rapidly and differs by jurisdiction.

| Approach                  | Key framework                         | Focus                                                                                                   |
| ------------------------- | ------------------------------------- | ------------------------------------------------------------------------------------------------------- |
| **Risk-based (EU)**       | EU AI Act, Voluntary Code of Practice | Ethics and safety first, with layers of compliance requirements for AI systems                          |
| **Innovation-first (US)** | US AI Action Plan                     | Emphasizes removing barriers to AI development. Views access to public data as crucial to AI leadership |
| **Hybrid**                | China's Global AI Initiative          | Combines innovation goals with data governance requirements                                             |

Three takeaways regardless of your jurisdiction:

1. **Data collection practices are getting more scrutiny.** Regulators are distinguishing between data collection and data usage. Both carry separate risks and requirements.
2. **Local regulation matters.** Requirements differ based on where your organization operates, where your data sources are located, and where your users are.
3. **Existing laws still apply.** Privacy regulations, copyright law, and computer fraud statutes are being applied to scraping cases today. Don't wait for AI-specific legislation to address compliance.

<Tip>
  Consult with your legal team regularly. Regulation is changing fast, and what was acceptable six months ago may no longer be. Ongoing risk management is essential, not optional.
</Tip>

## What to check before scraping

Use this checklist to evaluate your own scraping practices or to vet a data vendor.

<AccordionGroup>
  <Accordion title="1. Know your data sources">
    Only collect publicly available data. If you use a data vendor or proxy provider, do your due diligence: know who you're doing business with, where and how they source their data, and whether they follow ethical practices. Not all vendors are created equal.
  </Accordion>

  <Accordion title="2. Protect the web">
    Monitor target site health, implement rate limits, and use response time tracking to ensure your scraping doesn't degrade site performance. Ethical scraping means the website works normally for all visitors during and after your data collection.
  </Accordion>

  <Accordion title="3. Maintain logs and documentation">
    Keep detailed records of your scraping activity. Logs serve compliance, incident investigation, and continuous improvement. They're your best defense if your practices are ever questioned.
  </Accordion>

  <Accordion title="4. Build reporting and governance channels">
    Create mechanisms for internal teams and external stakeholders to report concerns. Investigate any abnormal activity promptly. At scale, issues will arise. Your response to them defines your ethical posture.
  </Accordion>

  <Accordion title="5. Stay current on regulation">
    Follow regulatory developments in every jurisdiction where you operate or source data. Consult with your legal team regularly. Join industry groups and alliances focused on responsible data collection to stay informed.
  </Accordion>
</AccordionGroup>

## Common misconceptions

**"If data is on the internet, it's free to scrape."**
Being publicly accessible doesn't mean there are no rules. Privacy laws, terms of service, and copyright protections may still apply. Public access reduces legal risk significantly compared to scraping behind logins, but it doesn't eliminate all obligations.

**"CAPTCHA solving means you're accessing protected data."**
Solving a CAPTCHA doesn't mean you're piercing a privacy wall or accessing restricted content. CAPTCHAs are anti-bot measures, not access controls. Courts have recognized this distinction: content behind a CAPTCHA can still be publicly available.

**"No-log policies protect you."**
Without logs, you can't prove what you did or didn't do. If a website owner claims you scraped non-public data or caused a service disruption, logs are your evidence. "No logs" is a liability, not a feature.

**"Data collection and data usage carry the same risk."**
These are distinct activities with different legal and ethical considerations. How you collect data (scraping practices, sources, methods) and how you use it (training models, commercial analytics, resale) are evaluated separately by regulators and courts.

## FAQs

<AccordionGroup>
  <Accordion title="What is 'public web data'?">
    Public web data is content accessible to anyone through a web browser without logging in, providing credentials, or bypassing access restrictions. Product listings, public social media profiles, published news articles, and government databases are common examples.
  </Accordion>

  <Accordion title="Is web scraping legal?">
    Web scraping of publicly available data is generally legal in most jurisdictions, but the specifics depend on local laws, the type of data, and how it's used. Privacy regulations (like GDPR), copyright law, and terms of service can all create constraints. Consult with legal counsel for your specific situation.
  </Accordion>

  <Accordion title="How do I evaluate a data vendor's ethical practices?">
    Ask whether they collect only public data, how they distinguish public from non-public content, whether they maintain logs, how they handle website owner complaints, and whether they undergo third-party audits. A vendor that can't answer these questions clearly is a risk.
  </Accordion>

  <Accordion title="Does respecting robots.txt make scraping ethical?">
    Respecting `robots.txt` is one signal of good faith, but it's not the full picture. Ethical scraping also requires collecting only public data, protecting site performance, maintaining logs, and having governance processes in place. `robots.txt` compliance alone is not sufficient.
  </Accordion>

  <Accordion title="What should I do if my data vendor gets sued or shuts down?">
    This is why vendor due diligence matters upfront. If it happens, assess what data you've already ingested, whether it was ethically sourced, and whether you need to remove or replace it. Build redundancy into your data pipeline so a single vendor failure doesn't cripple your operations.
  </Accordion>
</AccordionGroup>

## Further reading

* [Alliance for Responsible Data Collection (ARDC)](https://responsibledatacollection.org)
* [Bright Data Trust Center](https://brightdata.com/trustcenter)
* [Web Scraping Without Getting Blocked: 12 Techniques](https://brightdata.com/blog/web-data/web-scraping-without-getting-blocked)
* [How Bright Data handles anti-bot blocking](/scraping-automation/concepts/how-bright-data-handles-blocking)


# How Bright Data handles anti-bot blocking
Source: https://docs.brightdata.com/scraping-automation/concepts/how-bright-data-handles-blocking

Learn how modern anti-bot systems detect scrapers across 4 layers, why DIY bypasses are costly, and how Bright Data's products defeat each detection layer.

Your scraper worked yesterday. Today it returns a 403, a CAPTCHA page, or worse: valid-looking HTML with completely wrong data. What changed?

Websites layer multiple detection systems that evolve constantly. This guide explains the detection layers that block scrapers, why maintaining anti-blocking yourself is costly, and how Bright Data's products defeat each layer.

## Why scrapers get blocked

Modern anti-bot systems don't rely on a single signal. They combine multiple detection layers, and failing any one of them triggers a block.

DIY scraping refers to building and maintaining your own scraping infrastructure: writing parsers, managing proxies, handling CAPTCHAs, and patching browser fingerprints yourself. Here is why each detection layer makes that difficult:

| Detection layer            | What it checks                                         | Why DIY scraping struggles                                                                                 |
| -------------------------- | ------------------------------------------------------ | ---------------------------------------------------------------------------------------------------------- |
| **IP reputation**          | Historical behavior of your IP address                 | Datacenter IPs are flagged instantly; rotating residential IPs requires a large, clean pool                |
| **TLS/JA3 fingerprinting** | The TLS handshake signature of your HTTP client        | Libraries like Python `requests` send identical JA3 hashes on every request, matching known bot signatures |
| **Browser fingerprinting** | Canvas, WebGL, fonts, screen resolution, audio context | Even headless browsers with stealth plugins leave detectable traces                                        |
| **Behavioral analysis**    | Request timing, navigation patterns, mouse movement    | Fixed intervals and linear crawl paths signal automation                                                   |
| **CAPTCHAs**               | Human verification challenges                          | reCAPTCHA v3, hCaptcha, Cloudflare Turnstile each require different solving approaches                     |

Here is what a typical blocked response looks like when scraping a Cloudflare-protected site with a basic setup:

```bash cURL theme={null}
curl -s "https://www.g2.com/products/bright-data/reviews" \
  -H "User-Agent: Mozilla/5.0" \
  -x http://datacenter-proxy:8080
```

```html Response theme={null}
<html>
  <head><title>Attention Required! | Cloudflare</title></head>
  <body>
    <h1>Sorry, you have been blocked</h1>
    <p>You are unable to access g2.com</p>
    <!-- Cloudflare Ray ID: 7a1b2c3d4e5f -->
  </body>
</html>
```

## Why maintaining anti-blocking yourself is costly

Each detection layer requires a different countermeasure, and each countermeasure requires ongoing maintenance.

IP rotation means sourcing, validating, and retiring proxies. TLS fingerprinting means patching your HTTP client to randomize handshake signatures, something most libraries don't support natively. Browser fingerprinting means keeping headless browser patches current as detection systems update weekly. CAPTCHA solving means integrating third-party solvers and handling failures.

In practice, teams that build this in-house find that anti-blocking maintenance consumes a significant share of their engineering effort, often more time than building the actual data pipeline. When a target site updates its defenses, your scraper fails silently, returning empty fields or stale data while appearing to work normally. By the time you notice, your downstream systems have been ingesting bad data for hours or days.

Every Bright Data scraping product shares the same anti-blocking engine. The difference between products is what you get back and how much control you keep.

## How Bright Data handles each detection layer

**IP reputation.** Requests are routed through residential IPs from real ISPs across 195+ countries. Anti-bot systems treat these as regular household traffic. IPs are automatically rotated per request and flagged addresses are retired from the pool.

**TLS fingerprinting.** When your HTTP client opens a connection, it sends a TLS Client Hello that anti-bot systems hash into a JA3 fingerprint. Python `requests`, for example, always produces the same hash, which is a known bot signature. Bright Data generates a unique TLS fingerprint per request, matching the diversity of real browser populations.

**Browser fingerprinting.** Sites collect Canvas renders, WebGL data, installed fonts, screen dimensions, and audio context to build a device profile. Bright Data emulates complete, consistent browser environments that pass checks from Cloudflare Turnstile, Akamai Bot Manager, and other major detection systems.

**Behavioral analysis.** Anti-bot systems track request timing, navigation sequences, and interaction patterns. Bright Data varies request timing, simulates realistic navigation patterns, and manages session state to match human browsing behavior.

**CAPTCHA solving.** CAPTCHAs are solved automatically, including reCAPTCHA, hCaptcha, Cloudflare Turnstile, and others. You never see the challenge. The response arrives as if no CAPTCHA existed.

## Which product fits your situation

Each product inherits the anti-blocking capabilities described above. The difference is what you get back and how much control you need.

**I want full control over my HTTP client and just need IPs that won't get flagged.**

Use [Bright Data Proxies](/proxy-networks/introduction). Four types are available: residential (highest trust, best for protected sites), datacenter (fastest, best for unprotected sites), ISP (residential trust at datacenter speed), and mobile (highest trust, best for heavily protected targets). Proxies solve IP reputation but leave the other four detection layers to you.

**I need raw HTML from protected sites without building anti-blocking myself.**

Use [Web Unlocker](/scraping-automation/web-unlocker/introduction). Send a URL, get back clean HTML. All five detection layers are handled in a single API call: IP rotation, TLS fingerprinting, browser fingerprinting, behavioral emulation, and CAPTCHA solving.

**I need to navigate to click through pagination, or interact with JavaScript-heavy pages.**

Use [Bright Data Browser API](/scraping-automation/scraping-browser/introduction). Full cloud-hosted browsers controlled through Puppeteer or Playwright with all anti-blocking built in. Unlike Web Unlocker, Browser API runs a real GUI browser (not headless), which produces authentic rendering artifacts that detection systems are far less likely to flag.

**I need search engine results from Google, Bing, or other engines without getting blocked.**

Use [SERP API](/scraping-automation/serp-api/introduction). Search engines are among the most aggressively protected targets. SERP API handles all the anti-blocking and returns structured JSON with organic results, ads, featured snippets, and knowledge panels already parsed.

**I want structured data from popular websites without writing or maintaining parsers.**

Use [Web Scraper API](/datasets/scrapers/scrapers-library/overview). 650+ pre-built scrapers for sites like Amazon, LinkedIn, Instagram, YouTube, TikTok, and Google Maps. You get clean JSON with an average of 220+ data fields per scraper. When target sites change, Bright Data updates the scrapers.

## Common misconceptions

**"Residential proxies alone solve blocking."** They handle IP reputation, but modern systems also check TLS fingerprints, browser fingerprints, and behavioral patterns. Proxies are one layer out of five.

**"Stealth plugins make headless browsers undetectable."** Cloudflare Turnstile and Akamai Bot Manager detect patched headless browsers even with Playwright Stealth applied. Browser API solves this by running a real GUI browser rather than a patched headless one.

**"Slowing down requests prevents blocks."** Rate limiting helps avoid basic IP bans, but sites like LinkedIn, Instagram, and Amazon use session-level fingerprinting that detects automation regardless of speed.

**"Proxies and Web Unlocker do the same thing."** Proxies route your requests through different IPs only. Web Unlocker also manages TLS fingerprints, solves CAPTCHAs, emulates browser behavior, handles JavaScript rendering, and retries with fresh fingerprints on failure.

## FAQs

<AccordionGroup>
  <Accordion title="Does Bright Data work on Cloudflare-protected sites?">
    Yes. Web Unlocker, Browser API, SERP API, and Web Scraper API all handle Cloudflare challenges (including Turnstile), Akamai Bot Manager, PerimeterX, DataDome, and other major anti-bot systems automatically.
  </Accordion>

  <Accordion title="What success rate should I expect?">
    In an [independent benchmark](https://brightdata.com/blog/web-data/best-web-scraping-apis) testing 11 providers, Bright Data achieved a 98.44% average success rate, the highest among all tested.
  </Accordion>
</AccordionGroup>

## Further reading

* [Web Scraping Without Getting Blocked: 12 Techniques](https://brightdata.com/blog/web-data/web-scraping-without-getting-blocked)
* [Top 7 Anti-Scraping Techniques and How to Bypass Them](https://brightdata.com/blog/web-data/anti-scraping-techniques)
* [Web Unlocker best practices](/scraping-automation/web-unlocker/bestpractices)
* [Web Unlocker vs Scraping Browser](https://brightdata.com/blog/web-data/web-unlocker-vs-scraping-browser)


# Modern scraping operations
Source: https://docs.brightdata.com/scraping-automation/concepts/modern-scraping-operations

Why web scraping shifted from a scripting problem to an infrastructure discipline, and what production-grade scraping systems look like in 2026.

What changed about web scraping? The scripts still work, until they don't. Then you're debugging at 2 AM because a site changed a single CSS class and your entire pipeline went silent.

Five years ago, scraping was a scripting problem. You wrote a parser, pointed it at a URL, and collected data. Today, scraping is an infrastructure problem. Cloudflare alone protects [over 24 million active websites](https://www.cloudflare.com/network/), and in July 2025 it began [blocking AI crawlers by default](https://blog.cloudflare.com/declaring-your-aindependence-block-ai-bots-scrapers-and-crawlers-with-a-single-click/) across its entire network. The number of web security services tracked by [Wappalyzer](https://www.wappalyzer.com/technologies/security/) nearly doubled from 36 to 60 between 2022 and 2024. The web got harder to scrape, and it happened fast.

This article examines why the landscape shifted, what production scraping systems look like now, and how teams are adapting their architecture to operate reliably at scale.

## The economics shifted

The headline number most teams track is cost per gigabyte of proxy traffic. That number has fallen significantly over the past five years. But it's the wrong metric.

What actually matters is **cost per successful payload**: the total spend (proxy, compute, API fees) divided by the number of usable records you extract. That number has been climbing, because the techniques required to extract data have gotten more expensive even as individual input costs dropped.

Here's why:

* Sites that once responded to simple HTTP requests with datacenter proxies now require residential proxies (roughly 10x the cost) or full browser rendering (another 5-10x multiplier in compute)
* According to [AImultiple's web scraping challenges research](https://aimultiple.com/web-scraping-challenges), blocking is now the primary challenge developers face, with static IP blocking replaced by continuous behavioral trust scoring
* The share of requests that need heavyweight extraction methods (residential IPs, headless browsers, or both) has grown substantially, driven by widespread adoption of anti-bot services

This creates what you might call **scraping shock**: data remains technically reachable but becomes economically painful to extract at previous cost levels.

<Tip>
  The competitive advantage in scraping has shifted from "who can scrape the most" to "who can scrape most efficiently." Cost-per-successful-payload is now the metric that matters.
</Tip>

## Three forces driving the shift

### 1. Anti-bot systems got smarter, faster

In September 2024, Cloudflare introduced [one-click AI bot blocking](https://blog.cloudflare.com/declaring-your-aindependence-block-ai-bots-scrapers-and-crawlers-with-a-single-click/). Over 1 million customers activated it. By July 2025, Cloudflare began blocking AI crawlers by default across its entire network.

Detection moved beyond IP reputation and cookie validation. Modern anti-bot systems now analyze:

* **TLS fingerprints.** Python's Requests library has a different TLS signature than Chrome, making the library itself identifiable.
* **Browser fingerprints.** Screen resolution, WebGL renderer, canvas fingerprint, installed fonts, audio context, and GPU timing.
* **Behavioral signals.** Mouse movement patterns, scroll velocity, click timing, and keystroke cadence.
* **Header consistency.** Real browsers send different headers per request type; bots send identical headers every time.

The popular `puppeteer-stealth` library was deprecated in February 2025 because it could no longer bypass current Cloudflare versions. As developers frequently report in scraping communities: stock Selenium and Puppeteer leak automation signals everywhere, and techniques that work today stop working next month.

### 2. Platforms locked down deliberately

This isn't just technical escalation. It's strategic. Platforms are treating their data as a competitive asset, especially against AI companies.

* **Reddit** filed a lawsuit in October 2025 against multiple data collection companies and Perplexity AI for circumventing security measures.
* **X/Twitter** implemented IP reputation scoring in October 2024, bound guest tokens to browser fingerprints in January 2025, and permanently banned datacenter IPs.
* **Cloudflare's "AI Labyrinth"** creates honeypot traps that force AI agents to waste compute resources on fake content.

These aren't isolated incidents. They represent a coordinated shift where platforms view unrestricted data access as a threat to their business model.

### 3. AI crawlers changed the game for everyone

AI crawler traffic from GPTBot rose 147% between July 2024 and July 2025. Meta-ExternalAgent traffic rose 843%. These crawlers collectively generate around [50 billion requests daily](https://blog.cloudflare.com/declaring-your-aindependence-block-ai-bots-scrapers-and-crawlers-with-a-single-click/), roughly 1% of all web traffic according to Cloudflare.

This flood of AI traffic triggered a defensive response that affects all scrapers, not just AI crawlers. Sites that never bothered with anti-bot protection now have it. The collateral damage hits every team running a data pipeline.

<Warning>
  AI crawlers spend a significant portion of their fetches on 404 pages and redirect chains. This inefficiency is part of what drives sites to implement blanket blocking rather than selective filtering.
</Warning>

## What production scraping looks like now

The gap between "scraping works on my laptop" and "scraping works in production" has never been wider. Low-code tools and LLMs help get from 0 to 1 (getting a scraper working against a single page). But getting from 1 to 100 (running reliably at scale) requires systems thinking.

The operational reality of scraping at scale is sobering: successfully operating at even fewer than 1 million page views per day requires managing viewport size matching, user-agent rotation, multiple VLANs per container, and datacenter IP avoidance.

Here's what a production scraping system actually looks like:

<img alt="Modern scraping operations architecture" />

The architecture has five layers, each solving a distinct operational concern:

### How the orchestration layer works

This is the control plane. It manages what gets scraped, when, and how. At minimum, it includes:

* **Job scheduler.** Prioritizes and queues scrape jobs based on data freshness requirements.
* **Request router.** Decides the extraction method per target (HTTP client, headless browser, or managed API) based on the site's difficulty profile.
* **Retry logic with backoff.** Handles transient failures without hammering targets.

Most teams start without this layer. They run scrapers as cron jobs and handle routing manually. That works at hundreds of pages per day. It breaks at hundreds of thousands.

### How the extraction layer works

This is where the actual scraping happens. The key insight is that not every request needs the same tool:

* **HTTP clients** handle 0.5-2 seconds per request at minimal resource cost. They work for static content and sites without heavy JavaScript rendering.
* **Headless browsers** handle JavaScript-rendered content but consume 200-500 MB of RAM per instance and take 3-15 seconds per request. That's a 5-10x infrastructure multiplier.
* **Managed scraping APIs** offload anti-bot handling, proxy rotation, and browser management to a third party. The per-request cost is higher, but you eliminate infrastructure maintenance.

The production pattern is a tiered approach: try the cheapest method first, escalate only when it fails, and cache the result so subsequent requests to the same domain use the right method automatically.

<Note>
  Each Chrome instance needs 200-500 MB of RAM, and background scripts continue running even when a page seems idle. Sessions are tied to a specific process, making cross-machine load balancing complex and sharing Chrome user data directories across instances risky.
</Note>

### How the validation layer works

This is the layer most teams skip, and the one that causes the most damage at scale.

Scaling without validation means scaling error. A blocked scraper doesn't always return an HTTP error. It may return valid-looking HTML with wrong data: a CAPTCHA page, a soft block, or a region-specific version of the content. Your downstream systems ingest it silently.

Production validation includes:

* **Schema validation** before data enters storage: expected fields, types, and value ranges.
* **Content fingerprinting** to detect when a response matches a known block page pattern rather than real content.
* **Field completeness checks** that flag records where critical fields are missing or suspiciously uniform.

Teams that add schema validation to their scraping pipelines consistently report significant reductions in downstream data quality issues and ML model errors.

### How the observability layer works

Treat scraping like a production service. If you run a web application without monitoring, you'd be negligent. Scraping pipelines deserve the same discipline.

Key metrics to track:

* **Success rate per domain.** The percentage of requests that return valid, usable data (not just HTTP 200).
* **Cost per successful payload.** The total cost (proxy + compute + API) divided by usable records extracted.
* **Selector health.** Automated checks that detect when CSS selectors or XPath expressions stop matching expected elements.
* **Latency distribution.** p50 and p99 response times per domain, which signal when a site starts throttling.

Teams that implement observability-driven scraper redesigns consistently see dramatic improvements: fewer job failures, faster detection of site changes, and lower operational overhead from reduced manual debugging.

### Storage and delivery layer

Clean, validated data flows into storage and downstream systems. This layer is straightforward but matters for pipeline integrity:

* **Deduplication** before write. Scraping the same product page twice shouldn't create two records.
* **Timestamping.** Every record carries a collection timestamp so downstream consumers know data freshness.
* **Schema evolution.** When sites change their data structure, your storage schema needs to accommodate both old and new formats during the transition.

## The build vs. buy decision

At some point, every scraping team asks: should we maintain this infrastructure ourselves, or use a managed service?

The breakeven math depends on scale and site difficulty:

<img alt="Build vs buy decision framework" />

| Factor                        | Build (self-hosted)                                       | Buy (managed service)       |
| ----------------------------- | --------------------------------------------------------- | --------------------------- |
| **Upfront cost**              | Low (open-source tools)                                   | Per-request pricing         |
| **Maintenance burden**        | High (proxy rotation, browser updates, anti-bot adaption) | Low (vendor handles it)     |
| **Control**                   | Full                                                      | Limited to API parameters   |
| **Scaling ceiling**           | Limited by your infra team                                | Scales with spend           |
| **Anti-bot adaptation speed** | Weeks to months                                           | Hours to days               |
| **Breakeven point**           | Below \~500K requests/month                               | Above \~500K requests/month |

Self-hosted browser infrastructure costs \$200-800/month plus ongoing engineering time. At scale, the engineering time dominates: quarterly selector fixes, proxy pool management, and anti-bot adaptation are recurring costs that don't shrink with automation.

The practical pattern is a hybrid approach:

* **Self-host** for sites where simple HTTP requests work and data formats are stable.
* **Use managed APIs** for sites with heavy anti-bot protection, frequent layout changes, or JavaScript-heavy rendering.

Bright Data's product suite maps to this layered model. [Web Unlocker](/scraping-automation/web-unlocker/introduction) handles the anti-bot layer for HTTP requests. [Scraping Browser](/scraping-automation/scraping-browser/introduction) provides managed headless browsers without the RAM and scaling headaches. [Web Scraper API](/datasets/scrapers/overview) handles the full extraction pipeline for supported sites, returning structured data directly.

The decision isn't binary. Most production teams use a mix of self-hosted and managed components, optimized per domain based on difficulty, cost, and data freshness requirements.

## Common architectural mistakes

These patterns show up repeatedly in scraping teams that struggle at scale:

* **No validation layer.** The single most common failure. Teams scale their extraction without validating output, then discover weeks later that half their data is CAPTCHA pages stored as legitimate records.
* **Defaulting to browsers.** Headless browsers are 5-10x more expensive than HTTP clients. Teams that route every request through Puppeteer or Playwright are burning money on sites that would respond fine to a well-configured HTTP request with proper headers.
* **Hardcoded selectors without monitoring.** Static XPath and CSS selectors become invalid silently when sites change their DOM. Without automated selector health checks, data quality degrades without triggering any alert.
* **Treating scraping as a script, not a service.** Cron jobs without health checks, no alerting on success rate drops, no cost tracking per domain. This works at small scale. It creates invisible failures at production scale.
* **Ignoring the economics.** Scraping costs can spike 5-10x overnight when a site upgrades its defenses. Teams without cost-per-payload tracking don't notice until the monthly bill arrives.

## Where this is heading

Three trends will shape scraping operations over the next two years:

1. **Legal frameworks are crystallizing.** Reddit's lawsuit, the EU AI Act's data sourcing requirements, and platform-specific terms of service are creating a compliance layer that scraping systems need to account for. Teams that treat compliance as an afterthought will face operational disruption.

2. **AI is on both sides.** Sites use ML models to detect bots. Scrapers use LLMs to parse unstructured content. The cost of LLM-based parsing is still orders of magnitude higher than traditional approaches at scale, but it's falling. The teams that figure out when to use AI parsing and when to use traditional selectors will have a cost advantage.

3. **Managed infrastructure is becoming the default.** As anti-bot systems get more sophisticated, the maintenance burden of self-hosting increases. The trend line points toward more teams buying infrastructure and focusing engineering effort on data quality and business logic.

The scraping teams that thrive won't be the ones writing the cleverest bypass scripts. They'll be the ones running the most disciplined operations, with clear cost tracking, automated quality validation, and architecture that adapts to an adversarial web without manual intervention.

## Further reading

* [How Bright Data handles anti-bot blocking](/scraping-automation/concepts/how-bright-data-handles-blocking): deep dive into detection layers and how managed services defeat them
* [How to reduce web scraping costs](/scraping-automation/concepts/reducing-scraping-costs): practical techniques for optimizing at the request level
* [Ethical web scraping best practices](/scraping-automation/concepts/ethical-web-scraping): compliance principles and regulatory context
* [Understanding asynchronous requests](/scraping-automation/concepts/understanding-async-requests): when to use async vs sync for performance and cost

<AccordionGroup>
  <Accordion title="What is scraping shock?">
    Scraping shock describes the point where web data remains technically reachable but becomes economically unfeasible to extract at previous cost levels. It's driven by the combination of more sophisticated anti-bot systems, mandatory browser rendering, and required residential proxies, even as per-GB proxy prices have fallen.
  </Accordion>

  <Accordion title="How many requests per month justify building your own scraping infrastructure?">
    The general breakeven point is around 500K-1M requests per month, but this varies significantly by target site difficulty. If most of your targets work with simple HTTP requests and datacenter proxies, self-hosting stays cost-effective at higher volumes. If your targets require residential proxies and browser rendering, managed services become more economical at lower volumes.
  </Accordion>

  <Accordion title="Why did scraping costs rise even though proxy prices dropped?">
    Per-GB proxy prices have fallen significantly over the past five years. But the share of requests requiring residential proxies (roughly 10x more expensive than datacenter) and browser rendering (another 5-10x multiplier) has grown substantially. The shift in what's required more than offset the per-unit price decrease.
  </Accordion>

  <Accordion title="What percentage of scraping failures are silent?">
    This varies by implementation, but teams without validation layers commonly discover that 10-30% of their "successful" requests returned block pages, CAPTCHAs, or region-specific content instead of the expected data. These failures return HTTP 200, so they pass basic success/failure checks undetected.
  </Accordion>

  <Accordion title="Is self-hosted scraping infrastructure still viable in 2026?">
    Yes, for the right targets. Sites with minimal anti-bot protection, stable DOM structures, and static content are still cost-effective to scrape with self-hosted tools. The challenge is that the number of such sites is shrinking. A hybrid approach (self-hosted for easy targets, managed services for difficult ones) is the most common production pattern.
  </Accordion>
</AccordionGroup>


# How to reduce web scraping costs
Source: https://docs.brightdata.com/scraping-automation/concepts/reducing-scraping-costs

Practical techniques to lower your web scraping costs, from choosing the right IP type to optimizing bandwidth and service plans. Achieves 10% success rate.

Your scraping pipeline works, but the monthly bill keeps climbing. Bandwidth charges, residential proxy usage, and server costs add up fast at scale.

Most of that spend is avoidable. This guide walks through practical techniques to cut costs at every layer: IP selection, request optimization, bandwidth reduction, and service plan structure.

<iframe title="How to save money on data collection" />

## Start with the cheapest IP type that works

The single biggest cost lever in web scraping is IP type. Datacenter IPs are significantly cheaper per gigabyte than residential or mobile IPs, yet many teams default to residential when datacenter would work fine.

Think of it like shipping: you don't overnight everything just because it's easier. You start with ground shipping and only upgrade when the delivery window demands it.

| IP type         | Relative cost | Best for                                                    |
| --------------- | ------------- | ----------------------------------------------------------- |
| **Datacenter**  | Lowest        | Sites without advanced anti-bot systems                     |
| **ISP**         | Medium        | Sites that need residential-grade trust at datacenter speed |
| **Residential** | Higher        | Sites with Cloudflare, Akamai, or PerimeterX protection     |
| **Mobile**      | Highest       | Heavily protected targets that block all other IP types     |

**Rule of thumb:** start with datacenter IPs. Only move up the cost ladder when you've confirmed they won't work for your target.

### How to test if a site works with datacenter IPs

Before writing any code, test manually in a browser:

1. Configure your browser (Firefox works well) to route traffic through a datacenter proxy with a single sticky session
2. Navigate to the target URL
3. If the page loads normally, datacenter IPs can work for this site

If it loads in a browser through a datacenter proxy, you can make it work in code too. The key is making your requests look exactly like the browser's.

### Making datacenter IPs work with headers and cookies

A bare HTTP request with no headers or cookies won't work on most sites, even with a clean datacenter IP. But adding the right headers and cookies often gets you to near-perfect success rates.

Here's a real example scraping an Amazon product page with datacenter IPs:

```javascript Node.js theme={null}
const axios = require("axios");

const TARGET_URL = "https://www.amazon.com/dp/B0EXAMPLE";

// Without headers/cookies: ~10% success rate
const bareRequest = await axios.get(TARGET_URL, {
  proxy: { host: "datacenter-proxy", port: 8080 },
});

// With headers and cookies: ~100% success rate
const optimizedRequest = await axios.get(TARGET_URL, {
  proxy: { host: "datacenter-proxy", port: 8080 },
  headers: {
    "User-Agent":
      "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/120.0.0.0 Safari/537.36",
    Accept:
      "text/html,application/xhtml+xml,application/xml;q=0.9,image/webp,*/*;q=0.8",
    "Accept-Language": "en-US,en;q=0.5",
    "Accept-Encoding": "gzip, deflate, br",
    Connection: "keep-alive",
    "Upgrade-Insecure-Requests": "1",
    Cookie: "session-id=123-4567890; i18n-prefs=USD; sp-cdn=L5Z9:US",
  },
});
```

The difference is dramatic: 10% success rate jumps to nearly 100% just by mimicking what a real browser sends.

**Where to find the right headers and cookies:**

1. Open the target site in a browser routed through your datacenter proxy
2. Open DevTools (F12) and go to the **Network** tab
3. Reload the page and click the main document request
4. Copy the **Request Headers** section
5. Use those exact headers in your scraping code

<Tip>
  Headers and cookies don't change often. You can automate the refresh by loading the target domain once in a headless browser, extracting cookies and headers, then reusing them for hundreds of HTTP client requests.
</Tip>

## Use a browser only when an HTTP client isn't enough

There are two ways to fetch a web page through a proxy:

* **HTTP client** (axios, Python `requests`, cURL): sends a single request and downloads just the HTML. Fast, lightweight, and cheap. Everything in the previous section uses this approach.
* **Browser automation** (Puppeteer, Playwright, Selenium): launches a full browser that renders JavaScript, loads images, stylesheets, and every other resource on the page. Much heavier on bandwidth.

Both go through your proxy. The difference is cost: an HTTP client downloads \~500 KB of HTML, while a browser loads 20+ MB of resources for the same page. Use this decision tree to pick the right approach:

```text theme={null}
Can an HTTP client (with headers/cookies) get the data?
├── Yes → Use an HTTP client (cheapest, fastest)
└── No → Does the site need JavaScript rendering?
    ├── Yes → Use browser automation
    └── No → Check if you're missing headers, cookies, or TLS fingerprint
```

When you do need a browser, use a real Chrome binary instead of Chromium. Anti-bot systems fingerprint browser builds, and Chromium screams "automation."

```javascript Node.js (Puppeteer) theme={null}
const puppeteer = require("puppeteer-extra");
const StealthPlugin = require("puppeteer-extra-plugin-stealth");

puppeteer.use(StealthPlugin());

const browser = await puppeteer.launch({
  executablePath: "/usr/bin/google-chrome", // Real Chrome, not Chromium
  headless: "new",
  args: ["--no-sandbox"],
});

const page = await browser.newPage();

// Set realistic headers
await page.setExtraHTTPHeaders({
  "Accept-Language": "en-US,en;q=0.9",
});

await page.goto("https://www.amazon.com/dp/B0EXAMPLE", {
  waitUntil: "domcontentloaded",
});
```

This swap alone can eliminate CAPTCHAs on many sites that would otherwise block your scraper.

<Note>
  If you don't want to manage browsers at all, [Bright Data Browser API](/scraping-automation/scraping-browser/introduction) runs real GUI browsers in the cloud with all anti-blocking built in. You connect via Puppeteer or Playwright and we handle the infrastructure.
</Note>

## Reduce bandwidth when using browsers

A single Amazon product page loads over 20 MB of resources. If you only need text data like titles, prices, and descriptions, most of that bandwidth is wasted money.

### Block unnecessary resource types

Intercept network requests and abort anything you don't need:

```javascript Node.js (Puppeteer) theme={null}
await page.setRequestInterception(true);

page.on("request", (request) => {
  const resourceType = request.resourceType();

  // Block images, stylesheets, fonts, and media
  if (["image", "stylesheet", "font", "media"].includes(resourceType)) {
    request.abort();
  } else {
    request.continue();
  }
});

await page.goto("https://www.amazon.com/dp/B0EXAMPLE");
```

Blocking images alone cuts page load bandwidth by 50% or more. Adding stylesheets and fonts to the block list reduces it further.

### Block requests by domain

Many pages load third-party scripts (analytics, social widgets, ad networks) that contribute nothing to the data you need:

```javascript Node.js (Puppeteer) theme={null}
const BLOCKED_DOMAINS = [
  "google-analytics.com",
  "facebook.net",
  "doubleclick.net",
  "adservice.google.com",
];

page.on("request", (request) => {
  const url = request.url();
  if (BLOCKED_DOMAINS.some((domain) => url.includes(domain))) {
    request.abort();
  } else {
    request.continue();
  }
});
```

<Warning>
  Test blocking carefully. Some JavaScript files are required for the page to render your target data. Start by blocking images and obvious third-party domains, then expand the block list incrementally. If the site breaks, step back.
</Warning>

### Stop loading once you have the data

You don't need to wait for the full page to finish loading. Wait for the specific elements you need, then stop:

```javascript Node.js (Puppeteer) theme={null}
await page.goto("https://www.amazon.com/dp/B0EXAMPLE", {
  waitUntil: "domcontentloaded", // Don't wait for all resources
});

// Wait only for the elements you need
await page.waitForSelector("#productTitle");
await page.waitForSelector(".a-price .a-offscreen");

// Extract data immediately
const title = await page.$eval("#productTitle", (el) => el.textContent.trim());
const price = await page.$eval(".a-price .a-offscreen", (el) =>
  el.textContent.trim()
);

// Close the page before remaining resources finish loading
await page.close();
```

This can reduce bandwidth from 20+ MB down to under 2 MB per page while still capturing everything you need.

## Navigate directly to the data

Every extra page navigation costs bandwidth and time. Build the shortest path to the data you need.

**Longer path (3 navigations):**

1. Search for "Xbox" on Amazon
2. Click on the first product result
3. Click "See all reviews"

**Shorter path (1 navigation):**
Navigate directly to `https://www.amazon.com/product-reviews/B0EXAMPLE` by substituting the product ID into the reviews URL.

Most sites have predictable URL patterns for product pages, review pages, and search results. Reverse-engineer the URL structure and skip the clicks entirely.

## Mix HTTP client and browser methods

Some sites require a browser session to generate authentication tokens, but the actual data pages work fine with an HTTP client. You can combine both approaches to get the best of each:

1. **Load one page in a headless browser** to collect session cookies and authentication tokens
2. **Extract the cookies** from the browser session
3. **Use those cookies with your HTTP client** for all subsequent pages

```javascript Node.js theme={null}
// Step 1: Get auth cookies from one browser session
const browser = await puppeteer.launch();
const page = await browser.newPage();
await page.goto("https://target-site.com/search?q=product");

// Step 2: Extract cookies
const cookies = await page.cookies();
const cookieString = cookies.map((c) => `${c.name}=${c.value}`).join("; ");
await browser.close();

// Step 3: Use cookies for fast HTTP requests (no browser needed)
const productUrls = [
  "https://target-site.com/product/123",
  "https://target-site.com/product/456",
  "https://target-site.com/product/789",
];

for (const url of productUrls) {
  const response = await axios.get(url, {
    headers: {
      Cookie: cookieString,
      "User-Agent": "Mozilla/5.0 ...",
    },
    proxy: { host: "datacenter-proxy", port: 8080 },
  });
  // Parse response.data
}
```

This pattern uses heavy browser bandwidth for a single page load, then switches to lightweight HTTP client requests for hundreds of data pages. At scale, the cost difference is significant.

## Choose the right data collection approach

Before optimizing individual requests, consider whether you should be building scrapers at all.

| Approach              | What you manage                                                             | Best for                                                            |
| --------------------- | --------------------------------------------------------------------------- | ------------------------------------------------------------------- |
| **In-house**          | Everything: proxies, unlocking, parsing, storage, servers, engineering team | Companies where data collection IS the core business                |
| **Hybrid**            | Parsing and storage; a service handles unlocking and IP rotation            | Teams that want control over data processing but not infrastructure |
| **Data as a service** | Analysis only; you buy structured data from a provider                      | Teams whose core business is analyzing data, not collecting it      |

**In-house** requires multiple engineering teams and ongoing infrastructure. Unless data collection is your core product, this approach is rarely cost-effective.

**Hybrid** removes the biggest time sink: fighting anti-bot systems. With [Bright Data Web Unlocker](/scraping-automation/web-unlocker/introduction), you send a URL and we return clean HTML. All five detection layers (IP rotation, TLS fingerprinting, browser fingerprinting, behavioral emulation, and CAPTCHA solving) are handled in a single API call. Your developers focus on parsing and data quality instead of reverse-engineering blocking mechanisms.

**Data as a service** eliminates the scraping pipeline entirely. [Bright Data Web Scraper API](/datasets/scrapers/scrapers-library/overview) provides 650+ pre-built scrapers that return structured JSON, no selectors, no proxy configuration, no maintenance. If your core business is machine learning, analytics, or market intelligence, this is often the biggest cost saver of all.

<Tip>
  Not sure which approach fits? See our detailed comparison in [Web Scraper API vs DIY scraping](/datasets/scrapers/concepts/web-scraper-api-vs-diy).
</Tip>

## Optimize your service plan

Technical optimizations reduce per-request costs. Service plan optimization reduces the price you pay for each gigabyte or request.

**Choose the right pricing model.** Some providers charge per gigabyte of bandwidth, others per request. A single browser-loaded product page can weigh 20+ MB of bandwidth but counts as one request. Compare both models against your actual usage pattern.

**Commit to a monthly plan.** Pay-as-you-go rates are the highest tier. Even a small monthly commitment can cut per-unit costs by 50% or more. If a large commitment feels risky, start smaller. The savings still outweigh pay-as-you-go.

**Consolidate with one provider.** Splitting volume across multiple providers means you get worse pricing from both. Bringing all your volume to one provider unlocks higher-tier discounts.

<Accordion title="Real-world example: consolidating providers">
  A company split traffic 50/50 between two proxy providers, paying a combined $31,000 per month. By moving 90% of traffic to a single provider (keeping 10% as backup), the total bill dropped to $24,000 per month. That's \$84,000 in annual savings from consolidation alone, with no code changes.
</Accordion>

## Cost optimization checklist

Use this checklist to audit your current scraping setup:

* [ ] Are you using datacenter IPs where possible, or defaulting to residential?
* [ ] Have you tested your target sites with datacenter IPs in a real browser?
* [ ] Are you sending proper headers and cookies with your HTTP client?
* [ ] If using a browser, are you blocking images and unnecessary resource types?
* [ ] Are you blocking third-party domains that don't contribute to your data?
* [ ] Are you stopping page loads once target elements are present?
* [ ] Are you navigating directly to data URLs instead of clicking through multiple pages?
* [ ] Can you use a browser for authentication and an HTTP client for data pages?
* [ ] Is your pricing model (bandwidth vs. per-request) optimal for your usage pattern?
* [ ] Are you on a monthly plan instead of pay-as-you-go?
* [ ] Have you consolidated proxy volume with a single provider for better tier pricing?

## Verify your optimizations

After applying these techniques, measure the impact:

1. **Compare bandwidth per request.** Log the response size before and after blocking resources. If you went from 20 MB to 5 MB per page, you've cut costs by 75%.
2. **Track success rates.** Send 10-20 test requests with your optimized headers and cookies. If success rate is below 90%, you're likely missing a required header or cookie.
3. **Monitor cost per record.** Divide your monthly proxy bill by the number of successful records collected. This is the metric that matters. Repeat after each optimization to confirm savings.

## Troubleshooting

**Datacenter IPs return CAPTCHAs or 403 errors even with headers and cookies.**
The site likely uses Cloudflare, Akamai, or a similar system that blocks all datacenter IP ranges. Switch to ISP or residential IPs, or use [Bright Data Web Unlocker](/scraping-automation/web-unlocker/introduction). We handle detection automatically so you don't have to debug it.

**Blocking resources breaks the page and target data is missing.**
You blocked a JavaScript file that the page needs to render the data. Roll back to the last working block list and re-add resources one type at a time. Always block images first (safest), then expand incrementally.

**Cookies expire and success rate drops after a few hours.**
Set up a cron job or scheduled task that loads the target domain in a headless browser, extracts fresh cookies, and stores them for your HTTP requests.

## FAQs

<AccordionGroup>
  <Accordion title="Which sites work with datacenter IPs?">
    Many sites work with datacenter IPs when you send proper headers and cookies. To test, route your browser through a datacenter proxy and try loading the target page. If it loads, you can make it work in code. Sites with Cloudflare, Akamai, or PerimeterX set to block all datacenter IPs will require residential or ISP proxies.
  </Accordion>

  <Accordion title="How much bandwidth does blocking images save?">
    Blocking images typically reduces page load bandwidth by 50% or more. A product page that transfers 20 MB with all resources may drop to 7-8 MB with images blocked. Adding stylesheet and font blocking reduces it further.
  </Accordion>

  <Accordion title="How often do I need to refresh headers and cookies?">
    Headers rarely change. Cookies may expire depending on the site, but most session cookies last hours or days. You can automate the refresh by loading the target domain in a browser periodically and extracting fresh cookies for your HTTP requests.
  </Accordion>

  <Accordion title="Should I use Puppeteer, Playwright, or Selenium?">
    All three have equivalent data collection capabilities. Choose based on your team's language preference: Puppeteer for Node.js, Playwright for Node.js/Python/Java/.NET, Selenium for Python/Java. The cost optimization techniques in this guide apply to all of them.
  </Accordion>

  <Accordion title="What if I don't want to manage any of this?">
    If maintaining scrapers isn't your core business, consider [Bright Data Web Scraper API](/datasets/scrapers/scrapers-library/overview). We maintain 650+ pre-built scrapers that return structured JSON. You get data without managing proxies, browsers, or anti-blocking. Pricing starts at \$1 per 1,000 records.
  </Accordion>
</AccordionGroup>

## Further reading

* [How Bright Data handles anti-bot blocking](/scraping-automation/concepts/how-bright-data-handles-blocking)
* [Web Scraper API vs DIY scraping](/datasets/scrapers/concepts/web-scraper-api-vs-diy)
* [Web Unlocker best practices](/scraping-automation/web-unlocker/bestpractices)
* [Understanding sync vs. async requests](/datasets/scrapers/concepts/sync-vs-async)


# Understanding asynchronous requests
Source: https://docs.brightdata.com/scraping-automation/concepts/understanding-async-requests

Compare async vs sync requests across 2 Bright Data APIs (Unlocker and SERP) and how each approach impacts performance, cost and architecture.

## What are asynchronous requests?

Asynchronous requests let you submit scraping jobs without waiting for results. You send a request, get back a unique ID immediately, and retrieve the completed results later, like leaving a voicemail instead of staying on hold.

With synchronous requests, your connection stays open until results arrive (typically seconds). With async, results are processed in the background and stored for 48 hours. You retrieve them via API polling or webhook notification when ready (typically 5 minutes, up to 8 hours during peak times).

## Why asynchronous requests matter

If you're scraping thousands of URLs daily, synchronous requests create a bottleneck. Here's the problem: tracking 10,000 product prices with sync requests means holding 10,000 open connections for 30 seconds each. That's 300,000 seconds of concurrent connection time, and your server will struggle or crash.

Async decouples data collection from processing. Submit 10,000 requests in under a minute, then batch-process results when they're ready. Your infrastructure stays lightweight, and you avoid connection timeouts, thread blocking, and cascading failures.

## When to use async vs sync

### Use async when you're:

* **Running scheduled jobs** (nightly competitor analysis, weekly rank tracking)
* **Scraping high volumes** (500+ requests per hour)
* **Building data pipelines** where freshness within minutes is acceptable
* **Optimizing costs** (async offers 99.99% success rate = fewer retries)

### Use sync when you're:

* **Serving live user requests** (displaying search results in real-time)
* **Processing small volumes** (\< 100 requests per hour where simplicity matters)
* **Prototyping** and need quick iteration
* **Requiring sub-10-second responses**

<Warning>
  Don't use async for user-facing features where people are actively waiting for results. The multi-minute latency will hurt UX.
</Warning>

**Real example:** An e-commerce platform uses async to scrape 50,000 competitor prices overnight for morning reports, but uses sync for their "check this product now" button that shoppers click.

## How it works

<img alt="how async request works" />

**Key difference:** You're billed for Step 1 (request submission) but not Step 2 (result retrieval). Results store for 48 hours.

When you poll before processing completes, you'll get a `202` status. Set up webhooks instead of polling to avoid wasted API calls:

```bash theme={null}
# Response includes your ID instantly
x-response-id: abc123-def456-ghi789
```

<Warning>
  **SERP API: Avoid excessive polling.** Unlike some APIs, each poll request is individually metered and consumes resources. Use webhooks for instant notifications, or poll no more than once per minute.
</Warning>

## What the tradeoffs are

| Feature                       | Async                          | Sync                    |
| ----------------------------- | ------------------------------ | ----------------------- |
| **Success rate**              | 99.99%                         | Standard                |
| **Latency**                   | 5 min - 8 hours                | Seconds                 |
| **Connection handling**       | No open connections            | Holds connections       |
| **Implementation complexity** | Requires webhook/polling logic | Simple request/response |
| **Result retrieval cost**     | Free                           | N/A                     |

<Info> **Cost is identical per request.** However, async's higher success rate means for large-scale operations. </Info>

## Common questions

<AccordionGroup>
  <Accordion title="Is async more expensive?">
    No. Pricing is identical per request, but higher success rates mean fewer retries.
  </Accordion>

  <Accordion title="How long are results stored?">
    Results are stored for 48 hours from submission, then automatically deleted. Make sure your retrieval system runs within this window.
  </Accordion>

  <Accordion title="How do I get notified when results are ready?">
    Configure a webhook URL in your zone settings or per-request using `webhook_url`. Bright Data POSTs a notification when processing completes.

    **Required: Allowlist webhook IPs**

    Make sure to allowlist these stable IPs or your firewall may block notifications:

    * `100.27.150.189`
    * `18.214.10.85`

    [Webhook setup guide →](/scraping-automation/serp-api/asynchronous-requests#allowlist-our-webhook-ips)
  </Accordion>

  <Accordion title="What if I lose my response ID?">
    Unrecoverable. Always store response IDs in your database alongside request metadata.
  </Accordion>

  <Accordion title="Can I use both async and sync?">
    Yes, but create separate zones, each zone is either async or sync, not both. Most users run async for batch jobs and sync for ad-hoc requests.
  </Accordion>
</AccordionGroup>


# Web access APIs
Source: https://docs.brightdata.com/scraping-automation/introduction

Bright Data Web Access APIs (1000+ scrapers) handle unblocking, crawling, dynamic content and SERP data collection with proxy rotation and CAPTCHA solving.

Bright Data’s **Web Access APIs** provide a reliable and scalable way to programmatically access the public web. They are designed for teams that need consistent results from websites that use blocking, rate limiting, or dynamic content.

Instead of managing proxies, retries, sessions, and anti-bot logic yourself, Web Access APIs handle these challenges automatically, allowing you to integrate web data collection directly into your applications, pipelines, or analytics workflows.

<div>
  <h2>Our products</h2>
</div>

<Card>
  <CardGroup>
    <Card title="Web Unlocker API" href="/scraping-automation/web-unlocker" icon="lock-open">
      The Web Unlocker API provides automated access to websites that actively block bots or non-human traffic. It dynamically manages IP rotation, browser fingerprints, sessions, and CAPTCHA solving to maintain reliable access across protected domains.
    </Card>

    <Card title="Search API" href="/scraping-automation/serp-api/" icon="magnifying-glass">
      The Search API delivers structured, real-time search engine data without manual scraping. It returns clean results such as rankings, organic links, advertisements, and other SERP elements.
    </Card>

    <Card title="Browser API" href="/scraping-automation/scraping-browser/" icon="window-restore">
      The Browser API enables data extraction from JavaScript-heavy and interactive websites by running scripts on remote, fully managed browsers. It includes built-in unblocking and session handling while allowing full control over browser actions.
    </Card>

    <Card title="Crawl API" href="/scraping-automation/crawl-api" icon="sitemap">
      The Crawl API is designed for fast, large-scale crawling across domains. It allows you to extract, map, and transform web content into structured, LLM-ready data.
    </Card>
  </CardGroup>
</Card>

## How Web Access APIs help

Web Access APIs automatically handle:

* Website blocking and rate limits
* IP rotation and session management
* Browser fingerprinting
* CAPTCHA and challenge resolution
* Scaling and retry logic

This ensures reliable data delivery even when target websites change their defenses.

## When to use Web Access APIs

Use Web Access APIs when you need:

* Programmatic access to web data
* Reliable results at scale
* Minimal infrastructure maintenance
* Integration with applications, pipelines, or AI systems

If you prefer a no-code approach, consider using **Easy Scraper** instead.

<Tip>
  Use the [Browser Extension](/proxy-networks/browser-extension/introduction) to manually control browsing sessions, test target sites, and change geo-location during development.
</Tip>

<Note>
  **Special Offer**

  [Start now](https://brightdata.com/?hs_signup=1\&utm_source=docs) with **5,000 free credits per month**. No credit card required. See the [free tier](/general/account/billing-and-pricing/free-tier).

  Bright Data will match your **first account deposit up to \$500**.
</Note>

<Info>
  For billing, account settings, and user access management, visit the\
  [Account Management](/api-reference/authentication#how-do-i-generate-a-new-api-key%3F) section.
</Info>

<Card title="Network status" icon="badge-check" href="https://brightdata.com/network-status">
  View real-time availability and operational status for all Bright Data services.
</Card>


# Run your first browser session
Source: https://docs.brightdata.com/scraping-automation/scraping-browser/five-minute-how-to

Launch your first Bright Data Browser API session in under 5 minutes with JavaScript rendering, page interaction and dynamic content, no infrastructure.

This guide helps you launch your **first real browser session in under 5 minutes** using the Bright Data Browser API.\
It is designed for developers who need **JavaScript rendering, page interaction, or dynamic content**, without managing browsers or infrastructure.

By the end of this guide, you will:

* Verify your Browser API setup
* Launch a live browser session
* Load a website that requires JavaScript rendering

## What you need before starting (1 minute)

Before you begin, make sure you have:

* A Bright Data account
* An active **Browser API zone**
* A valid **Browser API zone** \*\*credentials \*\*(Username and Password)

You can find your **credentials** in the **Overview** tab of your Browser API in the Bright Data Control Panel.

If you haven’t created a Browser API yet, follow **Create Your First Browser API** before continuing.

## Step 1: Choose a JavaScript-based website (30 seconds)

Select a website that requires JavaScript rendering.

Good examples:

* [https://quotes.toscrape.com/js/](https://quotes.toscrape.com/js/)
* [https://www.nike.com](https://www.nike.com)
* [https://www.amazon.com](https://www.amazon.com)

Make sure the URL:

* Starts with `https://`
* Requires client-side rendering or user-like interaction

## Step 2: Understand how the Browser API works (30 seconds)

The Browser API launches a **real, cloud-based browser session** on your behalf.

With each session, Bright Data:

* Launches a browser instance
* Applies realistic fingerprints and headers
* Handles proxy routing and anti-bot challenges
* Returns rendered page content or session output

You do not need to manage browsers, drivers, or automation infrastructure.

## Step 3: Start your first Browser API session (2 minutes)

Replace the placeholders below with your actual values:

* USER:PASS
* YOUR\_TARGET\_URL

Copy one of the example code snippets below and paste it into your IDE of choice.\
Simply run the code after replacing the parameters to start your session!

<Tabs>
  <Tab title="NodeJS">
    <CodeGroup>
      ```javascript Puppeteer theme={null}
      #!/usr/bin/env node
      const puppeteer = require('puppeteer-core');

      const AUTH = 'USER:PASS';
      const TARGET_URL = 'YOUR_TARGET_URL';

      async function main() {
          console.log('Connecting to Browser...');
          const browser = await puppeteer.connect({
              browserWSEndpoint: `wss://${AUTH}@brd.superproxy.io:9222`
          });

          const page = await browser.newPage();

          // Get debugging URL
          const client = await page.createCDPSession();
          const { frameTree: { frame } } = await client.send('Page.getFrameTree');
          const { url: inspectUrl } = await client.send('Page.inspect', {
              frameId: frame.id
          });
          console.log(`You can inspect this session at: ${inspectUrl}`);

          // Navigate to target
          await page.goto(TARGET_URL);

      	console.log(await page.content());
          await page.screenshot({ path: 'screenshot.png', fullPage: true });
          console.log('Navigation complete!');

          await browser.close();
      }

      main().catch(console.error);
      ```

      ```javascript Playwright theme={null}
      #!/usr/bin/env node
      const playwright = require('playwright');

      const AUTH = 'USER:PASS';
      const TARGET_URL = 'YOUR_TARGET_URL';

      async function main() {
          console.log('Connecting to Browser...');
          const browser = await playwright.chromium.connectOverCDP(
              `wss://${AUTH}@brd.superproxy.io:9222`
          );

          const page = await browser.newPage();

          // Get debugging URL
          const client = await page.context().newCDPSession(page);
          const { frameTree: { frame } } = await client.send('Page.getFrameTree');
              const { url: inspectUrl } = await client.send('Page.inspect', {
                  frameId: frame.id,
              });
          console.log(`You can inspect this session at: ${inspectUrl}.`);

          // Navigate to target
          await page.goto(TARGET_URL);

      	console.log(await page.content());
          await page.screenshot({ path: 'screenshot.png', fullPage: true });
          console.log('Navigation complete!');
          
          await browser.close();
      }

      main().catch(console.error);
      ```
    </CodeGroup>
  </Tab>

  <Tab title="Python">
    <CodeGroup>
      ```python Playwright theme={null}
      #!/usr/bin/env python3
      import asyncio
      from playwright.async_api import async_playwright

      AUTH = 'USER:PASS'
      TARGET_URL = 'YOUR_TARGET_URL'

      async def main():
          print('Connecting to Browser...')
          
          async with async_playwright() as p:
              browser = await p.chromium.connect_over_cdp(
                  f'wss://{AUTH}@brd.superproxy.io:9222'
              )
              page = await browser.new_page()
              
              # Get debugging URL
              client = await page.context.new_cdp_session(page)
              frame_tree = await client.send('Page.getFrameTree')
              frame_id = frame_tree['frameTree']['frame']['id']
              inspect_result = await client.send('Page.inspect', {'frameId': frame_id})
              print(f"Debug URL: {inspect_result['url']}")
              
              # Navigate to target
              await page.goto(TARGET_URL)

              print(await page.content())
              await page.screenshot(path='screenshot.png', full_page=True)
              print('Navigation complete!')
              
              await browser.close()

      if __name__ == '__main__':
          try:
              asyncio.run(main())
          except Exception as e:
              print(f'Error: {e}')
      ```

      ```python Selenium theme={null}
      #!/usr/bin/env python3
      from selenium.webdriver import Remote, ChromeOptions as Options
      from selenium.webdriver.chromium.remote_connection import ChromiumRemoteConnection as Connection

      AUTH = 'USER:PASS'
      TARGET_URL = 'YOUR_TARGET_URL'

      def main():
          print('Connecting to Browser...')
          
          server_addr = f'https://{AUTH}@brd.superproxy.io:9515'
          connection = Connection(server_addr, 'goog', 'chrome')
          driver = Remote(connection, options=Options())
          
          def cdp(cmd, params={}):
              return driver.execute('executeCdpCommand', {
                  'cmd': cmd,
                  'params': params,
              })['value']
          
          try:
              # Get debugging URL
              frame_tree = cdp('Page.getFrameTree')
              frame_id = frame_tree['frameTree']['frame']['id']
              inspect_result = cdp('Page.inspect', {'frameId': frame_id})
              print(f"Debug URL: {inspect_result['url']}")
              
              # Navigate to target
              driver.get(TARGET_URL)

              print(driver.page_source)
              driver.save_screenshot('screenshot.png')
              print('Navigation complete!')
          finally:
              driver.quit()

      if __name__ == '__main__':
          try:
              main()
          except Exception as e:
              print(f'Error: {e}')
      ```
    </CodeGroup>
  </Tab>
</Tabs>

This code:

* Connects to a remote browser session
* Prints the live session URL
* Fully renders the page using JavaScript
* Prints the HTML content of the page
* Takes a screenshot of the rendered page
* Closes the browser session

## Step 4: Review the response (30 seconds)

If successful, you will receive:

* Fully rendered HTML content + screenshot
* JavaScript-generated elements included

If the page content matches what you see in a real browser, your Browser API setup is working correctly.

## Common issues and quick fixes (30 seconds)

* **407 Auth Failed:** Authentication is missing or invalid\
  → Verify the Username and Password credentials
* **Invalid URL:** The desired URL is in incorrect format\
  → Confirm the TRAGET\_URL parameter was changed to a valid URL

## What you just accomplished

In under 5 minutes, you:

* Connected to a reomte headless browser session
* Loaded a JavaScript-heavy website
* Retrieved rendered content

Your Browser API is now ready for advanced workflows.

## Where to go next

Once your first session works, you can:

* Interact with pages (clicks, scrolling, inputs)
* Run multi-step browser workflows
* Review **Browser API Configuration** for advanced controls
* Check **Troubleshooting** if you encounter issues


# Introduction to Bright Data’s Browser API
Source: https://docs.brightdata.com/scraping-automation/scraping-browser/introduction

Learn how Bright Data's Browser API (60+ tools) enables large-scale browser-based data collection with automation, proxy management and built-in unblocking.

## Overview

Bright Data’s **Browser API** is designed for **browser-based data collection workflows** that require full page rendering, user-like interactions, and advanced unblocking capabilities.

As part of Bright Data’s **Unlocker Scraping Suite**, the Browser API allows you to run your scraping logic directly on **fully managed cloud browsers**, eliminating the need to maintain your own browser infrastructure, proxy networks, or anti-bot handling logic.

Instead of running browsers locally or managing complex proxy configurations, your code executes on Bright Data’s dedicated browser environment, automatically optimized to bypass modern anti-bot systems at scale.

## How the Browser API works

With the Browser API, your scraping scripts run inside **real, hosted browsers** that are pre-configured for high success rates and stability.

Behind the scenes, Bright Data handles:

* Automatic proxy rotation across multiple networks, including residential IPs
* Browser fingerprint management to emulate real-user behavior
* Custom headers and session handling
* CAPTCHA detection and solving
* Intelligent retries and session recovery

This allows you to focus entirely on **writing scraping logic**, while Bright Data manages the full browser execution and unblocking lifecycle.

## Supported browser automation frameworks

The Browser API integrates seamlessly with standard browser automation tools, including:

* **Puppeteer**
* **Playwright**
* **Selenium**

These integrations allow you to reuse existing scripts and tooling while instantly gaining access to scalable, production-ready browser infrastructure.

> See the full list of supported integrations in our [Integrations documentation](/integrations).

## Why use the Browser API

The Browser API is ideal when static HTTP requests are not enough and full browser interaction is required.

Use the Browser API when you need to:

* Navigate multi-step user flows
* Fill out forms and submit inputs
* Click buttons, links, and menus
* Scroll and load dynamically rendered content
* Interact with JavaScript-heavy websites
* Handle login flows and authenticated sessions
* Bypass advanced bot detection and CAPTCHAs

## Best suited for

The Browser API is best suited for:

* Websites that rely heavily on JavaScript rendering
* Complex workflows requiring real-user interactions
* Large-scale browser automation with unpredictable anti-bot behavior
* Teams without a scalable in-house browser and proxy infrastructure
* Teams that need built-in CAPTCHA solving without integrating or maintaining a separate solver
* Use cases requiring **unlimited concurrent browser sessions**

## How to get started

To get started with the Browser API, follow the **Quick Start** guide to create your Browser API zone and run your first automated browser session in minutes.


# Create your first Browser API
Source: https://docs.brightdata.com/scraping-automation/scraping-browser/quickstart

Set up your first Bright Data Browser API in the Control Panel in 5 steps, configure access credentials and run your first headless browser scraping job.

> Get started with Bright Data’s [Browser API](https://brightdata.com/products/scraping-browser) in just a few steps. This guide walks you through creating your Browser API zone so you can begin running browser-based scraping jobs right away.

<Callout icon="badge-dollar">
  **Verify your account and get \$5 credit**

  To activate API access, add a payment method to your Bright Data account.\
  This verification grants you **\$5 in free credit**, and you won’t be charged at this stage.
</Callout>

## What you’ll accomplish in this guide

By the end of this quick start, you will:

* Create your first **Browser API zone**
* Prepare your account for browser-based scraping
* Be ready to run automated browser sessions using Puppeteer, Playwright, or Selenium

No local browser setup or proxy configuration is required.

## How to set up step by step

<Steps>
  <Step title={<a href="https://brightdata.com/cp/start">Sign in to Bright Data</a>}>
    Log in to your Bright Data account using your credentials. If you don’t have an account yet, you’ll be prompted to create one before proceeding.
  </Step>

  <Step title={<>Navigate to the <a href="https://brightdata.com/cp/web_access/new">Create an API</a> page</>}>
    From the Bright Data Control Panel:

    **1.** Open the left-hand navigation menu\
    **2.** Select **Web Access APIs**\
    **3.** Click **Create API** to begin setting up a new API zone

    <Frame>
      <img alt="Create an API" />
    </Frame>
  </Step>

  <Step title="Choose Browser API">
    On the API selection screen, choose **Browser API**. This option enables full browser automation with built-in proxy management, fingerprinting, CAPTCHA handling, and unblocking logic.

    Click **Continue** to proceed.

    <Frame>
      <img alt="Create an API" />
    </Frame>
  </Step>

  <Step title="Assign a name to your Browser API">
    Enter a **clear and descriptive name** for your Browser API zone. This helps you identify the zone later, especially if you manage multiple APIs.

    You may also add an optional description for internal reference.

    <Warning>
      **The Browser API name cannot be changed once created.** You can modify all other settings later, including concurrency, geography, and browser options.

      For details, see [Configure your API](/scraping-automation/scraping-browser/configuration).
    </Warning>

    <Frame>
      <img alt="Create an API" />
    </Frame>
  </Step>

  <Step title="Finalize API creation">
    Review your configuration and click **Add API**. Your Browser API zone is now created and immediately available for use.

    <Frame>
      <img alt="Create an API" />
    </Frame>
  </Step>
</Steps>

## What’s next?

Once your Browser API is created, you can:

* Retrieve your **connection details** from the Overview tab
* Connect using **Puppeteer**, **Playwright**, or **Selenium**
* Start running automated browser sessions at scale

Continue to **Send Your First Browser Request** to launch your first browser session and verify everything is working correctly.

> To find navigation and other pages in this documentation, fetch the llms.txt file at: [https://docs.brightdata.com/llms.txt](https://docs.brightdata.com/llms.txt)


# SERP API async requests
Source: https://docs.brightdata.com/scraping-automation/serp-api/asynchronous-requests

Send async Bright Data SERP API (31 languages) and Web Unlocker API requests: compare with sync mode, learn when async is faster and configure async parameters.

<Note>
  Async is supported by both **Web Unlocker API** and **SERP API** products
</Note>

## Async VS Sync requests

There are 2 ways for us to handle your Web Unlocker API and SERP API requests:

* `default` **Synchronous requests** - Send a request and get a real-time response immediately
* **Asynchronous requests** - Send a request (without waiting for an immediate response) and retrieve the results later via our designated API endpoint. Callback times are usually up to 5 minutes but may take up to 8 hours during peak periods. Responses are stored for up to 48 hours from the time the request was sent.

<Tip>
  Async is recommended for those with high-volume requests who **don't** need to serve an immediate or live response and can wait a few minutes to retrieve all their responses at once.
</Tip>

### Why should I use Async?

* 99.99% success rate
* Stability
* Flexibility - the ability to retrieve your requests at a later time of your choosing (and not have to wait for the response immediately after sending the request)

### How it works

Sending requests and receiving responses with Async mode is a two-step flow:

* **Sending the request** - This request includes the search parameters, returns a `response_ID`, and is a direct request (i.e. you will be billed for this request).
* **Collecting the response** - This request includes the `response_ID` and is free of charge (i.e. you will not be billed for this request). If you call for a `response_ID` which is still being processed you will receive a 202 status code.

<Note>
  We store responses for up to 48 hours from the time the request was sent.
</Note>

### How to get started

<Steps>
  <Step title="Enable &#x22;Asynchronous requests&#x22;">
    Within your specific Web Unlocker API or SERP API [zone](https://brightdata.com/cp/zones), under "Advanced settings", enable the "Asynchronous requests" toggle. <img alt="Asynchronous requests toggle in the zone advanced settings" />
  </Step>

  <Step title="[Optional] Setting up a webhook (POST or GET)">
    This is where you will get notified on the status of your future requests

    <Note>
      A webhook can also be set **per** request (see "Initial request parameters" below)
    </Note>
  </Step>

  <Step title="Sending an async request">
    The request syntax is slightly different from that of synchronous requests and requires an [API key](/api-reference/authentication#how-do-i-generate-a-new-api-key%3F) for authentication. See a basic example below (for more request parameters see below):

    ```sh theme={null}
    curl -i --silent --compressed "https://api.brightdata.com/unblocker/req?customer=[ACCOUNT_ID]&zone=[zone_name]" \
      -H "Content-Type: application/json" \
      -H "Authorization: Bearer [API_KEY]" \
      -d '{"country":"us","query":{"q":"pizza","num":"100","hl":"en","gl":"au"}}'
    ```

    You'll receive a response to the above that contains an `x-response-id` header with the ID of your request. This is the `RESPONSE_ID` for this request which you will use when collecting your results in the next step.

    <Note>
      You can easily save the `RESPONSE_ID` in your script by initializing it along with your request like this:

      ```js theme={null}
      RESPONSE_ID=$(
      	curl -i --silent --compressed "[https://api.brightdata.com/unblocker/req?customer=[ACCOUNT_ID]&zone=[zone_name]](https://api.brightdata.com/unblocker/req?customer=%5BACCOUNT_ID%5D&zone=%5BZONE_NAME%5D)" -H "Content-Type: application/json" -H "Authorization: Bearer API_KEY" -d '{"country":"us","query":{"q":"pizza","num":"100","hl":"en","gl":"au"}}' | sed -En 's/^x-response-id: (.*)/\1/p' | tr -d '\r'
      )
      ```
    </Note>
  </Step>

  <Step title="Webhook notification">
    If you've set up a webhook, you'll receive a notification immediately when the requests are ready with the following parameters: `status`, `response_id`, `request_url` and `hook_data` (optional - if you've used the `webhook_data` parameter in your request).

    <Tip>
      ### Allowlist our webhook IPs

      Our asynchronous webhooks delivery sends notifications from a pair of stable IP addresses, so please make sure to allowlist them:

      1. `100.27.150.189`
      2. `18.214.10.85`
    </Tip>
  </Step>

  <Step title="Collecting your results">
    We recommend to wait 20 seconds prior to the first poling request to get the response, 10 seconds for the second pole and 5 for the rest.

    Bright Data may apply rate limit for excessive poling requests without response.

    To get the response, use the `RESPONSE_ID` received in step 3, send the following:

    ```sh theme={null}
    curl -i --silent --compressed "https://api.brightdata.com/unblocker/get_result?customer=[ACCOUNT_ID]&zone=[zone_name]&response_id=${[RESPONSE_ID]}" \
       -H "Authorization: Bearer [API_KEY]"
    ```
  </Step>
</Steps>

## API - Request creation - `POST /{unblocker|serp}/req`

```sh Example theme={null}
curl -i --silent --compressed "https://api.brightdata.com/unblocker/req?customer=[ACCOUNT_ID]&zone=[zone_name]" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer [API_KEY]" \
  -d '{"url":"https://example.com?foo=bar","country":"us"}'
```

### Parameters

<Warning>
  (\*) mandatory parameter
</Warning>

| Parameter       | Type             | Description                                                                                                                                                                      |
| --------------- | ---------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| url (\*)        | String           | Defines the url of the request                                                                                                                                                   |
| method          | String           | Defines the HTTP method of the request                                                                                                                                           |
| headers         | Object           | Defines headers to be used in the request                                                                                                                                        |
| body            | String or Object | Defines body to be sent with request. If an object is specified, it is serialized to JSON, and Content-Type header is set to application/json.                                   |
| country         | String           | Defines country to be used for request (2-letters code)                                                                                                                          |
| webhook\_url    | String           | Defines the URL to which the job status notification will be sent. If you don't want to setup a default webhook (above) or prefer the URL to be different per request, use this. |
| webhook\_method | String           | Defines the HTTP method to use with the webhook\_url (GET or POST)                                                                                                               |
| webhook\_data   | Any              | Defines the data that will be sent with job status notification                                                                                                                  |

### Which SERP-specific parameters to use

| Parameter  | Type        | Description                 |
| ---------- | ----------- | --------------------------- |
| query (\*) | Object      |                             |
| brd\_json  | 1 or "html" | Defines the response format |

```sh SERP Example theme={null}
curl -i --silent --compressed "https://api.brightdata.com/unblocker/req?customer=[ACCOUNT_ID]&zone=[zone_name]" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer [API_KEY]" \
  -d '{"country":"us","query":{"q":"pizza","num":"100","hl":"en","gl":"au"},"brd_json":"1"}'
```

## API - Response collection - `GET /{unblocker|serp}/get_result`

Note: `response_id` comes from the `x-response-id` header of the request creation response

```sh Example theme={null}
curl -k -v --compressed "https://api.brightdata.com/unblocker/get_result?customer={ACCOUNT_ID&zone={ASYNC_ZONE}&response_id={response_id}" \
  -H "Authorization: Bearer {API_Key}" \
  -o {Your_result_ouput_file}
```

### Parameters

<Warning>
  (\*) mandatory parameter
</Warning>

| Parameter         | Description                                                                         |
| ----------------- | ----------------------------------------------------------------------------------- |
| response\_id (\*) | Defines the job id. Received in the response headers of your initial async request. |


# SERP API configuration
Source: https://docs.brightdata.com/scraping-automation/serp-api/configuration

Configure the Bright Data SERP API (31 languages): choose JSON or raw HTML format, switch sync and async modes and enrich ad data with key request parameters.

## Default response format

When you configure your SERP API you can select between different defualt response format:

1. Raw HTML: no parsing at all. Get the HTML response as is.
2. Full JSON: our full interpertation of Google’s SERP HTML to JSON.
3. Light JSON: a subset of full JSON
4. Parsed Bing: our full interpertation of Bing’s SERP HTML to JSON.
5. Markdown: our full interpertation of Google’s and Bing’s SERP HTML to markdown `*.md` file.
6. Screenshot: an image capture of the SERP HTML page as interperted by a browser.

<Note>
  We have a known issue with screenshot default response format. To get screenshot you must use header: `x-unblock-data-format: screenshot` or screenshot will not be provided. Our teams work on this issue and expecting to resolve it soon.
</Note>

To read more on our response options and advanced response formats see: [https://docs.brightdata.com/scraping-automation/serp-api/parsed-json-results/parsing-search-results](/scraping-automation/serp-api/parsed-json-results/parsing-search-results)

## Enhanced Ads for Google

Bright Data provides a special setting which brings more google ads data. When this setting is switch on, API will respond with a larger more diverse range of search results and ads, mimicking an incognito browsing scenario without cookies.

Default setting (OFF) fetches both organic search results and ads, encompassing a broad geographical scope.

## How to configure advanced settings

### Custom Headers and Cookies

Bright Data enables you to send your custom headers and cookies. Once you do so, we will not override your settings and relay your requests to the search engine.

You can choose from a pre-approved list of headers and cookies or request a new one, and go thru approval process.

Once custom headers and cookies are selected Bright Data will charge you for **all** requests. When using the default setting without customized cookies, Bright Data charges for successful requests only.

### How to send asynchronous requests

You can work with Bright Data APIs using an asynchronous mode, where request is sent immediately, and you will be notified when response is ready. It usually takes few minutes for the response to be posted back.

For non real time application we recommend with Async mode to assure higher success rate.

When submitting asynchornic request, Bright Data handls it seamlessly in the background. You can either poll for the response or configure a webhook where we will notify on request complrtion. This allows you to collect responses at a later more convenient time via a designated endpoint, increasing stability, flexibility, and efficiency. [Learn more](/scraping-automation/serp-api/asynchronous-requests)

#### Webhook Configuration

Webhook has two configurable options:

1. Webhoom address URL
2. Webhook methos (get/post)

On your network you should add our Webhook agent origin IPs.

<Tip>
  ### Allowlist our webhook IPs

  Our asynchronous webhooks delivery sends notifications from a pair of stable IP addresses:

  1. `100.27.150.189`
  2. `18.214.10.85`

  Customers may need to allowlist these IPs on their side.
</Tip>


# SERP troubleshooting
Source: https://docs.brightdata.com/scraping-automation/serp-api/debugging

Troubleshoot Bright Data SERP API (31 languages) requests using the x-brd-debug response header to capture detailed request and response diagnostics.

## Debugging SERP API

Use the `x-brd-debug` response header to extract detailed debug information about your requests.

Activate by appending `-debug-full` to your proxy username:

```bash theme={null}
curl -vk \
  -x brd-customer-$CUSTOMER_ID-zone-$ZONE-debug-full:$PASSWORD@brd.superproxy.io:44445 \
  "https://www.google.com/search?q=bright+data"
```

The `x-brd-debug` response header will look like this:

```javascript theme={null}
req_id=hl_d09913c7_a1lw123bkcg; bytes_up=2842; bytes_down=562418; billed=false; destination_ip=162.219.225.118; used_req_headers=accept-language,accept; peer_ip=r868133f79d0c3fa9d7c7ccca0151af2e; peer_country=us; render=false
```

| Field              | Description                                                           |
| ------------------ | --------------------------------------------------------------------- |
| `req_id`           | Internal request ID - include in bug reports                          |
| `bytes_up`         | Outgoing traffic recorded while processing the request                |
| `bytes_down`       | Incoming traffic recorded while processing the request                |
| `billed`           | Whether the request is considered billable                            |
| `destination_ip`   | IP of the remote server used to fetch the data                        |
| `used_req_headers` | Custom headers relayed in the initial request                         |
| `peer_ip`          | Unique identifier for the IP used - useful for validating IP rotation |
| `peer_country`     | Country of the peer used for the request                              |
| `render`           | Whether the result is browser-rendered HTML or a raw HTTP response    |

## Common Error Codes

| Error             | Description                                                   |
| ----------------- | ------------------------------------------------------------- |
| `404`             | Invalid URL - likely broken or dead                           |
| `403`             | URL is valid but access is forbidden                          |
| `502`             | Most common SERP API error - see detail in `x-brd-error-code` |
| `407`             | Incorrect credentials (password or zone name)                 |
| `429`             | Rate limit / auto-throttle - contact support                  |
| `401` `411` `444` | Bad request - missing headers or cookies                      |
| `503`             | Service unavailable - browser check failed                    |

```http Example 429 response theme={null}
HTTP/1.1 429 The request was auto-throttled due to low success rate
x-brd-error-code: sr_rate_limit
x-brd-error: The request was auto-throttled due to low success rate
date: Tue, 23 Jan 2024 17:07:19 GMT
connection: keep-alive
```

## SERP API error catalog

Fast SERP runs inside the SERP API and shares its error codes. When a request fails, the error is returned in the `x-brd-error` and `x-brd-err-msg` response headers.

| `x-brd-error`    | `x-brd-err-msg`                                                                                     | Description                                                                                                                                                                                                                                                                                                                                                        |
| ---------------- | --------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| `query_rejected` | This query cannot be attempted at this time. Please try again later, after a minimum of 15 seconds. | In some cases the search engine flags a query as suspicious and blocks that query globally for roughly 15 seconds. To avoid wasted requests during this window, once Bright Data detects such a block, it bans the affected query for 15 seconds globally. Any attempt to send the query during that time returns this error. Retry after a minimum of 15 seconds. |

```http Example query_rejected response theme={null}
x-brd-error: query_rejected
x-brd-err-msg: This query cannot be attempted at this time. Please try again later, after a minimum of 15 seconds.
```

## How to detect query truncation

Google sometimes returns results for a shorter version of your query than the one you sent. For example, a search for `pizza in tlv` can return results for `pizza`. This behavior applies to both the SERP API and Fast SERP text (web) search. Compare `general.query` with `general.detected_query` in the parsed response, then check for a `spelling` object to tell a genuine spelling correction apart from a truncated search:

1. If `general.query` and `general.detected_query` match, Google searched exactly what you sent.
2. If they differ, check for a `spelling` object:
   * **`spelling` present** - Google auto-corrected the spelling and the results are valid for the corrected query.
   * **`spelling` absent** - Google truncated (cloaked) your query and the results are for a shorter version of what you searched.

The example below shows an auto-corrected query, where `detected_query` differs from `query` but a `spelling` object confirms the results are valid:

```text theme={null}
{
  "general": {
    "query": "pizaa",
    "detected_query": "pizza"
  },
  "spelling": {
    "original_text": "pizaa",
    "original_link": "https://www.google.com/search?q=pizaa&nfpr=1",
    "auto_corrected_text": "pizza",
    "auto_corrected_link": "https://www.google.com/search?q=pizza&spell=1"
  },
  "organic": [ ... ]
}
```

For the `general` and `spelling` field definitions, see [Parsed JSON results](/scraping-automation/serp-api/parsed-json-results/parsing-search-results) for the SERP API or [Fast SERP web search](/scraping-automation/serp-api/fast-serp/web-search) for Fast SERP.

## What happens when a query is blocked

When Bright Data detects that Google has flagged a query, that exact query is blocked across the SERP API and Fast SERP for 15 seconds. Any request for the same query during that window returns the `query_rejected` error. Retry the query after the 15-second window, or vary the query, to receive results. See [SERP API error catalog](#serp-api-error-catalog) for the full error response.

## Get Success Rate Statistics Per Domain

Retrieve SERP API success rate stats from the past 7 days. Supports single domain or wildcard.

```bash Single domain theme={null}
curl "https://api.brightdata.com/unblocker/success_rate/google.com" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $API_KEY"
```

```bash All monitored TLDs theme={null}
curl "https://api.brightdata.com/unblocker/success_rate/google.*" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $API_KEY"
```

<Warning>
  Once you provide your API key, replace all `$API_KEY`, `$CUSTOMER_ID`, `$ZONE`, and `$PASSWORD` placeholders accordingly.
</Warning>


# SERP API FAQs
Source: https://docs.brightdata.com/scraping-automation/serp-api/faqs

FAQs about the Bright Data SERP API (31 languages): setup, troubleshooting, Google Image and Hotels scraping and advanced search techniques.

<AccordionGroup>
  <Accordion title="Why should I use Bright Data's SERP API?">
    The Bright Data SERP API solution allows you to focus on what matters most, the data. It provides you with a 3-in-1 proxy unlocking solution that autonomously takes care of the **proxy management** (which proxy to use and when), **unlocking logic** (captcha solving, fingerprinting, retries, best headers, etc), and **scraping** functionality. 

    <Tab title="Easy to integrate">
      In your code its as easy as swapping out the 1 line of your regular proxy network request with this 1 line SERP API request
    </Tab>

    <Tab title="Pay only for success">
      You only pay for successful requests.
    </Tab>

    <Tab title="Stable and predictable Billing">
      Because pricing is done according to number of pages (price per 1k requests), the bandwidth of your request doesn't matter.
    </Tab>

    <Tab title="Accuracy">
      Use real user devices with laser-focused geotargeting (including city-level) to collect accurate Search Engine Result Pages (SERPs) from major search engines as a real user.
    </Tab>

    <Tab title="Built for volume and scale">
      Bright Data can support your growing traffic needs and peak periods with high success rates and exceptional response time (under 5 seconds), regardless of your request volume.
    </Tab>

    <Tab title="Reduce costs">
      Save money on data extraction engineers and IT professionals, without worrying about server maintenance.
    </Tab>

    <Tab title="Avoid operational headaches">
      Each request is sent from a different IP ensuring no IP is flagged or banned.
    </Tab>

    <Tab title="Structured data response">
      Get parsed or unparsed responses in JSON or HTML format for easy integration with any system.
    </Tab>

    <Tab title="Highly customized">
      Bright Data supports a wide variety of tailored parameters to answer your search requirements including different search types, different devices, results per page, etc.
    </Tab>

    <Tab title="Real Residential IPs">
      Access 400M+ monthly residential IPs in all geolocations.
    </Tab>
  </Accordion>

  <Accordion title="How to use SERP API for &#x22;Google Search By Image&#x22;?">
    With Bright Data’s SERP API, it’s easy to collect Google Search by Image data.

    Google reverse image search (officially "Google Search by Image"), is a service provided by Google that allows users to search for images **using an image as the starting point**, rather than a written or spoken search query.

    <Note>
      The JSON response includes the image in base64 encoding.
    </Note>

    <CodeGroup>
      ```sh Search by image URL theme={null}
      curl -v --compressed --proxy brd.superproxy.io:44445 --proxy-user brd-customer-<customer_id>-zone-<zone_name>:<zone_password> "https://www.google.com/searchbyimage?image_url={TARGET_IMAGE_URL}"
      ```

      ```sh Search by an image stored locally theme={null}
      curl -v --compressed --proxy brd.superproxy.io:44445 --proxy-user brd-customer-<customer_id>-zone-<zone_name>:<zone_password> 'http://www.google.com/searchbyimage/upload' -o results_page.html -F 'encoded_image=@{FULL_IMAGE_FILE_PATH}'
      ```
    </CodeGroup>

    See the rest of our [Google Image SERP features.](/scraping-automation/serp-api/query-parameters/google#lens)
  </Accordion>

  <Accordion title="How to collect hotel data with SERP API?">
    Bright Data's SERP API makes it easy to collect hotel data, like prices, availability, reviews, and more.

    **There are two ways to collect hotel data:**

    <Tabs>
      <Tab title="Google Search Hotel Knowledge">
        **Provides limited info per specific hotel on pricing and dates**

        When you search for a specific hotel using Google Search, its details and reviews appear in the knowledge graph/widget that you can see on the right side below:

        <img alt="hotels-html.png" />

        You can set arrival and departure dates, the number of guests, and compare pricing..

        With SERP API, you can set these fields to collect different price combinations using dedicated parameters. See the full set of hotel parameters and features within our [API documentation](/scraping-automation/serp-api/parsed-json-results/parsing-search-results#hotels).

        <img alt="hotels-availability.png" />
      </Tab>

      <Tab title="Google Travel Hotel page">
        **Provides full details on hotels, pricing, and dates**

        SERP API also lets you target the hotel page in Google Travel (Google.\*/travel/hotels/…), where you can find more prices and search by additional parameters (including arrival and departure dates, the number of adults and children, the children’s ages, and whether or not it has free cancellation) to collect more price combinations.

        <Note>
          Only //Google.\*/travel/hotels/… URLs are supported.
        </Note>

        Go to the control panel [API Guide](https://brightdata.com/cp/serp_api/api/google/hotels) for an explanation of how to target this page and the dedicated parameters you can use or see our [API documentation](/scraping-automation/serp-api/parsed-json-results/parsing-search-results#hotels).

        <img alt="hotel-info.png" />
      </Tab>
    </Tabs>
  </Accordion>

  <Accordion title="How to send SERP API HTTPS requests without SSL Certificate?">
    When targeting HTTPS, URL data is encrypted. Therefore, for SERP API to decrypt the data and return the result, you will need to download and install the [Bright Data Certificate]().

    Here are sample code on how to send HTTPS requests:

    <CodeGroup>
      ```sh Shell theme={null}
      curl "https://www.google.com/search?q=pizza&lum_json=1" -v --insecure --compressed --proxy brd.superproxy.io:44445 --proxy-user brd-customer-<customer_id>-zone-<zone_name>:<zone_password>
      ```

      ```js NodeJS theme={null}
      process.env.NODE_TLS_REJECT_UNAUTHORIZED = 0;
      ```

      ```java Java theme={null}
      -Dcom.sun.net.ssl.checkRevocation=false
      ```

      ```cs C# theme={null}
      ServicePointManager.ServerCertificateValidationCallback += (sender, cert, chain, sslPolicyErrors) => true;
      ```

      ```python Python theme={null}
      # for native `request` library:
      import ssl
      ssl._create_default_https_context = ssl._create_unverified_context

      # for `requests` library, disable the ssl check directly in the .get() method:
      # requests.get(url, proxies=proxies, verify=False)
      ```
    </CodeGroup>
  </Accordion>

  <Accordion title="How to sending HTTPS requests with SSL validation?">
    <Tabs>
      <Tab title="Shell">
        Use the `cacert` flag followed by the certificate file path:

        ```sh Shell theme={null}
        curl -v --compressed "https://www.google.com/search?q=pizza&lum_json=1" --cacert “{cert file path}“ --proxy brd.superproxy.io:44445 --proxy-user brd-customer-<customer_id>-zone-<zone_name>:<zone_password>
        ```
      </Tab>

      <Tab title="Java">
        Please import the certificate to the Java Keystore. Here's an example using Java keytool to import the certificate:

        <CodeGroup>
          ```java Java theme={null}
          %JAVA_HOME% Keystore (mostly the cacerts file in ..\lib\security\).
          ```

          ```sh Keytool Command Example theme={null}
          keytool -import -alias <cert alias> -file <cert name>.cer -keystore <keystore filename> -storepass <keystore password>

          # After running the keytool command you will be prompted to trust the certificate: answer ‘y’
          ```
        </CodeGroup>
      </Tab>

      <Tab title="Other Programming Languages">
        Follow the instructions in the following article on [how to download and Install the Bright Data certificate](/general/account/ssl-certificate) to your local machine's Trusted Root Certification Authorities.

        ```sh Shell theme={null}
        T_ID&zone={ASYNC_ZONE}&output={output_fomat_html/json}&response_id={response_id} -H "Authorization: Bearer {API_KEY}" -o {Your_result_ouput_file}
        ```
      </Tab>
    </Tabs>
  </Accordion>

  <Accordion title="How to parse JSON with SERP API?">
    Please refer to this article: [Parsing Search Results](/scraping-automation/serp-api/parsed-json-results/parsing-search-results)
  </Accordion>

  <Accordion title="How to send multiple queries in an identical API request? (DEPRECATED)">
    <Warning>
      This parameter will is deprecated since 7-December-2025 and no longer supported. Requests with multi parameter will be returned with only one response back (the first)
    </Warning>

    SERP API supports sending 2 parallel query requests with one API request using the `multi` parameter.

    These parallel requests use the same peer IP and session and can be used for collecting additional data, comparison tests, etc. - e.g., making a pair of requests with different parameters/values. They use the same IP and session.

    <Note>
      **Conditions:**

      * Supported only for a zone with [asynchronous requests](/scraping-automation/serp-api/asynchronous-requests) enabled
      * Supported only for Google Search
      * Limited to 2 requests
      * Billed as 2 requests
    </Note>

    **Use Case:**

    <CodeGroup>
      ```json Different num parameter theme={null}
      multi:[
        {
          "keyword": "pizza",
          "num": 20
        },
        {
          "keyword": "pizza",
          "num": 100
        }
      ]

      ```

      ```json Different keyword theme={null}
      multi:[
        {
          "keyword": "pizza"
        },
        {
          "keyword": "burger"
        }
      ]
      ```
    </CodeGroup>

    **Sample Code:**

    <CodeGroup>
      ```sh Send request theme={null}
      curl -v --compressed "https://api.brightdata.com/serp/req" -H "Content-Type: application/json" -H "Authorization: Bearer $API_KEY" -d "{\"zone\":\"$ZONE\",\"country\":\"us\",\"multi\":[{\"keyword\":\"pizza\",\"num\":20},{\"keyword\":\"pizza\",\"num\":100}]}"
      ```

      ```sh Collect respone theme={null}
      # Collect the result 
      # use the response ID from the `x-response-id` returned above to collect the result

      curl -k -v --compressed "https://api.brightdata.com/serp/get_result?customer={customer_id&zone={ASYNC_ZONE}&response_id={response_id}" -H "Authorization: Bearer $API_KEY" -o {Your_result_ouput_file}
      ```
    </CodeGroup>
  </Accordion>

  <Accordion title="I saw that Google recently stopped supporting the `num` parameter in requests. Are you working on an alternative solution?">
    Indeed, as of September 10, 2025, Google has started phasing out the `num` parameter feature.

    Due to this change, we recommend that customers requiring additional Google SERP pages (beyond the first) transition to use Bright Data’s Scrapers endpoint (Google SERP – 100 Results) to get positions 1–100 in a single call, no manual pagination, while controlling depth with start\_page/end\_page (1..10 ≈ Top 100).

    Learn more on how to [get top 100 results in 1 call](/scraping-automation/serp-api/get-top-100-google-results).
  </Accordion>

  <Accordion title="What are common use cases for SERP API?">
    <Tab title="Organic Keyword Tracking">
      Mapping a company's ranking for various keywords in different locations
    </Tab>

    <Tab title="Brand Protection">
      Track top results for company brands and trademarks
    </Tab>

    <Tab title="Price Comparison">
      Search for products on online shopping websites and compare prices between different vendors
    </Tab>

    <Tab title="Market Research">
      Collect information about companies, contacts, locations, and more
    </Tab>

    <Tab title="Detect Copyright Infringements">
      Search for images or other copyright-protected content
    </Tab>

    <Tab title="Ad Intelligence">
      See which ads are showing for keywords in different countries, including double-click & Google ad services
    </Tab>
  </Accordion>

  <Accordion title="How to query Microsoft Bing with dates filter?">
    In the following article, we will analyze the different options for date-specific search queries on Bing and how to use them effectively

    ## Types of Date Filter Queries

    <Tabs>
      <Tab title="All dates">
        No date filter applied

        * URL: [https://www.bing.com/search?q=YOUR\_QUERY](https://www.bing.com/search?q=YOUR_QUERY)
      </Tab>

      <Tab title="Past 24 hours">
        Add `filters=ex1%3a"ez1"` to the URL

        * URL: [https://www.bing.com/search?q=YOUR\_QUERY\&filters=ex1%3a"ez1](https://www.bing.com/search?q=YOUR_QUERY\&filters=ex1%3a"ez1)"
      </Tab>

      <Tab title="Past week">
        Add `filters=ex1%3a"ez2"` to the URL

        * URL: [https://www.bing.com/search?q=YOUR\_QUERY\&filters=ex1%3a"ez2](https://www.bing.com/search?q=YOUR_QUERY\&filters=ex1%3a"ez2)"
      </Tab>

      <Tab title="Past year">
        Add `filters=ex1%3a"ez3"` to the URL

        * URL: [https://www.bing.com/search?q=YOUR\_QUERY\&filters=ex1%3a"ez3](https://www.bing.com/search?q=YOUR_QUERY\&filters=ex1%3a"ez3)"
      </Tab>

      <Tab title="Exact Match">
        Specify the exact date range by adding `filters=ex1:"ez5_StartDateSequence_EndDateSequence”` to the URL

        * URL: [https://www.bing.com/search?q=YOUR\_QUERY\&filters=ex1:"ez5\_StartDateSequence\_EndDateSequence”](https://www.bing.com/search?q=YOUR_QUERY\&filters=ex1:"ez5_StartDateSequence_EndDateSequence”)

        <Tip>
          `StartDateSequence` and `EndDateSequence` can be calculated using the logic below.
        </Tip>
      </Tab>
    </Tabs>

    ***

    ## Determining the Sequence String for “Exact Match” Query

    To perform an Exact match date search, you need to calculate the sequence string for your desired date range. Follow these steps to determine the sequence string.

    <Steps>
      <Step title="Use known sequence as a “Starting Point”">
        Use January 1, 2024 as the starting point with known sequence: `19723`
      </Step>

      <Step title="Calculate StartDateSequence">
        * Count the days from January 1 to your desired starting date.
        * Add the number of days counted to the sequence number of January 1 to get the `StartDateSequence`.
          <Tip>
            Counting starts from “**0**”. e.g. 0, 1, 2, 3 ...
          </Tip>

        > #### Example:
        >
        > To calculate the sequence number for February 4, 2024:
        >
        > * Total days from January 1 to February 4: 35 days
        > * 35 - 1 (counting starts at “0”) = 34
        > * February 4, 2024: 19723 (Jan1) + 34 = 19757 (`StartDateSequence`)
      </Step>

      <Step title="Calculate EndDateSequence">
        Add the number of days in your date range to the `StartDateSequence` to get the `EndDateSequence`.

        > #### Example:
        >
        > To calculate the sequence number for February 20, 2024:
        >
        > * February 4, 2024: 19757
        > * Days from February 4 to February 20: 17 days
        > * 17 - 1 (counting starts at “0”) = 16
        > * February 20, 2024: 19757 + 16 = 19773 (`EndDateSequence`)
      </Step>

      <Step title="Form the Sequence String">
        * Use the format `ez5_StartDateSequence_EndDateSequence`
        * Replace `StartDateSequence` with the sequence number calculated above for the starting date.
        * Replace `EndDateSequence` with the sequence number calculated above for the ending date.

        > #### Example: For February 4, 2024, to February 20, 2024:
        >
        > * Calculated `StartDateSequence`: 19757
        > * Calculated `EndDateSequence`: 19773
        > * Sequence string: `ez5_19757_19773`
        > * URL for query `pizza`: \
        >   [https://www.bing.com/search?q=pizza\&filters=ex1:"ez5\_19757\_19773](https://www.bing.com/search?q=pizza\&filters=ex1:"ez5_19757_19773)"

        <Frame>
          <img alt="bing-exact-date-filter.png" />
        </Frame>
      </Step>
    </Steps>

    With the above, you can construct URLs to query Bing for any specific date range.
  </Accordion>

  <Accordion title="Why am I getting the error: &#x22;400 this endpoint is not supported&#x22;?">
    SERP API supports a select number of generic domains/endpoints related to search engines, some specific subdomains or endpoints, may not be supported -  example: `https://trends.google.com/trends` Is not supported while `https://trends.google.com/trends/explore` Is supported.

    To see a list of working examples of domains and paths that are supported, we highly recommend that you check the [SERP Playground](https://brightdata.com/cp/zones/serp_playground) and the [SERP Documentation](/scraping-automation/serp-api/query-parameters).
  </Accordion>

  <Accordion title="How can I get faster SERP API response times?">
    Use `"data_format": "parsed_light"` for [faster top 10 results](/scraping-automation/serp-api/introduction#get-only-top-10-results-faster-response), or contact [sales@brightdata.com](mailto:sales@brightdata.com) for [sub-1-second premium routing](/scraping-automation/serp-api/introduction#sub-1-second-response-time).
  </Accordion>
</AccordionGroup>


# Fast SERP images search
Source: https://docs.brightdata.com/scraping-automation/serp-api/fast-serp/images-search

Use Bright Data Fast SERP (31 languages) for Google Images via the native proxy interface. Receive compact JSON image results suited for real-time applications.

Bright Data offers a fast SERP service for Images. This service responds with a compact JSON to power real-time applications that need image search results. To gain access, please contact your Bright Data account manager.

## Fast Images Search Request

Fast SERP for Google Images works best with the native proxy interface. If you need a REST API interface for your architecture, one can be provided.

Both the `x-unblock-data-format: parsed_light` request header and the `brd_json=1` URL parameter are required. Omitting either will result in an unexpected response format.

### Native proxy request

```text theme={null}
curl -i --proxy fserp.brd.superproxy.io:44445 \
  --proxy-user brd-customer-<CUSTOMER>-zone-<ZONE>:<PASSWORD> \
  -k \
  -H 'x-unblock-data-format: parsed_light' \
  "https://www.google.com/search?q=pizza&udm=2&brd_json=1"
```

## Response Format

A successful response contains a single required `images` array.

### `images` array

| Field             | Type    | Required | Description                                      |
| ----------------- | ------- | -------- | ------------------------------------------------ |
| `global_rank`     | integer | Yes      | Rank position of the result on the page          |
| `title`           | string  | No       | Title or alt text of the image                   |
| `link`            | string  | No       | URL of the source page where the image was found |
| `image`           | string  | No       | Thumbnail image URL                              |
| `original_image`  | string  | No       | Full-resolution image URL                        |
| `image_width`     | integer | No       | Displayed image width in pixels                  |
| `image_height`    | integer | No       | Displayed image height in pixels                 |
| `original_width`  | integer | No       | Original image width in pixels                   |
| `original_height` | integer | No       | Original image height in pixels                  |
| `blurred`         | boolean | No       | Whether the image is blurred                     |

## Example Response

```text theme={null}
{
  "images": [
    {
      "global_rank": 1,
      "title": "Classic Margherita Pizza",
      "link": "https://www.example-recipe.com/margherita",
      "image": "https://www.example-recipe.com/images/margherita-thumb.jpg",
      "original_image": "https://www.example-recipe.com/images/margherita-full.jpg",
      "image_width": 400,
      "image_height": 300,
      "original_width": 1200,
      "original_height": 900,
      "blurred": false
    },
    {
      "global_rank": 2,
      "title": "Neapolitan Pizza with Fresh Basil",
      "link": "https://www.example-food.com/neapolitan",
      "image": "https://www.example-food.com/images/neapolitan-thumb.jpg",
      "original_image": "https://www.example-food.com/images/neapolitan-full.jpg",
      "image_width": 400,
      "image_height": 300,
      "original_width": 1600,
      "original_height": 1200,
      "blurred": false
    },
    {
      "global_rank": 3,
      "title": "New York Style Pizza Slice",
      "link": "https://www.example-pizza.com/ny-style",
      "image": "https://www.example-pizza.com/images/ny-slice-thumb.jpg",
      "original_image": "https://www.example-pizza.com/images/ny-slice-full.jpg",
      "image_width": 400,
      "image_height": 267,
      "original_width": 2000,
      "original_height": 1333,
      "blurred": false
    },
    {
      "global_rank": 4,
      "title": "Homemade Deep Dish Chicago Pizza",
      "link": "https://www.example-recipe.com/deep-dish",
      "image": "https://www.example-recipe.com/images/deep-dish-thumb.jpg",
      "original_image": "https://www.example-recipe.com/images/deep-dish-full.jpg",
      "image_width": 400,
      "image_height": 400,
      "original_width": 1500,
      "original_height": 1500,
      "blurred": false
    },
    {
      "global_rank": 5,
      "title": "Wood-Fired Pizza from Naples",
      "link": "https://www.example-travel.com/naples-pizza",
      "image": "https://www.example-travel.com/images/naples-pizza-thumb.jpg",
      "original_image": "https://www.example-travel.com/images/naples-pizza-full.jpg",
      "image_width": 400,
      "image_height": 267,
      "original_width": 3000,
      "original_height": 2000,
      "blurred": false
    }
  ]
}
```

Response schema: [https://api.brightdata.com/data\_schemas/fast\_serp/google\_search\_images.schema.json](https://api.brightdata.com/data_schemas/fast_serp/google_search_images.schema.json)

## Supported parameters

| Parameter  | Description                                | Example      | Notes                                                                             |
| ---------- | ------------------------------------------ | ------------ | --------------------------------------------------------------------------------- |
| `q`        | Search query (**must be first in URL**)    | `q=pizza`    | Query size must be under 8,000 charachters. <br />Longer queries fail with error. |
| `gl`       | Two-letter country code for search country | `gl=us`      |                                                                                   |
| `hl`       | Two-letter language code for page language | `hl=en`      |                                                                                   |
| `brd_json` | **Required.**`1` = parsed JSON             | `brd_json=1` |                                                                                   |


# Fast SERP maps search
Source: https://docs.brightdata.com/scraping-automation/serp-api/fast-serp/maps-search

Use Bright Data Fast SERP (31 languages) for Google Maps via the native proxy interface. Receive compact JSON Maps results suited for real-time applications.

Use Bright Data's Fast SERP service to retrieve compact Maps search results in real time via a native proxy interface.

## Google Maps endpoints

Google Maps Fast SERP supports two response types depending on the URL you target:

* **Maps search results**, a list of places matching a search query, returning an `organic` array
* **Place detail page**, a single place record, returning a `place` object

Both endpoints require the `x-unblock-data-format: parsed_light` request header and the `brd_json=1` URL parameter. Omitting either will result in an unexpected response format.

## Fast Maps Search Request

Fast SERP for Google Maps works best with the native proxy interface. If you need a REST API interface for your architecture, one can be provided.

### Maps search results

```text theme={null}
curl -v --proxy fserp.brd.superproxy.io:44445 \
  --proxy-user username:password \
  -k \
  -H 'x-unblock-data-format: parsed_light' \
  "https://www.google.com/maps/search/coffee+shops+new+york/?hl=en&gl=us&brd_json=1"
```

### Place detail page: using Place ID

```text theme={null}
curl -v --proxy fserp.brd.superproxy.io:44445 \
  --proxy-user username:password \
  -k \
  -H 'x-unblock-data-format: parsed_light' \
  "https://www.google.com/maps/place/?q=place_id:ChIJN1t_tDeuEmsRUsoyG83frY4&hl=en&gl=us&brd_json=1"
```

### Place details page: using Map Link

```text theme={null}
curl -v --proxy fserp.brd.superproxy.io:44445 \
  --proxy-user username:password \
  -k \
  -H 'x-unblock-data-format: parsed_light' \
  "https://www.google.com/maps/place/data=!3m1!4b1!4m2!3m1!1s0x89e379c3784bfe3b:0x839c689710299cfc?hl=en&gl=us&brd_json=1"
```

## Response Format

The response is one of two shapes depending on the targeted URL: a search results page returns an `organic` array; a place detail page returns a `place` object. Both use the same `OrganicMapsItem` structure.

### `organic` array / `place` object

Both the items in `organic` and the `place` object share the following fields:

| Field            | Type    | Required | Description                                            |
| ---------------- | ------- | -------- | ------------------------------------------------------ |
| `global_rank`    | integer | Yes      | Rank position of the result on the page                |
| `title`          | string  | No       | Name of the place                                      |
| `address`        | string  | No       | Full address of the place                              |
| `phone`          | string  | No       | Phone number of the place                              |
| `link`           | string  | No       | URL to the place's website                             |
| `map_link`       | string  | No       | URL to the place on Google Maps                        |
| `map_id`         | string  | No       | Google Maps place identifier                           |
| `map_id_encoded` | string  | No       | Encoded version of the Google Maps place identifier    |
| `description`    | string  | No       | Short description of the place                         |
| `price`          | string  | No       | Price range indicator, e.g. `"$$"`                     |
| `rating`         | number  | No       | Average customer rating                                |
| `reviews_cnt`    | number  | No       | Total number of customer reviews                       |
| `latitude`       | number  | No       | Latitude coordinate of the place                       |
| `longitude`      | number  | No       | Longitude coordinate of the place                      |
| `image`          | string  | No       | Primary image URL                                      |
| `original_image` | string  | No       | Original full-resolution image URL                     |
| `thumbnail`      | string  | No       | Thumbnail image URL                                    |
| `open_hours`     | object  | No       | Opening hours keyed by day, e.g. `"Monday": "9am–5pm"` |
| `category`       | array   | No       | List of place categories (see below)                   |
| `images`         | array   | No       | List of place images (see below)                       |
| `menu_images`    | array   | No       | List of menu images (see below)                        |
| `tags`           | array   | No       | List of place attribute tags (see below)               |
| `reviews`        | array   | No       | List of customer reviews (see below)                   |

### `category` items

| Field         | Type   | Required | Description             |
| ------------- | ------ | -------- | ----------------------- |
| `id`          | string | Yes      | Category identifier     |
| `title`       | string | Yes      | Full category name      |
| `title_short` | string | No       | Shortened category name |

### `images` and `menu_images` items

| Field             | Type    | Required | Description                      |
| ----------------- | ------- | -------- | -------------------------------- |
| `image`           | string  | Yes      | Image URL                        |
| `image_width`     | integer | No       | Displayed image width in pixels  |
| `image_height`    | integer | No       | Displayed image height in pixels |
| `original_width`  | integer | No       | Original image width in pixels   |
| `original_height` | integer | No       | Original image height in pixels  |

### `tags` items

| Field               | Type   | Required | Description                               |
| ------------------- | ------ | -------- | ----------------------------------------- |
| `group_id`          | string | Yes      | Identifier of the tag group               |
| `group_title`       | string | Yes      | Display name of the tag group             |
| `key_id`            | string | Yes      | Identifier of the tag key                 |
| `key_title`         | string | Yes      | Display name of the tag key               |
| `value`             | number | No       | Numeric value associated with the tag     |
| `value_title`       | string | No       | Display label for the tag value           |
| `value_title_short` | string | No       | Shortened display label for the tag value |

### `reviews` items

| Field                       | Type             | Description                                    |
| --------------------------- | ---------------- | ---------------------------------------------- |
| `author`                    | string           | Name of the reviewer                           |
| `avatar`                    | string           | URL of the reviewer's profile image            |
| `author_reviews_cnt`        | number           | Total number of reviews written by this author |
| `author_photos_cnt`         | number           | Total number of photos uploaded by this author |
| `rating`                    | number           | Rating given in this review                    |
| `text`                      | string           | Review text content                            |
| `timestamp_added`           | string           | Date/time the review was posted                |
| `timestamp_edited`          | string           | Date/time the review was last edited           |
| `link`                      | string           | URL to the review                              |
| `source`                    | string           | Platform source of the review                  |
| `source_logo`               | string           | URL of the source platform's logo              |
| `images`                    | array of strings | List of image URLs attached to the review      |
| `response_text`             | string           | Owner's reply to the review                    |
| `response_timestamp_added`  | string           | Date/time the owner's reply was posted         |
| `response_timestamp_edited` | string           | Date/time the owner's reply was last edited    |

## Example Response

### Maps search results

```text theme={null}
{
  "organic": [
    {
      "global_rank": 1,
      "title": "Example Coffee Co.",
      "address": "123 Main St, New York, NY 10001",
      "phone": "+1 212-555-0100",
      "link": "https://www.example-coffee.com",
      "map_link": "https://www.google.com/maps/place/example-coffee",
      "map_id": "0x6b12ae37b47f5b37:0x8eaddfcd1b32ca52",
      "map_id_encoded": "ChIJN1t_tDeuEmsRUsoyG83frY4",
      "description": "Specialty coffee shop serving single-origin espresso and pour-overs.",
      "price": "$$",
      "rating": 4.7,
      "reviews_cnt": 1280,
      "latitude": 40.7128,
      "longitude": -74.0060,
      "thumbnail": "https://www.example-coffee.com/images/thumb.jpg",
      "open_hours": {
        "Monday": "7am–7pm",
        "Tuesday": "7am–7pm",
        "Wednesday": "7am–7pm",
        "Thursday": "7am–7pm",
        "Friday": "7am–8pm",
        "Saturday": "8am–8pm",
        "Sunday": "9am–6pm"
      },
      "category": [
        { "id": "coffee_shop", "title": "Coffee Shop", "title_short": "Coffee" }
      ],
      "tags": [
        {
          "group_id": "service_options",
          "group_title": "Service options",
          "key_id": "dine_in",
          "key_title": "Dine-in",
          "value": 1,
          "value_title": "Available",
          "value_title_short": "Yes"
        }
      ],
      "reviews": [
        {
          "author": "Jane D.",
          "avatar": "https://example.com/avatars/jane.jpg",
          "author_reviews_cnt": 42,
          "author_photos_cnt": 15,
          "rating": 5,
          "text": "Best espresso in the city, hands down.",
          "timestamp_added": "2025-03-10T09:00:00Z",
          "source": "Google",
          "source_logo": "https://www.google.com/images/google-logo.png",
          "response_text": "Thank you so much, Jane! See you soon.",
          "response_timestamp_added": "2025-03-11T10:00:00Z"
        }
      ]
    }
  ]
}
```

### Place detail page

```text theme={null}
{
  "place": {
    "global_rank": 1,
    "title": "Example Coffee Co.",
    "address": "123 Main St, New York, NY 10001",
    "phone": "+1 212-555-0100",
    "link": "https://www.example-coffee.com",
    "map_link": "https://www.google.com/maps/place/example-coffee",
    "map_id": "0x6b12ae37b47f5b37:0x8eaddfcd1b32ca52",
    "map_id_encoded": "ChIJN1t_tDeuEmsRUsoyG83frY4",
    "description": "Specialty coffee shop serving single-origin espresso and pour-overs.",
    "price": "$$",
    "rating": 4.7,
    "reviews_cnt": 1280,
    "latitude": 40.7128,
    "longitude": -74.0060,
    "thumbnail": "https://www.example-coffee.com/images/thumb.jpg",
    "images": [
      {
        "image": "https://www.example-coffee.com/images/interior.jpg",
        "image_width": 800,
        "image_height": 600,
        "original_width": 1600,
        "original_height": 1200
      }
    ],
    "open_hours": {
      "Monday": "7am–7pm",
      "Friday": "7am–8pm",
      "Saturday": "8am–8pm",
      "Sunday": "9am–6pm"
    },
    "category": [
      { "id": "coffee_shop", "title": "Coffee Shop", "title_short": "Coffee" }
    ]
  }
}
```

Response schema, Maps search results: [https://api.brightdata.com/data\_schemas/fast\_serp/google\_maps\_search.schema.json](https://api.brightdata.com/data_schemas/fast_serp/google_maps_search.schema.json)

Response schema, place detail page: [https://api.brightdata.com/data\_schemas/fast\_serp/google\_maps\_place.schema.json](https://api.brightdata.com/data_schemas/fast_serp/google_maps_place.schema.json)

## Supported parameters

| Parameter     | Description                                | Example                | Notes                                                                             |
| ------------- | ------------------------------------------ | ---------------------- | --------------------------------------------------------------------------------- |
| `gl`          | Two-letter country code for search country | `gl=us`                |                                                                                   |
| `hl`          | Two-letter language code for page language | `hl=en`                |                                                                                   |
| `brd_json`    | **Required.**`1` = parsed JSON             | `brd_json=1`           |                                                                                   |
| `search term` | Search query term embedded in URL          | `coffee+shops+near+me` | Query size must be under 8,000 charachters. <br />Longer queries fail with error. |

***


# Fast SERP news search
Source: https://docs.brightdata.com/scraping-automation/serp-api/fast-serp/news-search

Use Bright Data's Fast SERP service (31 languages) to retrieve compact Google News search results in real time, for selected enterprise customers.

Bright Data offers a fast SERP service for News, available to selected enterprise customers only. This service responds with a compact JSON to power real-time applications that need up-to-date news results. To gain access, please contact your Bright Data account manager.

## Google News endpoints

Google offers two endpoints for news search results:

[news.google.com](http://news.google.com) and [https://www.google.com/search/q=\[searchTerm\]\&tbm=nws](https://www.google.com/search/q=\[searchTerm]\&tbm=nws)

Bright Data offers **Fast SERP** results only for: [https://www.google.com/search/q=\[searchTerm\]\&tbm=nws](https://www.google.com/search/q=\[searchTerm]\&tbm=nws) . Bright Data will provide results for [news.google.com](http://news.google.com) , but with in our regular SERP.

## Fast News Search Request

Fast SERP for Google News works best with the native proxy interface. If you need a REST API interface for your architecture, one can be provided.

<Note>
  For Fast SERP, **both** the `x-unblock-data-format: parsed_light`request header **and** the `brd_json=1` URL parameter are required. Omitting either will result in an unexpected response format.
</Note>

### Native proxy request

```shell theme={null}
curl -i --proxy fserp.brd.superproxy.io:44445 \
  --proxy-user brd-customer-<CUSTOMER>-zone-<ZONE>:<PASSWORD> \
  -k \
  -H 'x-unblock-data-format: parsed_light' \
  "https://www.google.com/search?q=earthquake&tbm=nws&brd_json=1"
```

## Response Format

A successful response returns a JSON object with the following top-level fields.

### Choosing image format

For news articles search results in Fast SERP, Bright Data offers to receive the data either as embedded Base64 binary code or as a URL. The default is Base64.

In order to get the image links use this header: `-H 'x-unblock-img-format: link'`

Example:

```text theme={null}
curl  --proxy fserp.brd.superproxy.io:44445 --proxy-user [username]:[password] -k -H 'x-unblock-data-format: parsed_light' -H 'x-unblock-img-format: link' "https://www.google.com/search?q=earthquake&tbm=nws&brd_json=1" --output nws_links.json
```

### `news` array

The primary array of individual news results.

| Field         | Type    | Description                                                      |
| ------------- | ------- | ---------------------------------------------------------------- |
| `link`        | string  | URL of the news article                                          |
| `title`       | string  | Headline of the article                                          |
| `source`      | string  | Name of the news publisher                                       |
| `source_logo` | string  | URL of the publisher's logo image or Base64 image binary code    |
| `date`        | string  | Publication date/time of the article                             |
| `image`       | string  | URL of the article's thumbnail image or Base64 image binary code |
| `global_rank` | integer | Rank position of the result on the page                          |

### `article_sets` array

Grouped article clusters organized by topic, each containing a `heading` label and an `items` array of articles.

<Note>
  article\_sets is not guaranteed to appear in every response. Your implementation should handle its absence gracefully.
</Note>

### Example response with image links

```JSON theme={null}
{
  "organic": [],
  "news": [
    {
      "link": "https://www.example-news.com/world/earthquake-latest",
      "title": "Major Earthquake Strikes Pacific Region",
      "source": "Example News",
      "source_logo": "https://www.example-news.com/logo.png",
      "date": "2 hours ago",
      "image": "https://www.example-news.com/images/earthquake.jpg",
      "global_rank": 1
    },
    {
      "link": "https://www.another-outlet.com/earthquake-update",
      "title": "Rescue Operations Underway After Earthquake",
      "source": "Another Outlet",
      "source_logo": "https://www.another-outlet.com/logo.png",
      "date": "3 hours ago",
      "image": "https://www.another-outlet.com/images/rescue.jpg",
      "global_rank": 2
    }
  ],
  "article_sets": [
    {
      "heading": "Latest Updates",
      "items": [
        {
          "link": "https://www.example-news.com/world/earthquake-latest",
          "title": "Major Earthquake Strikes Pacific Region",
          "source": "Example News",
          "date": "2 hours ago"
        }
      ]
    }
  ]
}
```

Response schema: [https://api.brightdata.com/data\_schemas/fast\_serp/google\_search\_news.schema.json](https://api.brightdata.com/data_schemas/fast_serp/google_search_news.schema.json)

## Supported parameters

| Parameter  | Description                                | Example        | Notes                                                                             |
| ---------- | ------------------------------------------ | -------------- | --------------------------------------------------------------------------------- |
| `q`        | Search query (**must be first in URL**)    | `q=earthquake` | Query size must be under 8,000 charachters. <br />Longer queries fail with error. |
| `gl`       | Two-letter country code for search country | `gl=us`        |                                                                                   |
| `hl`       | Two-letter language code for page language | `hl=en`        |                                                                                   |
| `brd_json` | **Required.**`1` = parsed JSON             | `brd_json=1`   |                                                                                   |

**Headers**

| Header                  | Description                                    | Example        |
| ----------------------- | ---------------------------------------------- | -------------- |
| `x-unblock-data-format` | **Required.** Must be `parsed_light`           | `parsed_light` |
| `x-unblock-img-format`  | Image format: `link` (URL) or default (Base64) | `link`         |

***


# Fast SERP quickstart
Source: https://docs.brightdata.com/scraping-automation/serp-api/fast-serp/quickstart

Get started with Bright Data Fast SERP (31 languages) for enterprise customers. Apply through your account manager and run high-volume Google search queries.

## How do I get access to Bright Data's Fast SERP?

Access to fast SERP is available for enterprise customers: contact your account manager at [sales@brightdata.com](mailto:sales@brightdata.com) to see if your account qualifies. Fast SERP provides best results in high volumes so requests to serve volume below 50 QPS have slim chance to be approved.

## How fast is Fast SERP?

Fast SERP responds at least twice as fast than our full regular SERP, with P(90) around 1 second.

*P(90) is the 90th percentile meaning 90% of the requests.*

## Which Google searches are supported under Fast SERP?

Fast SERP supports multiple search verticals. See the relevant page for that search type.

Supported verticals:

1. Web Search
2. News
3. Shopping
4. Images
5. Maps

## What volume in QPS (queries per second) is supported?

Bright Data's can support high volume SERP traffic from hundreds to thousands of QPS.

Consider both your POC/testing volume and your expected production volume before getting started. This helps ensure your zone is configured correctly for your workload. If you're unsure, start with an estimate, your account manager can adjust your rate allocation as your usage grows. If your usage fluctuates on short time spans (like sudden or planned high bursts, or sudden or planned zero traffic periods) - let us know so we can ensure level of service.

## Do I need to control or throttle traffic on my end?

If your system has internal rate-limiting or load control mechanisms, share those details with your account manager. This helps align your zone's capacity with your infrastructure's behavior and avoids unnecessary errors.

## Should I use the native proxy interface or the REST API?

Fast SERP works best with the **native proxy interface**, it is slightly faster than the REST API. A REST API interface can be provided if required by your architecture.

## Which geographic region will my scrapers run from?

Fast SERP supports multiple deployment regions: **US East**, **US West**, **EU**, and **APAC**. Knowing your scraper region(s) in advance helps optimize routing and latency. If your production traffic is distributed across multiple regions, let your account manager know.


# Fast SERP shopping search
Source: https://docs.brightdata.com/scraping-automation/serp-api/fast-serp/shopping-search

Use Bright Data's Fast SERP service (31 languages) to retrieve compact Shopping search results in real time via a native proxy interface.

## Fast SERP: Google Shopping endpoints

Google Shopping offers two types of pages that Fast SERP supports:

* **Shopping search results**, a listing of products for a given search query, via `https://www.google.com/search?q=[searchTerm]&udm=28`
* **Product detail page (PDP)**, a full product page with offers, specifications, and reviews, via a Google Shopping product URL

Both endpoints require the `x-unblock-data-format: parsed_light` request header and the `brd_json=1` URL parameter. Omitting either will result in an unexpected response format.

## Fast Shopping Search Request

Fast SERP for Google Shopping works best with the native proxy interface. If you need a REST API interface for your architecture, one can be provided.

### Shopping search results

Use the `udm=28` parameter to retrieve the Google Shopping search results listing page.

```text theme={null}
curl -v --proxy fserp.brd.superproxy.io:44445 \
  --proxy-user username:password \
  -k \
  -H 'x-unblock-data-format: parsed_light' \
  "https://www.google.com/search?q=iphone&udm=28&brd_json=1"
```

### Response Format

A successful shopping search response contains a `shopping` array.

#### `shopping` array

| Field         | Type    | Required | Description                                   |
| ------------- | ------- | -------- | --------------------------------------------- |
| `price`       | string  | Yes      | Displayed price of the product                |
| `link`        | string  | Yes      | URL to the product listing or merchant page   |
| `global_rank` | integer | Yes      | Rank position of the result on the page       |
| `title`       | string  | No       | Product name                                  |
| `shop`        | string  | No       | Name of the merchant or seller                |
| `image`       | string  | No       | URL of the product thumbnail image            |
| `rating`      | number  | No       | Average customer rating                       |
| `reviews_cnt` | integer | No       | Number of customer reviews                    |
| `old_price`   | string  | No       | Original price before discount, if applicable |

#### Example response, shopping search results

```text theme={null}
{
  "shopping": [
    {
      "title": "Apple iPhone 16 128GB Black",
      "link": "https://www.example-store.com/iphone-16-black",
      "price": "$799.00",
      "old_price": "$899.00",
      "shop": "Example Store",
      "rating": 4.8,
      "reviews_cnt": 3240,
      "image": "https://www.example-store.com/images/iphone-16.jpg",
      "global_rank": 1
    },
    {
      "title": "Apple iPhone 16 256GB White",
      "link": "https://www.another-store.com/iphone-16-white",
      "price": "$899.00",
      "shop": "Another Store",
      "rating": 4.7,
      "reviews_cnt": 1850,
      "image": "https://www.another-store.com/images/iphone-16-white.jpg",
      "global_rank": 2
    }
  ]
}
```

Response schema: [https://api.brightdata.com/data\_schemas/fast\_serp/google\_shopping.schema.json](https://api.brightdata.com/data_schemas/fast_serp/google_shopping.schema.json)

## Fast Shopping Product Request

Fast SERP for Google Shopping product pages works best with the native proxy interface. If you need a REST API interface for your architecture, one can be provided.

For Fast SERP, both the `x-unblock-data-format: parsed_light` request header and the `brd_json=1` URL parameter are required. Omitting either will result in an unexpected response format.

<Note>
  Google Shopping product (PDP) URLs are short-lived. They carry an encoded `prds=` payload that Google rotates frequently, so a copied URL stops resolving after a short window. Do not hardcode a product URL. Instead, use whatever URL Google routes to when you open a product from a shopping search result tile, then append `&brd_json=1`.
</Note>

### Native proxy request

```shell theme={null}
curl -v --proxy fserp.brd.superproxy.io:44445 \
  --proxy-user username:password \
  -k \
  "<GOOGLE_SHOPPING_PRODUCT_URL>&brd_json=1" \
  -H 'x-unblock-data-format: parsed_light'
```

## Response Format

A successful response is structured around three top-level fields: `product`, `product_offers`, and `product_spec`.

### `product` object

Top-level product information.

| Field         | Type             | Description                      |
| :------------ | :--------------- | :------------------------------- |
| `title`       | string           | Name of the product              |
| `description` | string           | Full product description         |
| `images`      | array of strings | List of product image URLs       |
| `rating`      | number \| null   | Average customer rating          |
| `reviews_cnt` | integer          | Total number of customer reviews |
| `ai_images`   | array of strings | Links to images in ai segment    |

### `product_offers` array

List of individual seller offers for the product.

| Field                | Type             | Description                                  |
| :------------------- | :--------------- | :------------------------------------------- |
| `seller`             | string           | Name of the seller or merchant               |
| `link`               | string           | URL to the seller's product page             |
| `logo`               | string           | URL of the seller's logo image               |
| `item_price`         | array of strings | Current price(s) displayed for the offer     |
| `item_old_price`     | array of strings | Previous/crossed-out price(s), if applicable |
| `shipping`           | string           | Shipping cost or delivery information        |
| `rating`             | number           | Seller or offer rating                       |
| `reviews_cnt`        | integer          | Number of reviews for this offer             |
| `details`            | array of strings | List of offer detail highlights              |
| `details_and_offers` | string           | Combined details and promotional offer text  |
| `payment_methods`    | string           | Accepted payment methods                     |

### `product_spec` object

Technical specifications grouped into sections.

| Field                  | Type   | Description                                |
| :--------------------- | :----- | :----------------------------------------- |
| `specs`                | array  | List of specification sections             |
| `specs[].data`         | array  | List of spec items within the section      |
| `specs[].data[].name`  | string | Specification label, e.g. `"Display size"` |
| `specs[].data[].value` | string | Specification value, e.g. `"6.1 inches"`   |

## Example Response

```shell theme={null}
{
  "product": {
    "title": "Apple iPhone 17 Pro Max",
    "description": "The Apple iPhone 17 Pro Max features the latest A-series chip, a pro camera system, and all-day battery life in a titanium design.",
    "images": [
      "https://www.example-store.com/images/iphone-17-pro-max-front.jpg",
      "https://www.example-store.com/images/iphone-17-pro-max-back.jpg"
    ],
    "ai_images": [
      "https://www.example-store.com/images/iphone-17-pro-max-ai-1.jpg",
      "https://www.example-store.com/images/iphone-17-pro-max-ai-2.jpg"
    ],
    "rating": 4.9,
    "reviews_cnt": 5120
  },
  "product_offers": [
    {
      "seller": "Example Store",
      "link": "https://www.example-store.com/iphone-17-pro-max",
      "logo": "https://www.example-store.com/logo.png",
      "item_price": ["$1,199.00"],
      "item_old_price": ["$1,299.00"],
      "shipping": "Free shipping",
      "rating": 4.9,
      "reviews_cnt": 2100,
      "details": ["In stock", "Ships within 24 hours"],
      "details_and_offers": "In stock. Ships within 24 hours. 10% off with code SAVE10.",
      "payment_methods": "Visa, Mastercard, PayPal"
    },
    {
      "seller": "Another Store",
      "link": "https://www.another-store.com/iphone-17-pro-max",
      "logo": "https://www.another-store.com/logo.png",
      "item_price": ["$1,209.00"],
      "item_old_price": [],
      "shipping": "$5.99 shipping",
      "rating": 4.7,
      "reviews_cnt": 980,
      "details": ["In stock"],
      "details_and_offers": "In stock. Standard delivery 3-5 days.",
      "payment_methods": "Visa, Mastercard"
    }
  ],
  "product_spec": {
    "specs": [
      {
        "data": [
          { "name": "Display size", "value": "6.9 inches" },
          { "name": "Display type", "value": "Super Retina XDR OLED" }
        ]
      },
      {
        "data": [
          { "name": "Storage", "value": "256GB" },
          { "name": "RAM", "value": "12GB" },
          { "name": "Processor", "value": "Apple A19 Pro" }
        ]
      },
      {
        "data": [
          { "name": "Main camera", "value": "48MP" },
          { "name": "Battery capacity", "value": "4685 mAh" }
        ]
      }
    ]
  }
}
```

Response schema: [https://api.brightdata.com/data\_schemas/fast\_serp/google\_shopping\_product.schema.json](https://api.brightdata.com/data_schemas/fast_serp/google_shopping_product.schema.json)

## Supported parameters

| Parameter  | Description                                | Example      | Notes                                                                             |
| ---------- | ------------------------------------------ | ------------ | --------------------------------------------------------------------------------- |
| `q`        | Search query (**must be first in URL**)    | `q=iphone`   | Query size must be under 8,000 charachters. <br />Longer queries fail with error. |
| `gl`       | Two-letter country code for search country | `gl=us`      |                                                                                   |
| `hl`       | Two-letter language code for page language | `hl=en`      |                                                                                   |
| `brd_json` | **Required.**`1` = parsed JSON             | `brd_json=1` |                                                                                   |

***


# Fast SERP web search
Source: https://docs.brightdata.com/scraping-automation/serp-api/fast-serp/web-search

Use Bright Data Fast SERP (31 languages) to retrieve compact JSON search results in real time via a native proxy interface, for low-latency apps.

Bright Data offers a fast SERP service with a compact JSON response, to power real-time applications in need of search results.

To gain access to Bright Data FAST SERP service, please contact your Bright Data account manager.

## Fast SERP Request

Fast SERP works best with the native proxy interface. If you need a REST API interface for your architecture, one can be provided.

<Note>
  For Fast SERP, **both** the `x-unblock-data-format: parsed_light`request header **and** the `brd_json=1` URL parameter are required. Omitting either will result in an unexpected response format.
</Note>

### How to get organic results

Use header value `x-unblock-data-format: parsed_fast`, this request header will return organic results.

```shell theme={null}
curl -i --proxy fserp.brd.superproxy.io:44445 \
  --proxy-user brd-customer-<CUSTOMER>-zone-<ZONE>:<PASSWORD> \
  -k \
  -H 'x-unblock-data-format: parsed_fast' \
  "https://www.google.com/search?q=pizza&brd_json=1" \
  > output.json
```

#### Organic results: response format

#### `organic` array

The primary array of web search results, present in both `parsed_light` and `parsed_fast` responses.

| Field         | Type    | Description                                                        |
| :------------ | :------ | :----------------------------------------------------------------- |
| `link`        | string  | URL of the result page                                             |
| `title`       | string  | Title of the result                                                |
| `description` | string  | Snippet/summary shown in the search result                         |
| `global_rank` | integer | Rank position of the result on the page                            |
| `extensions`  | array   | Optional list of site links associated with the result (see below) |

#### `extensions` items

| Field  | Type   | Description                         |
| :----- | :----- | :---------------------------------- |
| `type` | string | Type of extension, e.g. `site_link` |
| `link` | string | URL of the site link                |
| `text` | string | Anchor text of the site link        |

### Example response, `parsed_fast` (organic results)

```text theme={null}
{
  "organic": [
    {
      "link": "https://en.wikipedia.org/wiki/Pizza",
      "title": "Pizza - Wikipedia",
      "description": "Pizza is an Italian dish consisting of a flat base of leavened wheat-based dough topped with tomato, cheese, and other ingredients.",
      "global_rank": 1,
      "extensions": [
        {
          "type": "site_link",
          "link": "https://en.wikipedia.org/wiki/Neapolitan_pizza",
          "text": "Neapolitan pizza"
        }
      ]
    },
    {
      "link": "https://www.example-pizza.com/best-pizza-nyc",
      "title": "Best Pizza in NYC - Joe's Pizza",
      "description": "Family-owned pizzeria serving authentic New York slices since 1975.",
      "global_rank": 2
    },
    {
      "link": "https://www.pizza-guide.com/top-10",
      "title": "Top 10 Pizza Places in NYC",
      "description": "Discover the highest-rated pizza restaurants across all five boroughs.",
      "global_rank": 3
    }
  ]
}
```

### Organic results with "Top Stories"

Use header value `x-unblock-data-format: parsed_light`, this request header will return Google's "Top Stories" in the response alongside organic results.

```shell theme={null}
curl -i --proxy fserp.brd.superproxy.io:44445 \
  --proxy-user brd-customer-<CUSTOMER>-zone-<ZONE>:<PASSWORD> \
  -k \
  -H 'x-unblock-data-format: parsed_light' \
  "https://www.google.com/search?q=pizza&brd_json=1" \
  > output.json
```

### `general` object

Returned in every `parsed_light` response. Reports the query you sent and the query Google actually ran, which lets you detect when Google truncates a search.

| Field            | Type   | Description                                                                                                                |
| ---------------- | ------ | -------------------------------------------------------------------------------------------------------------------------- |
| `query`          | string | The search query you submitted                                                                                             |
| `detected_query` | string | The query Google actually returned results for. Differs from `query` when Google corrects spelling or truncates the search |

<Note>
  If `detected_query` differs from `query`, check for a `spelling` section in the response. If `spelling` is present, the difference is due to automatic spelling correction and the response is valid. If `spelling` is absent, the query was cloaked and results were returned for a truncated version of the original query.
</Note>

### `spelling` object

Returned in a `parsed_light` response only when Google applies or suggests a spelling correction. All fields are nullable and appear only when Google provides that variant.

| Field                 | Type           | Description                                                           |
| --------------------- | -------------- | --------------------------------------------------------------------- |
| `original_text`       | string \| null | The original query keyword before correction                          |
| `original_link`       | string \| null | Google search URL for the original query                              |
| `auto_corrected_text` | string \| null | The corrected keyword Google searched instead                         |
| `auto_corrected_link` | string \| null | Google search URL for the corrected query                             |
| `auto_included_text`  | string \| null | Term Google automatically included in the search                      |
| `auto_included_link`  | string \| null | Google search URL for the auto-included term                          |
| `suggested_text`      | string \| null | Keyword Google suggests ("Did you mean") without changing the results |
| `suggested_link`      | string \| null | Google search URL for the suggested query                             |
| `original_empty`      | boolean        | `true` when Google returned no results for the original query         |

### `top_stories` array

Returned only when using `x-unblock-data-format: parsed_light`. Contains Google's "Top Stories" news carousel results.

| Field    | Type   | Description                          |
| -------- | ------ | ------------------------------------ |
| `link`   | string | URL of the news article              |
| `title`  | string | Headline of the article              |
| `source` | string | Name of the news publisher           |
| `date`   | string | Publication date/time of the article |
| `image`  | string | URL of the article's thumbnail image |

### Example response, `parsed_light` (with Top Stories)

```text theme={null}
{
  "general": {
    "query": "pizza",
    "detected_query": "pizza"
  },
  "organic": [
    {
      "link": "https://en.wikipedia.org/wiki/Pizza",
      "title": "Pizza - Wikipedia",
      "description": "Pizza is an Italian dish consisting of a flat base of leavened wheat-based dough topped with tomato, cheese, and other ingredients.",
      "global_rank": 1,
      "extensions": [
        {
          "type": "site_link",
          "link": "https://en.wikipedia.org/wiki/Neapolitan_pizza",
          "text": "Neapolitan pizza"
        },
        {
          "type": "site_link",
          "link": "https://en.wikipedia.org/wiki/Pizzeria",
          "text": "Pizzeria"
        }
      ]
    },
    {
      "link": "https://www.example-pizza.com/best-pizza-nyc",
      "title": "Best Pizza in NYC - Joe's Pizza",
      "description": "Family-owned pizzeria serving authentic New York slices since 1975.",
      "global_rank": 2
    }
  ],
  "top_stories": [
    {
      "link": "https://www.example-news.com/pizza-festival",
      "title": "NYC Pizza Festival Returns This Summer",
      "source": "Example News",
      "date": "3 hours ago",
      "image": "https://www.example-news.com/images/pizza-fest.jpg"
    },
    {
      "link": "https://www.another-outlet.com/pizza-record",
      "title": "World Record Pizza Baked in Naples",
      "source": "Another Outlet",
      "date": "5 hours ago",
      "image": "https://www.another-outlet.com/images/pizza-record.jpg"
    }
  ]
}
```

<Note>
  Query truncation detection and the `query_rejected` blocked-query behavior apply to the whole SERP API, not just Fast SERP. See [How to detect query truncation](/scraping-automation/serp-api/debugging#how-to-detect-query-truncation) and [What happens when a query is blocked](/scraping-automation/serp-api/debugging#what-happens-when-a-query-is-blocked) on the SERP API debugging page.
</Note>

Response schema, with Top Stories: [https://api.brightdata.com/data\_schemas/fast\_serp/google\_search.schema.json](https://api.brightdata.com/data_schemas/fast_serp/google_search.schema.json)

Response schema, without Top Stories: [https://api.brightdata.com/data\_schemas/fast\_serp/google\_search\_web.schema.json](https://api.brightdata.com/data_schemas/fast_serp/google_search_web.schema.json)

## Supported parameters

| Parameter  | Description                                | Example      | Notes                                                                             |
| ---------- | ------------------------------------------ | ------------ | --------------------------------------------------------------------------------- |
| `q`        | Search query (**must be first in URL**)    | `q=pizza`    | Query size must be under 8,000 charachters. <br />Longer queries fail with error. |
| `gl`       | Two-letter country code for search country | `gl=us`      |                                                                                   |
| `hl`       | Two-letter language code for page language | `hl=en`      |                                                                                   |
| `brd_json` | **Required.**`1` = parsed JSON             | `brd_json=1` |                                                                                   |

***


# Google SERP features
Source: https://docs.brightdata.com/scraping-automation/serp-api/features

Configure Bright Data SERP API (31 languages) features including response format, parsing options and header overrides for Google search results.

## Parsing and response format configuration

You can control and override the default API response format setup defined during API creation in Bright Data control panel.

We allow either override by URL parameter `brd_json` or by relaying a header `x-unblock-data-format`

| Parameter               | Type        | Required | Default | Accepted values                  |
| :---------------------- | :---------- | :------- | :------ | :------------------------------- |
| `brd_json`              | URL         | No       | none    | `1`, `html`                      |
| `x-unblock-data-format` | HTTP header | No       | none    | `parsed_light, html, screenshot` |

***

### Get response as raw HTML

Add header paramater: `x-unblock-data-format: html` .

Example:

```sh theme={null}
curl --proxy brd.superproxy.io:44445 --proxy-user  brd-customer-<customer-id>-zone-<zone-name>:<zone-password> -k -H "x-unblock-data-format: html" "https://www.google.com/search?q=pizza"
```

***

### Get response as Full JSON

Add header paramater: `x-unblock-data-format: json`or add URL parameter: `brd_json=1`.

Examples:

```sh Header parameter theme={null}
curl -k --proxy brd.superproxy.io:44445 --proxy-user brd-customer-<customer_id>-zone-<zone_name>:<zone_password> -k -H "x-unblock-data-format: json" "https://www.google.com/search?q=pizza"
```

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

***

### Get Full JSON with a structue holding the full HTML  as `string`

Add URL parameter: `brd_json=html` or  header parameter: `x-unblock-data-format: html`

Example:

```sh JSON+HTML theme={null}
  curl --proxy brd.superproxy.io:44445 --proxy-user brd-customer-<customer-id>-zone-<zone-name>:<zone-password> -k "https://www.google.com/search?q=pizza&brd_json=html"
```

***

### Get light JSON

Add header parameter: `x-unblock-data-format: parsed_light` or URL parameter `brd_json=parsed_light` to get a faster response (works twice as fast than Full SERP) with less componenets.

Full schema documentation can be seen here: [https://docs.brightdata.com/scraping-automation/serp-api/parsed-json-results/parsing-search-results#google-response-schema-light-json](/scraping-automation/serp-api/parsed-json-results/parsing-search-results#google-response-schema-light-json)

Examples:

```sh Header parameter theme={null}
curl -k --proxy brd.superproxy.io:44445 --proxy-user brd-customer-<customer_id>-zone-<zone_name>:<zone_password> -k -H "x-unblock-data-format: parsed_light" "https://www.google.com/search?q=pizza"
```

```sh URL parameter theme={null}
curl -k --proxy brd.superproxy.io:44445 --proxy-user brd-customer-<customer_id>-zone-<zone_name>:<zone_password> -k "https://www.google.com/search?q=pizza&brd_json=parsed_light"
```

***

### Get response as screenshot

Add header paramater: `x-unblock-data-format: screenshot` . Response will be a binary PNG image. In the example below add `--output` flag to `curl` to capture response to image file.

Example:

```sh theme={null}
curl --proxy brd.superproxy.io:44445 --proxy-user brd-customer-<customer-id>-zone-<zone-name>:<zone-password> -k -H "x-unblock-data-format: screenshot" "https://www.google.com/search?q=pizza" --output screenshot.png
```

***

## Get element rectangle information <Badge>BETA</Badge>

Add URL parameter `brd_rects=1` in order to get results rectangle area as displayed on search result screen. This allows you to know when, in relation to `viewport` (which signifies screen resolution used to render the page) how much space does the result take on the visible screen.`viewport` (screen size) can be found in `general` elememt.

Notes:

1. Getting rectangle data will increase response time. Expect response time to range between 5 seconds to 60 seconds per request.
2. In BETA version you must also relay`brd_json=1` URL parameter in addition to `brd_rects=1` .

Response elements which have rectangle information:

* `organic`
* `videos`
* `images`
* `people_also_ask`
* `ai_overview`
* `related_searches`
* `perspectives`
* `forums `
* `pagination`
* `latest_posts`

Example:

```bash theme={null}
curl -vx \
  -x brd-customer-$CUSTOMER_ID-zone-$ZONE:$PASSWORD@brd.superproxy.io:44445 \ 
 "https://www.google.com/search?q=bright+data&brd_json=1&brd_rects=1"
```

## How to configure routing

**Pin requests to the same IP with** `x-brd-session`**.** This feature will attempt to keep the same proxy IP address which was used previously.

```bash theme={null}
curl -vk \
  -x brd-customer-$CUSTOMER_ID-zone-$ZONE:$PASSWORD@brd.superproxy.io:44445 \
  -H 'x-brd-session: my-session-123' \
  "https://www.google.com/search?q=bright+data"
```

## Page Load configuration

**Wait for a specific element with `x-brd-expect`** *(requires* `custom_expect `*permission).*

Use this option in order to prevent premature response, and wait till specific element is rendered by google.

```bash theme={null}
curl -vk \
  -x brd-customer-$CUSTOMER_ID-zone-$ZONE:$PASSWORD@brd.superproxy.io:44445 \
  -H 'x-brd-expect: {"element": "#search"}' \
  "https://www.google.com/search?q=bright+data"
```

## URL Control configuration

**Append a URL fragment with `x-brd-url-fragment`:**

Use this option if you need to maintain a base URL address, and append a suffix by your logic.

```bash theme={null}
curl -vk \
  -x brd-customer-$CUSTOMER_ID-zone-$ZONE:$PASSWORD@brd.superproxy.io:44445 \
  -H 'x-brd-url-fragment: !/results/section2' \
  "https://www.google.com/search?q=bright+data"
```

## Get current rate limit

**Get rate limit info with `x-brd-get-rate-limit`:**

Get current target website rate limit, response is

```bash theme={null}
curl -vk \
  -x brd-customer-$CUSTOMER_ID-zone-$ZONE:$PASSWORD@brd.superproxy.io:44445 \
  -H 'x-brd-get-rate-limit: true' \
  "https://www.google.com/search?q=bright+data"   
```

## Request Headers: Summary

The following headers can be passed with your SERP API requests to control behavior, session pinning, output format, and more.

| Header or URL parameter               | Availability                                                            | Purpose                                                                  |
| :------------------------------------ | :---------------------------------------------------------------------- | :----------------------------------------------------------------------- |
| `x-brd-expect`                        | Zones with `custom_expect` permission                                   | Custom success/failure validation criteria for response content          |
| `x-unblock-data-format`               | All                                                                     | Controls output format: `json, html, light_json, screenshot, parsed`     |
| `x-brd-url-fragment`                  | All (browser step)                                                      | Appends a URL fragment (`#...`) to the request URL for browser rendering |
| `x-brd-session`                       | All                                                                     | Sets a customer session ID to pin requests to the same peer/IP           |
| `x-request-priority`                  | All                                                                     | Request priority hint - may influence internal routing decisions         |
| `x-brd-get-rate-limit`                | All                                                                     | When present, response includes current rate limit info headers          |
| `cookie`                              | Zones with `cookie_whitelist` or `header_whitelist` containing `cookie` | Customer cookies forwarded to target site (filtered by whitelist)        |
| Any header in `header_whitelist` rule | Zones with `cust_head` permission                                       | Custom headers forwarded verbatim to the target site                     |
| `brd_rects=1`                         | All                                                                     | Show element rectangle data                                              |


# Get started with Bing SERP API
Source: https://docs.brightdata.com/scraping-automation/serp-api/get-started-bing-serp-api

Start using Bright Data's Bing SERP API in 3 steps: Sign in, create a SERP zone, get your API key, and begin collecting Bing search data.

## Make your first request in minutes

Test the Bing SERP API in minutes with this ready-to-use code example.

<CardGroup>
  <Card title="Postman Example" icon="user-astronaut" href="https://www.postman.com/bright-data-api/bright-data-api/request/uzaea2u/bing-search" />

  <Card title="Node.js Example" icon="code" href="https://github.com/brightdata/bright-data-bing-serp-api-nodejs-project" />

  <Card title="Python Example" icon="code" href="https://github.com/brightdata/bright-data-bing-serp-api-python-project" />
</CardGroup>

## Bing SERP API Quick Start Examples

Run these basic examples to check that your Bing SERP API is working (remember to update in your API key and query):

<CodeGroup>
  ```shell cURL theme={null}
    curl -X POST https://api.brightdata.com/request \
    --header "Content-Type: application/json" \
    --header "Authorization: Bearer API_KEY" \
    --data '{
      "zone": "serp_api1",
      "url": "https://www.bing.com/search?q=pizza",
      "format": "raw"
    }'
  ```

  ```javascript bing-serp.js theme={null}
  (async () => {
    const response = await fetch('https://api.brightdata.com/request', {
      method: 'POST',
      headers: {
        'Content-Type': 'application/json',
        'Authorization': 'Bearer API_KEY'
      },
      body: JSON.stringify({
        zone: 'serp_api1',
        url: 'https://www.bing.com/search?q=pizza',
        format: 'raw'
      })
    });
    
    const data = await response.text();
    console.log(data);
  })();
  ```

  ```python bing_serp.py theme={null}
  import requests

  # API Configuration
  headers = {
      'Content-Type': 'application/json',
      'Authorization': 'Bearer API_KEY',
  }

  payload = {
      'zone': 'serp_api1',
      'url': 'https://www.bing.com/search?q=pizza',
      'format': 'raw'
  }

  # Make the request
  response = requests.post(
      'https://api.brightdata.com/request', 
      json=payload, 
      headers=headers
  )

  print(response.text)
  ```
</CodeGroup>

## Links to get started with Bing SERP API

* [SERP API introduction](/scraping-automation/serp-api/introduction)
* [Get API key](/api-reference/authentication)
* [Bing query parameters](/scraping-automation/serp-api/query-parameters/bing)

## Microsoft Bing API to Bright Data SERP API migration guide

[Bing API to Bright Data SERP API migration guide](/scraping-automation/serp-api/parsed-json-results/bing-to-bright-data-serp-migration-guide)


# Get started with Google SERP API
Source: https://docs.brightdata.com/scraping-automation/serp-api/get-started-google-serp-api

Start using Bright Data's Google SERP API in 3 steps: Sign in, create a SERP zone, get your API key, and begin collecting Google search data.

## Make your first request in minutes

Test the Google SERP API in minutes with this ready-to-use code example.

<CardGroup>
  <Card title="Postman Example" icon="user-astronaut" href="https://www.postman.com/bright-data-api/bright-data-api/request/kpq952m/google-search" />

  <Card title="Node.js Example" icon="code" href="https://github.com/luminati-io/bright-data-serp-api-nodejs-project" />

  <Card title="Python Example" icon="code" href="https://github.com/brightdata/bright-data-serp-api-python-project" />
</CardGroup>

## Google SERP API Quick Start Examples

Run these basic examples to check that your Google SERP API is working (remember to update in your API key and query):

<CodeGroup>
  ```shell cURL theme={null}
    curl -X POST https://api.brightdata.com/request \
    --header "Content-Type: application/json" \
    --header "Authorization: Bearer API_KEY" \
    --data '{
      "zone": "serp_api1",
      "url": "https://www.google.com/search?q=pizza",
      "format": "raw"
    }'
  ```

  ```javascript google-serp.js theme={null}
  (async () => {
    const response = await fetch('https://api.brightdata.com/request', {
      method: 'POST',
      headers: {
        'Content-Type': 'application/json',
        'Authorization': 'Bearer API_KEY'
      },
      body: JSON.stringify({
        zone: 'serp_api1',
        url: 'https://www.google.com/search?q=pizza',
        format: 'raw'
      })
    });
    
    const data = await response.text();
    console.log(data);
  })();
  ```

  ```python google_serp.py theme={null}
  import requests

  # API Configuration
  headers = {
      'Content-Type': 'application/json',
      'Authorization': 'Bearer API_KEY',
  }

  payload = {
      'zone': 'serp_api1',
      'url': 'https://www.google.com/search?q=pizza',
      'format': 'raw'
  }

  # Make the request
  response = requests.post(
      'https://api.brightdata.com/request', 
      json=payload, 
      headers=headers
  )

  print(response.text)
  ```
</CodeGroup>

## Links to get started with Google SERP API

* [SERP API introduction](/scraping-automation/serp-api/introduction)
* [Get API key](/api-reference/authentication)
* [Google query parameters](/scraping-automation/serp-api/query-parameters/google)


# Get top 100 Google results
Source: https://docs.brightdata.com/scraping-automation/serp-api/get-top-100-google-results

Fetch positions 1-100 from Google search in a single Bright Data request with control over language, location, pagination depth and AI Overview extraction.

<Note>
  This guide uses the Scrapers (Datasets) to return Google SERP positions 1-100 in one request. You control language, geo-targeting, pagination depth, and device type. This is guides overcome the challenge in getting 100 results   (`n=100`)  after parameter deprecation by google.
</Note>

## Prerequisites

Before you begin, ensure you have:

* An active Bright Data account
* Your API key (found in your dashboard under **Users and API keys**)
* Dataset ID: `gd_mfz5x93lmsjjjylob`

<Note>
  **Pricing:** One successful API call = one billable request, regardless of page depth. Retries are included; no bandwidth fees apply. See [SERP Pricing & Billing](/scraping-automation/serp-api/pricing-and-billing) for details.
</Note>

## Quick start

Try these examples to fetch the top 100 results in one request. Replace `${API_KEY}` with your actual API key.

<CardGroup>
  <Card title="Test in Postman" icon="user-astronaut" href="https://www.postman.com/bright-data-api/bright-data-api/request/h7ov9x5/google-serp-100-results">
    Pre-configured collection for Google SERP top 100 results
  </Card>
</CardGroup>

### How to send a basic request

This example returns approximately 100 results (10 pages × \~10 results per page):

<CodeGroup>
  ```bash cURL theme={null}
  curl -X POST "https://api.brightdata.com/datasets/v3/trigger?dataset_id=gd_mfz5x93lmsjjjylob&include_errors=true" \
    -H "Authorization: Bearer ${API_KEY}" \
    -H "Content-Type: application/json" \
    -d '[{
      "url": "https://www.google.com/",
      "keyword": "pizza",
      "language": "en",
      "country": "US",
      "start_page": 1,
      "end_page": 10
    }]'
  ```

  ```js Node.js theme={null}
  import fetch from "node-fetch";

  const API_KEY = process.env.API_KEY;
  const DATASET_ID = "gd_mfz5x93lmsjjjylob";

  const payload = [
    {
      url: "https://www.google.com/",
      keyword: "pizza",
      language: "en",
      country: "US",
      start_page: 1,
      end_page: 10,
    },
  ];

  const res = await fetch(
    `https://api.brightdata.com/datasets/v3/trigger?dataset_id=${DATASET_ID}&include_errors=true`,
    {
      method: "POST",
      headers: {
        "Content-Type": "application/json",
        Authorization: `Bearer ${API_KEY}`,
      },
      body: JSON.stringify(payload),
    }
  );

  const job = await res.json();
  console.log(job); // Contains snapshot_id for status checks and download
  ```

  ```py Python theme={null}
  import os
  import json
  import requests

  API_KEY = os.environ.get("API_KEY")
  DATASET_ID = "gd_mfz5x93lmsjjjylob"

  payload = [
      {
          "url": "https://www.google.com/",
          "keyword": "pizza",
          "language": "en",
          "country": "US",
          "start_page": 1,
          "end_page": 10
      }
  ]

  res = requests.post(
      f"https://api.brightdata.com/datasets/v3/trigger?dataset_id={DATASET_ID}&include_errors=true",
      headers={
          "Authorization": f"Bearer {API_KEY}",
          "Content-Type": "application/json",
      },
      data=json.dumps(payload),
  )

  print(res.json())  # Contains snapshot_id for status checks
  ```
</CodeGroup>

### Which parameters to use

| Parameter      | Type    | Description                      | Example                   |
| -------------- | ------- | -------------------------------- | ------------------------- |
| `keyword`      | string  | Search term to query             | `"pizza"`                 |
| `language`     | string  | UI language (ISO 639-1)          | `"en"`, `"de"`            |
| `country`      | string  | Geographic location (ISO 3166-1) | `"US"`, `"DE"`            |
| `start_page`   | integer | First page to scrape             | `1`                       |
| `end_page`     | integer | Last page to scrape              | `10` (≈ top 100)          |
| `collapse_aio` | boolean | Collapse the AI Overview section | `true`, `false` (default) |

<Tip>
  **Page ranges:** Use `start_page` and `end_page` to control depth:

  * `1..2` ≈ Top 20 results
  * `1..5` ≈ Top 50 results
  * `1..10` ≈ Top 100 results

  Smaller ranges complete faster and return smaller payloads.
</Tip>

## AI Overview extraction

The API automatically captures **Google's AI Overview** when available for your search query.

### What is AI Overview?

AI Overview is Google's AI-generated summary that appears at the top of search results. It provides quick answers synthesized from multiple sources.

### Response field

The AI Overview text is returned in the `aio_text` field:

```json theme={null}
{
  "keyword": "does honey expire?",
  "aio_text": "No, pure honey does not expire , as its high sugar content, low moisture, and acidity create an environment hostile to bacteria. While pure honey can last indefinitely, commercial honey may have a \"best by\" date for quality rather than safety...",
  "organic": [...],
  "people_also_ask": [...]
}
```

<Note>
  **AI Overview availability:** The `aio_text` field will be `null` or empty if no AI Overview is shown for your search.
</Note>

### Controlling AI Overview visibility

Use the `collapse_aio` parameter to control whether the AI Overview section is expanded or collapsed in the returned SERP.

| Value                | Behavior                          |
| -------------------- | --------------------------------- |
| `collapse_aio=true`  | AI Overview is collapsed          |
| `collapse_aio=false` | AI Overview is expanded (default) |

Collapsing AI Overview prevents it from pushing organic results down the page, which produces more stable pixel-position metrics and consistent layout data comparable to historical baselines.

```json theme={null}
{
  "url": "https://www.google.com/",
  "keyword": "pizza",
  "language": "en",
  "country": "US",
  "start_page": 1,
  "end_page": 10,
  "collapse_aio": true
}
```

### Example processing

```js theme={null}
const results = await response.json();

results.forEach(result => {
  if (result.aio_text) {
    console.log('AI Overview:', result.aio_text);
    
    // Split into sections
    const sections = result.aio_text.split('\n\n');
    sections.forEach(section => console.log(section));
  }
});
```

## Understanding the async workflow

Scrapers is asynchronous. Here's how it works:

1. **Trigger** your request → receive a `snapshot_id`
2. **Monitor** progress using the `snapshot_id`
3. **Download** results when complete

### Which API endpoints to call

| Action           | Method | Endpoint                                               |
| ---------------- | ------ | ------------------------------------------------------ |
| Trigger request  | POST   | `/datasets/v3/trigger?dataset_id=gd_mfz5x93lmsjjjylob` |
| Check progress   | GET    | `/datasets/v3/progress/{snapshot_id}`                  |
| Download results | GET    | `/datasets/v3/snapshot/{snapshot_id}`                  |

<Info>
  Learn more about the async workflow in [Asynchronous Requests](/scraping-automation/serp-api/asynchronous-requests).
</Info>

### Complete workflow example

<CodeGroup>
  ```js Node.js theme={null}
  import fetch from "node-fetch";

  const API_KEY = process.env.API_KEY;
  const DATASET_ID = "gd_mfz5x93lmsjjjylob";

  // Step 1: Trigger request
  const triggerRes = await fetch(
    `https://api.brightdata.com/datasets/v3/trigger?dataset_id=${DATASET_ID}&include_errors=true`,
    {
      method: "POST",
      headers: {
        "Content-Type": "application/json",
        Authorization: `Bearer ${API_KEY}`,
      },
      body: JSON.stringify([
        {
          url: "https://www.google.com/",
          keyword: "pizza",
          language: "en",
          country: "US",
          start_page: 1,
          end_page: 10,
        },
      ]),
    }
  );

  const { snapshot_id } = await triggerRes.json();

  // Step 2: Poll for completion
  let progress;
  do {
    await new Promise((resolve) => setTimeout(resolve, 5000)); // Wait 5 seconds
    const progressRes = await fetch(
      `https://api.brightdata.com/datasets/v3/progress/${snapshot_id}`,
      {
        headers: { Authorization: `Bearer ${API_KEY}` },
      }
    );
    progress = await progressRes.json();
  } while (progress.status !== "ready");

  // Step 3: Download results
  const downloadRes = await fetch(
    `https://api.brightdata.com/datasets/v3/snapshot/${snapshot_id}?format=json`,
    {
      headers: { Authorization: `Bearer ${API_KEY}` },
    }
  );

  const results = await downloadRes.json();
  console.log(results);
  ```

  ```python Python theme={null}
  import os
  import time
  import requests

  API_KEY = os.getenv("API_KEY")
  DATASET_ID = "gd_mfz5x93lmsjjjylob"

  # Step 1: Trigger request
  trigger_url = f"https://api.brightdata.com/datasets/v3/trigger?dataset_id={DATASET_ID}&include_errors=true"
  trigger_response = requests.post(
      trigger_url,
      headers={
          "Content-Type": "application/json",
          "Authorization": f"Bearer {API_KEY}",
      },
      json=[
          {
              "url": "https://www.google.com/",
              "keyword": "pizza",
              "language": "en",
              "country": "US",
              "start_page": 1,
              "end_page": 10,
          }
      ],
  )

  snapshot_id = trigger_response.json()["snapshot_id"]

  # Step 2: Poll for completion
  progress = None
  while progress is None or progress["status"] != "ready":
      time.sleep(5)  # Wait 5 seconds
      progress_url = f"https://api.brightdata.com/datasets/v3/progress/{snapshot_id}"
      progress_response = requests.get(
          progress_url,
          headers={"Authorization": f"Bearer {API_KEY}"},
      )
      progress = progress_response.json()

  # Step 3: Download results
  download_url = f"https://api.brightdata.com/datasets/v3/snapshot/{snapshot_id}?format=json"
  download_response = requests.get(
      download_url,
      headers={"Authorization": f"Bearer {API_KEY}"},
  )

  results = download_response.json()
  print(results)
  ```
</CodeGroup>

## How to configure advanced options

### Batch multiple queries

Process multiple search queries in one request:

```json theme={null}
[
  {
    "url": "https://www.google.com/",
    "keyword": "pizza",
    "language": "en",
    "country": "US",
    "start_page": 1,
    "end_page": 10
  },
  {
    "url": "https://www.google.com/",
    "keyword": "coffee",
    "language": "de",
    "country": "DE",
    "start_page": 1,
    "end_page": 10
  },
  {
    "url": "https://www.google.com/",
    "keyword": "running shoes",
    "language": "en",
    "country": "GB",
    "start_page": 1,
    "end_page": 5
  }
]
```

### Mobile search results

Add `"brd_mobile": true` to get mobile SERP data:

```bash cURL theme={null}
curl -X POST "https://api.brightdata.com/datasets/v3/trigger?dataset_id=gd_mfz5x93lmsjjjylob&include_errors=true" \
  -H "Authorization: Bearer ${API_KEY}" \
  -H "Content-Type: application/json" \
  -d '[{
      "url": "https://www.google.com/",
      "keyword": "running shoes",
      "language": "en",
      "country": "US",
      "start_page": 1,
      "end_page": 10,
      "brd_mobile": true
    }]'
```

### Get results from the Web tab (udm=14)

The Google `udm` parameter defines which search tab the SERP comes from. The Bright Data SERP Scraper maps the native Google `udm` value to its own request parameter, `udm_web`.

To return results from the **Web** tab (`udm=14` on Google), set `udm_web` to `true` in your request:

<Note>
  The `udm_web` parameter cannot be combined with the `tbm` parameter.
</Note>

```bash cURL theme={null}
curl -X POST "https://api.brightdata.com/datasets/v3/trigger?dataset_id=gd_mfz5x93lmsjjjylob&include_errors=true" \
  -H "Authorization: Bearer ${API_KEY}" \
  -H "Content-Type: application/json" \
  -d '[{
    "url": "https://www.google.com/",
    "keyword": "pizza kraków",
    "language": "pl",
    "country": "PL",
    "uule": "w+CAIQICIGUG9sYW5k",
    "udm_web": true,
    "include_paginated_html": true
  }]'
```

### Include HTML snapshots

Capture raw HTML alongside parsed data for auditing or custom parsing:

```json theme={null}
{
  "url": "https://www.google.com/",
  "keyword": "pizza",
  "language": "en",
  "country": "US",
  "start_page": 1,
  "end_page": 10,
  "include_paginated_html": true
}
```

When enabled, results include `pagination[].page_html` for each page.

### How to localize requests

Target specific markets with language and country combinations:

```json theme={null}
// German language, Germany location
{
  "keyword": "laufschuhe",
  "language": "de",
  "country": "DE",
  "start_page": 1,
  "end_page": 5
}

// English language, UK location
{
  "keyword": "trainers",
  "language": "en",
  "country": "GB",
  "start_page": 1,
  "end_page": 10
}

// Spanish language, Mexico location
{
  "keyword": "zapatos deportivos",
  "language": "es",
  "country": "MX",
  "start_page": 1,
  "end_page": 10
}
```

## Frequently asked questions

<AccordionGroup>
  <Accordion title="How do I select specific output fields?">
    You can choose which parsed fields to return for all pages. To also include raw HTML for each page, add `"include_paginated_html": true` to your request. This returns `pagination[].page_html` alongside parsed fields.
  </Accordion>

  <Accordion title="Can I control AI Overview (AIO) visibility?">
    Yes. Use the `collapse_aio` boolean parameter to control AI Overview visibility:

    * `collapse_aio=true`, AI Overview is collapsed, keeping organic results in stable positions
    * `collapse_aio=false`, AI Overview is expanded (default behavior)

    Collapsing AIO is useful when consistent pixel-position metrics or layout comparisons against historical data are required.
  </Accordion>

  <Accordion title="What changed with the browser worker implementation?">
    We now use a browser worker for SERP scraping. This reduces duplicate results, improves session continuity across pagination, and enables richer outputs (such as AI Overview). All existing requests remain backward-compatible.
  </Accordion>

  <Accordion title="How does pricing work for top 100 results?">
    One successful API call = one billable request, even when it returns 100+ results across 10 pages. Retries are included automatically, and there are no additional bandwidth fees. See [SERP Pricing & Billing](/scraping-automation/serp-api/pricing-and-billing) for full details.
  </Accordion>

  <Accordion title="What is the difference between language and country parameters?">
    * `language`: Controls the UI language Google uses (e.g., `"en"`, `"de"`, `"es"`)
    * `country`: Controls the geographic location for results (e.g., `"US"`, `"DE"`, `"MX"`)

    These can be combined independently to target specific markets.
  </Accordion>

  <Accordion title="How long does it take to get results?">
    Time varies based on query complexity and page depth. Smaller page ranges (e.g., `1..2`) complete faster than larger ranges (e.g., `1..10`). Use the Progress API to monitor your request status.
  </Accordion>

  <Accordion title="How to use tbs parameter?">
    Common usages for tbs to filter by date are:

    * Past hour:  tbs=qdr:h
    * Past 24 hours: tbs=qdr:d
    * Past week:  tbs=qdr:w
    * Past month:  tbs=qdr:m
    * Past year:  tbs=qdr:y\
       

    You can also set a custom range using tbs=cdr:1,cd\_min:MM/DD/YYYY,cd\_max:MM/DD/YYYY\
    Example:\
    ...\&tbs=cdr:1,cd\_min:1/1/2024,cd\_max:2/1/2024
  </Accordion>
</AccordionGroup>

## Next steps

<CardGroup>
  <Card title="Pricing & Billing" icon="credit-card" href="/scraping-automation/serp-api/pricing-and-billing">
    Understand how requests are billed
  </Card>

  <Card title="Google query parameters" icon="sliders" href="/scraping-automation/serp-api/query-parameters/google">
    Explore all available parameters
  </Card>

  <Card title="Parsed JSON results" icon="code" href="/scraping-automation/serp-api/parsed-json-results/parsing-search-results">
    Learn about the response structure
  </Card>

  <Card title="Asynchronous requests" icon="clock" href="/scraping-automation/serp-api/asynchronous-requests">
    Deep dive into the async workflow
  </Card>
</CardGroup>


# Guidelines for getting more Google ads
Source: https://docs.brightdata.com/scraping-automation/serp-api/guidelines-for-getting-more-google-ads

Structure Bright Data SERP API requests across 31 languages to maximize paid-ad coverage. Tune query intent, vertical, geo and device for higher ad density.

This document covers the key strategies for structuring Google SERP requests so that more paid ads appear in the response. This is relevant for use cases like competitive intelligence, ad monitoring, ad verification, PPC research, and SERP data collection at scale.

Google's SERP is dynamic, not every query returns ads. Getting more ads in your SERP results requires understanding what triggers them.

This article quotes data and information from studies and knowledge we have collected: since ad presentation logic and strategy may change, those guidelines are provided as heuristics and initial direction for investigationa and implementation and may change over time.

***

## Understanding the Context

Not all Google searches return ads. Google only serves paid results when it determines that the user's query has purchasing or commercial intent. This means the way a query is phrased, the niche it targets, the geography it is served in, and the technical setup of the request all play a role in how many ads appear. Optimizing each of these layers will consistently increase the number of ads returned per SERP request.

***

## Part 1. Query-Level Triggers: What Types of Queries Return More Ads

### Use Commercial and Transactional Intent Keywords

The single most reliable way to get ads in a SERP is to use commercial or transactional-intent queries. Google serves ads when users are perceived as likely to purchase. The following table shows how different intent types affect ad density:

| Intent Type   | Example Modifiers                   | Ad Rate   |
| ------------- | ----------------------------------- | --------- |
| Transactional | buy, shop, price, affordable, order | Very High |
| Commercial    | best, top, reviews, compare, deals  | High      |
| Informational | how to, what is, why                | Low       |
| Navigational  | Brand names alone                   | Low       |

Transactional "buy" keywords return shopping boxes in over 80% of SERPs. "Affordable" returns shopping results in over 73% of cases.

***

### Target High-Ad-Density Niches

Certain niches are heavily monetized and nearly always show ads. Prioritizing keywords from these verticals will produce higher ad yield per request:

| Niche                | Approximate Ad Presence |
| -------------------- | ----------------------- |
| Fashion and Beauty   | 83%                     |
| Pets                 | 80%                     |
| Ecommerce and Retail | 78%                     |
| Healthcare           | 65%                     |
| Insurance            | 42%                     |
| Legal                | High                    |
| Finance              | High                    |

***

### Use 3 to 4 Word Middle-Tail Queries

Query length significantly affects whether ads appear. Research across over 100,000 keywords shows that 3-word and 4-word queries produce the highest rate of ad appearances, at approximately 15.75% and 15.54% respectively. Single-word or very long queries produce significantly fewer ads.

Middle-tail queries strike a balance between specificity and search volume, making them ideal for triggering advertiser competition. An example would be "buy running shoes online" rather than just "shoes" or "what are the best minimalist running shoes for flat feet and knee problems."

***

### Append Proven Commercial Modifiers to Base Keywords

To systematically trigger ads, append intent modifiers to core product or service keywords.

Transactional modifiers with the highest ad density:

* buy, shop, order, purchase, cheap, affordable, discount, deals, free shipping, coupon

Commercial modifiers with strong ad density:

* best, top, reviews, compare, vs, price, cost, rated

For example, instead of using "running shoes," use "buy running shoes cheap" or "best running shoes price 2025."

***

## Part 2. Request Configuration: Technical Setup for More Ads

### Set the Right Geo-Location

Ads are far more concentrated in certain markets. Google's ad inventory is densest in the United States, followed by the United Kingdom, Australia, and Canada. When configuring SERP requests, setting the country parameter to the US and the language to English will produce maximum ad yield. Localized markets in developing regions will return significantly fewer or no ads.

***

### Use Desktop Device Emulation

There is a significant difference in ad rates between desktop and mobile. Desktop SERPs return higher ad volumes, with up to four text ads at the top and additional shopping carousels. Mobile SERPs, particularly when AI Overviews are present, return ads in only a small fraction of queries. For collecting more ads, desktop results should be the default target.

***

### Avoid Personalized or Logged-In Sessions

Personalized Google sessions can suppress ads if the user's history suggests a purchase has already been made or if behavioral targeting has deprioritized certain ad categories. For consistent and maximum ad results, use clean sessions with no browsing history, disable personalization where possible, and rotate session cookies when operating at scale.

***

### Avoid Queries That Trigger AI Overviews

Research shows that 87% of SERPs that contain an AI Overview show no ads at all. Since AI Overviews expanded significantly in 2024 and 2025, they have become a major suppressor of ad display. To avoid this, prefer queries that are clearly commercial or transactional, as AI Overviews rarely appear for purchase-intent searches. Purely informational queries such as "how to" or "what is" are the most likely to trigger AI Overviews and the least likely to return ads.

***

## Part 3. Ad Types and How to Trigger Each

### How to trigger text ads

Text ads appear at the top and bottom of search results and are the most common ad format. They are triggered by keyword searches with commercial or transactional intent. High-CPC categories such as legal, insurance, and finance almost always return text ads, with up to four appearing at the top of the page.

### How to trigger shopping ads

Shopping ads appear as visual product carousels with images, prices, and merchant information. They are triggered by product-specific searches that include terms like buy, shop, price, or deals. Including a brand name alongside the product type produces the best results. For example: "Nike running shoes buy."

### Local Services Ads

Local Services Ads are triggered by local combined with service-category queries, such as "plumber near me" or "lawyer in New York." Appending a city name or the phrase "near me" to a service keyword is the most reliable way to trigger this format.

***

## Part 4. Targeting High-CPC Keywords for Maximum Ad Slots

High-CPC keywords attract more advertisers, which fills more ad slots on the SERP. The following categories consistently produce the highest ad density:

| Category                   | Typical CPC Range |
| -------------------------- | ----------------- |
| Legal (lawyers, attorneys) | \$50 to \$100+    |
| Insurance                  | \$30 to \$60      |
| Finance, Loans, Credit     | \$20 to \$50      |
| Healthcare and Medical     | \$15 to \$40      |
| Real Estate                | \$10 to \$25      |
| SaaS and B2B Software      | \$10 to \$50      |

Searching for "personal injury lawyer \[city]" or "business insurance quote" will almost always return three to four text ads at the top of the page.

***

## Part 5. Scaling Tips for Systematic Ad Collection

***

### Use Standard Result Sets

As of early 2025, Google removed support for the num=100 parameter that previously allowed 100 results per page. The most stable approach is to use the default 10-result page. Standard result pages reliably return up to four text ads at the top, up to three text ads at the bottom, and shopping carousels where applicable.

***

### Target Queries at Peak Advertiser Hours

Ad auctions are dynamic and advertiser budgets fluctuate throughout the day. More advertisers compete during business hours, particularly on weekdays. The best windows for returning a full set of ads are Tuesday through Thursday between 9am and 5pm in the target geography. Weekends and late-night queries often return fewer ads as daily budgets exhaust or campaigns are paused.

***

## Part 6. Ad Position Reference

The following breakdown shows where ads typically appear in a standard non-AI Overview SERP:

| Ad Position             | Trigger                           | Notes                        |
| ----------------------- | --------------------------------- | ---------------------------- |
| Text ads at the top     | High-competition commercial terms | Up to 4 ads                  |
| Shopping carousels      | Product-specific queries          | Appear above organic results |
| Text ads at the bottom  | Most commercial queries           | Up to 3 ads                  |
| Text ads top and bottom | Highly commercial queries         | Maximum coverage             |

***

## Part 7. Example Queries Designed to Return Maximum Ads

The following query structures are designed to reliably produce high ad density across different formats:

* "buy car insurance online cheap", text ads and shopping
* "best personal injury lawyer New York", four top text ads
* "compare health insurance plans 2025", text ads and shopping
* "affordable running shoes free shipping", shopping carousel and text ads
* "online MBA program cost", text ads in a high-CPC education category
* "best CRM software for small business", text and shopping ads
* "deals on laptops buy now", heavy shopping ads
* "home loan rates today", text ads in a high-CPC finance category

***

## What to remember

Getting more ads in Google SERP results is primarily a function of query intent, niche selection, geography, and technical configuration. Commercial and transactional queries in high-value niches, targeted at US audiences on desktop devices, using clean sessions and residential proxies through a reliable SERP API, will consistently return the highest number of paid results per request. Avoiding informational queries, AI Overview triggers, and personalized sessions are equally important in ensuring maximum ad yield.


# Introduction to SERP API
Source: https://docs.brightdata.com/scraping-automation/serp-api/introduction

Use the Bright Data SERP API to collect structured search results from Google, Bing and other engines in under 1 second per request, with no proxy setup.

Collect search engine results at scale without managing proxies, CAPTCHAs, or parsing. Get structured data from Google, Bing, and other search engines in under 1 second.

**Perfect for:**

* SEO rank tracking and keyword monitoring
* AI agents performing web search and data enrichment
* Brand protection and ad intelligence
* Competitive market research and price comparison

<Tip>
  Pay only for successful delivery.
</Tip>

## Before you start

1. Sign in: [https://brightdata.com/cp/start](https://brightdata.com/cp/start)
2. Create a SERP API: [https://brightdata.com/cp/learn\_more/serp-api](https://brightdata.com/cp/learn_more/serp-api)
3. Get your API key: [/api-reference/authentication](/api-reference/authentication#how-do-i-authenticate-with-api-key%3F)

<Tip>
  New to Bright Data? See the step-by-step guide: [/scraping-automation/serp-api/quickstart](/scraping-automation/serp-api/quickstart)
</Tip>

## Quickstart

A minimal request with cURL. Replace `<BRIGHT_DATA_API_KEY>` and `zone` with your values:

<CodeGroup>
  ```shell cURL theme={null}
  curl -X POST https://api.brightdata.com/request \
    -H "Content-Type: application/json" \
    -H "Authorization: Bearer <BRIGHT_DATA_API_KEY>" \
    -d '{
      "zone": "YOUR_SERP_API_ZONE",
      "url": "https://www.google.com/search?q=pizza&hl=en&gl=us",
      "format": "raw"
    }'
  ```

  ```javascript Node.js theme={null}
  // Node 18+ (global fetch)
  const resp = await fetch('https://api.brightdata.com/request', {
    method: 'POST',
    headers: {
      'Content-Type': 'application/json',
      'Authorization': 'Bearer <BRIGHT_DATA_API_KEY>',
    },
    body: JSON.stringify({
      zone: 'YOUR_SERP_API_ZONE',
      url: 'https://www.google.com/search?q=pizza&hl=en&gl=us',
      format: 'raw' // set to "json" for parsed output
    }),
  });

  console.log(await resp.text());
  ```

  ```python Python theme={null}
  import requests

  headers = {
      'Content-Type': 'application/json',
      'Authorization': 'Bearer <BRIGHT_DATA_API_KEY>',
  }

  payload = {
      'zone': 'YOUR_SERP_API_ZONE',
      'url': 'https://www.google.com/search?q=pizza&hl=en&gl=us',
      'format': 'raw'  # set to "json" for parsed output
  }

  r = requests.post('https://api.brightdata.com/request',
                    headers=headers, json=payload)

  print(r.text)
  ```
</CodeGroup>

<Tip>
  Prefer Markdown output? Set <code>"data\_format": "markdown"</code> to receive Markdown SERP structure.
</Tip>

<Tip>
  Prefer JSON output? Set query parameter <code>"brd\_json=1"</code> to receive JSON SERP structure.
</Tip>

<CardGroup>
  <Card title="Run in Postman" icon="rocket" href="https://www.postman.com/bright-data-api/bright-data-api/request/kpq952m/google-search" />

  <Card title="Node.js example" icon="code" href="https://github.com/luminati-io/bright-data-serp-api-nodejs-project" />

  <Card title="Python example" icon="code" href="https://github.com/brightdata/bright-data-serp-api-python-project" />
</CardGroup>

## What you'll get (parsed JSON preview)

A compact look at the parsed structure you can expect:

```json theme={null}
{
  "engine": "google",
  "query": "pizza",
  "results": [
    { 
      "type": "organic", 
      "position": 1, 
      "title": "Best Pizza Near Me", 
      "url": "https://example.com" 
    }
  ]
}
```

See the full schema and examples: [/scraping-automation/serp-api/parsed-json-results/parsing-search-results](/scraping-automation/serp-api/parsed-json-results/parsing-search-results#expected-parsed-output-when-using-brd-json%3D1)

## Supported engines and parameters

* Google, Bing, DuckDuckGo, Yandex, Baidu, Yahoo, Naver
* Engine-specific query parameters:
  * Google: [/scraping-automation/serp-api/query-parameters/google](/scraping-automation/serp-api/query-parameters/google)
  * Bing: [/scraping-automation/serp-api/query-parameters/bing](/scraping-automation/serp-api/query-parameters/bing)

## How SERP API performs

### Get only top 10 results (faster response)

If you only need the top 10 organic results without ads or knowledge panels, add `"data_format": "parsed_light"` for faster response times:

<CodeGroup>
  ```bash cURL highlight={8} theme={null}
  curl -X POST 'https://api.brightdata.com/request' \
    -H 'Authorization: Bearer <API_KEY>' \
    -H 'Content-Type: application/json' \
    -d '{
      "zone": "<ZONE_NAME>",
      "url": "https://www.google.com/search?q=pizza&hl=en&gl=us",
      "format": "raw",
      "data_format": "parsed_light"
    }'
  ```

  ```javascript scrape.js highlight={11} theme={null}
  const response = await fetch('https://api.brightdata.com/request', {
    method: 'POST',
    headers: {
      'Authorization': 'Bearer <API_KEY>',
      'Content-Type': 'application/json'
    },
    body: JSON.stringify({
      zone: '<ZONE_NAME>',
      url: 'https://www.google.com/search?q=pizza&hl=en&gl=us',
      format: 'raw',
      data_format: 'parsed_light'
    })
  });

  const data = await response.json();
  console.log(data.organic);  // Array of top 10 results
  ```

  ```python scrape.py highlight={8} theme={null}
  response = requests.post(
      'https://api.brightdata.com/request',
      headers={'Authorization': 'Bearer <API_KEY>'},
      json={
          'zone': '<ZONE_NAME>',
          'url': 'https://www.google.com/search?q=pizza&hl=en&gl=us',
          'format': 'raw',
          'data_format': 'parsed_light'
      }
  )

  data = response.json()
  print(data['organic'])  # Array of top 10 results
  ```
</CodeGroup>

Response Example:

```json successful JSON response theme={null}
{
  "organic": [
    {
      "link": "https://example.com/pizza",
      "title": "Best Pizza in NYC - Joe's Pizza",
      "description": "Family-owned pizzeria serving authentic New York slices since 1975...",
      "global_rank": 1
    },
    {
      "link": "https://example.com/pizza-guide",
      "title": "Top 10 Pizza Places in NYC",
      "description": "Discover the highest-rated pizza restaurants across all five boroughs...",
      "global_rank": 2,
      "extensions": [
        {
          "type": "site_link",
          "link": "https://example.com/pizza-guide/brooklyn",
          "text": "Brooklyn"
        }
      ]
    }
    // ... 8 more results
  ]
}
```

### Sub-1-second response time

Get complete SERP results (organic, ads, knowledge panels, and all elements) in **under 1 second** with premium routing infrastructure designed for mission-critical AI applications.

**Ideal for:**

* AI agents performing real-time data enrichment
* Multi-step research workflows and fact verification
* Model evaluation and response grounding
* User-facing search applications requiring instant results

<Note>Contact your Account Manager or [sales@brightdata.com](mailto:sales@brightdata.com) to request access.</Note>

## When to use asynchronous requests

Use async for large volumes, slower pages, or long-running queries. This improves reliability and throughput.

* Guide: [/scraping-automation/serp-api/asynchronous-requests](/scraping-automation/serp-api/asynchronous-requests)

<Tip>
  Targeting non-SERP pages? Use the Web Unlocker API: [/scraping-automation/web-unlocker](/scraping-automation/web-unlocker)
</Tip>

## Troubleshooting quick hits

* **401/403**: Check your API key and zone permissions. See: [/api-reference/authentication](/api-reference/authentication)
* **429**: Reduce concurrency or switch to async. See: [/scraping-automation/serp-api/asynchronous-requests](/scraping-automation/serp-api/asynchronous-requests)
* **Empty/partial results**: Verify engine-specific parameters (e.g., `hl`, `gl`, `uule`, `location`). See: engine query parameters above.
* **Unexpected results:** This may occur when using non-latin letters. Google search query requests demands encoding the query request in that case.
* **Still stuck?** See FAQs: [/scraping-automation/serp-api/faqs](/scraping-automation/serp-api/faqs)

## Next steps

<CardGroup>
  <Card title="Send your first request" icon="bolt" href="/scraping-automation/serp-api/send-your-first-request" />

  <Card title="SERP Pricing & Billing" icon="dollar-sign" href="/scraping-automation/serp-api/pricing-and-billing" />

  <Card title="Query parameters (Google)" icon="sliders" href="/scraping-automation/serp-api/query-parameters/google" />

  <Card title="Parsed JSON results" icon="list" href="/scraping-automation/serp-api/parsed-json-results/parsing-search-results" />

  <Card title="Asynchronous requests" icon="clock" href="/scraping-automation/serp-api/asynchronous-requests" />

  <Card title="Quick Start" icon="road" href="/scraping-automation/serp-api/quickstart" />

  <Card title="FAQs" icon="circle-question" href="/scraping-automation/serp-api/faqs" />
</CardGroup>


# Bing to Bright Data SERP migration guide
Source: https://docs.brightdata.com/scraping-automation/serp-api/parsed-json-results/bing-to-bright-data-serp-migration-guide

Migrate from the retired Microsoft Bing Search API to the Bright Data SERP API (31 languages) for Bing. Step-by-step request mapping and response examples.

<Warning>
  [Microsoft Bing Search APIs retiring on August 11, 2025](https://learn.microsoft.com/en-us/lifecycle/announcements/bing-search-api-retirement). Bright Data SERP API for Bing domain continues to be supported.
</Warning>

<Info>
  **Migration benefits**

  * Drop-in replacement with minimal code changes
  * 1:1 compatible JSON response schema
  * Enhanced request flexibility supporting both query-based and URL-based requests
</Info>

## Quick start migration (5 Minutes)

<Steps>
  <Step title="Get your API Key">
    [Sign up for Bright Data](https://brightdata.com/?hs_signup=1\&utm_source=docs) and get your API key from the dashboard.
  </Step>

  <Step title="Update your endpoint">
    Replace `api.bing.microsoft.com` with `api.brightdata.com/request`
  </Step>

  <Step title="Add parameters in body & test your first request">
    ```bash theme={null}
    curl -X POST 'https://api.brightdata.com/request' \
      -H "Authorization: Bearer YOUR_API_KEY" \
      -H "Content-Type: application/json" \
      -d '{
        "search_engine": "bing",
        "query": "test search",
        "data_format": "parsed_bing_api",
        "format": "json",
        "zone": "your_zone_name_"
      }'
    ```
  </Step>
</Steps>

## Step-by-step migration guide

### Step 1: Account setup

<AccordionGroup>
  <Accordion title="1.1 Create Bright Data account">
    1. Visit [brightdata.com/signup](https://brightdata.com/?hs_signup=1\&utm_source=docs)
    2. Navigate to **Zones** → **Create Zone** → **SERP API**
    3. Copy your API key credentials
  </Accordion>

  <Accordion title="1.2 Configure Authentication">
    Replace your Bing API key with Bright Data credentials:

    **Before (Bing):**

    ```http theme={null}
    Ocp-Apim-Subscription-Key: YOUR_BING_KEY
    ```

    **After (Bright Data):**

    ```http theme={null}
    Authorization: Bearer YOUR_BRIGHTDATA_API_KEY
    ```
  </Accordion>
</AccordionGroup>

### Step 2: Update request format

<Tabs>
  <Tab title="cURL">
    **Before (Bing API):**

    ```bash theme={null}
    curl -X GET "https://api.bing.microsoft.com/v7.0/search?q=openai" \
      -H "Ocp-Apim-Subscription-Key: YOUR_BING_KEY"
    ```

    **After (Bright Data):**

    ```bash theme={null}
    curl -X POST "https://api.brightdata.com/request" \
      -H "Authorization: Bearer YOUR_API_KEY" \
      -H "Content-Type: application/json" \
      -d '{
        "search_engine": "bing",
        "query": "openai",
        "data_format": "parsed_bing_api",
        "format": "json",
        "zone": "your_zone_name"
      }'
    ```
  </Tab>

  <Tab title="Python">
    **Before (Bing API):**

    ```python theme={null}
    import requests

    headers = {
        'Ocp-Apim-Subscription-Key': 'YOUR_BING_KEY'
    }

    response = requests.get(
        'https://api.bing.microsoft.com/v7.0/search',
        headers=headers,
        params={'q': 'openai'}
    )
    ```

    **After (Bright Data):**

    ```python theme={null}
    import requests

    headers = {
        'Authorization': 'Bearer YOUR_API_KEY',
        'Content-Type': 'application/json'
    }

    payload = {
        'search_engine': 'bing',
        'query': 'openai',
        'data_format': 'parsed_bing_api',
        'format': 'json',
        'zone': 'your_zone_name'
    }

    response = requests.post(
        'https://api.brightdata.com/request',
        headers=headers,
        json=payload
    )
    ```
  </Tab>

  <Tab title="Node.js">
    **Before (Bing API):**

    ```javascript theme={null}
    const axios = require('axios');

    const response = await axios.get(
        'https://api.bing.microsoft.com/v7.0/search',
        {
            headers: {
                'Ocp-Apim-Subscription-Key': 'YOUR_BING_KEY'
            },
            params: { q: 'openai' }
        }
    );
    ```

    **After (Bright Data):**

    ```javascript theme={null}
    const axios = require('axios');

    const response = await axios.post(
        'https://api.brightdata.com/request',
        {
            search_engine: 'bing',
            query: 'openai',
            data_format: 'parsed_bing_api',
            format: 'json',
            zone: 'your_zone_name'
        },
        {
            headers: {
                'Authorization': 'Bearer YOUR_API_KEY',
                'Content-Type': 'application/json'
            }
        }
    );
    ```
  </Tab>
</Tabs>

### Step 3: Handle response format

The response format remains identical to Bing's API when using `data_format: "parsed_bing_api"`:

<CodeGroup>
  ```json Response Structure theme={null}
  {
    "_type": "SearchResponse",
    "queryContext": {
      "originalQuery": "openai"
    },
    "webPages": {
      "totalEstimatedMatches": 12300000,
      "value": [
        {
          "name": "OpenAI",
          "url": "https://openai.com/",
          "displayUrl": "openai.com",
          "snippet": "OpenAI is an AI research and deployment company..."
        }
      ]
    },
    "images": { "value": [...] },
    "videos": { "value": [...] },
    "relatedSearches": { "value": [...] }
  }
  ```

  ```python Parse Results theme={null}
  # Your existing Bing API parsing code works unchanged
  data = response.json()

  # Extract web results
  web_results = data.get('webPages', {}).get('value', [])
  for result in web_results:
      print(f"Title: {result['name']}")
      print(f"URL: {result['url']}")
      print(f"Snippet: {result['snippet']}")

  # Extract images
  images = data.get('images', {}).get('value', [])
  for image in images:
      print(f"Image: {image['thumbnailUrl']}")
  ```
</CodeGroup>


# Parsed JSON results with SERP API
Source: https://docs.brightdata.com/scraping-automation/serp-api/parsed-json-results/parsing-search-results

Use Bright Data SERP API parsing to convert raw HTML responses into structured JSON for Google and Bing. Covers 12 countries.

## What is Parsing?

[Parsing](https://brightdata.com/blog/web-data/what-is-data-parsing) for SERP API is the process of transforming a raw HTML response into a **structured JSON** with fields and values of data. This advanced parsing functionality is supported specifically for Google & Bing.

When parsing is activated, data from SERP HTMLs are further structured into usable fields and values (such as, `rank`, `link`, `title`, `description`, `rating`, and dozens more fields) enabling you to monitor competitor SERP rankings, analyze keyword trends, and gather valuable market insights.

## Which type of responses does Bright Data SERP provide?

Bright Data provides the following parsing options:

1. Raw HTML: no parsing at all. Get the HTML response as is.
2. Full JSON: our full interpertation of Google's SERP HTML to JSON.
3. Light JSON: a subset of full JSON, including only the organic results and google's "Top Stories" .
4. Parsed Bing: our full interpertation of Bing's SERP HTML to JSON.
5. Markdown: our full interpertation of Google's and Bing's SERP HTML to markdown `*.md` file.
6. Screenshot: an image capture of the SERP HTML page as interperted by a browser.

## Overriding default configuration

In order to override default data format, learn how to use the designated header parameter here: [https://docs.brightdata.com/scraping-automation/serp-api/features](/scraping-automation/serp-api/features)

***

## Google response schema: Light JSON

This schema usually returns twice as fast as the Full JSON. It includes 10 organic reults and covers less components than full JSON.

## Response Format

A successful response may contain the following top-level fields depending on the query. Only `organic` is guaranteed in every response.

***

### `general` object

Returned in every Light JSON response. Reports the query you sent and the query Google actually ran, which lets you detect when Google truncates a search.

| Field            | Type   | Description                                                                                                                |
| ---------------- | ------ | -------------------------------------------------------------------------------------------------------------------------- |
| `query`          | string | The search query you submitted                                                                                             |
| `detected_query` | string | The query Google actually returned results for. Differs from `query` when Google corrects spelling or truncates the search |

<Note>
  If `detected_query` differs from `query`, check for a `spelling` object in the response. If `spelling` is present, the difference is due to automatic spelling correction and the response is valid. If `spelling` is absent, the query was cloaked and results were returned for a truncated version of the original query. See [How to detect query truncation](/scraping-automation/serp-api/debugging#how-to-detect-query-truncation).
</Note>

***

### `spelling` object

Returned in a Light JSON response only when Google applies or suggests a spelling correction. All fields are nullable and appear only when Google provides that variant.

| Field                 | Type           | Description                                                           |
| --------------------- | -------------- | --------------------------------------------------------------------- |
| `original_text`       | string \| null | The original query keyword before correction                          |
| `original_link`       | string \| null | Google search URL for the original query                              |
| `auto_corrected_text` | string \| null | The corrected keyword Google searched instead                         |
| `auto_corrected_link` | string \| null | Google search URL for the corrected query                             |
| `auto_included_text`  | string \| null | Term Google automatically included in the search                      |
| `auto_included_link`  | string \| null | Google search URL for the auto-included term                          |
| `suggested_text`      | string \| null | Keyword Google suggests ("Did you mean") without changing the results |
| `suggested_link`      | string \| null | Google search URL for the suggested query                             |
| `original_empty`      | boolean        | `true` when Google returned no results for the original query         |

***

### `organic` array, required

The primary list of web search results.

| Field         | Type    | Required | Description                                |
| ------------- | ------- | -------- | ------------------------------------------ |
| `global_rank` | integer | Yes      | Rank position of the result on the page    |
| `title`       | string  | No       | Title of the result                        |
| `link`        | string  | No       | URL of the result page                     |
| `description` | string  | No       | Snippet/summary shown in the search result |
| `image`       | string  | No       | Image associated with the result           |
| `extensions`  | array   | No       | Site links or other extensions (see below) |

#### `extensions` items

| Field         | Type    | Required | Description                               |
| ------------- | ------- | -------- | ----------------------------------------- |
| `type`        | string  | Yes      | Extension type, e.g. `"site_link"`        |
| `text`        | string  | No       | Anchor text of the extension link         |
| `link`        | string  | No       | URL of the extension link                 |
| `description` | string  | No       | Description text, if available            |
| `extended`    | boolean | No       | Whether the extension is in expanded form |

***

### `top_ads` / `bottom_ads` arrays

Paid advertisement results appearing above or below organic results.

| Field           | Type    | Required | Description                                          |
| --------------- | ------- | -------- | ---------------------------------------------------- |
| `global_rank`   | integer | Yes      | Rank position of the ad on the page                  |
| `title`         | string  | No       | Ad headline                                          |
| `link`          | string  | No       | Destination URL of the ad                            |
| `display_link`  | string  | No       | Displayed URL shown in the ad                        |
| `referral_link` | string  | No       | Referral tracking URL                                |
| `description`   | string  | No       | Ad description text                                  |
| `extensions`    | array   | No       | Ad extensions (same structure as organic extensions) |

***

### `top_stories` object

Google's Top Stories news carousel. Contains a `heading` label and an `items` array of inline news items.

| Field     | Type   | Required | Description                           |
| --------- | ------ | -------- | ------------------------------------- |
| `heading` | string | No       | Section heading, e.g. `"Top Stories"` |
| `items`   | array  | No       | List of inline news items (see below) |
| `posts`   | array  | No       | List of post items (see below)        |

#### `top_stories.items` items

| Field         | Type    | Required | Description                           |
| ------------- | ------- | -------- | ------------------------------------- |
| `global_rank` | integer | Yes      | Rank position of the item on the page |
| `title`       | string  | No       | Headline of the article               |
| `link`        | string  | No       | URL of the article                    |
| `story`       | string  | No       | Short summary or excerpt              |
| `image`       | string  | No       | Thumbnail image URL                   |

***

### `article_sets` array

Grouped article clusters organized by topic, each containing a `heading` label and an `items` array of inline news items. Not guaranteed to appear in every response, your implementation should handle its absence gracefully.

| Field     | Type   | Required | Description                                                       |
| --------- | ------ | -------- | ----------------------------------------------------------------- |
| `heading` | string | No       | Topic heading for the article cluster                             |
| `items`   | array  | No       | List of inline news items (same structure as `top_stories.items`) |
| `posts`   | array  | No       | List of post items (see below)                                    |

***

### `news` array

News results embedded in the search page.

| Field         | Type    | Required | Description                             |
| ------------- | ------- | -------- | --------------------------------------- |
| `global_rank` | integer | Yes      | Rank position of the result on the page |
| `title`       | string  | No       | Headline of the article                 |
| `link`        | string  | No       | URL of the article                      |
| `source`      | string  | No       | Publisher name                          |
| `source_logo` | string  | No       | Publisher logo URL                      |
| `date`        | string  | No       | Publication date/time                   |
| `description` | string  | No       | Article snippet                         |
| `image`       | string  | No       | Thumbnail image URL                     |

***

### `videos` array

Video results embedded in the search page.

| Field         | Type    | Required | Description                             |
| ------------- | ------- | -------- | --------------------------------------- |
| `global_rank` | integer | Yes      | Rank position of the result on the page |
| `title`       | string  | No       | Video title                             |
| `link`        | string  | No       | URL to the video                        |

***

### `shorts` array

Short-form video results embedded in the search page.

| Field         | Type    | Required | Description                             |
| ------------- | ------- | -------- | --------------------------------------- |
| `global_rank` | integer | Yes      | Rank position of the result on the page |
| `title`       | string  | No       | Title of the short video                |
| `link`        | string  | No       | URL to the short video                  |
| `image`       | string  | No       | Thumbnail image URL                     |

***

### `images` array

Image results embedded in the search page.

| Field             | Type    | Required | Description                             |
| ----------------- | ------- | -------- | --------------------------------------- |
| `global_rank`     | integer | Yes      | Rank position of the result on the page |
| `title`           | string  | No       | Image title                             |
| `link`            | string  | No       | URL of the source page                  |
| `image`           | string  | No       | Thumbnail image URL                     |
| `original_image`  | string  | No       | Full-resolution image URL               |
| `image_width`     | integer | No       | Displayed image width in pixels         |
| `image_height`    | integer | No       | Displayed image height in pixels        |
| `original_width`  | integer | No       | Original image width in pixels          |
| `original_height` | integer | No       | Original image height in pixels         |
| `blurred`         | boolean | No       | Whether the image is blurred            |
| `is_hidden`       | boolean | No       | Whether the images is hidden            |

***

### `shopping` array

Shopping results embedded within web search results.

| Field         | Type    | Required | Description                                   |
| ------------- | ------- | -------- | --------------------------------------------- |
| `global_rank` | integer | Yes      | Rank position of the result on the page       |
| `price`       | string  | Yes      | Displayed price of the product                |
| `link`        | string  | Yes      | URL to the product page                       |
| `title`       | string  | No       | Product name                                  |
| `shop`        | string  | No       | Merchant name                                 |
| `old_price`   | string  | No       | Original price before discount, if applicable |
| `rating`      | number  | No       | Product rating                                |
| `reviews_cnt` | integer | No       | Number of reviews                             |
| `image`       | string  | No       | Product image URL                             |

***

### `snack_pack_map` object

The map image associated with the local pack results.

| Field   | Type   | Description        |
| ------- | ------ | ------------------ |
| `image` | string | Map image URL      |
| `link`  | string | URL to Google Maps |

***

### `snack_pack` array

Local business results shown in the map pack.

| Field                 | Type             | Required | Description                                    |
| --------------------- | ---------------- | -------- | ---------------------------------------------- |
| `global_rank`         | integer          | Yes      | Rank position of the result on the page        |
| `name`                | string           | No       | Business name                                  |
| `link`                | string           | No       | URL to the business website                    |
| `cid`                 | string           | No       | Google Customer ID of the business             |
| `site`                | string           | No       | Business website domain                        |
| `address`             | string           | No       | Business address                               |
| `phone`               | string           | No       | Phone number                                   |
| `maps_link`           | string           | No       | URL to the business on Google Maps             |
| `rating`              | number           | No       | Average customer rating                        |
| `reviews_cnt`         | number           | No       | Total number of reviews                        |
| `work_status`         | string           | No       | Current open/closed status                     |
| `work_status_details` | string           | No       | Detailed status, e.g. `"Open until 10:00 PM"`  |
| `summary`             | string           | No       | Short description of the business              |
| `tags`                | array of strings | No       | Attribute tags, e.g. `["Dine-in", "Takeaway"]` |
| `image`               | string           | No       | Business image URL                             |

***

### `overview` object

Knowledge panel overview for an entity, parsed from featured snippet elements.

| Field   | Type   | Description                        |
| ------- | ------ | ---------------------------------- |
| `title` | string | Entity name                        |
| `kgmid` | string | Google Knowledge Graph ID          |
| `items` | array  | List of overview items (see below) |

#### `overview.items` items

| Field       | Type             | Description                             |
| ----------- | ---------------- | --------------------------------------- |
| `type`      | string           | Item type, e.g. `"fact"`, `"image"`     |
| `attrid`    | string           | Attribute identifier from Google's data |
| `title`     | string           | Label of the attribute                  |
| `values`    | array of strings | Attribute values                        |
| `href`      | string           | URL associated with the attribute       |
| `source`    | string           | Source name                             |
| `image`     | string           | Image URL, if applicable                |
| `image_alt` | string           | Alt text for the image                  |

***

### `perspectives` array

Perspective results from forums, social media, and editorial sources.

| Field         | Type    | Required | Description                             |
| ------------- | ------- | -------- | --------------------------------------- |
| `global_rank` | integer | Yes      | Rank position of the result on the page |
| `title`       | string  | No       | Perspective title                       |
| `link`        | string  | No       | URL to the full post                    |
| `image`       | string  | No       | Image URL                               |

***

### `latest_posts` array

Latest social or editorial posts widget.

| Field         | Type    | Required | Description                             |
| ------------- | ------- | -------- | --------------------------------------- |
| `global_rank` | integer | Yes      | Rank position of the result on the page |
| `title`       | string  | No       | Post title                              |
| `link`        | string  | No       | URL to the post                         |
| `image`       | string  | No       | Post image URL                          |

***

## Example Response

```JSON theme={null}
{
  "general": {
    "query": "pizza",
    "detected_query": "pizza"
  },
  "organic": [
    {
      "global_rank": 1,
      "title": "Pizza - Wikipedia",
      "link": "https://en.wikipedia.org/wiki/Pizza",
      "description": "Pizza is an Italian dish consisting of a flat base of leavened wheat-based dough topped with tomato, cheese, and other ingredients.",
      "image": "https://upload.wikimedia.org/wikipedia/commons/thumb/a/a3/pizza.jpg/220px.jpg",
      "extensions": [
        { "type": "site_link", "text": "Neapolitan pizza", "link": "https://en.wikipedia.org/wiki/Neapolitan_pizza", "extended": false },
        { "type": "site_link", "text": "Pizzeria", "link": "https://en.wikipedia.org/wiki/Pizzeria", "extended": false }
      ]
    },
    {
      "global_rank": 2,
      "title": "Pizza Hut | Delivery & Carryout - No One OutPizzas The Hut!",
      "link": "https://www.pizzahut.com/",
      "description": "Order pizza online for fast delivery or carryout from a store near you.",
      "extensions": [
        { "type": "site_link", "text": "Menu", "link": "https://www.pizzahut.com/menu", "extended": false }
      ]
    },
    {
      "global_rank": 3,
      "title": "Domino's Pizza - Order Online for Delivery or Carryout",
      "link": "https://www.dominos.com/",
      "description": "Order Domino's pizza online for delivery or carryout. Find deals, coupons, and track your order in real time.",
      "extensions": []
    }
  ],
  "top_ads": [
    {
      "global_rank": 4,
      "title": "Order Pizza Online — Fast Delivery Guaranteed",
      "link": "https://www.example-pizza-ad.com/order",
      "display_link": "www.example-pizza-ad.com",
      "referral_link": "https://www.example-pizza-ad.com/ref=google",
      "description": "Hot fresh pizza delivered to your door in 30 minutes or less.",
      "extensions": [
        { "type": "site_link", "text": "Order Now", "link": "https://www.example-pizza-ad.com/order" }
      ]
    }
  ],
  "top_stories": {
    "heading": "Top Stories",
    "items": [
      {
        "global_rank": 5,
        "title": "NYC Pizza Festival Returns for Its Biggest Year Yet",
        "link": "https://www.example-news.com/nyc-pizza-festival-2026",
        "story": "The annual NYC Pizza Festival is back with over 50 vendors and live entertainment.",
        "image": "https://www.example-news.com/images/pizza-festival.jpg"
      },
      {
        "global_rank": 6,
        "title": "The Science Behind the Perfect Pizza Crust",
        "link": "https://www.another-outlet.com/pizza-crust-science",
        "story": "Researchers reveal the chemistry that makes a pizza crust perfectly crispy.",
        "image": "https://www.another-outlet.com/images/pizza-crust.jpg"
      }
    ]
  },
  "article_sets": [
    {
      "heading": "Latest pizza news",
      "items": [
        {
          "global_rank": 7,
          "title": "World Record Pizza Baked in Naples",
          "link": "https://www.example-news.com/world-record-pizza",
          "story": "A team of chefs in Naples broke the world record for the longest pizza ever made.",
          "image": "https://www.example-news.com/images/record-pizza.jpg"
        }
      ]
    }
  ],
  "news": [
    {
      "global_rank": 8,
      "title": "Pizza Sales Surge as Comfort Food Trend Continues",
      "link": "https://www.example-business.com/pizza-sales-surge",
      "source": "Example Business News",
      "source_logo": "https://www.example-business.com/logo.png",
      "date": "3 hours ago",
      "description": "Pizza delivery and carryout sales have hit record highs this quarter.",
      "image": "https://www.example-business.com/images/pizza-sales.jpg"
    }
  ],
  "videos": [
    {
      "global_rank": 9,
      "title": "How to Make Perfect Homemade Pizza",
      "link": "https://www.youtube.com/watch?v=abc123"
    },
    {
      "global_rank": 10,
      "title": "Classic New York Pizza At Home",
      "link": "https://www.youtube.com/watch?v=def456"
    }
  ],
  "shorts": [
    {
      "global_rank": 11,
      "title": "60-Second Pizza Dough Hack",
      "link": "https://www.youtube.com/shorts/xyz789",
      "image": "https://i.ytimg.com/vi/xyz789/hqdefault.jpg"
    }
  ],
  "images": [
    {
      "global_rank": 12,
      "title": "Classic Margherita Pizza",
      "link": "https://www.example-recipe.com/margherita",
      "image": "https://www.example-recipe.com/images/margherita-thumb.jpg",
      "original_image": "https://www.example-recipe.com/images/margherita-full.jpg",
      "image_width": 400,
      "image_height": 300,
      "original_width": 1200,
      "original_height": 900,
      "blurred": false
    }
  ],
  "shopping": [
    {
      "global_rank": 13,
      "title": "Ooni Koda 16 Gas Powered Pizza Oven",
      "link": "https://www.example-store.com/ooni-koda-16",
      "price": "$599.00",
      "old_price": "$699.00",
      "shop": "Example Store",
      "rating": 4.8,
      "reviews_cnt": 3120,
      "image": "https://www.example-store.com/images/ooni-koda.jpg"
    }
  ],
  "snack_pack_map": {
    "image": "https://maps.googleapis.com/maps/api/staticmap?center=40.7128,-74.0060&zoom=13",
    "link": "https://www.google.com/maps/search/pizza+near+me"
  },
  "snack_pack": [
    {
      "global_rank": 14,
      "name": "Joe's Pizza",
      "link": "https://www.joespizzanyc.com",
      "cid": "12345678901234567",
      "site": "joespizzanyc.com",
      "address": "7 Carmine St, New York, NY 10014",
      "phone": "+1 212-366-1182",
      "maps_link": "https://www.google.com/maps/place/Joe%27s+Pizza",
      "rating": 4.7,
      "reviews_cnt": 5230,
      "work_status": "Open",
      "work_status_details": "Open until 4:00 AM",
      "summary": "Iconic NY pizza slice joint",
      "tags": ["Dine-in", "Takeaway", "No delivery"],
      "image": "https://www.joespizzanyc.com/images/storefront.jpg"
    }
  ],
  "overview": {
    "title": "Pizza",
    "kgmid": "/m/0663v",
    "items": [
      { "type": "fact", "attrid": "place_of_origin", "title": "Place of origin", "values": ["Naples, Italy"], "href": "https://en.wikipedia.org/wiki/Naples", "source": "Wikipedia" },
      { "type": "fact", "attrid": "main_ingredients", "title": "Main ingredients", "values": ["Dough", "Tomato sauce", "Mozzarella", "Toppings"], "href": "" },
      { "type": "image", "attrid": "image", "title": "Pizza", "image": "https://upload.wikimedia.org/wikipedia/commons/thumb/a/a3/pizza.jpg/220px.jpg", "image_alt": "A classic Margherita pizza" }
    ]
  },
  "perspectives": [
    {
      "global_rank": 15,
      "title": "Why Neapolitan Pizza is the Gold Standard",
      "link": "https://www.reddit.com/r/pizza/comments/example",
      "image": "https://www.reddit.com/images/pizza-post.jpg"
    }
  ],
  "latest_posts": [
    {
      "global_rank": 16,
      "title": "I tried 30 NYC pizza slices in one weekend — here's my ranking",
      "link": "https://www.example-blog.com/nyc-pizza-ranking",
      "image": "https://www.example-blog.com/images/pizza-ranking.jpg"
    }
  ],
  "bottom_ads": [
    {
      "global_rank": 17,
      "title": "Best Pizza Deals Online — Order Now",
      "link": "https://www.example-pizza-ad2.com/order",
      "display_link": "www.example-pizza-ad2.com",
      "referral_link": "https://www.example-pizza-ad2.com/ref=google",
      "description": "Find the best pizza deals in your area. Fast delivery, great prices.",
      "extensions": []
    }
  ]
}
```

Response schema: [https://api.brightdata.com/data\_schemas/fast\_serp/google\_search.schema.json](https://api.brightdata.com/data_schemas/fast_serp/google_search.schema.json)

***

## Google response schema: Full JSON

A successful Google Search response is a JSON object that may contain the following top-level fields depending on the query and search context.

Response schema: [https://api.brightdata.com/data\_schemas/serp/google\_search.schema.json](https://api.brightdata.com/data_schemas/serp/google_search.schema.json)

***

### `general` object

Metadata about the search request and results.

| Field            | Type    | Description                                                                                                                |
| ---------------- | ------- | -------------------------------------------------------------------------------------------------------------------------- |
| `query`          | string  | The search query you submitted                                                                                             |
| `detected_query` | string  | The query Google actually returned results for. Differs from `query` when Google corrects spelling or truncates the search |
| `results_cnt`    | integer | Total number of results reported by Google                                                                                 |
| `search_time`    | number  | Time taken by Google to process the search, in seconds                                                                     |
| `language`       | string  | Language of the search results                                                                                             |
| `country`        | string  | Country name associated with the search                                                                                    |
| `country_code`   | string  | Two-letter country code                                                                                                    |
| `search_type`    | string  | Type of search, e.g. `"text"`, `"shopping"`                                                                                |
| `is_mobile`      | boolean | Whether the request was made as a mobile device                                                                            |
| `is_empty`       | boolean | Whether the results page returned no results                                                                               |
| `consent_type`   | string  | Consent mode applied to the request                                                                                        |

<Note>
  When `detected_query` differs from `query`, check for a `spelling` object to tell a genuine spelling correction apart from a truncated (cloaked) query. See [How to detect query truncation](/scraping-automation/serp-api/debugging#how-to-detect-query-truncation).
</Note>

***

### `input` object

Details about the original request.

| Field          | Type   | Description                             |
| -------------- | ------ | --------------------------------------- |
| `original_url` | string | The URL that was requested              |
| `user_agent`   | string | User agent string used for the request  |
| `request_id`   | string | Bright Data internal request identifier |

***

### `organic` array

The primary list of web search results.

| Field                       | Type             | Description                                            |
| --------------------------- | ---------------- | ------------------------------------------------------ |
| `link`                      | string           | URL of the result page                                 |
| `amp_link`                  | string           | AMP version URL, if available                          |
| `title`                     | string           | Title of the result                                    |
| `display_link`              | string           | Displayed URL shown in the result                      |
| `source`                    | string           | Source name                                            |
| `description`               | string           | Snippet shown in the search result                     |
| `snippet_highlighted_words` | array of strings | Words highlighted in the snippet                       |
| `last_modified_date`        | string           | Last modified date of the page, if available           |
| `icon`                      | string           | Favicon of the result                                  |
| `image`                     | string           | Image associated with the result                       |
| `thumbnail`                 | string           | Thumbnail image URL                                    |
| `extensions`                | array            | Site links or other extensions (see below)             |
| `subresults`                | array            | Indented sub-results under the main result (see below) |
| `similar_link`              | string           | Link to similar pages                                  |
| `cached_link`               | string           | Link to Google's cached version                        |
| `translate_link`            | string           | Link to translated version                             |
| `global_rank`               | integer          | Rank position of the result on the page                |

#### `extensions` items

| Field         | Type    | Description                               |
| ------------- | ------- | ----------------------------------------- |
| `type`        | string  | Extension type, e.g. `"site_link"`        |
| `text`        | string  | Anchor text                               |
| `link`        | string  | URL of the extension link                 |
| `description` | string  | Description text, if available            |
| `extended`    | boolean | Whether the extension is in expanded form |
| `inline`      | boolean | Whether the extension is displayed inline |

#### `subresults` items

| Field          | Type    | Description                     |
| -------------- | ------- | ------------------------------- |
| `link`         | string  | URL of the sub-result           |
| `title`        | string  | Title of the sub-result         |
| `description`  | string  | Snippet of the sub-result       |
| `display_link` | string  | Displayed URL of the sub-result |
| `global_rank`  | integer | Rank position of the sub-result |

***

### `top_ads` / `bottom_ads` arrays

Paid advertisement results appearing above or below organic results.

| Field           | Type    | Description                                          |
| --------------- | ------- | ---------------------------------------------------- |
| `title`         | string  | Ad headline                                          |
| `link`          | string  | Destination URL of the ad                            |
| `display_link`  | string  | Displayed URL shown in the ad                        |
| `referral_link` | string  | Referral tracking URL                                |
| `description`   | string  | Ad description text                                  |
| `phone`         | string  | Phone number shown in the ad, if any                 |
| `deal_link`     | string  | Link to a deal associated with the ad                |
| `deal_text`     | string  | Deal text, if any                                    |
| `image`         | string  | Image shown in the ad                                |
| `extensions`    | array   | Ad extensions (same structure as organic extensions) |
| `global_rank`   | integer | Rank position of the ad                              |

***

### `top_pla` / `bottom_pla` / `jackpot_pla` arrays

Product Listing Ads (shopping ads) appearing at the top, bottom, or in a prominent carousel.

| Field           | Type             | Description                                                                  |
| --------------- | ---------------- | ---------------------------------------------------------------------------- |
| `title`         | string           | Product name                                                                 |
| `link`          | string           | URL to the product page                                                      |
| `referral_link` | string           | Referral tracking URL                                                        |
| `price`         | string           | Displayed price                                                              |
| `old_price`     | string           | Original price before discount, if applicable                                |
| `shop`          | string           | Merchant name                                                                |
| `shipping`      | string           | Shipping information                                                         |
| `rating`        | number           | Product rating                                                               |
| `reviews_cnt`   | integer          | Number of reviews                                                            |
| `extensions`    | array of strings | Additional labels or badges                                                  |
| `image`         | string           | Product image URL                                                            |
| `view_all`      | boolean          | Whether this is a "view all" sentinel row that links to the full result list |
| `global_rank`   | integer          | Rank position of the item                                                    |

***

### `shopping` array

Shopping results embedded within web search results.

| Field            | Type    | Description                                       |
| ---------------- | ------- | ------------------------------------------------- |
| `title`          | string  | Product name                                      |
| `link`           | string  | URL to the product page                           |
| `shop_link`      | string  | URL to the merchant's store page                  |
| `description`    | string  | Product description                               |
| `price`          | string  | Displayed price                                   |
| `old_price`      | string  | Original price before discount, if applicable     |
| `shop`           | string  | Merchant name                                     |
| `shipping`       | string  | Shipping information                              |
| `rating`         | number  | Product rating                                    |
| `reviews_cnt`    | integer | Number of reviews                                 |
| `trusted_store`  | boolean | Whether the merchant is marked as a trusted store |
| `compare_prices` | string  | Link or label for comparing prices                |
| `image`          | string  | Product image URL                                 |
| `referral_link`  | string  | Referral tracking URL                             |
| `global_rank`    | integer | Rank position of the item                         |

***

### `news` array

News results embedded in the search page.

| Field         | Type    | Description                 |
| ------------- | ------- | --------------------------- |
| `title`       | string  | Headline of the article     |
| `link`        | string  | URL of the article          |
| `source`      | string  | Publisher name              |
| `source_logo` | string  | Publisher logo URL          |
| `description` | string  | Article snippet             |
| `date`        | string  | Publication date/time       |
| `image`       | string  | Thumbnail image URL         |
| `global_rank` | integer | Rank position of the result |

***

### `top_stories` object

Google's "Top Stories" news carousel.

| Field                 | Type    | Description             |
| --------------------- | ------- | ----------------------- |
| `items`               | array   | List of top story items |
| `items[].title`       | string  | Headline                |
| `items[].link`        | string  | Article URL             |
| `items[].source`      | string  | Publisher name          |
| `items[].source_logo` | string  | Publisher logo URL      |
| `items[].date`        | string  | Publication date/time   |
| `items[].image`       | string  | Thumbnail image URL     |
| `items[].global_rank` | integer | Rank position           |

***

### `videos` / `short_videos` arrays

Video results embedded in the search page.

| Field          | Type    | Description                               |
| -------------- | ------- | ----------------------------------------- |
| `title`        | string  | Video title                               |
| `link`         | string  | URL to the video                          |
| `source`       | string  | Platform or publisher name                |
| `date`         | string  | Publication date                          |
| `duration`     | string  | Video duration as displayed               |
| `duration_sec` | integer | Video duration in seconds                 |
| `image`        | string  | Thumbnail image URL                       |
| `key_moments`  | array   | List of key moment timestamps (see below) |
| `global_rank`  | integer | Rank position                             |

#### `key_moments` items

| Field       | Type    | Description                   |
| ----------- | ------- | ----------------------------- |
| `title`     | string  | Label for the key moment      |
| `link`      | string  | URL to the specific timestamp |
| `start`     | string  | Start time as displayed       |
| `start_sec` | integer | Start time in seconds         |
| `image`     | string  | Preview image URL             |

***

### `images` array

Image results embedded in the search page.

| Field            | Type    | Description                      |
| ---------------- | ------- | -------------------------------- |
| `title`          | string  | Image title                      |
| `link`           | string  | URL of the source page           |
| `source`         | string  | Source site name                 |
| `source_logo`    | string  | Source site logo URL             |
| `original_image` | string  | URL of the full-resolution image |
| `image`          | string  | Thumbnail image URL              |
| `global_rank`    | integer | Rank position                    |

***

### `featured_snippets` array

Featured snippet boxes appearing at the top of results.

| Field          | Type    | Description                                           |
| -------------- | ------- | ----------------------------------------------------- |
| `type`         | string  | Snippet type, e.g. `"paragraph"`, `"list"`, `"table"` |
| `title`        | string  | Snippet title                                         |
| `description`  | string  | Snippet text content                                  |
| `value`        | string  | Value shown in the snippet, if applicable             |
| `link`         | string  | Source URL                                            |
| `display_link` | string  | Displayed source URL                                  |
| `source`       | string  | Source name                                           |
| `image`        | string  | Image URL, if applicable                              |
| `items`        | array   | List items for list-type snippets (`text`, `value`)   |
| `global_rank`  | integer | Rank position                                         |

***

### `people_also_ask` array

"People also ask" questions shown on the results page.

| Field          | Type    | Description               |
| -------------- | ------- | ------------------------- |
| `question`     | string  | The question text         |
| `answer`       | string  | The answer snippet        |
| `link`         | string  | Source URL for the answer |
| `title`        | string  | Title of the source page  |
| `display_link` | string  | Displayed source URL      |
| `global_rank`  | integer | Rank position             |

***

### `knowledge` object

Google Knowledge Panel for an entity.

| Field                | Type   | Description                                                |
| -------------------- | ------ | ---------------------------------------------------------- |
| `title`              | string | Entity name                                                |
| `subtitle`           | string | Entity category or subtitle                                |
| `type`               | string | Entity type                                                |
| `description`        | string | Description of the entity                                  |
| `description_source` | string | Source of the description                                  |
| `description_link`   | string | URL of the description source                              |
| `kgmid`              | string | Google Knowledge Graph ID                                  |
| `link`               | string | Official website URL                                       |
| `image`              | string | Main image URL                                             |
| `facts`              | array  | List of fact items (`predicate`, `title`, `value`, `link`) |
| `widgets`            | array  | Additional knowledge widgets                               |

***

### `ai_overview` object

Google AI Overview summary shown at the top of some results pages.

| Field                       | Type              | Description                                                         |
| --------------------------- | ----------------- | ------------------------------------------------------------------- |
| `texts`                     | array             | List of content blocks (type: `title`, `paragraph`, `list`, `code`) |
| `texts[].type`              | string            | Content block type                                                  |
| `texts[].snippet`           | string            | Text content of the block                                           |
| `texts[].links`             | array             | Inline links within the block (`text`, `link`)                      |
| `texts[].reference_indexes` | array of integers | Indexes pointing to the `references` array                          |
| `references`                | array             | Source references cited in the AI overview                          |
| `references[].href`         | string            | URL of the reference                                                |
| `references[].title`        | string            | Title of the reference                                              |
| `references[].source`       | string            | Source name                                                         |
| `references[].index`        | integer           | Reference index                                                     |
| `global_rank`               | integer           | Rank position                                                       |

***

### `snack_pack` array

Local business results shown in the map pack.

| Field                 | Type             | Description                               |
| --------------------- | ---------------- | ----------------------------------------- |
| `name`                | string           | Business name                             |
| `link`                | string           | URL to the business website               |
| `cid`                 | string           | Google Customer ID of the business        |
| `rating`              | number           | Average customer rating                   |
| `reviews_cnt`         | integer          | Number of reviews                         |
| `type`                | string           | Business category                         |
| `price`               | string           | Price range indicator                     |
| `phone`               | string           | Phone number                              |
| `address`             | string           | Business address                          |
| `work_status`         | string           | Current open/closed status                |
| `work_status_details` | string           | Detailed status description               |
| `maps_link`           | string           | URL to the business on Google Maps        |
| `sponsored`           | boolean          | Whether the listing is a sponsored result |
| `tags`                | array of strings | Attribute tags for the business           |
| `global_rank`         | integer          | Rank position                             |

***

### `snack_pack_map` object

The map image associated with the local pack results.

| Field   | Type   | Description                 |
| ------- | ------ | --------------------------- |
| `image` | string | Map image URL               |
| `link`  | string | URL to Google Maps          |
| `lat`   | string | Latitude of the map center  |
| `lng`   | string | Longitude of the map center |

***

### `jobs` object

Job listing results embedded in the search page.

| Field                 | Type   | Description                    |
| --------------------- | ------ | ------------------------------ |
| `title`               | string | Widget title                   |
| `items`               | array  | List of job items              |
| `items[].title`       | string | Job title                      |
| `items[].company`     | string | Company name                   |
| `items[].location`    | string | Job location                   |
| `items[].source`      | string | Job board or source            |
| `items[].description` | string | Job description snippet        |
| `items[].link`        | string | URL to the job listing         |
| `items[].tags`        | array  | List of tags (`name`, `value`) |

***

### `flights` object

Flight results widget.

| Field              | Type   | Description                                                                       |
| ------------------ | ------ | --------------------------------------------------------------------------------- |
| `title`            | string | Widget title                                                                      |
| `from`             | string | Departure location                                                                |
| `to`               | string | Destination                                                                       |
| `date_from`        | string | Departure date                                                                    |
| `date_to`          | string | Return date                                                                       |
| `flight_class`     | string | Cabin class                                                                       |
| `ticket_type`      | string | One-way or round trip                                                             |
| `items`            | array  | List of flight options (`logo`, `title`, `travel_time`, `stops`, `price`, `link`) |
| `date_price_items` | array  | Alternate date pricing (`departure_date`, `return_date`, `price`)                 |

***

### `hotels_selection` object

Hotel results widget.

| Field                 | Type             | Description              |
| --------------------- | ---------------- | ------------------------ |
| `title`               | string           | Widget title             |
| `items[].name`        | string           | Hotel name               |
| `items[].link`        | string           | URL to the hotel listing |
| `items[].price`       | string           | Displayed price          |
| `items[].rating`      | number           | Hotel rating             |
| `items[].reviews_cnt` | integer          | Number of reviews        |
| `items[].tags`        | array of strings | Attribute labels         |
| `items[].image`       | string           | Hotel image URL          |

***

### `recipes` object

Recipe results widget.

| Field                 | Type             | Description         |
| --------------------- | ---------------- | ------------------- |
| `title`               | string           | Widget title        |
| `items[].title`       | string           | Recipe name         |
| `items[].link`        | string           | URL to the recipe   |
| `items[].rating`      | number           | Recipe rating       |
| `items[].reviews_cnt` | integer          | Number of reviews   |
| `items[].source`      | string           | Source site         |
| `items[].cook_time`   | string           | Cooking time        |
| `items[].ingredients` | array of strings | List of ingredients |
| `items[].image`       | string           | Recipe image URL    |

***

### `popular_products` object

Popular products widget embedded in results.

| Field                 | Type             | Description                |
| --------------------- | ---------------- | -------------------------- |
| `title`               | string           | Widget title               |
| `items[].title`       | string           | Product name               |
| `items[].price`       | string           | Displayed price            |
| `items[].link`        | string           | URL to the product         |
| `items[].rating`      | number           | Product rating             |
| `items[].reviews_cnt` | integer          | Number of reviews          |
| `items[].features`    | array of strings | Product feature highlights |
| `items[].image`       | string           | Product image URL          |

***

### `weather` object

Weather widget shown for weather-related queries.

| Field             | Type   | Description                                                                          |
| ----------------- | ------ | ------------------------------------------------------------------------------------ |
| `title`           | string | Location name                                                                        |
| `temperature`     | string | Current temperature                                                                  |
| `image`           | string | Weather condition icon URL                                                           |
| `daily_forecast`  | array  | Day-by-day forecast (`day`, `image`, `temperature.daytime`, `temperature.nighttime`) |
| `hourly_forecast` | object | Hourly precipitation and wind data                                                   |
| `additional_info` | array  | Extra info items (`type`, `text`)                                                    |

***

### `currency_exchange` object

Currency conversion widget.

| Field           | Type   | Description                                |
| --------------- | ------ | ------------------------------------------ |
| `exchange_rate` | number | Current exchange rate                      |
| `date`          | string | Date of the rate                           |
| `exchange`      | array  | Converted amounts (`amount`, `currency`)   |
| `history`       | array  | Historical rates (`exchange_rate`, `date`) |

***

### `related` array

"Related searches" shown at the bottom of the page.

| Field      | Type    | Description                                |
| ---------- | ------- | ------------------------------------------ |
| `text`     | string  | Related search text                        |
| `link`     | string  | URL to the related search                  |
| `expanded` | boolean | Whether this item has nested related items |
| `items`    | array   | Nested related items, same structure       |

***

### `pagination` object

Pagination data for the results page.

| Field            | Type    | Description                                       |
| ---------------- | ------- | ------------------------------------------------- |
| `current_page`   | integer | Current page number                               |
| `next_page`      | integer | Next page number                                  |
| `next_page_link` | string  | URL to the next page                              |
| `pages`          | array   | List of available pages (`page`, `start`, `link`) |

***

### `spelling` object

Spell correction data, if Google corrected or suggested an alternative query.

| Field                 | Type    | Description                                    |
| --------------------- | ------- | ---------------------------------------------- |
| `original_text`       | string  | The original query as submitted                |
| `original_link`       | string  | URL to search with the original query          |
| `original_empty`      | boolean | Whether the original query returned no results |
| `auto_corrected_text` | string  | Query Google automatically corrected to        |
| `auto_corrected_link` | string  | URL for the auto-corrected query               |
| `suggested_text`      | string  | Alternative spelling suggestion                |
| `suggested_link`      | string  | URL for the suggested spelling                 |

***

### `forums` object

Forum and discussion results embedded in the page.

| Field             | Type   | Description                                       |
| ----------------- | ------ | ------------------------------------------------- |
| `items[].title`   | string | Forum post or thread title                        |
| `items[].source`  | string | Forum or platform name                            |
| `items[].link`    | string | URL to the forum thread                           |
| `items[].answers` | array  | List of answers (`text`, `link`, `is_top_answer`) |

***

### `latest_posts` object

Latest social or editorial posts widget.

| Field                 | Type    | Description                |
| --------------------- | ------- | -------------------------- |
| `title`               | string  | Widget title               |
| `items[].title`       | string  | Post title                 |
| `items[].source`      | string  | Publisher or platform name |
| `items[].channel`     | string  | Channel or account name    |
| `items[].date`        | string  | Publication date           |
| `items[].link`        | string  | URL to the post            |
| `items[].image`       | string  | Post image URL             |
| `items[].global_rank` | integer | Rank position              |

***

### `perspectives` array

Perspectives results from forums, social media, and editorial sources.

| Field         | Type    | Description          |
| ------------- | ------- | -------------------- |
| `title`       | string  | Perspective title    |
| `author`      | string  | Author name          |
| `source`      | string  | Source platform      |
| `text`        | string  | Excerpt or summary   |
| `date`        | string  | Publication date     |
| `link`        | string  | URL to the full post |
| `image`       | string  | Image URL            |
| `global_rank` | integer | Rank position        |

***

### `navigation` array

Top navigation links shown on the results page (e.g. Images, News, Videos).

| Field   | Type   | Description                  |
| ------- | ------ | ---------------------------- |
| `title` | string | Label of the navigation item |
| `href`  | string | URL of the navigation link   |

***

### `chips` array

Refinement chip filters shown below the search bar.

| Field       | Type   | Description                      |
| ----------- | ------ | -------------------------------- |
| `label`     | string | Chip label text                  |
| `link`      | string | URL for applying the chip filter |
| `image_url` | string | Icon image URL, if applicable    |

### Example Full JSON

```sh Full JSON response example theme={null}
{
  "general": {
    "query": "pizza",
    "detected_query": "pizza",
    "results_cnt": 2340000000,
    "search_time": 0.52,
    "language": "en",
    "country": "United States",
    "country_code": "US",
    "search_type": "text",
    "is_mobile": false,
    "is_empty": false,
    "consent_type": "none"
  },
  "input": {
    "original_url": "https://www.google.com/search?q=pizza&brd_json=1",
    "user_agent": "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/124.0.0.0 Safari/537.36",
    "request_id": "hl_a1b2c3d4e5f6g7h8"
  },
  "navigation": [
    { "title": "Images", "href": "https://www.google.com/search?q=pizza&udm=2" },
    { "title": "News", "href": "https://www.google.com/search?q=pizza&tbm=nws" },
    { "title": "Videos", "href": "https://www.google.com/search?q=pizza&udm=7" },
    { "title": "Shopping", "href": "https://www.google.com/search?q=pizza&tbm=shop" }
  ],
  "navigation_tabs": [
    { "title": "All", "link": "https://www.google.com/search?q=pizza" },
    { "title": "Images", "link": "https://www.google.com/search?q=pizza&udm=2" }
  ],
  "navigation_filters": [
    {
      "title": "Any time",
      "is_active": true,
      "has_popup": true,
      "popup_items": [
        { "title": "Past hour", "is_active": false },
        { "title": "Past 24 hours", "is_active": false },
        { "title": "Past week", "is_active": false },
        { "title": "Past month", "is_active": false },
        { "title": "Past year", "is_active": false }
      ]
    }
  ],
  "chips": [
    { "label": "pizza dough", "link": "https://www.google.com/search?q=pizza+dough", "image_url": "https://example.com/chips/dough.jpg" },
    { "label": "pizza near me", "link": "https://www.google.com/search?q=pizza+near+me", "image_url": "https://example.com/chips/nearby.jpg" },
    { "label": "pizza recipes", "link": "https://www.google.com/search?q=pizza+recipes", "image_url": "https://example.com/chips/recipes.jpg" }
  ],
  "top_ads": [
    {
      "title": "Order Pizza Online — Fast Delivery Guaranteed",
      "link": "https://www.example-pizza-ad.com/order",
      "display_link": "www.example-pizza-ad.com",
      "referral_link": "https://www.example-pizza-ad.com/ref=google",
      "description": "Hot fresh pizza delivered to your door in 30 minutes or less. Order now.",
      "extensions": [
        { "type": "site_link", "text": "Order Now", "link": "https://www.example-pizza-ad.com/order", "extended": false },
        { "type": "site_link", "text": "Deals", "link": "https://www.example-pizza-ad.com/deals", "extended": false }
      ],
      "global_rank": 1
    }
  ],
  "featured_snippets": [
    {
      "type": "paragraph",
      "title": "What is pizza?",
      "description": "Pizza is a dish of Italian origin consisting of a usually round, flat base of leavened wheat-based dough topped with tomatoes, cheese, and often various other ingredients.",
      "link": "https://en.wikipedia.org/wiki/Pizza",
      "display_link": "en.wikipedia.org › wiki › Pizza",
      "source": "Wikipedia",
      "global_rank": 2
    }
  ],
  "ai_overview": {
    "texts": [
      {
        "type": "paragraph",
        "snippet": "Pizza is one of the world's most popular foods, originating in Naples, Italy. It typically consists of a leavened dough base topped with tomato sauce, mozzarella cheese, and a variety of toppings.",
        "links": [
          { "text": "History of pizza", "link": "https://en.wikipedia.org/wiki/History_of_pizza" }
        ],
        "reference_indexes": [0, 1]
      },
      {
        "type": "list",
        "snippet": "Common pizza styles include:",
        "list": [
          { "type": "paragraph", "snippet": "Neapolitan — thin, soft crust, simple toppings" },
          { "type": "paragraph", "snippet": "New York-style — large, foldable slices" },
          { "type": "paragraph", "snippet": "Chicago deep dish — thick crust, layered toppings" }
        ],
        "reference_indexes": [2]
      }
    ],
    "references": [
      { "index": 0, "href": "https://en.wikipedia.org/wiki/Pizza", "title": "Pizza - Wikipedia", "source": "Wikipedia" },
      { "index": 1, "href": "https://en.wikipedia.org/wiki/History_of_pizza", "title": "History of pizza", "source": "Wikipedia" },
      { "index": 2, "href": "https://www.example-food.com/pizza-styles", "title": "Pizza Styles Around the World", "source": "Example Food" }
    ],
    "global_rank": 3
  },
  "organic": [
    {
      "link": "https://en.wikipedia.org/wiki/Pizza",
      "amp_link": "https://en.m.wikipedia.org/wiki/Pizza",
      "title": "Pizza - Wikipedia",
      "display_link": "en.wikipedia.org › wiki › Pizza",
      "source": "Wikipedia",
      "description": "Pizza is an Italian dish consisting of a flat base of leavened wheat-based dough topped with tomato, cheese, and other ingredients, baked at a high temperature.",
      "snippet_highlighted_words": ["Pizza", "Italian", "dough"],
      "icon": "https://en.wikipedia.org/favicon.ico",
      "extensions": [
        { "type": "site_link", "text": "Neapolitan pizza", "link": "https://en.wikipedia.org/wiki/Neapolitan_pizza", "extended": false, "inline": false },
        { "type": "site_link", "text": "Pizzeria", "link": "https://en.wikipedia.org/wiki/Pizzeria", "extended": false, "inline": false },
        { "type": "site_link", "text": "Pizza Margherita", "link": "https://en.wikipedia.org/wiki/Pizza_Margherita", "extended": false, "inline": false }
      ],
      "global_rank": 4
    },
    {
      "link": "https://www.pizzahut.com/",
      "title": "Pizza Hut | Delivery & Carryout - No One OutPizzas The Hut!",
      "display_link": "www.pizzahut.com",
      "source": "Pizza Hut",
      "description": "Order pizza online for fast delivery or carryout from a store near you. View our full menu, nutritional information, store locations, and more.",
      "snippet_highlighted_words": ["pizza"],
      "icon": "https://www.pizzahut.com/favicon.ico",
      "extensions": [
        { "type": "site_link", "text": "Menu", "link": "https://www.pizzahut.com/menu", "extended": false, "inline": false },
        { "type": "site_link", "text": "Locations", "link": "https://www.pizzahut.com/locations", "extended": false, "inline": false }
      ],
      "global_rank": 5
    },
    {
      "link": "https://www.dominos.com/",
      "title": "Domino's Pizza - Order Online for Delivery or Carryout",
      "display_link": "www.dominos.com",
      "source": "Domino's",
      "description": "Order Domino's pizza online for delivery or carryout. Find deals, coupons, and track your order in real time.",
      "snippet_highlighted_words": ["pizza"],
      "icon": "https://www.dominos.com/favicon.ico",
      "extensions": [],
      "global_rank": 6
    },
    {
      "link": "https://www.bbcgoodfood.com/recipes/pizza-margherita-4-easy-steps",
      "title": "Pizza Margherita in 4 easy steps",
      "display_link": "www.bbcgoodfood.com › recipes",
      "source": "BBC Good Food",
      "description": "Even a novice cook can master the art of perfect pizza with our step-by-step guide to making a classic Margherita.",
      "snippet_highlighted_words": ["pizza", "Margherita"],
      "icon": "https://www.bbcgoodfood.com/favicon.ico",
      "extensions": [],
      "global_rank": 7
    }
  ],
  "videos": [
    {
      "title": "How to Make Perfect Homemade Pizza",
      "link": "https://www.youtube.com/watch?v=abc123",
      "source": "YouTube",
      "date": "2025-11-01",
      "duration": "12:34",
      "duration_sec": 754,
      "image": "https://i.ytimg.com/vi/abc123/hqdefault.jpg",
      "key_moments": [
        { "title": "Making the dough", "link": "https://www.youtube.com/watch?v=abc123&t=30", "start": "0:30", "start_sec": 30, "image": "https://i.ytimg.com/vi/abc123/moment1.jpg" },
        { "title": "Adding toppings", "link": "https://www.youtube.com/watch?v=abc123&t=480", "start": "8:00", "start_sec": 480, "image": "https://i.ytimg.com/vi/abc123/moment2.jpg" }
      ],
      "global_rank": 8
    },
    {
      "title": "Classic New York Pizza At Home",
      "link": "https://www.youtube.com/watch?v=def456",
      "source": "YouTube",
      "date": "2025-09-15",
      "duration": "9:45",
      "duration_sec": 585,
      "image": "https://i.ytimg.com/vi/def456/hqdefault.jpg",
      "key_moments": [],
      "global_rank": 9
    }
  ],
  "top_stories": {
    "items": [
      {
        "title": "NYC Pizza Festival Returns for Its Biggest Year Yet",
        "link": "https://www.example-news.com/nyc-pizza-festival-2026",
        "source": "Example News",
        "source_logo": "https://www.example-news.com/logo.png",
        "date": "2 hours ago",
        "image": "https://www.example-news.com/images/pizza-festival.jpg",
        "global_rank": 10
      },
      {
        "title": "The Science Behind the Perfect Pizza Crust",
        "link": "https://www.another-outlet.com/pizza-crust-science",
        "source": "Another Outlet",
        "source_logo": "https://www.another-outlet.com/logo.png",
        "date": "5 hours ago",
        "image": "https://www.another-outlet.com/images/pizza-crust.jpg",
        "global_rank": 11
      }
    ]
  },
  "images": [
    {
      "title": "Classic Margherita Pizza",
      "link": "https://www.example-recipe.com/margherita",
      "source": "Example Recipe",
      "source_logo": "https://www.example-recipe.com/logo.png",
      "original_image": "https://www.example-recipe.com/images/margherita-full.jpg",
      "image": "https://www.example-recipe.com/images/margherita-thumb.jpg",
      "global_rank": 12
    },
    {
      "title": "Neapolitan Pizza with Fresh Basil",
      "link": "https://www.example-food.com/neapolitan",
      "source": "Example Food",
      "source_logo": "https://www.example-food.com/logo.png",
      "original_image": "https://www.example-food.com/images/neapolitan-full.jpg",
      "image": "https://www.example-food.com/images/neapolitan-thumb.jpg",
      "global_rank": 13
    }
  ],
  "shopping": [
    {
      "title": "Ooni Koda 16 Gas Powered Pizza Oven",
      "link": "https://www.example-store.com/ooni-koda-16",
      "shop_link": "https://www.example-store.com",
      "description": "Gas-powered outdoor pizza oven. Reaches 950°F in 20 minutes.",
      "price": "$599.00",
      "old_price": "$699.00",
      "shop": "Example Store",
      "shipping": "Free shipping",
      "rating": 4.8,
      "reviews_cnt": 3120,
      "trusted_store": true,
      "image": "https://www.example-store.com/images/ooni-koda.jpg",
      "global_rank": 14
    },
    {
      "title": "Pizza Stone for Oven and Grill",
      "link": "https://www.another-store.com/pizza-stone",
      "shop_link": "https://www.another-store.com",
      "description": "14-inch cordierite pizza stone, evenly distributes heat for a crispy crust.",
      "price": "$34.99",
      "shop": "Another Store",
      "shipping": "$4.99 shipping",
      "rating": 4.6,
      "reviews_cnt": 8740,
      "trusted_store": false,
      "image": "https://www.another-store.com/images/pizza-stone.jpg",
      "global_rank": 15
    }
  ],
  "top_pla": [
    {
      "title": "Ooni Fyra 12 Wood Pellet Pizza Oven",
      "link": "https://www.example-shop.com/ooni-fyra",
      "referral_link": "https://www.example-shop.com/ref=gpla",
      "price": "$349.00",
      "old_price": "$399.00",
      "shop": "Example Shop",
      "shipping": "Free shipping",
      "rating": 4.7,
      "reviews_cnt": 2340,
      "image": "https://www.example-shop.com/images/ooni-fyra.jpg",
      "global_rank": 16
    }
  ],
  "knowledge": {
    "title": "Pizza",
    "subtitle": "Dish",
    "type": "Food",
    "description": "Pizza is a dish of Italian origin consisting of a usually round, flat base of leavened wheat-based dough topped with tomatoes, cheese, and often various other ingredients.",
    "description_source": "Wikipedia",
    "description_link": "https://en.wikipedia.org/wiki/Pizza",
    "kgmid": "/m/0663v",
    "link": "https://en.wikipedia.org/wiki/Pizza",
    "image": "https://upload.wikimedia.org/wikipedia/commons/thumb/a/a3/Eq_it-na_pizza-margherita_sep2005_sml.jpg/220px.jpg",
    "facts": [
      { "predicate": "Place of origin", "title": "Place of origin", "value": "Naples, Italy", "link": "https://en.wikipedia.org/wiki/Naples" },
      { "predicate": "Main ingredients", "title": "Main ingredients", "value": "Dough, tomato sauce, cheese, toppings", "link": "" },
      { "predicate": "Serving temperature", "title": "Serving temperature", "value": "Hot", "link": "" }
    ],
    "widgets": [
      {
        "type": "list",
        "key": "Variations",
        "predicate": "Variations",
        "title": "Popular variations",
        "items": [
          { "title": "Neapolitan pizza", "subtitle": "Pizza style", "link": "https://en.wikipedia.org/wiki/Neapolitan_pizza" },
          { "title": "New York-style pizza", "subtitle": "Pizza style", "link": "https://en.wikipedia.org/wiki/New_York-style_pizza" },
          { "title": "Chicago-style pizza", "subtitle": "Pizza style", "link": "https://en.wikipedia.org/wiki/Chicago-style_pizza" }
        ]
      }
    ]
  },
  "people_also_ask": [
    {
      "question": "What is the most popular pizza topping?",
      "answer": "Pepperoni is the most popular pizza topping in the United States, appearing on approximately 36% of all pizzas ordered.",
      "link": "https://www.example-food.com/popular-pizza-toppings",
      "title": "Most Popular Pizza Toppings in America",
      "display_link": "www.example-food.com",
      "global_rank": 17
    },
    {
      "question": "Where was pizza invented?",
      "answer": "Pizza was invented in Naples, Italy. The modern pizza with tomato sauce and mozzarella is believed to have originated there in the 18th or early 19th century.",
      "link": "https://en.wikipedia.org/wiki/Pizza",
      "title": "Pizza - Wikipedia",
      "display_link": "en.wikipedia.org",
      "global_rank": 18
    }
  ],
  "snack_pack_map": {
    "image": "https://maps.googleapis.com/maps/api/staticmap?center=40.7128,-74.0060&zoom=13",
    "link": "https://www.google.com/maps/search/pizza+near+me",
    "lat": "40.7128",
    "lng": "-74.0060"
  },
  "snack_pack": [
    {
      "name": "Joe's Pizza",
      "link": "https://www.joespizzanyc.com",
      "cid": "12345678901234567",
      "rating": 4.7,
      "reviews_cnt": 5230,
      "type": "Pizza restaurant",
      "price": "$",
      "phone": "+1 212-366-1182",
      "address": "7 Carmine St, New York, NY 10014",
      "work_status": "Open",
      "work_status_details": "Open until 4:00 AM",
      "maps_link": "https://www.google.com/maps/place/Joe%27s+Pizza",
      "sponsored": false,
      "tags": ["Dine-in", "Takeaway", "No delivery"],
      "global_rank": 19
    },
    {
      "name": "Grimaldi's Pizzeria",
      "link": "https://www.grimaldis-pizza.com",
      "cid": "98765432109876543",
      "rating": 4.5,
      "reviews_cnt": 8910,
      "type": "Pizza restaurant",
      "price": "$$",
      "phone": "+1 718-858-4300",
      "address": "1 Front St, Brooklyn, NY 11201",
      "work_status": "Open",
      "work_status_details": "Open until 10:00 PM",
      "maps_link": "https://www.google.com/maps/place/Grimaldi%27s+Pizzeria",
      "sponsored": false,
      "tags": ["Dine-in", "Takeaway"],
      "global_rank": 20
    }
  ],
  "recipes": {
    "title": "Pizza recipes",
    "items": [
      {
        "title": "Classic Margherita Pizza",
        "link": "https://www.bbcgoodfood.com/recipes/pizza-margherita",
        "rating": 4.8,
        "reviews_cnt": 1240,
        "source": "BBC Good Food",
        "cook_time": "25 mins",
        "ingredients": ["pizza dough", "tomato sauce", "mozzarella", "fresh basil", "olive oil"],
        "image": "https://www.bbcgoodfood.com/images/margherita.jpg"
      },
      {
        "title": "Easy Pepperoni Pizza",
        "link": "https://www.example-recipe.com/pepperoni-pizza",
        "rating": 4.6,
        "reviews_cnt": 890,
        "source": "Example Recipe",
        "cook_time": "30 mins",
        "ingredients": ["pizza dough", "tomato sauce", "mozzarella", "pepperoni", "oregano"],
        "image": "https://www.example-recipe.com/images/pepperoni.jpg"
      }
    ]
  },
  "popular_products": {
    "title": "Popular pizza-related products",
    "items": [
      {
        "title": "Ooni Koda 16 Pizza Oven",
        "price": "$599.00",
        "link": "https://www.example-store.com/ooni-koda-16",
        "rating": 4.8,
        "reviews_cnt": 3120,
        "features": ["Gas powered", "Reaches 950°F", "16-inch capacity"],
        "image": "https://www.example-store.com/images/ooni-koda.jpg"
      }
    ]
  },
  "perspectives": [
    {
      "title": "Why Neapolitan Pizza is the Gold Standard",
      "author": "John Smith",
      "source": "Reddit",
      "text": "After trying pizza across 12 countries, I keep coming back to true Neapolitan pizza. The simplicity of the ingredients and the high-heat cooking is unmatched.",
      "date": "2026-03-10",
      "link": "https://www.reddit.com/r/pizza/comments/example",
      "image": "https://www.reddit.com/images/pizza-post.jpg",
      "global_rank": 21
    }
  ],
  "forums": {
    "items": [
      {
        "title": "What makes a great pizza dough?",
        "source": "Reddit",
        "subtitles": ["r/pizza", "452 comments"],
        "link": "https://www.reddit.com/r/pizza/comments/dough-question",
        "answers": [
          { "text": "High protein flour, long cold fermentation, and proper hydration are the three keys.", "link": "https://www.reddit.com/r/pizza/comments/dough-question/answer1", "is_top_answer": true },
          { "text": "Don't overwork the dough and let it rest at room temperature before stretching.", "link": "https://www.reddit.com/r/pizza/comments/dough-question/answer2", "is_top_answer": false }
        ]
      }
    ]
  },
  "related": [
    { "text": "pizza dough recipe", "link": "https://www.google.com/search?q=pizza+dough+recipe", "expanded": false },
    { "text": "pizza near me", "link": "https://www.google.com/search?q=pizza+near+me", "expanded": false },
    { "text": "best pizza in New York", "link": "https://www.google.com/search?q=best+pizza+in+new+york", "expanded": false },
    { "text": "homemade pizza", "link": "https://www.google.com/search?q=homemade+pizza", "expanded": false }
  ],
  "spelling": {
    "original_text": "pizza",
    "original_link": "https://www.google.com/search?q=pizza",
    "original_empty": false,
    "auto_corrected_text": "",
    "auto_corrected_link": "",
    "suggested_text": "",
    "suggested_link": ""
  },
  "pagination": {
    "current_page": 1,
    "next_page": 2,
    "next_page_start": 10,
    "next_page_link": "https://www.google.com/search?q=pizza&start=10",
    "pages": [
      { "page": 1, "start": 0, "link": "https://www.google.com/search?q=pizza" },
      { "page": 2, "start": 10, "link": "https://www.google.com/search?q=pizza&start=10" },
      { "page": 3, "start": 20, "link": "https://www.google.com/search?q=pizza&start=20" }
    ]
  },
  "bottom_ads": [
    {
      "title": "Best Pizza Deals Online — Order Now",
      "link": "https://www.example-pizza-ad2.com/order",
      "display_link": "www.example-pizza-ad2.com",
      "referral_link": "https://www.example-pizza-ad2.com/ref=google",
      "description": "Find the best pizza deals in your area. Fast delivery, great prices.",
      "extensions": [],
      "global_rank": 22
    }
  ]
}
```


# SERP pricing & billing
Source: https://docs.brightdata.com/scraping-automation/serp-api/pricing-and-billing

Bright Data SERP API pricing: per-1,000 successful requests with parsing and unlocking included, no bandwidth fees and failed requests not billed.

Bright Data SERP API uses **per‑1,000 successful requests** pricing. Failed/errored requests are not billed. Parsing and unlocking are included, no bandwidth fees.

> * Billing unit: per successful request (per 1,000)
> * Parsing/unlocking included (no bandwidth fees)
> * Async: “send request” billed; “collect/retrieve” free

[Bright Data SERP API price tiers and volume discounts](https://brightdata.com/pricing/serp?utm_source=docs\&utm_medium=pricing-billing\&utm_campaign=serp_pricing)

## Pay per success

With Bright Data, **only successful responses** are billed.

* Unit: per 1,000 successful requests
* Included: parsing (JSON/Markdown/HTML), proxy management, unlocking/CAPTCHA handling
* No bandwidth fees

<Note>If a request is retried behind the scenes, you’re **not** charged extra, only the successful response is billed.</Note>

***

## How async billing works

Use asynchronous mode for long‑running jobs or large batches.

* **Billed**: the initial “send request” call
* **Not billed**: the follow‑up “collect/retrieve” call

See: [Asynchronous Requests](/scraping-automation/serp-api/asynchronous-requests)

***

## What’s included in the unit price

* Structured outputs: **JSON**, **Markdown**, or **raw HTML**
* Proxy management & **unlocking** (incl. CAPTCHA handling)
* Automatic retries and best header/device logic
* City/ZIP geotargeting; **desktop and mobile** user agents

***

## FAQs

**Are retries or async “collect” billed?**\
Retries are included. In async mode, “collect/retrieve” is **not** billed, only the “send request” is billed.

**Is parsing included?**\
Yes, **JSON/Markdown/HTML** are included in the unit price.

**Do you charge bandwidth fees?**\
No, pricing is per successful request only.

***

## See also

* [SERP pricing](https://brightdata.com/pricing/serp?utm_source=docs\&utm_medium=pricing-billing\&utm_campaign=serp_pricing)
* [Introduction to SERP API](/scraping-automation/serp-api/introduction)
* [Asynchronous Requests](/scraping-automation/serp-api/asynchronous-requests)
* [Parsed JSON Results](/scraping-automation/serp-api/parsed-json-results/parsing-search-results)


# SERP API Bing query parameters
Source: https://docs.brightdata.com/scraping-automation/serp-api/query-parameters/bing

Configure Bing search queries on the Bright Data SERP API (31 languages) with parameters for localization, geo, pagination, device targeting and custom output.

<Warning>
  [Microsoft Bing Search APIs retiring on August 11, 2025](https://learn.microsoft.com/en-us/lifecycle/announcements/bing-search-api-retirement). Bright Data SERP API for Bing domain continues to be supported.
  [Bing API to Bright Data SERP API migration guide](/scraping-automation/serp-api/parsed-json-results/bing-to-bright-data-serp-migration-guide).
</Warning>

## Search

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

    A language to use for user interface strings. You may specify the language using either a 2-letter or 4-letter code. Using 4-letter codes is preferred.

    ```sh theme={null}
    curl --proxy brd.superproxy.io:44445 --proxy-user brd-customer-<customer-id>-zone-<zone-name>:<zone-password> "https://www.bing.com/search?q=pizza&setLang=en-US"
    ```
  </Accordion>

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

    A location for the search origin. Should be used together with `lat` (latitude) and `lon` (longitude) parameters.

    ```sh theme={null}
    curl --proxy brd.superproxy.io:44445 --proxy-user brd-customer-<customer-id>-zone-<zone-name>:<zone-password> "https://www.bing.com/search?q=pizza&location=New+York%2C+New+York%2C+United+States&lat=40.7001958&lon=-74.1087142"
    ```

    ### `cc`

    A 2-character country code of the country where the results come from.

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

    ### `mkt`

    A market where the search results come from.

    ```sh theme={null}
    curl --proxy brd.superproxy.io:44445 --proxy-user brd-customer-<customer-id>-zone-<zone-name>:<zone-password> "https://www.bing.com/search?q=pizza&mkt=en-US"
    ```
  </Accordion>

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

    This attibute was deprecated by bing and is no longer supported.

    ### `first`

    An offset that indicates the number of search results to skip before returning results. The default value is 1.

    Use this parameter along with the `count` parameter to page results. For example, set `count` to 10 and `first` to 1 to get the first page of results.
    For each subsequent page, increment `first` by 10 (for example, 1, 11, 21).
    It is possible for multiple pages to include some overlap in results.

    > #### Examples:
    >
    > `first=1` (default) - first page of results \
    > `first=11` - second page of results \
    > `first=21` - third page of results, etc.

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

  <Accordion title="Filters" icon="filter">
    ### `safesearch`

    Used to filter webpages, images, and videos for adult content.

    > **The following are the possible filter values:** \
    > `safesearch=off`, Returns content with adult text and images but not adult videos \
    > `safesearch=moderate`, Returns webpages with adult text, but not adult images or videos \
    > `safesearch=strict`, Does not return adult text, images, or videos

    The default is Moderate.

    NOTE: If the request comes from a market that Bing's adult policy requires that safeSearch be set to Strict, Bing ignores the safesearch value and uses Strict.

    ```sh theme={null}
    curl --proxy brd.superproxy.io:44445 --proxy-user brd-customer-<customer-id>-zone-<zone-name>:<zone-password> "https://www.bing.com/search?q=pizza&safesearch=off"
    ```
  </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:44445 --proxy-user brd-customer-<customer-id>-zone-<zone-name>:<zone-password> "https://www.bing.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:44445 --proxy-user brd-customer-<customer-id>-zone-<zone-name>:<zone-password> "https://www.bing.com/search?q=pizza&brd_browser=chrome"
    ```
  </Accordion>
</AccordionGroup>


# SERP API DuckDuckGo query parameters
Source: https://docs.brightdata.com/scraping-automation/serp-api/query-parameters/duckduckgo

Configure DuckDuckGo search queries on the Bright Data SERP API (31 languages) with parameters for localization, safe search, time range and device targeting.

## Search

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

    Country and language code used to define the country and language of search. See the [full list here](https://api.brightdata.com/serp/duckduckgo/kl_values).

    ```sh theme={null}
    curl --proxy brd.superproxy.io:44445 --proxy-user brd-customer-<customer-id>-zone-<zone-name>:<zone-password> "https://duckduckgo.com/?q=pizza&kl=us-en"
    ```

    ### `kad`

    Language of the search page interface: buttons, menu. See the [full list here](https://api.brightdata.com/serp/duckduckgo/kad_values)

    ```sh theme={null}
    curl --proxy brd.superproxy.io:44445 --proxy-user brd-customer-<customer-id>-zone-<zone-name>:<zone-password> "https://duckduckgo.com/?q=pizza"
    ```
  </Accordion>

  <Accordion title="Safe search" icon="shield">
    ### `kp`

    Removes adult content from search results.

    > **Available values are:** \
    > ` 1` - Turn on safe search \
    > `-1` - Moderate search content \
    > `-2` - Turn off safe search

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

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

    Time range to search.

    > **Available values are:** \
    > `d` - Past day \
    > `w` - Past week \
    > `m` - Past month \
    > `w` - Past year

    ```sh theme={null}
    curl --proxy brd.superproxy.io:44445 --proxy-user brd-customer-<customer-id>-zone-<zone-name>:<zone-password> "https://duckduckgo.com/?q=pizza&df=d"
    ```
  </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:44445 --proxy-user brd-customer-<customer-id>-zone-<zone-name>:<zone-password> "https://duckduckgo.com/?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:44445 --proxy-user brd-customer-<customer-id>-zone-<zone-name>:<zone-password> "https://duckduckgo.com/?q=pizza&brd_browser=chrome"
    ```
  </Accordion>
</AccordionGroup>


# SERP API Google query parameters
Source: https://docs.brightdata.com/scraping-automation/serp-api/query-parameters/google

Configure the Bright Data SERP API (31 languages) for Google search, Maps, Trends, Reviews, Images, Lens, Hotels and Flights with parameters per access point.

## The Search URL

Bright Data uses advanced parsing and access logic to provide you reliable response of search results, as fast as possible. We require that your search prefix will not carry any arguments in the URL **before** the `q=` argument. Relaying arguments before the `q` argument may result in delays in response and lower success rate.

Example for correct URL wit`gl` argument appended for search results in the US:

```text theme={null}
https://www.google.com/search?q=pizza&gl=us
```

Example for **incorrect** URL, with `gl` argument preceding `q` argument.

```text theme={null}
https://www.google.com/search?gl=us&q=pizza
```

### How to search for a term comprised of multiple words?

When you issue the query, add a `+` charachter in between the words in your search term. So if you want to search for "pizza in paris" the search string shouild be: `pizza+in+paris`

```text theme={null}
https://www.google.com/search?q=pizza+in+paris
```

## Web search

### Query parameters

<AccordionGroup>
  <Accordion title="Localization" icon="flag">
    <Note>
      Google now serves all search results exclusively through `google.com` and as such, any **SERP API** request sent to a different Google TLD (e.g., `google.co.uk`, `google.ca`) will automatically be routed through `google.com`.

      **Localization** is no longer determined by the TLD and should instead be configured solely using the `gl` (country) and `hl` (language) query parameters below:
    </Note>

    ### `gl`

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

    ```sh gl theme={null}
    curl --proxy brd.superproxy.io:44445 --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:44445 --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=nws` - news <br />`tbm=vid` - videos <br />`tbm=lcl` - Google Places (local search results)

    <Note>
      For Image search, see the [Images](#images) section.
    </Note>

    ```sh theme={null}
    curl --proxy brd.superproxy.io:44445 --proxy-user brd-customer-<customer-id>-zone-<zone-name>:<zone-password> "https://www.google.com/search?q=deli&hl=en&gl=us&tbm=lcl&uule=Charleston,South+Carolina,United+States&brd_json=1"
    ```

    ### `udm`

    > #### Example:
    >
    > `udm=1` - Google Places (local search results) <br />`udm=28` - shopping <br />`udm=39` - short videos

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

    ### `ibp`

    Use the `ibp` parameter for Jobs search type.

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

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

    ### `safe`

    Use the `safe` flag with values `active` or `off` to enable or disable safe search.

    > #### Example:
    >
    > `safe=active` - Safe search is ON `safe=off`    - Safe search is off

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

    ### `nfpr`

    Use the `nfpr` flag with values `1` to enable exact query search and disable auto correct to run search with similar term.

    > #### Example:
    >
    > `nfpr=1` - Exact match is "ON:?"

    ```sh theme={null}
    curl --proxy brd.superproxy.io:44445 --proxy-user brd-customer-<customer-id>-zone-<zone-name>:<zone-password> "https://www.google.com/search?q=pizza&nfpr=1"
    ```
  </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 <br />`start=10` - second page of results <br />`start=20` - third page of results, etc.

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

    ***

    ### `num`

    <Warning>
      **Deprecated by Google on September 11, 2025.** The `num` parameter no longer sets how many Google results are returned.

      * Google now returns about 10 results per page. The result set size can vary.
      * Use the `start` parameter to paginate through the result set.
      * To get the top 100 results in one request, use the [Get Top 100 Google Results](/scraping-automation/serp-api/get-top-100-google-results) feature.
    </Warning>
  </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:44445 --proxy-user brd-customer-<customer-id>-zone-<zone-name>:<zone-password> "https://www.google.com/search?q=pizza&uule=w+CAIQICINVW5pdGVkK1N0YXRlcw"

    ```

    #### Using geographic coordinates for location <Badge>BETA</Badge>

    You can provide a set of `latitude` , `longtitude` and `radius` as uule parameters, and Bright Data will compose a the closest possible uule encoded location for you.

    The format is `uule=lat,lon,radius`

    > #### Example - searching pizze with Eiffel Tower coordinates: `Lat=48.8584`,  `lon=2.2945` and `radius=200`:

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

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

    Define what device type to be represented in user-agent. <br />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:** <br />`brd_mobile=ios` - iPhone user-agent (alias `brd_mobile=iphone`) <br />`brd_mobile=ipad` - iPad user-agent (alias `brd_mobile=ios_tablet`) <br />`brd_mobile=android` - Android phone <br />`brd_mobile=android_tablet` - Android tablet

    ```sh theme={null}
    curl --proxy brd.superproxy.io:44445 --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. <br />Can be combined with `brd_mobile` to get according mobile browser. <br />Default will provide random browser.

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

    ```sh theme={null}
    curl --proxy brd.superproxy.io:44445 --proxy-user brd-customer-<customer-id>-zone-<zone-name>:<zone-password> "https://www.google.com/search?q=pizza&brd_browser=chrome"
    ```
  </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 <br />`hotel_occupancy=2` (default) - for 2 guests

    ```sh theme={null}
    curl --proxy brd.superproxy.io:44445 --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.<br />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:44445 --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="AI Overview" icon="brain">
    ### `brd_ai_overview`

    Setting `brd_ai_overview=2` will **increase** the likelihood of receiving Google's Generative AI Overviews in your SERP responses, typically appearing in \~15-20%+ of results.

    <Note>
      * Expect an extra \~5-10 seconds of latency in SERP API’s response time with this query paramater, as it launches a browser to capture the entire AI Overview content.
      * To better trigger an AI Overview, your SERP keywords must be relevant to topics that Google considers suitable for generative responses.
    </Note>

    ```sh theme={null}
    curl --proxy brd.superproxy.io:44445 --proxy-user brd-customer-<customer-id>-zone-<zone-name>:<zone-password> "https://www.google.com/search?q=what+makes+the+best+pizza&brd_ai_overview=2"
    ```

    ### Parsed AI Overviews Example

    <CodeGroup>
      ```sh Request: Parsed AIO theme={null}
      curl --proxy brd.superproxy.io:44445 --proxy-user brd-customer-<customer-id>-zone-<zone-name>:<zone-password> "https://www.google.com/search?q=does+honey+ever+expire&brd_json=1&brd_ai_overview=2"
      ```

      ```json Response: AIO exists theme={null}
      {
      //Displaying AIO field snippet below from within the full parsed JSON
        "ai_overview": {
          "texts": [
            {
              "type": "paragraph",
              "snippet": "To make the best pizza, focus on a good pizza dough, high heat baking, and fresh, high-quality toppings. Start with a slow fermentation for the dough, bake on a hot surface like a pizza stone or baking steel, and use fresh, quality toppings.",
              "snippet_highlighted_words": "focus on a good pizza dough, high heat baking, and fresh, high-quality toppings",
              "reference_indexes": [4, 5, 7, 9, 11, 12, 16]
            },
            {
              "type": "paragraph",
              "snippet": "Here's a more detailed breakdown:"
            },
            {
              "type": "list",
              "list": [
                {
                  "type": "paragraph",
                  "snippet": "Slow Fermentation: . Opens in new tabAllow the dough to ferment for a longer period, ideally overnight in the refrigerator. This develops the flavor and makes the crust more chewy and crispy according to Serious Eats and Food & Wine.",
                  "reference_indexes": [2, 3, 6, 22]
                },
                {
                  "type": "paragraph",
                  "snippet": "Flour Selection: . Opens in new tabUse a combination of bread flour for strength and all-purpose flour for a nice rise.",
                  "reference_indexes": [14]
                },
                {
                  "type": "paragraph",
                  "snippet": "Dough Preparation: . Opens in new tabStretch the dough carefully to avoid overworking it, which can make it tough.",
                  "reference_indexes": [13]
                }
              ],
              "title": "1. Dough:"
            },
            {
              "type": "list",
              "list": [
                {
                  "type": "paragraph",
                  "snippet": "High Heat: Preheat your oven to the highest temperature it can reach, ideally between 450°F and 500°F (232°C and 260°C).",
                  "reference_indexes": [9, 12]
                },
                {
                  "type": "paragraph",
                  "snippet": "Hot Baking Surface: Use a pizza stone or baking steel to distribute heat evenly and create a crispy crust.",
                  "reference_indexes": [9, 11]
                },
                {
                  "type": "paragraph",
                  "snippet": "Baking Time: Monitor the pizza closely and bake for 6-15 minutes, depending on the crust thickness and toppings.",
                  "reference_indexes": [9, 12, 17, 21, 23]
                }
              ],
              "title": "2. Baking:"
            },
            {
              "type": "list",
              "list": [
                {
                  "type": "paragraph",
                  "snippet": "Layering: Start with the sauce, followed by a layer of cheese, then meats, and finally vegetables.",
                  "reference_indexes": [15]
                },
                {
                  "type": "paragraph",
                  "snippet": "Fresh Ingredients: Use fresh, high-quality ingredients for the sauce, cheese, and toppings.",
                  "reference_indexes": [0, 4, 18, 20]
                },
                {
                  "type": "paragraph",
                  "snippet": "Pre-Cooked Toppings: Pre-cook toppings like sausage and vegetables that may not cook completely in the short baking time.",
                  "reference_indexes": [10]
                },
                {
                  "type": "paragraph",
                  "snippet": "Sauce: Consider using a simple sauce made with fresh crushed tomatoes, garlic, basil, olive oil, and spices.",
                  "reference_indexes": [0, 4]
                },
                {
                  "type": "paragraph",
                  "snippet": "Cheese: Consider using a combination of low-moisture mozzarella for melting and fresh mozzarella for flavor.",
                  "reference_indexes": [4]
                }
              ],
              "title": "3. Toppings:"
            },
            {
              "type": "list",
              "list": [
                {
                  "type": "paragraph",
                  "snippet": "Dough Storage: Store the dough in a bowl, oiled to prevent sticking, and covered tightly with plastic wrap.",
                  "reference_indexes": [2]
                },
                {
                  "type": "paragraph",
                  "snippet": "Crust: Consider using a baking stone, cast-iron griddle, or perforated pizza pan for a crispier crust.",
                  "reference_indexes": [8, 11]
                },
                {
                  "type": "paragraph",
                  "snippet": "Tossing Dough: For a more professional look, consider using the dough tossing technique.",
                  "reference_indexes": [1, 19, 24]
                }
              ],
              "title": "4. Optional but Recommended:"
            },
            {
              "type": "paragraph",
              "snippet": "This video demonstrates 5 pro chef secrets to the perfect pizza: 57sBigger Bolder Baking with Gemma StaffordYouTube · Jul 18, 2019",
              "image": {
                "image": "https://i.ytimg.com/vi/0hqLSZPaThU/mqdefault.jpg?sqp=-oaymwEGCPgEEOQC&rs=AMzJL3ldq2W1-OGaL6qxskwJT0GAYMe_4w",
                "image_url": "https://i.ytimg.com/vi/0hqLSZPaThU/mqdefault.jpg?sqp=-oaymwEGCPgEEOQC&rs=AMzJL3ldq2W1-OGaL6qxskwJT0GAYMe_4w"
              }
            }
          ],
          "references": [
            {
              "href": "https://www.youtube.com/watch?v=mRx_odAj-XQ&t=147",
              "title": "The Best Pizza You'll Ever Make | Epicurious 101 - YouTube",
              "subtitle": "Apr 18, 2023 — and they have a ton of flavor as well i'm using crushed peeled tomatoes. you can use whole peeled or diced tomatoes. w...",
              "source": "YouTube · Epicurious",
              "index": 0
            }
            // ... more references follow
          ]
        }
      }
      ```

      ```js Response: AIO Doesn't exist theme={null}
      {
      //Returned within response headers, displayed when adding `-i` OR `-v` to your request

      `x-brd-warning: AI Overview did not appear on original SERP. Please ensure that you are using the brd_ai_overview=2 query parameter (https://docs.brightdata.com/scraping-automation/serp-api/query-parameters/google#ai-overview), and that your query is relevant for triggering an AI Overview.`
      }
      ```
    </CodeGroup>
  </Accordion>
</AccordionGroup>

### Headers

For the full list of SERP API request headers (session pinning, output format, rate-limit info), see [SERP API features](/scraping-automation/serp-api/features#headers).

The most useful header for Google Web search is `x-unblock-data-format: parsed_light`, which returns a parsed JSON limited to the top 10 organic results with approximately 50% lower latency than full JSON parsing.

```sh theme={null}
curl -k --proxy brd.superproxy.io:44445 --proxy-user brd-customer-<customer-id>-zone-<zone-name>:<zone-password> -H "x-unblock-data-format: parsed_light" "https://www.google.com/search?q=pizza"
```

## Maps

### Query parameters

<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:44445 --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:44445 --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:44445 --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 [Deprecated]" icon="file">
    <Warning>
      **Pagination parameters deprecated on December, 15th 2025.**
    </Warning>

    To get all google maps information use our [Scrapers](/datasets/scrapers/scrapers-library/overview).  Our scrapers library includes a google maps scraper which covers the full data retrieved from a google maps search. Direct scraper link (requires login to Bright Data) [Goole Maps Scraper API](/datasets/scrapers/scrapers-library/overview). 

    ### `start `\[deprecated]

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

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

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

    ***

    <Warning>
      **Deprecated by Google on September 11, 2025.** The `num` parameter no longer sets how many Google results are returned.

      * Google now returns about 10 results per page. The result set size can vary.
      * Use the `start` parameter to paginate through the result set.
      * To get the top 100 results in one request, use the [Get Top 100 Google Results](/scraping-automation/serp-api/get-top-100-google-results) feature.
    </Warning>
  </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:44445 --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_accommodation_type`

    Accomodation type: Hotels or Vacation Rentals.

    > #### Examples:
    >
    > `brd_accommodation_type`=hotels (default) - search for Hotels <br />`brd_accommodation_type`=vacation\_rentals - search for Vacation Rentals

    ```sh theme={null}
    curl --proxy brd.superproxy.io:44445 --proxy-user brd-customer-<customer-id>-zone-<zone-name>:<zone-password> "https://www.google.com/maps/search/hotels+new+york/?brd_accommodation_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 <br />`brd_json=html` - return JSON with "html" field containing raw HTML

    ```sh theme={null}
    curl --proxy brd.superproxy.io:44445 --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>

### Headers

For the full list of SERP API request headers, see [SERP API features](/scraping-automation/serp-api/features#headers).

For Google Maps, set `x-unblock-data-format: parsed_light` to receive parsed JSON results with reduced latency:

```sh theme={null}
curl -k --proxy brd.superproxy.io:44445 --proxy-user brd-customer-<customer-id>-zone-<zone-name>:<zone-password> -H "x-unblock-data-format: parsed_light" "https://www.google.com/maps/search/hotels+new+york/"
```

## Trends

**Required Parameters**<br />`brd_json=1`: Returns parsed JSON results (Trends supports parsed results only).<br />`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>

### Query parameters

<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:44445 --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:44445 --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:44445 --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:**<br />`now 1-H` - Past hour<br />`now 4-H` - Past 4 hours<br />`now 1-d` - Past day<br />`now 7-d` - Past 7 days<br />`today 1-m` - Past 30 days<br />`today 3-m` - Past 90 days<br />`today 12-m` (default) - Past 12 months<br />`today 5-y` - Past 5 years<br />`2020-07-01 2020-12-31` - custom date range

    ```sh theme={null}
    curl --proxy brd.superproxy.io:44445 --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.<br />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:44445 --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.<br />Possible values are: `images`, `news`, `froogle` (for Google Shopping), `youtube`

    ```sh theme={null}
    curl --proxy brd.superproxy.io:44445 --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>

### Headers

For the full list of SERP API request headers, see [SERP API features](/scraping-automation/serp-api/features#headers).

Google Trends responses are always parsed JSON when `brd_json=1` is set, so the `x-unblock-data-format` header is not needed for this endpoint. Use `x-brd-session: <session-id>` to pin requests to the same peer when running consecutive Trends queries.

## Reviews

### Query parameters

<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:44445 --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:44445 --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:**<br />`sort=qualityScore` (default) - most relevant first<br />`sort=newestFirst` - newest first<br />`sort=ratingHigh` - highest rating first<br />`sort=ratingLow` - lowest rating first

    ```sh theme={null}
    curl --proxy brd.superproxy.io:44445 --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:44445 --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 <br />`start=10` - second page of results <br />`start=20` - third page of results, etc.

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

    ### `num`

    <Warning>
      **Deprecated by Google on September 11, 2025.** The `num` parameter no longer sets how many Google results are returned.

      * Google now returns about 10 results per page. The result set size can vary.
      * Use the `start` parameter to paginate through the result set.
      * To get the top 100 results in one request, use the [Get Top 100 Google Results](/scraping-automation/serp-api/get-top-100-google-results) feature.
    </Warning>
  </Accordion>

  <Accordion title="Sample Response" icon="brackets-curly">
    ```json expandable theme={null}
    {
      "reviews": [
        {
          "review_id": "ChdDSUhNMG9nS0VKeTJ0di1zNGFpLXF3RRAB",
          "reviewer": {
            "profile_photo_url": "https://lh3.googleusercontent.com/local-reviews/AJMZ0Qczn4VDfUM6-AtEt-6oaNazFa-i9Fy6kqPVfGIlPil6vJulEYyK8t930jZwOW4hD80mzw=s120-c-br100",
            "display_name": "DLSharpsteen",
            "link": "https://www.tripadvisor.com/ShowUserReviews-g60763-d611947-r1045281816?m=68573&staydates=2026_03_08_2026_03_09&uguests=1_2_0&supdv=desktop&supuc=DE&supul=en"
          },
          "link": "https://www.tripadvisor.com/ShowUserReviews-g60763-d611947-r1045281816?m=68573&staydates=2026_03_08_2026_03_09&uguests=1_2_0&supdv=desktop&supuc=DE&supul=en",
          "source": "Tripadvisor",
          "source_logo": "https://www.gstatic.com/travel-hotels/branding/icon_100532569.png",
          "rating": "5/5",
          "created": "a month ago",
          "comment": "We traveled to NYC to watch The Christmas Spectacular at the Radio City Music Hall and stayed at the Hilton for the night. We loved the location as it was within of 5 minute walking distance of literally everything there is to see at Christmas time. Our room was quite spacious and clean with two full beds and a nice view. Staff was friendly and I loved that you can get there early and check in your bags so you can go explore before check in time as we arrived to the city around noon. Also loved that there was parking on site. We used the valet so you pulled in, got everything out you would need, they give you a card with a number and you walk into the doors and right to the luggage storage area. The elevator system is insane and that's my only complaint. I've never stayed in a hotel where you have to put in your room number and can only ride a certain elevator to your room. Seemed our elevators were always the ones with tons of people waiting to get on or off. The only outside noise you could hear were horns, but I was ok with that and thankful I never heard my neighbors or anyone in the halls. I got an insane discount on my room through my employer otherwise I would never be able to stay here during Christmastime. But I understand why the rate is so high as it is a hotel that sits in the middle of all the amazing attractions NYC has to offer. Would definitely stay here again!"
        },
        {
          "review_id": "Ci9DQUlRQUNvZENodHljRjlvT2tRNFRVOXVUVE51YXpKVVdHb3laV3R5TjNScmRuYxAB",
          "reviewer": {
            "profile_photo_url": "https://lh3.googleusercontent.com/a-/ALV-UjXfHOWf_k3xFLr7N87GuvjsQHzsDSZb3FW1zjSl6LV32uKV4qI=s120-c-rp-mo-ba4-br100",
            "display_name": "Brian Ash",
            "link": "https://www.google.com/maps/contrib/109749787540014073287?hl=en"
          },
          "link": "https://www.google.com/maps/reviews/data=!4m8!14m7!1m6!2m5!1sCi9DQUlRQUNvZENodHljRjlvT2tRNFRVOXVUVE51YXpKVVdHb3laV3R5TjNScmRuYxAB!2m1!1s0x0:0x2a34371cb33f3c80!3m1!1s2@1:CAIQACodChtycF9oOkQ4TU9uTTNuazJUWGoyZWtyN3Rrdnc%7C0dK0Oisp5f4%7C?hl=en",
          "source": "Google",
          "source_logo": "https://www.gstatic.com/images/branding/product/1x/googleg_48dp.png",
          "rating": "4/5",
          "created": "a month ago",
          "date": "2025-12-30",
          "comment": "The staff here were friendly and helpful. Everyone was cheerful and considerate. The staff here made our experience pleasant and memorable. The rooms were nice, but the location is perfect if you want to be in thick of the hustle and bustle of the city. Conveniently located, great facilities and a room rate that won’t break the bank. I wouldn’t hesitate to book again.",
          "review_reply": "Dear Brian,\nThank you for the wonderful review. We are glad to hear our team’s friendliness and positive energy helped make your stay pleasant and memorable. It is great to know you enjoyed the room, facilities, and our convenient location, along with a rate that added value to your visit. We truly appreciate your recommendation and look forward to welcoming you back again.\n\nSincerely,\n\nNew York Hilton Midtown Team\n\nNYCNH_FO@hilton.com",
          "review_reply_created": "a month ago",
          "photos": [
            "https://lh3.googleusercontent.com/geougc-cs/ABOP9pvvgQTSLWCQ056w1UnyiW-HQ8XlJcxFI9RPlNSPw_VjGFToRpXmZvl4zi-1EmutHol0y9EkjJNn7LOXgLtV3M-RZiUdzUcP-0K8jXXVbbJV__zujNJUalJNXk_8iiwT7XV4aLirkNDDr40",
            "https://lh3.googleusercontent.com/geougc-cs/ABOP9pvD_OHm_eM5-xlDtQ_JsJ2G1nFk-C6yxA8kPImAvVnoWEOpmKD-GITwiBPBKFTCXchntdML8EoT1Fwn5WTal5L6PKNOaX4qSVbDJngSeiEkpwX0AB538R2qQNNVSgWFIQ-zenCQzRf535iu",
            "https://lh3.googleusercontent.com/geougc-cs/ABOP9pvPerK2Ko2feiSaSqQCwOyOrUUqeaZw1UEgef_uhHDtHRf13LCTDbS75syJviepVU9D_rM6qZBaxF4PLP_2lj3Z3Mkoo20FgyLuBZeuZVfblLk1irwTk3PtYliKvi2o9do1Ny74hExGanYP",
            "https://lh3.googleusercontent.com/geougc-cs/ABOP9ptH2vxFE-97SR1-wApwuBbfgPUhrskiO6TB47_87hNDP_e6z7RENf90h8aOB3pOmF-FBXrEqc_PsxqKM6GnbGlDzWd3mhvdf8qHm1abUEIiE_IoFBrd5M47Yl_IOVSQauqT8ojHDdOijkKZ",
            "https://lh3.googleusercontent.com/geougc-cs/ABOP9psSapsiHkevwQyqPBj3PGj5eaFmKqzSkxJoGsW7GpJdVvaH1V-2J0vje7ebkIIc5supUOZ1p_C_TlTyBeYr4XvxyIbW-TAt5kadEwN8lTWcrmDts3XG8INb2qyC5tXiY2usAl7wLN6BaRzf",
            "https://lh3.googleusercontent.com/geougc-cs/ABOP9pvufCVXOTmOu11veUvZlM1SzXWm-BSGnIlpEJLfRyoD70KDQvp4R5qRY5p4jIzlmlsXRGSlvsfqeZYzrPVoO6amg1HbiDFoiXnndGaNos1MIGFC_DeN9rgIsvwKiS3MoUD-lSOx7sFZ3IEE",
            "https://lh3.googleusercontent.com/geougc-cs/ABOP9pumyMXze6Vad_DZrwdn-kb4FH_pfJ51p7a7sND0a_46CXOQLiGN0KVNC4-TU2QDjlcQOpnbCC6pggGw7uDwqSl-r6m-kvb89CaIbdY0zzQ5We8XK7EtpDO7nPMDqfbka1GWeYYNlRedBqQf",
            "https://lh3.googleusercontent.com/geougc-cs/ABOP9ptmv7dNkFRK6-Seq0iQTzBnh5NY2ddlrAOLtHP3dpA1Txew87zOcdBFbPciTR5DRQTA_Qgh0NPSH23bSEnrw6fDOihixxEjOKaWAmcliJ2Bsq2XtaOS_j2QmkfF0OcwUnzMOWP1psei0paj"
          ],
          "details": [
            {
              "id": "HOTELS_PILOT_TRIP_TYPE",
              "name": "Trip type",
              "value": "Vacation",
              "description": "What kind of trip was it?"
            },
            {
              "id": "HOTELS_PILOT_TRAVEL_GROUP_TYPE",
              "name": "Travel group",
              "value": "Couple",
              "description": "Who did you travel with?"
            },
            {
              "id": "HOTELS_ASPECT_ROOMS",
              "name": "Rooms",
              "value": 3,
              "description": "Rooms"
            },
            {
              "id": "HOTELS_ASPECT_SERVICES",
              "name": "Service",
              "value": 4,
              "description": "Service"
            },
            {
              "id": "HOTELS_ASPECT_LOCATION",
              "name": "Location",
              "value": 5,
              "description": "Location"
            },
            {
              "id": "HOTELS_VIBE",
              "name": "Hotel highlights",
              "value": "Great view",
              "description": "How would you describe the hotel?"
            }
          ]
        },
        {
          "review_id": "Ci9DQUlRQUNvZENodHljRjlvT205WFNsaDVRWFJUWjBsd1Yxb3pNbmhEUkdnM2EwRRAB",
          "reviewer": {
            "profile_photo_url": "https://lh3.googleusercontent.com/a/ACg8ocK7OOVJIAqO_bUXJsXNClGhPiS_codAAJ_4jbQhjngD2I5VQA=s120-c-rp-mo-ba3-br100",
            "display_name": "L File",
            "link": "https://www.google.com/maps/contrib/112336634363254268566?hl=en"
          },
          "link": "https://www.google.com/maps/reviews/data=!4m8!14m7!1m6!2m5!1sCi9DQUlRQUNvZENodHljRjlvT205WFNsaDVRWFJUWjBsd1Yxb3pNbmhEUkdnM2EwRRAB!2m1!1s0x0:0x2a34371cb33f3c80!3m1!1s2@1:CAIQACodChtycF9oOm9XSlh5QXRTZ0lwV1ozMnhDRGg3a0E%7C0dCjYvbWq6w%7C?hl=en",
          "source": "Google",
          "source_logo": "https://www.gstatic.com/images/branding/product/1x/googleg_48dp.png",
          "rating": "4/5",
          "created": "2 months ago",
          "comment": "Awesome location, rooms were clean and comfortable.  Bar drinks are just ok, food is meh.  But I didn’t go to NYC to eat/drinkk in my hotel.  Its location is perfect.  We walked about 5 miles a day to see what we wanted and to go where we wanted.  Subway was easy to use.  The elevators are nice, but they do need more.  Construction on one, but there is almost always a line to go up and getting down is awful.  Give yourself plenty of time and the higher the room, the easier to get “on”.  Oftentimes people had been waiting multiple stops for the elevator to get down to the lobby, if on lower floors, but it would be full.  That was the only pitfall, but could be a significant one if you are in a hurry.",
          "review_reply": "Thank you for sharing your experience with us. We are glad to hear you enjoyed the clean and comfortable rooms, as well as our convenient location, which made it easy to explore the city on foot and by subway. We appreciate your comments regarding food, beverages, and elevator availability, and we will be reviewing these concerns with our team to help improve the overall guest experience. We appreciate you staying with us and hope to have the chance to host you again.\n\nSincerely,\n\nNew York Hilton Midtown Team\n\nNYCNH_FO@hilton.com",
          "review_reply_created": "2 months ago",
          "details": [
            {
              "id": "HOTELS_PILOT_TRIP_TYPE",
              "name": "Trip type",
              "value": "Vacation",
              "description": "What kind of trip was it?"
            },
            {
              "id": "HOTELS_PILOT_TRAVEL_GROUP_TYPE",
              "name": "Travel group",
              "value": "Family",
              "description": "Who did you travel with?"
            },
            {
              "id": "HOTELS_ASPECT_ROOMS",
              "name": "Rooms",
              "value": 5,
              "description": "Rooms"
            },
            {
              "id": "HOTELS_ASPECT_SERVICES",
              "name": "Service",
              "value": 4,
              "description": "Service"
            },
            {
              "id": "HOTELS_ASPECT_LOCATION",
              "name": "Location",
              "value": 5,
              "description": "Location"
            }
          ]
        },
        {
          "review_id": "Ci9DQUlRQUNvZENodHljRjlvT2t0eVMzWjJjbk5tUWt0TGFFcG5kVU5XWTFvMGQwRRAB",
          "reviewer": {
            "profile_photo_url": "https://lh3.googleusercontent.com/a/ACg8ocIb_1I5stFL2E46ANU5a9D1tE37bd7z3TrcvcjeCv8jbP01sQ=s120-c-rp-mo-ba4-br100",
            "display_name": "Diana Nichols",
            "link": "https://www.google.com/maps/contrib/104268723670363283044?hl=en"
          },
          "link": "https://www.google.com/maps/reviews/data=!4m8!14m7!1m6!2m5!1sCi9DQUlRQUNvZENodHljRjlvT2t0eVMzWjJjbk5tUWt0TGFFcG5kVU5XWTFvMGQwRRAB!2m1!1s0x0:0x2a34371cb33f3c80!3m1!1s2@1:CAIQACodChtycF9oOktyS3Z2cnNmQktLaEpndUNWY1o0d0E%7C0dKeRXjPbb4%7C?hl=en",
          "source": "Google",
          "source_logo": "https://www.gstatic.com/images/branding/product/1x/googleg_48dp.png",
          "rating": "5/5",
          "created": "a month ago",
          "comment": "Absolutely the best stay in the world! My room was clean and quiet and had everything I needed. The room was much bigger than I expected for NYC. Shout out to housekeeping who didn’t make a peep in the hallways as they cleaned the vacant rooms. I didn’t leave until around 2pm so they were working hard. Many hotels (even the best of the best) have housekeepers who talk too loudly in the hallways and constantly slam doors. Not here! They were perfect and I didn’t even know they were there until I left. Can’t tell you how much I appreciate that. Tons of security and police presence for the upcoming celebration (New Year’s) or maybe it’s always like that here. Felt extremely safe and protected. Beautiful spacious clean sparkling lobby. Many upscale shops and stores I didn’t have time to visit. Glistening with inviting items to purchase and view. Wish I would have gone into the shops! The staff was very very friendly from the front desk to the security guard who answered all my questions last night about transportation to JFK and local things to visit near the hotel. The man mopping the floor was super friendly (this was around 1am) trying to give me directions for the subway train etc for the next day to JFK. I had the best latte from the wonderful friendly cafe near the lobby. Everything clean and welcoming and beautifully displayed. I decided to take a taxi to JFK\nand asked for a “nice” taxi driver. The gentleman supervising the taxi line immediately made way for me through the throngs of folks on the street and treated me like a celebrity as he directed me to the next available ride. He didn’t laugh at me and I did get the nicest taxi driver - Fabian!!!  I was given excellent directions to get to the airport in JFK by the transportation and show tickets desk and they explained how to take the train bus subway etc but it seemed a little more difficult than I was in the mood for. The energy out on the street was electric and I also wish I had walked around a little before I left the city. This hotel is convenient to everything! Can’t ask for anything more than the wonderful experience I had at this hotel. Thank you everyone who works there and outside and Happy New Year!!!",
          "review_reply": "Dear Diana,\nIt's an absolute pleasure to learn about the exceptional visit you had with us, and we thank you for your perfect marks. Thank you for also going out of your way to spotlight our safe, welcoming facilities and unbeatable New York location. Of course, we'll be sure our team hears they really made a difference with their outstanding service, and we look forward to seeing you again soon here at New York Hilton Midtown for another unforgettable experience.\n\nSincerely,\n\nNew York Hilton Midtown Team\n\nNYCNH_FO@hilton.com",
          "review_reply_created": "a month ago",
          "details": [
            {
              "id": "HOTELS_PILOT_TRIP_TYPE",
              "name": "Trip type",
              "value": "Business",
              "description": "What kind of trip was it?"
            },
            {
              "id": "HOTELS_PILOT_TRAVEL_GROUP_TYPE",
              "name": "Travel group",
              "value": "Solo",
              "description": "Who did you travel with?"
            },
            {
              "id": "HOTELS_ASPECT_ROOMS",
              "name": "Rooms",
              "value": 5,
              "description": "Rooms"
            },
            {
              "id": "HOTELS_ASPECT_SERVICES",
              "name": "Service",
              "value": 5,
              "description": "Service"
            },
            {
              "id": "HOTELS_ASPECT_LOCATION",
              "name": "Location",
              "value": 5,
              "description": "Location"
            },
            {
              "id": "HOTELS_TIPS_TOPICS_ROOMS",
              "name": "Rooms",
              "value": "My room was perfect and bigger than I expected for NYC.",
              "description": "Rooms"
            },
            {
              "id": "HOTELS_TIPS_TOPICS_SAFETY",
              "name": "Safety",
              "value": "Lots of police officers around! Felt extremely safe.",
              "description": "Safety"
            },
            {
              "id": "HOTELS_TIPS_TOPICS_NOTEWORTHY_DETAILS",
              "name": "Noteworthy details",
              "value": "I just found everyone super friendly. Maybe because I love the people and the energy in NYC anyway.",
              "description": "Noteworthy details"
            },
            {
              "id": "HOTELS_VIBE",
              "name": "Hotel highlights",
              "value": "Luxury",
              "description": "How would you describe the hotel?"
            }
          ]
        },
        {
          "review_id": "Ci9DQUlRQUNvZENodHljRjlvT25ReVRFUTJiV0ZNUkdVNFduaFNTMnh6VmpGSU5uYxAB",
          "reviewer": {
            "profile_photo_url": "https://lh3.googleusercontent.com/a-/ALV-UjXmcoJ3y3xhQX30wsKy5q87OD7qFUR6FDUsw_QDL8EWl8-nUSQ=s120-c-rp-mo-ba3-br100",
            "display_name": "Natiesha Wray Henry",
            "link": "https://www.google.com/maps/contrib/102270227746850983681?hl=en"
          },
          "link": "https://www.google.com/maps/reviews/data=!4m8!14m7!1m6!2m5!1sCi9DQUlRQUNvZENodHljRjlvT25ReVRFUTJiV0ZNUkdVNFduaFNTMnh6VmpGSU5uYxAB!2m1!1s0x0:0x2a34371cb33f3c80!3m1!1s2@1:CAIQACodChtycF9oOnQyTEQ2bWFMRGU4WnhSS2xzVjFINnc%7C0dKxrV3ZLWB%7C?hl=en",
          "source": "Google",
          "source_logo": "https://www.gstatic.com/images/branding/product/1x/googleg_48dp.png",
          "rating": "5/5",
          "created": "a month ago",
          "comment": "Location, Location,  Location! This hotel made adventuring in Manhattan a breeze. Central Park, Radio City, Rockefeller Center, were all so close, there was simply no excuse to not take a walk and be in all the action. We loved to food trucks and vendors near by but we also enjoyed the walkable restaurants close by as well. Staff and facilities were great. I'm so happy we stayed here.",
          "review_reply": "Dear Natiesha,\nThank you for sharing your wonderful experience with us! It's great that our prime location, close to New York's best attractions and dining options, enhanced your visit. We're also happy that our friendly service added to your experience. It was a pleasure having you as our guest, and we look forward to welcoming you back for another memorable stay.\n\nSincerely,\n\nNew York Hilton Midtown Team\n\nNYCNH_FO@hilton.com",
          "review_reply_created": "a month ago",
          "details": [
            {
              "id": "HOTELS_PILOT_TRIP_TYPE",
              "name": "Trip type",
              "value": "Vacation",
              "description": "What kind of trip was it?"
            },
            {
              "id": "HOTELS_PILOT_TRAVEL_GROUP_TYPE",
              "name": "Travel group",
              "value": "Family",
              "description": "Who did you travel with?"
            },
            {
              "id": "HOTELS_ASPECT_ROOMS",
              "name": "Rooms",
              "value": 5,
              "description": "Rooms"
            },
            {
              "id": "HOTELS_ASPECT_SERVICES",
              "name": "Service",
              "value": 5,
              "description": "Service"
            },
            {
              "id": "HOTELS_ASPECT_LOCATION",
              "name": "Location",
              "value": 5,
              "description": "Location"
            },
            {
              "id": "HOTELS_TIPS_TOPICS_ROOMS",
              "name": "Rooms",
              "value": "Cozy and comfortable",
              "description": "Rooms"
            },
            {
              "id": "HOTELS_TIPS_TOPICS_NEARBY_ACTIVITIES",
              "name": "Nearby activities",
              "value": "Times Square is walkable from here",
              "description": "Nearby activities"
            },
            {
              "id": "HOTELS_TIPS_TOPICS_WALKABILITY",
              "name": "Walkability",
              "value": "10 out of 10",
              "description": "Walkability"
            },
            {
              "id": "HOTELS_TIPS_TOPICS_NOTEWORTHY_DETAILS",
              "name": "Noteworthy details",
              "value": "Parking and traffic is a nightmare.",
              "description": "Noteworthy details"
            },
            {
              "id": "HOTELS_VIBE",
              "name": "Hotel highlights",
              "value": "Kid-friendly",
              "description": "How would you describe the hotel?"
            }
          ]
        },
        {
          "review_id": "ChdDSUhNMG9nS0VQdnIyOHU1LVppVGlBRRAB",
          "reviewer": {
            "profile_photo_url": "https://lh3.googleusercontent.com/local-reviews/AJMZ0QfnSFWXMd1oJu73a6IhdtgibYcjse2HKQTHeghNQd9Cyw8DYQQJZDCyh-TD68ehXuY-FA=s120-c-br100",
            "display_name": "R471LZalext",
            "link": "https://www.tripadvisor.com/ShowUserReviews-g60763-d1379306-r1043196288?m=68573&staydates=2026_03_08_2026_03_09&uguests=1_2_0&supdv=desktop&supuc=DE&supul=en"
          },
          "link": "https://www.tripadvisor.com/ShowUserReviews-g60763-d1379306-r1043196288?m=68573&staydates=2026_03_08_2026_03_09&uguests=1_2_0&supdv=desktop&supuc=DE&supul=en",
          "source": "Tripadvisor",
          "source_logo": "https://www.gstatic.com/travel-hotels/branding/icon_100532569.png",
          "rating": "3/5",
          "created": "2 months ago",
          "comment": "Room was ok. For a Hilton I thought it would be better. Could do with an update with better placed plug sockets and some USB sockets. It is 2025 and people need multiple sockets to charge phones, tablets, watches etc.||Staff were underwhelming. Our flight home was cancelled and we had to find accommodation for another night. I understand they couldn’t accept us as they were fully booked. I would have appreciated some sort of effort to see if other Hilton hotels available but no, just a shrug of the shoulders pretty much and left to sort ourselves out. I understand that it is probably over there pay grade. However, a phone call or some sort of contact with other Hilton hotels would have been put our anxiety at ease. I am disappointed because i expect staff from the Hilton brand would excel at customer service, but they didn’t. They would’ve earned a decent tip from it. ||Only 2 things impressed me. The coffee machine in our room and the cleaning staff. They always did a superb job."
        },
        {
          "review_id": "Ci9DQUlRQUNvZENodHljRjlvT2pKdk5FdHVMVW8xTjFoT2MzUjJlamQyV0hSTk4wRRAB",
          "reviewer": {
            "profile_photo_url": "https://lh3.googleusercontent.com/a/ACg8ocKxAYr7LFV6ZMNckj3q8VKiPdMIZXgCzt920CSu2v1nYG3GzQ=s120-c-rp-mo-ba4-br100",
            "display_name": "Elia Alejandra",
            "link": "https://www.google.com/maps/contrib/107082141027365570078?hl=en"
          },
          "link": "https://www.google.com/maps/reviews/data=!4m8!14m7!1m6!2m5!1sCi9DQUlRQUNvZENodHljRjlvT2pKdk5FdHVMVW8xTjFoT2MzUjJlamQyV0hSTk4wRRAB!2m1!1s0x0:0x2a34371cb33f3c80!3m1!1s2@1:CAIQACodChtycF9oOjJvNEtuLUo1N1hOc3R2ejd2WHRNN0E%7C0d6T99EL24S%7C?hl=en",
          "source": "Google",
          "source_logo": "https://www.gstatic.com/images/branding/product/1x/googleg_48dp.png",
          "rating": "2/5",
          "created": "3 months ago",
          "comment": "Room had a nice view. Staff was friendly.\nRoom was dirty when we walked in. There were hairs in the bathtub, and sink wasn’t very clean. Restrooms and rooms along with furniture are very old! Bedsheets had some hairs and not very clean. Room was cleaned once out of 4 days so it’s not daily. They do give you a 35$ voucher for the cafe they have and 25$ for their services. Luggage hold is free if you get there early but they charge 5$ a piece if you need to check out of your room but still have time before the airport. Elevators are nice they have a system that makes it run smoother.\nHotel seems very central so that’s a good thing. Lots of things around but that’s just New York.\nOver all because of how old rooms seems and how dirty it was 2/5. Wouldn’t stay here again .",
          "review_reply": "Dear Elia,\nThank you for taking the time to share such detailed feedback. We’re glad to hear you enjoyed the wonderful view, the fantastic location, and the friendliness of the team, but we’re truly sorry to learn that the room did not meet expectations during your stay. Your comments about cleanliness, upkeep, and service frequency are important, and they’ll be shared with the appropriate teams so we can take a closer look. We appreciate you noting the helpful amenities like the café credit, services credit, luggage storage, and elevator system as well. We’re grateful for your perspective and hope the rest of your time in New York City was wonderful.\n\nSincerely,\n\nNew York Hilton Midtown Team\n\nNYCNH_FO@hilton.com",
          "review_reply_created": "3 months ago",
          "details": [
            {
              "id": "HOTELS_PILOT_TRIP_TYPE",
              "name": "Trip type",
              "value": "Vacation",
              "description": "What kind of trip was it?"
            },
            {
              "id": "HOTELS_PILOT_TRAVEL_GROUP_TYPE",
              "name": "Travel group",
              "value": "Family",
              "description": "Who did you travel with?"
            },
            {
              "id": "HOTELS_ASPECT_ROOMS",
              "name": "Rooms",
              "value": 1,
              "description": "Rooms"
            },
            {
              "id": "HOTELS_ASPECT_SERVICES",
              "name": "Service",
              "value": 3,
              "description": "Service"
            },
            {
              "id": "HOTELS_ASPECT_LOCATION",
              "name": "Location",
              "value": 4,
              "description": "Location"
            }
          ]
        },
        {
          "review_id": "Ci9DQUlRQUNvZENodHljRjlvT2xWbGRIaHFUblkzZFdaaFdITlNRMlZNZDE5bmNHYxAB",
          "reviewer": {
            "profile_photo_url": "https://lh3.googleusercontent.com/a-/ALV-UjUizL79_bwGWMDpI7JDM4zojb6e6Ufpryfw23XnFxFSFJMHriK_=s120-c-rp-mo-ba3-br100",
            "display_name": "Amanda Garcia",
            "link": "https://www.google.com/maps/contrib/102898602342998029792?hl=en"
          },
          "link": "https://www.google.com/maps/reviews/data=!4m8!14m7!1m6!2m5!1sCi9DQUlRQUNvZENodHljRjlvT2xWbGRIaHFUblkzZFdaaFdITlNRMlZNZDE5bmNHYxAB!2m1!1s0x0:0x2a34371cb33f3c80!3m1!1s2@1:CAIQACodChtycF9oOlVldHhqTnY3dWZhWHNSQ2VMd19ncGc%7C0dGM04hI_ys%7C?hl=en",
          "source": "Google",
          "source_logo": "https://www.gstatic.com/images/branding/product/1x/googleg_48dp.png",
          "rating": "5/5",
          "created": "2 months ago",
          "comment": "From the moment we arrived, our experience at this hotel was nothing short of exceptional. The property is beautiful, impeccably clean, and thoughtfully designed for comfort and relaxation. Every detail reflected true five-star quality.\nWhat truly made our stay unforgettable was the incredible staff. The team went above and beyond to make us feel welcomed and valued. Special recognition to Lek at concierge, Christina in housekeeping, Brian and Joland at front desk for their professionalism, warmth, and genuine care. Their attentiveness and willingness to assist with every request during our stay as we celebrate a birthday made a lasting impression.\nHousekeeping was flawless, the amenities were excellent, and the overall atmosphere was both luxurious and inviting. This hotel sets the standard for hospitality, and we cannot wait to return.\nHighly recommend to anyone looking for an outstanding stay! Location a huge plus.",
          "review_reply": "Dear Amanda,\nIt's an absolute pleasure to read about the exceptional celebration experience you had with us here at New York Hilton Midtown. Thank you for going out of your way to write about our gorgeous property, where comfort and charm come together perfectly, and we're delighted our team was able to make your experience that much more memorable. We'll be sure your thoughtful compliments are shared with them, and we hope to have the opportunity to welcome you back soon, whether for another special occasion or simply a relaxing New York getaway.\n\nSincerely,\n\nNew York Hilton Midtown Team\n\nNYCNH_FO@hilton.com",
          "review_reply_created": "2 months ago",
          "details": [
            {
              "id": "HOTELS_ASPECT_ROOMS",
              "name": "Rooms",
              "value": 5,
              "description": "Rooms"
            },
            {
              "id": "HOTELS_ASPECT_SERVICES",
              "name": "Service",
              "value": 5,
              "description": "Service"
            },
            {
              "id": "HOTELS_ASPECT_LOCATION",
              "name": "Location",
              "value": 5,
              "description": "Location"
            }
          ]
        },
        {
          "review_id": "ChZDSUhNMG9nS0VKdXluNURVNjR1UWJnEAE",
          "reviewer": {
            "profile_photo_url": "https://lh3.googleusercontent.com/local-reviews/AJMZ0QdVsxDWqDDLG62Q3M3dmLlHORJs5jz0NWRJO3cP21KtRNPfosO7RpofjnbUgpyNjOTDew=s120-c-br100",
            "display_name": "LisaO964",
            "link": "https://www.tripadvisor.com/ShowUserReviews-g60763-d611947-r1045294524?m=68573&staydates=2026_03_08_2026_03_09&uguests=1_2_0&supdv=desktop&supuc=DE&supul=en"
          },
          "link": "https://www.tripadvisor.com/ShowUserReviews-g60763-d611947-r1045294524?m=68573&staydates=2026_03_08_2026_03_09&uguests=1_2_0&supdv=desktop&supuc=DE&supul=en",
          "source": "Tripadvisor",
          "source_logo": "https://www.gstatic.com/travel-hotels/branding/icon_100532569.png",
          "rating": "4/5",
          "created": "a month ago",
          "comment": "Spent 6 nights here with my family- arrives 9.45pm due to flight delay but on arrival rooms were not ready, the gentleman at check in was helpful and found us a room however it was interconnecting with another family which meant we were disturbed by their noise quite a lot. However, this hotel is really lovely and other than this and the elevators being slow I can’t fault it. They have installed a new elevator system and should have thought it through as during busy times they are packed and it can take quite some time to get one. |Rooms are lovely , cleaned every day, excellent location and staff all really lovely. I would recommend staying here."
        },
        {
          "review_id": "ChdDSUhNMG9nS0VNT3NySlBUc01UbTZRRRAB",
          "reviewer": {
            "profile_photo_url": "https://lh3.googleusercontent.com/local-reviews/AJMZ0Qdvd3mFTmnQslJajBtyC7hGXBv5KKEN_7z5ZnXByEfDkAAFDmgEV3HW1P9_iXApXyf1XA=s120-c-br100",
            "display_name": "bobrobb",
            "link": "https://www.tripadvisor.com/ShowUserReviews-g60763-d611947-r1045071077?m=68573&staydates=2026_03_08_2026_03_09&uguests=1_2_0&supdv=desktop&supuc=DE&supul=en"
          },
          "link": "https://www.tripadvisor.com/ShowUserReviews-g60763-d611947-r1045071077?m=68573&staydates=2026_03_08_2026_03_09&uguests=1_2_0&supdv=desktop&supuc=DE&supul=en",
          "source": "Tripadvisor",
          "source_logo": "https://www.gstatic.com/travel-hotels/branding/icon_100532569.png",
          "rating": "2/5",
          "created": "a month ago",
          "comment": "On a positive, the location is excellent and the room was big enough for a family which I think is a rarity for such a location.  We visited from 30th Dec to 6th Jan and in all honesty the hotel is just not set up to be running at capacity.  There were queues for everything, check in, check out, restrooms, bars and the lifts.  The lifts deserve a special mention - if on a lower floor you might have to wait for 5 to 6 lifts to get one that had any capacity if heading down at a busy time.  The service at check in and check out was pretty non- existent, the $35 “destination charge” is to encourage you to spend in their bar.  If lucky enough to actually get served in the lobby bar 2 x beers is more than the $35 - it just leaves a bad taste.  There are no tea and coffee facilities in room (a given in UK), but on a positive note towels were changed daily.  When checking out this morning nobody asked us how our stay was, totally impersonal, then we got hit with the $5 per item holding fee, to hold our baggage from 12 noon to 2 pm - as we had 7 items (hand luggage also counts as a separate item) we got a $35 charge after checking out.  If anyone genuinely cared about customer experience, that would have been taken out of your destination charge, but of course that isn’t possible.    It is a shame really, a once grand hotel, living off the Hilton brand, in need of a refurb with a clear focus on revenue creation as opposed to customer experience.  The location just isn’t enough to make up for the lack of experience I’m afraid - there are much better out there."
        }
      ]
    }

    ```
  </Accordion>
</AccordionGroup>

### Headers

For the full list of SERP API request headers, see [SERP API features](/scraping-automation/serp-api/features#headers).

For Google Reviews, set `x-unblock-data-format: parsed_light` to receive parsed JSON results. Combine with `x-brd-session: <session-id>` to pin paginated review fetches (`start`) to the same peer.

```sh theme={null}
curl -k --proxy brd.superproxy.io:44445 --proxy-user brd-customer-<customer-id>-zone-<zone-name>:<zone-password> -H "x-unblock-data-format: parsed_light" -H "x-brd-session: my-session-123" "https://www.google.com/reviews?fid=0x808fba02425dad8f%3A0x6c296c66619367e0"
```

## Images

Google image search uses `udm=2` (replaces deprecated `tbm=isch` since March 2026). Below are the parameters specific to image search.

### Query parameters

<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:44445 --proxy-user brd-customer-<customer-id>-zone-<zone-name>:<zone-password> "https://www.google.com/search?q=pizza&udm=2&gl=us"
    ```

    ***

    ### `hl`

    Two-letter language code used to define the page languages

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

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

    Use `udm=2` to enter Google Image search.

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

    ### `safe`

    You can control the images' search with 3 modes:

    1. `off` - This will display all images, even inapproproate ones.
    2. `on` or `active` - This mode will filter out from the results in appropriate results.
    3. `images` - This mode will show a blurred version of the inappropriate images.

    Use `safe=[mode]` to get the required results.

    This is examples for blured images filter. 

    > We cannot publish inappropriate search terms in our documentation - so our default search term here will remain `pizza` . To see the actual impact, you need to modify the search term.

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

    ### `tbm` \[deprecated]

    <Warning>
      `tbm=isch` is deprecated since March 2026 and now redirects to `udm=2`. Use `udm=2` instead.
    </Warning>

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

  <Accordion title="Image size" icon="image">
    ### `tbs`

    Usage: `tbs=isz:[l|m|i]` to set preferred image size filter (large, medium, small).

    ```sh theme={null}
    curl --proxy brd.superproxy.io:44445 --proxy-user brd-customer-<customer-id>-zone-<zone-name>:<zone-password> "https://www.google.com/search?q=pizza&udm=2&tbs=isz:l"
    ```
  </Accordion>
</AccordionGroup>

### Headers

For the full list of SERP API request headers, see [SERP API features](/scraping-automation/serp-api/features#headers).

For Google Image search, set `x-unblock-data-format: parsed_light` to receive parsed JSON results:

```sh theme={null}
curl -k --proxy brd.superproxy.io:44445 --proxy-user brd-customer-<customer-id>-zone-<zone-name>:<zone-password> -H "x-unblock-data-format: parsed_light" "https://www.google.com/search?q=pizza&udm=2"
```

## Lens

### Query parameters

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

    URL of image you want to search

    ```sh theme={null}
    curl --proxy brd.superproxy.io:44445 --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:44445 --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="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:44445 --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 alt="brd_lens" />

    ```sh theme={null}
    curl --proxy brd.superproxy.io:44445 --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>

### Headers

For the full list of SERP API request headers, see [SERP API features](/scraping-automation/serp-api/features#headers).

For Google Lens, set `x-unblock-data-format: parsed_light` to receive parsed JSON results. When uploading an image as a file (`POST` to `/v3/upload`), `x-brd-session: <session-id>` is required to keep the upload and result fetch on the same peer.

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

## Hotels

### Query parameters

<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:44445 --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:44445 --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:44445 --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 <br />`brd_occupancy=2` (default) - for 2 persons <br />`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) <br />`brd_occupancy=2,1,3` - for 2 adults and 2 children (1 and 3 years old)

    ```sh theme={null}
    curl --proxy brd.superproxy.io:44445 --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 <br />`brd_free_cancellation=false` (default) - show any offers

    ```sh theme={null}
    curl --proxy brd.superproxy.io:44445 --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_accommodation_type`

    Accomodation type: Hotels or Vacation Rentals.

    > #### Examples:
    >
    > `brd_accommodation_type=hotels` (default) - search for Hotels <br />`brd_accommodation_type=vacation_rentals` - search for Vacation Rentals

    ```sh theme={null}
    curl --proxy brd.superproxy.io:44445 --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_accommodation_type=vacation_rentals"
    ```

    ### `brd_currency`

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

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

    ```sh theme={null}
    curl --proxy brd.superproxy.io:44445 --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:** <br />`brd_mobile=ios` - iPhone user-agent (alias `brd_mobile=iphone`) <br />`brd_mobile=ipad` - iPad user-agent (alias `brd_mobile=ios_tablet`) <br />`brd_mobile=android` - Android phone <br />`brd_mobile=android_tablet` - Android tablet

    ```sh theme={null}
    curl --proxy brd.superproxy.io:44445 --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 <br />`brd_json=html` - return JSON with "html" field containing raw HTML

    ```sh theme={null}
    curl --proxy brd.superproxy.io:44445 --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>

### Headers

For the full list of SERP API request headers, see [SERP API features](/scraping-automation/serp-api/features#headers).

For Google Hotels, set `x-unblock-data-format: parsed_light` to receive parsed JSON results. Combine with `x-brd-session: <session-id>` to keep `brd_dates` and `brd_occupancy` queries pinned to a stable peer.

```sh theme={null}
curl -k --proxy brd.superproxy.io:44445 --proxy-user brd-customer-<customer-id>-zone-<zone-name>:<zone-password> -H "x-unblock-data-format: parsed_light" "https://www.google.com/travel/hotels/four%20seasons%20hotel%20new%20york%20downtown/entity/CgoIovWq7d7c9psTEAE/prices"
```

## 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:44445 --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:44445 --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:44445 --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:44445 --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>


# SERP API Yandex query parameters
Source: https://docs.brightdata.com/scraping-automation/serp-api/query-parameters/yandex

Explore Yandex query parameters for the Bright Data SERP API (31 languages), including localization, pagination, time range and device targeting for results.

## Search

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

    Region or country to search.

    > #### Examples:
    >
    > `1` - Berlin \
    > `2` - London \
    > `84` - USA \
    > `95` - Canada \
    > `134` - China

    ```sh theme={null}
    curl --proxy brd.superproxy.io:44445 --proxy-user brd-customer-<customer-id>-zone-<zone-name>:<zone-password> "https://www.yandex.com/search/?text=pizza&lr=84"
    ```

    ### `lang`

    Two-letter language code used to define the page language

    ```sh theme={null}
    curl --proxy brd.superproxy.io:44445 --proxy-user brd-customer-<customer-id>-zone-<zone-name>:<zone-password> "https://www.yandex.com/search/?text=pizza&lang=en"
    ```
  </Accordion>

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

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

    > #### Examples:
    >
    > `p=1` (default) - first page of results \
    > `p=2` - second page of results \
    > `p=4` - fourth page of results, etc.

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

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

    Time range to search.

    > **Available values are:** \
    > `77` - Past 24 hours \
    > `1` - Past 2 weeks \
    > `[%pm]` - Past month

    ```sh theme={null}
    curl --proxy brd.superproxy.io:44445 --proxy-user brd-customer-<customer-id>-zone-<zone-name>:<zone-password> "https://www.yandex.com/search/?text=pizza&within=1"
    ```
  </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:44445 --proxy-user brd-customer-<customer-id>-zone-<zone-name>:<zone-password> "https://www.yandex.com/search/?text=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:44445 --proxy-user brd-customer-<customer-id>-zone-<zone-name>:<zone-password> "https://www.yandex.com/search/?text=pizza&brd_browser=chrome"
    ```
  </Accordion>
</AccordionGroup>


# Create your first SERP API
Source: https://docs.brightdata.com/scraping-automation/serp-api/quickstart

Get started with the Bright Data SERP API (31 languages) in 3 steps: create a zone, generate credentials and send your first Google search query.

<Callout icon="badge-dollar">
  **Start free, no credit card required**

  Your free tier includes **5,000 credits every month** for the SERP API. Create your SERP API and start sending requests immediately, no payment method needed. [Learn more about the free tier](/general/account/billing-and-pricing/free-tier).
</Callout>

<Steps>
  <Step title={<a href="https://brightdata.com/cp/start">Sign in to Bright Data</a>} />

  <Step title={<>Navigate to <a href="https://brightdata.com/cp/web_access/new">Create an API</a> page</>}>
    Navigate to **Create an API** under the **Web Access API** section in the left menu.

    <Frame>
      <img alt="Create an API" />
    </Frame>
  </Step>

  <Step title="Choose SERP API">
    Select **SERP API** and click **Continue**.

    <Frame>
      <img alt="SERP API" />
    </Frame>
  </Step>

  <Step title="Assign a name to your SERP API">
    Enter a meaningful name. Optionally, add a short description.

    <Warning>
      **The SERP API name cannot be changed once created.**

      All other settings can be modified later. For details, see [Configure your API](/scraping-automation/serp-api/configuration).
    </Warning>

    <Frame>
      <img alt="API Name" />
    </Frame>
  </Step>

  <Step title="Finalize API creation">
    Click **Add API**. Your SERP API is now ready to use.
  </Step>
</Steps>


# Send your first SERP API request
Source: https://docs.brightdata.com/scraping-automation/serp-api/send-your-first-request

Step-by-step guide to sending your first SERP API request, with copy-paste curl examples for HTTP and SOCKS5 proxy interfaces.

## Make your first request in minutes

Test the SERP API in minutes with this ready-to-use code example.

<CardGroup>
  <Card title="Postman Example" icon="user-astronaut" href="https://www.postman.com/bright-data-api/bright-data-api/request/kpq952m/google-search" />

  <Card title="Node.js Example" icon="code" href="https://github.com/luminati-io/bright-data-serp-api-nodejs-project" />

  <Card title="Python Example" icon="code" href="https://github.com/luminati-io/bright-data-web-unlocker-python-project" />
</CardGroup>

Bright Data offers two methods for accessing SERP API, both delivering **identical** results while catering to different customer workflows:

<CardGroup>
  <Card title="Direct API access (recommended)" href="/scraping-automation/serp-api/send-your-first-request#direct-api-access-recommended">
    A pure REST API method for easy access and straightforward integration.
  </Card>

  <Card title="Native proxy-based access" href="/scraping-automation/serp-api/send-your-first-request#native-proxy-based-access">
    For workflows that rely on proxy-based routing.
  </Card>
</CardGroup>

## Direct API access (recommended)

A simple and RESTful way to interact with Bright Data's SERP API. Direct API access abstracts proxy management and allows you to send requests via a central endpoint, ensuring ease of use and straightforward REST API integration.

### When to use direct API access

* Centralized endpoint: Access SERP API via a single, RESTful endpoint.
* Streamlined direct integration: Eliminating the complexity of managing proxies or routing.
* Single API key authentication: Secure and easy to use, replacing the need for username-password management.

### Sending your first request

After [setting up](/scraping-automation/serp-api/quickstart) your SERP API zone, you'll find a working SERP API request example and your API key within your zone's **Overview** tab:

<Frame>
  <img alt="SERP API Overview tab" />
</Frame>

The following is an example of a simple SERP API cURL request:

```sh Direct API access - cURL theme={null}

curl -H "Content-Type: application/json" -H "Authorization: Bearer [INSERT_YOUR_API_KEY]" -d '{"zone": "[INSERT_YOUR_SERP_API_ZONE_NAME]","url": "[INSERT_YOUR_TARGET_URL]", "format": "raw"}' https://api.brightdata.com/request
```

### Request breakdown

1. API Endpoint: [`https://api.brightdata.com/request`](https://api.brightdata.com/request)
2. Authorization Header: `Authorization: Bearer [INSERT YOUR API key]`
   * Your API key is found within your SERP API zone.
3. Payload:
   * `zone`: Your specific SERP API **zone name**.
   * `url`: The full SERP target URL (including SERP query params) that you wish to access via SERP API.
   * `format`: Defines the response format. Use `raw` to receive the raw response from the target site.

### Generating your Bright Data API key

A Bright Data API key is your secure authentication token for accessing SERP API via Direct API access. When adding a new SERP API zone in the [control panel](https://brightdata.com/cp/zones), an API key will be generated automatically and can be found within the **Overview** tab of your zone.

<Frame>
  <img alt="SERP API key" />
</Frame>

**To generate a new API key:**

* Navigate to [Account settings](https://brightdata.com/cp/setting/users).
* Scroll down and click the Add API key button.
* Follow the on-screen instructions to complete the process.

<Tip>
  We strongly recommend to have an expiration date set on your API key for increased security.
</Tip>

<Warning>
  The API key will be shown to you on the screen **only** so make sure you copy and store it in a safe location per your organization's policies
</Warning>

## Native proxy-based access

In order to access SERP API, you will need to provide credentials which are comprised of:

1. Your customer ID
2. Your SERP API zone name
3. Your SERP API password
4. Bright Data SSL certificate

### Where to find your customer ID

Customer ID can be found in the welcome email you received, or by clicking your account initial letter on the top right screen of your control panel, or by clicking here: [Account settings](https://brightdata.com/cp/setting/customer_details) .

### Zone name and password

Your zone name and password can be found in the overview tab of your Web Unlocker API zone in the control panel.

### Bright Data SSL Certificate

<Warning>
  Prevent SSL errors by setting up Bright Data SSL certificate
</Warning>

SSL Certificate can be found by clicking "SSL certificate" wizard on your zone's overview top menu. See further instructions here:  [SSL certificate](/general/account/ssl-certificate#how-to-download-the-ssl-certificate).

Alternatively, you can  [ignore SSL errors](/general/account/ssl-certificate#how-to-ignore-ssl-errors).

### SERP API: HTTPS Proxy code examples

Once you have your API credentials, use the following code to send your first request:

<CodeGroup>
  ```sh cURL theme={null}
  curl "https://www.google.com/search?q=pizza" --proxy brd.superproxy.io:44445 --proxy-user brd-customer-<customer_id>-zone-<zone_name>:<zone_password> -k
  ```

  ```js Node.js theme={null}
  #!/usr/bin/env node

  const { ProxyAgent, setGlobalDispatcher } = require('undici');

  setGlobalDispatcher(new ProxyAgent('http://brd-customer-<customer_id>-zone-<zone_name>:<zone_password>@brd.superproxy.io:44445'));

  (async () => {
    const response = await fetch('https://www.google.com/search?q=pizza');
    console.log(await response.text());
  })();
  ```

  ```python Python theme={null}
  import pprint
  import requests


  host = 'brd.superproxy.io'
  port = 44445

  username = 'brd-customer-<customer_id>-zone-<zone_name>'
  password = '<zone_password>'

  proxy_url = f'http://{username}:{password}@{host}:{port}'

  proxies = {
      'http': proxy_url,
      'https': proxy_url
  }


  url = "https://www.google.com/search?q=pizza&brd_json=1"
  response = requests.get(url, proxies=proxies, verify=False)
  pprint.pprint(response.json())
  ```

  ```php PHP theme={null}

  <?php
  echo 'To enable your free eval account and get CUSTOMER, YOURZONE and '
      .'YOURPASS, please contact sales@brightdata.com';
  $curl = curl_init('https://www.google.com/search?q=pizza');
  curl_setopt($curl, CURLOPT_PROXY, 'http://brd.superproxy.io:44445');
  curl_setopt($curl, CURLOPT_PROXYUSERPWD, 'brd-customer-<customer_id>-zone-<zone_name>:<zone_password>');
  curl_exec($curl);
  ?>
  ```

  ```ruby Ruby theme={null}
  #!/usr/bin/ruby

  require 'uri'
  require 'net/http'
  require 'net/https'

  puts 'To enable your free eval account and get CUSTOMER, YOURZONE and YOURPASS, please contact sales@brightdata.com'

  uri = URI.parse('https://www.google.com/search?q=pizza')
  proxy = Net::HTTP::Proxy('brd.superproxy.io', 44445, 'brd-customer-<customer_id>-zone-<zone_name>', '<zone_password>')

  req = Net::HTTP::Get.new(uri)

  result = proxy.start(uri.host,uri.port, :use_ssl => uri.scheme == 'https') do |http|
      http.request(req)
  end

  puts result.body
  ```

  ```cs C# theme={null}
  using System;
  using System.Net;

  class Example {
    static void Main() {
      var client = new WebClient();
      client.Proxy = new WebProxy("brd.superproxy.io:44445");
      client.Proxy.Credentials = new NetworkCredential(
        "brd-customer-<customer_id>-zone-<zone_name>",
        "<zone_password>"
      );
      Console.WriteLine(client.DownloadString("https://www.google.com/search?q=pizza"));
    }
  ```

  ```java Java theme={null}
  package example;

  import org.apache.http.HttpHost;
  import org.apache.http.client.fluent.*;

  public class Example {
      public static void main(String[] args) throws Exception {
          System.out.println("To enable your free eval account and get "
              +"CUSTOMER, YOURZONE and YOURPASS, please contact "
              +"sales@brightdata.com");
          HttpHost proxy = new HttpHost("brd.superproxy.io", 44445);
          String res = Executor.newInstance()
              .auth(proxy, "brd-customer-<customer_id>-zone-<zone_name>", "<zone_password>")
              .execute(Request.Get("https://www.google.com/search?q=pizza").viaProxy(proxy))
              .returnContent().asString();
          System.out.println(res);
      }
  }
  ```

  ```perl Perl theme={null}
  #!/usr/bin/perl

  print 'To enable your free eval account and get CUSTOMER, YOURZONE and '
      .'YOURPASS, please contact sales@brightdata.com';
  use LWP::UserAgent;
  my $agent = LWP::UserAgent->new();
  $agent->proxy(['http', 'https'], "http://brd-customer-<customer_id>-zone-<zone_name>:<zone_password>\@brd.superproxy.io:44445");
  print $agent->get('https://www.google.com/search?q=pizza')->content();
  ```

  ```vb VBA theme={null}
  Imports System.Net

  Module Module1
      Sub Main()
          Console.WriteLine("To enable your free eval account and get " & 
              "CUSTOMER, YOURZONE and YOURPASS, please contact " &
              "sales@brightdata.com")
          Dim Client As New WebClient
          Client.Proxy = New WebProxy("http://brd.superproxy.io:44445")
          Client.Proxy.Credentials = New NetworkCredential("brd-customer-<customer_id>-zone-<zone_name>", "<zone_password>")
          Console.WriteLine(Client.DownloadString("https://www.google.com/search?q=pizza"))
      End Sub
  End Module
  ```
</CodeGroup>


# Your first async SERP API request
Source: https://docs.brightdata.com/scraping-automation/serp-api/your-first-async-request

Send asynchronous requests to the Bright Data SERP API (31 languages) and retrieve search results via snapshot ID and webhook delivery.

<Accordion title="Prerequisites" icon="list-check">
  The following are required:

  * [A Bright Data account](https://brightdata.com/?hs_signup=1\&utm_source=docs)
  * [A Bright Data API key](/api-reference/authentication#how-do-i-generate-a-new-api-key)
  * [An active SERP API zone](https://brightdata.com/cp/zones)
  * [Basic knowledge of cURL](https://curl.se/)
</Accordion>

<Steps>
  <Step title="Enable &#x22;Asynchronous requests&#x22;">
    In the SERP API [zone](https://brightdata.com/cp/zones), under "Advanced settings", enable the "Asynchronous requests" toggle.

    <Frame>
      <img alt="Enable async requests" />
    </Frame>
  </Step>

  <Step title="Send your first async request">
    The following request submits an [asynchronous SERP API](/api-reference/rest-api/serp/request) job:

    <CodeGroup>
      ```bash cURL icon=rectangle-terminal theme={null}
      curl --request POST \
        --url 'https://api.brightdata.com/serp/req?zone=<serp-zone-name>' \
        --header 'Authorization: Bearer <API_KEY>' \
        --header 'Content-Type: application/json' \
        --data '{
            "query": {"q": "pizza",},
            "brd_json": "json"
          }'
      ```

      ```python Python theme={null}
        import requests

        url = "https://api.brightdata.com/serp/req?zone=<serp-zone-name>"

        payload = {
            "query": {
                "q": "pizza",
            },
            "brd_json": "json"
        }
        headers = {
            "Authorization": "Bearer <API_KEY>",
            "Content-Type": "application/json"
        }

        response = requests.post(url, json=payload, headers=headers)

        print(response.text)
      ```

      ```js Node.js theme={null}
        const options = {
          method: 'POST',
          headers: {Authorization: 'Bearer <API_KEY>', 'Content-Type': 'application/json'},
          body: JSON.stringify({
            query: {q: 'pizza'},
            brd_json: 'json'
          })
        };

        fetch('https://api.brightdata.com/serp/req?zone=<serp-zone-name>', options)
          .then(res => res.json())
          .then(res => console.log(res))
          .catch(err => console.error(err));
      ```
    </CodeGroup>

    <Callout icon="key">
      Replace `<API_KEY>` and `<serp-zone-name>` with valid values.
    </Callout>
  </Step>

  <Step title="Wait and check status">
    The request returns a `response_id` used to retrieve results after processing completes.

    ```json theme={null}
    {
      "response_id": "s4t7w3619285042ra9dke1m8qx"
    }
    ```

    If the request is still processing, the API returns HTTP `202`:

    ```json HTTP/202 theme={null}
    "Request is pending"
    ```

    <Callout icon="hourglass">
      Processing time is typically up to 5 minutes and may extend to 8 hours during peak periods.

      Responses are retained for up to 48 hours from submission time.
    </Callout>
  </Step>

  <Step title="Retrieve your results">
    The following [request retrieves](/api-reference/rest-api/serp/get-results) the completed result:

    ```sh theme={null}
    curl --silent --compressed \
      "https://api.brightdata.com/unblocker/get_result?&response_id=${RESPONSE_ID}" \
      -H "Authorization: Bearer [API_KEY]" \
      -o results.json
    ```

    <Callout icon="file-arrow-down">
      The response body is written to `results.json`.
    </Callout>
  </Step>

  <Step title="Verify the output">
    Display the saved file:

    ```sh theme={null}
      cat results.json
    ```

    The file contains structured JSON SERP results. For example:

    ```json Sample Response expandable theme={null}
      {
        "general": {
          "search_engine": "google",
          "query": "pizza",
          "results_cnt": 1200000000,
          "search_time": 0.45,
          "language": "en",
          "location": "United States",
          "mobile": false,
          "basic_view": false,
          "search_type": "text",
          "page_title": "pizza - Google Search",
          "timestamp": "2026-02-19T09:23:10.353Z"
        },
        "input": {
          "original_url": "http://www.google.com/search?q=pizza&hl=en&gl=us"
        },
        "organic": [
          {
            "link": "https://www.pizzahut.com/",
            "source": "Pizza Hut",
            "display_link": "https://www.pizzahut.com",
            "title": "Pizza Hut | Delivery & Carryout - No One OutPizzas The Hut!",
            "description": "Discover classic & new menu items, find deals and enjoy seamless ordering for delivery and carryout. No One OutPizzas the Hut®.",
            "snippet_highlighted_words": [
              "classic & new menu items"
            ],
            "icon": "data:image/png;base64 ...",
            "image": "data:image/jpeg;base64 ...",
            "image_alt": "pizza from www.pizzahut.com",
            "image_base64": "data:image/jpeg;base64 ...",
            "rank": 1,
            "global_rank": 4
          },
          {
            "link": "https://www.dominos.com/",
            "source": "Domino's",
            "display_link": "https://www.dominos.com",
            "title": "Domino's: Pizza Delivery & Carryout, Pasta, Wings & More",
            "description": "Order pizza, pasta, sandwiches & more online for carryout or delivery from Domino's. View menu, find locations, track orders. Sign up for Domino's email ...",
            "snippet_highlighted_words": [
              "Order pizza, pasta, sandwiches & more online for carryout or delivery"
            ],
            "icon": "data:image/png;base64, ...",
            "rank": 2,
            "global_rank": 5
          },
          {
            "link": "https://en.wikipedia.org/wiki/Pizza",
            "source": "Wikipedia",
            "display_link": "https://en.wikipedia.org › wiki › Pizza",
            "title": "Pizza",
            "description": "Pizza is an Italian dish typically consisting of a flat base of leavened wheat-based dough topped with tomato, cheese, and other ingredients, baked at a ...Read more",
            "snippet_highlighted_words": [
              "an Italian dish typically consisting of a flat base of leavened wheat-based dough"
            ],
            "icon": "data:image/png;base64 ...",
            "image": "data:image/jpeg;base64 ...",
            "image_alt": "pizza from en.wikipedia.org",
            "image_base64": "data:image/jpeg;base64 ...",
            "rank": 3,
            "global_rank": 6
          }
        ],
        "perspectives": [
          {
            "title": "Barstool Pizza Review - Flour + Water Pizzeria (San Francisco, CA)",
            "author": "One Bite Pizza Reviews · YouTube",
            "source": "Pizza reviews & rankings",
            "date": "97.3K+ views · 10 hours ago",
            "link": "https://www.youtube.com/watch?v=7iWWdSsTI0I",
            "image": "https://img.youtube.com/vi/7iWWdSsTI0I/hqdefault.jpg",
            "image_url": "https://img.youtube.com/vi/7iWWdSsTI0I/hqdefault.jpg"
          },
          {
            "title": "Are there any just Sicilian style pizza places?",
            "author": "Pizzaholics · Facebook",
            "source": "Pizza enthusiast",
            "date": "8 reactions · 9 hours ago",
            "link": "https://www.facebook.com/groups/742034912983989/posts/2424981814689282/",
            "image": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcTAPzkwKJX8rct5LhEtAN6p-ypb5UjDiHn0aZ8e9S6nS8tPmROY_1E2gFxXeus&usqp=CAI&s",
            "image_url": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcTAPzkwKJX8rct5LhEtAN6p-ypb5UjDiHn0aZ8e9S6nS8tPmROY_1E2gFxXeus&usqp=CAI&s"
          },
          {
            "title": "Top Pizza in the Bay Area",
            "author": "Cesar Hernandez, Soleil Ho",
            "source": "San Francisco Chronicle",
            "date": "2 weeks ago",
            "link": "https://www.sfchronicle.com/projects/2023/best-pizza-sf-bay-area/",
            "image": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcSPGyTJpaRNE8ruXgkLdHkPFLVu5T7ykcJezvyYa07SUmrk7T0XaSntO19GBw&usqp=CAI&s",
            "image_url": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcSPGyTJpaRNE8ruXgkLdHkPFLVu5T7ykcJezvyYa07SUmrk7T0XaSntO19GBw&usqp=CAI&s"
          }
        ],
        "knowledge": {
          "name": "Pizza",
          "summary": "Dish",
          "subtitle": "Dish"
        },
        "overview": {
          "title": "Pizza",
          "kgmid": "/m/0663v"
        },
        "snack_pack_map": {
          "image": "data:image/png;base64 ...",
          "image_base64": "data:image/png;base64 ...",
          "link": "https://www.google.com/search?q=pizza&sca_esv=9559f81e103ba33b&hl=en&gl=us&udm=1&lsack=fdaWadL4D5OP9u8P8LrdoAI&sa=X&ved=2ahUKEwiSq-PSneWSAxWTh_0HHXBdFyQQtgN6BAgdEAM"
        },
        "snack_pack": [
          {
            "cid": "2036127367591792815",
            "name": "Hunt Brothers Pizza",
            "image": "data:image/png;base64 ...",
            "image_base64": "data:image/png;base64 ...",
            "reviews_cnt": 1,
            "type": "Pizza",
            "price": "$",
            "work_status": "Pit stop for pizza & chicken wings",
            "address": "Hollister, MO",
            "rank": 1,
            "global_rank": 1
          }
        ],
        "pagination": {
          "pages": [
            {
              "page": 2,
              "start": 10,
              "link": "https://www.google.com/search?q=pizza&sca_esv=9559f81e103ba33b&hl=en&gl=us&ei=fdaWadL4D5OP9u8P8LrdoAI&start=10&sa=N&sstk=Af77f_chnDKNIlZ0IppYwCTGX-8AsCUfZH2WQB4kzsZIYRjsE5mqBJMEdWa84P7jgf603q2kg3ocZLtVg3UcaoXgLxAF8bRxzTc64g&ved=2ahUKEwiSq-PSneWSAxWTh_0HHXBdFyQQ8tMDegQICxAE"
            },
            {
              "page": 3,
              "start": 20,
              "link": "https://www.google.com/search?q=pizza&sca_esv=9559f81e103ba33b&hl=en&gl=us&ei=fdaWadL4D5OP9u8P8LrdoAI&start=20&sa=N&sstk=Af77f_chnDKNIlZ0IppYwCTGX-8AsCUfZH2WQB4kzsZIYRjsE5mqBJMEdWa84P7jgf603q2kg3ocZLtVg3UcaoXgLxAF8bRxzTc64g&ved=2ahUKEwiSq-PSneWSAxWTh_0HHXBdFyQQ8tMDegQICxAG"
            },
            {
              "page": 4,
              "start": 30,
              "link": "https://www.google.com/search?q=pizza&sca_esv=9559f81e103ba33b&hl=en&gl=us&ei=fdaWadL4D5OP9u8P8LrdoAI&start=30&sa=N&sstk=Af77f_chnDKNIlZ0IppYwCTGX-8AsCUfZH2WQB4kzsZIYRjsE5mqBJMEdWa84P7jgf603q2kg3ocZLtVg3UcaoXgLxAF8bRxzTc64g&ved=2ahUKEwiSq-PSneWSAxWTh_0HHXBdFyQQ8tMDegQICxAI"
            }
          ],
          "current_page": 1,
          "next_page": 2,
          "next_page_start": 10,
          "next_page_link": "https://www.google.com/search?q=pizza&sca_esv=9559f81e103ba33b&hl=en&gl=us&ei=fdaWadL4D5OP9u8P8LrdoAI&start=10&sa=N&sstk=Af77f_chnDKNIlZ0IppYwCTGX-8AsCUfZH2WQB4kzsZIYRjsE5mqBJMEdWa84P7jgf603q2kg3ocZLtVg3UcaoXgLxAF8bRxzTc64g&ved=2ahUKEwiSq-PSneWSAxWTh_0HHXBdFyQQ8tMDegQICxAE"
        },
        "related": [
          {
            "text": "Pizza wiki",
            "link": "https://www.google.com/search?sca_esv=9559f81e103ba33b&hl=en&gl=us&q=Pizza+wiki&sa=X&ved=2ahUKEwiSq-PSneWSAxWTh_0HHXBdFyQQ1QJ6BAhLEAE",
            "rank": 1,
            "global_rank": 17
          },
          {
            "text": "Pizza open",
            "link": "https://www.google.com/search?sca_esv=9559f81e103ba33b&hl=en&gl=us&q=Pizza+open&sa=X&ved=2ahUKEwiSq-PSneWSAxWTh_0HHXBdFyQQ1QJ6BAhfEAE",
            "rank": 2,
            "global_rank": 18
          },
          {
            "text": "Pizza Hut near me",
            "link": "https://www.google.com/search?sca_esv=9559f81e103ba33b&hl=en&gl=us&q=Pizza+Hut+near+me&sa=X&ved=2ahUKEwiSq-PSneWSAxWTh_0HHXBdFyQQ1QJ6BAheEAE",
            "rank": 3,
            "global_rank": 19
          }
        ],
        "people_also_ask": [
          {
            "question": "What's the 2 hour rule for pizza?",
            "question_type": "featured",
            "answer_source": "Green Lantern Pizza",
            "answer_link": "https://greenlanternpizza.com/blog/how-long-does-pizza-last/#:~:text=Sitting%20out%20at%20Room%20Temperature,-How%20long%20can&text=The%20United%20States%20Department%20of,two%20hours%20before%20tossing%20it.",
            "answer_display_link": "https://greenlanternpizza.com › blog › how-long-does-pi...https://greenlanternpizza.com › blog › how-long-does-pi...",
            "answers": [
              {
                "type": "answer",
                "value": {
                  "text": "Sitting out at Room Temperature The United States Department of Agriculture (USDA) strongly recommends following the “two-hour rule” when leaving food out, meaning you shouldn't let pizza or takeout sit at room temperature for over two hours before tossing it.Jan 29, 2025"
                },
                "rank": 1
              }
            ],
            "rank": 1,
            "global_rank": 7
          }
        ]
      }
    ```

    <Callout icon="party-horn">
      **Congratulations!** If the file contains valid JSON search results, you're done!
    </Callout>
  </Step>
</Steps>

## Can Bright Data send the response to a target which I specify?

No. Our Async mechanism requires you to poll with the request ID and pull your request on demand.

Our scrapers do support relaying a payload to a target you provide: if this is a crucial part of your flow, use our google scrapers instead.


# Best practices for Web Unlocker API
Source: https://docs.brightdata.com/scraping-automation/web-unlocker/bestpractices

Best practices for targeting API endpoints with the Bright Data Web Unlocker API (98% success rate), including troubleshooting and alternative methods.

## Overview

When using Web Unlocker API, targeting specific API endpoints of product or other pages is a common strategy to extract necessary data efficiently. In most scenarios, Web Unlocker API can access these API endpoints successfully. However, there are instances where unlocking an API endpoint may face challenges, while the required data remains accessible on the main webpage.

## Best Practices for API Endpoint Targeting

### Direct API Access

Initially, attempt to directly target the API endpoint with Web Unlocker API. This method in most cases will work out of the box.

### Alternative Approach for Unblocking Issues

If direct API endpoint targeting is unsuccessful, shift your focus to the main webpage from which the API gathers its data. Web Unlocker API is designed to access and unlock data on these primary web pages effectively. This will ensure you still retrieve the necessary information without direct API access.

### Leveraging Browser API for Complex Cases

For cases where accessing the API endpoint directly is critical, and alternative methods are not sufficient, our [Browser API](/scraping-automation/scraping-browser) can be utilized.

Use Browser API to load the webpage, and set the request interception on the API call that is done by the frontend, so you can read the desired API response.

### Can I use Web Unlocker API with Browsers (e.g. Chrome) or Browser Automation Libraries (e.g., Puppeteer, Playwright, Selenium)?

**No.** You should not use the Web Unlocker API with browsers (e.g., Chrome, Firefox, Edge), anti-detect browsers (e.g., Adspower, Multilogin), or browser automation libraries (e.g., Puppeteer, Playwright, Selenium).

Web Unlocker API is optimized for scraping data from websites **without interaction**, focusing on delivering clean HTML/JSON responses to singular requests while managing proxy and unblocking infrastructure.

Using the Web Unlocker API directly with browsers usually does not work, and even if it does, it can also lead to unnecessarily increased costs.

If you do need to interact with web pages, you have a few options:

* **For regular browsers** (e.g., Chrome, Firefox, Edge) and **anti-detect browsers** (e.g., Adspower, Multilogin), you should use our **proxy networks** (Data Center, ISP, Mobile, Residential). Integration guides for these products are available here: [Proxy Integrations (brightdata.com)](/integrations)

* **For browser automation libraries** (e.g., Puppeteer, Playwright, Selenium), you may use proxy networks; but an even better solution is the **Browser API** product, which provides unblocking capabilities similar to the Web Unlocker API but is designed to work seamlessly with browser automation. For more information on the Browser API, visit: [Introduction to Browser API - Bright Data Docs](/scraping-automation/scraping-browser/introduction)


# Web Unlocker API configuration
Source: https://docs.brightdata.com/scraping-automation/web-unlocker/configuration

Configure the Bright Data Web Unlocker API (98% success rate): premium domains, async processing, custom headers, cookies and auto-throttling controls.

## When to use premium domains

Some websites employ more advanced anti-bot and traffic filtering mechanisms that require additional resources to unblock successfully. To support these targets, Bright Data offers a **separate premium pricing tier** for a predefined list of domains.

You can review the current list of premium domains here: [Current list of premium domains](/scraping-automation/web-unlocker/features#current-list-of-premium-domains)

When premium domains are enabled:

* Requests to listed domains are charged at the premium rate
* The estimated cost is reflected in the **Estimated cost** section of your zone

<Note>
  Enabling premium domains does **not** affect all traffic.

  Only requests made to domains on the premium list are billed at the higher rate. Requests to all other domains continue to use the standard pricing tier.
</Note>

## How to configure advanced options

Advanced options allow you to fine-tune how the Web Unlocker API processes requests, handles failures, and optimizes success rates.

### How to enable asynchronous requests

By default, requests are processed synchronously, returning a response immediately.\
For long-running or high-volume workloads, you can enable **asynchronous requests**.

With asynchronous processing:

* Requests are handled in the background
* Responses can be retrieved later via a designated endpoint
* Overall stability and throughput are improved for large-scale jobs

This mode is recommended when:

* Target websites respond slowly
* You are processing large batches of URLs
* You want to decouple request submission from response handling

Learn more about asynchronous workflows here: [Asynchronous requests](/scraping-automation/web-unlocker/your-first-async-request)

### Custom Web Unlocker API (Custom Headers & Cookies)

By default, the Web Unlocker API automatically generates optimal headers and cookies for each request. In some advanced scenarios, you may need full control over these values to access a **specific site version or user flow**.

Enabling **Custom Headers & Cookies** allows you to override the automated behavior and provide your own values.

<Note>
  Enabling **Custom Headers & Cookies** introduces the following changes:

  <AccordionGroup>
    <Accordion title="Access to a Pre-approved List of Headers and Cookies">
      You gain access to a pre-approved list of supported headers and cookies.
      This list allows you to verify whether the values you need are already approved for use with your target website.
    </Accordion>

    <Accordion title="Send Request for New Headers/Cookies">
      If your required headers or cookies are not listed, you can submit an approval request to Bright Data’s compliance team.
      The request must include details about the header/cookie and its purpose.
      Once reviewed, you will be notified when approval is granted.
    </Accordion>

    <Accordion title="Charging for All Requests">
      Unlike the regular Web Unlocker API logic, which only charges for successful requests, enabling this feature means you’ll be charged for 100% of the requests (both successful and failed). This change is due to Bright Data not having full control over the process and its performance.
    </Accordion>
  </AccordionGroup>
</Note>

#### Enable custom headers & cookies

To enable this feature:

1. Log in to the **Bright Data Control Panel**
2. Select the relevant **Web Unlocker API zone**
3. Open **Advanced Options** and enable **Custom headers & cookies**.
4. Once enabled, start sending custom headers and cookies with your requests.

Once enabled, you can begin sending custom headers and cookies with your requests.

### Control over auto-throttling

The Web Unlocker API includes an intelligent **auto-throttling mechanism** designed to protect performance and reduce unnecessary costs.

Auto-throttling dynamically adjusts request behavior based on real-time success rates.

<Tabs>
  <Tab title="Automatic optimization">
    The system continuously evaluates request performance and automatically applies better-performing configurations when available.
  </Tab>

  <Tab title="Low success-rate protection">
    If the success rate for a target site drops below a defined threshold, the system begins throttling requests.
    This prevents repeated failures and conserves resources.
  </Tab>

  <Tab title="Customizable success threshold">
    By default, the throttling threshold is set to **70% success rate**.

    When **Custom Headers & Cookies** are enabled, you can customize this threshold to any value that fits your workload.
    This is especially useful when all requests are billable and tighter control is required.
  </Tab>
</Tabs>


# Web Unlocker API features
Source: https://docs.brightdata.com/scraping-automation/web-unlocker/features

Reference for Bright Data Web Unlocker API features (98% success rate): CAPTCHA solving, Premium Domains, custom headers, cookies and Browser Rendering.

## Disable CAPTCHA Solving

By default, as part of our full proxy unblocking solution, Web Unlocker API also solves CAPTCHAs that are encountered while returning your proxy request.

When disabling CAPTCHA solver, our intelligent algorithm still takes care of the entire ever-changing flow of finding the best proxy network, customizing headers, fingerprinting, and more, but intentionally does not solve CAPTCHAs automatically, giving your team a lightweight, streamlined solution, that broadens the scope of your potential scraping opportunities.

**Best for:**

* Scraping data from websites without getting blocked
* Emulating real-user web behavior
* Teams that don't have an unblocking infrastructure in-house and **don't want** their scraper to solve CAPTCHAs automatically

<Accordion title="How can I get started?">
  To disable CAPTCHA solving just open the relevant zone, go to the ‘configuration’ tab and open the advanced settings where you will find the ‘Automatic Captcha Solving’ controller. To disable CAPTCHA solving just switch off the toggle.

  <Frame>
    <img alt="automatic-captcha-solving.png" />
  </Frame>
</Accordion>

## Web Unlocker API Premium Domains

Premium domains are a part of Bright Data's tiered website classification system. These are websites that are more challenging to unblock than others and require additional Web Unlocker API resources.

In this article, we will see the current list of Premium domains, understand how to target them, and go over the special pricing.

<Note>
  The premium domains list is updated quarterly using our website classification logic and we’ll notify you via email 30 days in advance of any changes to your domains. You can always access the most up-to-date list in your Web Unlocker API zone.
</Note>

### Current List of Premium Domains

<Accordion title="Expand to view current premium domains">
  <div>
    Loading...
  </div>
</Accordion>

### Enable Premium Domains

When creating your Web Unlocker API zone, check the 'Premium Domains' box under Special features

<Frame>
  <img alt="Enable Premium Domains" />
</Frame>

### Pricing

Once enabled, the premium price will be reflected in the "Estimated cost" section. Check out the [pricing page](https://brightdata.com/pricing) to see exact numbers, but keep in mind these prices are usually for "Pay as you go" plans and you can enjoy significant discounts if you sign up to a package or talk to our sales people!

<Note>
  Even after enabled, only specific requests to these domains will be priced at the higher rate. Requests to other domains will be kept at the default lower tier.
</Note>

## Geolocation Targeting `-country-country_code`

<Tip>
  Web Unlocker automatically selects the optimal IP location for targeting your domain, reducing the need for manual configuration in **most** cases. Manual geo-targeting is useful when accessing region-restricted or location-specific data.
</Tip>

If you want to target from a specific **country** in Web Unlocker API refer to [geolocation targeting](/api-reference/proxy/geolocation-targeting).

## Mobile User-agent Targeting `-ua-mobile`

By default, Web Unlocker API uses desktop-specific user agents for your requests. To use a **mobile** user agent instead, simply append `-ua-mobile` to your request. 

## Scrape as markdown

Web Unlocker is able to live convert your pages from HTML to markdown. This makes it easier to feed your LLM training system, for example.

To activate the feature, add the `x-unblock-data-format: markdown` header when using the native proxy interface, or set `data_format: 'markdown'` when using the API.

<CodeGroup>
  ```shell HTTP API theme={null}
  API_KEY=your_api_key_here
  ZONE=your_zone_here
  curl -v \
     -H "Authorization: Bearer $API_KEY" \
     -H 'content-type: application/json' \
     --data '{"url": "https://example.com", "zone": "'$ZONE'", "format": "raw", "data_format": "markdown"}' \
     https://api.brightdata.com/request
  ```

  ```shell Native proxy interface theme={null}
  curl -vk \
      -x brd-customer-$CUSTOMER_ID-zone-$ZONE:$PASSWORD@brd.superproxy.io:44445 \
      -H 'x-unblock-data-format: markdown' \
      https://example.com
  ```
</CodeGroup>

## Return a screenshot

Web Unlocker is able to take a screenshot of the page you are trying to scrape. This can be useful for debugging or for monitoring the page's appearance.

To activate the feature, add the `x-unblock-data-format: screenshot` header when using the native proxy interface or add `data_format: screenshot` to request body when using API interface.

Output format is `.png`

<CodeGroup>
  ```shell HTTP API theme={null}
  curl -k https://api.brightdata.com/request \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer <YOUR API KEY>" \
  -d '{"zone":"unblocker","url":"https://example.com","format":"raw","data_format":"screenshot"}' \
  --silent --output example_com.png
  ```

  ```shell Native proxy interface theme={null}
  curl -k \
      -x brd-customer-$CUSTOMER_ID-zone-$ZONE:$PASSWORD@brd.superproxy.io:44445 \
      -H 'x-unblock-data-format: screenshot' \
      https://example.com > example_com.png
  ```
</CodeGroup>

## Unlock Fragmented URL in a single call

Unlock a fragmanted URL (broken by a `#` charachter) using Web Unlocker API.

### Using REST API

Just provide the fragmented URL, Bright Data Unlocker will handle and retreive the results. Response time may take a bit longer due to increased processing and retreival.

Example:

```bash theme={null}
curl 'https://api.brightdata.com/request' -H 'Content-Type: application/json' -H 'Authorization: Bearer API_KEY' -d '{"zone": "zone3","url": "https://www.somesite.com#!/path1/id11133/9*Fmt=100", "format": "raw", "headers": {"x-unblock-expect": "{\"element\": \".pace-done\"}"}}'
```

### Using Native API

A special header is introduced for this purpose: `x-unblock-url-fragment` . Relay this header and add the fragment.

Example:

```bash theme={null}
curl -i --proxy brd.superproxy.io:44445 --proxy-user brd-customer-someID-zone-myunlocker:**passwd** -k "https://www.site.com/" -H 'x-unblock-url-fragment: !/path1/id11133/9*Fmt=100' -H 'x-unblock-expect: {"element": ".pace-done"}' 
```

## Force JavaScript rendering with a browser

You can instruct Web Unlocker to force JavaScript rendering using a browser by adding the `render `parameter to your request. Since this flag forces browser use, you may see significant increase in response time, so use it only when needed, and scarcely.

<CodeGroup>
  ```shell HTTP API theme={null}
  curl -k https://api.brightdata.com/request \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer <YOUR API KEY>" \
  -d '{"zone":"unblocker","url":"https://example.com","format":"raw","render":"true"}' 
  ```

  ```shell Native proxy interface theme={null}
  curl -k \
      -x brd-customer-$CUSTOMER_ID-zone-$ZONE-render:$PASSWORD@brd.superproxy.io:44445 \
       https://example.com
  ```
</CodeGroup>

## Custom Web Unlocker API

Gain enhanced control over your requests with flexible options to fine-tune website behavior and optimize request handling.

By default, Web Unlocker API automatically manages all request headers, cookies, expect elements etc., to get the best known results and any extra elements that are sent along with the request are disregarded.

Custom Web Unlocker API allows you to override the automated parameters and send your own custom values specific to your needs.

### Which custom features are available

* [Manual headers & cookies](/scraping-automation/web-unlocker/features#manual-headers-%26-cookies)
* [Manual ‘expect’ elements](/scraping-automation/web-unlocker/features#manual-%E2%80%98expect%E2%80%99-elements)

### How to enable

In the Control Panel, go to your specific **Web Unlocker API** zone -> Configuration -> Advanced Settings, and enable the Custom Web Unlocker API feature you want to use.

<img alt="Enable Premium Domains" />

Once enabled, you can now send Custom Web Unlocker API requests in accordance with each [custom feature's](/scraping-automation/web-unlocker/features#custom-features%3A) procedure.

### How billing changes with custom features

Unlike the regular Web Unlocker API billing logic, which only charges for successful requests, when any of the above Custom Web Unlocker API features are **enabled**, you'll be billed for 100% of the requests (both successful and failed).

Since you are now in control of certain request paramaters, Bright Data can no longer take full responsibility for the unlocking process and its performance.

<Warning>
  **Be advised:**

  * We do not allow cookies for login/authentication purposes
  * Adding custom paramaters to your request may result in blocking and a drop in the success rate.
</Warning>

### Manual headers & cookies

Override automated headers/cookies and send your own custom values in order to target specific versions of a website.

<Note>
  Enabling **Custom Headers & Cookies** results in the following

  <AccordionGroup>
    <Accordion title="Access to Pre-approved List of Headers/Cookies">
      You'll gain access to a pre-approved list of headers and cookies. You can browse through this list to verify that the required headers and cookies are approved for your target site.
    </Accordion>

    <Accordion title="Send Request for New Headers/Cookies">
      If your required headers or cookies are not on the pre-approved list, you can submit a form to our compliance team for approval. This process involves providing information about the headers/cookies and their necessity. After a short approval process is completed, you will be notified by our compliance team.
    </Accordion>

    <Accordion title="Charging for All Requests">
      Unlike the regular Web Unlocker API billing logic, which only charges for successful requests, enabling this feature means you'll be charged for 100% of the requests (both successful and failed). This change is due to Bright Data not having full control over the process and its performance.
    </Accordion>
  </AccordionGroup>
</Note>

### Manual ‘expect’ elements

In case of receiving partially rendered/loaded pages, you can use the `x-unblock-expect` header to instruct Web Unlocker API to wait for specific elements or text before returning the response.\
This feature allows you to define expectations, such as a CSS selector, specific text, or the page body, that must be present before the page is considered fully loaded.

You can configure this per request with the `x-unblock-expect` header seen below.

**Add header**

<CodeGroup>
  ```shell Element must exist theme={null}
  curl -vk \
      -x brd-customer-$CUSTOMER_ID-zone-$ZONE:$PASSWORD@brd.superproxy.io:44445 \
      -H 'x-unblock-expect: {"element": ".some-css-selector"}' \
      https://example.com
  ```

  ```shell Page must include text theme={null}
  curl -vk \
      -x brd-customer-$CUSTOMER_ID-zone-$ZONE:$PASSWORD@brd.superproxy.io:44445 \
      -H 'x-unblock-expect: {"text": "items in stock"}' \
      https://example.com
  ```
</CodeGroup>

### Amazon-specific geolocation headers

Web Unlocker API allows you to pass custom headers to simulate a user-selected city and  ZIP code on Amazon, enabling access to region-specific content, pricing, and delivery options.

* `x-unblock-city` - Simulates selecting a city.
* `x-unblock-zipcode` - Simulates selecting a ZIP code on Amazon.
* `x-unblock-get-sponsored` - Simulated sponsored-specific rules on Amazon pages to improve the consistency/appearance of sponsored results. It’s recommended to use it only on requests where sponsored data is required (omit otherwise).

<CodeGroup>
  ```shell Example theme={null}
  curl -vk \
  -x brd-customer-$CUSTOMER_ID-zone-$ZONE:$PASSWORD@brd.superproxy.io:44445 \
  -H 'x-unblock-zipcode: 10001' \
  -H 'x-unblock-city: New York' \
  https://www.amazon.com/
  ```
</CodeGroup>

## Monitor Web Unlocker API Usage

To review your current Web Unlocker API CPM, navigate to [My Proxies](https://brightdata.com/cp/zones) page, and review the **Traffic** column.

<Frame>
  <img alt="Monitor Web Unlocker API Usage" />
</Frame>

### How to read usage numbers

The number displayed in the traffic column above is the number of **successful requests**. In the example above, 115k requests are equal to 115 CPM, so you'll be billed according to the rate of 10 CPMs for that billing cycle.

### How is usage calculated?

Your Web Unlocker API usage is measured by CPM. CPM is the cost of 1000 **successful requests,** meaning only successful Web Unlocker API requests will count toward your billing.

See our [Billing & Pricing](/general/account/billing-and-pricing/payment) page to learn more.

## Debugging Web Unlocker API

Sometimes it's useful to extract some debug info about your requests to understand what happened inside them in more detail.

We provide the `x-brd-debug` response header for this purpose.

How you switch it on depends on which access type you're using, the same Native / API choice you see in the Playground of your [zone](https://brightdata.com/cp/zones):

| Access type            | How to enable                              |
| ---------------------- | ------------------------------------------ |
| Native proxy interface | Append `-debug-full` to the proxy username |
| HTTP API               | Set `"debug": true` in the request body    |

For asynchronous requests, set `"debug": true` on the **submit** call to `/unblocker/req`. The `x-brd-debug` header is then returned by `/unblocker/get_result` when you collect the response. Submitting without the flag returns no debug header at collection time.

<Note>
  This feature is only available for the Web Unlocker API and is NOT available for our proxy products.
</Note>

<Tip>
  `x-brd-debug` is a **response header**, so two flags matter:

  * Print headers with `-v` or `-i`. A plain `curl` shows only the body, which looks like the feature returned nothing.
  * On the native proxy interface, keep `-k` for HTTPS targets. Without it curl rejects the proxy's certificate, the tunnelled request never completes, and you see only the bare `HTTP/1.1 200 OK` of the CONNECT, with no debug header.
</Tip>

<CodeGroup>
  ```shell Native proxy interface theme={null}
  curl -vk \
      -x brd-customer-$CUSTOMER_ID-zone-$ZONE-debug-full:$PASSWORD@brd.superproxy.io:44445 \
      https://example.com
  ```

  ```shell HTTP API (sync) theme={null}
  curl -i --request POST \
    --url https://api.brightdata.com/request \
    --header "Authorization: Bearer $API_KEY" \
    --header "Content-Type: application/json" \
    --data '{
      "zone": "web_unlocker1",
      "url": "https://example.com",
      "format": "raw",
      "debug": true
    }'
  ```

  ```shell HTTP API (async) theme={null}
  # 1. Submit the job with "debug": true, and keep the response_id.
  RESPONSE_ID=$(curl --silent --request POST \
    --url "https://api.brightdata.com/unblocker/req?zone=web_unlocker1" \
    --header "Authorization: Bearer $API_KEY" \
    --header "Content-Type: application/json" \
    --data '{"url": "https://example.com", "debug": true}' \
    | sed -En 's/.*"response_id":"([^"]+)".*/\1/p')

  # 2. Collect the result. x-brd-debug is returned here, not on the submit.
  #    Wait ~20s before the first poll, 10s before the second, then 5s.
  #    HTTP 202 means the job is still running.
  curl -i --silent --compressed \
    --url "https://api.brightdata.com/unblocker/get_result?response_id=$RESPONSE_ID" \
    --header "Authorization: Bearer $API_KEY"
  ```
</CodeGroup>

The format of the `x-brd-debug` header looks like this:

```text theme={null}
req_id=hl_d09913c7_a1lw123bkcg; bytes_up=2842; bytes_down=562418; billed=false; destination_ip=162.219.225.118; used_req_headers=accept-language,accept; peer_ip=r868133f79d0c3fa9d7c7ccca0151af2e; peer_country=us; render=false
```

| Field              | Description                                                                                                                                                                                   |
| ------------------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| req\_id            | The internal ID of your request into the Bright Data Web Unlocker API. Providing this can be helpful in bug reports as it will help us see details on what happened in your specific request. |
| bytes\_up          | The amount of outgoing traffic the Bright Data Web Unlocker API recorded while processing this request                                                                                        |
| bytes\_down        | The amount of incoming traffic the Bright Data Web Unlocker API recorded while processing this request                                                                                        |
| billed             | Whether the Bright Data Web Unlocker API considers this a billable request or not                                                                                                             |
| destination\_ip    | The IP address of the remote server used to fetch this data                                                                                                                                   |
| used\_req\_headers | Return custom headers which were relayed in the initial request.                                                                                                                              |
| peer\_ip           | A unique identifier for the IP address used to make the request. This is mainly useful to validate IP rotation is working as you expect                                                       |
| peer\_country      | The country of the peer that was used for the request                                                                                                                                         |
| render             | Shows whether the returned page is the result after a browser rendered the HTML or the response body of a single HTTP request                                                                 |

## Common Error Codes

Occasionally, for a number of reasons, you might receive an unexpected error code in response to your Web Unlocker API request.

The following list will provide you with a deeper understanding of what the source of the issue may be.

| Error                                              | Description                                                                                                                                                                                                                                                         |
| -------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `404`                                              | Page not found. Invalid URL, which suggests the URL might be broken or dead.                                                                                                                                                                                        |
| [403](/proxy-networks/faqs#what-is-error-code-403) | The URL you're trying to access is valid, but you are forbidden from accessing that URL.                                                                                                                                                                            |
| [502](/proxy-networks/faqs#what-is-error-code-502) | Error code `502` is the most common error for Web Unlocker API users, the descriptive part is under the `x-luminati-error-code`.                                                                                                                                    |
| `407`                                              | This error code suggests one of your account credentials is incorrect (password or zone's name).                                                                                                                                                                    |
| `429`                                              | This error code implies a rate limit (rare). In such cases, if the response appears as below, Bright Data is applying auto-throttling to the request, and you should open a ticket or email [support@brightdata.com](mailto:support@brightdata.com) for assistance. |
| `401`                                              | Bad request, usually happens in API requests when headers or cookies missing.                                                                                                                                                                                       |
| `503`                                              | HTTP error code `503` means "Service Unavailable". Browser check failed or browser check wasn't completed                                                                                                                                                           |

```js theme={null}
< HTTP/1.1 429 The request was auto-throttled due to low success rate  
< x-luminati-error-code: sr_rate_limit
< x-luminati-error: The request was auto-throttled due to low success rate
< x-brd-error-code: sr_rate_limit
< x-brd-error: The request was auto-throttled due to low success rate
< date: Tue, 23 Jan 2024 17:07:19 GMT
< connection: keep-alive
< keep-alive: timeout=5
< transfer-encoding: chunked
< 
* Connection #0 to host brd.superproxy.io left intact
```

<Accordion title="Contact support for further assistance">
  If you encounter an issue with Web Unlocker API, before reporting it to us, please test with the instructions and tips below:

  1. Open '[API & Examples](https://brightdata.com/cp/zones/proxy_examples)' in your control panel
  2. Select `curl` and your Web Unlocker API zone
  3. Paste the URL of your target in the 'URL' box
  4. Copy with the button on the right
  5. Add `-v -o test` to your command (this will turn on verbose logging, and create an output file named 'test' for you to share with our support agents)
  6. Run the command and check the output (make sure to check the static source HTML for the data also)

  If this test reproduces your issue, please contact [support@brightdata.com](mailto:support@brightdata.com) and share the following within the body of the email:

  1. The `curl` request you sent to generate the result
  2. The full verbose output from running the command
  3. The response returned from running it (the 'test' file)
  4. Whether you are using a browser automation tool or not (The Web Unlocker API does not support them or any 3rd party integrations except for your code).
</Accordion>

## Get Success Rate Statistics Per Domain

The following API endpoint will provide Web Unlocker API success rate statistics from the past 7 days.

The statistics can be obtained per single domain like `example.com` or for a wildcard domain like `example.*` in order to get statistics for all top-level domains.

**Note**: calling this API endpoint requires using your [API key](/api-reference/authentication#how-do-i-authenticate-with-api-key%3F)

**How to get statistics for a single domain?**

<CodeGroup>
  ```shell Request theme={null}
      curl "https://api.brightdata.com/unblocker/success_rate/example.com" -H "Content-Type: application/json" -H "Authorization: Bearer API_KEY"
  ```

  ```shell Response theme={null}
      {"example.com":0.9835556363554884} 
  ```
</CodeGroup>

**How to get statistics for all monitored top level domains?**

<CodeGroup>
  ```shell Request theme={null}
      curl "https://api.brightdata.com/unblocker/success_rate/example.*" -H "Content-Type: application/json" -H "Authorization: Bearer API_KEY"
  ```

  ```shell Response theme={null}
      {{"example.com":0.9835548316870116,"example.fr":0.987469724604454,"example.co.uk":0.9503769840916476,"example.ca":0.9904893224078992,"example.de":0.9864620859972142,"example.es":0.9845641506811664,"example.in":0.8558596797075156,"example.it":0.9890758071645432,"example.co.jp":0.996804161764218,"example.com.mx":0.9710054259117241,"example.com.au":0.9969920926297628,"example.ae":0.617948700199661,"example.nl":0.9872124916314797,"example.pl":0.9899010819017637,"example.com.br":0.9804172881460471,"example.com.be":0.9928999059667324,"example.se":0.9888455998636585,"example.sa":0.9939472688535012,"example.com.tr":0.7967697653998838,"example.eg":0.9990248073774932}} 
  ```
</CodeGroup>


# Unlock your first website
Source: https://docs.brightdata.com/scraping-automation/web-unlocker/five-minute-how-to

Unlock your first website with the Bright Data Web Unlocker API in under 5 minutes. Validate your setup with a minimal request before moving to advanced config.

This guide helps you unlock your **first website in under 5 minutes** using the Bright Data Web Unlocker API.\
It is designed for developers who want to validate their setup quickly and see real results without diving into advanced configuration.

By the end of this guide, you will:

* Verify your Web Unlocker API setup
* Send a live unlock request
* Receive clean HTML or JSON content from a target website

## What you need before starting (1 minute)

Make sure you already have:

* A Bright Data account
* An active **Web Unlocker API zone**
* An [**API key**](https://brightdata.com/cp/setting/users)

You can find your **zone name** and **API key** in the **Overview** tab of your Web Unlocker API in the [Bright Data Control Panel](https://brightdata.com/cp/web_access).

If you haven’t created an Web Unlocker API yet, follow **Create Your First Web Unlocker API** before continuing.

## Step 1: Choose a test website (30 seconds)

Select a public URL to test your first unlock request.

Good examples:

* [https://example.com](https://example.com)
* [https://httpbin.org/html](https://httpbin.org/html)

Make sure the URL:

* Is publicly accessible
* Starts with `https://` or `http://`

## Step 2: Understand what you’re about to send (30 seconds)

The Web Unlocker API works through a **single REST endpoint**.

You will send:

* Your API key (for authentication)
* Your Web Unlocker API zone name
* The target URL you want to unlock

Bright Data will automatically:

* Select the best proxy network
* Handle anti-bot protections
* Retry failed attempts if needed

## Step 3: Send your first unlock request (2 minutes)

Replace the placeholders below with your actual values:

* YOUR\_API\_KEY
* YOUR\_ZONE\_NAME
* YOUR\_TARGET\_URL

Example request:

`POST https://api.brightdata.com/request`

**Headers:**

* Authorization: `Bearer YOUR_API_KEY`
* Content-Type: `application/json`

Body:

```json theme={null}
{
  "zone": "YOUR_ZONE_NAME",
  "url": "YOUR_TARGET_URL",
  "format": "raw"
}
```

This request asks the Web Unlocker API to fetch the target page and return the unlocked response as raw HTML.

## Step 4: Review the response (30 seconds)

If the request is successful, you will receive:

* HTTP status: 200 OK
* A response body containing unlocked content
* HTML or JSON, depending on the format you requested

If you can see the page content, your Web Unlocker API is working correctly.

## Common issues and quick fixes (30 seconds)

* **401 Unauthorized**\
  Authentication is missing or invalid\
  → Verify the Authorization header and API key

* **400 Bad Request**\
  Request payload is invalid\
  → Ensure `zone`, `url`, and `format` are present

* **Content looks incomplete**\
  → Try another public URL or review Configuration options

## What you just accomplished

In under 5 minutes, you:

* Authenticated with the Web Unlocker API
* Sent a real unlock request
* Retrieved clean, usable content from a website

This confirms your setup is correct and ready for real workloads.

## Where to go next

Once your first request works, you can:

* Enable **geolocation** for region-specific content
* Use **asynchronous requests** for large batches
* Configure **premium domains** for harder targets
* Explore **Send Your First Request** for advanced examples
* Review **Troubleshooting** if you encounter errors


# Web Unlocker API overview
Source: https://docs.brightdata.com/scraping-automation/web-unlocker/introduction

Bright Data Web Unlocker API (98% success rate) handles proxy rotation, anti-bot challenges and CAPTCHA solving in 1 call. Returns clean HTML or JSON.

The **Web Unlocker API** unlocks any public web page in a single API call with a 98% success rate and returns clean HTML or JSON. You send one request with your target URL, and Bright Data handles proxy rotation, browser fingerprints, CAPTCHA solving and retries on its side. You pay only for successful requests.

The Web Unlocker API is part of Bright Data's [Unlocker scraping suite](/scraping-automation/introduction). Instead of managing proxies, headers, fingerprints and anti-bot logic yourself, you call one endpoint and get back a response that is already unblocked and ready to parse.

```sh Direct API access theme={null}
curl -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{"zone":"YOUR_ZONE_NAME","url":"https://example.com","format":"raw"}' \
  https://api.brightdata.com/request
```

The response is the target page's raw HTML or JSON. No proxy orchestration, browser automation or custom retry logic is required. See [Send your first request](/scraping-automation/web-unlocker/send-your-first-request) for the full walkthrough with Python, Node.js and cURL examples.

## How does the Web Unlocker API work?

Every request is optimized on Bright Data's side before it reaches the target site. A single call to `https://api.brightdata.com/request`:

* Selects the most effective proxy network for the target site
* Sets request headers and fingerprints to match real-user browser traffic
* Solves CAPTCHAs and anti-bot challenges automatically
* Retries failed attempts with alternative configurations until the request succeeds
* Charges only for requests that return a successful response

Bright Data provides two access methods that return identical results: **direct API access**, a REST call to a single endpoint (recommended), and **native proxy-based access**, which routes requests through the Bright Data super proxy. See [Send your first request](/scraping-automation/web-unlocker/send-your-first-request) to set up either one.

## When should you use the Web Unlocker API?

Use the Web Unlocker API when you need reliable, large-scale access to public web data without building and maintaining proxy and anti-bot infrastructure yourself. It fits:

* Scraping any website, including sites with advanced anti-bot protection
* Emulating real-user behavior to reach protected or geo-restricted content
* Engineering teams without a scalable proxy and unblocking stack
* Production workloads that need high success rates and predictable, pay-per-success costs

<Warning>
  Social network account management is not a supported use case for the Web Unlocker API. This includes managing accounts on Facebook, TikTok, Instagram, X (Twitter), LinkedIn, YouTube, Reddit, Pinterest, Snapchat and Discord.
</Warning>

<Note>
  The Web Unlocker API is not intended for browser-based automation or third-party browser tools such as
  [Adspower](/integrations/adspower),
  [Puppeteer](/integrations/puppeteer),
  [Playwright](/integrations/playwright),
  or [Multilogin (MLA)](/integrations/multilogin).
  If your workflow requires direct interaction with a browser or scripted user actions, use the
  [Browser API](https://brightdata.com/products/scraping-browser) instead.
</Note>

## FAQ

### What format does the Web Unlocker API return?

By default the Web Unlocker API returns the target page's raw HTML. Set `"format":"raw"` for the unmodified response. The body comes back ready to parse, with no post-processing required.

### Do you pay for failed requests?

No. With both the Web Unlocker API and the [SERP API](/scraping-automation/serp-api), you are charged only for successful requests to your target domain.

### Can the Web Unlocker API control a browser?

No. The Web Unlocker API returns page content from a single request. For scripted browser actions such as clicking, scrolling or filling forms, use the [Browser API](https://brightdata.com/products/scraping-browser).

### Does the Web Unlocker API work on search engines?

For Google, Bing and other search engines, use the [SERP API](/scraping-automation/serp-api). It is purpose-built for search result pages and returns parsed results.

## Related

<CardGroup>
  <Card title="Send your first request" icon="paper-plane" href="/scraping-automation/web-unlocker/send-your-first-request">
    Make your first Web Unlocker API call in Python, Node.js or cURL.
  </Card>

  <Card title="Quickstart" icon="rocket" href="/scraping-automation/web-unlocker/quickstart">
    Create a Web Unlocker API zone and get your API key.
  </Card>

  <Card title="Configuration" icon="sliders" href="/scraping-automation/web-unlocker/configuration">
    Tune country targeting, response format and request options.
  </Card>

  <Card title="Best practices" icon="list-check" href="/scraping-automation/web-unlocker/bestpractices">
    Get the highest success rates and lowest cost per request.
  </Card>
</CardGroup>


# Create your first Web Unlocker API
Source: https://docs.brightdata.com/scraping-automation/web-unlocker/quickstart

Set up your first Bright Data Web Unlocker API (98% success rate): create the API in the Control Panel, configure credentials and send your first request.

<Callout icon="badge-dollar">
  **Start free, no credit card required**

  Your free tier includes **5,000 credits every month** for the Web Unlocker API. Create your Web Unlocker API and start sending requests immediately, no payment method needed. [Learn more about the free tier](/general/account/billing-and-pricing/free-tier).
</Callout>

This quick start walks you through creating your first **Web Unlocker API zone** in the Bright Data Control Panel.\
Once completed, your API will be ready to send unlock requests and return clean HTML or JSON responses.

## How to set up step by step

<Steps>
  <Step title={<a href="https://brightdata.com/cp/start">Sign in to Bright Data</a>}>
    Log in to your Bright Data account using your credentials. If you don’t have an account yet, you’ll be prompted to create one before proceeding.
  </Step>

  <Step title={<>Navigate to the <a href="https://brightdata.com/cp/web_access/new">Create an API</a> page</>}>
    From the Bright Data Control Panel:

    **1.** Open the left-hand navigation menu from the dashboard.\
    **2.** Select **Web Access APIs** from the menu.\
    **3.** Click **Create API** to start creating a new API.

    <Frame>
      <img alt="Create an API" />
    </Frame>
  </Step>

  <Step title="Choose Web Unlocker API">
    In the API selection screen, choose **Web Unlocker API**. This enables automatic proxy management and unblocking logic for your requests.

    Click **Continue** to proceed.

    <Frame>
      <img alt="Web Unlocker API" />
    </Frame>
  </Step>

  <Step title="Assign a name to your Web Unlocker API">
    Enter a **clear and descriptive name** for your Web Unlocker API. This helps you identify the API later, especially if you manage multiple zones.

    You may also add an optional description for internal reference.

    <Warning>
      **The Web Unlocker API name cannot be changed once created.**
      You can modify all other settings later, including domains, headers, and throttling options. For details, see [Configure your API](/scraping-automation/web-unlocker/configuration).
    </Warning>

    <Frame>
      <img alt="API Name" />
    </Frame>
  </Step>

  <Step title="Add payment method (free trial users only)">
    If you signed up with a personal email (e.g., Gmail, GitHub) and have not yet added a payment method, the primary button will read **Add payment method** instead of **Add API**.

    Click the button to open the payment verification form and complete the process. You will **not** be charged, this is for identity verification only.

    <Info>
      Already have a payment method on file? This step is skipped automatically. For full details, see [Payment Verification](/general/account/billing-and-pricing/payment-verification).
    </Info>
  </Step>

  <Step title="Finalize API creation">
    Review your configuration and click **Add API**. If you were redirected to add a payment method, your zone is created automatically once verification completes. Your Web Unlocker API zone is now created and immediately available for use.

    <Frame>
      <img alt="Save API" />
    </Frame>
  </Step>
</Steps>


# Send your first Web Unlocker API request
Source: https://docs.brightdata.com/scraping-automation/web-unlocker/send-your-first-request

Send your first request using Bright Data Web Unlocker API (98% success rate) with step-by-step guidance, request breakdowns and real-world code examples.

## Make your first request in minutes

Once your Web Unlocker API is created, you can begin unlocking websites immediately. This guide walks you through sending your **first successful request**, explains the available access methods, and provides ready-to-use examples.

<CardGroup>
  <Card title="Postman Example" icon="user-astronaut" href="https://www.postman.com/bright-data-api/bright-data-api/request/f0g939o/unlock-website" />

  <Card title="Node.js Example" icon="code" href="https://github.com/luminati-io/bright-data-web-unlocker-nodejs-project" />

  <Card title="Python Example" icon="code" href="https://github.com/luminati-io/bright-data-web-unlocker-python-project" />
</CardGroup>

## Choose an access method

Bright Data provides **two ways** to access the Web Unlocker API. Both methods return **identical results**, but are optimized for different workflows.

<CardGroup>
  <Card title="Direct API access (recommended)" href="/scraping-automation/web-unlocker/send-your-first-request#direct-api-access-recommended">
    A pure REST API method for easy access and straightforward integration.
  </Card>

  <Card title="Native proxy-based access" href="/scraping-automation/web-unlocker/send-your-first-request#native-proxy-based-access">
    For workflows that rely on proxy-based routing.
  </Card>
</CardGroup>

## Direct API access (recommended)

A simple and RESTful way to interact with Bright Data’s Web Unlocker API. Direct API access abstracts proxy management and allows you to send requests via a central endpoint, ensuring ease of use and straightforward REST API integration.

### When to use direct API access

* **Centralized endpoint:** Access Web Unlocker API via a single, RESTful endpoint.
* **Streamlined direct integration:** Eliminating the complexity of managing proxies or routing.
* **Single API key authentication:** Secure and easy to use, replacing the need for username-password management.

### Sending your first request

After [setting up](/scraping-automation/web-unlocker/quickstart) your Web Unlocker API zone, you can find:

* Your **API key**
* A ready-to-use request example
* Your **zone name**

in the **Overview** tab of your Web Unlocker API zone.

<Frame>
  <img alt="Web Unlocker API Overview tab" />
</Frame>

The following is an example of a simple Web Unlocker API cURL request:

```sh Direct API access - cURL theme={null}
curl -H "Content-Type: application/json" -H "Authorization: Bearer [INSERT_YOUR_API_KEY]" -d "{\"zone\": \"[INSERT_YOUR_WEB_UNLOCKER_ZONE_NAME]\", \"url\": \"[INSERT_YOUR_TARGET_URL]\", \"format\": \"raw\", \"body\": \"{\\\"key\\\":\\\"value\\\"}\"}" https://api.brightdata.com/request
```

### Request breakdown

1. API Endpoint: [`https://api.brightdata.com/request`](https://api.brightdata.com/request)
2. Authorization Header: `Authorization: Bearer [INSERT YOUR API key]`
   * Your API key is found within your Web Unlocker API zone.
3. Payload:
   * `zone`: Your specific Web Unlocker API **zone name**.
   * `url`: The target URL you wish to access via Web Unlocker API.
   * `format`: Defines the response format. Use `raw` to receive the raw response from the target site.
   * \[Optional] `body`: Specifies the raw POST payload sent to the target URL. e.g. `"body": "{\"key\":\"value\"}"`

### Generating your Bright Data API key

A Bright Data API key is your secure authentication token for accessing Web Unlocker API via Direct API access. When adding a new Web Unlocker API zone in the [control panel](https://brightdata.com/cp/zones), an API key will be generated automatically and can be found within the **Overview** tab of your zone.

<Frame>
  <img alt="Web Unlocker API key" />
</Frame>

**To generate a new API key:**

* Navigate to [Account settings](https://brightdata.com/cp/setting/users).
* Scroll down and click the Add API key button.
* Follow the on-screen instructions to complete the process.

<Tip>
  We strongly recommend having an expiration date set on your API key for increased security.
</Tip>

<Warning>
  The API key will be shown to you on the screen **only** so make sure you copy and store it in a safe location per your organization's policies
</Warning>

## Native proxy-based access

Proxy-based access is designed for workflows that already use proxy routing. Instead of a REST endpoint, requests are sent through Bright Data’s super proxy.

### Which credentials are required

In order to access Web Unlocker, you will need to provide credentials which are comprised of:

1. **Your customer ID**
2. **Your Web Unlocker API zone name**
3. **Your Web Unlocker API password**
4. **Bright Data SSL certificate**

### Where to find your customer ID

Customer ID can be found in the welcome email you received, or by clicking your account initial letter on the top right screen of your control panel, or by clicking here: [Account settings](https://brightdata.com/cp/setting/customer_details) .

### Zone name and password

Your zone name and password can be found in the overview tab of your unlocker zone in the control panel.

### Bright Data SSL Certificate

<Warning>
  Prevent SSL errors by setting up Bright Data SSL certificate
</Warning>

SSL Certificate can be found by clicking "SSL certificate" wizard on your zone's overview top menu. See further instructions here:  [SSL certificate](/general/account/ssl-certificate#download-the-ssl-certificate).

Alternatively, you can  [ignore SSL errors](/general/account/ssl-certificate#how-to-ignore-ssl-errors%3F).

### Web Unlocker API: HTTPS Proxy code examples

Once you have your credentials, use the following code to send your first request:

<Accordion title="Expand for code examples">
  <CodeGroup>
    ```sh cURL theme={null}
    curl "http://brdtest.com/myip.json" --proxy brd.superproxy.io:44445 --proxy-user brd-customer-<customer_id>-zone-<zone_name>:<zone_password>
    ```

    ```javascript Node.js theme={null}
    #!/usr/bin/env node

    const { ProxyAgent, setGlobalDispatcher } = require('undici');

    setGlobalDispatcher(new ProxyAgent('http://brd-customer-<customer_id>-zone-<zone_name>:<zone_password>@brd.superproxy.io:44445'));

    (async () => {
      const response = await fetch('http://brdtest.com/myip.json');
      console.log(await response.text());
    })();
    ```

    ```python Python theme={null}
    import pprint
    import requests

    host = 'brd.superproxy.io'  
    port = 44445
    username = 'brd-customer-<customer_id>-zone-<zone_name>'
    password = '<zone_password>'
    proxy_url = f'http://{username}:{password}@{host}:{port}'
    proxies = {
      'http': proxy_url,
      'https': proxy_url
    }

    url = "http://brdtest.com/myip.json"

    response = requests.get(url, proxies=proxies)
    pprint.pprint(response.json())
    ```

    ```php php theme={null}
    <?php

    echo 'To enable your free eval account and get CUSTOMER, YOURZONE and YOURPASS, please contact sales@brightdata.com';

    $curl = curl_init('http://brdtest.com/myip.json');
    curl_setopt($curl, CURLOPT_PROXY, 'http://brd.superproxy.io:44445');
    curl_setopt($curl, CURLOPT_PROXYUSERPWD, 'brd-customer-<customer_id>-zone-<zone_name>:<zone_password>');
    curl_exec($curl);
    ?> 
    ```

    ```ruby Ruby theme={null}
    #!/usr/bin/ruby

    require 'uri'
    require 'net/http'
    require 'net/https'

    puts 'To enable your free eval account and get CUSTOMER, YOURZONE and YOURPASS, please contact sales@brightdata.com'

    uri = URI.parse('http://brdtest.com/myip.json')
    proxy = Net::HTTP::Proxy('brd.superproxy.io', 44445, 'brd-customer-<customer_id>-zone-<zone_name>', '<zone_password>')
    req = Net::HTTP::Get.new(uri)
    result = proxy.start(uri.host,uri.port, :use_ssl  => uri.scheme == 'https') do |http|

    http.request(req)

    end

    puts result.body
    ```

    ```cs C# theme={null}
    using System;
    using System.Net;
    class Example {
      static void Main() {
        var client = new WebClient();
        client.Proxy = new WebProxy("brd.superproxy.io:44445");
        client.Proxy.Credentials = new NetworkCredential(
          "brd-customer-<customer_id>-zone-<zone_name>",
          "<zone_password>"
        );

        Console.WriteLine(client.DownloadString("http://brdtest.com/myip.json"));
      }
    }
    ```

    ```java Java theme={null}

    package example;
    import org.apache.http.HttpHost;
    import org.apache.http.client.fluent.*;

    public  class Example {
      public  static  void main(String[] args) throws Exception {
        System.out.println(
          "To enable your free eval account and get "
          +"CUSTOMER, YOURZONE and YOURPASS, please contact "
          +"sales@brightdata.com"
        );

        HttpHost proxy = new HttpHost("brd.superproxy.io", 44445);

        String res = Executor.newInstance()
          .auth(proxy, "brd-customer-<customer_id>-zone-<zone_name>", "<zone_password>")
          .execute(Request.Get("http://brdtest.com/myip.json").viaProxy(proxy))
          .returnContent().asString();

        System.out.println(res);
      }
    }
    ```

    ```perl Perl theme={null}

    #!/usr/bin/perl
    print 'To enable your free eval account and get CUSTOMER, YOURZONE and '
    .'YOURPASS, please contact sales@brightdata.com';

    use LWP::UserAgent;
    my  $agent = LWP::UserAgent->new();

    $agent->proxy(['http', 'https'], "http://brd-customer-<customer_id>-zone-<zone_name>:<zone_password>\@brd.superproxy.io:44445");
    print  $agent->get('http://brdtest.com/myip.json')->content();

    ```

    ```vb VBA theme={null}
    Imports System.Net
    Module Module1

    Sub Main()

    Console.WriteLine("To enable your free eval account and get " &
    "CUSTOMER, YOURZONE and YOURPASS, please contact " &
    "sales@brightdata.com")

    Dim Client As  New WebClient
    Client.Proxy = New WebProxy("http://brd.superproxy.io:44445")
    Client.Proxy.Credentials = New NetworkCredential("brd-customer-<customer_id>-zone-<zone_name>", "<zone_password>")
    Console.WriteLine(Client.DownloadString("http://brdtest.com/myip.json"))
    End Sub
    End Module
    ```
  </CodeGroup>

  The code above uses the residential proxy to send a request to [http://brdtest.com/myip.json](http://brdtest.com/myip.json). It returns your IP information in a JSON format:

  ```json Output theme={null}
  {
    "ip": "ALLOCATED_IP",
    "country": "PK",
    "asn": {
      "asnum": 203020,
      "org_name": "HostRoyale Technologies Pvt Ltd"
    },
    "geo": {
      "city": "Islamabad",
      "region": "IS",
      "region_name": "Islamabad",
      "postal_code": "44040",
      "latitude": 33.7233,
      "longitude": 73.0435,
      "tz": "Asia/Karachi",
      "lum_city": "islamabad",
      "lum_region": "is"
    }
  }
  ```

  Now, replace “[https://brdtest.com/myip.json”](https://brdtest.com/myip.json”) with the website of your choice.
</Accordion>


# Set up webhooks for Web Unlocker API
Source: https://docs.brightdata.com/scraping-automation/web-unlocker/setup-webhooks

Configure webhooks for the Bright Data Web Unlocker API (98% success rate) to receive HTTP callbacks when async jobs complete, instead of polling for results.

<AccordionGroup>
  <Accordion title="Understand how webhooks work" icon="lightbulb">
    When using [asynchronous requests](/api-reference/rest-api/unlocker/request), the Web Unlocker API processes jobs in the background.

    Instead of polling for results, you can configure a webhook. A webhook is an HTTP endpoint that Bright Data calls when your job is completed.

    The flow looks like this:

    1. Send async request
    2. Receive `response_id`
    3. Bright Data processes the request
    4. Bright Data sends a notification to your `webhook_url`
    5. Use the `response_id` to retrieve the result

    <Tip>
      Webhooks notify you when a job is ready, they do not include the full response body.
    </Tip>
  </Accordion>

  <Accordion title="Prerequisites" icon="list-check">
    The following are required:

    * [A Bright Data account](https://brightdata.com/?hs_signup=1\&utm_source=docs)
    * [A Bright Data API key](/api-reference/authentication#how-do-i-generate-a-new-api-key)
    * [An active Web Unlocker API zone](https://brightdata.com/cp/zones)
    * [Basic knowledge of cURL](https://curl.se/)
    * [A working asynchronous request setup using the Web Unlocker API](/scraping-automation/web-unlocker/your-first-async-request)
  </Accordion>
</AccordionGroup>

<Steps>
  <Step title="Create a webhook endpoint">
    You need a publicly accessible URL to receive webhook notifications.

    <Tip>
      For demonstration purposes, we'll use [webhook.site](https://webhook.site).

      It instantly generates a temporary webhook URL and lets you inspect incoming requests in real time, including headers, query parameters, and payloads.
    </Tip>
  </Step>

  <Step title="Send an async request with webhook">
    Add the `webhook_url` parameter to your request:

    <CodeGroup>
      ```bash cURL theme={null}
      curl --request POST \
        --url 'https://api.brightdata.com/unblocker/req?zone=<unlocker-zone-name>' \
        --header 'Authorization: Bearer <API_KEY>' \
        --header 'Content-Type: application/json' \
        --data '{
          "url": "https://geo.brdtest.com/welcome.txt",
          "webhook_url": "https://webhook.site/<webhook-url-id>"
        }'
      ```

      ```python Python theme={null}
        import requests

        url = "https://api.brightdata.com/unblocker/req?zone=<unlocker-zone-name>"

        payload = {
            "url": "https://geo.brdtest.com/welcome.txt",
            "webhook_url": "https://webhook.site/<webhook-url-id>",
        }
        headers = {
            "Authorization": "Bearer <API_KEY>",
            "Content-Type": "application/json"
        }

        response = requests.post(url, json=payload, headers=headers)

        print(response.text)
      ```

      ```js Node.js theme={null}
      const options = {
        method: 'POST',
        headers: {Authorization: 'Bearer <API_KEY>', 'Content-Type': 'application/json'},
        body: JSON.stringify({
          url: 'https://geo.brdtest.com/welcome.txt',
          webhook_url: 'https://webhook.site/<webhook-url-id>',
        })
      };

      fetch('https://api.brightdata.com/unblocker/req?zone=<unlocker-zone-name>', options)
        .then(res => res.json())
        .then(res => console.log(res))
        .catch(err => console.error(err));
      ```
    </CodeGroup>

    <Callout icon="key">
      Replace `<API_KEY>`, `<unlocker-zone-name>`, `<webhook-url-id>` with your actual values.
    </Callout>
  </Step>

  <Step title="Receive webhook notification">
    Once the request is processed, Bright Data sends a POST request to your `webhook_url`.

    ```json theme={null}
    // A typical webhook request includes:
    {
      "status": 200,
      "response_id": "<RESPONSE_ID>",
      "request_url": "https://geo.brdtest.com/welcome.txt"
    }
    ```

    If you're using webhook.site, you can inspect the incoming request, including payload fields and headers (e.g., `user-agent`).

    <Tip>
      This webhook notifies you that the request has completed.
    </Tip>
  </Step>

  <Step title={<>Retrieve the result using <code>response_id</code></>}>
    Use the `response_id` from the webhook to fetch the actual result:

    ```sh wrap theme={null}
    curl --silent --compressed \
      "https://api.brightdata.com/unblocker/get_result?response_id=<RESPONSE_ID>" \
      -H "Authorization: Bearer <API_KEY>" \
      -o results.json
    ```

    Then inspect the output:

    ```sh theme={null}
    cat results.json
    ```

    The file will contain the full response, including headers and body.
  </Step>

  <Step title={<><Badge>Optional</Badge> Attach custom data to webhook</>}>
    You can include custom metadata using `webhook_data`. When using `webhook_method` as `POST`, this data will be sent in the request body of the webhook notification.

    ```bash wrap theme={null}
    curl --request POST \
      --url 'https://api.brightdata.com/unblocker/req?zone=web_unlocker3' \
      --header 'Authorization: Bearer <API_KEY>' \
      --header 'Content-Type: application/json' \
      --data '{
        "url": "https://geo.brdtest.com/welcome.txt",
        "webhook_url": "https://webhook.site/a14a55b3-c3cc-4890-84f2-eeebe4b264a4",
        "webhook_method": "POST",
        "webhook_data": "{\"job_id\": \"my_job_123\", \"source\": \"test_script\"}"
      }'
    ```

    The `webhook_data` field is returned unchanged in the webhook notification. This allows you to attach identifiers such as job IDs or metadata, making it easier to map responses to your internal workflows.
  </Step>

  <Step title="Congratulations" icon="party-horn">
    You’ve successfully set up webhooks with the Web Unlocker API. You can now receive real-time notifications for completed jobs and build more efficient, event-driven scraping workflows.
  </Step>
</Steps>


# Your first async Web Unlocker API request
Source: https://docs.brightdata.com/scraping-automation/web-unlocker/your-first-async-request

Send asynchronous requests to the Bright Data Web Unlocker API (98% success rate) and retrieve results using a snapshot ID and webhook delivery method.

<Accordion title="Prerequisites" icon="list-check">
  The following are required:

  * [A Bright Data account](https://brightdata.com/?hs_signup=1\&utm_source=docs)
  * [A Bright Data API key](/api-reference/authentication#how-do-i-generate-a-new-api-key)
  * [An active Web Unlocker API zone](https://brightdata.com/cp/zones)
  * [Basic knowledge of cURL](https://curl.se/)
</Accordion>

<Steps>
  <Step title="Enable &#x22;Asynchronous requests&#x22;">
    In the Web Unlocker API [zone](https://brightdata.com/cp/zones), under "Advanced settings", enable the "Asynchronous requests" toggle.

    <Frame>
      <img alt="Enable async requests" />
    </Frame>
  </Step>

  <Step title="Send your first async request">
    The following request submits an [asynchronous Web Unlocker API](/api-reference/rest-api/unlocker/request) job:

    <CodeGroup>
      ```bash cURL icon=rectangle-terminal theme={null}
      curl --request POST \
        --url 'https://api.brightdata.com/unblocker/req?zone=web_unlocker1' \
        --header 'Authorization: Bearer <API_KEY>' \
        --header 'Content-Type: application/json' \
        --data '{
            "url": "https://geo.brdtest.com/welcome.txt",
          }'
      ```

      ```python Python theme={null}
        import requests

        url = "https://api.brightdata.com/unblocker/req?zone=web_unlocker1"

        payload = {
            "url": "https://geo.brdtest.com/welcome.txt",
        }
        headers = {
            "Authorization": "Bearer <API_KEY>",
            "Content-Type": "application/json"
        }

        response = requests.post(url, json=payload, headers=headers)

        print(response.text)
      ```

      ```js Node.js theme={null}
      const options = {
        method: 'POST',
        headers: {Authorization: 'Bearer ', 'Content-Type': 'application/json'},
        body: JSON.stringify({
          url: 'https://geo.brdtest.com/welcome.txt',
        })
      };

      fetch('https://api.brightdata.com/unblocker/req?zone=web_unlocker1', options)
        .then(res => res.json())
        .then(res => console.log(res))
        .catch(err => console.error(err));
      ```
    </CodeGroup>

    <Callout icon="key">
      Replace `<API_KEY>` and `<unlocker-zone-name>` with valid values.
    </Callout>
  </Step>

  <Step title="Send your first async request">
    The following request submits an [asynchronous Web Unlocker API](/api-reference/rest-api/unlocker/request) job:

    <CodeGroup>
      ```bash cURL icon=rectangle-terminal theme={null}
      curl --request POST \
        --url 'https://api.brightdata.com/unblocker/req?zone=web_unlocker1' \
        --header 'Authorization: Bearer <API_KEY>' \
        --header 'Content-Type: application/json' \
        --data '{
            "url": "https://geo.brdtest.com/welcome.txt"
          }'
      ```

      ```python Python theme={null}
        import requests

        url = "https://api.brightdata.com/unblocker/req?zone=web_unlocker1"

        payload = {
            "url": "https://geo.brdtest.com/welcome.txt",
        }
        headers = {
            "Authorization": "Bearer <API_KEY>",
            "Content-Type": "application/json"
        }

        response = requests.post(url, json=payload, headers=headers)

        print(response.text)
      ```

      ```js Node.js theme={null}
      const options = {
        method: 'POST',
        headers: {Authorization: 'Bearer <API_KEY>', 'Content-Type': 'application/json'},
        body: JSON.stringify({
          url: 'https://geo.brdtest.com/welcome.txt',
        })
      };

      fetch('https://api.brightdata.com/unblocker/req?zone=web_unlocker1', options)
        .then(res => res.json())
        .then(res => console.log(res))
        .catch(err => console.error(err));
      ```
    </CodeGroup>

    <Callout icon="key">
      Replace `<API_KEY>` and `<unlocker-zone-name>` with valid values.
    </Callout>
  </Step>

  <Step title="Wait and check status">
    We recommend to wait 20 seconds prior to the first polling request to get the response, 10 seconds for the second poll and 5 for the rest.

    Bright Data may apply rate limit for excessive poling requests without response.

    The request returns a `response_id` used to retrieve results after processing completes.

    ```json theme={null}
    {
      "response_id": "s4t7w3619285042ra9dke1m8qx"
    }
    ```

    If the request is still processing, the API returns HTTP `202`:

    ```json HTTP/202 theme={null}
    "Request is pending"
    ```

    <Callout icon="hourglass">
      Processing time is typically up to 5 minutes and may extend to 8 hours during peak periods.

      Responses are retained for up to 48 hours from submission time.
    </Callout>
  </Step>

  <Step title="Retrieve your results">
    The following [request retrieves](/api-reference/rest-api/unlocker/get-results) the completed result:

    ```sh theme={null}
    curl --silent --compressed \
      "https://api.brightdata.com/unblocker/get_result?&response_id=${RESPONSE_ID}" \
      -H "Authorization: Bearer [API_KEY]" \
      -o results.json
    ```

    <Callout icon="file-arrow-down">
      The response body is written to `results.json`.
    </Callout>
  </Step>

  <Step title="Verify the output">
    Display the saved file:

    ```sh theme={null}
      cat results.json
    ```

    The file contains structured JSON results from the Web Unlocker API. For example:

    ```json Sample Response expandable theme={null}
      {
          "status_code": 200,
          "headers": {
              "access-control-allow-origin": "*",
              "cache-control": "no-store",
              "content-type": "text/plain; charset=utf-8",
              "date": "Sun, 18 May 2025 20:01:18 GMT",
              "server": "nginx",
              "connection": "close",
              "transfer-encoding": "chunked"
          },
          "body": "\nWelcome to Bright Data! Here are your proxy details\nCountry: US\nLatitude: 37.751\nLongitude: -97.822\nTimezone: America/Chicago\nASN number: 20473\nASN Organization name: AS-VULTR\nIP version: IPv4\n\nCommon usage examples:\n\n[USERNAME]-country-us:[PASSWORD]  // US based Proxy\n[USERNAME]-country-us-state-ny:[PASSWORD]  // US proxy from NY\n[USERNAME]-asn-56386:[PASSWORD]  // proxy from ASN 56386\n[USERNAME]-ip-1.1.1.1.1:[PASSWORD]  // proxy from dedicated pool\n\nTo get a simple JSON response, use https://geo.brdtest.com/mygeo.json .\n\nMore examples on https://docs.brightdata.com/api-reference/introduction\n\n"
      }
    ```

    <Callout icon="party-horn">
      **Congratulations!** If the file contains valid JSON search results, you're done!
    </Callout>
  </Step>
</Steps>

## Can Bright Data send the response to a target which I specify?

No. Our Async mechanism requires you to poll with the request ID and pull your request on demand.

Our scrapers do support relaying a payload to a target you provide: if this is a crucial part of your flow, use our google scrapers instead.


# JavaScript SDK quickstart
Source: https://docs.brightdata.com/sdk-js-quickstart





# Python SDK quickstart
Source: https://docs.brightdata.com/sdk-quickstart





# Search API
Source: https://docs.brightdata.com/search-api-quickstart





# Web Unlocker API quickstart
Source: https://docs.brightdata.com/unlocker-api-quickstart





# Data feeds
Source: https://docs.brightdata.com/datasets/introduction

Collect and process web data without managing scraping infrastructure. Use 1000+ pre-built scrapers, deploy custom scrapers, or buy ready-made datasets.

<Card>
  <CardGroup>
    <Card title="Datasets marketplace" icon="store" href="/datasets/marketplace">
      Search, customize, and export high-quality, ethically sourced datasets from 250+ domains, ready for instant use.
    </Card>

    <Card title="Scrapers" icon="spider" href="/datasets/scrapers">
      Access 1000+ ready-to-use scrapers, select a scraper from our library or request a custom scraper, and get real-time data delivered directly to your storage.
    </Card>

    <Card title="Archive" icon="box-archive" href="/datasets/archive">
      The most cost-effective way to collect data. Access and retrieve data snapshots using Bright Data cached data collections.
    </Card>

    <Card title="Scraper Studio" icon="code" href="/datasets/scraper-studio/introduction">
      Build and run scrapers at scale using our IDE or AI-powered tools, fully hosted to speed up development and reduce unblocking maintenance.
    </Card>
  </CardGroup>
</Card>

<Note>
  [<u>Start now</u>](https://brightdata.com/?hs_signup=1\&utm_source=docs) with **5,000 free credits per month**, no credit card required. We’ll match your first account deposit up to \$500. See the [free tier](/general/account/billing-and-pricing/free-tier).
</Note>

<Info>
  For billing, settings and user access, visit the [account management](/api-reference/authentication#how-do-i-generate-a-new-api-key%3F) section.
</Info>

<Card title="Network status" icon="badge-check" href="https://brightdata.com/network-status">
  View real-time network status for all products
</Card>


# Async Amazon data collection
Source: https://docs.brightdata.com/datasets/scrapers/amazon/async-requests

Trigger large-scale Amazon scraping jobs, monitor progress and retrieve results with the Bright Data async /trigger endpoint. Batches up to 1 GB input.

This guide shows you how to scrape Amazon data at scale using the asynchronous `/trigger` endpoint. Use this when you have more than 20 URLs, need discovery, or want delivery to a webhook or S3.

<Tip>
  Not sure whether to use sync or async? Read [Understanding sync vs. async requests](/datasets/scrapers/concepts/sync-vs-async).
</Tip>

## Prerequisites

* A [Bright Data account](https://brightdata.com/cp/start) with an active API key
* Familiarity with the [synchronous request flow](/datasets/scrapers/amazon/send-first-request)

## Step 1: Trigger the collection

Send a `POST` request to the `/trigger` endpoint with your input URLs:

<CodeGroup>
  ```bash cURL theme={null}
  curl -X POST \
    "https://api.brightdata.com/datasets/v3/trigger?dataset_id=gd_l7q7dkf244hwjntr0&format=json" \
    -H "Authorization: Bearer YOUR_API_KEY" \
    -H "Content-Type: application/json" \
    -d '[
      {"url": "https://www.amazon.com/dp/B0CHHSFMRL"},
      {"url": "https://www.amazon.com/dp/B09V3KXJPB"},
      {"url": "https://www.amazon.com/dp/B0BDJ279KF"},
      {"url": "https://www.amazon.com/dp/B0BSHF7WHW"},
      {"url": "https://www.amazon.com/dp/B0D1XD1ZV3"}
    ]'
  ```

  ```python Python theme={null}
  import requests

  response = requests.post(
      "https://api.brightdata.com/datasets/v3/trigger",
      params={
          "dataset_id": "gd_l7q7dkf244hwjntr0",
          "format": "json",
      },
      headers={
          "Authorization": "Bearer YOUR_API_KEY",
          "Content-Type": "application/json",
      },
      json=[
          {"url": "https://www.amazon.com/dp/B0CHHSFMRL"},
          {"url": "https://www.amazon.com/dp/B09V3KXJPB"},
          {"url": "https://www.amazon.com/dp/B0BDJ279KF"},
          {"url": "https://www.amazon.com/dp/B0BSHF7WHW"},
          {"url": "https://www.amazon.com/dp/B0D1XD1ZV3"},
      ],
  )

  snapshot = response.json()
  print("Snapshot ID:", snapshot["snapshot_id"])
  ```

  ```javascript Node.js theme={null}
  const response = await fetch(
    "https://api.brightdata.com/datasets/v3/trigger?dataset_id=gd_l7q7dkf244hwjntr0&format=json",
    {
      method: "POST",
      headers: {
        "Authorization": "Bearer YOUR_API_KEY",
        "Content-Type": "application/json",
      },
      body: JSON.stringify([
        { url: "https://www.amazon.com/dp/B0CHHSFMRL" },
        { url: "https://www.amazon.com/dp/B09V3KXJPB" },
        { url: "https://www.amazon.com/dp/B0BDJ279KF" },
        { url: "https://www.amazon.com/dp/B0BSHF7WHW" },
        { url: "https://www.amazon.com/dp/B0D1XD1ZV3" },
      ]),
    }
  );

  const snapshot = await response.json();
  console.log("Snapshot ID:", snapshot.snapshot_id);
  ```
</CodeGroup>

You should see a `200` response with a `snapshot_id`:

```json theme={null}
{
  "snapshot_id": "s_m1a2b3c4d5e6f7g8h"
}
```

Save this ID. You need it to check progress and download results.

## Step 2: Monitor progress

Poll the snapshot status until it shows `ready`. This takes 30 seconds to several minutes depending on the number of URLs.

<CodeGroup>
  ```bash cURL theme={null}
  curl "https://api.brightdata.com/datasets/v3/progress/s_m1a2b3c4d5e6f7g8h" \
    -H "Authorization: Bearer YOUR_API_KEY"
  ```

  ```python Python theme={null}
  import time

  snapshot_id = "s_m1a2b3c4d5e6f7g8h"

  while True:
      status_response = requests.get(
          f"https://api.brightdata.com/datasets/v3/progress/{snapshot_id}",
          headers={"Authorization": "Bearer YOUR_API_KEY"},
      )
      status = status_response.json().get("status")
      print(f"Status: {status}")

      if status == "ready":
          break
      time.sleep(10)
  ```

  ```javascript Node.js theme={null}
  const snapshotId = "s_m1a2b3c4d5e6f7g8h";

  let status = "collecting";
  while (status !== "ready") {
    const statusResponse = await fetch(
      `https://api.brightdata.com/datasets/v3/progress/${snapshotId}`,
      { headers: { "Authorization": "Bearer YOUR_API_KEY" } }
    );
    const statusData = await statusResponse.json();
    status = statusData.status;
    console.log("Status:", status);

    if (status !== "ready") {
      await new Promise((r) => setTimeout(r, 10000));
    }
  }
  ```
</CodeGroup>

Status values:

| Status       | Meaning                             |
| :----------- | :---------------------------------- |
| `collecting` | Scraping is in progress             |
| `digesting`  | Data is being processed             |
| `ready`      | Results are available for download  |
| `failed`     | The collection encountered an error |

## Step 3: Download results

Once the status is `ready`, download the scraped data:

<CodeGroup>
  ```bash cURL theme={null}
  curl "https://api.brightdata.com/datasets/v3/snapshot/s_m1a2b3c4d5e6f7g8h?format=json" \
    -H "Authorization: Bearer YOUR_API_KEY" \
    -o results.json
  ```

  ```python Python theme={null}
  results_response = requests.get(
      f"https://api.brightdata.com/datasets/v3/snapshot/{snapshot_id}",
      params={"format": "json"},
      headers={"Authorization": "Bearer YOUR_API_KEY"},
  )

  results = results_response.json()
  print(f"Collected {len(results)} products")
  ```

  ```javascript Node.js theme={null}
  const resultsResponse = await fetch(
    `https://api.brightdata.com/datasets/v3/snapshot/${snapshotId}?format=json`,
    { headers: { "Authorization": "Bearer YOUR_API_KEY" } }
  );

  const results = await resultsResponse.json();
  console.log(`Collected ${results.length} products`);
  ```
</CodeGroup>

You've successfully triggered, monitored, and downloaded a batch Amazon scraping job.

## Skip polling with webhooks

If you don't want to poll for status, add an `endpoint` parameter to receive results automatically:

```bash theme={null}
curl -X POST \
  "https://api.brightdata.com/datasets/v3/trigger?dataset_id=gd_l7q7dkf244hwjntr0&format=json&endpoint=https://your-server.com/webhook" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '[{"url": "https://www.amazon.com/dp/B0CHHSFMRL"}]'
```

See [How to receive Amazon data via webhooks](/datasets/scrapers/amazon/data-delivery/webhooks) for the full setup.

## Limits and constraints

| Constraint                           | Value      |
| :----------------------------------- | :--------- |
| Max input file size                  | 1 GB       |
| Max concurrent batch requests        | 100        |
| Max concurrent single-input requests | 1,500      |
| Webhook delivery size                | Up to 1 GB |
| API download size                    | Up to 5 GB |

## Troubleshooting

<Accordion title="Getting a 429 Too Many Requests error?">
  You've exceeded the concurrent request limit. Reduce the number of parallel requests or combine inputs into fewer, larger batches. Each batch can include up to 1 GB of input data.
</Accordion>

<Accordion title="Snapshot status shows 'failed'?">
  Check that all input URLs are valid Amazon URLs. Review the error details in the snapshot response or in the [Logs tab](https://brightdata.com/cp/scrapers) of your Bright Data dashboard.
</Accordion>

<Accordion title="Results are incomplete or missing some URLs?">
  Some URLs may fail individually while the overall job succeeds. Check the snapshot response for any `errors` field. Retry failed URLs in a separate request.
</Accordion>

## Next steps

<CardGroup>
  <Card title="Set up webhooks" icon="webhook" href="/datasets/scrapers/amazon/data-delivery/webhooks">
    Receive results without polling.
  </Card>

  <Card title="Deliver to S3" icon="bucket" href="/datasets/scrapers/amazon/data-delivery/amazon-s3">
    Send results directly to your S3 bucket.
  </Card>
</CardGroup>


# Amazon data delivery to Amazon S3
Source: https://docs.brightdata.com/datasets/scrapers/amazon/data-delivery/amazon-s3

Configure the Bright Data Amazon Scraper API to deliver scraped product, review and seller data directly to your Amazon S3 bucket when each job completes.

This guide shows you how to configure the Bright Data Amazon Scraper API to deliver scraped data directly to your Amazon S3 bucket when a collection job completes.

## Prerequisites

* A [Bright Data account](https://brightdata.com/cp/start) with an active API key
* An AWS account with an S3 bucket
* IAM credentials with write access to the bucket
* Familiarity with the [async request workflow](/datasets/scrapers/amazon/async-requests)

## Step 1: Create an S3 bucket

If you already have a bucket, skip to Step 2.

In the [AWS S3 Console](https://s3.console.aws.amazon.com/s3/buckets):

1. Click **Create bucket**
2. Enter a bucket name (e.g., `amazon-scraper-data`)
3. Select your preferred AWS region
4. Keep default settings and click **Create bucket**

## Step 2: Set up IAM permissions

Create an IAM role that grants Bright Data write access to your bucket.

### Create a policy

In the [IAM Console](https://console.aws.amazon.com/iam/), go to **Policies** and create a new policy with this JSON:

```json theme={null}
{
  "Version": "2012-10-17",
  "Statement": [
    {
      "Effect": "Allow",
      "Action": ["s3:PutObject", "s3:GetObject"],
      "Resource": "arn:aws:s3:::amazon-scraper-data/*"
    }
  ]
}
```

Replace `amazon-scraper-data` with your actual bucket name.

### Create a role for Bright Data

1. Go to **Roles** > **Create role**
2. Select **AWS account** as the trusted entity type
3. Enter Bright Data's AWS account ID: `422310177405`
4. Attach the policy you created above
5. Name the role (e.g., `BrightDataS3Delivery`)
6. Note the role ARN (e.g., `arn:aws:iam::123456789012:role/BrightDataS3Delivery`)

Add an external ID condition to the trust policy:

```json theme={null}
{
  "Version": "2012-10-17",
  "Statement": [
    {
      "Effect": "Allow",
      "Principal": {
        "AWS": "arn:aws:iam::422310177405:role/brd.ec2.zs-dca-delivery"
      },
      "Action": "sts:AssumeRole",
      "Condition": {
        "StringEquals": {
          "sts:ExternalId": "YOUR_BRIGHT_DATA_CUSTOMER_ID"
        }
      }
    }
  ]
}
```

Find your customer ID in [Account settings](https://brightdata.com/cp/setting/customer_details).

## Step 3: Configure delivery in Bright Data

1. Navigate to your [scraper configuration](https://brightdata.com/cp/scrapers)
2. Click the **Delivery settings** tab
3. Select **Amazon S3** as the delivery destination
4. Enter your credentials:
   * **Bucket name**: Your S3 bucket name
   * **Role ARN**: The IAM role ARN from Step 2
   * **Region**: Your S3 bucket region
   * **Path prefix** (optional): A folder path within the bucket (e.g., `amazon/products/`)
5. Select your preferred file format (JSON, NDJSON, or CSV)
6. Click **Save**

## Step 4: Trigger a collection

Trigger an async collection. Results are automatically delivered to your S3 bucket:

<CodeGroup>
  ```bash cURL theme={null}
  curl -X POST \
    "https://api.brightdata.com/datasets/v3/trigger?dataset_id=gd_l7q7dkf244hwjntr0&format=json" \
    -H "Authorization: Bearer YOUR_API_KEY" \
    -H "Content-Type: application/json" \
    -d '[
      {"url": "https://www.amazon.com/dp/B0CHHSFMRL"},
      {"url": "https://www.amazon.com/dp/B09V3KXJPB"},
      {"url": "https://www.amazon.com/dp/B0BDJ279KF"}
    ]'
  ```

  ```python Python theme={null}
  import requests

  response = requests.post(
      "https://api.brightdata.com/datasets/v3/trigger",
      params={"dataset_id": "gd_l7q7dkf244hwjntr0", "format": "json"},
      headers={
          "Authorization": "Bearer YOUR_API_KEY",
          "Content-Type": "application/json",
      },
      json=[
          {"url": "https://www.amazon.com/dp/B0CHHSFMRL"},
          {"url": "https://www.amazon.com/dp/B09V3KXJPB"},
          {"url": "https://www.amazon.com/dp/B0BDJ279KF"},
      ],
  )

  print("Snapshot ID:", response.json()["snapshot_id"])
  ```

  ```javascript Node.js theme={null}
  const response = await fetch(
    "https://api.brightdata.com/datasets/v3/trigger?dataset_id=gd_l7q7dkf244hwjntr0&format=json",
    {
      method: "POST",
      headers: {
        "Authorization": "Bearer YOUR_API_KEY",
        "Content-Type": "application/json",
      },
      body: JSON.stringify([
        { url: "https://www.amazon.com/dp/B0CHHSFMRL" },
        { url: "https://www.amazon.com/dp/B09V3KXJPB" },
        { url: "https://www.amazon.com/dp/B0BDJ279KF" },
      ]),
    }
  );

  const data = await response.json();
  console.log("Snapshot ID:", data.snapshot_id);
  ```
</CodeGroup>

## Step 5: Verify delivery

Once the collection completes, check your S3 bucket for the delivered file:

```bash theme={null}
aws s3 ls s3://amazon-scraper-data/amazon/products/
```

You should see a file named with the snapshot ID (e.g., `s_m1a2b3c4d5e6f7g8h.json`).

Download and inspect it:

```bash theme={null}
aws s3 cp s3://amazon-scraper-data/amazon/products/s_m1a2b3c4d5e6f7g8h.json ./results.json
cat results.json | python -m json.tool | head -20
```

You can also verify delivery status using the [Monitor Delivery API](/api-reference/scrapers/management-apis/monitor-delivery).

## Troubleshooting

<Accordion title="Files not appearing in S3?">
  * Verify the IAM role ARN and external ID are correct
  * Check that the bucket policy allows `s3:PutObject` from Bright Data's account
  * Ensure the bucket region matches your configuration
  * Review delivery status in the Bright Data dashboard under **Logs**
</Accordion>

<Accordion title="Access denied errors?">
  Verify the trust policy on your IAM role includes Bright Data's account (`422310177405`) and your external ID matches your Bright Data customer ID found in [Account settings](https://brightdata.com/cp/setting/customer_details).
</Accordion>

<Accordion title="Delivered file is empty or missing records?">
  Check the collection status in the Bright Data dashboard. If some URLs failed, the delivered file contains only successful results. Retry failed URLs in a separate request.
</Accordion>

## Next steps

<CardGroup>
  <Card title="Set up webhooks" icon="webhook" href="/datasets/scrapers/amazon/data-delivery/webhooks">
    Receive results at your HTTP endpoint.
  </Card>

  <Card title="All delivery options" icon="truck" href="/datasets/scrapers/scrapers-library/delivery-options">
    Snowflake, Azure, GCS, SFTP, and more.
  </Card>
</CardGroup>


# Amazon data delivery via webhook
Source: https://docs.brightdata.com/datasets/scrapers/amazon/data-delivery/webhooks

Configure the Bright Data Amazon Scraper API to push scraped data to your HTTPS webhook as each collection job completes across 5 supported endpoints.

This guide shows you how to set up webhook delivery so your server receives scraped Amazon data automatically when a collection job finishes.

## Prerequisites

* A [Bright Data account](https://brightdata.com/cp/start) with an active API key
* Familiarity with the [async request workflow](/datasets/scrapers/amazon/async-requests)
* A publicly accessible HTTP endpoint (or a testing tool like [webhook.site](https://webhook.site))

## How webhooks work

When you trigger an async collection with an `endpoint` URL, Bright Data sends a `POST` request to that URL with the scraped data once the job completes. No polling required.

```text theme={null}
Your app --> POST /trigger (with webhook URL) --> Bright Data scrapes --> POST to your webhook
```

## Step 1: Set up a test webhook

For testing, use [webhook.site](https://webhook.site) to get a temporary public URL:

1. Open [webhook.site](https://webhook.site) in your browser
2. Copy the unique URL displayed (e.g., `https://webhook.site/abc-123-def`)
3. Keep the page open to monitor incoming requests

## Step 2: Trigger a collection with the webhook URL

Add the `endpoint` query parameter to your async `/trigger` request:

<CodeGroup>
  ```bash cURL theme={null}
  curl -X POST \
    "https://api.brightdata.com/datasets/v3/trigger?dataset_id=gd_l7q7dkf244hwjntr0&format=json&endpoint=https://webhook.site/abc-123-def&uncompressed_webhook=true" \
    -H "Authorization: Bearer YOUR_API_KEY" \
    -H "Content-Type: application/json" \
    -d '[
      {"url": "https://www.amazon.com/dp/B0CHHSFMRL"},
      {"url": "https://www.amazon.com/dp/B09V3KXJPB"}
    ]'
  ```

  ```python Python theme={null}
  import requests

  WEBHOOK_URL = "https://webhook.site/abc-123-def"

  response = requests.post(
      "https://api.brightdata.com/datasets/v3/trigger",
      params={
          "dataset_id": "gd_l7q7dkf244hwjntr0",
          "format": "json",
          "webhook": WEBHOOK_URL,
          "uncompressed_webhook": "true",
      },
      headers={
          "Authorization": "Bearer YOUR_API_KEY",
          "Content-Type": "application/json",
      },
      json=[
          {"url": "https://www.amazon.com/dp/B0CHHSFMRL"},
          {"url": "https://www.amazon.com/dp/B09V3KXJPB"},
      ],
  )

  print("Snapshot ID:", response.json()["snapshot_id"])
  ```

  ```javascript Node.js theme={null}
  const WEBHOOK_URL = "https://webhook.site/abc-123-def";

  const response = await fetch(
    `https://api.brightdata.com/datasets/v3/trigger?dataset_id=gd_l7q7dkf244hwjntr0&format=json&endpoint=${encodeURIComponent(WEBHOOK_URL)}&uncompressed_webhook=true`,
    {
      method: "POST",
      headers: {
        "Authorization": "Bearer YOUR_API_KEY",
        "Content-Type": "application/json",
      },
      body: JSON.stringify([
        { url: "https://www.amazon.com/dp/B0CHHSFMRL" },
        { url: "https://www.amazon.com/dp/B09V3KXJPB" },
      ]),
    }
  );

  const data = await response.json();
  console.log("Snapshot ID:", data.snapshot_id);
  ```
</CodeGroup>

Key parameters:

| Parameter              | Description                                                  |
| :--------------------- | :----------------------------------------------------------- |
| `endpoint`             | Your HTTP endpoint URL that receives the `POST` payload      |
| `uncompressed_webhook` | Set to `true` to receive uncompressed JSON (default is gzip) |
| `format`               | Output format: `json`, `ndjson`, or `csv`                    |

## Step 3: Verify delivery

Once the collection completes (typically 30-60 seconds for a few products), check your webhook.site page. You should see a `POST` request with the scraped data.

The payload is the same JSON array you would receive from a direct API download:

```json theme={null}
[
  {
    "title": "Apple AirPods Pro (2nd Generation)",
    "asin": "B0CHHSFMRL",
    "price": 189.99,
    "currency": "USD",
    "rating": 4.7,
    "reviews_count": 85420,
    "seller_name": "Amazon.com",
    "brand": "Apple"
  },
  {
    "title": "Echo Dot (5th Gen)",
    "asin": "B09V3KXJPB",
    "price": 49.99,
    "currency": "USD",
    "rating": 4.6,
    "reviews_count": 127800,
    "seller_name": "Amazon.com",
    "brand": "Amazon"
  }
]
```

## Production webhook setup

For production, point the `endpoint` URL to your own server endpoint.

### How to handle webhooks in Express.js

```javascript server.js theme={null}
const express = require("express");
const app = express();

app.use(express.json({ limit: "100mb" }));

app.post("/webhook/amazon", (req, res) => {
  const products = req.body;
  console.log(`Received ${products.length} products`);

  for (const product of products) {
    console.log(`- ${product.title} ($${product.price})`);
  }

  res.status(200).json({ received: true });
});

app.listen(3000, () => console.log("Webhook server running on port 3000"));
```

### How to handle webhooks in Flask

```python server.py theme={null}
from flask import Flask, request, jsonify

app = Flask(__name__)

@app.route("/webhook/amazon", methods=["POST"])
def handle_webhook():
    products = request.get_json()
    print(f"Received {len(products)} products")

    for product in products:
        print(f"- {product['title']} (${product.get('price')})")

    return jsonify({"received": True}), 200

if __name__ == "__main__":
    app.run(port=3000)
```

<Warning>
  Return a `200` status code within 30 seconds to acknowledge receipt. If your endpoint fails or times out, Bright Data retries delivery.
</Warning>

## Webhook with authorization

If your endpoint requires authentication, add the `webhook_header_Authorization` parameter:

```bash theme={null}
curl -X POST \
  "https://api.brightdata.com/datasets/v3/trigger?dataset_id=gd_l7q7dkf244hwjntr0&format=json&endpoint=https://your-server.com/webhook&webhook_header_Authorization=Bearer+YOUR_SECRET_TOKEN" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '[{"url": "https://www.amazon.com/dp/B0CHHSFMRL"}]'
```

## Allowlist webhook IPs

If your server uses an IP allowlist, add the following Bright Data webhook source IPs:

```text theme={null}
54.175.27.69
34.225.9.175
100.28.38.247
100.29.18.195
52.72.185.255
35.174.112.248
54.165.183.124
3.91.140.7
52.202.75.37
98.82.225.117
100.27.150.189
18.214.10.85
35.169.71.210
44.194.183.74
```

## Troubleshooting

<Accordion title="Webhook not receiving data?">
  * Verify the URL is publicly accessible (not `localhost`)
  * Check that your endpoint returns a `200` status code within 30 seconds
  * Verify the webhook IPs above are allowlisted if you have firewall rules
</Accordion>

<Accordion title="Receiving compressed data?">
  If you omit `uncompressed_webhook=true`, data arrives gzip-compressed. Add `uncompressed_webhook=true` to your trigger URL, or decompress the payload on your server.
</Accordion>

<Accordion title="Payload too large for your server?">
  Large collections can produce payloads up to 1 GB. Set `express.json({ limit: "100mb" })` in Express.js or equivalent in your framework. If you need to handle very large datasets, use [S3 delivery](/datasets/scrapers/amazon/data-delivery/amazon-s3) instead.
</Accordion>

## Next steps

<CardGroup>
  <Card title="Deliver to Amazon S3" icon="bucket" href="/datasets/scrapers/amazon/data-delivery/amazon-s3">
    Store results directly in your S3 bucket.
  </Card>

  <Card title="All delivery options" icon="truck" href="/datasets/scrapers/scrapers-library/delivery-options">
    Snowflake, Azure, GCS, and more.
  </Card>
</CardGroup>


# Amazon Scraper API
Source: https://docs.brightdata.com/datasets/scrapers/amazon/introduction

Extract structured data from Amazon products, reviews, sellers and search results with the Bright Data [Amazon Scraper API](https://brightdata.com/products/web-scraper/amazon). Handles up to 20 URLs per request.

Send an Amazon URL, get structured JSON back. The Bright Data Amazon Scraper API handles proxies, CAPTCHAs, and parsing so you can focus on your data pipeline.

<Tip>
  New to Bright Data? [Create a free account](https://brightdata.com/products/web-scraper/amazon/?hs_signup=1\&utm_source=docs) and get **5,000 free credits every month**, no credit card required. That's up to **5,000 Amazon records** to start scraping. See the [free tier](/general/account/billing-and-pricing/free-tier).
</Tip>

## How it works

You send one or more Amazon URLs to the Bright Data Amazon Scraper API. Bright Data handles the scraping infrastructure and returns clean, structured JSON.

```text theme={null}
Your app  -->  Bright Data API  -->  Structured JSON
           POST /datasets/v3/scrape
           Authorization: Bearer YOUR_API_KEY
```

All requests use a `dataset_id` to specify the data type (products, reviews, sellers, global products, or search) and return results in JSON, NDJSON, or CSV.

## What the response looks like

```bash theme={null}
curl -X POST "https://api.brightdata.com/datasets/v3/scrape?dataset_id=gd_l7q7dkf244hwjntr0&format=json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '[{"url": "https://www.amazon.com/dp/B0CHHSFMRL"}]'
```

```json theme={null}
{
  "title": "Apple AirPods Pro (2nd Generation)",
  "asin": "B0CHHSFMRL",
  "price": 189.99,
  "currency": "USD",
  "rating": 4.7,
  "reviews_count": 85420,
  "seller_name": "Amazon.com",
  "brand": "Apple",
  "availability": "In Stock",
  "main_image": "https://m.media-amazon.com/images/I/...",
  "url": "https://www.amazon.com/dp/B0CHHSFMRL"
}
```

## Supported data types

<CardGroup>
  <Card title="Products" icon="box" href="/api-reference/scrapers/e-commerce-apis/amazon-products-collect-by-url">
    Product titles, prices, ratings, reviews count, seller info, and availability. Discover products by best sellers, category, keyword, or UPC.
  </Card>

  <Card title="Reviews" icon="star" href="/api-reference/scrapers/e-commerce-apis/amazon-reviews-collect-by-url">
    Review text, ratings, reviewer details, verified purchase status, and review dates.
  </Card>

  <Card title="Sellers Info" icon="store" href="/api-reference/scrapers/e-commerce-apis/amazon-sellers-info-collect-by-url">
    Seller names, ratings, feedback counts, and business details.
  </Card>

  <Card title="Products Global" icon="globe" href="/api-reference/scrapers/e-commerce-apis/amazon-products-global-collect-by-url">
    Product data from Amazon marketplaces worldwide. Discover by brand, category, keywords, or seller.
  </Card>

  <Card title="Products Search" icon="magnifying-glass" href="/api-reference/scrapers/e-commerce-apis/amazon-products-search-collect-by-url">
    Search results for any keyword on Amazon, including product listings and pagination.
  </Card>
</CardGroup>

## Request methods

The Bright Data Amazon Scraper API supports two request methods. Choose based on your volume and latency needs.

| Method           | Endpoint                                                  | Best for                                   |
| :--------------- | :-------------------------------------------------------- | :----------------------------------------- |
| **Synchronous**  | [`/scrape`](/datasets/scrapers/amazon/send-first-request) | Real-time lookups, up to 20 URLs           |
| **Asynchronous** | [`/trigger`](/datasets/scrapers/amazon/async-requests)    | Batch jobs, 20+ URLs, production pipelines |

Learn more in [Understanding sync vs. async requests](/datasets/scrapers/concepts/sync-vs-async).

## Capabilities and limits

| Capability                     | Detail                                                                                                                                                                                                                                 |
| :----------------------------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Output formats**             | JSON, NDJSON, CSV                                                                                                                                                                                                                      |
| **Max URLs per sync request**  | 20                                                                                                                                                                                                                                     |
| **Max URLs per async request** | 5,000                                                                                                                                                                                                                                  |
| **Data freshness**             | Real-time (scraped on demand)                                                                                                                                                                                                          |
| **Delivery options**           | API download, [Webhook](/datasets/scrapers/amazon/data-delivery/webhooks), [Amazon S3](/datasets/scrapers/amazon/data-delivery/amazon-s3), Snowflake, Azure, GCS ([all options](/datasets/scrapers/scrapers-library/delivery-options)) |
| **Pricing**                    | Pay per successful record ([see pricing](https://brightdata.com/pricing/web-scraper))                                                                                                                                                  |

## Common questions

<Accordion title="Is the data scraped in real time?">
  Yes. Each request triggers a live scrape. There is no cached or stale data. Response times vary by endpoint: products typically return in 10-30 seconds (sync), while discovery requests may take longer depending on result volume.
</Accordion>

<Accordion title="What is the difference between URL collection and discovery?">
  **URL collection** scrapes a specific Amazon page you provide (e.g., a product URL). **Discovery** finds Amazon content matching search criteria (e.g., all products in a category or matching a keyword) and scrapes the results. Discovery is only available via async requests.
</Accordion>

<Accordion title="How is this different from scraping using proxies or Web Unlocker?">
  When scraping using proxies or Web Unlocker, you still need to write and maintain your own parsing logic and update it whenever Amazon changes its page structure. The Amazon Scraper API handles the entire stack: proxy rotation, anti-bot bypassing and parsing. You simply send an Amazon URL and get clean, structured JSON back with no scraping infrastructure or parser maintenance required on your end.
</Accordion>

## Next steps

<CardGroup>
  <Card title="Quickstart" icon="rocket" href="/datasets/scrapers/amazon/quickstart">
    Scrape your first Amazon product in 5 minutes.
  </Card>

  <Card title="Send your first request" icon="bolt" href="/datasets/scrapers/amazon/send-first-request">
    Full code examples in cURL, Python, and Node.js.
  </Card>

  <Card title="API reference" icon="code" href="/api-reference/scrapers/e-commerce-apis/amazon-products-collect-by-url">
    Endpoint specs, parameters, and response schemas.
  </Card>
</CardGroup>


# Amazon scraper quickstart
Source: https://docs.brightdata.com/datasets/scrapers/amazon/quickstart

Set up the Bright Data Amazon Scraper API and collect your first product, review or seller record as structured JSON in under 5 minutes from the Control Panel.

This tutorial shows you how to scrape an Amazon product and get structured JSON data using the Bright Data Amazon Scraper API.

## Prerequisites

* A [Bright Data account](https://brightdata.com/cp/start) (includes \$2 free credit)
* cURL, Python 3, or Node.js 18+ installed

<Steps>
  <Step title="Get your API key">
    Go to the [user settings page](https://brightdata.com/cp/setting/users) in your Bright Data account and copy your API key.

    If you don't have an account yet, [sign up at brightdata.com](https://brightdata.com/cp/start). New users get \$2 free credit for testing.

    <Warning>
      Your API key is shown only once when created. Copy and store it securely.
    </Warning>
  </Step>

  <Step title="Send a request">
    We'll use the **Products endpoint** with a synchronous request. Replace `YOUR_API_KEY` with your actual token:

    <CodeGroup>
      ```bash cURL theme={null}
      curl -X POST \
        "https://api.brightdata.com/datasets/v3/scrape?dataset_id=gd_l7q7dkf244hwjntr0&format=json" \
        -H "Authorization: Bearer YOUR_API_KEY" \
        -H "Content-Type: application/json" \
        -d '[{"url": "https://www.amazon.com/dp/B0CHHSFMRL"}]'
      ```

      ```python Python theme={null}
      import requests

      response = requests.post(
          "https://api.brightdata.com/datasets/v3/scrape",
          params={"dataset_id": "gd_l7q7dkf244hwjntr0", "format": "json"},
          headers={
              "Authorization": "Bearer YOUR_API_KEY",
              "Content-Type": "application/json",
          },
          json=[{"url": "https://www.amazon.com/dp/B0CHHSFMRL"}],
      )

      print(response.json())
      ```

      ```javascript Node.js theme={null}
      const response = await fetch(
        "https://api.brightdata.com/datasets/v3/scrape?dataset_id=gd_l7q7dkf244hwjntr0&format=json",
        {
          method: "POST",
          headers: {
            "Authorization": "Bearer YOUR_API_KEY",
            "Content-Type": "application/json",
          },
          body: JSON.stringify([
            { url: "https://www.amazon.com/dp/B0CHHSFMRL" }
          ]),
        }
      );

      const data = await response.json();
      console.log(data);
      ```
    </CodeGroup>

    You should see a `200` status code. This takes 10-30 seconds.
  </Step>

  <Step title="Review the response">
    The Bright Data Amazon Scraper API returns a JSON array with structured product data:

    ```json theme={null}
    [
      {
        "title": "Apple AirPods Pro (2nd Generation)",
        "asin": "B0CHHSFMRL",
        "price": 189.99,
        "currency": "USD",
        "rating": 4.7,
        "reviews_count": 85420,
        "seller_name": "Amazon.com",
        "brand": "Apple",
        "availability": "In Stock",
        "url": "https://www.amazon.com/dp/B0CHHSFMRL"
      }
    ]
    ```

    Each product object includes fields covering pricing, ratings, seller info, and more. See the [full response schema](/api-reference/scrapers/e-commerce-apis/amazon-products-collect-by-url).
  </Step>
</Steps>

You've successfully scraped your first Amazon product using the Bright Data Amazon Scraper API.

## Common questions

<Accordion title="Can I scrape multiple products in one request?">
  Yes. Add more objects to the input array. Synchronous requests support up to 20 URLs. For larger batches, use the [async `/trigger` endpoint](/datasets/scrapers/amazon/async-requests).

  ```json theme={null}
  [
    {"url": "https://www.amazon.com/dp/B0CHHSFMRL"},
    {"url": "https://www.amazon.com/dp/B09V3KXJPB"},
    {"url": "https://www.amazon.com/dp/B0BDJ279KF"}
  ]
  ```
</Accordion>

<Accordion title="Getting a 401 or 403 error?">
  Verify your API key is correct and hasn't expired. Generate a new token from [Account settings](https://brightdata.com/cp/setting/users). See the [authentication guide](/api-reference/authentication) for details.
</Accordion>

<Accordion title="Request is timing out?">
  Synchronous requests have a 1-minute timeout. If the request exceeds this limit, it automatically switches to async and returns a `snapshot_id`. Use the [async workflow](/datasets/scrapers/amazon/async-requests) for large batches.
</Accordion>

<Accordion title="Empty or partial response data?">
  Verify the Amazon product URL is publicly accessible and correctly formatted. The URL should follow the pattern `https://www.amazon.com/dp/{ASIN}`.
</Accordion>

## Next steps

<CardGroup>
  <Card title="Send your first request" icon="bolt" href="/datasets/scrapers/amazon/send-first-request">
    Explore all five endpoint types with full examples.
  </Card>

  <Card title="Async batch requests" icon="layer-group" href="/datasets/scrapers/amazon/async-requests">
    Scrape hundreds of URLs in a single batch job.
  </Card>

  <Card title="Set up webhooks" icon="webhook" href="/datasets/scrapers/amazon/data-delivery/webhooks">
    Receive results automatically when scraping completes.
  </Card>
</CardGroup>


# Send your first Amazon API request
Source: https://docs.brightdata.com/datasets/scrapers/amazon/send-first-request

Send synchronous requests to all 5 Bright Data Amazon Scraper API endpoints with copy-paste examples for products, reviews, sellers, global and search.

This tutorial walks you through sending a synchronous request to each Bright Data Amazon Scraper API endpoint. By the end, you'll have working examples for products, reviews, sellers info, products global, and products search.

## Prerequisites

* A [Bright Data account](https://brightdata.com/cp/start) with an active API key
* Completed the [Quickstart](/datasets/scrapers/amazon/quickstart)

## Request structure

Every synchronous request follows the same pattern:

```http theme={null}
POST https://api.brightdata.com/datasets/v3/scrape?dataset_id={DATASET_ID}&format=json
Authorization: Bearer YOUR_API_KEY
Content-Type: application/json

[{"url": "https://www.amazon.com/..."}]
```

The only thing that changes between endpoints is the `dataset_id` and the input URL format.

<Note>
  Synchronous requests support up to 20 URLs and have a 1-minute timeout. If the request takes longer, the API automatically returns a `snapshot_id` instead. See [async requests](/datasets/scrapers/amazon/async-requests).
</Note>

## How to scrape Amazon products

**Dataset ID:** `gd_l7q7dkf244hwjntr0`

```bash theme={null}
curl -X POST \
  "https://api.brightdata.com/datasets/v3/scrape?dataset_id=gd_l7q7dkf244hwjntr0&format=json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '[{"url": "https://www.amazon.com/dp/B0CHHSFMRL"}]'
```

You should see a `200` response. This takes 10-30 seconds.

<Accordion title="Example response">
  ```json theme={null}
  [
    {
      "title": "Apple AirPods Pro (2nd Generation)",
      "asin": "B0CHHSFMRL",
      "price": 189.99,
      "currency": "USD",
      "rating": 4.7,
      "reviews_count": 85420,
      "seller_name": "Amazon.com",
      "brand": "Apple",
      "availability": "In Stock",
      "main_image": "https://m.media-amazon.com/images/I/...",
      "url": "https://www.amazon.com/dp/B0CHHSFMRL"
    }
  ]
  ```
</Accordion>

[Full Products response schema](/api-reference/scrapers/e-commerce-apis/amazon-products-collect-by-url)

## How to scrape Amazon reviews

**Dataset ID:** `gd_le8e811kzy4ggddlq`

```bash theme={null}
curl -X POST \
  "https://api.brightdata.com/datasets/v3/scrape?dataset_id=gd_le8e811kzy4ggddlq&format=json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '[{"url": "https://www.amazon.com/dp/B0CHHSFMRL"}]'
```

<Accordion title="Example response">
  ```json theme={null}
  [
    {
      "title": "Best noise cancellation ever",
      "text": "These earbuds have incredible noise cancellation. The fit is comfortable and battery life is outstanding.",
      "rating": 5,
      "date": "2024-08-15T00:00:00.000Z",
      "author_name": "TechReviewer42",
      "verified_purchase": true,
      "helpful_count": 234,
      "asin": "B0CHHSFMRL",
      "url": "https://www.amazon.com/dp/B0CHHSFMRL"
    }
  ]
  ```
</Accordion>

[Full Reviews response schema](/api-reference/scrapers/e-commerce-apis/amazon-reviews-collect-by-url)

## How to scrape Amazon sellers info

**Dataset ID:** `gd_lhotzucw1etoe5iw1k`

```bash theme={null}
curl -X POST \
  "https://api.brightdata.com/datasets/v3/scrape?dataset_id=gd_lhotzucw1etoe5iw1k&format=json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '[{"url": "https://www.amazon.com/sp?seller=A2FE5N3LOEXQRU"}]'
```

<Accordion title="Example response">
  ```json theme={null}
  [
    {
      "seller_name": "TechGadgets Direct",
      "seller_id": "A2FE5N3LOEXQRU",
      "rating": 4.5,
      "ratings_count": 12450,
      "positive_feedback_pct": 95,
      "business_name": "TechGadgets LLC",
      "business_address": "123 Commerce St, Seattle, WA 98101",
      "url": "https://www.amazon.com/sp?seller=A2FE5N3LOEXQRU"
    }
  ]
  ```
</Accordion>

[Full Sellers Info response schema](/api-reference/scrapers/e-commerce-apis/amazon-sellers-info-collect-by-url)

## How to scrape Amazon products globally

**Dataset ID:** `gd_lwhideng15g8jg63s7`

```bash theme={null}
curl -X POST \
  "https://api.brightdata.com/datasets/v3/scrape?dataset_id=gd_lwhideng15g8jg63s7&format=json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '[{"url": "https://www.amazon.co.uk/dp/B0CHHSFMRL"}]'
```

<Accordion title="Example response">
  ```json theme={null}
  [
    {
      "title": "Apple AirPods Pro (2nd Generation)",
      "asin": "B0CHHSFMRL",
      "price": 229.00,
      "currency": "GBP",
      "rating": 4.7,
      "reviews_count": 32150,
      "seller_name": "Amazon.co.uk",
      "brand": "Apple",
      "availability": "In Stock",
      "domain": "amazon.co.uk",
      "url": "https://www.amazon.co.uk/dp/B0CHHSFMRL"
    }
  ]
  ```
</Accordion>

[Full Products Global response schema](/api-reference/scrapers/e-commerce-apis/amazon-products-global-collect-by-url)

## How to scrape Amazon product search

**Dataset ID:** `gd_lwdb4vjm1ehb499uxs`

```bash theme={null}
curl -X POST \
  "https://api.brightdata.com/datasets/v3/scrape?dataset_id=gd_lwdb4vjm1ehb499uxs&format=json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '[{"keyword": "wireless earbuds", "url": "https://www.amazon.com", "pages_to_search": 1}]'
```

<Accordion title="Example response">
  ```json theme={null}
  [
    {
      "title": "Apple AirPods Pro (2nd Generation)",
      "asin": "B0CHHSFMRL",
      "price": 189.99,
      "currency": "USD",
      "rating": 4.7,
      "reviews_count": 85420,
      "sponsored": false,
      "position": 1,
      "keyword": "wireless earbuds",
      "url": "https://www.amazon.com/dp/B0CHHSFMRL"
    },
    {
      "title": "Samsung Galaxy Buds2 Pro",
      "asin": "B0B2SH4CN6",
      "price": 159.99,
      "currency": "USD",
      "rating": 4.5,
      "reviews_count": 42300,
      "sponsored": false,
      "position": 2,
      "keyword": "wireless earbuds",
      "url": "https://www.amazon.com/dp/B0B2SH4CN6"
    }
  ]
  ```
</Accordion>

[Full Products Search response schema](/api-reference/scrapers/e-commerce-apis/amazon-products-search-collect-by-url)

## Quick reference: dataset IDs

| Endpoint        | Dataset ID              | Input format                          |
| :-------------- | :---------------------- | :------------------------------------ |
| Products        | `gd_l7q7dkf244hwjntr0`  | `amazon.com/dp/{ASIN}`                |
| Reviews         | `gd_le8e811kzy4ggddlq`  | `amazon.com/dp/{ASIN}`                |
| Sellers Info    | `gd_lhotzucw1etoe5iw1k` | `amazon.com/sp?seller={SELLER_ID}`    |
| Products Global | `gd_lwhideng15g8jg63s7` | `amazon.{domain}/dp/{ASIN}`           |
| Products Search | `gd_lwdb4vjm1ehb499uxs` | `keyword` + `url` + `pages_to_search` |

## Output formats

Control the response format with the `format` query parameter:

| Value    | Description                                 |
| :------- | :------------------------------------------ |
| `json`   | JSON array (default)                        |
| `ndjson` | Newline-delimited JSON, one record per line |
| `csv`    | Comma-separated values                      |

## Next steps

<CardGroup>
  <Card title="Async batch requests" icon="layer-group" href="/datasets/scrapers/amazon/async-requests">
    Scrape hundreds of URLs in a single batch job.
  </Card>

  <Card title="API reference" icon="code" href="/api-reference/scrapers/e-commerce-apis/amazon-products-collect-by-url">
    Full parameter and response field reference.
  </Card>
</CardGroup>


# Async ChatGPT search collection
Source: https://docs.brightdata.com/datasets/scrapers/chatgpt/async-requests

Trigger large-scale ChatGPT search jobs, monitor progress, and retrieve results using the Bright Data async /trigger endpoint. Supports batches of 20 prompts.

This guide shows you how to search ChatGPT at scale using the asynchronous `/trigger` endpoint. Use this when you have more than 20 prompts or want delivery to a webhook or S3.

<Tip>
  Not sure whether to use sync or async? Read [Understanding sync vs. async requests](/datasets/scrapers/concepts/sync-vs-async).
</Tip>

## Prerequisites

* A [Bright Data account](https://brightdata.com/cp/start) with an active API key
* Familiarity with the [synchronous request flow](/datasets/scrapers/chatgpt/send-first-request)

## Step 1: Trigger the collection

Send a `POST` request to the `/trigger` endpoint with your input prompts:

<CodeGroup>
  ```bash cURL theme={null}
  curl -X POST \
    "https://api.brightdata.com/datasets/v3/trigger?dataset_id=gd_m7aof0k82r803d5bjm&format=json" \
    -H "Authorization: Bearer YOUR_API_KEY" \
    -H "Content-Type: application/json" \
    -d '[
      {"url": "https://chatgpt.com/", "prompt": "Top hotels in New York"},
      {"url": "https://chatgpt.com/", "prompt": "Best restaurants in Paris"},
      {"url": "https://chatgpt.com/", "prompt": "Things to do in Tokyo"},
      {"url": "https://chatgpt.com/", "prompt": "Budget travel tips for Europe"},
      {"url": "https://chatgpt.com/", "prompt": "Best beaches in Southeast Asia"}
    ]'
  ```

  ```python Python theme={null}
  import requests

  response = requests.post(
      "https://api.brightdata.com/datasets/v3/trigger",
      params={
          "dataset_id": "gd_m7aof0k82r803d5bjm",
          "format": "json",
      },
      headers={
          "Authorization": "Bearer YOUR_API_KEY",
          "Content-Type": "application/json",
      },
      json=[
          {"url": "https://chatgpt.com/", "prompt": "Top hotels in New York"},
          {"url": "https://chatgpt.com/", "prompt": "Best restaurants in Paris"},
          {"url": "https://chatgpt.com/", "prompt": "Things to do in Tokyo"},
          {"url": "https://chatgpt.com/", "prompt": "Budget travel tips for Europe"},
          {"url": "https://chatgpt.com/", "prompt": "Best beaches in Southeast Asia"},
      ],
  )

  snapshot = response.json()
  print("Snapshot ID:", snapshot["snapshot_id"])
  ```

  ```javascript Node.js theme={null}
  const response = await fetch(
    "https://api.brightdata.com/datasets/v3/trigger?dataset_id=gd_m7aof0k82r803d5bjm&format=json",
    {
      method: "POST",
      headers: {
        "Authorization": "Bearer YOUR_API_KEY",
        "Content-Type": "application/json",
      },
      body: JSON.stringify([
        { url: "https://chatgpt.com/", prompt: "Top hotels in New York" },
        { url: "https://chatgpt.com/", prompt: "Best restaurants in Paris" },
        { url: "https://chatgpt.com/", prompt: "Things to do in Tokyo" },
        { url: "https://chatgpt.com/", prompt: "Budget travel tips for Europe" },
        { url: "https://chatgpt.com/", prompt: "Best beaches in Southeast Asia" },
      ]),
    }
  );

  const snapshot = await response.json();
  console.log("Snapshot ID:", snapshot.snapshot_id);
  ```
</CodeGroup>

You should see a `200` response with a `snapshot_id`:

```json theme={null}
{
  "snapshot_id": "s_m1a2b3c4d5e6f7g8h"
}
```

Save this ID. You need it to check progress and download results.

## Step 2: Monitor progress

Poll the snapshot status until it shows `ready`. This takes 30 seconds to several minutes depending on the number of prompts.

<CodeGroup>
  ```bash cURL theme={null}
  curl "https://api.brightdata.com/datasets/v3/progress/s_m1a2b3c4d5e6f7g8h" \
    -H "Authorization: Bearer YOUR_API_KEY"
  ```

  ```python Python theme={null}
  import time

  snapshot_id = "s_m1a2b3c4d5e6f7g8h"

  while True:
      status_response = requests.get(
          f"https://api.brightdata.com/datasets/v3/progress/{snapshot_id}",
          headers={"Authorization": "Bearer YOUR_API_KEY"},
      )
      status = status_response.json().get("status")
      print(f"Status: {status}")

      if status == "ready":
          break
      time.sleep(10)
  ```

  ```javascript Node.js theme={null}
  const snapshotId = "s_m1a2b3c4d5e6f7g8h";

  let status = "collecting";
  while (status !== "ready") {
    const statusResponse = await fetch(
      `https://api.brightdata.com/datasets/v3/progress/${snapshotId}`,
      { headers: { "Authorization": "Bearer YOUR_API_KEY" } }
    );
    const statusData = await statusResponse.json();
    status = statusData.status;
    console.log("Status:", status);

    if (status !== "ready") {
      await new Promise((r) => setTimeout(r, 10000));
    }
  }
  ```
</CodeGroup>

Status values:

| Status       | Meaning                             |
| :----------- | :---------------------------------- |
| `collecting` | Scraping is in progress             |
| `digesting`  | Data is being processed             |
| `ready`      | Results are available for download  |
| `failed`     | The collection encountered an error |

## Step 3: Download results

Once the status is `ready`, download the scraped data:

<CodeGroup>
  ```bash cURL theme={null}
  curl "https://api.brightdata.com/datasets/v3/snapshot/s_m1a2b3c4d5e6f7g8h?format=json" \
    -H "Authorization: Bearer YOUR_API_KEY" \
    -o results.json
  ```

  ```python Python theme={null}
  results_response = requests.get(
      f"https://api.brightdata.com/datasets/v3/snapshot/{snapshot_id}",
      params={"format": "json"},
      headers={"Authorization": "Bearer YOUR_API_KEY"},
  )

  results = results_response.json()
  print(f"Collected {len(results)} search results")
  ```

  ```javascript Node.js theme={null}
  const resultsResponse = await fetch(
    `https://api.brightdata.com/datasets/v3/snapshot/${snapshotId}?format=json`,
    { headers: { "Authorization": "Bearer YOUR_API_KEY" } }
  );

  const results = await resultsResponse.json();
  console.log(`Collected ${results.length} search results`);
  ```
</CodeGroup>

You've successfully triggered, monitored, and downloaded a batch ChatGPT search job.

## Skip polling with webhooks

If you don't want to poll for status, add an `endpoint` parameter to receive results automatically:

```bash theme={null}
curl -X POST \
  "https://api.brightdata.com/datasets/v3/trigger?dataset_id=gd_m7aof0k82r803d5bjm&format=json&endpoint=https://your-server.com/webhook" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '[{"url": "https://chatgpt.com/", "prompt": "Top hotels in New York"}]'
```

See [How to receive ChatGPT search results via webhooks](/datasets/scrapers/chatgpt/data-delivery/webhooks) for the full setup.

## Limits and constraints

| Constraint                           | Value      |
| :----------------------------------- | :--------- |
| Max input file size                  | 1 GB       |
| Max concurrent batch requests        | 100        |
| Max concurrent single-input requests | 1,500      |
| Webhook delivery size                | Up to 1 GB |
| API download size                    | Up to 5 GB |

## Troubleshooting

<Accordion title="Getting a 429 Too Many Requests error?">
  You've exceeded the concurrent request limit. Reduce the number of parallel requests or combine inputs into fewer, larger batches. Each batch can include up to 1 GB of input data.
</Accordion>

<Accordion title="Snapshot status shows 'failed'?">
  Check that all input objects include a valid `url` (must be `https://chatgpt.com/`) and a non-empty `prompt`. Review the error details in the snapshot response or in the [Logs tab](https://brightdata.com/cp/scrapers) of your Bright Data dashboard.
</Accordion>

<Accordion title="Results are incomplete or missing some prompts?">
  Some prompts may fail individually while the overall job succeeds. Check the snapshot response for any `errors` field. Retry failed prompts in a separate request.
</Accordion>

## Next steps

<CardGroup>
  <Card title="Set up webhooks" icon="webhook" href="/datasets/scrapers/chatgpt/data-delivery/webhooks">
    Receive results without polling.
  </Card>

  <Card title="Deliver to S3" icon="bucket" href="/datasets/scrapers/chatgpt/data-delivery/amazon-s3">
    Send results directly to your S3 bucket.
  </Card>
</CardGroup>


# ChatGPT data delivery to Amazon S3
Source: https://docs.brightdata.com/datasets/scrapers/chatgpt/data-delivery/amazon-s3

Configure the Bright Data ChatGPT Scraper API to deliver scraped prompt responses and citations directly to your Amazon S3 bucket when each job completes.

This guide shows you how to configure the Bright Data ChatGPT Scraper API to deliver scraped data directly to your Amazon S3 bucket when a collection job completes.

## Prerequisites

* A [Bright Data account](https://brightdata.com/cp/start) with an active API key
* An AWS account with an S3 bucket
* IAM credentials with write access to the bucket
* Familiarity with the [async request workflow](/datasets/scrapers/chatgpt/async-requests)

## Step 1: Create an S3 bucket

If you already have a bucket, skip to Step 2.

In the [AWS S3 Console](https://s3.console.aws.amazon.com/s3/buckets):

1. Click **Create bucket**
2. Enter a bucket name (e.g., `chatgpt-scraper-data`)
3. Select your preferred AWS region
4. Keep default settings and click **Create bucket**

## Step 2: Set up IAM permissions

Create an IAM role that grants Bright Data write access to your bucket.

### Create a policy

In the [IAM Console](https://console.aws.amazon.com/iam/), go to **Policies** and create a new policy with this JSON:

```json theme={null}
{
  "Version": "2012-10-17",
  "Statement": [
    {
      "Effect": "Allow",
      "Action": ["s3:PutObject", "s3:GetObject"],
      "Resource": "arn:aws:s3:::chatgpt-scraper-data/*"
    }
  ]
}
```

Replace `chatgpt-scraper-data` with your actual bucket name.

### Create a role for Bright Data

1. Go to **Roles** > **Create role**
2. Select **AWS account** as the trusted entity type
3. Enter Bright Data's AWS account ID: `422310177405`
4. Attach the policy you created above
5. Name the role (e.g., `BrightDataS3Delivery`)
6. Note the role ARN (e.g., `arn:aws:iam::123456789012:role/BrightDataS3Delivery`)

Add an external ID condition to the trust policy:

```json theme={null}
{
  "Version": "2012-10-17",
  "Statement": [
    {
      "Effect": "Allow",
      "Principal": {
        "AWS": "arn:aws:iam::422310177405:role/brd.ec2.zs-dca-delivery"
      },
      "Action": "sts:AssumeRole",
      "Condition": {
        "StringEquals": {
          "sts:ExternalId": "YOUR_BRIGHT_DATA_CUSTOMER_ID"
        }
      }
    }
  ]
}
```

Find your customer ID in [Account settings](https://brightdata.com/cp/setting/customer_details).

## Step 3: Configure delivery in Bright Data

1. Navigate to your [scraper configuration](https://brightdata.com/cp/scrapers)
2. Click the **Delivery settings** tab
3. Select **Amazon S3** as the delivery destination
4. Enter your credentials:
   * **Bucket name**: Your S3 bucket name
   * **Role ARN**: The IAM role ARN from Step 2
   * **Region**: Your S3 bucket region
   * **Path prefix** (optional): A folder path within the bucket (e.g., `chatgpt/search/`)
5. Select your preferred file format (JSON, NDJSON, or CSV)
6. Click **Save**

## Step 4: Trigger a collection

Trigger an async collection. Results are automatically delivered to your S3 bucket:

<CodeGroup>
  ```bash cURL theme={null}
  curl -X POST \
    "https://api.brightdata.com/datasets/v3/trigger?dataset_id=gd_m7aof0k82r803d5bjm&format=json" \
    -H "Authorization: Bearer YOUR_API_KEY" \
    -H "Content-Type: application/json" \
    -d '[
      {"url": "https://chatgpt.com/", "prompt": "Top hotels in New York"},
      {"url": "https://chatgpt.com/", "prompt": "Best restaurants in Paris"},
      {"url": "https://chatgpt.com/", "prompt": "Things to do in Tokyo"}
    ]'
  ```

  ```python Python theme={null}
  import requests

  response = requests.post(
      "https://api.brightdata.com/datasets/v3/trigger",
      params={"dataset_id": "gd_m7aof0k82r803d5bjm", "format": "json"},
      headers={
          "Authorization": "Bearer YOUR_API_KEY",
          "Content-Type": "application/json",
      },
      json=[
          {"url": "https://chatgpt.com/", "prompt": "Top hotels in New York"},
          {"url": "https://chatgpt.com/", "prompt": "Best restaurants in Paris"},
          {"url": "https://chatgpt.com/", "prompt": "Things to do in Tokyo"},
      ],
  )

  print("Snapshot ID:", response.json()["snapshot_id"])
  ```

  ```javascript Node.js theme={null}
  const response = await fetch(
    "https://api.brightdata.com/datasets/v3/trigger?dataset_id=gd_m7aof0k82r803d5bjm&format=json",
    {
      method: "POST",
      headers: {
        "Authorization": "Bearer YOUR_API_KEY",
        "Content-Type": "application/json",
      },
      body: JSON.stringify([
        { url: "https://chatgpt.com/", prompt: "Top hotels in New York" },
        { url: "https://chatgpt.com/", prompt: "Best restaurants in Paris" },
        { url: "https://chatgpt.com/", prompt: "Things to do in Tokyo" },
      ]),
    }
  );

  const data = await response.json();
  console.log("Snapshot ID:", data.snapshot_id);
  ```
</CodeGroup>

## Step 5: Verify delivery

Once the collection completes, check your S3 bucket for the delivered file:

```bash theme={null}
aws s3 ls s3://chatgpt-scraper-data/chatgpt/search/
```

You should see a file named with the snapshot ID (e.g., `s_m1a2b3c4d5e6f7g8h.json`).

Download and inspect it:

```bash theme={null}
aws s3 cp s3://chatgpt-scraper-data/chatgpt/search/s_m1a2b3c4d5e6f7g8h.json ./results.json
cat results.json | python -m json.tool | head -20
```

You can also verify delivery status using the [Monitor Delivery API](/api-reference/scrapers/management-apis/monitor-delivery).

## Troubleshooting

<Accordion title="Files not appearing in S3?">
  * Verify the IAM role ARN and external ID are correct
  * Check that the bucket policy allows `s3:PutObject` from Bright Data's account
  * Ensure the bucket region matches your configuration
  * Review delivery status in the Bright Data dashboard under **Logs**
</Accordion>

<Accordion title="Access denied errors?">
  Verify the trust policy on your IAM role includes Bright Data's account (`422310177405`) and your external ID matches your Bright Data customer ID found in [Account settings](https://brightdata.com/cp/setting/customer_details).
</Accordion>

<Accordion title="Delivered file is empty or missing records?">
  Check the collection status in the Bright Data dashboard. If some prompts failed, the delivered file contains only successful results. Retry failed prompts in a separate request.
</Accordion>

## Next steps

<CardGroup>
  <Card title="Set up webhooks" icon="webhook" href="/datasets/scrapers/chatgpt/data-delivery/webhooks">
    Receive results at your HTTP endpoint.
  </Card>

  <Card title="All delivery options" icon="truck" href="/datasets/scrapers/scrapers-library/delivery-options">
    Snowflake, Azure, GCS, SFTP, and more.
  </Card>
</CardGroup>


# ChatGPT data delivery via webhook
Source: https://docs.brightdata.com/datasets/scrapers/chatgpt/data-delivery/webhooks

Configure webhook delivery to receive scraped ChatGPT search data at your HTTP endpoint as soon as the collection completes. Returns up to 1 GB per response.

This guide shows you how to set up webhook delivery so your server receives scraped ChatGPT search data automatically when a collection job finishes.

## Prerequisites

* A [Bright Data account](https://brightdata.com/cp/start) with an active API key
* Familiarity with the [async request workflow](/datasets/scrapers/chatgpt/async-requests)
* A publicly accessible HTTP endpoint (or a testing tool like [webhook.site](https://webhook.site))

## How webhooks work

When you trigger an async collection with an `endpoint` URL, Bright Data sends a `POST` request to that URL with the scraped data once the job completes. No polling required.

```text theme={null}
Your app --> POST /trigger (with webhook URL) --> Bright Data scrapes --> POST to your webhook
```

## Step 1: Set up a test webhook

For testing, use [webhook.site](https://webhook.site) to get a temporary public URL:

1. Open [webhook.site](https://webhook.site) in your browser
2. Copy the unique URL displayed (e.g., `https://webhook.site/abc-123-def`)
3. Keep the page open to monitor incoming requests

## Step 2: Trigger a collection with the webhook URL

Add the `endpoint` query parameter to your async `/trigger` request:

<CodeGroup>
  ```bash cURL theme={null}
  curl -X POST \
    "https://api.brightdata.com/datasets/v3/trigger?dataset_id=gd_m7aof0k82r803d5bjm&format=json&endpoint=https://webhook.site/abc-123-def&uncompressed_webhook=true" \
    -H "Authorization: Bearer YOUR_API_KEY" \
    -H "Content-Type: application/json" \
    -d '[
      {"url": "https://chatgpt.com/", "prompt": "Top hotels in New York"},
      {"url": "https://chatgpt.com/", "prompt": "Best restaurants in Paris"}
    ]'
  ```

  ```python Python theme={null}
  import requests

  WEBHOOK_URL = "https://webhook.site/abc-123-def"

  response = requests.post(
      "https://api.brightdata.com/datasets/v3/trigger",
      params={
          "dataset_id": "gd_m7aof0k82r803d5bjm",
          "format": "json",
          "webhook": WEBHOOK_URL,
          "uncompressed_webhook": "true",
      },
      headers={
          "Authorization": "Bearer YOUR_API_KEY",
          "Content-Type": "application/json",
      },
      json=[
          {"url": "https://chatgpt.com/", "prompt": "Top hotels in New York"},
          {"url": "https://chatgpt.com/", "prompt": "Best restaurants in Paris"},
      ],
  )

  print("Snapshot ID:", response.json()["snapshot_id"])
  ```

  ```javascript Node.js theme={null}
  const WEBHOOK_URL = "https://webhook.site/abc-123-def";

  const response = await fetch(
    `https://api.brightdata.com/datasets/v3/trigger?dataset_id=gd_m7aof0k82r803d5bjm&format=json&endpoint=${encodeURIComponent(WEBHOOK_URL)}&uncompressed_webhook=true`,
    {
      method: "POST",
      headers: {
        "Authorization": "Bearer YOUR_API_KEY",
        "Content-Type": "application/json",
      },
      body: JSON.stringify([
        { url: "https://chatgpt.com/", prompt: "Top hotels in New York" },
        { url: "https://chatgpt.com/", prompt: "Best restaurants in Paris" },
      ]),
    }
  );

  const data = await response.json();
  console.log("Snapshot ID:", data.snapshot_id);
  ```
</CodeGroup>

Key parameters:

| Parameter              | Description                                                  |
| :--------------------- | :----------------------------------------------------------- |
| `endpoint`             | Your HTTP endpoint URL that receives the `POST` payload      |
| `uncompressed_webhook` | Set to `true` to receive uncompressed JSON (default is gzip) |
| `format`               | Output format: `json`, `ndjson`, or `csv`                    |

## Step 3: Verify delivery

Once the collection completes (typically 30-60 seconds for a few prompts), check your webhook.site page. You should see a `POST` request with the scraped data.

The payload is the same JSON array you would receive from a direct API download:

```json theme={null}
[
  {
    "url": "https://chatgpt.com/",
    "prompt": "Top hotels in New York",
    "answer_text": "Here are some of the top-rated hotels in New York City...",
    "model": "gpt-4o",
    "web_search_triggered": true,
    "citations": [
      {
        "title": "Best Hotels in NYC",
        "url": "https://example.com/nyc-hotels",
        "position": 1
      }
    ]
  },
  {
    "url": "https://chatgpt.com/",
    "prompt": "Best restaurants in Paris",
    "answer_text": "Paris is renowned for its culinary scene...",
    "model": "gpt-4o",
    "web_search_triggered": true,
    "citations": [
      {
        "title": "Top Paris Restaurants",
        "url": "https://example.com/paris-restaurants",
        "position": 1
      }
    ]
  }
]
```

## Production webhook setup

For production, point the `endpoint` URL to your own server endpoint.

### How to handle webhooks in Express.js

```javascript server.js theme={null}
const express = require("express");
const app = express();

app.use(express.json({ limit: "100mb" }));

app.post("/webhook/chatgpt", (req, res) => {
  const results = req.body;
  console.log(`Received ${results.length} search results`);

  for (const result of results) {
    console.log(`- Prompt: ${result.prompt}`);
    console.log(`  Citations: ${result.citations?.length || 0}`);
  }

  res.status(200).json({ received: true });
});

app.listen(3000, () => console.log("Webhook server running on port 3000"));
```

### How to handle webhooks in Flask

```python server.py theme={null}
from flask import Flask, request, jsonify

app = Flask(__name__)

@app.route("/webhook/chatgpt", methods=["POST"])
def handle_webhook():
    results = request.get_json()
    print(f"Received {len(results)} search results")

    for result in results:
        print(f"- Prompt: {result['prompt']}")
        print(f"  Citations: {len(result.get('citations', []))}")

    return jsonify({"received": True}), 200

if __name__ == "__main__":
    app.run(port=3000)
```

<Warning>
  Return a `200` status code within 30 seconds to acknowledge receipt. If your endpoint fails or times out, Bright Data retries delivery.
</Warning>

## Webhook with authorization

If your endpoint requires authentication, add the `webhook_header_Authorization` parameter:

```bash theme={null}
curl -X POST \
  "https://api.brightdata.com/datasets/v3/trigger?dataset_id=gd_m7aof0k82r803d5bjm&format=json&endpoint=https://your-server.com/webhook&webhook_header_Authorization=Bearer+YOUR_SECRET_TOKEN" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '[{"url": "https://chatgpt.com/", "prompt": "Top hotels in New York"}]'
```

## Allowlist webhook IPs

If your server uses an IP allowlist, add the following Bright Data webhook source IPs:

```text theme={null}
54.175.27.69
34.225.9.175
100.28.38.247
100.29.18.195
52.72.185.255
35.174.112.248
54.165.183.124
3.91.140.7
52.202.75.37
98.82.225.117
100.27.150.189
18.214.10.85
35.169.71.210
44.194.183.74
```

## Troubleshooting

<Accordion title="Webhook not receiving data?">
  * Verify the URL is publicly accessible (not `localhost`)
  * Check that your endpoint returns a `200` status code within 30 seconds
  * Verify the webhook IPs above are allowlisted if you have firewall rules
</Accordion>

<Accordion title="Receiving compressed data?">
  If you omit `uncompressed_webhook=true`, data arrives gzip-compressed. Add `uncompressed_webhook=true` to your trigger URL, or decompress the payload on your server.
</Accordion>

<Accordion title="Payload too large for your server?">
  Large collections can produce payloads up to 1 GB. Set `express.json({ limit: "100mb" })` in Express.js or equivalent in your framework. If you need to handle very large datasets, use [S3 delivery](/datasets/scrapers/chatgpt/data-delivery/amazon-s3) instead.
</Accordion>

## Next steps

<CardGroup>
  <Card title="Deliver to Amazon S3" icon="bucket" href="/datasets/scrapers/chatgpt/data-delivery/amazon-s3">
    Store results directly in your S3 bucket.
  </Card>

  <Card title="All delivery options" icon="truck" href="/datasets/scrapers/scrapers-library/delivery-options">
    Snowflake, Azure, GCS, and more.
  </Card>
</CardGroup>


# ChatGPT Scraper API
Source: https://docs.brightdata.com/datasets/scrapers/chatgpt/introduction

Use the Bright Data [ChatGPT Scraper API](https://brightdata.com/products/web-scraper/chatgpt) to extract structured search results, citations and answers. Handles up to 20 inputs per request.

Send a prompt, get structured search results back. The Bright Data ChatGPT Scraper API handles proxies, browser automation, and parsing so you can focus on your data pipeline.

<Tip>
  New to Bright Data? [Create a free account](https://brightdata.com/products/web-scraper/chatgpt?hs_signup=1\&utm_source=docs) and get **5,000 free credits every month**, no credit card required. That's up to **5,000 ChatGPT records** to start scraping. See the [free tier](/general/account/billing-and-pricing/free-tier).
</Tip>

## How it works

You send a prompt to the Bright Data ChatGPT Scraper API. Bright Data handles the scraping infrastructure and returns clean, structured JSON with the answer, citations, and sources.

```text theme={null}
Your app  -->  Bright Data API  -->  Structured JSON
           POST /datasets/v3/scrape
           Authorization: Bearer YOUR_API_KEY
```

All requests use the `dataset_id` for ChatGPT Search and return results in JSON, NDJSON, or CSV.

## What the response looks like

```bash theme={null}
curl -X POST "https://api.brightdata.com/datasets/v3/scrape?dataset_id=gd_m7aof0k82r803d5bjm&format=json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '[{"url": "https://chatgpt.com/", "prompt": "Top hotels in New York"}]'
```

```json theme={null}
{
  "url": "https://chatgpt.com/",
  "prompt": "Top hotels in New York",
  "answer_text": "Here are some of the top-rated hotels in New York City...",
  "model": "gpt-4o",
  "web_search_triggered": true,
  "citations": [
    {
      "title": "Best Hotels in NYC - Travel Guide",
      "url": "https://example.com/nyc-hotels",
      "position": 1
    }
  ],
  "search_sources": [
    {
      "url": "https://example.com/nyc-hotels",
      "title": "Best Hotels in NYC - Travel Guide"
    }
  ],
  "prompt_sent_at": "2026-04-08T12:00:00.000Z"
}
```

## Which capabilities are supported

<CardGroup>
  <Card title="Search with Citations" icon="quote-right" href="/api-reference/scrapers/ai-search-apis/chatgpt-search-by-prompt">
    Get structured answers with source citations, positions, and linked references from ChatGPT web search.
  </Card>

  <Card title="Follow-up Prompts" icon="comments" href="/api-reference/scrapers/ai-search-apis/chatgpt-search-by-prompt">
    Send an additional prompt to get follow-up answers within the same search context.
  </Card>

  <Card title="Shopping and Map Results" icon="store" href="/api-reference/scrapers/ai-search-apis/chatgpt-search-by-prompt">
    Detect when ChatGPT returns shopping product cards or map-based results for location queries.
  </Card>

  <Card title="Web Search Control" icon="globe" href="/datasets/scrapers/concepts/query-fan-out">
    Use `web_search` to allow or disable live web search and `web_search_triggered` to know whether a search actually ran.
  </Card>
</CardGroup>

## Request methods

The Bright Data ChatGPT Scraper API supports two request methods. Choose based on your volume and latency needs.

| Method           | Endpoint                                                   | Best for                                     |
| :--------------- | :--------------------------------------------------------- | :------------------------------------------- |
| **Synchronous**  | [`/scrape`](/datasets/scrapers/chatgpt/send-first-request) | Real-time lookups, up to 20 inputs           |
| **Asynchronous** | [`/trigger`](/datasets/scrapers/chatgpt/async-requests)    | Batch jobs, 20+ inputs, production pipelines |

Learn more in [Understanding sync vs. async requests](/datasets/scrapers/concepts/sync-vs-async).

## Capabilities and limits

| Capability                       | Detail                                                                                                                                                                                                                                   |
| :------------------------------- | :--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Output formats**               | JSON, NDJSON, CSV                                                                                                                                                                                                                        |
| **Max inputs per sync request**  | 20                                                                                                                                                                                                                                       |
| **Max inputs per async request** | 5,000                                                                                                                                                                                                                                    |
| **Max prompt length**            | 4,096 characters                                                                                                                                                                                                                         |
| **Data freshness**               | Real-time (scraped on demand)                                                                                                                                                                                                            |
| **Context between requests**     | None (each request is independent)                                                                                                                                                                                                       |
| **Delivery options**             | API download, [Webhook](/datasets/scrapers/chatgpt/data-delivery/webhooks), [Amazon S3](/datasets/scrapers/chatgpt/data-delivery/amazon-s3), Snowflake, Azure, GCS ([all options](/datasets/scrapers/scrapers-library/delivery-options)) |
| **Pricing**                      | Pay per successful record ([see pricing](https://brightdata.com/pricing/web-scraper))                                                                                                                                                    |

## Common questions

<Accordion title="Is the data scraped in real time?">
  Yes. Each request triggers a live ChatGPT search session. There is no cached or stale data. Response times vary depending on prompt complexity and whether web search is enabled.
</Accordion>

<Accordion title="Can I maintain conversation context across requests?">
  No. Each request starts a fresh ChatGPT session. There is no memory or context carried over between requests. To ask a follow-up question within a single request, use the `additional_prompt` field.
</Accordion>

<Accordion title="How is this different from scraping using proxies or Web Unlocker?">
  When scraping using proxies or Web Unlocker, you still need to write and maintain your own browser automation and parsing logic, and update it whenever ChatGPT changes its interface. The ChatGPT Scraper API handles the entire stack: proxy rotation, anti-bot bypassing, browser automation, and parsing. You simply send a prompt and get clean, structured JSON back with no scraping infrastructure or parser maintenance required on your end.
</Accordion>

## Next steps

<CardGroup>
  <Card title="Quickstart" icon="rocket" href="/datasets/scrapers/chatgpt/quickstart">
    Search ChatGPT with your first prompt in 5 minutes.
  </Card>

  <Card title="Send your first request" icon="bolt" href="/datasets/scrapers/chatgpt/send-first-request">
    Full code examples in cURL, Python, and Node.js.
  </Card>

  <Card title="API reference" icon="code" href="/api-reference/scrapers/ai-search-apis/chatgpt-search-by-prompt">
    Endpoint specs, parameters, and response schemas.
  </Card>
</CardGroup>


# ChatGPT scraper quickstart
Source: https://docs.brightdata.com/datasets/scrapers/chatgpt/quickstart

Set up the Bright Data ChatGPT Scraper API and send your first prompt to receive structured JSON with search results and citations in under 5 minutes.

This tutorial shows you how to send a search prompt to ChatGPT and get structured JSON data using the Bright Data ChatGPT Scraper API.

## Prerequisites

* A [Bright Data account](https://brightdata.com/cp/start) (includes \$2 free credit)
* cURL, Python 3, or Node.js 18+ installed

<Steps>
  <Step title="Get your API key">
    Go to the [user settings page](https://brightdata.com/cp/setting/users) in your Bright Data account and copy your API key.

    If you don't have an account yet, [sign up at brightdata.com](https://brightdata.com/cp/start). New users get \$2 free credit for testing.

    <Warning>
      Your API key is shown only once when created. Copy and store it securely.
    </Warning>
  </Step>

  <Step title="Send a request">
    We'll use the **ChatGPT Search endpoint** with a synchronous request. Replace `YOUR_API_KEY` with your actual token:

    <CodeGroup>
      ```bash cURL theme={null}
      curl -X POST \
        "https://api.brightdata.com/datasets/v3/scrape?dataset_id=gd_m7aof0k82r803d5bjm&format=json" \
        -H "Authorization: Bearer YOUR_API_KEY" \
        -H "Content-Type: application/json" \
        -d '[{"url": "https://chatgpt.com/", "prompt": "Top hotels in New York"}]'
      ```

      ```python Python theme={null}
      import requests

      response = requests.post(
          "https://api.brightdata.com/datasets/v3/scrape",
          params={"dataset_id": "gd_m7aof0k82r803d5bjm", "format": "json"},
          headers={
              "Authorization": "Bearer YOUR_API_KEY",
              "Content-Type": "application/json",
          },
          json=[{"url": "https://chatgpt.com/", "prompt": "Top hotels in New York"}],
      )

      print(response.json())
      ```

      ```javascript Node.js theme={null}
      const response = await fetch(
        "https://api.brightdata.com/datasets/v3/scrape?dataset_id=gd_m7aof0k82r803d5bjm&format=json",
        {
          method: "POST",
          headers: {
            "Authorization": "Bearer YOUR_API_KEY",
            "Content-Type": "application/json",
          },
          body: JSON.stringify([
            { url: "https://chatgpt.com/", prompt: "Top hotels in New York" }
          ]),
        }
      );

      const data = await response.json();
      console.log(data);
      ```
    </CodeGroup>

    You should see a `200` status code. This takes 15-45 seconds.
  </Step>

  <Step title="Review the response">
    The Bright Data ChatGPT Scraper API returns a JSON array with structured search data:

    ```json theme={null}
    [
      {
        "url": "https://chatgpt.com/",
        "prompt": "Top hotels in New York",
        "answer_text": "Here are some of the top-rated hotels in New York City...",
        "model": "gpt-4o",
        "web_search_triggered": true,
        "citations": [
          {
            "title": "Best Hotels in NYC - Travel Guide",
            "url": "https://example.com/nyc-hotels",
            "position": 1
          }
        ],
        "search_sources": [
          {
            "url": "https://example.com/nyc-hotels",
            "title": "Best Hotels in NYC - Travel Guide"
          }
        ],
        "prompt_sent_at": "2026-04-08T12:00:00.000Z"
      }
    ]
    ```

    Each result object includes the answer text, citations with source URLs, and metadata. See the [full response schema](/api-reference/scrapers/ai-search-apis/chatgpt-search-by-prompt).
  </Step>
</Steps>

You've successfully searched ChatGPT with your first prompt using the Bright Data ChatGPT Scraper API.

## Common questions

<Accordion title="Can I send multiple prompts in one request?">
  Yes. Add more objects to the input array. Synchronous requests support up to 20 inputs. For larger batches, use the [async `/trigger` endpoint](/datasets/scrapers/chatgpt/async-requests).

  ```json theme={null}
  [
    {"url": "https://chatgpt.com/", "prompt": "Top hotels in New York"},
    {"url": "https://chatgpt.com/", "prompt": "Best restaurants in Paris"},
    {"url": "https://chatgpt.com/", "prompt": "Things to do in Tokyo"}
  ]
  ```
</Accordion>

<Accordion title="Getting a 401 or 403 error?">
  Verify your API key is correct and hasn't expired. Generate a new token from [Account settings](https://brightdata.com/cp/setting/users). See the [authentication guide](/api-reference/authentication) for details.
</Accordion>

<Accordion title="Request is timing out?">
  Synchronous requests have a 1-minute timeout. If the request exceeds this limit, it automatically switches to async and returns a `snapshot_id`. Use the [async workflow](/datasets/scrapers/chatgpt/async-requests) for large batches.
</Accordion>

<Accordion title="Empty or partial response data?">
  Verify that the `url` field is set to `https://chatgpt.com/` and the `prompt` field is not empty. Prompts must be 4,096 characters or fewer.
</Accordion>

## Next steps

<CardGroup>
  <Card title="Send your first request" icon="bolt" href="/datasets/scrapers/chatgpt/send-first-request">
    Explore input options with full code examples.
  </Card>

  <Card title="Async batch requests" icon="layer-group" href="/datasets/scrapers/chatgpt/async-requests">
    Search ChatGPT with hundreds of prompts in a single batch job.
  </Card>

  <Card title="Set up webhooks" icon="webhook" href="/datasets/scrapers/chatgpt/data-delivery/webhooks">
    Receive results automatically when scraping completes.
  </Card>
</CardGroup>


# Send your first ChatGPT search request
Source: https://docs.brightdata.com/datasets/scrapers/chatgpt/send-first-request

Make synchronous requests to the Bright Data ChatGPT Scraper API with copy-paste examples for search, targeting across 195 countries and follow-up prompts.

This tutorial walks you through sending synchronous requests to the Bright Data ChatGPT Scraper API. By the end, you'll have working examples for basic search, country-targeted search, and follow-up prompts.

## Prerequisites

* A [Bright Data account](https://brightdata.com/cp/start) with an active API key
* Completed the [Quickstart](/datasets/scrapers/chatgpt/quickstart)

## Request structure

Every synchronous request follows the same pattern:

```http theme={null}
POST https://api.brightdata.com/datasets/v3/scrape?dataset_id=gd_m7aof0k82r803d5bjm&format=json
Authorization: Bearer YOUR_API_KEY
Content-Type: application/json

[{"url": "https://chatgpt.com/", "prompt": "Your search prompt here"}]
```

The `url` field is always `https://chatgpt.com/`. The `prompt` field contains your search query.

<Note>
  Synchronous requests support up to 20 inputs and have a 1-minute timeout. If the request takes longer, the API automatically returns a `snapshot_id` instead. See [async requests](/datasets/scrapers/chatgpt/async-requests).
</Note>

## How to scrape ChatGPT Search

**Dataset ID:** `gd_m7aof0k82r803d5bjm`

### How to send a basic search

Send a prompt and get a structured answer with citations:

```bash theme={null}
curl -X POST \
  "https://api.brightdata.com/datasets/v3/scrape?dataset_id=gd_m7aof0k82r803d5bjm&format=json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '[{"url": "https://chatgpt.com/", "prompt": "Top hotels in New York"}]'
```

You should see a `200` response. This takes 15-45 seconds.

<Accordion title="Example response">
  ```json theme={null}
  [
    {
      "url": "https://chatgpt.com/",
      "prompt": "Top hotels in New York",
      "answer_text": "Here are some of the top-rated hotels in New York City...",
      "answer_text_markdown": "Here are some of the top-rated hotels in **New York City**...",
      "model": "gpt-4o",
      "web_search_triggered": true,
      "is_map": false,
      "shopping_visible": false,
      "citations": [
        {
          "title": "Best Hotels in NYC - Travel Guide",
          "url": "https://example.com/nyc-hotels",
          "position": 1
        }
      ],
      "search_sources": [
        {
          "url": "https://example.com/nyc-hotels",
          "title": "Best Hotels in NYC - Travel Guide"
        }
      ],
      "links_attached": [
        {
          "url": "https://example.com/nyc-hotels",
          "text": "Travel Guide"
        }
      ],
      "recommendations": [],
      "references": [],
      "prompt_sent_at": "2026-04-08T12:00:00.000Z"
    }
  ]
  ```
</Accordion>

### Search with country targeting

Use the `country` field to get location-specific results:

```bash theme={null}
curl -X POST \
  "https://api.brightdata.com/datasets/v3/scrape?dataset_id=gd_m7aof0k82r803d5bjm&format=json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '[{"url": "https://chatgpt.com/", "prompt": "Best local restaurants", "country": "JP"}]'
```

<Accordion title="Example response">
  ```json theme={null}
  [
    {
      "url": "https://chatgpt.com/",
      "prompt": "Best local restaurants",
      "answer_text": "Here are some highly recommended local restaurants in Japan...",
      "model": "gpt-4o",
      "web_search_triggered": true,
      "is_map": true,
      "citations": [
        {
          "title": "Top Restaurants in Tokyo",
          "url": "https://example.com/tokyo-restaurants",
          "position": 1
        }
      ],
      "prompt_sent_at": "2026-04-08T12:05:00.000Z"
    }
  ]
  ```
</Accordion>

### Search with follow-up prompt

Use the `additional_prompt` field to ask a follow-up question in the same session:

```bash theme={null}
curl -X POST \
  "https://api.brightdata.com/datasets/v3/scrape?dataset_id=gd_m7aof0k82r803d5bjm&format=json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '[{"url": "https://chatgpt.com/", "prompt": "Top hotels in New York", "additional_prompt": "Which of these are pet-friendly?"}]'
```

<Accordion title="Example response">
  ```json theme={null}
  [
    {
      "url": "https://chatgpt.com/",
      "prompt": "Top hotels in New York",
      "answer_text": "Here are some of the top-rated hotels in New York City...",
      "additional_answer_text": "Among the hotels listed, the following are pet-friendly...",
      "model": "gpt-4o",
      "web_search_triggered": true,
      "citations": [
        {
          "title": "Pet-Friendly Hotels NYC",
          "url": "https://example.com/pet-friendly-nyc",
          "position": 1
        }
      ],
      "prompt_sent_at": "2026-04-08T12:10:00.000Z"
    }
  ]
  ```
</Accordion>

[Full ChatGPT Search response schema](/api-reference/scrapers/ai-search-apis/chatgpt-search-by-prompt)

## Quick reference: dataset ID

| Endpoint       | Dataset ID              | Input            |
| :------------- | :---------------------- | :--------------- |
| ChatGPT Search | `gd_m7aof0k82r803d5bjm` | `url` + `prompt` |

## Input fields

| Field               | Required | Description                                                                                                                                                                                                                                                                        |
| :------------------ | :------- | :--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `url`               | Yes      | Always `https://chatgpt.com/`                                                                                                                                                                                                                                                      |
| `prompt`            | Yes      | Search prompt (max 4,096 characters)                                                                                                                                                                                                                                               |
| `country`           | No       | Country code for location-targeted results                                                                                                                                                                                                                                         |
| `index`             | No       | Unique tracking ID (number)                                                                                                                                                                                                                                                        |
| `require_sources`   | No       | Return error if no sources found (boolean)                                                                                                                                                                                                                                         |
| `additional_prompt` | No       | Follow-up prompt within the same session                                                                                                                                                                                                                                           |
| `web_search`        | No       | Enable or disable web search during the run (default: `true`). This is a **permission, not a guarantee**: read `web_search_triggered` in the response to know whether a search actually ran. See [Query fan-out and web search control](/datasets/scrapers/concepts/query-fan-out) |

## Output fields (web search signals)

| Field                  | Type    | Always returned | Meaning                                                                                                       |
| :--------------------- | :------ | :-------------- | :------------------------------------------------------------------------------------------------------------ |
| `web_search`           | boolean | No              | Echoes the input value (defaults to `true` if omitted). Does not indicate whether a search actually happened. |
| `web_search_triggered` | boolean | Yes             | `true` only if the model actually triggered a web search during the run; `false` otherwise.                   |

<Note>
  Do not use prompt-derived output fields like `is_map`, `citations`, or `shopping_visible` as proof that a web search ran. Those fields depend on the prompt and the model's response format. Use `web_search_triggered` as the canonical signal. Full rules in [Query fan-out and web search control](/datasets/scrapers/concepts/query-fan-out).
</Note>

## Output formats

Control the response format with the `format` query parameter:

| Value    | Description                                 |
| :------- | :------------------------------------------ |
| `json`   | JSON array (default)                        |
| `ndjson` | Newline-delimited JSON, one record per line |
| `csv`    | Comma-separated values                      |

## Next steps

<CardGroup>
  <Card title="Async batch requests" icon="layer-group" href="/datasets/scrapers/chatgpt/async-requests">
    Search ChatGPT with hundreds of prompts in a single batch job.
  </Card>

  <Card title="API reference" icon="code" href="/api-reference/scrapers/ai-search-apis/chatgpt-search-by-prompt">
    Full parameter and response field reference.
  </Card>
</CardGroup>


# Understanding sync vs. async requests
Source: https://docs.brightdata.com/datasets/scrapers/concepts/sync-vs-async

Choose between synchronous and asynchronous Bright Data Scraper API requests. Sync supports up to 20 URLs per request; async supports up to 1 GB input.

The Bright Data Scraper APIs offer two methods for collecting data. This guide explains the difference and helps you choose the right approach for your use case.

## What are sync and async requests?

**Synchronous (`/scrape`)** sends a request and waits for the scraped data in the same HTTP response. The connection stays open until results are ready.

**Asynchronous (`/trigger`)** sends a request, immediately receives a `snapshot_id`, and collects the results later via polling, webhook, or external storage delivery.

## When to use each approach

**Use synchronous requests when:**

* You need real-time results for a small number of URLs (1-20)
* You are building an interactive application that waits for data
* You want the simplest integration with no background job management

**Use asynchronous requests when:**

* You are scraping more than 20 URLs in a batch
* You are running discovery queries (search by keyword, find posts by company)
* You want results delivered to a webhook or external storage (S3, Snowflake)
* You are building production pipelines that need reliability and retry handling

## How they compare

| Feature                  | Sync `/scrape`                    | Async `/trigger`                          |
| :----------------------- | :-------------------------------- | :---------------------------------------- |
| **Max URLs per request** | 20                                | Unlimited (up to 1 GB input)              |
| **Response**             | Scraped data directly             | `snapshot_id` (data retrieved separately) |
| **Timeout**              | 1 minute (auto-switches to async) | No timeout                                |
| **Discovery support**    | No                                | Yes                                       |
| **Webhook delivery**     | No                                | Yes                                       |
| **External storage**     | No                                | Yes                                       |
| **Concurrency limit**    | 1,500 requests                    | 100 requests                              |
| **Ideal for**            | Quick lookups, real-time apps     | Batch jobs, production pipelines          |

## Synchronous request flow

```text theme={null}
Your app --> POST /scrape --> [Wait 10-30s] --> Scraped data in response
```

The entire operation happens in a single HTTP request. If the scraping takes longer than 1 minute, the API automatically converts it to an async job and returns a `snapshot_id` instead.

<Tip>
  If you receive a `snapshot_id` instead of data from a sync request, your request was auto-converted. Use the async retrieval workflow to download results.
</Tip>

## Asynchronous request flow

```text theme={null}
Your app --> POST /trigger --> snapshot_id (immediate)
                                    |
                     +--------------+--------------+
                     |              |              |
                  Poll API      Webhook      S3/Storage
                     |              |              |
                  GET /snapshot  POST to URL   File in bucket
```

The async flow decouples triggering from retrieval. You have three options for getting results:

1. **Poll the API** - Check status with `GET /progress/{snapshot_id}`, then download with `GET /snapshot/{snapshot_id}`
2. **Webhook** - Bright Data sends results to your URL when the job completes
3. **External storage** - Results are delivered to S3, Snowflake, or other storage

## When to use each mode

**Single-page lookup**
Your app needs data from one URL in real-time (e.g., enriching a lead, checking a product page). Use **sync**. One URL, instant results, simple integration.

**Weekly batch report**
Every Monday, you scrape 500 pages matching search criteria across multiple sources. Use **async** with discovery. Deliver results to S3 for your data pipeline.

**Real-time app with background enrichment**
A user triggers a search, and you display initial results immediately. Use **sync** for the first lookup, then **async** with a webhook to collect additional data in the background.

**Nightly competitor monitoring**
Every night, you scrape hundreds of competitor pages. Use **async** with S3 delivery. No polling needed, data appears in your bucket.

## Common misconceptions

<Accordion title="Async is always faster than sync">
  Not true. For 1-5 URLs, synchronous requests are faster because there is no job scheduling overhead. Async adds a queue step before scraping begins. Use sync for small, real-time lookups.
</Accordion>

<Accordion title="Sync requests fail if they take too long">
  They don't fail. If a sync request exceeds the 1-minute timeout, the Bright Data API automatically converts it to an async job and returns a `snapshot_id`. Your data is still collected. You just need to retrieve it using the async flow.
</Accordion>

## Handling auto-conversion in your code

If a synchronous request exceeds the 1-minute timeout, the API returns a `snapshot_id` instead of data. Handle both cases:

```python Python theme={null}
import requests

response = requests.post(
    "https://api.brightdata.com/datasets/v3/scrape",
    params={"dataset_id": "DATASET_ID", "format": "json"},
    headers={"Authorization": "Bearer YOUR_API_KEY"},
    json=[{"url": "https://example.com/target-page"}],
)

data = response.json()

if isinstance(data, list):
    # Sync response: data is ready
    print(f"Got {len(data)} results")
elif isinstance(data, dict) and "snapshot_id" in data:
    # Auto-converted to async: poll for results
    print(f"Job running. Snapshot ID: {data['snapshot_id']}")
```

## Common questions

<Accordion title="Can I mix sync and async in the same application?">
  Yes. Many applications use sync for real-time user-facing lookups and async for batch background jobs. Use the method that fits each use case.
</Accordion>

<Accordion title="What happens if my webhook is down when async results are ready?">
  Bright Data retries webhook delivery if your endpoint returns a non-200 status or times out. If you need guaranteed delivery, use S3 or another external storage option.
</Accordion>

<Accordion title="Is there a cost difference between sync and async?">
  No. Pricing is per successful record regardless of the request method. The choice between sync and async is about volume, latency, and delivery preferences, not cost.
</Accordion>

## Next steps

<CardGroup>
  <Card title="Scraper APIs overview" icon="grid-2" href="/datasets/scrapers">
    Browse all available Bright Data Scraper APIs.
  </Card>

  <Card title="Delivery options" icon="truck" href="/datasets/scrapers/scrapers-library/delivery-options">
    Webhook, S3, Snowflake, Azure, and more.
  </Card>
</CardGroup>


# Async batch requests for Facebook
Source: https://docs.brightdata.com/datasets/scrapers/facebook/async-requests

Trigger large-scale Facebook scraping jobs, monitor progress, and retrieve results using the Bright Data async /trigger endpoint. Supports batches of 20 URLs.

This guide shows you how to scrape Facebook data at scale using the asynchronous `/trigger` endpoint. Use this when you have more than 20 URLs, need discovery, or want delivery to a webhook or S3.

<Tip>
  Not sure whether to use sync or async? Read [Understanding sync vs. async requests](/datasets/scrapers/concepts/sync-vs-async).
</Tip>

## Prerequisites

* A [Bright Data account](https://brightdata.com/cp/start) with an active API key
* Familiarity with the [synchronous request flow](/datasets/scrapers/facebook/send-first-request)

## Step 1: Trigger the collection

Send a `POST` request to the `/trigger` endpoint with your input URLs:

<CodeGroup>
  ```bash cURL theme={null}
  curl -X POST \
    "https://api.brightdata.com/datasets/v3/trigger?dataset_id=gd_mf0urb782734ik94dz&format=json" \
    -H "Authorization: Bearer YOUR_API_KEY" \
    -H "Content-Type: application/json" \
    -d '[
      {"url": "https://www.facebook.com/zuck"},
      {"url": "https://www.facebook.com/NASA"},
      {"url": "https://www.facebook.com/natgeo"},
      {"url": "https://www.facebook.com/nike"},
      {"url": "https://www.facebook.com/cristiano"}
    ]'
  ```

  ```python Python theme={null}
  import requests

  response = requests.post(
      "https://api.brightdata.com/datasets/v3/trigger",
      params={
          "dataset_id": "gd_mf0urb782734ik94dz",
          "format": "json",
      },
      headers={
          "Authorization": "Bearer YOUR_API_KEY",
          "Content-Type": "application/json",
      },
      json=[
          {"url": "https://www.facebook.com/zuck"},
          {"url": "https://www.facebook.com/NASA"},
          {"url": "https://www.facebook.com/natgeo"},
          {"url": "https://www.facebook.com/nike"},
          {"url": "https://www.facebook.com/cristiano"},
      ],
  )

  snapshot = response.json()
  print("Snapshot ID:", snapshot["snapshot_id"])
  ```

  ```javascript Node.js theme={null}
  const response = await fetch(
    "https://api.brightdata.com/datasets/v3/trigger?dataset_id=gd_mf0urb782734ik94dz&format=json",
    {
      method: "POST",
      headers: {
        "Authorization": "Bearer YOUR_API_KEY",
        "Content-Type": "application/json",
      },
      body: JSON.stringify([
        { url: "https://www.facebook.com/zuck" },
        { url: "https://www.facebook.com/NASA" },
        { url: "https://www.facebook.com/natgeo" },
        { url: "https://www.facebook.com/nike" },
        { url: "https://www.facebook.com/cristiano" },
      ]),
    }
  );

  const snapshot = await response.json();
  console.log("Snapshot ID:", snapshot.snapshot_id);
  ```
</CodeGroup>

You should see a `200` response with a `snapshot_id`:

```json theme={null}
{
  "snapshot_id": "s_m1a2b3c4d5e6f7g8h"
}
```

Save this ID. You need it to check progress and download results.

## Step 2: Monitor progress

Poll the snapshot status until it shows `ready`. This takes 30 seconds to several minutes depending on the number of URLs.

<CodeGroup>
  ```bash cURL theme={null}
  curl "https://api.brightdata.com/datasets/v3/progress/s_m1a2b3c4d5e6f7g8h" \
    -H "Authorization: Bearer YOUR_API_KEY"
  ```

  ```python Python theme={null}
  import time

  snapshot_id = "s_m1a2b3c4d5e6f7g8h"

  while True:
      status_response = requests.get(
          f"https://api.brightdata.com/datasets/v3/progress/{snapshot_id}",
          headers={"Authorization": "Bearer YOUR_API_KEY"},
      )
      status = status_response.json().get("status")
      print(f"Status: {status}")

      if status == "ready":
          break
      time.sleep(10)
  ```

  ```javascript Node.js theme={null}
  const snapshotId = "s_m1a2b3c4d5e6f7g8h";

  let status = "collecting";
  while (status !== "ready") {
    const statusResponse = await fetch(
      `https://api.brightdata.com/datasets/v3/progress/${snapshotId}`,
      { headers: { "Authorization": "Bearer YOUR_API_KEY" } }
    );
    const statusData = await statusResponse.json();
    status = statusData.status;
    console.log("Status:", status);

    if (status !== "ready") {
      await new Promise((r) => setTimeout(r, 10000));
    }
  }
  ```
</CodeGroup>

Status values:

| Status       | Meaning                             |
| :----------- | :---------------------------------- |
| `collecting` | Scraping is in progress             |
| `digesting`  | Data is being processed             |
| `ready`      | Results are available for download  |
| `failed`     | The collection encountered an error |

## Step 3: Download results

Once the status is `ready`, download the scraped data:

<CodeGroup>
  ```bash cURL theme={null}
  curl "https://api.brightdata.com/datasets/v3/snapshot/s_m1a2b3c4d5e6f7g8h?format=json" \
    -H "Authorization: Bearer YOUR_API_KEY" \
    -o results.json
  ```

  ```python Python theme={null}
  results_response = requests.get(
      f"https://api.brightdata.com/datasets/v3/snapshot/{snapshot_id}",
      params={"format": "json"},
      headers={"Authorization": "Bearer YOUR_API_KEY"},
  )

  results = results_response.json()
  print(f"Collected {len(results)} profiles")
  ```

  ```javascript Node.js theme={null}
  const resultsResponse = await fetch(
    `https://api.brightdata.com/datasets/v3/snapshot/${snapshotId}?format=json`,
    { headers: { "Authorization": "Bearer YOUR_API_KEY" } }
  );

  const results = await resultsResponse.json();
  console.log(`Collected ${results.length} profiles`);
  ```
</CodeGroup>

You've successfully triggered, monitored, and downloaded a batch Facebook scraping job.

## Skip polling with webhooks

If you don't want to poll for status, add an `endpoint` parameter to receive results automatically:

```bash theme={null}
curl -X POST \
  "https://api.brightdata.com/datasets/v3/trigger?dataset_id=gd_mf0urb782734ik94dz&format=json&endpoint=https://your-server.com/webhook" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '[{"url": "https://www.facebook.com/zuck"}]'
```

See [How to receive Facebook data via webhooks](/datasets/scrapers/facebook/data-delivery/webhooks) for the full setup.

## Limits and constraints

| Constraint                           | Value      |
| :----------------------------------- | :--------- |
| Max input file size                  | 1 GB       |
| Max concurrent batch requests        | 100        |
| Max concurrent single-input requests | 1,500      |
| Webhook delivery size                | Up to 1 GB |
| API download size                    | Up to 5 GB |

## Troubleshooting

<Accordion title="Getting a 429 Too Many Requests error?">
  You've exceeded the concurrent request limit. Reduce the number of parallel requests or combine inputs into fewer, larger batches. Each batch can include up to 1 GB of input data.
</Accordion>

<Accordion title="Snapshot status shows 'failed'?">
  Check that all input URLs are valid Facebook URLs. Review the error details in the snapshot response or in the [Logs tab](https://brightdata.com/cp/scrapers) of your Bright Data dashboard.
</Accordion>

<Accordion title="Results are incomplete or missing some URLs?">
  Some URLs may fail individually while the overall job succeeds. Check the snapshot response for any `errors` field. Retry failed URLs in a separate request.
</Accordion>

## Next steps

<CardGroup>
  <Card title="Set up webhooks" icon="webhook" href="/datasets/scrapers/facebook/data-delivery/webhooks">
    Receive results without polling.
  </Card>

  <Card title="Deliver to S3" icon="bucket" href="/datasets/scrapers/facebook/data-delivery/amazon-s3">
    Send results directly to your S3 bucket.
  </Card>
</CardGroup>


# Facebook data delivery to Amazon S3
Source: https://docs.brightdata.com/datasets/scrapers/facebook/data-delivery/amazon-s3

Configure the Bright Data Facebook Scraper API to deliver scraped profiles, posts and marketplace data directly to your Amazon S3 bucket on job completion.

This guide shows you how to configure the Bright Data Facebook Scraper API to deliver scraped data directly to your Amazon S3 bucket when a collection job completes.

## Prerequisites

* A [Bright Data account](https://brightdata.com/cp/start) with an active API key
* An AWS account with an S3 bucket
* IAM credentials with write access to the bucket
* Familiarity with the [async request workflow](/datasets/scrapers/facebook/async-requests)

## Step 1: Create an S3 bucket

If you already have a bucket, skip to Step 2.

In the [AWS S3 Console](https://s3.console.aws.amazon.com/s3/buckets):

1. Click **Create bucket**
2. Enter a bucket name (e.g., `facebook-scraper-data`)
3. Select your preferred AWS region
4. Keep default settings and click **Create bucket**

## Step 2: Set up IAM permissions

Create an IAM role that grants Bright Data write access to your bucket.

### Create a policy

In the [IAM Console](https://console.aws.amazon.com/iam/), go to **Policies** and create a new policy with this JSON:

```json theme={null}
{
  "Version": "2012-10-17",
  "Statement": [
    {
      "Effect": "Allow",
      "Action": ["s3:PutObject", "s3:GetObject"],
      "Resource": "arn:aws:s3:::facebook-scraper-data/*"
    }
  ]
}
```

Replace `facebook-scraper-data` with your actual bucket name.

### Create a role for Bright Data

1. Go to **Roles** > **Create role**
2. Select **AWS account** as the trusted entity type
3. Enter Bright Data's AWS account ID: `422310177405`
4. Attach the policy you created above
5. Name the role (e.g., `BrightDataS3Delivery`)
6. Note the role ARN (e.g., `arn:aws:iam::123456789012:role/BrightDataS3Delivery`)

Add an external ID condition to the trust policy:

```json theme={null}
{
  "Version": "2012-10-17",
  "Statement": [
    {
      "Effect": "Allow",
      "Principal": {
        "AWS": "arn:aws:iam::422310177405:role/brd.ec2.zs-dca-delivery"
      },
      "Action": "sts:AssumeRole",
      "Condition": {
        "StringEquals": {
          "sts:ExternalId": "YOUR_BRIGHT_DATA_CUSTOMER_ID"
        }
      }
    }
  ]
}
```

Find your customer ID in [Account settings](https://brightdata.com/cp/setting/customer_details).

## Step 3: Configure delivery in Bright Data

1. Navigate to your [scraper configuration](https://brightdata.com/cp/scrapers)
2. Click the **Delivery settings** tab
3. Select **Amazon S3** as the delivery destination
4. Enter your credentials:
   * **Bucket name**: Your S3 bucket name
   * **Role ARN**: The IAM role ARN from Step 2
   * **Region**: Your S3 bucket region
   * **Path prefix** (optional): A folder path within the bucket (e.g., `facebook/profiles/`)
5. Select your preferred file format (JSON, NDJSON, or CSV)
6. Click **Save**

## Step 4: Trigger a collection

Trigger an async collection. Results are automatically delivered to your S3 bucket:

<CodeGroup>
  ```bash cURL theme={null}
  curl -X POST \
    "https://api.brightdata.com/datasets/v3/trigger?dataset_id=gd_mf0urb782734ik94dz&format=json" \
    -H "Authorization: Bearer YOUR_API_KEY" \
    -H "Content-Type: application/json" \
    -d '[
      {"url": "https://www.facebook.com/zuck"},
      {"url": "https://www.facebook.com/NASA"},
      {"url": "https://www.facebook.com/natgeo"}
    ]'
  ```

  ```python Python theme={null}
  import requests

  response = requests.post(
      "https://api.brightdata.com/datasets/v3/trigger",
      params={"dataset_id": "gd_mf0urb782734ik94dz", "format": "json"},
      headers={
          "Authorization": "Bearer YOUR_API_KEY",
          "Content-Type": "application/json",
      },
      json=[
          {"url": "https://www.facebook.com/zuck"},
          {"url": "https://www.facebook.com/NASA"},
          {"url": "https://www.facebook.com/natgeo"},
      ],
  )

  print("Snapshot ID:", response.json()["snapshot_id"])
  ```

  ```javascript Node.js theme={null}
  const response = await fetch(
    "https://api.brightdata.com/datasets/v3/trigger?dataset_id=gd_mf0urb782734ik94dz&format=json",
    {
      method: "POST",
      headers: {
        "Authorization": "Bearer YOUR_API_KEY",
        "Content-Type": "application/json",
      },
      body: JSON.stringify([
        { url: "https://www.facebook.com/zuck" },
        { url: "https://www.facebook.com/NASA" },
        { url: "https://www.facebook.com/natgeo" },
      ]),
    }
  );

  const data = await response.json();
  console.log("Snapshot ID:", data.snapshot_id);
  ```
</CodeGroup>

## Step 5: Verify delivery

Once the collection completes, check your S3 bucket for the delivered file:

```bash theme={null}
aws s3 ls s3://facebook-scraper-data/facebook/profiles/
```

You should see a file named with the snapshot ID (e.g., `s_m1a2b3c4d5e6f7g8h.json`).

Download and inspect it:

```bash theme={null}
aws s3 cp s3://facebook-scraper-data/facebook/profiles/s_m1a2b3c4d5e6f7g8h.json ./results.json
cat results.json | python -m json.tool | head -20
```

You can also verify delivery status using the [Monitor Delivery API](/api-reference/scrapers/management-apis/monitor-delivery).

## Troubleshooting

<Accordion title="Files not appearing in S3?">
  * Verify the IAM role ARN and external ID are correct
  * Check that the bucket policy allows `s3:PutObject` from Bright Data's account
  * Ensure the bucket region matches your configuration
  * Review delivery status in the Bright Data dashboard under **Logs**
</Accordion>

<Accordion title="Access denied errors?">
  Verify the trust policy on your IAM role includes Bright Data's account (`422310177405`) and your external ID matches your Bright Data customer ID found in [Account settings](https://brightdata.com/cp/setting/customer_details).
</Accordion>

<Accordion title="Delivered file is empty or missing records?">
  Check the collection status in the Bright Data dashboard. If some URLs failed, the delivered file contains only successful results. Retry failed URLs in a separate request.
</Accordion>

## Next steps

<CardGroup>
  <Card title="Set up webhooks" icon="webhook" href="/datasets/scrapers/facebook/data-delivery/webhooks">
    Receive results at your HTTP endpoint.
  </Card>

  <Card title="All delivery options" icon="truck" href="/datasets/scrapers/scrapers-library/delivery-options">
    Snowflake, Azure, GCS, SFTP, and more.
  </Card>
</CardGroup>


# Facebook data delivery via webhook
Source: https://docs.brightdata.com/datasets/scrapers/facebook/data-delivery/webhooks

Configure the Bright Data Facebook Scraper API to push scraped profiles, posts and comments to your HTTPS webhook as each job completes across 9 endpoints.

This guide shows you how to set up webhook delivery so your server receives scraped Facebook data automatically when a collection job finishes.

## Prerequisites

* A [Bright Data account](https://brightdata.com/cp/start) with an active API key
* Familiarity with the [async request workflow](/datasets/scrapers/facebook/async-requests)
* A publicly accessible HTTP endpoint (or a testing tool like [webhook.site](https://webhook.site))

## How webhooks work

When you trigger an async collection with an `endpoint` URL, Bright Data sends a `POST` request to that URL with the scraped data once the job completes. No polling required.

```text theme={null}
Your app --> POST /trigger (with webhook URL) --> Bright Data scrapes --> POST to your webhook
```

## Step 1: Set up a test webhook

For testing, use [webhook.site](https://webhook.site) to get a temporary public URL:

1. Open [webhook.site](https://webhook.site) in your browser
2. Copy the unique URL displayed (e.g., `https://webhook.site/abc-123-def`)
3. Keep the page open to monitor incoming requests

## Step 2: Trigger a collection with the webhook URL

Add the `endpoint` query parameter to your async `/trigger` request:

<CodeGroup>
  ```bash cURL theme={null}
  curl -X POST \
    "https://api.brightdata.com/datasets/v3/trigger?dataset_id=gd_mf0urb782734ik94dz&format=json&endpoint=https://webhook.site/abc-123-def&uncompressed_webhook=true" \
    -H "Authorization: Bearer YOUR_API_KEY" \
    -H "Content-Type: application/json" \
    -d '[
      {"url": "https://www.facebook.com/zuck"},
      {"url": "https://www.facebook.com/NASA"}
    ]'
  ```

  ```python Python theme={null}
  import requests

  WEBHOOK_URL = "https://webhook.site/abc-123-def"

  response = requests.post(
      "https://api.brightdata.com/datasets/v3/trigger",
      params={
          "dataset_id": "gd_mf0urb782734ik94dz",
          "format": "json",
          "webhook": WEBHOOK_URL,
          "uncompressed_webhook": "true",
      },
      headers={
          "Authorization": "Bearer YOUR_API_KEY",
          "Content-Type": "application/json",
      },
      json=[
          {"url": "https://www.facebook.com/zuck"},
          {"url": "https://www.facebook.com/NASA"},
      ],
  )

  print("Snapshot ID:", response.json()["snapshot_id"])
  ```

  ```javascript Node.js theme={null}
  const WEBHOOK_URL = "https://webhook.site/abc-123-def";

  const response = await fetch(
    `https://api.brightdata.com/datasets/v3/trigger?dataset_id=gd_mf0urb782734ik94dz&format=json&endpoint=${encodeURIComponent(WEBHOOK_URL)}&uncompressed_webhook=true`,
    {
      method: "POST",
      headers: {
        "Authorization": "Bearer YOUR_API_KEY",
        "Content-Type": "application/json",
      },
      body: JSON.stringify([
        { url: "https://www.facebook.com/zuck" },
        { url: "https://www.facebook.com/NASA" },
      ]),
    }
  );

  const data = await response.json();
  console.log("Snapshot ID:", data.snapshot_id);
  ```
</CodeGroup>

Key parameters:

| Parameter              | Description                                                  |
| :--------------------- | :----------------------------------------------------------- |
| `endpoint`             | Your HTTP endpoint URL that receives the `POST` payload      |
| `uncompressed_webhook` | Set to `true` to receive uncompressed JSON (default is gzip) |
| `format`               | Output format: `json`, `ndjson`, or `csv`                    |

## Step 3: Verify delivery

Once the collection completes (typically 30-60 seconds for a few profiles), check your webhook.site page. You should see a `POST` request with the scraped data.

The payload is the same JSON array you would receive from a direct API download:

```json theme={null}
[
  {
    "name": "Mark Zuckerberg",
    "url": "https://www.facebook.com/zuck",
    "followers": 120000000,
    "is_verified": true
  },
  {
    "name": "NASA",
    "url": "https://www.facebook.com/NASA",
    "followers": 25000000,
    "is_verified": true
  }
]
```

## Production webhook setup

For production, point the `endpoint` URL to your own server endpoint.

### How to handle webhooks in Express.js

```javascript server.js theme={null}
const express = require("express");
const app = express();

app.use(express.json({ limit: "100mb" }));

app.post("/webhook/facebook", (req, res) => {
  const profiles = req.body;
  console.log(`Received ${profiles.length} profiles`);

  for (const profile of profiles) {
    console.log(`- ${profile.name} (${profile.followers} followers)`);
  }

  res.status(200).json({ received: true });
});

app.listen(3000, () => console.log("Webhook server running on port 3000"));
```

### How to handle webhooks in Flask

```python server.py theme={null}
from flask import Flask, request, jsonify

app = Flask(__name__)

@app.route("/webhook/facebook", methods=["POST"])
def handle_webhook():
    profiles = request.get_json()
    print(f"Received {len(profiles)} profiles")

    for profile in profiles:
        print(f"- {profile['name']} ({profile.get('followers')} followers)")

    return jsonify({"received": True}), 200

if __name__ == "__main__":
    app.run(port=3000)
```

<Warning>
  Return a `200` status code within 30 seconds to acknowledge receipt. If your endpoint fails or times out, Bright Data retries delivery.
</Warning>

## Webhook with authorization

If your endpoint requires authentication, add the `webhook_header_Authorization` parameter:

```bash theme={null}
curl -X POST \
  "https://api.brightdata.com/datasets/v3/trigger?dataset_id=gd_mf0urb782734ik94dz&format=json&endpoint=https://your-server.com/webhook&webhook_header_Authorization=Bearer+YOUR_SECRET_TOKEN" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '[{"url": "https://www.facebook.com/zuck"}]'
```

## Allowlist webhook IPs

If your server uses an IP allowlist, add the following Bright Data webhook source IPs:

```text theme={null}
54.175.27.69
34.225.9.175
100.28.38.247
100.29.18.195
52.72.185.255
35.174.112.248
54.165.183.124
3.91.140.7
52.202.75.37
98.82.225.117
100.27.150.189
18.214.10.85
35.169.71.210
44.194.183.74
```

## Troubleshooting

<Accordion title="Webhook not receiving data?">
  * Verify the URL is publicly accessible (not `localhost`)
  * Check that your endpoint returns a `200` status code within 30 seconds
  * Verify the webhook IPs above are allowlisted if you have firewall rules
</Accordion>

<Accordion title="Receiving compressed data?">
  If you omit `uncompressed_webhook=true`, data arrives gzip-compressed. Add `uncompressed_webhook=true` to your trigger URL, or decompress the payload on your server.
</Accordion>

<Accordion title="Payload too large for your server?">
  Large collections can produce payloads up to 1 GB. Set `express.json({ limit: "100mb" })` in Express.js or equivalent in your framework. If you need to handle very large datasets, use [S3 delivery](/datasets/scrapers/facebook/data-delivery/amazon-s3) instead.
</Accordion>

## Next steps

<CardGroup>
  <Card title="Deliver to Amazon S3" icon="bucket" href="/datasets/scrapers/facebook/data-delivery/amazon-s3">
    Store results directly in your S3 bucket.
  </Card>

  <Card title="All delivery options" icon="truck" href="/datasets/scrapers/scrapers-library/delivery-options">
    Snowflake, Azure, GCS, and more.
  </Card>
</CardGroup>


# Facebook Scraper API
Source: https://docs.brightdata.com/datasets/scrapers/facebook/introduction

Extract data from Facebook profiles, pages, posts, marketplace and events across 9 endpoints with the Bright Data [Facebook Scraper API](https://brightdata.com/products/web-scraper/facebook).

Send a Facebook URL, get structured JSON back. The Bright Data Facebook Scraper API handles proxies, CAPTCHAs, and parsing so you can focus on your data pipeline.

<Tip>
  New to Bright Data? [Create a free account](https://brightdata.com/cp/start) and get \$2 credit to start scraping.
</Tip>

## How it works

You send one or more Facebook URLs to the Bright Data Facebook Scraper API. Bright Data handles the scraping infrastructure and returns clean, structured JSON.

```text theme={null}
Your app  -->  Bright Data API  -->  Structured JSON
           POST /datasets/v3/scrape
           Authorization: Bearer YOUR_API_KEY
```

All requests use a `dataset_id` to specify the data type (profiles, posts, marketplace, events, and more) and return results in JSON, NDJSON, or CSV.

## What the response looks like

```bash theme={null}
curl -X POST "https://api.brightdata.com/datasets/v3/scrape?dataset_id=gd_mf0urb782734ik94dz&format=json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '[{"url": "https://www.facebook.com/zuck"}]'
```

```json theme={null}
{
  "name": "Mark Zuckerberg",
  "url": "https://www.facebook.com/zuck",
  "followers": 120000000,
  "bio": "Building the future...",
  "profile_type": "public_figure",
  "is_verified": true
}
```

## Supported data types

<CardGroup>
  <Card title="Profiles" icon="user" href="/api-reference/scrapers/social-media-apis/facebook-profiles-collect-by-url">
    Names, follower counts, bios, verification status, and profile details.
  </Card>

  <Card title="Page Posts" icon="newspaper" href="/api-reference/scrapers/social-media-apis/facebook-pages-posts-collect-by-url">
    Posts from Facebook pages by profile URL, including text, reactions, and media.
  </Card>

  <Card title="Posts" icon="image" href="/api-reference/scrapers/social-media-apis/facebook-posts-collect-by-url">
    Individual post data by post URL or posts by group URL.
  </Card>

  <Card title="Marketplace" icon="shop" href="/api-reference/scrapers/social-media-apis/facebook-marketplace-collect-by-url">
    Product listings, prices, seller details, and item descriptions.
  </Card>

  <Card title="Events" icon="calendar" href="/api-reference/scrapers/social-media-apis/facebook-events-collect-by-url">
    Event details including dates, locations, descriptions, and attendance.
  </Card>

  <Card title="Comments" icon="comments" href="/api-reference/scrapers/social-media-apis/facebook-comments-collect-by-url">
    Comment text, reactions, replies, and commenter details for any post.
  </Card>

  <Card title="Reels" icon="film" href="/api-reference/scrapers/social-media-apis/facebook-reels-collect-by-url">
    Video URLs, view counts, and engagement data from Facebook reels by profile URL.
  </Card>

  <Card title="Company Reviews" icon="star" href="/api-reference/scrapers/social-media-apis/facebook-company-reviews-collect-by-url">
    Business reviews, ratings, and reviewer details from Facebook pages.
  </Card>
</CardGroup>

## Request methods

The Bright Data Facebook Scraper API supports two request methods. Choose based on your volume and latency needs.

| Method           | Endpoint                                                    | Best for                                   |
| :--------------- | :---------------------------------------------------------- | :----------------------------------------- |
| **Synchronous**  | [`/scrape`](/datasets/scrapers/facebook/send-first-request) | Real-time lookups, up to 20 URLs           |
| **Asynchronous** | [`/trigger`](/datasets/scrapers/facebook/async-requests)    | Batch jobs, 20+ URLs, production pipelines |

Learn more in [Understanding sync vs. async requests](/datasets/scrapers/concepts/sync-vs-async).

## Capabilities and limits

| Capability                     | Detail                                                                                                                                                                                                                                     |
| :----------------------------- | :----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Output formats**             | JSON, NDJSON, CSV                                                                                                                                                                                                                          |
| **Max URLs per sync request**  | 20                                                                                                                                                                                                                                         |
| **Max URLs per async request** | 5,000                                                                                                                                                                                                                                      |
| **Data freshness**             | Real-time (scraped on demand)                                                                                                                                                                                                              |
| **Delivery options**           | API download, [Webhook](/datasets/scrapers/facebook/data-delivery/webhooks), [Amazon S3](/datasets/scrapers/facebook/data-delivery/amazon-s3), Snowflake, Azure, GCS ([all options](/datasets/scrapers/scrapers-library/delivery-options)) |
| **Pricing**                    | Pay per successful record ([see pricing](https://brightdata.com/pricing/web-scraper))                                                                                                                                                      |

## Common questions

<Accordion title="Is the data scraped in real time?">
  Yes. Each request triggers a live scrape. There is no cached or stale data. Response times vary by endpoint: profiles typically return in 10-30 seconds (sync), while discovery requests may take longer depending on result volume.
</Accordion>

<Accordion title="What is the difference between URL collection and discovery?">
  **URL collection** scrapes a specific Facebook page you provide (e.g., a profile URL). **Discovery** finds Facebook content matching search criteria (e.g., all posts from a page URL) and scrapes the results. Discovery is only available via async requests.
</Accordion>

<Accordion title="How is this different from scraping using proxies or Web Unlocker?">
  When scraping using proxies or Web Unlocker, you still need to write and maintain
  your own parsing logic and update it whenever Facebook changes its page structure.
  The Facebook Scraper API handles the entire stack: proxy rotation, anti-bot bypassing
  and parsing. You simply send a Facebook URL and get clean, structured JSON back with
  no scraping infrastructure or parser maintenance required on your end.
</Accordion>

## Next steps

<CardGroup>
  <Card title="Quickstart" icon="rocket" href="/datasets/scrapers/facebook/quickstart">
    Scrape your first Facebook profile in 5 minutes.
  </Card>

  <Card title="Send your first request" icon="bolt" href="/datasets/scrapers/facebook/send-first-request">
    Full code examples in cURL, Python, and Node.js.
  </Card>

  <Card title="API reference" icon="code" href="/api-reference/scrapers/social-media-apis/facebook-profiles-collect-by-url">
    Endpoint specs, parameters, and response schemas.
  </Card>
</CardGroup>


# Facebook scraper quickstart
Source: https://docs.brightdata.com/datasets/scrapers/facebook/quickstart

Set up the Bright Data Facebook Scraper API and collect your first profile, page or post as structured JSON in under 5 minutes from the Control Panel.

This tutorial shows you how to scrape a Facebook profile and get structured JSON data using the Bright Data Facebook Scraper API.

## Prerequisites

* A [Bright Data account](https://brightdata.com/cp/start) (includes \$2 free credit)
* cURL, Python 3, or Node.js 18+ installed

<Steps>
  <Step title="Get your API key">
    Go to the [user settings page](https://brightdata.com/cp/setting/users) in your Bright Data account and copy your API key.

    If you don't have an account yet, [sign up at brightdata.com](https://brightdata.com/cp/start). New users get \$2 free credit for testing.

    <Warning>
      Your API key is shown only once when created. Copy and store it securely.
    </Warning>
  </Step>

  <Step title="Send a request">
    We'll use the **Profiles endpoint** with a synchronous request. Replace `YOUR_API_KEY` with your actual token:

    <CodeGroup>
      ```bash cURL theme={null}
      curl -X POST \
        "https://api.brightdata.com/datasets/v3/scrape?dataset_id=gd_mf0urb782734ik94dz&format=json" \
        -H "Authorization: Bearer YOUR_API_KEY" \
        -H "Content-Type: application/json" \
        -d '[{"url": "https://www.facebook.com/zuck"}]'
      ```

      ```python Python theme={null}
      import requests

      response = requests.post(
          "https://api.brightdata.com/datasets/v3/scrape",
          params={"dataset_id": "gd_mf0urb782734ik94dz", "format": "json"},
          headers={
              "Authorization": "Bearer YOUR_API_KEY",
              "Content-Type": "application/json",
          },
          json=[{"url": "https://www.facebook.com/zuck"}],
      )

      print(response.json())
      ```

      ```javascript Node.js theme={null}
      const response = await fetch(
        "https://api.brightdata.com/datasets/v3/scrape?dataset_id=gd_mf0urb782734ik94dz&format=json",
        {
          method: "POST",
          headers: {
            "Authorization": "Bearer YOUR_API_KEY",
            "Content-Type": "application/json",
          },
          body: JSON.stringify([
            { url: "https://www.facebook.com/zuck" }
          ]),
        }
      );

      const data = await response.json();
      console.log(data);
      ```
    </CodeGroup>

    You should see a `200` status code. This takes 10-30 seconds.
  </Step>

  <Step title="Review the response">
    The Bright Data Facebook Scraper API returns a JSON array with structured profile data:

    ```json theme={null}
    [
      {
        "name": "Mark Zuckerberg",
        "url": "https://www.facebook.com/zuck",
        "followers": 120000000,
        "bio": "Building the future...",
        "profile_type": "public_figure",
        "is_verified": true
      }
    ]
    ```

    Each profile object includes fields covering follower counts, bio, verification status, and more. See the [full response schema](/api-reference/scrapers/social-media-apis/facebook-profiles-collect-by-url).
  </Step>
</Steps>

You've successfully scraped your first Facebook profile using the Bright Data Facebook Scraper API.

## Common questions

<Accordion title="Can I scrape multiple profiles in one request?">
  Yes. Add more objects to the input array. Synchronous requests support up to 20 URLs. For larger batches, use the [async `/trigger` endpoint](/datasets/scrapers/facebook/async-requests).

  ```json theme={null}
  [
    {"url": "https://www.facebook.com/zuck"},
    {"url": "https://www.facebook.com/NASA"},
    {"url": "https://www.facebook.com/natgeo"}
  ]
  ```
</Accordion>

<Accordion title="Getting a 401 or 403 error?">
  Verify your API key is correct and hasn't expired. Generate a new token from [Account settings](https://brightdata.com/cp/setting/users). See the [authentication guide](/api-reference/authentication) for details.
</Accordion>

<Accordion title="Request is timing out?">
  Synchronous requests have a 1-minute timeout. If the request exceeds this limit, it automatically switches to async and returns a `snapshot_id`. Use the [async workflow](/datasets/scrapers/facebook/async-requests) for large batches.
</Accordion>

<Accordion title="Empty or partial response data?">
  Verify the Facebook profile URL is publicly accessible and correctly formatted. The URL should follow the pattern `https://www.facebook.com/username`.
</Accordion>

## Next steps

<CardGroup>
  <Card title="Send your first request" icon="bolt" href="/datasets/scrapers/facebook/send-first-request">
    Explore all endpoint types with full examples.
  </Card>

  <Card title="Async batch requests" icon="layer-group" href="/datasets/scrapers/facebook/async-requests">
    Scrape hundreds of URLs in a single batch job.
  </Card>

  <Card title="Set up webhooks" icon="webhook" href="/datasets/scrapers/facebook/data-delivery/webhooks">
    Receive results automatically when scraping completes.
  </Card>
</CardGroup>


# Send your first Facebook API request
Source: https://docs.brightdata.com/datasets/scrapers/facebook/send-first-request

Send synchronous requests to the Bright Data Facebook Scraper API across 9 endpoints with examples for profiles, page posts, marketplace and comments.

This tutorial walks you through sending a synchronous request to each Bright Data Facebook Scraper API endpoint. By the end, you'll have working examples for profiles, page posts, posts, marketplace listings, and comments.

## Prerequisites

* A [Bright Data account](https://brightdata.com/cp/start) with an active API key
* Completed the [Quickstart](/datasets/scrapers/facebook/quickstart)

## Request structure

Every synchronous request follows the same pattern:

```http theme={null}
POST https://api.brightdata.com/datasets/v3/scrape?dataset_id={DATASET_ID}&format=json
Authorization: Bearer YOUR_API_KEY
Content-Type: application/json

[{"url": "https://www.facebook.com/..."}]
```

The only thing that changes between endpoints is the `dataset_id` and the input URL format.

<Note>
  Synchronous requests support up to 20 URLs and have a 1-minute timeout. If the request takes longer, the API automatically returns a `snapshot_id` instead. See [async requests](/datasets/scrapers/facebook/async-requests).
</Note>

## How to scrape Facebook profiles

**Dataset ID:** `gd_mf0urb782734ik94dz`

```bash theme={null}
curl -X POST \
  "https://api.brightdata.com/datasets/v3/scrape?dataset_id=gd_mf0urb782734ik94dz&format=json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '[{"url": "https://www.facebook.com/zuck"}]'
```

You should see a `200` response. This takes 10-30 seconds.

<Accordion title="Example response">
  ```json theme={null}
  [
    {
      "name": "Mark Zuckerberg",
      "url": "https://www.facebook.com/zuck",
      "followers": 120000000,
      "bio": "Building the future...",
      "profile_type": "public_figure",
      "is_verified": true
    }
  ]
  ```
</Accordion>

[Full Profiles response schema](/api-reference/scrapers/social-media-apis/facebook-profiles-collect-by-url)

## How to scrape Facebook page posts

**Dataset ID:** `gd_lkaxegm826bjpoo9m5`

```bash theme={null}
curl -X POST \
  "https://api.brightdata.com/datasets/v3/scrape?dataset_id=gd_lkaxegm826bjpoo9m5&format=json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '[{"url": "https://www.facebook.com/NASA"}]'
```

<Accordion title="Example response">
  ```json theme={null}
  [
    {
      "url": "https://www.facebook.com/NASA",
      "post_text": "Exploring the cosmos...",
      "num_comments": 450,
      "date_posted": "2024-04-10T14:30:00.000Z",
      "reactions": 12500,
      "content_type": "Photo"
    }
  ]
  ```
</Accordion>

[Full Page Posts response schema](/api-reference/scrapers/social-media-apis/facebook-pages-posts-collect-by-url)

## Posts by post URL

**Dataset ID:** `gd_lyclm1571iy3mv57zw`

```bash theme={null}
curl -X POST \
  "https://api.brightdata.com/datasets/v3/scrape?dataset_id=gd_lyclm1571iy3mv57zw&format=json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '[{"url": "https://www.facebook.com/zuck/posts/example123"}]'
```

<Accordion title="Example response">
  ```json theme={null}
  [
    {
      "url": "https://www.facebook.com/zuck/posts/example123",
      "post_text": "Excited to share...",
      "num_comments": 320,
      "date_posted": "2024-05-01T09:00:00.000Z",
      "reactions": 8500,
      "shares": 1200
    }
  ]
  ```
</Accordion>

[Full Posts response schema](/api-reference/scrapers/social-media-apis/facebook-posts-collect-by-url)

## How to scrape Facebook Marketplace

**Dataset ID:** `gd_lvt9iwuh6fbcwmx1a`

```bash theme={null}
curl -X POST \
  "https://api.brightdata.com/datasets/v3/scrape?dataset_id=gd_lvt9iwuh6fbcwmx1a&format=json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '[{"url": "https://www.facebook.com/marketplace/item/123456789"}]'
```

<Accordion title="Example response">
  ```json theme={null}
  [
    {
      "url": "https://www.facebook.com/marketplace/item/123456789",
      "title": "Vintage Coffee Table",
      "price": "$150",
      "location": "San Francisco, CA",
      "seller_name": "John Doe",
      "description": "Beautiful mid-century modern coffee table..."
    }
  ]
  ```
</Accordion>

[Full Marketplace response schema](/api-reference/scrapers/social-media-apis/facebook-marketplace-collect-by-url)

## How to scrape Facebook comments

**Dataset ID:** `gd_lkay758p1eanlolqw8`

```bash theme={null}
curl -X POST \
  "https://api.brightdata.com/datasets/v3/scrape?dataset_id=gd_lkay758p1eanlolqw8&format=json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '[{"url": "https://www.facebook.com/zuck/posts/example123"}]'
```

<Accordion title="Example response">
  ```json theme={null}
  [
    {
      "url": "https://www.facebook.com/zuck/posts/example123",
      "comment_user": "Jane Smith",
      "comment_date": "2024-05-02T10:15:00.000Z",
      "comment_text": "Great update!",
      "reactions": 12,
      "replies_count": 3
    }
  ]
  ```
</Accordion>

[Full Comments response schema](/api-reference/scrapers/social-media-apis/facebook-comments-collect-by-url)

## Quick reference: dataset IDs

| Endpoint                   | Dataset ID              | URL pattern                               |
| :------------------------- | :---------------------- | :---------------------------------------- |
| Pages Posts by Profile URL | `gd_lkaxegm826bjpoo9m5` | `facebook.com/{page_name}`                |
| Comments                   | `gd_lkay758p1eanlolqw8` | `facebook.com/{user}/posts/{post_id}`     |
| Posts by group URL         | `gd_lz11l67o2cb3r0lkj3` | `facebook.com/groups/{group_id}`          |
| Posts by post URL          | `gd_lyclm1571iy3mv57zw` | `facebook.com/{user}/posts/{post_id}`     |
| Marketplace                | `gd_lvt9iwuh6fbcwmx1a`  | `facebook.com/marketplace/item/{item_id}` |
| Profiles                   | `gd_mf0urb782734ik94dz` | `facebook.com/{username}`                 |
| Pages and Profiles         | `gd_mf124a0511bauquyow` | `facebook.com/{page_or_profile}`          |
| Events                     | `gd_m14sd0to1jz48ppm51` | `facebook.com/events/{event_id}`          |
| Reels by profile URL       | `gd_lyclm3ey2q6rww027t` | `facebook.com/{username}`                 |
| Company Reviews            | `gd_m0dtqpiu1mbcyc2g86` | `facebook.com/{company_page}`             |

## Output formats

Control the response format with the `format` query parameter:

| Value    | Description                                 |
| :------- | :------------------------------------------ |
| `json`   | JSON array (default)                        |
| `ndjson` | Newline-delimited JSON, one record per line |
| `csv`    | Comma-separated values                      |

## Next steps

<CardGroup>
  <Card title="Async batch requests" icon="layer-group" href="/datasets/scrapers/facebook/async-requests">
    Scrape hundreds of URLs in a single batch job.
  </Card>

  <Card title="API reference" icon="code" href="/api-reference/scrapers/social-media-apis/facebook-profiles-collect-by-url">
    Full parameter and response field reference.
  </Card>
</CardGroup>


# How to scrape Google data in bulk
Source: https://docs.brightdata.com/datasets/scrapers/google/async-requests

Trigger large-scale Google scraping jobs, monitor progress and retrieve results using the Bright Data async /trigger endpoint. Returns up to 1 GB per response.

This guide shows you how to scrape Google data at scale using the asynchronous `/trigger` endpoint. Use this when you have more than 20 inputs, need discovery by keyword, location or input filters, or want delivery to a webhook or S3.

<Tip>
  Not sure whether to use sync or async? Read [Understanding sync vs. async requests](/datasets/scrapers/concepts/sync-vs-async).
</Tip>

## Prerequisites

* A [Bright Data account](https://brightdata.com/cp/start) with an active API key
* Familiarity with the [synchronous request flow](/datasets/scrapers/google/send-first-request)

## Step 1: Trigger the collection

Send a `POST` request to the `/trigger` endpoint with your input array. This example collects five Google Maps places in a single batch:

<CodeGroup>
  ```bash cURL theme={null}
  curl -X POST \
    "https://api.brightdata.com/datasets/v3/trigger?dataset_id=gd_m8ebnr0q2qlklc02fz&format=json" \
    -H "Authorization: Bearer YOUR_API_KEY" \
    -H "Content-Type: application/json" \
    -d '[
      {"url": "https://www.google.com/maps/place/Empire+State+Building"},
      {"url": "https://www.google.com/maps/place/Central+Park"},
      {"url": "https://www.google.com/maps/place/Times+Square"},
      {"url": "https://www.google.com/maps/place/Statue+of+Liberty"},
      {"url": "https://www.google.com/maps/place/Brooklyn+Bridge"}
    ]'
  ```

  ```python Python theme={null}
  import requests

  response = requests.post(
      "https://api.brightdata.com/datasets/v3/trigger",
      params={"dataset_id": "gd_m8ebnr0q2qlklc02fz", "format": "json"},
      headers={
          "Authorization": "Bearer YOUR_API_KEY",
          "Content-Type": "application/json",
      },
      json=[
          {"url": "https://www.google.com/maps/place/Empire+State+Building"},
          {"url": "https://www.google.com/maps/place/Central+Park"},
          {"url": "https://www.google.com/maps/place/Times+Square"},
          {"url": "https://www.google.com/maps/place/Statue+of+Liberty"},
          {"url": "https://www.google.com/maps/place/Brooklyn+Bridge"},
      ],
  )

  snapshot = response.json()
  print("Snapshot ID:", snapshot["snapshot_id"])
  ```

  ```javascript Node.js theme={null}
  const response = await fetch(
    "https://api.brightdata.com/datasets/v3/trigger?dataset_id=gd_m8ebnr0q2qlklc02fz&format=json",
    {
      method: "POST",
      headers: {
        "Authorization": "Bearer YOUR_API_KEY",
        "Content-Type": "application/json",
      },
      body: JSON.stringify([
        { url: "https://www.google.com/maps/place/Empire+State+Building" },
        { url: "https://www.google.com/maps/place/Central+Park" },
        { url: "https://www.google.com/maps/place/Times+Square" },
        { url: "https://www.google.com/maps/place/Statue+of+Liberty" },
        { url: "https://www.google.com/maps/place/Brooklyn+Bridge" },
      ]),
    }
  );

  const snapshot = await response.json();
  console.log("Snapshot ID:", snapshot.snapshot_id);
  ```
</CodeGroup>

You should see a `200` response with a `snapshot_id`:

```json theme={null}
{
  "snapshot_id": "s_m1a2b3c4d5e6f7g8h"
}
```

Save this ID. You need it to check progress and download results.

## Discovery with async

Discovery is the primary reason to use async. Most Google discovery modes can return large result sets, and some require structured inputs that aren't URLs.

**Discover Google Maps places by location:**

```bash theme={null}
curl -X POST \
  "https://api.brightdata.com/datasets/v3/trigger?dataset_id=gd_m8ebnr0q2qlklc02fz&format=json&type=discover_new&discover_by=location" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '[{"country": "US", "lat": 40.7484, "long": -73.9857, "zoom_level": 14, "keyword": "coffee shop"}]'
```

**Discover Google Shopping products by keyword:**

```bash theme={null}
curl -X POST \
  "https://api.brightdata.com/datasets/v3/trigger?dataset_id=gd_ltppk50q18kdw67omz&format=json&type=discover_new&discover_by=keyword" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '[{"keyword": "wireless headphones", "country": "US"}]'
```

**Discover Google Flights by input filters:**

```bash theme={null}
curl -X POST \
  "https://api.brightdata.com/datasets/v3/trigger?dataset_id=gd_mhng7wen1rw0a3gvpf&format=json&type=discover_new&discover_by=input_filters" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '[{
    "origin": "JFK",
    "destination": "LAX",
    "departure": "2026-06-15",
    "return": "2026-06-22",
    "trip_type": "round_trip",
    "adults": 1,
    "cabin": "economy"
  }]'
```

**Discover Google Hotels by search:**

```bash theme={null}
curl -X POST \
  "https://api.brightdata.com/datasets/v3/trigger?dataset_id=gd_mg3gjfmg12tc2n5d4d&format=json&type=discover_new&discover_by=search" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '[{
    "search_term": "New York",
    "check_in_date": "2026-06-15",
    "check_out_date": "2026-06-18",
    "guest_number": 2,
    "country": "US",
    "currency": "USD"
  }]'
```

## Step 2: Monitor progress

Poll the snapshot status until it shows `ready`. This takes 30 seconds to several minutes depending on input count and whether discovery is involved.

<CodeGroup>
  ```bash cURL theme={null}
  curl "https://api.brightdata.com/datasets/v3/progress/s_m1a2b3c4d5e6f7g8h" \
    -H "Authorization: Bearer YOUR_API_KEY"
  ```

  ```python Python theme={null}
  import time

  snapshot_id = "s_m1a2b3c4d5e6f7g8h"

  while True:
      status_response = requests.get(
          f"https://api.brightdata.com/datasets/v3/progress/{snapshot_id}",
          headers={"Authorization": "Bearer YOUR_API_KEY"},
      )
      status = status_response.json().get("status")
      print(f"Status: {status}")

      if status == "ready":
          break
      time.sleep(10)
  ```

  ```javascript Node.js theme={null}
  const snapshotId = "s_m1a2b3c4d5e6f7g8h";

  let status = "collecting";
  while (status !== "ready") {
    const statusResponse = await fetch(
      `https://api.brightdata.com/datasets/v3/progress/${snapshotId}`,
      { headers: { "Authorization": "Bearer YOUR_API_KEY" } }
    );
    const statusData = await statusResponse.json();
    status = statusData.status;
    console.log("Status:", status);

    if (status !== "ready") {
      await new Promise((r) => setTimeout(r, 10000));
    }
  }
  ```
</CodeGroup>

Status values:

| Status       | Meaning                             |
| :----------- | :---------------------------------- |
| `collecting` | Scraping is in progress             |
| `digesting`  | Data is being processed             |
| `ready`      | Results are available for download  |
| `failed`     | The collection encountered an error |

## Step 3: Download results

Once the status is `ready`, download the scraped data:

<CodeGroup>
  ```bash cURL theme={null}
  curl "https://api.brightdata.com/datasets/v3/snapshot/s_m1a2b3c4d5e6f7g8h?format=json" \
    -H "Authorization: Bearer YOUR_API_KEY" \
    -o results.json
  ```

  ```python Python theme={null}
  results_response = requests.get(
      f"https://api.brightdata.com/datasets/v3/snapshot/{snapshot_id}",
      params={"format": "json"},
      headers={"Authorization": "Bearer YOUR_API_KEY"},
  )

  results = results_response.json()
  print(f"Collected {len(results)} records")
  ```

  ```javascript Node.js theme={null}
  const resultsResponse = await fetch(
    `https://api.brightdata.com/datasets/v3/snapshot/${snapshotId}?format=json`,
    { headers: { "Authorization": "Bearer YOUR_API_KEY" } }
  );

  const results = await resultsResponse.json();
  console.log(`Collected ${results.length} records`);
  ```
</CodeGroup>

You've successfully triggered, monitored and downloaded a batch Google scraping job. See the [Download Snapshot API reference](/api-reference/scrapers/delivery-apis/download-snapshot) for format options and part-by-part download flow.

## Skip polling with webhooks

If you don't want to poll for status, add an `endpoint` parameter to receive results automatically:

```bash theme={null}
curl -X POST \
  "https://api.brightdata.com/datasets/v3/trigger?dataset_id=gd_m8ebnr0q2qlklc02fz&format=json&endpoint=https://your-server.com/webhook" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '[{"url": "https://www.google.com/maps/place/Empire+State+Building"}]'
```

See [Webhook delivery](/datasets/scrapers/google/data-delivery/webhooks) for the full setup.

## Limits and constraints

| Constraint                           | Value      |
| :----------------------------------- | :--------- |
| Max inputs per async request         | 5,000      |
| Max input file size                  | 1 GB       |
| Max concurrent batch requests        | 100        |
| Max concurrent single-input requests | 1,500      |
| Webhook delivery size                | Up to 1 GB |
| API download size                    | Up to 5 GB |

## Troubleshooting

<Accordion title="Getting a 429 Too Many Requests error?">
  You've exceeded the concurrent request limit. Reduce the number of parallel requests or combine inputs into fewer, larger batches. Each batch can include up to 1 GB of input data.
</Accordion>

<Accordion title="Snapshot status shows 'failed'?">
  Check that all input URLs are valid and correctly formatted for the target Google product. Review the error details in the snapshot response or in the [Logs tab](https://brightdata.com/cp/scrapers) of your Bright Data dashboard.
</Accordion>

<Accordion title="Results are incomplete or missing some records?">
  Individual inputs can fail while the overall job succeeds. Check the snapshot response for any `errors` field and retry failed inputs in a separate request.
</Accordion>

<Accordion title="Discovery returned zero results?">
  Verify your discovery parameters. Location-based Maps discovery needs valid lat/long and a realistic zoom level (12 to 16). Flights discovery needs IATA codes and future dates. Hotels discovery needs a valid destination string.
</Accordion>

## Next steps

<CardGroup>
  <Card title="Webhook delivery" icon="webhook" href="/datasets/scrapers/google/data-delivery/webhooks">
    Push results to your HTTP endpoint automatically.
  </Card>

  <Card title="API reference" icon="code" href="/api-reference/scrapers/search-engines-apis/google-maps-collect-by-url">
    Full endpoint specs, parameters and response schemas.
  </Card>
</CardGroup>


# How to deliver Google data to Amazon S3
Source: https://docs.brightdata.com/datasets/scrapers/google/data-delivery/amazon-s3

Configure the Bright Data Google Scraper API to deliver scraped Maps, Trends and review data directly to your Amazon S3 bucket on job completion.

This guide shows you how to configure the Bright Data Google Scraper API to deliver scraped data directly to your Amazon S3 bucket when a collection job completes.

## Prerequisites

* A [Bright Data account](https://brightdata.com/cp/start) with an active API key
* An AWS account with an S3 bucket
* IAM credentials with write access to the bucket
* Familiarity with the [async request workflow](/datasets/scrapers/google/async-requests)

## Step 1: Create an S3 bucket

If you already have a bucket, skip to Step 2.

In the [AWS S3 Console](https://s3.console.aws.amazon.com/s3/buckets):

1. Click **Create bucket**
2. Enter a bucket name (e.g., `google-scraper-data`)
3. Select your preferred AWS region
4. Keep default settings and click **Create bucket**

## Step 2: Set up IAM permissions

Create an IAM role that grants Bright Data write access to your bucket.

### Create a policy

In the [IAM Console](https://console.aws.amazon.com/iam/), go to **Policies** and create a new policy with this JSON:

```json theme={null}
{
  "Version": "2012-10-17",
  "Statement": [
    {
      "Effect": "Allow",
      "Action": ["s3:PutObject", "s3:GetObject"],
      "Resource": "arn:aws:s3:::google-scraper-data/*"
    }
  ]
}
```

Replace `google-scraper-data` with your actual bucket name.

### Create a role for Bright Data

1. Go to **Roles** > **Create role**
2. Select **AWS account** as the trusted entity type
3. Enter Bright Data's AWS account ID: `422310177405`
4. Attach the policy you created above
5. Name the role (e.g., `BrightDataS3Delivery`)
6. Note the role ARN (e.g., `arn:aws:iam::123456789012:role/BrightDataS3Delivery`)

Add an external ID condition to the trust policy:

```json theme={null}
{
  "Version": "2012-10-17",
  "Statement": [
    {
      "Effect": "Allow",
      "Principal": {
        "AWS": "arn:aws:iam::422310177405:role/brd.ec2.zs-dca-delivery"
      },
      "Action": "sts:AssumeRole",
      "Condition": {
        "StringEquals": {
          "sts:ExternalId": "YOUR_BRIGHT_DATA_CUSTOMER_ID"
        }
      }
    }
  ]
}
```

Find your customer ID in [Account settings](https://brightdata.com/cp/setting/customer_details).

## Step 3: Configure delivery in Bright Data

1. Navigate to your [scraper configuration](https://brightdata.com/cp/scrapers)
2. Click the **Delivery settings** tab
3. Select **Amazon S3** as the delivery destination
4. Enter your credentials:
   * **Bucket name**: Your S3 bucket name
   * **Role ARN**: The IAM role ARN from Step 2
   * **Region**: Your S3 bucket region
   * **Path prefix** (optional): A folder path within the bucket (e.g., `google/maps/`)
5. Select your preferred file format (JSON, NDJSON or CSV)
6. Click **Save**

## Step 4: Trigger a collection

Trigger an async collection. Results are automatically delivered to your S3 bucket:

<CodeGroup>
  ```bash cURL theme={null}
  curl -X POST \
    "https://api.brightdata.com/datasets/v3/trigger?dataset_id=gd_m8ebnr0q2qlklc02fz&format=json" \
    -H "Authorization: Bearer YOUR_API_KEY" \
    -H "Content-Type: application/json" \
    -d '[
      {"url": "https://www.google.com/maps/place/Empire+State+Building"},
      {"url": "https://www.google.com/maps/place/Central+Park"},
      {"url": "https://www.google.com/maps/place/Times+Square"}
    ]'
  ```

  ```python Python theme={null}
  import requests

  response = requests.post(
      "https://api.brightdata.com/datasets/v3/trigger",
      params={"dataset_id": "gd_m8ebnr0q2qlklc02fz", "format": "json"},
      headers={
          "Authorization": "Bearer YOUR_API_KEY",
          "Content-Type": "application/json",
      },
      json=[
          {"url": "https://www.google.com/maps/place/Empire+State+Building"},
          {"url": "https://www.google.com/maps/place/Central+Park"},
          {"url": "https://www.google.com/maps/place/Times+Square"},
      ],
  )

  print("Snapshot ID:", response.json()["snapshot_id"])
  ```

  ```javascript Node.js theme={null}
  const response = await fetch(
    "https://api.brightdata.com/datasets/v3/trigger?dataset_id=gd_m8ebnr0q2qlklc02fz&format=json",
    {
      method: "POST",
      headers: {
        "Authorization": "Bearer YOUR_API_KEY",
        "Content-Type": "application/json",
      },
      body: JSON.stringify([
        { url: "https://www.google.com/maps/place/Empire+State+Building" },
        { url: "https://www.google.com/maps/place/Central+Park" },
        { url: "https://www.google.com/maps/place/Times+Square" },
      ]),
    }
  );

  const data = await response.json();
  console.log("Snapshot ID:", data.snapshot_id);
  ```
</CodeGroup>

## Step 5: Verify delivery

Once the collection completes, check your S3 bucket for the delivered file:

```bash theme={null}
aws s3 ls s3://google-scraper-data/google/maps/
```

You should see a file named with the snapshot ID (e.g., `s_m1a2b3c4d5e6f7g8h.json`).

Download and inspect it:

```bash theme={null}
aws s3 cp s3://google-scraper-data/google/maps/s_m1a2b3c4d5e6f7g8h.json ./results.json
cat results.json | python -m json.tool | head -20
```

You can also verify delivery status using the [Monitor Delivery API](/api-reference/scrapers/management-apis/monitor-delivery).

## Troubleshooting

<Accordion title="Files not appearing in S3?">
  * Verify the IAM role ARN and external ID are correct
  * Check that the bucket policy allows `s3:PutObject` from Bright Data's account
  * Ensure the bucket region matches your configuration
  * Review delivery status in the Bright Data dashboard under **Logs**
</Accordion>

<Accordion title="Access denied errors?">
  Verify the trust policy on your IAM role includes Bright Data's account (`422310177405`) and your external ID matches your Bright Data customer ID found in [Account settings](https://brightdata.com/cp/setting/customer_details).
</Accordion>

<Accordion title="Delivered file is empty or missing records?">
  Check the collection status in the Bright Data dashboard. If some inputs failed, the delivered file contains only successful results. Retry failed inputs in a separate request.
</Accordion>

## Next steps

<CardGroup>
  <Card title="Set up webhooks" icon="webhook" href="/datasets/scrapers/google/data-delivery/webhooks">
    Receive results at your HTTP endpoint.
  </Card>

  <Card title="All delivery options" icon="truck" href="/datasets/scrapers/scrapers-library/delivery-options">
    Snowflake, Azure, GCS, SFTP and more.
  </Card>
</CardGroup>


# How to receive Google data via webhooks
Source: https://docs.brightdata.com/datasets/scrapers/google/data-delivery/webhooks

Configure the Bright Data Google Scraper API to push scraped Maps, Trends and review data to your HTTPS webhook across multiple endpoints (4xx errors retried).

This guide shows you how to set up webhook delivery so your server receives scraped Google data automatically when a collection job finishes.

## Prerequisites

* A [Bright Data account](https://brightdata.com/cp/start) with an active API key
* Familiarity with the [async request workflow](/datasets/scrapers/google/async-requests)
* A publicly accessible HTTP endpoint (or a testing tool like [webhook.site](https://webhook.site))

## How webhooks work

When you trigger an async collection with an `endpoint` URL, Bright Data sends a `POST` request to that URL with the scraped data once the job completes. No polling required.

```text theme={null}
Your app --> POST /trigger (with webhook URL) --> Bright Data scrapes --> POST to your webhook
```

## Step 1: Set up a test webhook

For testing, use [webhook.site](https://webhook.site) to get a temporary public URL:

1. Open [webhook.site](https://webhook.site) in your browser
2. Copy the unique URL displayed (e.g., `https://webhook.site/abc-123-def`)
3. Keep the page open to monitor incoming requests

## Step 2: Trigger a collection with the webhook URL

Add the `endpoint` query parameter to your async `/trigger` request. This example uses Google Maps:

<CodeGroup>
  ```bash cURL theme={null}
  curl -X POST \
    "https://api.brightdata.com/datasets/v3/trigger?dataset_id=gd_m8ebnr0q2qlklc02fz&format=json&endpoint=https://webhook.site/abc-123-def&uncompressed_webhook=true" \
    -H "Authorization: Bearer YOUR_API_KEY" \
    -H "Content-Type: application/json" \
    -d '[
      {"url": "https://www.google.com/maps/place/Empire+State+Building"},
      {"url": "https://www.google.com/maps/place/Central+Park"}
    ]'
  ```

  ```python Python theme={null}
  import requests

  WEBHOOK_URL = "https://webhook.site/abc-123-def"

  response = requests.post(
      "https://api.brightdata.com/datasets/v3/trigger",
      params={
          "dataset_id": "gd_m8ebnr0q2qlklc02fz",
          "format": "json",
          "webhook": WEBHOOK_URL,
          "uncompressed_webhook": "true",
      },
      headers={
          "Authorization": "Bearer YOUR_API_KEY",
          "Content-Type": "application/json",
      },
      json=[
          {"url": "https://www.google.com/maps/place/Empire+State+Building"},
          {"url": "https://www.google.com/maps/place/Central+Park"},
      ],
  )

  print("Snapshot ID:", response.json()["snapshot_id"])
  ```

  ```javascript Node.js theme={null}
  const WEBHOOK_URL = "https://webhook.site/abc-123-def";

  const response = await fetch(
    `https://api.brightdata.com/datasets/v3/trigger?dataset_id=gd_m8ebnr0q2qlklc02fz&format=json&endpoint=${encodeURIComponent(WEBHOOK_URL)}&uncompressed_webhook=true`,
    {
      method: "POST",
      headers: {
        "Authorization": "Bearer YOUR_API_KEY",
        "Content-Type": "application/json",
      },
      body: JSON.stringify([
        { url: "https://www.google.com/maps/place/Empire+State+Building" },
        { url: "https://www.google.com/maps/place/Central+Park" },
      ]),
    }
  );

  const data = await response.json();
  console.log("Snapshot ID:", data.snapshot_id);
  ```
</CodeGroup>

Key parameters:

| Parameter              | Description                                                  |
| :--------------------- | :----------------------------------------------------------- |
| `endpoint`             | Your HTTP endpoint URL that receives the `POST` payload      |
| `uncompressed_webhook` | Set to `true` to receive uncompressed JSON (default is gzip) |
| `format`               | Output format: `json`, `ndjson` or `csv`                     |

## Step 3: Verify delivery

Once the collection completes (typically 30 to 60 seconds for a few records), check your webhook.site page. You should see a `POST` request with the scraped data.

The payload is the same JSON array you would receive from a direct API download:

```json theme={null}
[
  {
    "place_id": "ChIJaXQRs6lZwokRY6EFpJnhNNE",
    "name": "Empire State Building",
    "address": "20 W 34th St., New York, NY 10001",
    "rating": 4.7,
    "reviews_count": 98500
  },
  {
    "place_id": "ChIJ4zGFAZpYwokRGUGph3Mf37k",
    "name": "Central Park",
    "address": "New York, NY",
    "rating": 4.8,
    "reviews_count": 325000
  }
]
```

## Production webhook setup

For production, point the `endpoint` URL to your own server endpoint.

### How to handle webhooks in Express.js

```javascript server.js theme={null}
const express = require("express");
const app = express();

app.use(express.json({ limit: "100mb" }));

app.post("/webhook/google", (req, res) => {
  const records = req.body;
  console.log(`Received ${records.length} records`);

  for (const record of records) {
    console.log(`- ${record.name || record.title} (${record.rating || "n/a"})`);
  }

  res.status(200).json({ received: true });
});

app.listen(3000, () => console.log("Webhook server running on port 3000"));
```

### How to handle webhooks in Flask

```python server.py theme={null}
from flask import Flask, request, jsonify

app = Flask(__name__)

@app.route("/webhook/google", methods=["POST"])
def handle_webhook():
    records = request.get_json()
    print(f"Received {len(records)} records")

    for record in records:
        name = record.get("name") or record.get("title")
        print(f"- {name}")

    return jsonify({"received": True}), 200

if __name__ == "__main__":
    app.run(port=3000)
```

<Warning>
  Return a `200` status code within 30 seconds to acknowledge receipt. If your endpoint fails or times out, Bright Data retries delivery.
</Warning>

## Webhook with authorization

If your endpoint requires authentication, add the `webhook_header_Authorization` parameter:

```bash theme={null}
curl -X POST \
  "https://api.brightdata.com/datasets/v3/trigger?dataset_id=gd_m8ebnr0q2qlklc02fz&format=json&endpoint=https://your-server.com/webhook&webhook_header_Authorization=Bearer+YOUR_SECRET_TOKEN" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '[{"url": "https://www.google.com/maps/place/Empire+State+Building"}]'
```

## Allowlist webhook IPs

If your server uses an IP allowlist, add the following Bright Data webhook source IPs:

```text theme={null}
54.175.27.69
34.225.9.175
100.28.38.247
100.29.18.195
52.72.185.255
35.174.112.248
54.165.183.124
3.91.140.7
52.202.75.37
98.82.225.117
100.27.150.189
18.214.10.85
35.169.71.210
44.194.183.74
```

## Troubleshooting

<Accordion title="Webhook not receiving data?">
  * Verify the URL is publicly accessible (not `localhost`)
  * Check that your endpoint returns a `200` status code within 30 seconds
  * Verify the webhook IPs above are allowlisted if you have firewall rules
</Accordion>

<Accordion title="Receiving compressed data?">
  If you omit `uncompressed_webhook=true`, data arrives gzip-compressed. Add `uncompressed_webhook=true` to your trigger URL, or decompress the payload on your server.
</Accordion>

<Accordion title="Payload too large for your server?">
  Large collections can produce payloads up to 1 GB. Set `express.json({ limit: "100mb" })` in Express.js or equivalent in your framework. If you need to handle very large datasets, use [S3 delivery](/datasets/scrapers/google/data-delivery/amazon-s3) instead.
</Accordion>

## Next steps

<CardGroup>
  <Card title="Deliver to Amazon S3" icon="bucket" href="/datasets/scrapers/google/data-delivery/amazon-s3">
    Store results directly in your S3 bucket.
  </Card>

  <Card title="All delivery options" icon="truck" href="/datasets/scrapers/scrapers-library/delivery-options">
    Snowflake, Azure, GCS and more.
  </Card>
</CardGroup>


# Google Scraper API
Source: https://docs.brightdata.com/datasets/scrapers/google/introduction

Extract structured data from Google Maps, Shopping, SERP, Flights, Hotels and more using the Bright Data Google Scraper API. Handles up to 100 organic results.

Send a Google URL or a keyword, get structured JSON back. The Bright Data Google Scraper API covers Maps, Shopping, Search results, AI Mode Search, Flights and Hotels with consistent request and response shapes.

<Tip>
  New to Bright Data? [Create a free account](https://brightdata.com/cp/start) and get \$2 credit to start scraping.
</Tip>

## How it works

You send one or more Google URLs, keywords or structured inputs to the Bright Data Google Scraper API. Bright Data handles proxies, CAPTCHAs and parsing, then returns clean JSON.

```text theme={null}
Your app  -->  Bright Data API  -->  Structured JSON
           POST /datasets/v3/scrape
           Authorization: Bearer YOUR_API_KEY
```

All requests use a `dataset_id` to specify the Google product and return results in JSON, NDJSON, JSON Lines or CSV.

## Supported data types

<CardGroup>
  <Card title="Google Maps" icon="map-location-dot" href="/api-reference/scrapers/search-engines-apis/google-maps-collect-by-url">
    Places, reviews, ratings, photos and community stats. Collect by URL or discover by CID, place ID or geographic location.
  </Card>

  <Card title="Google Maps Reviews" icon="star" href="/api-reference/scrapers/search-engines-apis/google-maps-reviews-collect-by-url">
    Full review text, ratings and reviewer metadata, filtered by a configurable lookback window.
  </Card>

  <Card title="Google Shopping" icon="bag-shopping" href="/api-reference/scrapers/search-engines-apis/google-shopping-collect-by-url">
    Product listings, pricing, merchants and specifications. Collect by URL or discover by keyword.
  </Card>

  <Card title="Google Shopping Search US" icon="store" href="/api-reference/scrapers/search-engines-apis/google-shopping-products-search-us-collect-by-url">
    US-focused product search results with expanded merchant and pricing coverage.
  </Card>

  <Card title="Google SERP 100 Results" icon="magnifying-glass" href="/scraping-automation/serp-api/get-top-100-google-results">
    Up to 100 organic results per query with language, device and geographic targeting.
  </Card>

  <Card title="Google AI Mode Search" icon="robot" href="/api-reference/scrapers/search-engines-apis/google-ai-mode-search-collect-by-url">
    Answers and citations from Google's AI-powered search experience.
  </Card>

  <Card title="Google Flights" icon="plane" href="/api-reference/scrapers/search-engines-apis/google-flights-collect-by-url">
    Flight options, pricing and itineraries. Collect by URL or discover by route and dates.
  </Card>

  <Card title="Google Hotels" icon="bed" href="/api-reference/scrapers/search-engines-apis/google-hotel-collect-by-url">
    Hotel rates, availability and amenities. Collect by URL, filter URL or search parameters.
  </Card>
</CardGroup>

## Which dataset IDs to use

Each Google product uses its own `dataset_id`. Pass the ID as a query parameter on every request.

| Product                            | Dataset ID              |
| :--------------------------------- | :---------------------- |
| Google Maps full info              | `gd_m8ebnr0q2qlklc02fz` |
| Google Maps Reviews                | `gd_luzfs1dn2oa0teb81`  |
| Google Shopping                    | `gd_ltppk50q18kdw67omz` |
| Google Shopping products search US | `gd_m31f2k0d2m1bah4f3b` |
| Google SERP 100 Results            | `gd_mfz5x93lmsjjjylob`  |
| Google AI Mode Search              | `gd_mcswdt6z2elth3zqr2` |
| Google Flights                     | `gd_mhng7wen1rw0a3gvpf` |
| Google Hotels                      | `gd_mg3gjfmg12tc2n5d4d` |

## Request methods

The Google Scraper API supports two request methods. Choose based on your volume and latency needs.

| Method           | Endpoint                                                  | Best for                                                |
| :--------------- | :-------------------------------------------------------- | :------------------------------------------------------ |
| **Synchronous**  | [`/scrape`](/datasets/scrapers/google/send-first-request) | Real-time lookups, up to 20 inputs                      |
| **Asynchronous** | [`/trigger`](/datasets/scrapers/google/async-requests)    | Batch jobs, 20+ inputs, discovery, production pipelines |

Learn more in [Understanding sync vs. async requests](/datasets/scrapers/concepts/sync-vs-async).

## Capabilities and limits

| Capability                       | Detail                                                                                                                        |
| :------------------------------- | :---------------------------------------------------------------------------------------------------------------------------- |
| **Output formats**               | JSON, NDJSON, JSON Lines, CSV                                                                                                 |
| **Max inputs per sync request**  | 20                                                                                                                            |
| **Max inputs per async request** | 5,000                                                                                                                         |
| **Data freshness**               | Real-time (scraped on demand)                                                                                                 |
| **Delivery options**             | API download, webhook, Amazon S3, Snowflake, Azure, GCS ([all options](/datasets/scrapers/scrapers-library/delivery-options)) |
| **Pricing**                      | Pay per successful record ([see pricing](https://brightdata.com/pricing/web-scraper))                                         |

## Common questions

<Accordion title="Is the data scraped in real time?">
  Yes. Each request triggers a live scrape against Google. There is no cached or stale data. Response times vary by endpoint: Collect-by-URL requests typically return in 10 to 30 seconds, while discovery requests may take longer depending on result volume.
</Accordion>

<Accordion title="What is the difference between Collect and Discover?">
  **Collect by URL** scrapes a specific Google page you provide, such as a single Maps place, a Shopping product or a SERP URL. **Discover** finds Google records matching search criteria such as a keyword, a CID or a geographic area, then scrapes the results. Discovery is most useful via async requests when you don't know the exact URLs up front.
</Accordion>

<Accordion title="Can I target a specific country or language?">
  Yes. Most endpoints accept a `country` parameter (ISO 3166-1 alpha-2 code), and the SERP 100 endpoint also accepts `language` and `uule` for geographic targeting. See each endpoint's reference page for the full parameter list.
</Accordion>

<Accordion title="How is this different from scraping using proxies or Web Unlocker?">
  When scraping with proxies or Web Unlocker, you still need to write and maintain your own parsing logic and update it whenever Google changes its page structure. The Google Scraper API handles the entire stack: proxy rotation, anti-bot bypassing and parsing. You send a URL or keyword and get clean, structured JSON back with no scraping infrastructure or parser maintenance on your end.
</Accordion>

## Next steps

<CardGroup>
  <Card title="Quickstart" icon="rocket" href="/datasets/scrapers/google/quickstart">
    Scrape your first Google Maps place in 5 minutes.
  </Card>

  <Card title="Send your first request" icon="bolt" href="/datasets/scrapers/google/send-first-request">
    Full code examples for every endpoint in cURL, Python and Node.js.
  </Card>

  <Card title="API reference" icon="code" href="/api-reference/scrapers/search-engines-apis/google-maps-collect-by-url">
    Endpoint specs, parameters and response schemas.
  </Card>
</CardGroup>


# Google scraper quickstart
Source: https://docs.brightdata.com/datasets/scrapers/google/quickstart

Set up the Bright Data Google Scraper API and collect your first Google Maps place as structured JSON in under 5 minutes from the Control Panel.

This tutorial shows you how to scrape a Google Maps place and get structured JSON data using the Bright Data Google Scraper API.

## Prerequisites

* A [Bright Data account](https://brightdata.com/cp/start) (includes \$2 free credit)
* cURL, Python 3 or Node.js 18+ installed

<Steps>
  <Step title="Get your API key">
    Go to the [user settings page](https://brightdata.com/cp/setting/users) in your Bright Data account and copy your API key.

    If you don't have an account yet, [sign up at brightdata.com](https://brightdata.com/cp/start). New users get \$2 free credit for testing.

    <Warning>
      Your API key is shown only once when created. Copy and store it securely.
    </Warning>
  </Step>

  <Step title="Send a request">
    We'll use the **Google Maps, Collect by URL** endpoint with a synchronous request. Replace `YOUR_API_KEY` with your actual token:

    <CodeGroup>
      ```bash cURL theme={null}
      curl -X POST \
        "https://api.brightdata.com/datasets/v3/scrape?dataset_id=gd_m8ebnr0q2qlklc02fz&format=json" \
        -H "Authorization: Bearer YOUR_API_KEY" \
        -H "Content-Type: application/json" \
        -d '[{"url": "https://www.google.com/maps/place/Empire+State+Building"}]'
      ```

      ```python Python theme={null}
      import requests

      response = requests.post(
          "https://api.brightdata.com/datasets/v3/scrape",
          params={"dataset_id": "gd_m8ebnr0q2qlklc02fz", "format": "json"},
          headers={
              "Authorization": "Bearer YOUR_API_KEY",
              "Content-Type": "application/json",
          },
          json=[{"url": "https://www.google.com/maps/place/Empire+State+Building"}],
      )

      print(response.json())
      ```

      ```javascript Node.js theme={null}
      const response = await fetch(
        "https://api.brightdata.com/datasets/v3/scrape?dataset_id=gd_m8ebnr0q2qlklc02fz&format=json",
        {
          method: "POST",
          headers: {
            "Authorization": "Bearer YOUR_API_KEY",
            "Content-Type": "application/json",
          },
          body: JSON.stringify([
            { url: "https://www.google.com/maps/place/Empire+State+Building" }
          ]),
        }
      );

      const data = await response.json();
      console.log(data);
      ```
    </CodeGroup>

    You should see a `200` status code. This takes 10 to 30 seconds.
  </Step>

  <Step title="Review the response">
    The Bright Data Google Scraper API returns a JSON array with structured place data:

    ```json theme={null}
    [
      {
        "place_id": "ChIJaXQRs6lZwokRY6EFpJnhNNE",
        "name": "Empire State Building",
        "address": "20 W 34th St., New York, NY 10001",
        "category": "Observation deck",
        "rating": 4.7,
        "reviews_count": 98500,
        "phone": "+1 212-736-3100",
        "website": "https://www.esbnyc.com/",
        "latitude": 40.7484405,
        "longitude": -73.9856644,
        "open_hours": {},
        "photos": [],
        "url": "https://www.google.com/maps/place/Empire+State+Building"
      }
    ]
    ```

    Each place object includes location details, ratings, hours, photos and contact info. See the [full response schema](/api-reference/scrapers/search-engines-apis/google-maps-collect-by-url).
  </Step>
</Steps>

You've successfully scraped your first Google Maps place using the Bright Data Google Scraper API.

## Common questions

<Accordion title="Can I scrape multiple places in one request?">
  Yes. Add more objects to the input array. Synchronous requests support up to 20 inputs. For larger batches or for discovery by keyword, CID or location, use the [async `/trigger` endpoint](/datasets/scrapers/google/async-requests).

  ```json theme={null}
  [
    {"url": "https://www.google.com/maps/place/Empire+State+Building"},
    {"url": "https://www.google.com/maps/place/Central+Park"},
    {"url": "https://www.google.com/maps/place/Times+Square"}
  ]
  ```
</Accordion>

<Accordion title="Can I scrape Google Shopping or SERP instead?">
  Yes. Swap the `dataset_id` for the product you need. For example, Google Shopping Collect by URL uses `gd_ltppk50q18kdw67omz`, and Google SERP 100 uses `gd_mfz5x93lmsjjjylob`. See [Send your first request](/datasets/scrapers/google/send-first-request) for working examples of every endpoint.
</Accordion>

<Accordion title="Getting a 401 or 403 error?">
  Verify your API key is correct and hasn't expired. Generate a new token from [Account settings](https://brightdata.com/cp/setting/users). See the [authentication guide](/api-reference/authentication) for details.
</Accordion>

<Accordion title="Request is timing out?">
  Synchronous requests have a 1-minute timeout. If the request exceeds this limit, it automatically switches to async and returns a `snapshot_id`. Use the [async workflow](/datasets/scrapers/google/async-requests) for large batches.
</Accordion>

<Accordion title="Empty or partial response data?">
  Verify the Google URL is publicly accessible and correctly formatted. For Google Maps, the URL should follow the pattern `https://www.google.com/maps/place/...`. For Shopping and SERP, verify the URL works in an incognito browser window.
</Accordion>

## Next steps

<CardGroup>
  <Card title="Send your first request" icon="bolt" href="/datasets/scrapers/google/send-first-request">
    Explore every endpoint with full examples in cURL, Python and Node.js.
  </Card>

  <Card title="Async batch requests" icon="layer-group" href="/datasets/scrapers/google/async-requests">
    Scrape thousands of places or run discovery in a single batch job.
  </Card>

  <Card title="API reference" icon="code" href="/api-reference/scrapers/search-engines-apis/google-maps-collect-by-url">
    Endpoint specs, parameters and response schemas.
  </Card>
</CardGroup>


# Send your first Google API request
Source: https://docs.brightdata.com/datasets/scrapers/google/send-first-request

Send synchronous requests to every Bright Data Google Scraper API endpoint with copy-paste examples for Maps, Trends, reviews and Play Store across 4 surfaces.

This tutorial walks you through sending a synchronous request to each Bright Data Google Scraper API endpoint. By the end, you'll have working examples for Maps, Reviews, Shopping, SERP, AI Mode, Flights and Hotels.

## Prerequisites

* A [Bright Data account](https://brightdata.com/cp/start) with an active API key
* Completed the [Quickstart](/datasets/scrapers/google/quickstart)

## Request structure

Every synchronous request follows the same pattern:

```http theme={null}
POST https://api.brightdata.com/datasets/v3/scrape?dataset_id={DATASET_ID}&format=json
Authorization: Bearer YOUR_API_KEY
Content-Type: application/json

[{"url": "https://www.google.com/..."}]
```

The only things that change between endpoints are the `dataset_id`, the optional discovery query parameters and the input shape.

<Note>
  Synchronous requests support up to 20 inputs and have a 1-minute timeout. If the request takes longer, the API automatically returns a `snapshot_id` instead. See [async requests](/datasets/scrapers/google/async-requests).
</Note>

## Google Maps, Collect by URL

Scrape a specific Google Maps place by its URL.

**Dataset ID:** `gd_m8ebnr0q2qlklc02fz`

<CodeGroup>
  ```bash cURL theme={null}
  curl -X POST \
    "https://api.brightdata.com/datasets/v3/scrape?dataset_id=gd_m8ebnr0q2qlklc02fz&format=json" \
    -H "Authorization: Bearer YOUR_API_KEY" \
    -H "Content-Type: application/json" \
    -d '[{"url": "https://www.google.com/maps/place/Empire+State+Building"}]'
  ```

  ```python Python theme={null}
  import requests

  response = requests.post(
      "https://api.brightdata.com/datasets/v3/scrape",
      params={"dataset_id": "gd_m8ebnr0q2qlklc02fz", "format": "json"},
      headers={
          "Authorization": "Bearer YOUR_API_KEY",
          "Content-Type": "application/json",
      },
      json=[{"url": "https://www.google.com/maps/place/Empire+State+Building"}],
  )

  print(response.json())
  ```

  ```javascript Node.js theme={null}
  const response = await fetch(
    "https://api.brightdata.com/datasets/v3/scrape?dataset_id=gd_m8ebnr0q2qlklc02fz&format=json",
    {
      method: "POST",
      headers: {
        "Authorization": "Bearer YOUR_API_KEY",
        "Content-Type": "application/json",
      },
      body: JSON.stringify([
        { url: "https://www.google.com/maps/place/Empire+State+Building" }
      ]),
    }
  );

  const data = await response.json();
  console.log(data);
  ```
</CodeGroup>

[Full schema](/api-reference/scrapers/search-engines-apis/google-maps-collect-by-url)

## Google Maps, Discover by CID

Find a Google Maps place using its Customer ID (CID) value.

**Dataset ID:** `gd_m8ebnr0q2qlklc02fz`

```bash cURL theme={null}
curl -X POST \
  "https://api.brightdata.com/datasets/v3/scrape?dataset_id=gd_m8ebnr0q2qlklc02fz&format=json&type=discover_new&discover_by=cid" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '[{"CID": "14408248692727049506"}]'
```

[Full schema](/api-reference/scrapers/search-engines-apis/google-maps-discover-by-cid)

## Google Maps, Discover by place\_id

Find a place using its Google Maps place ID.

**Dataset ID:** `gd_m8ebnr0q2qlklc02fz`

```bash cURL theme={null}
curl -X POST \
  "https://api.brightdata.com/datasets/v3/scrape?dataset_id=gd_m8ebnr0q2qlklc02fz&format=json&type=discover_new&discover_by=place_id" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '[{"place_id": "ChIJS5WVcqWh9YgRHU08rJqLNsQ"}]'
```

[Full schema](/api-reference/scrapers/search-engines-apis/google-maps-discover-by-place-id)

## Google Maps, Discover by location

Find places near a geographic point using latitude, longitude, zoom level and a search keyword.

**Dataset ID:** `gd_m8ebnr0q2qlklc02fz`

```bash cURL theme={null}
curl -X POST \
  "https://api.brightdata.com/datasets/v3/scrape?dataset_id=gd_m8ebnr0q2qlklc02fz&format=json&type=discover_new&discover_by=location" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '[{"country": "US", "lat": 40.7484, "long": -73.9857, "zoom_level": 14, "keyword": "coffee shop"}]'
```

[Full schema](/api-reference/scrapers/search-engines-apis/google-maps-discover-by-location)

## Google Maps Reviews, Collect by URL

Scrape reviews for a Google Maps place, optionally limiting to reviews posted within the last N days.

**Dataset ID:** `gd_luzfs1dn2oa0teb81`

<CodeGroup>
  ```bash cURL theme={null}
  curl -X POST \
    "https://api.brightdata.com/datasets/v3/scrape?dataset_id=gd_luzfs1dn2oa0teb81&format=json" \
    -H "Authorization: Bearer YOUR_API_KEY" \
    -H "Content-Type: application/json" \
    -d '[{"url": "https://www.google.com/maps/place/Empire+State+Building", "days_limit": 30}]'
  ```

  ```python Python theme={null}
  import requests

  response = requests.post(
      "https://api.brightdata.com/datasets/v3/scrape",
      params={"dataset_id": "gd_luzfs1dn2oa0teb81", "format": "json"},
      headers={
          "Authorization": "Bearer YOUR_API_KEY",
          "Content-Type": "application/json",
      },
      json=[{"url": "https://www.google.com/maps/place/Empire+State+Building", "days_limit": 30}],
  )

  print(response.json())
  ```
</CodeGroup>

[Full schema](/api-reference/scrapers/search-engines-apis/google-maps-reviews-collect-by-url)

## Google Shopping, Collect by URL

Scrape a Google Shopping product page by its URL, with optional country targeting.

**Dataset ID:** `gd_ltppk50q18kdw67omz`

```bash cURL theme={null}
curl -X POST \
  "https://api.brightdata.com/datasets/v3/scrape?dataset_id=gd_ltppk50q18kdw67omz&format=json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '[{"url": "https://www.google.com/shopping/product/12345", "country": "US"}]'
```

[Full schema](/api-reference/scrapers/search-engines-apis/google-shopping-collect-by-url)

## Google Shopping, Discover by keyword

Find Google Shopping products matching a search term, with optional country targeting.

**Dataset ID:** `gd_ltppk50q18kdw67omz`

```bash cURL theme={null}
curl -X POST \
  "https://api.brightdata.com/datasets/v3/scrape?dataset_id=gd_ltppk50q18kdw67omz&format=json&type=discover_new&discover_by=keyword" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '[{"keyword": "wireless headphones", "country": "US"}]'
```

[Full schema](/api-reference/scrapers/search-engines-apis/google-shopping-discover-by-keyword)

## Google Shopping Products Search US, Collect by URL

US-focused Google Shopping search result scraper.

**Dataset ID:** `gd_m31f2k0d2m1bah4f3b`

```bash cURL theme={null}
curl -X POST \
  "https://api.brightdata.com/datasets/v3/scrape?dataset_id=gd_m31f2k0d2m1bah4f3b&format=json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '[{"url": "https://www.google.com/search?tbm=shop&q=wireless+headphones"}]'
```

[Full schema](/api-reference/scrapers/search-engines-apis/google-shopping-products-search-us-collect-by-url)

## Google SERP 100 Results, Collect by URL

Scrape up to 100 organic results from a Google Search URL with fine-grained targeting.

**Dataset ID:** `gd_mfz5x93lmsjjjylob`

```bash cURL theme={null}
curl -X POST \
  "https://api.brightdata.com/datasets/v3/scrape?dataset_id=gd_mfz5x93lmsjjjylob&format=json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '[{
    "url": "https://www.google.com/search?q=best+coffee+nyc",
    "keyword": "best coffee nyc",
    "tbm": "",
    "language": "en",
    "uule": "",
    "brd_mobile": "",
    "tbs": "",
    "nfpr": "",
    "index": ""
  }]'
```

[Full schema](/scraping-automation/serp-api/get-top-100-google-results)

## Google AI Mode Search, Collect by URL

Scrape answers and citations from Google's AI Mode Search.

**Dataset ID:** `gd_mcswdt6z2elth3zqr2`

```bash cURL theme={null}
curl -X POST \
  "https://api.brightdata.com/datasets/v3/scrape?dataset_id=gd_mcswdt6z2elth3zqr2&format=json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '[{
    "url": "https://www.google.com/search?udm=50&q=how+to+train+for+a+marathon",
    "prompt": "how to train for a marathon",
    "country": "US"
  }]'
```

[Full schema](/api-reference/scrapers/search-engines-apis/google-ai-mode-search-collect-by-url)

## Google Flights, Collect by URL

Scrape flight options, pricing and itineraries from a Google Flights URL.

**Dataset ID:** `gd_mhng7wen1rw0a3gvpf`

```bash cURL theme={null}
curl -X POST \
  "https://api.brightdata.com/datasets/v3/scrape?dataset_id=gd_mhng7wen1rw0a3gvpf&format=json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '[{"url": "https://www.google.com/travel/flights?tfs=..."}]'
```

[Full schema](/api-reference/scrapers/search-engines-apis/google-flights-collect-by-url)

## Google Flights, Discover by input filters

Find flights by origin, destination, dates and passenger counts.

**Dataset ID:** `gd_mhng7wen1rw0a3gvpf`

```bash cURL theme={null}
curl -X POST \
  "https://api.brightdata.com/datasets/v3/scrape?dataset_id=gd_mhng7wen1rw0a3gvpf&format=json&type=discover_new&discover_by=input_filters" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '[{
    "origin": "JFK",
    "destination": "LAX",
    "departure": "2026-06-15",
    "return": "2026-06-22",
    "trip_type": "round_trip",
    "adults": 1,
    "children": 0,
    "infants_in_seat": 0,
    "infants_on_lap": 0,
    "cabin": "economy"
  }]'
```

[Full schema](/api-reference/scrapers/search-engines-apis/google-flights-discover-by-input-filters)

## Google Hotels, Collect by URL

Scrape a Google Hotels listing by its URL, with optional country targeting.

**Dataset ID:** `gd_mg3gjfmg12tc2n5d4d`

```bash cURL theme={null}
curl -X POST \
  "https://api.brightdata.com/datasets/v3/scrape?dataset_id=gd_mg3gjfmg12tc2n5d4d&format=json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '[{"url": "https://www.google.com/travel/hotels/entity/...", "country": "US"}]'
```

[Full schema](/api-reference/scrapers/search-engines-apis/google-hotel-collect-by-url)

## Google Hotels, Discover by filter URL

Discover hotels from a filtered Google Hotels URL.

**Dataset ID:** `gd_mg3gjfmg12tc2n5d4d`

```bash cURL theme={null}
curl -X POST \
  "https://api.brightdata.com/datasets/v3/scrape?dataset_id=gd_mg3gjfmg12tc2n5d4d&format=json&type=discover_new&discover_by=filter_url" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '[{
    "url": "https://www.google.com/travel/hotels/New+York?...",
    "country": "US",
    "currency": "USD"
  }]'
```

[Full schema](/api-reference/scrapers/search-engines-apis/google-hotel-discover-by-filter-url)

## Google Hotels, Discover by search

Discover hotels by destination, dates and guest count.

**Dataset ID:** `gd_mg3gjfmg12tc2n5d4d`

```bash cURL theme={null}
curl -X POST \
  "https://api.brightdata.com/datasets/v3/scrape?dataset_id=gd_mg3gjfmg12tc2n5d4d&format=json&type=discover_new&discover_by=search" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '[{
    "search_term": "New York",
    "check_in_date": "2026-06-15",
    "check_out_date": "2026-06-18",
    "guest_number": 2,
    "country": "US",
    "currency": "USD"
  }]'
```

[Full schema](/api-reference/scrapers/search-engines-apis/google-hotel-discover-by-search)

## Next steps

<CardGroup>
  <Card title="Async batch requests" icon="layer-group" href="/datasets/scrapers/google/async-requests">
    Scrape thousands of records or run discovery jobs in a single async request.
  </Card>

  <Card title="API reference" icon="code" href="/api-reference/scrapers/search-engines-apis/google-maps-collect-by-url">
    Full endpoint specs, parameters and response schemas.
  </Card>
</CardGroup>


# How to scrape Instagram data in bulk
Source: https://docs.brightdata.com/datasets/scrapers/instagram/async-requests

Trigger large-scale Instagram scraping jobs, monitor progress, and retrieve results using the Bright Data async /trigger endpoint. Supports batches of 20 URLs.

This guide shows you how to scrape Instagram data at scale using the asynchronous `/trigger` endpoint. Use this when you have more than 20 URLs, need discovery, or want delivery to a webhook or S3.

<Tip>
  Not sure whether to use sync or async? Read [Understanding sync vs. async requests](/datasets/scrapers/concepts/sync-vs-async).
</Tip>

## Prerequisites

* A [Bright Data account](https://brightdata.com/cp/start) with an active API key
* Familiarity with the [synchronous request flow](/datasets/scrapers/instagram/send-first-request)

## Step 1: Trigger the collection

Send a `POST` request to the `/trigger` endpoint with your input URLs:

<CodeGroup>
  ```bash cURL theme={null}
  curl -X POST \
    "https://api.brightdata.com/datasets/v3/trigger?dataset_id=gd_l1vikfch901nx3by4&format=json" \
    -H "Authorization: Bearer YOUR_API_KEY" \
    -H "Content-Type: application/json" \
    -d '[
      {"url": "https://www.instagram.com/instagram"},
      {"url": "https://www.instagram.com/natgeo"},
      {"url": "https://www.instagram.com/nasa"},
      {"url": "https://www.instagram.com/nike"},
      {"url": "https://www.instagram.com/cristiano"}
    ]'
  ```

  ```python Python theme={null}
  import requests

  response = requests.post(
      "https://api.brightdata.com/datasets/v3/trigger",
      params={
          "dataset_id": "gd_l1vikfch901nx3by4",
          "format": "json",
      },
      headers={
          "Authorization": "Bearer YOUR_API_KEY",
          "Content-Type": "application/json",
      },
      json=[
          {"url": "https://www.instagram.com/instagram"},
          {"url": "https://www.instagram.com/natgeo"},
          {"url": "https://www.instagram.com/nasa"},
          {"url": "https://www.instagram.com/nike"},
          {"url": "https://www.instagram.com/cristiano"},
      ],
  )

  snapshot = response.json()
  print("Snapshot ID:", snapshot["snapshot_id"])
  ```

  ```javascript Node.js theme={null}
  const response = await fetch(
    "https://api.brightdata.com/datasets/v3/trigger?dataset_id=gd_l1vikfch901nx3by4&format=json",
    {
      method: "POST",
      headers: {
        "Authorization": "Bearer YOUR_API_KEY",
        "Content-Type": "application/json",
      },
      body: JSON.stringify([
        { url: "https://www.instagram.com/instagram" },
        { url: "https://www.instagram.com/natgeo" },
        { url: "https://www.instagram.com/nasa" },
        { url: "https://www.instagram.com/nike" },
        { url: "https://www.instagram.com/cristiano" },
      ]),
    }
  );

  const snapshot = await response.json();
  console.log("Snapshot ID:", snapshot.snapshot_id);
  ```
</CodeGroup>

You should see a `200` response with a `snapshot_id`:

```json theme={null}
{
  "snapshot_id": "s_m1a2b3c4d5e6f7g8h"
}
```

Save this ID. You need it to check progress and download results.

## Step 2: Monitor progress

Poll the snapshot status until it shows `ready`. This takes 30 seconds to several minutes depending on the number of URLs.

<CodeGroup>
  ```bash cURL theme={null}
  curl "https://api.brightdata.com/datasets/v3/progress/s_m1a2b3c4d5e6f7g8h" \
    -H "Authorization: Bearer YOUR_API_KEY"
  ```

  ```python Python theme={null}
  import time

  snapshot_id = "s_m1a2b3c4d5e6f7g8h"

  while True:
      status_response = requests.get(
          f"https://api.brightdata.com/datasets/v3/progress/{snapshot_id}",
          headers={"Authorization": "Bearer YOUR_API_KEY"},
      )
      status = status_response.json().get("status")
      print(f"Status: {status}")

      if status == "ready":
          break
      time.sleep(10)
  ```

  ```javascript Node.js theme={null}
  const snapshotId = "s_m1a2b3c4d5e6f7g8h";

  let status = "collecting";
  while (status !== "ready") {
    const statusResponse = await fetch(
      `https://api.brightdata.com/datasets/v3/progress/${snapshotId}`,
      { headers: { "Authorization": "Bearer YOUR_API_KEY" } }
    );
    const statusData = await statusResponse.json();
    status = statusData.status;
    console.log("Status:", status);

    if (status !== "ready") {
      await new Promise((r) => setTimeout(r, 10000));
    }
  }
  ```
</CodeGroup>

Status values:

| Status       | Meaning                             |
| :----------- | :---------------------------------- |
| `collecting` | Scraping is in progress             |
| `digesting`  | Data is being processed             |
| `ready`      | Results are available for download  |
| `failed`     | The collection encountered an error |

## Step 3: Download results

Once the status is `ready`, download the scraped data:

<CodeGroup>
  ```bash cURL theme={null}
  curl "https://api.brightdata.com/datasets/v3/snapshot/s_m1a2b3c4d5e6f7g8h?format=json" \
    -H "Authorization: Bearer YOUR_API_KEY" \
    -o results.json
  ```

  ```python Python theme={null}
  results_response = requests.get(
      f"https://api.brightdata.com/datasets/v3/snapshot/{snapshot_id}",
      params={"format": "json"},
      headers={"Authorization": "Bearer YOUR_API_KEY"},
  )

  results = results_response.json()
  print(f"Collected {len(results)} profiles")
  ```

  ```javascript Node.js theme={null}
  const resultsResponse = await fetch(
    `https://api.brightdata.com/datasets/v3/snapshot/${snapshotId}?format=json`,
    { headers: { "Authorization": "Bearer YOUR_API_KEY" } }
  );

  const results = await resultsResponse.json();
  console.log(`Collected ${results.length} profiles`);
  ```
</CodeGroup>

You've successfully triggered, monitored, and downloaded a batch Instagram scraping job.

## Skip polling with webhooks

If you don't want to poll for status, add an `endpoint` parameter to receive results automatically:

```bash theme={null}
curl -X POST \
  "https://api.brightdata.com/datasets/v3/trigger?dataset_id=gd_l1vikfch901nx3by4&format=json&endpoint=https://your-server.com/webhook" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '[{"url": "https://www.instagram.com/instagram"}]'
```

See [How to receive Instagram data via webhooks](/datasets/scrapers/instagram/data-delivery/webhooks) for the full setup.

## Limits and constraints

| Constraint                           | Value      |
| :----------------------------------- | :--------- |
| Max input file size                  | 1 GB       |
| Max concurrent batch requests        | 100        |
| Max concurrent single-input requests | 1,500      |
| Webhook delivery size                | Up to 1 GB |
| API download size                    | Up to 5 GB |

## Troubleshooting

<Accordion title="Getting a 429 Too Many Requests error?">
  You've exceeded the concurrent request limit. Reduce the number of parallel requests or combine inputs into fewer, larger batches. Each batch can include up to 1 GB of input data.
</Accordion>

<Accordion title="Snapshot status shows 'failed'?">
  Check that all input URLs are valid Instagram URLs. Review the error details in the snapshot response or in the [Logs tab](https://brightdata.com/cp/scrapers) of your Bright Data dashboard.
</Accordion>

<Accordion title="Results are incomplete or missing some URLs?">
  Some URLs may fail individually while the overall job succeeds. Check the snapshot response for any `errors` field. Retry failed URLs in a separate request.
</Accordion>

## Next steps

<CardGroup>
  <Card title="Set up webhooks" icon="webhook" href="/datasets/scrapers/instagram/data-delivery/webhooks">
    Receive results without polling.
  </Card>

  <Card title="Deliver to S3" icon="bucket" href="/datasets/scrapers/instagram/data-delivery/amazon-s3">
    Send results directly to your S3 bucket.
  </Card>
</CardGroup>


# Instagram data delivery to Amazon S3
Source: https://docs.brightdata.com/datasets/scrapers/instagram/data-delivery/amazon-s3

Configure the Bright Data Instagram Scraper API to deliver scraped profiles, posts and reels data directly to your Amazon S3 bucket on job completion.

This guide shows you how to configure the Bright Data Instagram Scraper API to deliver scraped data directly to your Amazon S3 bucket when a collection job completes.

## Prerequisites

* A [Bright Data account](https://brightdata.com/cp/start) with an active API key
* An AWS account with an S3 bucket
* IAM credentials with write access to the bucket
* Familiarity with the [async request workflow](/datasets/scrapers/instagram/async-requests)

## Step 1: Create an S3 bucket

If you already have a bucket, skip to Step 2.

In the [AWS S3 Console](https://s3.console.aws.amazon.com/s3/buckets):

1. Click **Create bucket**
2. Enter a bucket name (e.g., `instagram-scraper-data`)
3. Select your preferred AWS region
4. Keep default settings and click **Create bucket**

## Step 2: Set up IAM permissions

Create an IAM role that grants Bright Data write access to your bucket.

### Create a policy

In the [IAM Console](https://console.aws.amazon.com/iam/), go to **Policies** and create a new policy with this JSON:

```json theme={null}
{
  "Version": "2012-10-17",
  "Statement": [
    {
      "Effect": "Allow",
      "Action": ["s3:PutObject", "s3:GetObject"],
      "Resource": "arn:aws:s3:::instagram-scraper-data/*"
    }
  ]
}
```

Replace `instagram-scraper-data` with your actual bucket name.

### Create a role for Bright Data

1. Go to **Roles** > **Create role**
2. Select **AWS account** as the trusted entity type
3. Enter Bright Data's AWS account ID: `422310177405`
4. Attach the policy you created above
5. Name the role (e.g., `BrightDataS3Delivery`)
6. Note the role ARN (e.g., `arn:aws:iam::123456789012:role/BrightDataS3Delivery`)

Add an external ID condition to the trust policy:

```json theme={null}
{
  "Version": "2012-10-17",
  "Statement": [
    {
      "Effect": "Allow",
      "Principal": {
        "AWS": "arn:aws:iam::422310177405:role/brd.ec2.zs-dca-delivery"
      },
      "Action": "sts:AssumeRole",
      "Condition": {
        "StringEquals": {
          "sts:ExternalId": "YOUR_BRIGHT_DATA_CUSTOMER_ID"
        }
      }
    }
  ]
}
```

Find your customer ID in [Account settings](https://brightdata.com/cp/setting/customer_details).

## Step 3: Configure delivery in Bright Data

1. Navigate to your [scraper configuration](https://brightdata.com/cp/scrapers)
2. Click the **Delivery settings** tab
3. Select **Amazon S3** as the delivery destination
4. Enter your credentials:
   * **Bucket name**: Your S3 bucket name
   * **Role ARN**: The IAM role ARN from Step 2
   * **Region**: Your S3 bucket region
   * **Path prefix** (optional): A folder path within the bucket (e.g., `instagram/profiles/`)
5. Select your preferred file format (JSON, NDJSON, or CSV)
6. Click **Save**

## Step 4: Trigger a collection

Trigger an async collection. Results are automatically delivered to your S3 bucket:

<CodeGroup>
  ```bash cURL theme={null}
  curl -X POST \
    "https://api.brightdata.com/datasets/v3/trigger?dataset_id=gd_l1vikfch901nx3by4&format=json" \
    -H "Authorization: Bearer YOUR_API_KEY" \
    -H "Content-Type: application/json" \
    -d '[
      {"url": "https://www.instagram.com/instagram"},
      {"url": "https://www.instagram.com/natgeo"},
      {"url": "https://www.instagram.com/nasa"}
    ]'
  ```

  ```python Python theme={null}
  import requests

  response = requests.post(
      "https://api.brightdata.com/datasets/v3/trigger",
      params={"dataset_id": "gd_l1vikfch901nx3by4", "format": "json"},
      headers={
          "Authorization": "Bearer YOUR_API_KEY",
          "Content-Type": "application/json",
      },
      json=[
          {"url": "https://www.instagram.com/instagram"},
          {"url": "https://www.instagram.com/natgeo"},
          {"url": "https://www.instagram.com/nasa"},
      ],
  )

  print("Snapshot ID:", response.json()["snapshot_id"])
  ```

  ```javascript Node.js theme={null}
  const response = await fetch(
    "https://api.brightdata.com/datasets/v3/trigger?dataset_id=gd_l1vikfch901nx3by4&format=json",
    {
      method: "POST",
      headers: {
        "Authorization": "Bearer YOUR_API_KEY",
        "Content-Type": "application/json",
      },
      body: JSON.stringify([
        { url: "https://www.instagram.com/instagram" },
        { url: "https://www.instagram.com/natgeo" },
        { url: "https://www.instagram.com/nasa" },
      ]),
    }
  );

  const data = await response.json();
  console.log("Snapshot ID:", data.snapshot_id);
  ```
</CodeGroup>

## Step 5: Verify delivery

Once the collection completes, check your S3 bucket for the delivered file:

```bash theme={null}
aws s3 ls s3://instagram-scraper-data/instagram/profiles/
```

You should see a file named with the snapshot ID (e.g., `s_m1a2b3c4d5e6f7g8h.json`).

Download and inspect it:

```bash theme={null}
aws s3 cp s3://instagram-scraper-data/instagram/profiles/s_m1a2b3c4d5e6f7g8h.json ./results.json
cat results.json | python -m json.tool | head -20
```

You can also verify delivery status using the [Monitor Delivery API](/api-reference/scrapers/management-apis/monitor-delivery).

## Troubleshooting

<Accordion title="Files not appearing in S3?">
  * Verify the IAM role ARN and external ID are correct
  * Check that the bucket policy allows `s3:PutObject` from Bright Data's account
  * Ensure the bucket region matches your configuration
  * Review delivery status in the Bright Data dashboard under **Logs**
</Accordion>

<Accordion title="Access denied errors?">
  Verify the trust policy on your IAM role includes Bright Data's account (`422310177405`) and your external ID matches your Bright Data customer ID found in [Account settings](https://brightdata.com/cp/setting/customer_details).
</Accordion>

<Accordion title="Delivered file is empty or missing records?">
  Check the collection status in the Bright Data dashboard. If some URLs failed, the delivered file contains only successful results. Retry failed URLs in a separate request.
</Accordion>

## Next steps

<CardGroup>
  <Card title="Set up webhooks" icon="webhook" href="/datasets/scrapers/instagram/data-delivery/webhooks">
    Receive results at your HTTP endpoint.
  </Card>

  <Card title="All delivery options" icon="truck" href="/datasets/scrapers/scrapers-library/delivery-options">
    Snowflake, Azure, GCS, SFTP, and more.
  </Card>
</CardGroup>


# Instagram data delivery via webhook
Source: https://docs.brightdata.com/datasets/scrapers/instagram/data-delivery/webhooks

Configure the Bright Data Instagram Scraper API to push scraped profiles, posts and reels to your HTTPS webhook as each job completes across 4 endpoints.

This guide shows you how to set up webhook delivery so your server receives scraped Instagram data automatically when a collection job finishes.

## Prerequisites

* A [Bright Data account](https://brightdata.com/cp/start) with an active API key
* Familiarity with the [async request workflow](/datasets/scrapers/instagram/async-requests)
* A publicly accessible HTTP endpoint (or a testing tool like [webhook.site](https://webhook.site))

## How webhooks work

When you trigger an async collection with an `endpoint` URL, Bright Data sends a `POST` request to that URL with the scraped data once the job completes. No polling required.

```text theme={null}
Your app --> POST /trigger (with webhook URL) --> Bright Data scrapes --> POST to your webhook
```

## Step 1: Set up a test webhook

For testing, use [webhook.site](https://webhook.site) to get a temporary public URL:

1. Open [webhook.site](https://webhook.site) in your browser
2. Copy the unique URL displayed (e.g., `https://webhook.site/abc-123-def`)
3. Keep the page open to monitor incoming requests

## Step 2: Trigger a collection with the webhook URL

Add the `endpoint` query parameter to your async `/trigger` request:

<CodeGroup>
  ```bash cURL theme={null}
  curl -X POST \
    "https://api.brightdata.com/datasets/v3/trigger?dataset_id=gd_l1vikfch901nx3by4&format=json&endpoint=https://webhook.site/abc-123-def&uncompressed_webhook=true" \
    -H "Authorization: Bearer YOUR_API_KEY" \
    -H "Content-Type: application/json" \
    -d '[
      {"url": "https://www.instagram.com/instagram"},
      {"url": "https://www.instagram.com/natgeo"}
    ]'
  ```

  ```python Python theme={null}
  import requests

  WEBHOOK_URL = "https://webhook.site/abc-123-def"

  response = requests.post(
      "https://api.brightdata.com/datasets/v3/trigger",
      params={
          "dataset_id": "gd_l1vikfch901nx3by4",
          "format": "json",
          "webhook": WEBHOOK_URL,
          "uncompressed_webhook": "true",
      },
      headers={
          "Authorization": "Bearer YOUR_API_KEY",
          "Content-Type": "application/json",
      },
      json=[
          {"url": "https://www.instagram.com/instagram"},
          {"url": "https://www.instagram.com/natgeo"},
      ],
  )

  print("Snapshot ID:", response.json()["snapshot_id"])
  ```

  ```javascript Node.js theme={null}
  const WEBHOOK_URL = "https://webhook.site/abc-123-def";

  const response = await fetch(
    `https://api.brightdata.com/datasets/v3/trigger?dataset_id=gd_l1vikfch901nx3by4&format=json&endpoint=${encodeURIComponent(WEBHOOK_URL)}&uncompressed_webhook=true`,
    {
      method: "POST",
      headers: {
        "Authorization": "Bearer YOUR_API_KEY",
        "Content-Type": "application/json",
      },
      body: JSON.stringify([
        { url: "https://www.instagram.com/instagram" },
        { url: "https://www.instagram.com/natgeo" },
      ]),
    }
  );

  const data = await response.json();
  console.log("Snapshot ID:", data.snapshot_id);
  ```
</CodeGroup>

Key parameters:

| Parameter              | Description                                                  |
| :--------------------- | :----------------------------------------------------------- |
| `endpoint`             | Your HTTP endpoint URL that receives the `POST` payload      |
| `uncompressed_webhook` | Set to `true` to receive uncompressed JSON (default is gzip) |
| `format`               | Output format: `json`, `ndjson`, or `csv`                    |

## Step 3: Verify delivery

Once the collection completes (typically 30-60 seconds for a few profiles), check your webhook.site page. You should see a `POST` request with the scraped data.

The payload is the same JSON array you would receive from a direct API download:

```json theme={null}
[
  {
    "user_name": "instagram",
    "full_name": "Instagram",
    "biography": "Discover what's next. ✨",
    "followers": 676000000,
    "is_verified": true
  },
  {
    "user_name": "natgeo",
    "full_name": "National Geographic",
    "biography": "Experience the world through the eyes of National Geographic photographers.",
    "followers": 284000000,
    "is_verified": true
  }
]
```

## Production webhook setup

For production, point the `endpoint` URL to your own server endpoint.

### How to handle webhooks in Express.js

```javascript server.js theme={null}
const express = require("express");
const app = express();

app.use(express.json({ limit: "100mb" }));

app.post("/webhook/instagram", (req, res) => {
  const profiles = req.body;
  console.log(`Received ${profiles.length} profiles`);

  for (const profile of profiles) {
    console.log(`- ${profile.user_name} (${profile.followers} followers)`);
  }

  res.status(200).json({ received: true });
});

app.listen(3000, () => console.log("Webhook server running on port 3000"));
```

### How to handle webhooks in Flask

```python server.py theme={null}
from flask import Flask, request, jsonify

app = Flask(__name__)

@app.route("/webhook/instagram", methods=["POST"])
def handle_webhook():
    profiles = request.get_json()
    print(f"Received {len(profiles)} profiles")

    for profile in profiles:
        print(f"- {profile['user_name']} ({profile.get('followers')} followers)")

    return jsonify({"received": True}), 200

if __name__ == "__main__":
    app.run(port=3000)
```

<Warning>
  Return a `200` status code within 30 seconds to acknowledge receipt. If your endpoint fails or times out, Bright Data retries delivery.
</Warning>

## Webhook with authorization

If your endpoint requires authentication, add the `webhook_header_Authorization` parameter:

```bash theme={null}
curl -X POST \
  "https://api.brightdata.com/datasets/v3/trigger?dataset_id=gd_l1vikfch901nx3by4&format=json&endpoint=https://your-server.com/webhook&webhook_header_Authorization=Bearer+YOUR_SECRET_TOKEN" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '[{"url": "https://www.instagram.com/instagram"}]'
```

## Allowlist webhook IPs

If your server uses an IP allowlist, add the following Bright Data webhook source IPs:

```text theme={null}
54.175.27.69
34.225.9.175
100.28.38.247
100.29.18.195
52.72.185.255
35.174.112.248
54.165.183.124
3.91.140.7
52.202.75.37
98.82.225.117
100.27.150.189
18.214.10.85
35.169.71.210
44.194.183.74
```

## Troubleshooting

<Accordion title="Webhook not receiving data?">
  * Verify the URL is publicly accessible (not `localhost`)
  * Check that your endpoint returns a `200` status code within 30 seconds
  * Verify the webhook IPs above are allowlisted if you have firewall rules
</Accordion>

<Accordion title="Receiving compressed data?">
  If you omit `uncompressed_webhook=true`, data arrives gzip-compressed. Add `uncompressed_webhook=true` to your trigger URL, or decompress the payload on your server.
</Accordion>

<Accordion title="Payload too large for your server?">
  Large collections can produce payloads up to 1 GB. Set `express.json({ limit: "100mb" })` in Express.js or equivalent in your framework. If you need to handle very large datasets, use [S3 delivery](/datasets/scrapers/instagram/data-delivery/amazon-s3) instead.
</Accordion>

## Next steps

<CardGroup>
  <Card title="Deliver to Amazon S3" icon="bucket" href="/datasets/scrapers/instagram/data-delivery/amazon-s3">
    Store results directly in your S3 bucket.
  </Card>

  <Card title="All delivery options" icon="truck" href="/datasets/scrapers/scrapers-library/delivery-options">
    Snowflake, Azure, GCS, and more.
  </Card>
</CardGroup>


# Instagram Scraper API
Source: https://docs.brightdata.com/datasets/scrapers/instagram/introduction

Extract structured data from Instagram profiles, posts, reels and comments with the Bright Data [Instagram Scraper API](https://brightdata.com/products/web-scraper/instagram). Up to 20 URLs per request.

Send an Instagram URL, get structured JSON back. The Bright Data Instagram Scraper API handles proxies, CAPTCHAs, and parsing so you can focus on your data pipeline.

<Tip>
  New to Bright Data? [Create a free account](https://brightdata.com/products/web-scraper/amazon/?hs_signup=1\&utm_source=docs) and get **5,000 free credits every month**, no credit card required. That's up to **5,000 Instagram records** to start scraping. See the [free tier](/general/account/billing-and-pricing/free-tier).
</Tip>

## How it works

You send one or more Instagram URLs to the Bright Data Instagram Scraper API. Bright Data handles the scraping infrastructure and returns clean, structured JSON.

```text theme={null}
Your app  -->  Bright Data API  -->  Structured JSON
           POST /datasets/v3/scrape
           Authorization: Bearer YOUR_API_KEY
```

All requests use a `dataset_id` to specify the data type (profiles, posts, reels, or comments) and return results in JSON, NDJSON, or CSV.

## What the response looks like

```bash theme={null}
curl -X POST "https://api.brightdata.com/datasets/v3/scrape?dataset_id=gd_l1vikfch901nx3by4&format=json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '[{"url": "https://www.instagram.com/instagram"}]'
```

```json theme={null}
{
  "user_name": "instagram",
  "full_name": "Instagram",
  "biography": "Discover what's next. ✨",
  "followers": 676000000,
  "following": 500,
  "posts_count": 7800,
  "is_verified": true,
  "profile_pic_url": "https://..."
}
```

## Supported data types

<CardGroup>
  <Card title="Profiles" icon="user" href="/api-reference/scrapers/social-media-apis/instagram-profiles-collect-by-url">
    Follower counts, bios, verification status, profile pictures. Discover profiles by username.
  </Card>

  <Card title="Posts" icon="image" href="/api-reference/scrapers/social-media-apis/instagram-posts-collect-by-url">
    Captions, likes, comments, hashtags, photos, and videos. Discover posts by profile URL.
  </Card>

  <Card title="Reels" icon="film" href="/api-reference/scrapers/social-media-apis/instagram-reels-collect-by-url">
    Video URLs, view counts, play counts, thumbnails. Discover reels or collect all reels from a profile.
  </Card>

  <Card title="Comments" icon="comments" href="/api-reference/scrapers/social-media-apis/instagram-comments-collect-by-url">
    Comment text, likes, replies, commenter details for any post or reel.
  </Card>
</CardGroup>

## Request methods

The Bright Data Instagram Scraper API supports two request methods. Choose based on your volume and latency needs.

| Method           | Endpoint                                                     | Best for                                   |
| :--------------- | :----------------------------------------------------------- | :----------------------------------------- |
| **Synchronous**  | [`/scrape`](/datasets/scrapers/instagram/send-first-request) | Real-time lookups, up to 20 URLs           |
| **Asynchronous** | [`/trigger`](/datasets/scrapers/instagram/async-requests)    | Batch jobs, 20+ URLs, production pipelines |

Learn more in [Understanding sync vs. async requests](/datasets/scrapers/concepts/sync-vs-async).

## Capabilities and limits

| Capability                     | Detail                                                                                                                                                                                                                                       |
| :----------------------------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Output formats**             | JSON, NDJSON, CSV                                                                                                                                                                                                                            |
| **Max URLs per sync request**  | 20                                                                                                                                                                                                                                           |
| **Max URLs per async request** | 5,000                                                                                                                                                                                                                                        |
| **Data freshness**             | Real-time (scraped on demand)                                                                                                                                                                                                                |
| **Delivery options**           | API download, [Webhook](/datasets/scrapers/instagram/data-delivery/webhooks), [Amazon S3](/datasets/scrapers/instagram/data-delivery/amazon-s3), Snowflake, Azure, GCS ([all options](/datasets/scrapers/scrapers-library/delivery-options)) |
| **Pricing**                    | Pay per successful record ([see pricing](https://brightdata.com/pricing/web-scraper))                                                                                                                                                        |

## Common questions

<Accordion title="Is the data scraped in real time?">
  Yes. Each request triggers a live scrape. There is no cached or stale data. Response times vary by endpoint: profiles typically return in 10-30 seconds (sync), while discovery requests may take longer depending on result volume.
</Accordion>

<Accordion title="What is the difference between URL collection and discovery?">
  **URL collection** scrapes a specific Instagram page you provide (e.g., a profile URL). **Discovery** finds Instagram content matching search criteria (e.g., all posts from a profile URL) and scrapes the results. Discovery is only available via async requests.
</Accordion>

<Accordion title="How is this different from scraping using proxies or Web Unlocker?">
  When scraping using proxies or Web Unlocker, you still need to write and maintain your own parsing logic and update it whenever Instagram changes its page structure. The Instagram Scraper API handles the entire stack: proxy rotation, anti-bot bypassing and parsing. You simply send an Instagram URL and get clean, structured JSON back with no scraping infrastructure or parser maintenance required on your end.
</Accordion>

## Next steps

<CardGroup>
  <Card title="Quickstart" icon="rocket" href="/datasets/scrapers/instagram/quickstart">
    Scrape your first Instagram profile in 5 minutes.
  </Card>

  <Card title="Send your first request" icon="bolt" href="/datasets/scrapers/instagram/send-first-request">
    Full code examples in cURL, Python, and Node.js.
  </Card>

  <Card title="API reference" icon="code" href="/api-reference/scrapers/social-media-apis/instagram-profiles-collect-by-url">
    Endpoint specs, parameters, and response schemas.
  </Card>
</CardGroup>


# Instagram scraper quickstart
Source: https://docs.brightdata.com/datasets/scrapers/instagram/quickstart

Set up the Bright Data Instagram Scraper API and collect your first profile, post or reel as structured JSON in under 5 minutes from the Control Panel.

This tutorial shows you how to scrape an Instagram profile and get structured JSON data using the Bright Data Instagram Scraper API.

## Prerequisites

* A [Bright Data account](https://brightdata.com/cp/start) (includes \$2 free credit)
* cURL, Python 3, or Node.js 18+ installed

<Steps>
  <Step title="Get your API key">
    Go to the [user settings page](https://brightdata.com/cp/setting/users) in your Bright Data account and copy your API key.

    If you don't have an account yet, [sign up at brightdata.com](https://brightdata.com/cp/start). New users get \$2 free credit for testing.

    <Warning>
      Your API key is shown only once when created. Copy and store it securely.
    </Warning>
  </Step>

  <Step title="Send a request">
    We'll use the **Profiles endpoint** with a synchronous request. Replace `YOUR_API_KEY` with your actual token:

    <CodeGroup>
      ```bash cURL theme={null}
      curl -X POST \
        "https://api.brightdata.com/datasets/v3/scrape?dataset_id=gd_l1vikfch901nx3by4&format=json" \
        -H "Authorization: Bearer YOUR_API_KEY" \
        -H "Content-Type: application/json" \
        -d '[{"url": "https://www.instagram.com/instagram"}]'
      ```

      ```python Python theme={null}
      import requests

      response = requests.post(
          "https://api.brightdata.com/datasets/v3/scrape",
          params={"dataset_id": "gd_l1vikfch901nx3by4", "format": "json"},
          headers={
              "Authorization": "Bearer YOUR_API_KEY",
              "Content-Type": "application/json",
          },
          json=[{"url": "https://www.instagram.com/instagram"}],
      )

      print(response.json())
      ```

      ```javascript Node.js theme={null}
      const response = await fetch(
        "https://api.brightdata.com/datasets/v3/scrape?dataset_id=gd_l1vikfch901nx3by4&format=json",
        {
          method: "POST",
          headers: {
            "Authorization": "Bearer YOUR_API_KEY",
            "Content-Type": "application/json",
          },
          body: JSON.stringify([
            { url: "https://www.instagram.com/instagram" }
          ]),
        }
      );

      const data = await response.json();
      console.log(data);
      ```
    </CodeGroup>

    You should see a `200` status code. This takes 10-30 seconds.
  </Step>

  <Step title="Review the response">
    The Bright Data Instagram Scraper API returns a JSON array with structured profile data:

    ```json theme={null}
    [
      {
        "user_name": "instagram",
        "full_name": "Instagram",
        "biography": "Discover what's next. ✨",
        "followers": 676000000,
        "following": 500,
        "posts_count": 7800,
        "is_verified": true,
        "url": "https://www.instagram.com/instagram"
      }
    ]
    ```

    Each profile object includes fields covering follower counts, bio, verification status, and more. See the [full response schema](/api-reference/scrapers/social-media-apis/instagram-profiles-collect-by-url).
  </Step>
</Steps>

You've successfully scraped your first Instagram profile using the Bright Data Instagram Scraper API.

## Common questions

<Accordion title="Can I scrape multiple profiles in one request?">
  Yes. Add more objects to the input array. Synchronous requests support up to 20 URLs. For larger batches, use the [async `/trigger` endpoint](/datasets/scrapers/instagram/async-requests).

  ```json theme={null}
  [
    {"url": "https://www.instagram.com/instagram"},
    {"url": "https://www.instagram.com/natgeo"},
    {"url": "https://www.instagram.com/nasa"}
  ]
  ```
</Accordion>

<Accordion title="Getting a 401 or 403 error?">
  Verify your API key is correct and hasn't expired. Generate a new token from [Account settings](https://brightdata.com/cp/setting/users). See the [authentication guide](/api-reference/authentication) for details.
</Accordion>

<Accordion title="Request is timing out?">
  Synchronous requests have a 1-minute timeout. If the request exceeds this limit, it automatically switches to async and returns a `snapshot_id`. Use the [async workflow](/datasets/scrapers/instagram/async-requests) for large batches.
</Accordion>

<Accordion title="Empty or partial response data?">
  Verify the Instagram profile URL is publicly accessible and correctly formatted. The URL should follow the pattern `https://www.instagram.com/username`.
</Accordion>

## Next steps

<CardGroup>
  <Card title="Send your first request" icon="bolt" href="/datasets/scrapers/instagram/send-first-request">
    Explore all four endpoint types with full examples.
  </Card>

  <Card title="Async batch requests" icon="layer-group" href="/datasets/scrapers/instagram/async-requests">
    Scrape hundreds of URLs in a single batch job.
  </Card>

  <Card title="Set up webhooks" icon="webhook" href="/datasets/scrapers/instagram/data-delivery/webhooks">
    Receive results automatically when scraping completes.
  </Card>
</CardGroup>


# Send your first Instagram API request
Source: https://docs.brightdata.com/datasets/scrapers/instagram/send-first-request

Send synchronous requests to all 4 Bright Data Instagram Scraper API endpoints with copy-paste examples for profiles, posts, reels and comments.

This tutorial walks you through sending a synchronous request to each Bright Data Instagram Scraper API endpoint. By the end, you'll have working examples for profiles, posts, reels, and comments.

## Prerequisites

* A [Bright Data account](https://brightdata.com/cp/start) with an active API key
* Completed the [Quickstart](/datasets/scrapers/instagram/quickstart)

## Request structure

Every synchronous request follows the same pattern:

```http theme={null}
POST https://api.brightdata.com/datasets/v3/scrape?dataset_id={DATASET_ID}&format=json
Authorization: Bearer YOUR_API_KEY
Content-Type: application/json

[{"url": "https://www.instagram.com/..."}]
```

The only thing that changes between endpoints is the `dataset_id` and the input URL format.

<Note>
  Synchronous requests support up to 20 URLs and have a 1-minute timeout. If the request takes longer, the API automatically returns a `snapshot_id` instead. See [async requests](/datasets/scrapers/instagram/async-requests).
</Note>

## How to scrape Instagram profiles

**Dataset ID:** `gd_l1vikfch901nx3by4`

```bash theme={null}
curl -X POST \
  "https://api.brightdata.com/datasets/v3/scrape?dataset_id=gd_l1vikfch901nx3by4&format=json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '[{"url": "https://www.instagram.com/instagram"}]'
```

You should see a `200` response. This takes 10-30 seconds.

<Accordion title="Example response">
  ```json theme={null}
  [
    {
      "user_name": "instagram",
      "full_name": "Instagram",
      "biography": "Discover what's next. ✨",
      "followers": 676000000,
      "following": 500,
      "posts_count": 7800,
      "is_verified": true,
      "profile_pic_url": "https://..."
    }
  ]
  ```
</Accordion>

[Full Profiles response schema](/api-reference/scrapers/social-media-apis/instagram-profiles-collect-by-url)

## How to scrape Instagram posts

**Dataset ID:** `gd_lk5ns7kz21pck8jpis`

```bash theme={null}
curl -X POST \
  "https://api.brightdata.com/datasets/v3/scrape?dataset_id=gd_lk5ns7kz21pck8jpis&format=json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '[{"url": "https://www.instagram.com/p/Cuf4s0MNqNr"}]'
```

<Accordion title="Example response">
  ```json theme={null}
  [
    {
      "url": "https://www.instagram.com/p/Cuf4s0MNqNr",
      "user_posted": "instagram",
      "description": "Sharing moments that matter...",
      "num_comments": 1250,
      "date_posted": "2024-04-03T14:30:00.000Z",
      "likes": 45230,
      "hashtags": ["photography", "moments"],
      "content_type": "Photo",
      "shortcode": "Cuf4s0MNqNr"
    }
  ]
  ```
</Accordion>

[Full Posts response schema](/api-reference/scrapers/social-media-apis/instagram-posts-collect-by-url)

## How to scrape Instagram reels

**Dataset ID:** `gd_lyclm20il4r5helnj`

```bash theme={null}
curl -X POST \
  "https://api.brightdata.com/datasets/v3/scrape?dataset_id=gd_lyclm20il4r5helnj&format=json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '[{"url": "https://www.instagram.com/reel/C5Rdyj_q7YN/"}]'
```

<Accordion title="Example response">
  ```json theme={null}
  [
    {
      "url": "https://www.instagram.com/reel/C5Rdyj_q7YN/",
      "user_posted": "instagram",
      "description": "Watch this reel...",
      "num_comments": 320,
      "date_posted": "2024-03-15T10:00:00.000Z",
      "likes": 15000,
      "views": 250000,
      "video_play_count": 500000,
      "length": "15.033",
      "shortcode": "C5Rdyj_q7YN"
    }
  ]
  ```
</Accordion>

[Full Reels response schema](/api-reference/scrapers/social-media-apis/instagram-reels-collect-by-url)

## How to scrape Instagram comments

**Dataset ID:** `gd_ltppn085pokosxh13`

```bash theme={null}
curl -X POST \
  "https://api.brightdata.com/datasets/v3/scrape?dataset_id=gd_ltppn085pokosxh13&format=json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '[{"url": "https://www.instagram.com/p/Cuf4s0MNqNr"}]'
```

<Accordion title="Example response">
  ```json theme={null}
  [
    {
      "url": "https://www.instagram.com/p/Cuf4s0MNqNr",
      "comment_user": "user123",
      "comment_user_url": "https://www.instagram.com/user123",
      "comment_date": "2024-04-05T12:30:00.000Z",
      "comment": "Amazing post!",
      "likes_number": 5,
      "replies_number": 2,
      "comment_id": "18168596065410257",
      "post_id": "3851148751604100411"
    }
  ]
  ```
</Accordion>

[Full Comments response schema](/api-reference/scrapers/social-media-apis/instagram-comments-collect-by-url)

## Quick reference: dataset IDs

| Endpoint | Dataset ID              | URL pattern                                                       |
| :------- | :---------------------- | :---------------------------------------------------------------- |
| Profiles | `gd_l1vikfch901nx3by4`  | `instagram.com/{username}`                                        |
| Posts    | `gd_lk5ns7kz21pck8jpis` | `instagram.com/p/{shortcode}`                                     |
| Reels    | `gd_lyclm20il4r5helnj`  | `instagram.com/reel/{shortcode}`                                  |
| Comments | `gd_ltppn085pokosxh13`  | `instagram.com/p/{shortcode}` or `instagram.com/reel/{shortcode}` |

## Output formats

Control the response format with the `format` query parameter:

| Value    | Description                                 |
| :------- | :------------------------------------------ |
| `json`   | JSON array (default)                        |
| `ndjson` | Newline-delimited JSON, one record per line |
| `csv`    | Comma-separated values                      |

## Next steps

<CardGroup>
  <Card title="Async batch requests" icon="layer-group" href="/datasets/scrapers/instagram/async-requests">
    Scrape hundreds of URLs in a single batch job.
  </Card>

  <Card title="API reference" icon="code" href="/api-reference/scrapers/social-media-apis/instagram-profiles-collect-by-url">
    Full parameter and response field reference.
  </Card>
</CardGroup>


# How to scrape LinkedIn data in bulk
Source: https://docs.brightdata.com/datasets/scrapers/linkedin/async-requests

Trigger large-scale LinkedIn scraping jobs, monitor progress, and retrieve results using the Bright Data async /trigger endpoint. Supports batches of 20 URLs.

This guide shows you how to scrape LinkedIn data at scale using the asynchronous `/trigger` endpoint. Use this when you have more than 20 URLs, need discovery, or want delivery to a webhook or S3.

<Tip>
  Not sure whether to use sync or async? Read [Understanding sync vs. async requests](/datasets/scrapers/concepts/sync-vs-async).
</Tip>

## Prerequisites

* A [Bright Data account](https://brightdata.com/cp/start) with an active API key
* Familiarity with the [synchronous request flow](/datasets/scrapers/linkedin/send-first-request)

## Step 1: Trigger the collection

Send a `POST` request to the `/trigger` endpoint with your input URLs:

<CodeGroup>
  ```bash cURL theme={null}
  curl -X POST \
    "https://api.brightdata.com/datasets/v3/trigger?dataset_id=gd_l1viktl72bvl7bjuj0&format=json" \
    -H "Authorization: Bearer YOUR_API_KEY" \
    -H "Content-Type: application/json" \
    -d '[
      {"url": "https://www.linkedin.com/in/satyanadella"},
      {"url": "https://www.linkedin.com/in/jeffweiner08"},
      {"url": "https://www.linkedin.com/in/rbranson"},
      {"url": "https://www.linkedin.com/in/sherylsandberg"},
      {"url": "https://www.linkedin.com/in/raboram"}
    ]'
  ```

  ```python Python theme={null}
  import requests

  response = requests.post(
      "https://api.brightdata.com/datasets/v3/trigger",
      params={
          "dataset_id": "gd_l1viktl72bvl7bjuj0",
          "format": "json",
      },
      headers={
          "Authorization": "Bearer YOUR_API_KEY",
          "Content-Type": "application/json",
      },
      json=[
          {"url": "https://www.linkedin.com/in/satyanadella"},
          {"url": "https://www.linkedin.com/in/jeffweiner08"},
          {"url": "https://www.linkedin.com/in/rbranson"},
          {"url": "https://www.linkedin.com/in/sherylsandberg"},
          {"url": "https://www.linkedin.com/in/raboram"},
      ],
  )

  snapshot = response.json()
  print("Snapshot ID:", snapshot["snapshot_id"])
  ```

  ```javascript Node.js theme={null}
  const response = await fetch(
    "https://api.brightdata.com/datasets/v3/trigger?dataset_id=gd_l1viktl72bvl7bjuj0&format=json",
    {
      method: "POST",
      headers: {
        "Authorization": "Bearer YOUR_API_KEY",
        "Content-Type": "application/json",
      },
      body: JSON.stringify([
        { url: "https://www.linkedin.com/in/satyanadella" },
        { url: "https://www.linkedin.com/in/jeffweiner08" },
        { url: "https://www.linkedin.com/in/rbranson" },
        { url: "https://www.linkedin.com/in/sherylsandberg" },
        { url: "https://www.linkedin.com/in/raboram" },
      ]),
    }
  );

  const snapshot = await response.json();
  console.log("Snapshot ID:", snapshot.snapshot_id);
  ```
</CodeGroup>

You should see a `200` response with a `snapshot_id`:

```json theme={null}
{
  "snapshot_id": "s_m1a2b3c4d5e6f7g8h"
}
```

Save this ID. You need it to check progress and download results.

## Step 2: Monitor progress

Poll the snapshot status until it shows `ready`. This takes 30 seconds to several minutes depending on the number of URLs.

<CodeGroup>
  ```bash cURL theme={null}
  curl "https://api.brightdata.com/datasets/v3/progress/s_m1a2b3c4d5e6f7g8h" \
    -H "Authorization: Bearer YOUR_API_KEY"
  ```

  ```python Python theme={null}
  import time

  snapshot_id = "s_m1a2b3c4d5e6f7g8h"

  while True:
      status_response = requests.get(
          f"https://api.brightdata.com/datasets/v3/progress/{snapshot_id}",
          headers={"Authorization": "Bearer YOUR_API_KEY"},
      )
      status = status_response.json().get("status")
      print(f"Status: {status}")

      if status == "ready":
          break
      time.sleep(10)
  ```

  ```javascript Node.js theme={null}
  const snapshotId = "s_m1a2b3c4d5e6f7g8h";

  let status = "collecting";
  while (status !== "ready") {
    const statusResponse = await fetch(
      `https://api.brightdata.com/datasets/v3/progress/${snapshotId}`,
      { headers: { "Authorization": "Bearer YOUR_API_KEY" } }
    );
    const statusData = await statusResponse.json();
    status = statusData.status;
    console.log("Status:", status);

    if (status !== "ready") {
      await new Promise((r) => setTimeout(r, 10000));
    }
  }
  ```
</CodeGroup>

Status values:

| Status       | Meaning                             |
| :----------- | :---------------------------------- |
| `collecting` | Scraping is in progress             |
| `digesting`  | Data is being processed             |
| `ready`      | Results are available for download  |
| `failed`     | The collection encountered an error |

## Step 3: Download results

Once the status is `ready`, download the scraped data:

<CodeGroup>
  ```bash cURL theme={null}
  curl "https://api.brightdata.com/datasets/v3/snapshot/s_m1a2b3c4d5e6f7g8h?format=json" \
    -H "Authorization: Bearer YOUR_API_KEY" \
    -o results.json
  ```

  ```python Python theme={null}
  results_response = requests.get(
      f"https://api.brightdata.com/datasets/v3/snapshot/{snapshot_id}",
      params={"format": "json"},
      headers={"Authorization": "Bearer YOUR_API_KEY"},
  )

  results = results_response.json()
  print(f"Collected {len(results)} profiles")
  ```

  ```javascript Node.js theme={null}
  const resultsResponse = await fetch(
    `https://api.brightdata.com/datasets/v3/snapshot/${snapshotId}?format=json`,
    { headers: { "Authorization": "Bearer YOUR_API_KEY" } }
  );

  const results = await resultsResponse.json();
  console.log(`Collected ${results.length} profiles`);
  ```
</CodeGroup>

You've successfully triggered, monitored, and downloaded a batch LinkedIn scraping job.

## Skip polling with webhooks

If you don't want to poll for status, add an `endpoint` parameter to receive results automatically:

```bash theme={null}
curl -X POST \
  "https://api.brightdata.com/datasets/v3/trigger?dataset_id=gd_l1viktl72bvl7bjuj0&format=json&endpoint=https://your-server.com/webhook" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '[{"url": "https://www.linkedin.com/in/satyanadella"}]'
```

See [How to receive LinkedIn data via webhooks](/datasets/scrapers/linkedin/data-delivery/webhooks) for the full setup.

## Limits and constraints

| Constraint                           | Value      |
| :----------------------------------- | :--------- |
| Max input file size                  | 1 GB       |
| Max concurrent batch requests        | 100        |
| Max concurrent single-input requests | 1,500      |
| Webhook delivery size                | Up to 1 GB |
| API download size                    | Up to 5 GB |

## Troubleshooting

<Accordion title="Getting a 429 Too Many Requests error?">
  You've exceeded the concurrent request limit. Reduce the number of parallel requests or combine inputs into fewer, larger batches. Each batch can include up to 1 GB of input data.
</Accordion>

<Accordion title="Snapshot status shows 'failed'?">
  Check that all input URLs are valid LinkedIn URLs. Review the error details in the snapshot response or in the [Logs tab](https://brightdata.com/cp/scrapers) of your Bright Data dashboard.
</Accordion>

<Accordion title="Results are incomplete or missing some URLs?">
  Some URLs may fail individually while the overall job succeeds. Check the snapshot response for any `errors` field. Retry failed URLs in a separate request.
</Accordion>

## Next steps

<CardGroup>
  <Card title="Set up webhooks" icon="webhook" href="/datasets/scrapers/linkedin/data-delivery/webhooks">
    Receive results without polling.
  </Card>

  <Card title="Deliver to S3" icon="bucket" href="/datasets/scrapers/linkedin/data-delivery/amazon-s3">
    Send results directly to your S3 bucket.
  </Card>
</CardGroup>


# How to deliver LinkedIn data to Amazon S3
Source: https://docs.brightdata.com/datasets/scrapers/linkedin/data-delivery/amazon-s3

Configure the Bright Data LinkedIn Scraper API to deliver scraped profiles, companies, jobs and posts directly to your Amazon S3 bucket on job completion.

This guide shows you how to configure the Bright Data LinkedIn Scraper API to deliver scraped data directly to your Amazon S3 bucket when a collection job completes.

## Prerequisites

* A [Bright Data account](https://brightdata.com/cp/start) with an active API key
* An AWS account with an S3 bucket
* IAM credentials with write access to the bucket
* Familiarity with the [async request workflow](/datasets/scrapers/linkedin/async-requests)

## Step 1: Create an S3 bucket

If you already have a bucket, skip to Step 2.

In the [AWS S3 Console](https://s3.console.aws.amazon.com/s3/buckets):

1. Click **Create bucket**
2. Enter a bucket name (e.g., `linkedin-scraper-data`)
3. Select your preferred AWS region
4. Keep default settings and click **Create bucket**

## Step 2: Set up IAM permissions

Create an IAM role that grants Bright Data write access to your bucket.

### Create a policy

In the [IAM Console](https://console.aws.amazon.com/iam/), go to **Policies** and create a new policy with this JSON:

```json theme={null}
{
  "Version": "2012-10-17",
  "Statement": [
    {
      "Effect": "Allow",
      "Action": ["s3:PutObject", "s3:GetObject"],
      "Resource": "arn:aws:s3:::linkedin-scraper-data/*"
    }
  ]
}
```

Replace `linkedin-scraper-data` with your actual bucket name.

### Create a role for Bright Data

1. Go to **Roles** > **Create role**
2. Select **AWS account** as the trusted entity type
3. Enter Bright Data's AWS account ID: `422310177405`
4. Attach the policy you created above
5. Name the role (e.g., `BrightDataS3Delivery`)
6. Note the role ARN (e.g., `arn:aws:iam::123456789012:role/BrightDataS3Delivery`)

Add an external ID condition to the trust policy:

```json theme={null}
{
  "Version": "2012-10-17",
  "Statement": [
    {
      "Effect": "Allow",
      "Principal": {
        "AWS": "arn:aws:iam::422310177405:role/brd.ec2.zs-dca-delivery"
      },
      "Action": "sts:AssumeRole",
      "Condition": {
        "StringEquals": {
          "sts:ExternalId": "YOUR_BRIGHT_DATA_CUSTOMER_ID"
        }
      }
    }
  ]
}
```

Find your customer ID in [Account settings](https://brightdata.com/cp/setting/customer_details).

## Step 3: Configure delivery in Bright Data

1. Navigate to your [scraper configuration](https://brightdata.com/cp/scrapers)
2. Click the **Delivery settings** tab
3. Select **Amazon S3** as the delivery destination
4. Enter your credentials:
   * **Bucket name**: Your S3 bucket name
   * **Role ARN**: The IAM role ARN from Step 2
   * **Region**: Your S3 bucket region
   * **Path prefix** (optional): A folder path within the bucket (e.g., `linkedin/profiles/`)
5. Select your preferred file format (JSON, NDJSON, or CSV)
6. Click **Save**

## Step 4: Trigger a collection

Trigger an async collection. Results are automatically delivered to your S3 bucket:

<CodeGroup>
  ```bash cURL theme={null}
  curl -X POST \
    "https://api.brightdata.com/datasets/v3/trigger?dataset_id=gd_l1viktl72bvl7bjuj0&format=json" \
    -H "Authorization: Bearer YOUR_API_KEY" \
    -H "Content-Type: application/json" \
    -d '[
      {"url": "https://www.linkedin.com/in/satyanadella"},
      {"url": "https://www.linkedin.com/in/jeffweiner08"},
      {"url": "https://www.linkedin.com/in/rbranson"}
    ]'
  ```

  ```python Python theme={null}
  import requests

  response = requests.post(
      "https://api.brightdata.com/datasets/v3/trigger",
      params={"dataset_id": "gd_l1viktl72bvl7bjuj0", "format": "json"},
      headers={
          "Authorization": "Bearer YOUR_API_KEY",
          "Content-Type": "application/json",
      },
      json=[
          {"url": "https://www.linkedin.com/in/satyanadella"},
          {"url": "https://www.linkedin.com/in/jeffweiner08"},
          {"url": "https://www.linkedin.com/in/rbranson"},
      ],
  )

  print("Snapshot ID:", response.json()["snapshot_id"])
  ```

  ```javascript Node.js theme={null}
  const response = await fetch(
    "https://api.brightdata.com/datasets/v3/trigger?dataset_id=gd_l1viktl72bvl7bjuj0&format=json",
    {
      method: "POST",
      headers: {
        "Authorization": "Bearer YOUR_API_KEY",
        "Content-Type": "application/json",
      },
      body: JSON.stringify([
        { url: "https://www.linkedin.com/in/satyanadella" },
        { url: "https://www.linkedin.com/in/jeffweiner08" },
        { url: "https://www.linkedin.com/in/rbranson" },
      ]),
    }
  );

  const data = await response.json();
  console.log("Snapshot ID:", data.snapshot_id);
  ```
</CodeGroup>

## Step 5: Verify delivery

Once the collection completes, check your S3 bucket for the delivered file:

```bash theme={null}
aws s3 ls s3://linkedin-scraper-data/linkedin/profiles/
```

You should see a file named with the snapshot ID (e.g., `s_m1a2b3c4d5e6f7g8h.json`).

Download and inspect it:

```bash theme={null}
aws s3 cp s3://linkedin-scraper-data/linkedin/profiles/s_m1a2b3c4d5e6f7g8h.json ./results.json
cat results.json | python -m json.tool | head -20
```

You can also verify delivery status using the [Monitor Delivery API](/api-reference/scrapers/management-apis/monitor-delivery).

## Troubleshooting

<Accordion title="Files not appearing in S3?">
  * Verify the IAM role ARN and external ID are correct
  * Check that the bucket policy allows `s3:PutObject` from Bright Data's account
  * Ensure the bucket region matches your configuration
  * Review delivery status in the Bright Data dashboard under **Logs**
</Accordion>

<Accordion title="Access denied errors?">
  Verify the trust policy on your IAM role includes Bright Data's account (`422310177405`) and your external ID matches your Bright Data customer ID found in [Account settings](https://brightdata.com/cp/setting/customer_details).
</Accordion>

<Accordion title="Delivered file is empty or missing records?">
  Check the collection status in the Bright Data dashboard. If some URLs failed, the delivered file contains only successful results. Retry failed URLs in a separate request.
</Accordion>

## Next steps

<CardGroup>
  <Card title="Set up webhooks" icon="webhook" href="/datasets/scrapers/linkedin/data-delivery/webhooks">
    Receive results at your HTTP endpoint.
  </Card>

  <Card title="All delivery options" icon="truck" href="/datasets/scrapers/scrapers-library/delivery-options">
    Snowflake, Azure, GCS, SFTP, and more.
  </Card>
</CardGroup>


# How to receive LinkedIn data via webhooks
Source: https://docs.brightdata.com/datasets/scrapers/linkedin/data-delivery/webhooks

Configure the Bright Data LinkedIn Scraper API to push scraped profiles, companies, jobs and posts to your HTTPS webhook across 4 endpoints as jobs complete.

This guide shows you how to set up webhook delivery so your server receives scraped LinkedIn data automatically when a collection job finishes.

## Prerequisites

* A [Bright Data account](https://brightdata.com/cp/start) with an active API key
* Familiarity with the [async request workflow](/datasets/scrapers/linkedin/async-requests)
* A publicly accessible HTTP endpoint (or a testing tool like [webhook.site](https://webhook.site))

## How webhooks work

When you trigger an async collection with an `endpoint` URL, Bright Data sends a `POST` request to that URL with the scraped data once the job completes. No polling required.

```text theme={null}
Your app --> POST /trigger (with webhook URL) --> Bright Data scrapes --> POST to your webhook
```

## Step 1: Set up a test webhook

For testing, use [webhook.site](https://webhook.site) to get a temporary public URL:

1. Open [webhook.site](https://webhook.site) in your browser
2. Copy the unique URL displayed (e.g., `https://webhook.site/abc-123-def`)
3. Keep the page open to monitor incoming requests

## Step 2: Trigger a collection with the webhook URL

Add the `endpoint` query parameter to your async `/trigger` request:

<CodeGroup>
  ```bash cURL theme={null}
  curl -X POST \
    "https://api.brightdata.com/datasets/v3/trigger?dataset_id=gd_l1viktl72bvl7bjuj0&format=json&endpoint=https://webhook.site/abc-123-def&uncompressed_webhook=true" \
    -H "Authorization: Bearer YOUR_API_KEY" \
    -H "Content-Type: application/json" \
    -d '[
      {"url": "https://www.linkedin.com/in/satyanadella"},
      {"url": "https://www.linkedin.com/in/jeffweiner08"}
    ]'
  ```

  ```python Python theme={null}
  import requests

  WEBHOOK_URL = "https://webhook.site/abc-123-def"

  response = requests.post(
      "https://api.brightdata.com/datasets/v3/trigger",
      params={
          "dataset_id": "gd_l1viktl72bvl7bjuj0",
          "format": "json",
          "webhook": WEBHOOK_URL,
          "uncompressed_webhook": "true",
      },
      headers={
          "Authorization": "Bearer YOUR_API_KEY",
          "Content-Type": "application/json",
      },
      json=[
          {"url": "https://www.linkedin.com/in/satyanadella"},
          {"url": "https://www.linkedin.com/in/jeffweiner08"},
      ],
  )

  print("Snapshot ID:", response.json()["snapshot_id"])
  ```

  ```javascript Node.js theme={null}
  const WEBHOOK_URL = "https://webhook.site/abc-123-def";

  const response = await fetch(
    `https://api.brightdata.com/datasets/v3/trigger?dataset_id=gd_l1viktl72bvl7bjuj0&format=json&endpoint=${encodeURIComponent(WEBHOOK_URL)}&uncompressed_webhook=true`,
    {
      method: "POST",
      headers: {
        "Authorization": "Bearer YOUR_API_KEY",
        "Content-Type": "application/json",
      },
      body: JSON.stringify([
        { url: "https://www.linkedin.com/in/satyanadella" },
        { url: "https://www.linkedin.com/in/jeffweiner08" },
      ]),
    }
  );

  const data = await response.json();
  console.log("Snapshot ID:", data.snapshot_id);
  ```
</CodeGroup>

Key parameters:

| Parameter              | Description                                                  |
| :--------------------- | :----------------------------------------------------------- |
| `endpoint`             | Your HTTP endpoint URL that receives the `POST` payload      |
| `uncompressed_webhook` | Set to `true` to receive uncompressed JSON (default is gzip) |
| `format`               | Output format: `json`, `ndjson`, or `csv`                    |

## Step 3: Verify delivery

Once the collection completes (typically 30-60 seconds for a few profiles), check your webhook.site page. You should see a `POST` request with the scraped data.

The payload is the same JSON array you would receive from a direct API download:

```json theme={null}
[
  {
    "name": "Satya Nadella",
    "city": "Redmond",
    "country_code": "US",
    "current_company": { "name": "Microsoft" },
    "followers": 10842560
  },
  {
    "name": "Jeff Weiner",
    "city": "San Francisco Bay Area",
    "country_code": "US",
    "current_company": { "name": "Next Chapter" },
    "followers": 1200000
  }
]
```

## Production webhook setup

For production, point the `endpoint` URL to your own server endpoint.

### How to handle webhooks in Express.js

```javascript server.js theme={null}
const express = require("express");
const app = express();

app.use(express.json({ limit: "100mb" }));

app.post("/webhook/linkedin", (req, res) => {
  const profiles = req.body;
  console.log(`Received ${profiles.length} profiles`);

  for (const profile of profiles) {
    console.log(`- ${profile.name} (${profile.current_company?.name})`);
  }

  res.status(200).json({ received: true });
});

app.listen(3000, () => console.log("Webhook server running on port 3000"));
```

### How to handle webhooks in Flask

```python server.py theme={null}
from flask import Flask, request, jsonify

app = Flask(__name__)

@app.route("/webhook/linkedin", methods=["POST"])
def handle_webhook():
    profiles = request.get_json()
    print(f"Received {len(profiles)} profiles")

    for profile in profiles:
        print(f"- {profile['name']} ({profile.get('current_company', {}).get('name')})")

    return jsonify({"received": True}), 200

if __name__ == "__main__":
    app.run(port=3000)
```

<Warning>
  Return a `200` status code within 30 seconds to acknowledge receipt. If your endpoint fails or times out, Bright Data retries delivery.
</Warning>

## Webhook with authorization

If your endpoint requires authentication, add the `webhook_header_Authorization` parameter:

```bash theme={null}
curl -X POST \
  "https://api.brightdata.com/datasets/v3/trigger?dataset_id=gd_l1viktl72bvl7bjuj0&format=json&endpoint=https://your-server.com/webhook&webhook_header_Authorization=Bearer+YOUR_SECRET_TOKEN" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '[{"url": "https://www.linkedin.com/in/satyanadella"}]'
```

## Allowlist webhook IPs

If your server uses an IP allowlist, add the following Bright Data webhook source IPs:

```text theme={null}
54.175.27.69
34.225.9.175
100.28.38.247
100.29.18.195
52.72.185.255
35.174.112.248
54.165.183.124
3.91.140.7
52.202.75.37
98.82.225.117
100.27.150.189
18.214.10.85
35.169.71.210
44.194.183.74
```

## Troubleshooting

<Accordion title="Webhook not receiving data?">
  * Verify the URL is publicly accessible (not `localhost`)
  * Check that your endpoint returns a `200` status code within 30 seconds
  * Verify the webhook IPs above are allowlisted if you have firewall rules
</Accordion>

<Accordion title="Receiving compressed data?">
  If you omit `uncompressed_webhook=true`, data arrives gzip-compressed. Add `uncompressed_webhook=true` to your trigger URL, or decompress the payload on your server.
</Accordion>

<Accordion title="Payload too large for your server?">
  Large collections can produce payloads up to 1 GB. Set `express.json({ limit: "100mb" })` in Express.js or equivalent in your framework. If you need to handle very large datasets, use [S3 delivery](/datasets/scrapers/linkedin/data-delivery/amazon-s3) instead.
</Accordion>

## Next steps

<CardGroup>
  <Card title="Deliver to Amazon S3" icon="bucket" href="/datasets/scrapers/linkedin/data-delivery/amazon-s3">
    Store results directly in your S3 bucket.
  </Card>

  <Card title="All delivery options" icon="truck" href="/datasets/scrapers/scrapers-library/delivery-options">
    Snowflake, Azure, GCS, and more.
  </Card>
</CardGroup>


# LinkedIn Scraper API
Source: https://docs.brightdata.com/datasets/scrapers/linkedin/introduction

Use the Bright Data [LinkedIn Scraper API](https://brightdata.com/products/web-scraper/linkedin) to extract structured data from profiles, companies, jobs and posts. Handles up to 20 URLs per request.

Send a LinkedIn URL, get structured JSON back. The Bright Data LinkedIn Scraper API handles proxies, CAPTCHAs, and parsing so you can focus on your data pipeline.

<Tip>
  New to Bright Data? [Create a free account](https://brightdata.com/cp/start) and get \$2 credit to start scraping.
</Tip>

## How it works

You send one or more LinkedIn URLs to the Bright Data LinkedIn Scraper API. Bright Data handles the scraping infrastructure and returns clean, structured JSON.

```text theme={null}
Your app  -->  Bright Data API  -->  Structured JSON
           POST /datasets/v3/scrape
           Authorization: Bearer YOUR_API_KEY
```

All requests use a `dataset_id` to specify the data type (profiles, companies, jobs, or posts) and return results in JSON, NDJSON, or CSV.

## What the response looks like

```bash theme={null}
curl -X POST "https://api.brightdata.com/datasets/v3/scrape?dataset_id=gd_l1viktl72bvl7bjuj0&format=json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '[{"url": "https://www.linkedin.com/in/satyanadella"}]'
```

```json theme={null}
{
  "name": "Satya Nadella",
  "city": "Redmond",
  "country_code": "US",
  "current_company": { "name": "Microsoft" },
  "followers": 10842560,
  "about": "Chairman and CEO at Microsoft..."
}
```

## Supported data types

<CardGroup>
  <Card title="Profiles" icon="user" href="/api-reference/scrapers/social-media-apis/linkedin-profiles-collect-by-url">
    Work history, education, skills, connections. Discover profiles by name or keyword.
  </Card>

  <Card title="Companies" icon="building" href="/api-reference/scrapers/social-media-apis/linkedin-companies-collect-by-url">
    Employee counts, funding data, specialties, affiliated organizations.
  </Card>

  <Card title="Jobs" icon="briefcase" href="/api-reference/scrapers/social-media-apis/linkedin-jobs-collect-by-url">
    Salary data, requirements, application links. Discover jobs by keyword or search URL.
  </Card>

  <Card title="Posts" icon="message" href="/api-reference/scrapers/social-media-apis/linkedin-posts-collect-by-url">
    Post content, engagement metrics, hashtags, comments. Discover posts by company or profile.
  </Card>
</CardGroup>

## Request methods

The Bright Data LinkedIn Scraper API supports two request methods. Choose based on your volume and latency needs.

| Method           | Endpoint                                                    | Best for                                   |
| :--------------- | :---------------------------------------------------------- | :----------------------------------------- |
| **Synchronous**  | [`/scrape`](/datasets/scrapers/linkedin/send-first-request) | Real-time lookups, up to 20 URLs           |
| **Asynchronous** | [`/trigger`](/datasets/scrapers/linkedin/async-requests)    | Batch jobs, 20+ URLs, production pipelines |

Learn more in [Understanding sync vs. async requests](/datasets/scrapers/concepts/sync-vs-async).

## Capabilities and limits

| Capability                     | Detail                                                                                                                                                                                                                                     |
| :----------------------------- | :----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Output formats**             | JSON, NDJSON, CSV                                                                                                                                                                                                                          |
| **Max URLs per sync request**  | 20                                                                                                                                                                                                                                         |
| **Max URLs per async request** | 5,000                                                                                                                                                                                                                                      |
| **Data freshness**             | Real-time (scraped on demand)                                                                                                                                                                                                              |
| **Delivery options**           | API download, [Webhook](/datasets/scrapers/linkedin/data-delivery/webhooks), [Amazon S3](/datasets/scrapers/linkedin/data-delivery/amazon-s3), Snowflake, Azure, GCS ([all options](/datasets/scrapers/scrapers-library/delivery-options)) |
| **Pricing**                    | Pay per successful record ([see pricing](https://brightdata.com/pricing/web-scraper))                                                                                                                                                      |

## Common questions

<Accordion title="Is the data scraped in real time?">
  Yes. Each request triggers a live scrape. There is no cached or stale data. Response times vary by endpoint: profiles typically return in 10-30 seconds (sync), while discovery requests may take longer depending on result volume.
</Accordion>

<Accordion title="What is the difference between URL collection and discovery?">
  **URL collection** scrapes a specific LinkedIn page you provide (e.g., a profile URL). **Discovery** finds LinkedIn pages matching search criteria (e.g., "software engineers in San Francisco") and scrapes the results. Discovery is only available via async requests.
</Accordion>

<Accordion title="How is this different from scraping using proxies or Web Unlocker?">
  When scraping using proxies or Web Unlocker, you still need to write and maintain
  your own parsing logic and update it whenever LinkedIn changes its page structure.
  The LinkedIn Scraper API handles the entire stack: proxy rotation, anti-bot bypassing
  and parsing. You simply send a LinkedIn URL and get clean, structured JSON back with
  no scraping infrastructure or parser maintenance required on your end.
</Accordion>

## Next steps

<CardGroup>
  <Card title="Quickstart" icon="rocket" href="/datasets/scrapers/linkedin/quickstart">
    Scrape your first LinkedIn profile in 5 minutes.
  </Card>

  <Card title="Send your first request" icon="bolt" href="/datasets/scrapers/linkedin/send-first-request">
    Full code examples in cURL, Python, and Node.js.
  </Card>

  <Card title="API reference" icon="code" href="/api-reference/scrapers/social-media-apis/linkedin-profiles-collect-by-url">
    Endpoint specs, parameters, and response schemas.
  </Card>
</CardGroup>


# LinkedIn scraper quickstart
Source: https://docs.brightdata.com/datasets/scrapers/linkedin/quickstart

Set up the Bright Data LinkedIn Scraper API and collect your first profile, company or job as structured JSON in under 5 minutes from the Control Panel.

This tutorial shows you how to scrape a LinkedIn profile and get structured JSON data using the Bright Data LinkedIn Scraper API.

## Prerequisites

* A [Bright Data account](https://brightdata.com/cp/start) (includes \$2 free credit)
* cURL, Python 3, or Node.js 18+ installed

<Steps>
  <Step title="Get your API key">
    Go to the [user settings page](https://brightdata.com/cp/setting/users) in your Bright Data account and copy your API key.

    If you don't have an account yet, [sign up at brightdata.com](https://brightdata.com/cp/start). New users get \$2 free credit for testing.

    <Warning>
      Your API key is shown only once when created. Copy and store it securely.
    </Warning>
  </Step>

  <Step title="Send a request">
    We'll use the **Profiles endpoint** with a synchronous request. Replace `YOUR_API_KEY` with your actual token:

    <CodeGroup>
      ```bash cURL theme={null}
      curl -X POST \
        "https://api.brightdata.com/datasets/v3/scrape?dataset_id=gd_l1viktl72bvl7bjuj0&format=json" \
        -H "Authorization: Bearer YOUR_API_KEY" \
        -H "Content-Type: application/json" \
        -d '[{"url": "https://www.linkedin.com/in/satyanadella"}]'
      ```

      ```python Python theme={null}
      import requests

      response = requests.post(
          "https://api.brightdata.com/datasets/v3/scrape",
          params={"dataset_id": "gd_l1viktl72bvl7bjuj0", "format": "json"},
          headers={
              "Authorization": "Bearer YOUR_API_KEY",
              "Content-Type": "application/json",
          },
          json=[{"url": "https://www.linkedin.com/in/satyanadella"}],
      )

      print(response.json())
      ```

      ```javascript Node.js theme={null}
      const response = await fetch(
        "https://api.brightdata.com/datasets/v3/scrape?dataset_id=gd_l1viktl72bvl7bjuj0&format=json",
        {
          method: "POST",
          headers: {
            "Authorization": "Bearer YOUR_API_KEY",
            "Content-Type": "application/json",
          },
          body: JSON.stringify([
            { url: "https://www.linkedin.com/in/satyanadella" }
          ]),
        }
      );

      const data = await response.json();
      console.log(data);
      ```
    </CodeGroup>

    You should see a `200` status code. This takes 10-30 seconds.
  </Step>

  <Step title="Review the response">
    The Bright Data LinkedIn Scraper API returns a JSON array with structured profile data:

    ```json theme={null}
    [
      {
        "name": "Satya Nadella",
        "city": "Redmond",
        "country_code": "US",
        "position": "Chairman and CEO at Microsoft",
        "current_company": {
          "name": "Microsoft",
          "link": "https://www.linkedin.com/company/microsoft"
        },
        "followers": 10842560,
        "connections": 500,
        "url": "https://www.linkedin.com/in/satyanadella"
      }
    ]
    ```

    Each profile object includes 50+ fields covering personal details, work history, education, skills, and social activity. See the [full response schema](/api-reference/scrapers/social-media-apis/linkedin-profiles-collect-by-url).
  </Step>
</Steps>

You've successfully scraped your first LinkedIn profile using the Bright Data LinkedIn Scraper API.

## Common questions

<Accordion title="Can I scrape multiple profiles in one request?">
  Yes. Add more objects to the input array. Synchronous requests support up to 20 URLs. For larger batches, use the [async `/trigger` endpoint](/datasets/scrapers/linkedin/async-requests).

  ```json theme={null}
  [
    {"url": "https://www.linkedin.com/in/satyanadella"},
    {"url": "https://www.linkedin.com/in/jeffweiner08"},
    {"url": "https://www.linkedin.com/in/rbranson"}
  ]
  ```
</Accordion>

<Accordion title="Getting a 401 or 403 error?">
  Verify your API key is correct and hasn't expired. Generate a new token from [Account settings](https://brightdata.com/cp/setting/users). See the [authentication guide](/api-reference/authentication) for details.
</Accordion>

<Accordion title="Request is timing out?">
  Synchronous requests have a 1-minute timeout. If the request exceeds this limit, it automatically switches to async and returns a `snapshot_id`. Use the [async workflow](/datasets/scrapers/linkedin/async-requests) for large batches.
</Accordion>

<Accordion title="Empty or partial response data?">
  Verify the LinkedIn profile URL is publicly accessible and correctly formatted. The URL should follow the pattern `https://www.linkedin.com/in/username`.
</Accordion>

## Next steps

<CardGroup>
  <Card title="Send your first request" icon="bolt" href="/datasets/scrapers/linkedin/send-first-request">
    Explore all four endpoint types with full examples.
  </Card>

  <Card title="Async batch requests" icon="layer-group" href="/datasets/scrapers/linkedin/async-requests">
    Scrape hundreds of URLs in a single batch job.
  </Card>

  <Card title="Set up webhooks" icon="webhook" href="/datasets/scrapers/linkedin/data-delivery/webhooks">
    Receive results automatically when scraping completes.
  </Card>
</CardGroup>


# Send your first LinkedIn API request
Source: https://docs.brightdata.com/datasets/scrapers/linkedin/send-first-request

Send synchronous requests to all 4 Bright Data LinkedIn Scraper API endpoints with copy-paste examples for profiles, companies, jobs and posts.

This tutorial walks you through sending a synchronous request to each Bright Data LinkedIn Scraper API endpoint. By the end, you'll have working examples for profiles, companies, jobs, and posts.

## Prerequisites

* A [Bright Data account](https://brightdata.com/cp/start) with an active API key
* Completed the [Quickstart](/datasets/scrapers/linkedin/quickstart)

## Request structure

Every synchronous request follows the same pattern:

```http theme={null}
POST https://api.brightdata.com/datasets/v3/scrape?dataset_id={DATASET_ID}&format=json
Authorization: Bearer YOUR_API_KEY
Content-Type: application/json

[{"url": "https://www.linkedin.com/..."}]
```

The only thing that changes between endpoints is the `dataset_id` and the input URL format.

<Note>
  Synchronous requests support up to 20 URLs and have a 1-minute timeout. If the request takes longer, the API automatically returns a `snapshot_id` instead. See [async requests](/datasets/scrapers/linkedin/async-requests).
</Note>

## How to scrape LinkedIn profiles

**Dataset ID:** `gd_l1viktl72bvl7bjuj0`

```bash theme={null}
curl -X POST \
  "https://api.brightdata.com/datasets/v3/scrape?dataset_id=gd_l1viktl72bvl7bjuj0&format=json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '[{"url": "https://www.linkedin.com/in/satyanadella"}]'
```

You should see a `200` response. This takes 10-30 seconds.

<Accordion title="Example response">
  ```json theme={null}
  [
    {
      "name": "Satya Nadella",
      "city": "Redmond",
      "country_code": "US",
      "position": "Chairman and CEO at Microsoft",
      "current_company": {
        "name": "Microsoft",
        "company_id": "microsoft",
        "link": "https://www.linkedin.com/company/microsoft"
      },
      "about": "Chairman and CEO at Microsoft...",
      "followers": 10842560,
      "connections": 500
    }
  ]
  ```
</Accordion>

[Full Profiles response schema](/api-reference/scrapers/social-media-apis/linkedin-profiles-collect-by-url)

## How to scrape LinkedIn companies

**Dataset ID:** `gd_l1vikfnt1wgvvqz95w`

```bash theme={null}
curl -X POST \
  "https://api.brightdata.com/datasets/v3/scrape?dataset_id=gd_l1vikfnt1wgvvqz95w&format=json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '[{"url": "https://www.linkedin.com/company/microsoft"}]'
```

<Accordion title="Example response">
  ```json theme={null}
  [
    {
      "name": "Microsoft",
      "followers": 23000000,
      "employees_in_linkedin": 290000,
      "about": "Every company has a mission...",
      "industries": ["Software Development"],
      "company_size": "10,001+ employees",
      "headquarters": "Redmond, Washington",
      "website": "https://www.microsoft.com",
      "founded": "1975"
    }
  ]
  ```
</Accordion>

[Full Companies response schema](/api-reference/scrapers/social-media-apis/linkedin-companies-collect-by-url)

## How to scrape LinkedIn jobs

**Dataset ID:** `gd_lpfll7v5hcqtkxl6l`

```bash theme={null}
curl -X POST \
  "https://api.brightdata.com/datasets/v3/scrape?dataset_id=gd_lpfll7v5hcqtkxl6l&format=json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '[{"url": "https://www.linkedin.com/jobs/view/3986111804"}]'
```

<Accordion title="Example response">
  ```json theme={null}
  [
    {
      "job_title": "Software Engineer",
      "company_name": "Epic",
      "job_location": "Verona, WI",
      "job_seniority_level": "Entry level",
      "job_employment_type": "Full-time",
      "job_industries": ["Software Development"],
      "job_summary": "Work on healthcare software that impacts millions...",
      "apply_link": "https://www.linkedin.com/jobs/view/3986111804/apply",
      "is_easy_apply": true
    }
  ]
  ```
</Accordion>

[Full Jobs response schema](/api-reference/scrapers/social-media-apis/linkedin-jobs-collect-by-url)

## How to scrape LinkedIn posts

**Dataset ID:** `gd_lyy3tktm25m4avu764`

```bash theme={null}
curl -X POST \
  "https://api.brightdata.com/datasets/v3/scrape?dataset_id=gd_lyy3tktm25m4avu764&format=json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '[{"url": "https://www.linkedin.com/posts/satyanadella_activity-7180537307521769472"}]'
```

<Accordion title="Example response">
  ```json theme={null}
  [
    {
      "post_text": "Excited to share our latest AI innovations...",
      "num_likes": 45230,
      "num_comments": 1250,
      "date_posted": "2024-04-03T14:30:00.000Z",
      "hashtags": ["AI", "Innovation"],
      "user_followers": 10842560,
      "post_type": "original"
    }
  ]
  ```
</Accordion>

[Full Posts response schema](/api-reference/scrapers/social-media-apis/linkedin-posts-collect-by-url)

## Quick reference: dataset IDs

| Endpoint  | Dataset ID              | URL pattern                   |
| :-------- | :---------------------- | :---------------------------- |
| Profiles  | `gd_l1viktl72bvl7bjuj0` | `linkedin.com/in/{username}`  |
| Companies | `gd_l1vikfnt1wgvvqz95w` | `linkedin.com/company/{slug}` |
| Jobs      | `gd_lpfll7v5hcqtkxl6l`  | `linkedin.com/jobs/view/{id}` |
| Posts     | `gd_lyy3tktm25m4avu764` | `linkedin.com/posts/{slug}`   |

## Output formats

Control the response format with the `format` query parameter:

| Value    | Description                                 |
| :------- | :------------------------------------------ |
| `json`   | JSON array (default)                        |
| `ndjson` | Newline-delimited JSON, one record per line |
| `csv`    | Comma-separated values                      |

## Next steps

<CardGroup>
  <Card title="Async batch requests" icon="layer-group" href="/datasets/scrapers/linkedin/async-requests">
    Scrape hundreds of URLs in a single batch job.
  </Card>

  <Card title="API reference" icon="code" href="/api-reference/scrapers/social-media-apis/linkedin-profiles-collect-by-url">
    Full parameter and response field reference.
  </Card>
</CardGroup>


# Scrapers
Source: https://docs.brightdata.com/datasets/scrapers/overview

Browse Bright Data Web Scraper APIs for Amazon, LinkedIn, Google, Instagram, TikTok and 1000+ other sites. Pre-built scrapers return structured JSON on demand.

<Note>
  [Start now](https://brightdata.com/?hs_signup=1\&utm_source=docs) with **5,000 free credits per month**. No credit card required. See the [free tier](/general/account/billing-and-pricing/free-tier).

  We’ll also match your **first account deposit up to \$500**.
</Note>

<div>
  <div>
    <div>
      <div>
        <span>Scrapers</span>

        <h1>Structured data from any website</h1>

        <p>
          Send a URL, receive structured JSON/CSV. No proxies, browsers, anti-bot systems or parsing to manage. 1000+ pre-built scrapers cover LinkedIn, Instagram, TikTok, Amazon, Google Maps and more.
        </p>

        <div>
          <a href="/datasets/scrapers/linkedin/quickstart">Start building</a>
        </div>
      </div>

      <div>
        <img alt="Bright Data Web Scraper API overview illustration" />
      </div>
    </div>

    <div>
      <span>💡</span>
      <span>Not ready for a full integration? Run any scraper from the <a href="https://brightdata.com/cp/scrapers/browse">no-code dashboard</a>.</span>
    </div>

    ## Your first request

    Replace `API_KEY` with a key from your [account settings](https://brightdata.com/cp/setting/users). You'll receive a JSON record with 200+ fields. The same request pattern works for every scraper in the library.

    <CodeGroup>
      ```bash cURL theme={null}
      curl "https://api.brightdata.com/datasets/v3/scrape?dataset_id=gd_l1viktl72bvl7bjuj0&format=json" \
        -H "Authorization: Bearer API_KEY" \
        -H "Content-Type: application/json" \
        -d '[{"url": "https://www.linkedin.com/in/elad-moshe-05a90413/"}]'
      ```

      ```python Python theme={null}
      import requests

      url = "https://api.brightdata.com/datasets/v3/scrape"
      headers = {
          "Authorization": "Bearer API_KEY",
          "Content-Type": "application/json",
      }
      params = {"dataset_id": "gd_l1viktl72bvl7bjuj0", "format": "json"}
      payload = [{"url": "https://www.linkedin.com/in/elad-moshe-05a90413/"}]

      response = requests.post(url, headers=headers, params=params, json=payload)
      print(response.json())
      ```

      ```javascript Node.js theme={null}
      const response = await fetch(
        "https://api.brightdata.com/datasets/v3/scrape?dataset_id=gd_l1viktl72bvl7bjuj0&format=json",
        {
          method: "POST",
          headers: {
            "Authorization": "Bearer API_KEY",
            "Content-Type": "application/json",
          },
          body: JSON.stringify([
            { url: "https://www.linkedin.com/in/elad-moshe-05a90413/" },
          ]),
        }
      );

      const data = await response.json();
      console.log(data);
      ```
    </CodeGroup>

    ## Which scrapers are most popular

    <div>
      <span>Most popular</span>
    </div>

    <CardGroup>
      <Card title="LinkedIn" icon="linkedin" href="/datasets/scrapers/linkedin/quickstart">
        Profiles, companies, jobs, posts.
      </Card>

      <Card title="Instagram" icon="instagram" href="/datasets/scrapers/instagram/quickstart">
        Profiles, posts, reels, comments.
      </Card>

      <Card title="TikTok" icon="tiktok" href="/datasets/scrapers/tiktok/quickstart">
        Profiles, posts, comments, shop.
      </Card>

      <Card title="Amazon" icon="amazon" href="/datasets/scrapers/amazon/quickstart">
        Products, reviews, sellers, search.
      </Card>
    </CardGroup>

    <h3>Social</h3>

    <CardGroup>
      <Card title="Facebook" icon="facebook" href="/datasets/scrapers/facebook/quickstart">
        Pages, posts, events.
      </Card>

      <Card title="X / Twitter" icon="x-twitter" href="/datasets/scrapers/twitter/quickstart">
        Profiles and posts.
      </Card>

      <Card title="YouTube" icon="youtube" href="/datasets/scrapers/youtube/quickstart">
        Channels, videos, comments.
      </Card>

      <Card title="Reddit" icon="reddit" href="/datasets/scrapers/reddit/introduction">
        Subreddits, posts, comments.
      </Card>
    </CardGroup>

    <h3>AI & Search</h3>

    <CardGroup>
      <Card title="ChatGPT" icon="comments" href="/datasets/scrapers/chatgpt/quickstart">
        Conversations and prompts.
      </Card>

      <Card title="Google Search" icon="magnifying-glass" href="/datasets/scrapers/google/quickstart">
        SERPs, snippets, featured results.
      </Card>

      <Card title="Google Maps" icon="location-dot" href="/datasets/scrapers/google/quickstart">
        Places, reviews, hours.
      </Card>
    </CardGroup>

    <a href="https://brightdata.com/cp/scrapers/browse">Browse all 1000+ scrapers →</a>

    <div>
      <span>🛠️</span>
      <span>Can't find the site you need? Build a custom scraper in minutes with AI-powered <a href="/datasets/scraper-studio/overview">Scraper Studio</a>.</span>
    </div>

    ## How it works

    Pick a request mode, then pick how you want the data delivered.

    ### Request modes

    <CardGroup>
      <Card title="Synchronous" icon="bolt" href="/datasets/scrapers/concepts/sync-vs-async">
        One request, one response. Best for single URLs and real-time use cases.
      </Card>

      <Card title="Asynchronous" icon="layer-group" href="/datasets/scrapers/linkedin/async-requests">
        Trigger a job, retrieve later. Handles thousands of URLs per request.
      </Card>

      <Card title="Discovery" icon="magnifying-glass" href="/datasets/scrapers/scrapers-library/working-with-sources">
        Find records by keyword or category when you don't have specific URLs.
      </Card>
    </CardGroup>

    ### Which delivery options to use

    <CardGroup>
      <Card title="API download" icon="download" href="/api-reference/scrapers/delivery-apis/download-snapshot">
        Pull results from the API once a job completes.
      </Card>

      <Card title="Webhooks" icon="webhook" href="/datasets/scrapers/linkedin/data-delivery/webhooks">
        Push results to your endpoint as soon as a snapshot is ready.
      </Card>

      <Card title="Cloud storage" icon="cloud" href="/datasets/scrapers/linkedin/data-delivery/amazon-s3">
        Deliver to S3, GCS, Azure, or Snowflake.
      </Card>

      <Card title="Streaming" icon="stream" href="/datasets/scrapers/scrapers-library/stream-and-file-delivery">
        Receive results in batches as they are scraped.
      </Card>
    </CardGroup>

    ## Beyond pre-built scrapers

    <CardGroup>
      <Card title="Custom scrapers" icon="code" href="/datasets/scraper-studio/overview">
        Build a scraper for any site using Scraper Studio. Pass a URL and describe the data you need.
      </Card>

      <Card title="Managed services" icon="screwdriver-wrench" href="/datasets/scrapers/managed-services">
        Bright Data's team builds and operates custom scrapers for your targets. **No code required.**
      </Card>

      <Card title="Datasets marketplace" icon="store" href="/datasets/marketplace">
        Skip scraping entirely. Buy ready-made datasets refreshed on a schedule. **No code required.**
      </Card>
    </CardGroup>

    ## How to combine scrapers and delivery

    End-to-end tutorials that combine a scraper with a delivery option and a target system.

    <CardGroup>
      <Card title="LinkedIn profiles → your CRM" icon="user-magnifying-glass" href="/datasets/scrapers/tutorials/linkedin-to-crm">
        Pull profiles and company data with the LinkedIn scraper, then push them via webhook into HubSpot or Salesforce.
      </Card>

      <Card title="Amazon price monitor" icon="tag" href="/datasets/scrapers/tutorials/amazon-price-monitor">
        Schedule an async job over your SKU list and stream results into S3 for daily price and stock tracking.
      </Card>

      <Card title="Social listener" icon="bell" href="/datasets/scrapers/tutorials/social-listener">
        Use Google SERP as a discovery engine, then fan out to Instagram, TikTok and X scrapers to track mentions by keyword.
      </Card>
    </CardGroup>

    ## What you can build

    <CardGroup>
      <Card title="Lead enrichment" icon="user-magnifying-glass" href="/datasets/scrapers/linkedin/quickstart">
        Pull LinkedIn profiles and company data into your CRM or sales pipeline.
      </Card>

      <Card title="Price monitoring" icon="tag" href="/datasets/scrapers/amazon/quickstart">
        Track product prices, stock, and reviews across e-commerce sites.
      </Card>

      <Card title="Market research" icon="chart-line" href="/datasets/scrapers/instagram/quickstart">
        Aggregate social signals, competitor activity, and trending content.
      </Card>

      <Card title="AI training data" icon="robot" href="/datasets/scrapers/concepts/web-scraper-api-vs-diy">
        Build large, structured datasets to train and fine-tune models.
      </Card>

      <Card title="Job aggregation" icon="briefcase" href="/datasets/scrapers/linkedin/quickstart">
        Collect job listings from LinkedIn and other boards into a single feed.
      </Card>

      <Card title="Brand monitoring" icon="bell" href="/datasets/scrapers/twitter/quickstart">
        Track mentions, hashtags, and sentiment across social platforms.
      </Card>
    </CardGroup>

    ## Where to learn more

    <CardGroup>
      <Card title="Concepts" icon="lightbulb">
        [Sync vs async](/datasets/scrapers/concepts/sync-vs-async)

        [Web Scraper API vs DIY](/datasets/scrapers/concepts/web-scraper-api-vs-diy)
      </Card>

      <Card title="Library reference" icon="book">
        [Library overview](/datasets/scrapers/scrapers-library/overview)

        [Custom inputs](/datasets/scrapers/scrapers-library/custom-inputs)

        [Working with sources](/datasets/scrapers/scrapers-library/working-with-sources)
      </Card>

      <Card title="API basics" icon="code-branch">
        [API reference](/api-reference/rest-api/scraper/asynchronous-requests)

        [Error catalog](/datasets/scrapers/scrapers-library/error-list-by-endpoint)

        [FAQs](/datasets/scrapers/scrapers-library/faqs)
      </Card>

      <Card title="Operations" icon="gauge-high">
        [Delivery options](/datasets/scrapers/scrapers-library/delivery-options)

        [Stream and file delivery](/datasets/scrapers/scrapers-library/stream-and-file-delivery)

        [Deadline feature](/datasets/scrapers/scrapers-library/deadline-feature)
      </Card>
    </CardGroup>
  </div>
</div>


# How to scrape Reddit data in bulk
Source: https://docs.brightdata.com/datasets/scrapers/reddit/async-requests

Trigger large-scale Reddit scraping jobs, monitor progress and retrieve results using the Bright Data async /trigger endpoint. Supports batches of 20 URLs.

This guide shows you how to scrape Reddit data at scale using the asynchronous `/trigger` endpoint. Use this when you have more than 20 URLs, need discovery by keyword or subreddit, or want delivery to a webhook or S3.

<Tip>
  Not sure whether to use sync or async? Read [Understanding sync vs. async requests](/datasets/scrapers/concepts/sync-vs-async).
</Tip>

## Prerequisites

* A [Bright Data account](https://brightdata.com/cp/start) with an active API key
* Familiarity with the [synchronous request flow](/datasets/scrapers/reddit/send-first-request)

## Step 1: Trigger the collection

Send a `POST` request to the `/trigger` endpoint with your input URLs. This example collects five Reddit posts in a single batch:

<CodeGroup>
  ```bash cURL theme={null}
  curl -X POST \
    "https://api.brightdata.com/datasets/v3/trigger?dataset_id=gd_lvz8ah06191smkebj4&format=json" \
    -H "Authorization: Bearer YOUR_API_KEY" \
    -H "Content-Type: application/json" \
    -d '[
      {"url": "https://www.reddit.com/r/learnpython/comments/1asdf12/"},
      {"url": "https://www.reddit.com/r/python/comments/1bsdf34/"},
      {"url": "https://www.reddit.com/r/programming/comments/1csdf56/"},
      {"url": "https://www.reddit.com/r/datascience/comments/1dsdf78/"},
      {"url": "https://www.reddit.com/r/machinelearning/comments/1esdf90/"}
    ]'
  ```

  ```python Python theme={null}
  import requests

  response = requests.post(
      "https://api.brightdata.com/datasets/v3/trigger",
      params={
          "dataset_id": "gd_lvz8ah06191smkebj4",
          "format": "json",
      },
      headers={
          "Authorization": "Bearer YOUR_API_KEY",
          "Content-Type": "application/json",
      },
      json=[
          {"url": "https://www.reddit.com/r/learnpython/comments/1asdf12/"},
          {"url": "https://www.reddit.com/r/python/comments/1bsdf34/"},
          {"url": "https://www.reddit.com/r/programming/comments/1csdf56/"},
          {"url": "https://www.reddit.com/r/datascience/comments/1dsdf78/"},
          {"url": "https://www.reddit.com/r/machinelearning/comments/1esdf90/"},
      ],
  )

  snapshot = response.json()
  print("Snapshot ID:", snapshot["snapshot_id"])
  ```

  ```javascript Node.js theme={null}
  const response = await fetch(
    "https://api.brightdata.com/datasets/v3/trigger?dataset_id=gd_lvz8ah06191smkebj4&format=json",
    {
      method: "POST",
      headers: {
        "Authorization": "Bearer YOUR_API_KEY",
        "Content-Type": "application/json",
      },
      body: JSON.stringify([
        { url: "https://www.reddit.com/r/learnpython/comments/1asdf12/" },
        { url: "https://www.reddit.com/r/python/comments/1bsdf34/" },
        { url: "https://www.reddit.com/r/programming/comments/1csdf56/" },
        { url: "https://www.reddit.com/r/datascience/comments/1dsdf78/" },
        { url: "https://www.reddit.com/r/machinelearning/comments/1esdf90/" },
      ]),
    }
  );

  const snapshot = await response.json();
  console.log("Snapshot ID:", snapshot.snapshot_id);
  ```
</CodeGroup>

You should see a `200` response with a `snapshot_id`:

```json theme={null}
{
  "snapshot_id": "s_m1a2b3c4d5e6f7g8h"
}
```

Save this ID. You need it to check progress and download results.

## Discovery with async

The async endpoint is the best fit for discovery jobs, because Reddit discovery can return many results. Trigger a subreddit or keyword discovery by adding the relevant query parameters:

**Discover by subreddit URL:**

```bash theme={null}
curl -X POST \
  "https://api.brightdata.com/datasets/v3/trigger?dataset_id=gd_lvz8ah06191smkebj4&format=json&type=discover_new&discover_by=subreddit_url" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '[{"url": "https://www.reddit.com/r/learnpython/", "sort_by": "hot"}]'
```

**Discover by keyword:**

```bash theme={null}
curl -X POST \
  "https://api.brightdata.com/datasets/v3/trigger?dataset_id=gd_lvz8ah06191smkebj4&format=json&type=discover_new&discover_by=keyword" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '[{"keyword": "machine learning", "date": "Past week", "num_of_posts": 100}]'
```

## Step 2: Monitor progress

Poll the snapshot status until it shows `ready`. This takes 30 seconds to several minutes depending on the number of URLs and whether discovery is involved.

<CodeGroup>
  ```bash cURL theme={null}
  curl "https://api.brightdata.com/datasets/v3/progress/s_m1a2b3c4d5e6f7g8h" \
    -H "Authorization: Bearer YOUR_API_KEY"
  ```

  ```python Python theme={null}
  import time

  snapshot_id = "s_m1a2b3c4d5e6f7g8h"

  while True:
      status_response = requests.get(
          f"https://api.brightdata.com/datasets/v3/progress/{snapshot_id}",
          headers={"Authorization": "Bearer YOUR_API_KEY"},
      )
      status = status_response.json().get("status")
      print(f"Status: {status}")

      if status == "ready":
          break
      time.sleep(10)
  ```

  ```javascript Node.js theme={null}
  const snapshotId = "s_m1a2b3c4d5e6f7g8h";

  let status = "collecting";
  while (status !== "ready") {
    const statusResponse = await fetch(
      `https://api.brightdata.com/datasets/v3/progress/${snapshotId}`,
      { headers: { "Authorization": "Bearer YOUR_API_KEY" } }
    );
    const statusData = await statusResponse.json();
    status = statusData.status;
    console.log("Status:", status);

    if (status !== "ready") {
      await new Promise((r) => setTimeout(r, 10000));
    }
  }
  ```
</CodeGroup>

Status values:

| Status       | Meaning                             |
| :----------- | :---------------------------------- |
| `collecting` | Scraping is in progress             |
| `digesting`  | Data is being processed             |
| `ready`      | Results are available for download  |
| `failed`     | The collection encountered an error |

## Step 3: Download results

Once the status is `ready`, download the scraped data:

<CodeGroup>
  ```bash cURL theme={null}
  curl "https://api.brightdata.com/datasets/v3/snapshot/s_m1a2b3c4d5e6f7g8h?format=json" \
    -H "Authorization: Bearer YOUR_API_KEY" \
    -o results.json
  ```

  ```python Python theme={null}
  results_response = requests.get(
      f"https://api.brightdata.com/datasets/v3/snapshot/{snapshot_id}",
      params={"format": "json"},
      headers={"Authorization": "Bearer YOUR_API_KEY"},
  )

  results = results_response.json()
  print(f"Collected {len(results)} posts")
  ```

  ```javascript Node.js theme={null}
  const resultsResponse = await fetch(
    `https://api.brightdata.com/datasets/v3/snapshot/${snapshotId}?format=json`,
    { headers: { "Authorization": "Bearer YOUR_API_KEY" } }
  );

  const results = await resultsResponse.json();
  console.log(`Collected ${results.length} posts`);
  ```
</CodeGroup>

You've successfully triggered, monitored and downloaded a batch Reddit scraping job.

## Skip polling with webhooks

If you don't want to poll for status, add an `endpoint` parameter to receive results automatically:

```bash theme={null}
curl -X POST \
  "https://api.brightdata.com/datasets/v3/trigger?dataset_id=gd_lvz8ah06191smkebj4&format=json&endpoint=https://your-server.com/webhook" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '[{"url": "https://www.reddit.com/r/learnpython/comments/1asdf12/"}]'
```

See [Webhook delivery options](/datasets/scrapers/scrapers-library/delivery-options) for the full setup.

## Limits and constraints

| Constraint                           | Value      |
| :----------------------------------- | :--------- |
| Max input file size                  | 1 GB       |
| Max concurrent batch requests        | 100        |
| Max concurrent single-input requests | 1,500      |
| Webhook delivery size                | Up to 1 GB |
| API download size                    | Up to 5 GB |

## Troubleshooting

<Accordion title="Getting a 429 Too Many Requests error?">
  You've exceeded the concurrent request limit. Reduce the number of parallel requests or combine inputs into fewer, larger batches. Each batch can include up to 1 GB of input data.
</Accordion>

<Accordion title="Snapshot status shows 'failed'?">
  Check that all input URLs are valid, publicly accessible Reddit URLs. Review the error details in the snapshot response or in the [Logs tab](https://brightdata.com/cp/scrapers) of your Bright Data dashboard.
</Accordion>

<Accordion title="Results are incomplete or missing some URLs?">
  Some URLs may fail individually while the overall job succeeds. Private subreddits, deleted posts and removed comments cannot be scraped. Check the snapshot response for any `errors` field and retry failed URLs in a separate request.
</Accordion>

<Accordion title="Discovery returned zero results?">
  For keyword discovery, make sure the `date` value matches one of Reddit's accepted ranges (e.g. `Past hour`, `Past day`, `Past week`, `Past month`, `Past year`, `All time`). For subreddit discovery, confirm the subreddit URL is valid and not private.
</Accordion>

## Next steps

<CardGroup>
  <Card title="Delivery options" icon="cloud" href="/datasets/scrapers/scrapers-library/delivery-options">
    Webhooks, S3, Snowflake, Azure and GCS delivery.
  </Card>

  <Card title="API reference" icon="code" href="/api-reference/scrapers/social-media-apis/reddit-posts-collect-by-url">
    Full endpoint specs, parameters and response schemas.
  </Card>
</CardGroup>


# How to deliver Reddit data to Amazon S3
Source: https://docs.brightdata.com/datasets/scrapers/reddit/data-delivery/amazon-s3

Configure the Bright Data Reddit Scraper API to deliver scraped posts, comments and subreddit data directly to your Amazon S3 bucket on job completion.

This guide shows you how to configure the Bright Data Reddit Scraper API to deliver scraped data directly to your Amazon S3 bucket when a collection job completes.

## Prerequisites

* A [Bright Data account](https://brightdata.com/cp/start) with an active API key
* An AWS account with an S3 bucket
* IAM credentials with write access to the bucket
* Familiarity with the [async request workflow](/datasets/scrapers/reddit/async-requests)

## Step 1: Create an S3 bucket

If you already have a bucket, skip to Step 2.

In the [AWS S3 Console](https://s3.console.aws.amazon.com/s3/buckets):

1. Click **Create bucket**
2. Enter a bucket name (e.g., `reddit-scraper-data`)
3. Select your preferred AWS region
4. Keep default settings and click **Create bucket**

## Step 2: Set up IAM permissions

Create an IAM role that grants Bright Data write access to your bucket.

### Create a policy

In the [IAM Console](https://console.aws.amazon.com/iam/), go to **Policies** and create a new policy with this JSON:

```json theme={null}
{
  "Version": "2012-10-17",
  "Statement": [
    {
      "Effect": "Allow",
      "Action": ["s3:PutObject", "s3:GetObject"],
      "Resource": "arn:aws:s3:::reddit-scraper-data/*"
    }
  ]
}
```

Replace `reddit-scraper-data` with your actual bucket name.

### Create a role for Bright Data

1. Go to **Roles** > **Create role**
2. Select **AWS account** as the trusted entity type
3. Enter Bright Data's AWS account ID: `422310177405`
4. Attach the policy you created above
5. Name the role (e.g., `BrightDataS3Delivery`)
6. Note the role ARN (e.g., `arn:aws:iam::123456789012:role/BrightDataS3Delivery`)

Add an external ID condition to the trust policy:

```json theme={null}
{
  "Version": "2012-10-17",
  "Statement": [
    {
      "Effect": "Allow",
      "Principal": {
        "AWS": "arn:aws:iam::422310177405:role/brd.ec2.zs-dca-delivery"
      },
      "Action": "sts:AssumeRole",
      "Condition": {
        "StringEquals": {
          "sts:ExternalId": "YOUR_BRIGHT_DATA_CUSTOMER_ID"
        }
      }
    }
  ]
}
```

Find your customer ID in [Account settings](https://brightdata.com/cp/setting/customer_details).

## Step 3: Configure delivery in Bright Data

1. Navigate to your [scraper configuration](https://brightdata.com/cp/scrapers)
2. Click the **Delivery settings** tab
3. Select **Amazon S3** as the delivery destination
4. Enter your credentials:
   * **Bucket name**: Your S3 bucket name
   * **Role ARN**: The IAM role ARN from Step 2
   * **Region**: Your S3 bucket region
   * **Path prefix** (optional): A folder path within the bucket (e.g., `reddit/posts/`)
5. Select your preferred file format (JSON, NDJSON or CSV)
6. Click **Save**

## Step 4: Trigger a collection

Trigger an async collection. Results are automatically delivered to your S3 bucket:

<CodeGroup>
  ```bash cURL theme={null}
  curl -X POST \
    "https://api.brightdata.com/datasets/v3/trigger?dataset_id=gd_lvz8ah06191smkebj4&format=json" \
    -H "Authorization: Bearer YOUR_API_KEY" \
    -H "Content-Type: application/json" \
    -d '[
      {"url": "https://www.reddit.com/r/learnpython/comments/1asdf12/"},
      {"url": "https://www.reddit.com/r/python/comments/1bsdf34/"},
      {"url": "https://www.reddit.com/r/programming/comments/1csdf56/"}
    ]'
  ```

  ```python Python theme={null}
  import requests

  response = requests.post(
      "https://api.brightdata.com/datasets/v3/trigger",
      params={"dataset_id": "gd_lvz8ah06191smkebj4", "format": "json"},
      headers={
          "Authorization": "Bearer YOUR_API_KEY",
          "Content-Type": "application/json",
      },
      json=[
          {"url": "https://www.reddit.com/r/learnpython/comments/1asdf12/"},
          {"url": "https://www.reddit.com/r/python/comments/1bsdf34/"},
          {"url": "https://www.reddit.com/r/programming/comments/1csdf56/"},
      ],
  )

  print("Snapshot ID:", response.json()["snapshot_id"])
  ```

  ```javascript Node.js theme={null}
  const response = await fetch(
    "https://api.brightdata.com/datasets/v3/trigger?dataset_id=gd_lvz8ah06191smkebj4&format=json",
    {
      method: "POST",
      headers: {
        "Authorization": "Bearer YOUR_API_KEY",
        "Content-Type": "application/json",
      },
      body: JSON.stringify([
        { url: "https://www.reddit.com/r/learnpython/comments/1asdf12/" },
        { url: "https://www.reddit.com/r/python/comments/1bsdf34/" },
        { url: "https://www.reddit.com/r/programming/comments/1csdf56/" },
      ]),
    }
  );

  const data = await response.json();
  console.log("Snapshot ID:", data.snapshot_id);
  ```
</CodeGroup>

## Step 5: Verify delivery

Once the collection completes, check your S3 bucket for the delivered file:

```bash theme={null}
aws s3 ls s3://reddit-scraper-data/reddit/posts/
```

You should see a file named with the snapshot ID (e.g., `s_m1a2b3c4d5e6f7g8h.json`).

Download and inspect it:

```bash theme={null}
aws s3 cp s3://reddit-scraper-data/reddit/posts/s_m1a2b3c4d5e6f7g8h.json ./results.json
cat results.json | python -m json.tool | head -20
```

You can also verify delivery status using the [Monitor Delivery API](/api-reference/scrapers/management-apis/monitor-delivery).

## Troubleshooting

<Accordion title="Files not appearing in S3?">
  * Verify the IAM role ARN and external ID are correct
  * Check that the bucket policy allows `s3:PutObject` from Bright Data's account
  * Ensure the bucket region matches your configuration
  * Review delivery status in the Bright Data dashboard under **Logs**
</Accordion>

<Accordion title="Access denied errors?">
  Verify the trust policy on your IAM role includes Bright Data's account (`422310177405`) and your external ID matches your Bright Data customer ID found in [Account settings](https://brightdata.com/cp/setting/customer_details).
</Accordion>

<Accordion title="Delivered file is empty or missing records?">
  Check the collection status in the Bright Data dashboard. If some URLs failed, the delivered file contains only successful results. Retry failed URLs in a separate request.
</Accordion>

## Next steps

<CardGroup>
  <Card title="Set up webhooks" icon="webhook" href="/datasets/scrapers/reddit/data-delivery/webhooks">
    Receive results at your HTTP endpoint.
  </Card>

  <Card title="All delivery options" icon="truck" href="/datasets/scrapers/scrapers-library/delivery-options">
    Snowflake, Azure, GCS, SFTP and more.
  </Card>
</CardGroup>


# How to receive Reddit data via webhooks
Source: https://docs.brightdata.com/datasets/scrapers/reddit/data-delivery/webhooks

Configure the Bright Data Reddit Scraper API to push scraped posts, comments and subreddit data to your HTTPS webhook with 4xx errors retried automatically.

This guide shows you how to set up webhook delivery so your server receives scraped Reddit data automatically when a collection job finishes.

## Prerequisites

* A [Bright Data account](https://brightdata.com/cp/start) with an active API key
* Familiarity with the [async request workflow](/datasets/scrapers/reddit/async-requests)
* A publicly accessible HTTP endpoint (or a testing tool like [webhook.site](https://webhook.site))

## How webhooks work

When you trigger an async collection with an `endpoint` URL, Bright Data sends a `POST` request to that URL with the scraped data once the job completes. No polling required.

```text theme={null}
Your app --> POST /trigger (with webhook URL) --> Bright Data scrapes --> POST to your webhook
```

## Step 1: Set up a test webhook

For testing, use [webhook.site](https://webhook.site) to get a temporary public URL:

1. Open [webhook.site](https://webhook.site) in your browser
2. Copy the unique URL displayed (e.g., `https://webhook.site/abc-123-def`)
3. Keep the page open to monitor incoming requests

## Step 2: Trigger a collection with the webhook URL

Add the `endpoint` query parameter to your async `/trigger` request:

<CodeGroup>
  ```bash cURL theme={null}
  curl -X POST \
    "https://api.brightdata.com/datasets/v3/trigger?dataset_id=gd_lvz8ah06191smkebj4&format=json&endpoint=https://webhook.site/abc-123-def&uncompressed_webhook=true" \
    -H "Authorization: Bearer YOUR_API_KEY" \
    -H "Content-Type: application/json" \
    -d '[
      {"url": "https://www.reddit.com/r/learnpython/comments/1asdf12/"},
      {"url": "https://www.reddit.com/r/python/comments/1bsdf34/"}
    ]'
  ```

  ```python Python theme={null}
  import requests

  WEBHOOK_URL = "https://webhook.site/abc-123-def"

  response = requests.post(
      "https://api.brightdata.com/datasets/v3/trigger",
      params={
          "dataset_id": "gd_lvz8ah06191smkebj4",
          "format": "json",
          "webhook": WEBHOOK_URL,
          "uncompressed_webhook": "true",
      },
      headers={
          "Authorization": "Bearer YOUR_API_KEY",
          "Content-Type": "application/json",
      },
      json=[
          {"url": "https://www.reddit.com/r/learnpython/comments/1asdf12/"},
          {"url": "https://www.reddit.com/r/python/comments/1bsdf34/"},
      ],
  )

  print("Snapshot ID:", response.json()["snapshot_id"])
  ```

  ```javascript Node.js theme={null}
  const WEBHOOK_URL = "https://webhook.site/abc-123-def";

  const response = await fetch(
    `https://api.brightdata.com/datasets/v3/trigger?dataset_id=gd_lvz8ah06191smkebj4&format=json&endpoint=${encodeURIComponent(WEBHOOK_URL)}&uncompressed_webhook=true`,
    {
      method: "POST",
      headers: {
        "Authorization": "Bearer YOUR_API_KEY",
        "Content-Type": "application/json",
      },
      body: JSON.stringify([
        { url: "https://www.reddit.com/r/learnpython/comments/1asdf12/" },
        { url: "https://www.reddit.com/r/python/comments/1bsdf34/" },
      ]),
    }
  );

  const data = await response.json();
  console.log("Snapshot ID:", data.snapshot_id);
  ```
</CodeGroup>

Key parameters:

| Parameter              | Description                                                  |
| :--------------------- | :----------------------------------------------------------- |
| `endpoint`             | Your HTTP endpoint URL that receives the `POST` payload      |
| `uncompressed_webhook` | Set to `true` to receive uncompressed JSON (default is gzip) |
| `format`               | Output format: `json`, `ndjson` or `csv`                     |

## Step 3: Verify delivery

Once the collection completes (typically 30 to 60 seconds for a few posts), check your webhook.site page. You should see a `POST` request with the scraped data.

The payload is the same JSON array you would receive from a direct API download:

```json theme={null}
[
  {
    "post_id": "1asdf12",
    "url": "https://www.reddit.com/r/learnpython/comments/1asdf12/",
    "title": "How do I start learning Python?",
    "num_upvotes": 1240,
    "num_comments": 86,
    "community_name": "learnpython"
  },
  {
    "post_id": "1bsdf34",
    "url": "https://www.reddit.com/r/python/comments/1bsdf34/",
    "title": "New Python 3.13 features",
    "num_upvotes": 540,
    "num_comments": 31,
    "community_name": "python"
  }
]
```

## Production webhook setup

For production, point the `endpoint` URL to your own server endpoint.

### How to handle webhooks in Express.js

```javascript server.js theme={null}
const express = require("express");
const app = express();

app.use(express.json({ limit: "100mb" }));

app.post("/webhook/reddit", (req, res) => {
  const posts = req.body;
  console.log(`Received ${posts.length} posts`);

  for (const post of posts) {
    console.log(`- ${post.title} (r/${post.community_name})`);
  }

  res.status(200).json({ received: true });
});

app.listen(3000, () => console.log("Webhook server running on port 3000"));
```

### How to handle webhooks in Flask

```python server.py theme={null}
from flask import Flask, request, jsonify

app = Flask(__name__)

@app.route("/webhook/reddit", methods=["POST"])
def handle_webhook():
    posts = request.get_json()
    print(f"Received {len(posts)} posts")

    for post in posts:
        print(f"- {post['title']} (r/{post.get('community_name')})")

    return jsonify({"received": True}), 200

if __name__ == "__main__":
    app.run(port=3000)
```

<Warning>
  Return a `200` status code within 30 seconds to acknowledge receipt. If your endpoint fails or times out, Bright Data retries delivery.
</Warning>

## Webhook with authorization

If your endpoint requires authentication, add the `webhook_header_Authorization` parameter:

```bash theme={null}
curl -X POST \
  "https://api.brightdata.com/datasets/v3/trigger?dataset_id=gd_lvz8ah06191smkebj4&format=json&endpoint=https://your-server.com/webhook&webhook_header_Authorization=Bearer+YOUR_SECRET_TOKEN" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '[{"url": "https://www.reddit.com/r/learnpython/comments/1asdf12/"}]'
```

## Allowlist webhook IPs

If your server uses an IP allowlist, add the following Bright Data webhook source IPs:

```text theme={null}
54.175.27.69
34.225.9.175
100.28.38.247
100.29.18.195
52.72.185.255
35.174.112.248
54.165.183.124
3.91.140.7
52.202.75.37
98.82.225.117
100.27.150.189
18.214.10.85
35.169.71.210
44.194.183.74
```

## Troubleshooting

<Accordion title="Webhook not receiving data?">
  * Verify the URL is publicly accessible (not `localhost`)
  * Check that your endpoint returns a `200` status code within 30 seconds
  * Verify the webhook IPs above are allowlisted if you have firewall rules
</Accordion>

<Accordion title="Receiving compressed data?">
  If you omit `uncompressed_webhook=true`, data arrives gzip-compressed. Add `uncompressed_webhook=true` to your trigger URL, or decompress the payload on your server.
</Accordion>

<Accordion title="Payload too large for your server?">
  Large collections can produce payloads up to 1 GB. Set `express.json({ limit: "100mb" })` in Express.js or equivalent in your framework. If you need to handle very large datasets, use [S3 delivery](/datasets/scrapers/reddit/data-delivery/amazon-s3) instead.
</Accordion>

## Next steps

<CardGroup>
  <Card title="Deliver to Amazon S3" icon="bucket" href="/datasets/scrapers/reddit/data-delivery/amazon-s3">
    Store results directly in your S3 bucket.
  </Card>

  <Card title="All delivery options" icon="truck" href="/datasets/scrapers/scrapers-library/delivery-options">
    Snowflake, Azure, GCS and more.
  </Card>
</CardGroup>


# Reddit Scraper API
Source: https://docs.brightdata.com/datasets/scrapers/reddit/introduction

Use the Bright Data Reddit Scraper API to extract structured data from posts, comments and subreddits. Handles up to 20 URLs per request.

Send a Reddit URL or a keyword, get structured JSON back. The Bright Data Reddit Scraper API handles proxies, CAPTCHAs and parsing so you can focus on your data pipeline.

<Tip>
  New to Bright Data? [Create a free account](https://brightdata.com/cp/start) and get \$2 credit to start scraping.
</Tip>

## How it works

You send one or more Reddit URLs or keywords to the Bright Data Reddit Scraper API. Bright Data handles the scraping infrastructure and returns clean, structured JSON.

```text theme={null}
Your app  -->  Bright Data API  -->  Structured JSON
           POST /datasets/v3/scrape
           Authorization: Bearer YOUR_API_KEY
```

All requests use a `dataset_id` to specify the data type (posts or comments) and return results in JSON, NDJSON or CSV.

## Supported data types

<CardGroup>
  <Card title="Posts" icon="images" href="/api-reference/scrapers/social-media-apis/reddit-posts-collect-by-url">
    Titles, descriptions, upvotes, community stats and attached media. Collect by post URL or discover by keyword or subreddit URL.
  </Card>

  <Card title="Comments" icon="comments" href="/api-reference/scrapers/social-media-apis/reddit-comments-collect-by-url">
    Comment text, replies, upvotes and post context. Collect by post or comment URL, with optional day-based filtering.
  </Card>
</CardGroup>

## Which endpoints are available

The Reddit Scraper API exposes two dataset families. Each family supports one or more input shapes.

| Dataset                                                        | Input                                    | What it returns                                           |
| :------------------------------------------------------------- | :--------------------------------------- | :-------------------------------------------------------- |
| **Posts, Collect by URL** (`gd_lvz8ah06191smkebj4`)            | `url` (post URL)                         | A single post with metadata, community info and media     |
| **Posts, Discover by keyword** (`gd_lvz8ah06191smkebj4`)       | `keyword`, `date`, `num_of_posts`        | Posts matching a search term, filtered by date            |
| **Posts, Discover by subreddit URL** (`gd_lvz8ah06191smkebj4`) | `url` (subreddit URL), `sort_by`         | Posts from one subreddit, sorted by `new`, `top` or `hot` |
| **Comments, Collect by URL** (`gd_lvzdpsdlw09j6t702`)          | `url` (post or comment URL), `days_back` | Comments from a post with full thread context             |

## Request methods

The Bright Data Reddit Scraper API supports two request methods. Choose based on your volume and latency needs.

| Method           | Endpoint                                                  | Best for                                              |
| :--------------- | :-------------------------------------------------------- | :---------------------------------------------------- |
| **Synchronous**  | [`/scrape`](/datasets/scrapers/reddit/send-first-request) | Real-time lookups, up to 20 URLs                      |
| **Asynchronous** | [`/trigger`](/datasets/scrapers/reddit/async-requests)    | Batch jobs, 20+ URLs, discovery, production pipelines |

Learn more in [Understanding sync vs. async requests](/datasets/scrapers/concepts/sync-vs-async).

## Capabilities and limits

| Capability                     | Detail                                                                                                                        |
| :----------------------------- | :---------------------------------------------------------------------------------------------------------------------------- |
| **Output formats**             | JSON, NDJSON, CSV                                                                                                             |
| **Max URLs per sync request**  | 20                                                                                                                            |
| **Max URLs per async request** | 5,000                                                                                                                         |
| **Data freshness**             | Real-time (scraped on demand)                                                                                                 |
| **Delivery options**           | API download, webhook, Amazon S3, Snowflake, Azure, GCS ([all options](/datasets/scrapers/scrapers-library/delivery-options)) |
| **Pricing**                    | Pay per successful record ([see pricing](https://brightdata.com/pricing/web-scraper))                                         |

## Common questions

<Accordion title="Is the data scraped in real time?">
  Yes. Each request triggers a live scrape against Reddit. There is no cached or stale data. Response times vary by endpoint: Collect-by-URL requests typically return in 10 to 30 seconds, while discovery requests may take longer depending on result volume.
</Accordion>

<Accordion title="What is the difference between Collect and Discover?">
  **Collect by URL** scrapes a specific Reddit page you provide, a single post, a comment thread or a subreddit. **Discover** finds Reddit posts matching search criteria such as a keyword or a subreddit listing, then scrapes the results. Discovery is most useful via async requests when you don't know the exact URLs up front.
</Accordion>

<Accordion title="Can I collect only recent comments from a post?">
  Yes. The Comments API accepts an optional `days_back` parameter. Pass an integer to limit results to comments posted within that many days.
</Accordion>

<Accordion title="How is this different from scraping using proxies or Web Unlocker?">
  When scraping using proxies or Web Unlocker, you still need to write and maintain your own parsing logic and update it whenever Reddit changes its page structure. The Reddit Scraper API handles the entire stack: proxy rotation, anti-bot bypassing and parsing. You simply send a Reddit URL or keyword and get clean, structured JSON back with no scraping infrastructure or parser maintenance required on your end.
</Accordion>

## Next steps

<CardGroup>
  <Card title="Quickstart" icon="rocket" href="/datasets/scrapers/reddit/quickstart">
    Scrape your first Reddit post in 5 minutes.
  </Card>

  <Card title="Send your first request" icon="bolt" href="/datasets/scrapers/reddit/send-first-request">
    Full code examples for every endpoint in cURL, Python and Node.js.
  </Card>

  <Card title="API reference" icon="code" href="/api-reference/scrapers/social-media-apis/reddit-posts-collect-by-url">
    Endpoint specs, parameters and response schemas.
  </Card>
</CardGroup>


# Reddit scraper quickstart
Source: https://docs.brightdata.com/datasets/scrapers/reddit/quickstart

Set up the Bright Data Reddit Scraper API and collect your first post, comment thread or subreddit as structured JSON in under 5 minutes from the Control Panel.

This tutorial shows you how to scrape a Reddit post and get structured JSON data using the Bright Data Reddit Scraper API.

## Prerequisites

* A [Bright Data account](https://brightdata.com/cp/start) (includes \$2 free credit)
* cURL, Python 3 or Node.js 18+ installed

<Steps>
  <Step title="Get your API key">
    Go to the [user settings page](https://brightdata.com/cp/setting/users) in your Bright Data account and copy your API key.

    If you don't have an account yet, [sign up at brightdata.com](https://brightdata.com/cp/start). New users get \$2 free credit for testing.

    <Warning>
      Your API key is shown only once when created. Copy and store it securely.
    </Warning>
  </Step>

  <Step title="Send a request">
    We'll use the **Posts, Collect by URL** endpoint with a synchronous request. Replace `YOUR_API_KEY` with your actual token:

    <CodeGroup>
      ```bash cURL theme={null}
      curl -X POST \
        "https://api.brightdata.com/datasets/v3/scrape?dataset_id=gd_lvz8ah06191smkebj4&format=json" \
        -H "Authorization: Bearer YOUR_API_KEY" \
        -H "Content-Type: application/json" \
        -d '[{"url": "https://www.reddit.com/r/learnpython/comments/1asdf12/how_do_i_start_learning_python/"}]'
      ```

      ```python Python theme={null}
      import requests

      response = requests.post(
          "https://api.brightdata.com/datasets/v3/scrape",
          params={"dataset_id": "gd_lvz8ah06191smkebj4", "format": "json"},
          headers={
              "Authorization": "Bearer YOUR_API_KEY",
              "Content-Type": "application/json",
          },
          json=[{"url": "https://www.reddit.com/r/learnpython/comments/1asdf12/how_do_i_start_learning_python/"}],
      )

      print(response.json())
      ```

      ```javascript Node.js theme={null}
      const response = await fetch(
        "https://api.brightdata.com/datasets/v3/scrape?dataset_id=gd_lvz8ah06191smkebj4&format=json",
        {
          method: "POST",
          headers: {
            "Authorization": "Bearer YOUR_API_KEY",
            "Content-Type": "application/json",
          },
          body: JSON.stringify([
            { url: "https://www.reddit.com/r/learnpython/comments/1asdf12/how_do_i_start_learning_python/" }
          ]),
        }
      );

      const data = await response.json();
      console.log(data);
      ```
    </CodeGroup>

    You should see a `200` status code. This takes 10 to 30 seconds.
  </Step>

  <Step title="Review the response">
    The Bright Data Reddit Scraper API returns a JSON array with structured post data:

    ```json theme={null}
    [
      {
        "post_id": "1asdf12",
        "url": "https://www.reddit.com/r/learnpython/comments/1asdf12/how_do_i_start_learning_python/",
        "user_posted": "example_user",
        "title": "How do I start learning Python?",
        "description": "I'm a complete beginner...",
        "num_upvotes": 1240,
        "num_comments": 86,
        "date_posted": "2025-03-14T18:22:00Z",
        "community_name": "learnpython",
        "community_url": "https://www.reddit.com/r/learnpython",
        "community_members_num": 1_120_000,
        "tag": "Tutorial"
      }
    ]
    ```

    Each post object includes post details, community stats, engagement metrics and attached media. See the [full response schema](/api-reference/scrapers/social-media-apis/reddit-posts-collect-by-url).
  </Step>
</Steps>

You've successfully scraped your first Reddit post using the Bright Data Reddit Scraper API.

## Common questions

<Accordion title="Can I scrape multiple posts in one request?">
  Yes. Add more objects to the input array. Synchronous requests support up to 20 URLs. For larger batches or for discovery by keyword or subreddit, use the [async `/trigger` endpoint](/datasets/scrapers/reddit/async-requests).

  ```json theme={null}
  [
    {"url": "https://www.reddit.com/r/learnpython/comments/1asdf12/"},
    {"url": "https://www.reddit.com/r/python/comments/1bsdf34/"},
    {"url": "https://www.reddit.com/r/programming/comments/1csdf56/"}
  ]
  ```
</Accordion>

<Accordion title="Can I scrape comments from a post?">
  Yes, with the separate Comments dataset. Use dataset ID `gd_lvzdpsdlw09j6t702` and pass the post URL:

  ```bash theme={null}
  curl -X POST \
    "https://api.brightdata.com/datasets/v3/scrape?dataset_id=gd_lvzdpsdlw09j6t702&format=json" \
    -H "Authorization: Bearer YOUR_API_KEY" \
    -H "Content-Type: application/json" \
    -d '[{"url": "https://www.reddit.com/r/learnpython/comments/1asdf12/"}]'
  ```

  You can also pass `days_back` to limit results to comments posted within the last N days.
</Accordion>

<Accordion title="Getting a 401 or 403 error?">
  Verify your API key is correct and hasn't expired. Generate a new token from [Account settings](https://brightdata.com/cp/setting/users). See the [authentication guide](/api-reference/authentication) for details.
</Accordion>

<Accordion title="Request is timing out?">
  Synchronous requests have a 1-minute timeout. If the request exceeds this limit, it automatically switches to async and returns a `snapshot_id`. Use the [async workflow](/datasets/scrapers/reddit/async-requests) for large batches.
</Accordion>

<Accordion title="Empty or partial response data?">
  Verify the Reddit post URL is publicly accessible and correctly formatted. The URL should follow the pattern `https://www.reddit.com/r/{subreddit}/comments/{post_id}/{slug}/`. Private subreddits and deleted posts cannot be scraped.
</Accordion>

## Next steps

<CardGroup>
  <Card title="Send your first request" icon="bolt" href="/datasets/scrapers/reddit/send-first-request">
    Explore every endpoint with full examples in cURL, Python and Node.js.
  </Card>

  <Card title="Async batch requests" icon="layer-group" href="/datasets/scrapers/reddit/async-requests">
    Scrape hundreds of posts or run keyword discovery in a single batch job.
  </Card>

  <Card title="API reference" icon="code" href="/api-reference/scrapers/social-media-apis/reddit-posts-collect-by-url">
    Endpoint specs, parameters and response schemas.
  </Card>
</CardGroup>


# Send your first Reddit API request
Source: https://docs.brightdata.com/datasets/scrapers/reddit/send-first-request

Send synchronous requests to every Bright Data Reddit Scraper API endpoint with copy-paste examples for posts, comments and subreddit data across 3 surfaces.

This tutorial walks you through sending a synchronous request to each Bright Data Reddit Scraper API endpoint. By the end, you'll have working examples for collecting posts, discovering posts and collecting comments.

## Prerequisites

* A [Bright Data account](https://brightdata.com/cp/start) with an active API key
* Completed the [Quickstart](/datasets/scrapers/reddit/quickstart)

## Request structure

Every synchronous request follows the same pattern:

```http theme={null}
POST https://api.brightdata.com/datasets/v3/scrape?dataset_id={DATASET_ID}&format=json
Authorization: Bearer YOUR_API_KEY
Content-Type: application/json

[{"url": "https://www.reddit.com/..."}]
```

The only things that change between endpoints are the `dataset_id` and the input shape.

<Note>
  Synchronous requests support up to 20 URLs and have a 1-minute timeout. If the request takes longer, the API automatically returns a `snapshot_id` instead. See [async requests](/datasets/scrapers/reddit/async-requests).
</Note>

## Posts, Collect by URL

Scrape a specific Reddit post by its URL.

**Dataset ID:** `gd_lvz8ah06191smkebj4`

<CodeGroup>
  ```bash cURL theme={null}
  curl -X POST \
    "https://api.brightdata.com/datasets/v3/scrape?dataset_id=gd_lvz8ah06191smkebj4&format=json" \
    -H "Authorization: Bearer YOUR_API_KEY" \
    -H "Content-Type: application/json" \
    -d '[{"url": "https://www.reddit.com/r/learnpython/comments/1asdf12/how_do_i_start_learning_python/"}]'
  ```

  ```python Python theme={null}
  import requests

  response = requests.post(
      "https://api.brightdata.com/datasets/v3/scrape",
      params={"dataset_id": "gd_lvz8ah06191smkebj4", "format": "json"},
      headers={
          "Authorization": "Bearer YOUR_API_KEY",
          "Content-Type": "application/json",
      },
      json=[{"url": "https://www.reddit.com/r/learnpython/comments/1asdf12/how_do_i_start_learning_python/"}],
  )

  print(response.json())
  ```

  ```javascript Node.js theme={null}
  const response = await fetch(
    "https://api.brightdata.com/datasets/v3/scrape?dataset_id=gd_lvz8ah06191smkebj4&format=json",
    {
      method: "POST",
      headers: {
        "Authorization": "Bearer YOUR_API_KEY",
        "Content-Type": "application/json",
      },
      body: JSON.stringify([
        { url: "https://www.reddit.com/r/learnpython/comments/1asdf12/how_do_i_start_learning_python/" }
      ]),
    }
  );

  const data = await response.json();
  console.log(data);
  ```
</CodeGroup>

You should see a `200` response. This takes 10 to 30 seconds.

<Accordion title="Example response">
  ```json theme={null}
  [
    {
      "post_id": "1asdf12",
      "url": "https://www.reddit.com/r/learnpython/comments/1asdf12/how_do_i_start_learning_python/",
      "user_posted": "example_user",
      "title": "How do I start learning Python?",
      "description": "I'm a complete beginner and want to know the best resources...",
      "num_upvotes": 1240,
      "num_comments": 86,
      "date_posted": "2025-03-14T18:22:00Z",
      "tag": "Tutorial",
      "community_name": "learnpython",
      "community_url": "https://www.reddit.com/r/learnpython",
      "community_description": "Subreddit for posting questions...",
      "community_members_num": 1120000,
      "community_rank": "Top 1%",
      "photos": [],
      "videos": []
    }
  ]
  ```
</Accordion>

[Full Posts - Collect by URL schema](/api-reference/scrapers/social-media-apis/reddit-posts-collect-by-url)

## Posts, Discover by subreddit URL

Scrape recent posts from a specific subreddit, optionally sorted by `new`, `top` or `hot`.

**Dataset ID:** `gd_lvz8ah06191smkebj4`

<Note>
  Discovery endpoints are best used asynchronously via [`/trigger`](/datasets/scrapers/reddit/async-requests) since they may return many results. The sync example below is for quick testing.
</Note>

<CodeGroup>
  ```bash cURL theme={null}
  curl -X POST \
    "https://api.brightdata.com/datasets/v3/scrape?dataset_id=gd_lvz8ah06191smkebj4&format=json&type=discover_new&discover_by=subreddit_url" \
    -H "Authorization: Bearer YOUR_API_KEY" \
    -H "Content-Type: application/json" \
    -d '[{"url": "https://www.reddit.com/r/learnpython/", "sort_by": "hot"}]'
  ```

  ```python Python theme={null}
  import requests

  response = requests.post(
      "https://api.brightdata.com/datasets/v3/scrape",
      params={
          "dataset_id": "gd_lvz8ah06191smkebj4",
          "format": "json",
          "type": "discover_new",
          "discover_by": "subreddit_url",
      },
      headers={
          "Authorization": "Bearer YOUR_API_KEY",
          "Content-Type": "application/json",
      },
      json=[{"url": "https://www.reddit.com/r/learnpython/", "sort_by": "hot"}],
  )

  print(response.json())
  ```

  ```javascript Node.js theme={null}
  const response = await fetch(
    "https://api.brightdata.com/datasets/v3/scrape?dataset_id=gd_lvz8ah06191smkebj4&format=json&type=discover_new&discover_by=subreddit_url",
    {
      method: "POST",
      headers: {
        "Authorization": "Bearer YOUR_API_KEY",
        "Content-Type": "application/json",
      },
      body: JSON.stringify([
        { url: "https://www.reddit.com/r/learnpython/", sort_by: "hot" }
      ]),
    }
  );

  const data = await response.json();
  console.log(data);
  ```
</CodeGroup>

[Full Discover by subreddit URL schema](/api-reference/scrapers/social-media-apis/reddit-posts-discover-by-subreddit-url)

## Posts, Discover by keyword

Find Reddit posts matching a search term, filtered by date.

**Dataset ID:** `gd_lvz8ah06191smkebj4`

<CodeGroup>
  ```bash cURL theme={null}
  curl -X POST \
    "https://api.brightdata.com/datasets/v3/scrape?dataset_id=gd_lvz8ah06191smkebj4&format=json&type=discover_new&discover_by=keyword" \
    -H "Authorization: Bearer YOUR_API_KEY" \
    -H "Content-Type: application/json" \
    -d '[{"keyword": "machine learning", "date": "Past week", "num_of_posts": 20}]'
  ```

  ```python Python theme={null}
  import requests

  response = requests.post(
      "https://api.brightdata.com/datasets/v3/scrape",
      params={
          "dataset_id": "gd_lvz8ah06191smkebj4",
          "format": "json",
          "type": "discover_new",
          "discover_by": "keyword",
      },
      headers={
          "Authorization": "Bearer YOUR_API_KEY",
          "Content-Type": "application/json",
      },
      json=[{"keyword": "machine learning", "date": "Past week", "num_of_posts": 20}],
  )

  print(response.json())
  ```

  ```javascript Node.js theme={null}
  const response = await fetch(
    "https://api.brightdata.com/datasets/v3/scrape?dataset_id=gd_lvz8ah06191smkebj4&format=json&type=discover_new&discover_by=keyword",
    {
      method: "POST",
      headers: {
        "Authorization": "Bearer YOUR_API_KEY",
        "Content-Type": "application/json",
      },
      body: JSON.stringify([
        { keyword: "machine learning", date: "Past week", num_of_posts: 20 }
      ]),
    }
  );

  const data = await response.json();
  console.log(data);
  ```
</CodeGroup>

[Full Discover by keyword schema](/api-reference/scrapers/social-media-apis/reddit-posts-discover-by-keyword)

## Comments, Collect by URL

Scrape all comments from a Reddit post or a specific comment thread, with optional filtering by age.

**Dataset ID:** `gd_lvzdpsdlw09j6t702`

<CodeGroup>
  ```bash cURL theme={null}
  curl -X POST \
    "https://api.brightdata.com/datasets/v3/scrape?dataset_id=gd_lvzdpsdlw09j6t702&format=json" \
    -H "Authorization: Bearer YOUR_API_KEY" \
    -H "Content-Type: application/json" \
    -d '[{"url": "https://www.reddit.com/r/learnpython/comments/1asdf12/", "days_back": 7}]'
  ```

  ```python Python theme={null}
  import requests

  response = requests.post(
      "https://api.brightdata.com/datasets/v3/scrape",
      params={"dataset_id": "gd_lvzdpsdlw09j6t702", "format": "json"},
      headers={
          "Authorization": "Bearer YOUR_API_KEY",
          "Content-Type": "application/json",
      },
      json=[{"url": "https://www.reddit.com/r/learnpython/comments/1asdf12/", "days_back": 7}],
  )

  print(response.json())
  ```

  ```javascript Node.js theme={null}
  const response = await fetch(
    "https://api.brightdata.com/datasets/v3/scrape?dataset_id=gd_lvzdpsdlw09j6t702&format=json",
    {
      method: "POST",
      headers: {
        "Authorization": "Bearer YOUR_API_KEY",
        "Content-Type": "application/json",
      },
      body: JSON.stringify([
        { url: "https://www.reddit.com/r/learnpython/comments/1asdf12/", days_back: 7 }
      ]),
    }
  );

  const data = await response.json();
  console.log(data);
  ```
</CodeGroup>

<Accordion title="Example response">
  ```json theme={null}
  [
    {
      "comment_id": "kabc1de",
      "user_posted": "example_commenter",
      "comment": "Start with the official Python tutorial, it's free and covers all the basics.",
      "date_posted": "2025-03-14T19:02:11Z",
      "num_upvotes": 412,
      "num_replies": 8,
      "replies": [],
      "post_url": "https://www.reddit.com/r/learnpython/comments/1asdf12/",
      "post_id": "1asdf12",
      "post_type": "text",
      "community_name": "learnpython",
      "community_url": "https://www.reddit.com/r/learnpython",
      "is_moderator": false,
      "is_pinned": false,
      "is_locked": false
    }
  ]
  ```
</Accordion>

[Full Comments - Collect by URL schema](/api-reference/scrapers/social-media-apis/reddit-comments-collect-by-url)

## Next steps

<CardGroup>
  <Card title="Async batch requests" icon="layer-group" href="/datasets/scrapers/reddit/async-requests">
    Scrape thousands of posts or run keyword discovery jobs in a single async request.
  </Card>

  <Card title="API reference" icon="code" href="/api-reference/scrapers/social-media-apis/reddit-posts-collect-by-url">
    Full endpoint specs, parameters and response schemas.
  </Card>
</CardGroup>


# AI web scrapers documentation
Source: https://docs.brightdata.com/datasets/scrapers/scrapers-library/ai-scrapers

Use Bright Data AI scrapers across 5 platforms (ChatGPT, Perplexity, Gemini, Grok, Google AI Mode) to retrieve structured prompt responses with citations.

## Overview

Bright Data supports the following AI scrapers:

* [ChatGPT](https://brightdata.com/cp/scrapers/browse?domain=chatgpt.com)
* [Perplexity](https://brightdata.com/cp/scrapers/browse?domain=perplexity.ai)
* [Gemini](https://brightdata.com/cp/scrapers/browse?domain=gemini.google.com)
* [Grok](https://brightdata.com/cp/scrapers/browse?domain=grok.com) <Badge>Currently unavailable</Badge>
* [Google - AI Mode](https://brightdata.com/cp/scrapers/browse?domain=google.com)
* [Copilot](https://brightdata.com/cp/scrapers/browse?domain=copilot.microsoft.com)

Each scraper is designed to handle user prompts and return enriched responses, with varying levels of detail and supporting data.

<div>
  ## How AI Scraping Differs from Traditional SERP Scraping
</div>

AI bot scraping offers a smarter, more efficient alternative to traditional SERP (Search Engine Results Page) scraping. While SERP scraping involves extracting raw HTML from search engine result pages, often requiring complex parsing and frequent maintenance, AI bot scraping uses natural language models to understand the intent behind a query and return structured, context-rich answers.
Key advantages of AI bot scraping over SERP scraping:

* ✅ Understands query context and delivers direct answers
* ✅ Includes citations, sources, and enriched content (e.g., maps, product links)
* ✅ More resilient to UI changes and search engine updates
* ✅ Easier to integrate via official APIs
* ✅ Provides a better user experience with cleaner, more relevant results

In contrast, SERP scraping is limited to surface-level data, often lacks context, and may violate search engine terms of service. AI bot scraping is the modern, scalable solution for intelligent data extraction.

***

| Scraper                                               | Short Description                                                               | Includes                                                                                                                                                                                                                                                    |
| :---------------------------------------------------- | :------------------------------------------------------------------------------ | :---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **ChatGPT Scraper**                                   | Generates detailed, conversational answers using OpenAI's ChatGPT.              | <ul><li>Hyperlinks</li><li>Citations (when available)</li><li>Product recommendations</li><li>Embedded map data</li><li>[Available countries](https://github.com/brightdata/answer-engines-country-codes/blob/main/chatgpt_countries.csv)</li></ul>         |
| **Perplexity Scraper**                                | Provides concise, well-sourced answers via Perplexity AI, ideal for research.   | <ul><li>Hyperlinked citations for verification</li><li>[Available countries](https://github.com/brightdata/answer-engines-country-codes/blob/main/perplexity_countries.csv)</li></ul>                                                                       |
| **Copilot Scraper**                                   | Offers contextual answers with sources using Microsoft's Copilot                | <ul><li>Hyperlinked citations</li><li>Contextual explanations</li><li>[Available countries](https://github.com/brightdata/answer-engines-country-codes/blob/main/copilot_countries.csv)</li></ul>                                                           |
| **Gemini Scraper**                                    | Delivers informative responses with potential web searches via Google's Gemini. | <ul><li>Web-based citations and sources</li><li>Hyperlinked references (when available)</li><li>[Country targeting](https://github.com/brightdata/answer-engines-country-codes/blob/main/gemini_countries.csv) (European countries not available)</li></ul> |
| **Google AI Scraper**                                 | Collect Google AI mode search results by prompt                                 | <ul><li>[Available countries](https://github.com/brightdata/answer-engines-country-codes/blob/main/google_aimode_countries.csv)</li></ul>                                                                                                                   |
| **Grok Scraper** <Badge>Currently unavailable</Badge> | Collect Grok search results by prompt                                           | <ul><li>Hyperlinked citations</li><li>[Available countries](https://github.com/brightdata/answer-engines-country-codes/blob/main/grok_countries.csv)</li></ul>                                                                                              |

<Note>
  **Web search control varies by scraper.** ChatGPT and Grok support a `web_search` input that allows or disables live web search, and a `web_search_triggered` output that confirms whether a search actually ran. See [Query fan-out and web search control](/datasets/scrapers/concepts/query-fan-out) for full details, plus the availability matrix for Google AI Mode and other LLM Scrapers. Gemini does not currently expose a `web_search` control, the decision is made internally by Gemini and prompt phrasing may influence whether a web search is triggered.
</Note>


# Scrapers library API reference
Source: https://docs.brightdata.com/datasets/scrapers/scrapers-library/api-reference

Full API reference for Bright Data's Scrapers Library, including endpoints for triggering collections, retrieving snapshots, and managing jobs.



# Custom inputs
Source: https://docs.brightdata.com/datasets/scrapers/scrapers-library/custom-inputs

dca-custom-inputs POST /datasets/v3/scrape
Add custom fields to a Bright Data Web Scraper API input schema (1000+ pre-built scrapers); values you send are returned in each output record for tagging.

## Custom inputs

You can add custom fields to your input schema, and whatever you send in those fields will be **returned in the results** for each record/job. This is useful for:

* **Unified schema**: Keep the same output structure across different scrapers/datasets.
* **Index / reference fields**: Pass an `id`, `row_index`, or any internal key so you can easily match results back to the original input rows.


# Deadline feature
Source: https://docs.brightdata.com/datasets/scrapers/scrapers-library/deadline-feature

Limit how long a Bright Data Web Scraper API (1000+ scrapers) trigger request waits when a snapshot may take a long time to finish.

<Steps>
  <Step title="Prerequisites" icon="list-check">
    * Specific task: Add a time limit to a snapshot run so it doesn’t wait indefinitely.
    * Related setting: `deadline` (query parameter)
  </Step>

  <Step title="Set the deadline query parameter">
    Add deadline to your trigger request query string:

    * If you want to wait up to a fixed duration, set a duration like 3m, 15min, 2h.
    * If you want the request to wait until a specific moment, set an ISO timestamp like `2022-01-12T18:58:43.149Z`.

    > **Example:** `&deadline=3m`

    **Expected result:** the trigger request will wait up to the specified limit. If the run is not ready by then, it returns an error/timeout response instead of waiting longer.
  </Step>

  <Step title="Send a trigger request with a deadline">
    Use the same trigger call you normally use and append deadline.

    ```sh highlight={20} theme={null}
    curl \
      -H "Authorization: Bearer TOKEN" \
      -H "Content-Type: application/json" \
      -d '{
        "input": [
          { "url": "https://www.linkedin.com/in/elad-moshe-05a90413/" },
          { "url": "https://www.linkedin.com/in/jonathan-myrvik-3baa01109" },
          { "url": "https://www.linkedin.com/in/aviv-tal-75b81/" },
          { "url":"https://www.linkedin.com/in/bulentakar/" }
        ] 
      }' \
      "https://api.brightdata.com/datasets/v3/trigger" \
      "?dataset_id=gd_l1viktl72bvl7bjuj0" \
      "&endpoint=https%3A%2F%2Fwebhook.site%2Fc6aee479-3dae-44bb-9b44-09a7cd823efe" \
      "&notify=false" \
      "&format=json" \
      "&uncompressed_webhook=true" \
      "&force_deliver=false" \
      "&include_errors=true" \
      "&deadline=3m"
    ```

    `deadline` must be:

    * ISO format (`2022-01-12T18:58:43.149Z`)
    * Duration format (`1s`, `15min`, `2h`, `3d`).

    **Expected result:**

    * If the run completes within 3m, you’ll receive results (or your webhook receives the output payload).
    * If the run does not complete within 3m, the trigger call times out/returns an error response.
  </Step>

  <Step title="Check your webhook payload for success or errors">
    If you configured a webhook endpoint, verify the payload:

    <CodeGroup>
      ```json ✅ Success theme={null}
      [
        {
          "url": "https://www.amazon.com/Solar-Eclipse-Glasses-Certified-Viewing/dp/B08GB3QC1H",
          "product_name": "Soluna Solar Eclipse Glasses AAS Approved 2024 - Made in the USA CE and ISO Certified Safe Shades for Direct Sun Viewing (2 Pack)",
          "product_rating": 4.6,
          "review_id": "R3LKES0U7C9BGB",
          "badge": "Verified Purchase"
        }
      ]
      ```

      ```json ❌ Error (deadline reached) theme={null}
      [
        {
          "timestamp": "2026-02-23T08:54:26.645Z",
          "input": {
            "url": "https://www.amazon.com/Solar-Eclipse-Glasses-Certified-Viewing/dp/B08GB3QC1H",
            "reviews_to_not_include": []
          },
          "error": "Crawl aborted on job cancel",
          "error_code": "aborted_page"
        }
      ]
      ```
    </CodeGroup>
  </Step>
</Steps>


# Delivery options
Source: https://docs.brightdata.com/datasets/scrapers/scrapers-library/delivery-options

Configure Bright Data Web Scraper API delivery: API download, S3, Azure Blob, GCS, SFTP and webhook endpoints with JSON, NDJSON and CSV output formats.

To set your delivery preferences for the dataset, simply click on the 'Delivery settings' tab:

* Choose file format :
  * JSON
  * NDJSON
  * CSV
  * JSON lines
* Choose how to receive the data :
* Amazon S3 ([AWS S3 User Role Permissions](/datasets/scrapers/scrapers-library/delivery-options#aws-s3-user-role-permissions))
* Google Cloud Storage ([How to find your google cloud Private Key](/datasets/scrapers/scrapers-library/delivery-options#how-to-find-your-google-cloud-private-key))
* Google Cloud PubSub
* Microsoft Azure Storage
* SFTP/FTP
* Snowflake ([Snowflake Delivery Configuration Guide](/datasets/scrapers/scrapers-library/delivery-options#snowflake-delivery-configuration-guide))

  **Streamed Delivery Feature (Stream results)** - In cases of large snapshots, you have the option to get immediate results in minimum batches of 10. A delivery method is required (storage or webhook- not compatible with API download). To trigger in WSAPI, add `&stream_max_lines=10 /`turn ON the toogle bar.

  * 10 is the minimum value
  * 100k is the maximum value

    <img alt="Screenshot 2025 12 23 120416" title="Screenshot 2025 12 23 120416" />

**File Delivery:** You can add `&download_fields=` to your WSA request to retrieve files along with the extracted data.

Available options:

* `html`
* `warc` (not always available)
* `screenshot` (not always available)

Note: This works only when the delivery method is set to **Storage** and **Webhook**.

<Frame>
  ![Download fields setting for selecting html, warc, and screenshot file delivery](https://brightdata.zendesk.com/hc/article_attachments/22455157046161)
</Frame>

## AWS S3 User Role Permissions

<Frame>
  <img alt="delivery-strategy.png" />
</Frame>

To control access to S3 resources, you can use IAM (Identity and Access Management) to create and manage AWS users and their permissions. One way to do this is by creating IAM roles and attaching them to S3 resources.

<Steps>
  <Step title="Create a Policy">
    Go to the "Policies" section in the IAM console

    <Frame>
      <img alt="policies.png" />
    </Frame>

    Create a new policy that defines the permissions for the S3 resources you want to grant access to.

    Example of AWS policy:

    ```json theme={null}
    {
    "Version": "2012-10-17",
    "Statement": [
        {
        "Effect": "Allow",
        "Action": [
            "s3:PutObject",
            "s3:GetObject"
        ],
        "Resource": "arn:aws:s3:::NAME-OF-YOUR-BUCKET/*"
        }
    ]
    }
    ```
  </Step>

  <Step title="Create a Role">
    Go to the "Roles" section in the IAM console

    <Frame>
      <img alt="roles.png" />
    </Frame>

    Create a new role and specify the policy created in step 1 in the "Permission policies" section.

    Make a note of the ARN of the role, which will be used for delivery credentials. (The ARN will look like `arn:aws:iam::<ROLE_ID>:role/<ROLE_NAME>`)

    Example of User Role:

    ```json theme={null}
    {
    "Version": "2012-10-17",
    "Statement": [
        {
        "Effect": "Allow",
        "Principal": {
            "AWS": "arn:aws:iam::422310177405:role/brd.ec2.zs-dca-delivery"
        },
        "Action": "sts:AssumeRole",
        "Condition": {
            "StringEquals": {
            "sts:ExternalId": "YOUR EXTERNAL ID"
            }
        }
        }
    ]
    }
    ```
  </Step>

  <Step title="Use the ARN of the role">
    In the S3 resources that you want to grant access to, attach the role created in step 2 by using the ARN.
  </Step>
</Steps>

## How to find your Google Cloud Private Key

1. Go to the Google Cloud Platform Console home page - [https://console.cloud.google.com/](https://console.cloud.google.com/)
2. Expand the menu by Google Cloud Platform, and click IAM & Admin.
3. Click **Service accounts**.

<Frame>
  <img alt="service-accounts.png" />
</Frame>

4. Choose an existing service account from the list or create one.

<Frame>
  <img alt="create-service-account.png" />
</Frame>

If the button is not visible, create a project first in order to **Create Service Account**.

<Frame>
  <img alt="create-project.png" />
</Frame>

5. Create the service account by entering the name, ID, and description at the **Create Service Account** process. Then grant the access and create the account.

<Frame>
  <img alt="service-account-details.png" />
</Frame>

6. Click on Email of the service account.

<Frame>
  <img alt="email.png" />
</Frame>

7. To access the keys, click on the 'KEYS' tab. Click the "Add Key" dropdown and then select 'Create New Key'.

<Frame>
  <img alt="create-new-key.png" />
</Frame>

8. Choose JSON as the key type.

<Frame>
  <img alt="type-json.png" />
</Frame>

9. The service account key JSON file is automatically downloaded to your local machine.
10. Copy `private_key` from the downloaded JSON file & Paste it to Data Collector delivery settings.

<Frame>
  <img alt="private-key.png" />
</Frame>

## Snowflake Delivery Configuration Guide

<Note>
  Snowflake configuration is available for 'Datasets' delivery and not available for data collectors (Web Scraper)
</Note>

**Getting Started**

In order to allow efficient delivery of Datasets to your Snowflake environment, we provide a step-by-step guide to set it up. Just follow these steps:

<Steps>
  <Step title="Select or Create a Database">
    Firstly, decide if you will use an existing database or create a new one. If you opt for a new database, here's the command you need:

    ```sh theme={null}
    CREATE DATABASE <database>;
    ```

    Remember to replace `<database>` with the name you want for your database.
  </Step>

  <Step title="Select or Create a Schema">
    Decide if you will use an existing schema or create a new one. By default every database has a PUBLIC schema. If you wish to use a different schema, here's the command you need:

    ```sh theme={null}
    CREATE SCHEMA <schema>;
    ```

    Replace `<schema>` with your own schema name.
  </Step>

  <Step title="Select or Create a Warehouse">
    Choose an existing warehouse or create a new one. When creating a new warehouse, consider Snowflake's recommendations for configuring a warehouse specifically for data loading. Use the following command to create a warehouse:

    ```sh theme={null}
    CREATE WAREHOUSE <warehouse>;
    ```

    Replace `<warehouse>` with your desired warehouse name.
  </Step>

  <Step title="Select or Create an Internal Named Stage">
    Next, choose an existing internal named stage or create a new one. To create a new stage, use this command:

    ```sh theme={null}
    CREATE STAGE <stage>;
    ```

    Don't forget to replace `<stage>` with your preferred stage name.
  </Step>

  <Step title="Create a Role">
    You'll need a role that can write to your chosen stage. To create one, use:

    ```sh theme={null}
    CREATE ROLE <role_name>;
    ```

    Change `<role_name>` to your chosen role name.
  </Step>

  <Step title="Grant Warehouse Rights to the Role">
    Now, grant your new role the necessary rights to operate on your chosen warehouse using:

    ```sh theme={null}
    GRANT OPERATE ON WAREHOUSE <warehouse> TO ROLE <role_name>;
    ```

    Remember to replace `<warehouse>` and `<role_name>` with your specific warehouse and role name respectively.
  </Step>

  <Step title="Enable Write Operations on the Stage for the Role">
    To enable your role to write on the stage, use the command:

    ```sh theme={null}
    GRANT WRITE ON STAGE <stage> TO ROLE <role_name>;
    ```

    Again, replace `<stage>` and `<role_name>` with your chosen stage and role names.
  </Step>

  <Step title="Create a BrightData User">
    Next, create a new user for BrightData that will be used to upload data directly into Snowflake. The command is as follows:

    ```sh theme={null}
    create user <user_name>
    PASSWORD = '<password>'
    LOGIN_NAME = <login>
    MUST_CHANGE_PASSWORD = FALSE
    DISABLED = FALSE  
    COMMENT = 'user for BrightData to upload data directly into Snowflake'
    ```

    Replace `<user_name>`, `<password>`, and `<login>` with your chosen username, password, and login name.
  </Step>

  <Step title="Grant Role Privileges to the New User">
    Finally, grant your new user the privileges of the role you created:

    ```sh theme={null}
    GRANT ROLE <role_name> TO USER <user_name>;
    ```

    Replace `<role_name>` and `<user_name>` with your role and user names.
  </Step>

  <Step title="Allowlist IPs">
    If you have an active [Network Policy](https://docs.snowflake.com/en/user-guide/network-policies) applied in your Snowflake account you need to whiltelist following IPs:

    ```sh theme={null}
    ALTER NETWORK POLICY <policy_name>  
    SET ALLOWED_IP_LIST=(  
    <existing_allowlisted_ips>,  
    '35.169.71.210',  
    '34.233.211.38',  
    '44.194.183.74',  
    '54.243.177.151');
    ```

    Replace `<policy_name>` with your network policy name. Replace `<existing_whiltelisted_ips>` with the list of existing allowlisted IPs.

    And that's it! You have now configured your Snowflake environment to receive data from Bright Data.

    ## webhook whitelist IPs

    All of the IP addresses listed below are legitimate Bright Data webhook sources used across our infrastructure (Scrapers, AI scrapers, SERP API, etc.).

    This applies to all asynchronous webhook deliveries from Bright Data services.

    To ensure you receive all webhook notifications without issues, please allowlist (whitelist) the following IPs:

    ```text theme={null}
    54.175.27.69
    34.225.9.175
    100.28.38.247
    100.29.18.195
    52.72.185.255
    35.174.112.248
    54.165.183.124
    3.91.140.7
    52.202.75.37
    98.82.225.117
    100.27.150.189
    18.214.10.85
    35.169.71.210
    44.194.183.74
    ```

    <Note>
      If you have any issues or need further assistance, please contact our support team.

      If you want to learn more about Data Loading Performance and Warehouse Size Considerations [click here](https://docs.snowflake.com/en/user-guide/warehouses-overview#impact-on-data-loading).
    </Note>
  </Step>
</Steps>


# Error codes by endpoint
Source: https://docs.brightdata.com/datasets/scrapers/scrapers-library/error-list-by-endpoint

Reference of Bright Data Web Scraper API error codes grouped by endpoint with cause and fix for 4xx and 5xx responses across trigger, snapshot and delivery.

## Trigger a collection

`POST` `/datasets/v3/trigger`

`Error codes related to the "Trigger a collection" endpoint`

| http\_status\_code | message                                                                                                                                                                                        |
| :----------------: | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
|         400        | `{validation_errors: [ERRORS]}`                                                                                                                                                                |
|                    | `dataset missing`                                                                                                                                                                              |
|                    | Invalid attachments                                                                                                                                                                            |
|                    | This dataset is not allowed for API                                                                                                                                                            |
|                    | This dataset is not ready yet                                                                                                                                                                  |
|                    | No data to trigger                                                                                                                                                                             |
|                    | Should be at least `LIMIT` inputs                                                                                                                                                              |
|         404        | `dataset does not exist`                                                                                                                                                                       |
|         429        | You have too many running jobs for this dataset. Please wait until some of them finish or consider combining multiple inputs into a single   request. Running jobs: `RUNNING_JOBS>=JOBS_LIMIT` |
|         500        | Internal server error                                                                                                                                                                          |

## Download snapshot

`GET` `/datasets/v3/snapshot/:snapshot_id`

`Error codes related to the "Download snapshot" endpoint`

| http\_status\_code | message                                                                        |
| :----------------: | ------------------------------------------------------------------------------ |
|         202        | `{status: "STATUS", message: "Snapshot is not   ready yet, try again in 10s"}` |
|                    | `{status: "building", message: "Snapshot is   building, try again in 10s"}`    |
|         400        | `{validation_errors: [ERRORS]}`                                                |
|                    | Snapshot is expired                                                            |
|                    | Snapshot is empty                                                              |
|         404        | Snapshot does not exist                                                        |
|         500        | Internal server error                                                          |

## Calculate the number of parts for delivery

`GET` `/datasets/v3/snapshot/:snapshot_id/parts`

`Error codes related to the "Calculate the number of parts for delivery" endpoint`

| http\_status\_code | message                         |
| :----------------: | ------------------------------- |
|         400        | `{validation_errors: [ERRORS]}` |
|                    | Snapshot is not ready           |
|         404        | Snapshot does not exist         |
|         500        | Internal server error           |

## Fetch the input file from a triggered snapshot

`GET` `/datasets/v3/snapshot/:snapshot_id/input`

`Error codes related to the "Fetch the input file from a triggered snapshot" endpoint`

| http\_status\_code | message                       |
| :----------------: | ----------------------------- |
|         400        | Snapshot input does not exist |
|         404        | Snapshot does not exist       |
|         500        | Internal server error         |

## Cancel a collection

`POST` `/datasets/v3/snapshot/:snapshot_id/cancel`

`Error codes related to the "Cancel a collection" endpoint`

| http\_status\_code | message                 |
| :----------------: | ----------------------- |
|         400        | Snapshot is not running |
|         404        | Snapshot does not exist |
|         500        | Internal server error   |

## Monitor progress

`GET` `/datasets/v3/progress/:snapshot_id`

`Error codes related to the "Monitor progress" endpoint`

| http\_status\_code | message                                                     |
| :----------------: | ----------------------------------------------------------- |
|         404        | Snapshot does not exist                                     |
|         500        | Internal server error                                       |
|         200        | \{status: "failed", error\_message: "ERROR\_MESSAGE"}       |
|                    | Something went wrong. Bright Data is looking into it.       |
|                    | Account is suspended                                        |
|                    | Account is new, please activate it in account settings. URL |
|                    | No data found in discovery                                  |
|                    | Snapshot is empty                                           |
|                    | Failed to deliver snapshot                                  |
|                    | Failed to download response                                 |
|                    | Failed to trigger collector                                 |
|                    | Internal Server Error                                       |
|                    | Input validation failed: DETAILS                            |

## Monitor delivery

`GET` `/datasets/v3/delivery/:delivery_id`

`Error codes related to the "Monitor delivery" endpoint`

| http\_status\_code | message                 |
| :----------------: | ----------------------- |
|         404        | Delivery does not exist |
|         500        | Internal server error   |

## Deliver collected data to storage

`POST` `/datasets/v3/deliver/:snapshot_id`

`Error codes related to the "Deliver collected data to storage" endpoint`

| http\_status\_code | message                                        |
| :----------------: | ---------------------------------------------- |
|         400        | `{validation_errors: [ERRORS]}`                |
|                    | Snapshot is not ready                          |
|                    | Snapshot is expired                            |
|                    | Deliver options are missing                    |
|                    | Snapshot is empty                              |
|                    | Snapshot is too big for single file delivery   |
|                    | Batch size should be at least `MIN_BATCH_SIZE` |
|         404        | Snapshot does not exist                        |
|         500        | Failed to deliver snapshot                     |
|                    | Internal server error                          |

## Get snapshot list

`GET` `/datasets/v3/snapshots`

`Error codes related to the "Get snapshot list" endpoint`

| http\_status\_code | message                         |
| :----------------: | ------------------------------- |
|         400        | `{validation_errors: [ERRORS]}` |
|         500        | Internal server error           |

## How to handle 429 errors (and avoid IP blacklisting)

This guide shows you how to handle HTTP 429 (Too Many Requests) from Bright Data Datasets API and avoid automatic IP blacklisting.

### What Bright Data does (from our side)

* If your IP gets 25+ 429 responses within 5 minutes, it is **automatically blacklisted**.
* After blacklisting, **all API requests from that IP are blocked**.

### Why you get 429

You’ll receive `429 Too Many Requests` when you exceed the concurrent request limits:

* `≤ 20` inputs per request: up to 1500 concurrent requests
* `> 20` inputs per request: up to 100 concurrent requests

### What you should do (customer side)

1. Stop sending new requests immediately when you receive a 429 (don’t ignore it).
2. Wait before retrying:
   * If `Retry-After` header exists, wait that many seconds
   * Otherwise use exponential backoff: 2s, 4s, 8s, 16s, 32s
3. Reduce concurrency if you keep seeing 429s (you’re over the limit).

<Warning>
  If you see 10+ 429s within 5 minutes, reduce your request rate right away to avoid hitting the 25/5min blacklist threshold.
</Warning>

### Examples

<CodeGroup>
  ```python ❌ Bad (will get your IP blacklisted) theme={null}
  response = requests.post(api_url, json=data)

  if response.status_code == 429:
      requests.post(api_url, json=data)  # WRONG: immediate retry
  ```

  ```python ✅ Good (Retry-After + backoff) theme={null}
  import time
  import requests

  resp = requests.post(api_url, json=data)

  if resp.status_code == 429:
      retry_after = resp.headers.get("Retry-After")
      wait_s = int(retry_after) if retry_after else 2
      time.sleep(wait_s)
      # retry after waiting (and increase wait if 429 repeats)
  ```
</CodeGroup>

<Note>
  If you are already blacklisted [contact Bright Data Support](mailto:support@brightdata.com) and include the blocked IP address(es) to request whitelisting.
</Note>


# Scrapers FAQs
Source: https://docs.brightdata.com/datasets/scrapers/scrapers-library/faqs

FAQs about Bright Data Scrapers (1000+ pre-built scrapers) covering setup, authentication, data formats, pricing and large-scale data extraction.

<AccordionGroup>
  <Accordion title="What is the Scrapers?">
    The Scrapers allows users to extract fresh data on demand from websites using pre-built scrapers. It can be used to automate data collection and integrate with other systems.
  </Accordion>

  <Accordion title="Who can benefit from using the Scrapers?">
    Data analysts, scientists, engineers, and developers or individuals seeking efficient methods to collect and analyze web data for AI, ML, big data applications, and more with no scraping development efforts will find Scraper APIs particularly beneficial.
  </Accordion>

  <Accordion title="How do I get started with the Scrapers?">
    Getting started with Scraper APIs is straightforward, once you open your Bright Data account, you will need to [generate an API key](/api-reference/authentication#how-do-i-authenticate-with-api-key%3F) from your account settings. Once you have your key, you can refer to our [API documentation](/datasets/scrapers/scrapers-library/overview) for detailed instructions on making your first API call.

    <iframe title="Watch a demo video" />
  </Accordion>

  <Accordion title="What is the difference between the scrapers?">
    Each scraper can require different inputs. There are 2 main types of scrapers:

    1. **PDP** \
       These scrapers require URLs as inputs. A PDP scraper extracts detailed product information like specifications, pricing, and features from web pages
    2. **Discovery/ Discovery+PDP** \
       Discovery scrapers allow you to explore and find new entities/products through search, categories, Keywords and more.

    <Frame>
      <img alt="delivery-pdp.png" />
    </Frame>
  </Accordion>

  <Accordion title="Why are there different discovery APIs for the same domain?">
    Each discovery API allow you to find the desired data using a different method, it can by keyword, category URL or even location
  </Accordion>

  <Accordion title="How do I authenticate with the Scrapers?">
    Authentication is done using an API key. Include the API key in the `Authorization` header of your requests as follows: `Authorization: Bearer YOUR_API_KEY`.
  </Accordion>

  <Accordion title="How do I customize my request and trigger it?">
    Once picking the API you want to run, you can customize your request using our [detailed API parameters documentation](/api-reference/rest-api/scraper/asynchronous-requests), specifying the different types and expected inputs and responses.
  </Accordion>

  <Accordion title="Do you offer a free trial?">
    You’ll get a \$2 credit to explore and test our services.
  </Accordion>

  <Accordion title="How do I test the API?">
    You can quickly test the product by customizing the code on the control panel ([Demo video](https://app.arcade.software/flows/BPGoTdRmf89Ip1EQuIOW/view))

    <Steps>
      <Step title="Pick your desired API from the variety of APIs" />

      <Step title="Enter your inputs">
        <Frame>
          <img alt="trigger-a-collection.png" />
        </Frame>
      </Step>

      <Step title="Enter your API key">
        <Frame>
          <img alt="enter-api-token.png" />
        </Frame>
      </Step>

      <Step title="Select your preferred delivery method">
        <Frame>
          <img alt="delivery-method.png" />
        </Frame>

        Using a webhook - update the webhook URL and copy paste the “trigger data collection” code using and run the code on your client.

        Using an API - fill out the needed credentials and information based on the specific setting you chose (`S3`, `GCP`, `pubsub` and more) and copy the code and run the code after collection ends
      </Step>

      <Step title="Copy the code and run it on your client">
        <img alt="code.png" />

        All of the above can also be done by free tools such as [Webhook-site](https://webhook.site/) and [Postman](https://web.postman.co/)

        We also offer additional management APIs to acquire information about the collection status and fetch a list of all the snapshots under **Management APIs** tab
      </Step>
    </Steps>
  </Accordion>

  <Accordion title="What data formats does the Scrapers support?">
    The Scrapers supports data extraction in various formats including `JSON`, `NDJSON`, `JSONL` and `CSV`. Specify your desired format in the request parameters.
  </Accordion>

  <Accordion title="What are the rates for the Scrapers?">
    We charge based on the number of records we delivered, you only pay for what you get, do note that unsuccessful attempts resulting from incorrect inputs by the user will still be billed. Since the failure to retrieve data was due to user input rather than Bright Data’s performance, resources were still consumed in processing the request. The rate per record depends on your subscription plan (starting from 0.7\$ per 1000 records). Check our [pricing plans](https://brightdata.com/pricing/web-scraper) or your account details for specific rates.
  </Accordion>

  <Accordion title="What should I do if my API key expires?">
    For account admins: If your API key expires, you need to create a new one in your account settings.

    <Frame>
      <img alt="no-api-token.png" />
    </Frame>

    For account users: If your API key expires, please contact your account admin to issue a new API key.

    <Frame>
      <img alt="no-api-token-user.png" />
    </Frame>
  </Accordion>

  <Accordion title="How does Scraper APIs manage large-scale data extraction tasks?">
    Featuring capabilities for high concurrency and batch processing, Scraper APIs excel in large-scale data extraction scenarios. This ensures developers can scale their scraping operations efficiently, accommodating massive volumes of requests with high throughput.
  </Accordion>

  <Accordion title="How can I upgrade my subscription plan?">
    To upgrade your subscription plan, visit the billing section on your dashboard account and select the desired plan. For further assistance, contact our support team.
  </Accordion>

  <Accordion title="What specific use cases are Scraper APIs optimized for?">
    The Scraperss support a vast range of Use cases including competitive benchmarking, market trend analysis, dynamic pricing algorithms, sentiment extraction, and feeding data into machine learning pipelines. Essential for e-commerce, fintech, and social media analytics, these APIs empower developers to implement data-driven strategies effectively.
  </Accordion>

  <Accordion title="How fast is the Scrapers?">
    We offer real-time support for scrapers using URLs as inputs, with up to 20 URL inputs, and batch support for more than 20 inputs, regardless of the scraper type.

    The Scrapers delivers real-time data for up to 20 inputs per call, with response times varying by domain, ensuring fresh data without relying on cached information.

    Scrapers that discover new records (e.g., "Discover by keyword," "Discover by hashtag") generally take longer and use batch support, as the actual response times can be influenced by several factors, including the target URL’s load time and the execution duration of user-defined Page Interactions. An indication of the average response time for each scraper can be found on the specific Scraper page.
  </Accordion>

  <Accordion title=" How do I cancel an API call?">
    You can cancel a run using the following endpoint:

    ```sh theme={null}
    curl -H "Authorization: API key" -H "Content-Type: application/json" -k "https://api.brightdata.com/datasets/v3/snapshot/SNAPSHOT_ID/cancel" -X POST
    ```

    Make sure the snapshot id is the one you want to cancel.

    Note: If you cancel the run no data will be delivered to you and a snapshot can't be canceled after it finished collecting
  </Accordion>

  <Accordion title=" What is the difference between a notify URL and a webhook URL configurations? ">
    The key difference between a notify URL and a webhook URL in API configurations lies in their purpose and usage:

    Notify URL:

    Typically used for asynchronous communication. The system sends a notification to the specified URL when a task is completed or when an event occurs. The notification is often lightweight and doesn't include detailed data but may provide a reference or status for further action (e.g., "Job completed, check logs for details").

    Webhook URL:

    Also used for asynchronous communication but is more data-centric. The system pushes detailed, real-time data payloads to the specified URL when a specific event occurs. Webhooks provide direct, actionable information without requiring the client to poll the system.

    Example Use Case:

    A notify URL might be used to inform you that a scraping job is finished. A webhook URL could send the actual scraped data or detailed metadata about the completion directly to you.
  </Accordion>

  <Accordion title=" For how long a snapshot is available after i triggered a collection?">
    The snapshot is available for 30 days, you can retrieve the snapshot during this time period via [delivery API](/api-reference/scrapers/delivery-apis/download-snapshot) options and the snapshot ID
  </Accordion>

  <Accordion title="Are there any limitations for specific scrapers or domains?">
    There are certain limitations on these platforms:

    <AccordionGroup>
      <Accordion title="Facebook" icon="facebook">
        |                        |   |
        | ---------------------- | - |
        | Posts (by profile URL) |   |
        | Comments               |   |
        | Reels                  |   |
      </Accordion>

      <Accordion title="Instagram" icon="instagram">
        |                        |   |
        | ---------------------- | - |
        | Posts (by keyword)     |   |
        | Posts (by profile URL) |   |
        | Comments               |   |
        | Reels                  |   |

        <Warning>
          Media Links expiring after 24 hours.
        </Warning>
      </Accordion>

      <Accordion title="Pinterest" icon="pinterest">
        |                        |   |
        | ---------------------- | - |
        | Profiles               |   |
        | Posts (by keyword)     |   |
        | Posts (by profile URL) |   |
      </Accordion>

      <Accordion title="Reddit" icon="reddit">
        |                    |   |
        | ------------------ | - |
        | Posts (by keyword) |   |
        | Comments           |   |
      </Accordion>

      <Accordion title="TikTok" icon="tiktok">
        |                          |   |
        | ------------------------ | - |
        | Profiles (by search URL) |   |
        | Comments                 |   |
        | Posts (by keyword)       |   |
        | Posts (by profile URL)   |   |
      </Accordion>

      <Accordion title="Quora" icon="quora">
        |       |   |
        | ----- | - |
        | Posts |   |
      </Accordion>

      <Accordion title="Vimeo" icon="vimeo">
        |                   |   |
        | ----------------- | - |
        | Posts(by keyword) |   |
        | Posts(by URL)     |   |
      </Accordion>

      <Accordion title="X (Twitter)" icon="twitter">
        |       |   |
        | ----- | - |
        | Posts |   |
      </Accordion>

      <Accordion title="YouTube" icon="YouTube">
        |                           |   |
        | ------------------------- | - |
        | Profiles                  |   |
        | Posts (by keyword)        |   |
        | Posts (by URL)            |   |
        | Posts (by search filters) |   |
      </Accordion>

      <Accordion title="TikTok" icon="TikTok">
        Media only accessible with a generated token in the same session.
      </Accordion>

      <Accordion title="Linkedin" icon="Linkedin">
        Posts are limited to amount that is shown publicly on profile (e.g. **10**)
      </Accordion>
    </AccordionGroup>
  </Accordion>

  <Accordion title="What does it mean when a snapshot is marked as empty?">
    When a snapshot is marked as empty, it means there are no valid or usable records in the snapshot. However, this does not imply the snapshot is completely devoid of content. In most cases, it contains information such as errors or dead pages:

    * **Errors**: Issues encountered during the data collection process, such as invalid inputs, system errors, or access restrictions.
    * **Dead Pages**: Pages that could not be accessed for reasons like 404 errors (page not found), removed content (e.g., unavailable products), or restricted access.

    To view these details, you can use the parameter `include_errors=true` in your request, which will display the errors and information about the dead pages in the snapshot. This helps you diagnose and understand the issues within the snapshot.
  </Accordion>

  <Accordion title="How to stop a web scraper task?">
    You can stop a running collection by utilizing the following API call: [https://docs.brightdata.com/api-reference/scrapers/management-apis/cancel-snapshot](https://docs.brightdata.com/api-reference/scrapers/management-apis/cancel-snapshot)
  </Accordion>

  <Accordion title="Which domains do you provide scrapers for?">
    ae.com

    airbnb.com

    amazon.com

    apps.apple.com

    ashleyfurniture.com

    asos.com

    balenciaga.com

    bbc.com

    berluti.com

    bestbuy.com

    booking.com

    bottegaveneta.com

    bsky.app

    carsales.com.au

    carters.com

    celine.com

    chanel.com

    chileautos.cl

    crateandbarrel.com

    creativecommons.org

    crunchbase.com

    delvaux.com

    digikey.com

    dior.com

    ebay.com

    edition.cnn.com

    en.wikipedia.org

    enricheddata.com

    espn.com

    etsy.com

    example.com

    facebook.com

    fanatics.com

    fendi.com

    finance.yahoo.com

    g2.com

    github.com

    glassdoor.com

    global.llbean.com

    goodreads.com

    google.com

    hermes.com

    homedepot.ca

    homedepot.com

    ikea.com

    imdb.com

    indeed.com

    infocasas.com.uy

    inmuebles24.com

    instagram.com

    la-z-boy.com

    lazada.com.my

    lazada.sg

    lazada.vn

    lego.com

    linkedin.com

    loewe.com

    lowes.com

    manta.com

    martindale.com

    massimodutti.com

    mattressfirm.com

    mediamarkt.de

    metrocuadrado.com

    montblanc.com

    mouser.com

    moynat.com

    mybobs.com

    myntra.com

    news.google.com

    nordstrom.com

    olx.com

    otodom.pl

    owler.com

    ozon.ru

    pinterest.com

    pitchbook.com

    play.google.com

    prada.com

    properati.com.co

    raymourflanigan.com

    realestate.com.au

    reddit.com

    revenuebase.ai

    sephora.fr

    shop.mango.com

    shopee.co.id

    sleepnumber.com

    slintel.com

    target.com

    tiktok.com

    toctoc.com

    tokopedia.com

    toysrus.com

    trustpilot.com

    trustradius.com

    unashamedcataddicts.quora.com

    us.shein.com

    ventureradar.com

    vimeo.com

    walmart.com

    wayfair.com

    webmotors.com.br

    wildberries.ru

    worldpopulationreview\.com

    worldpostalcode.com

    www2.hm.com

    x.com

    xing.com

    yapo.cl

    yelp.com

    youtube.com

    ysl.com

    zalando.de

    zara.com

    zarahome.com

    zillow\.com

    zonaprop.com.ar

    zoominfo.com

    zoopla.co.uk

    If your target domain is not on this list, we can develop a custom scraper specifically for you
  </Accordion>

  <Accordion title="How can I use Bright Data to access hotel data through an API?">
    We don’t provide dedicated scrapers specifically for hotels, but we do offer a Booking.com scraper and the option to create a custom scraper tailored to your specific requirements.
  </Accordion>

  <Accordion title="How do I get the data I need?">
    Here’s a quick guide to help you get started and choose the right solution for your needs:

    * Option 1: Enriched, Pre-Collected Data – Explore Our Datasets Marketplace

    If you’re looking for ready-to-use, high-quality data, our Datasets Marketplace is the perfect place to start. We’ve already done the heavy lifting by collecting and enriching vast amounts of data from a variety of sources. These datasets are designed to save you time and effort, so you can focus on analyzing the data and making smarter decisions.

    Simply browse our marketplace, find the dataset that fits your needs, and start using it right away.

    Option 2: Web Scrapers for Fresh and Real-Time Data

    If your project requires fresh data or highly specific information that isn’t available in our Datasets Marketplace, we offer powerful tools to help you collect fresh and real-time data directly from the web. Here’s how you can get started:

    **Pre-Built Web Scrapers** We offer a wide range of [pre-built web scrapers for popular websites](/datasets/scrapers/scrapers-library/overview), allowing you to collect data quickly and efficiently. These scrapers are ready to use and require minimal setup, making them a great choice for users who want to hit the ground running.

    Managed Services

    Can’t find your target website in our list of pre-built scrapers? No problem\\! We can create a [Managed Services tailored specifically to your needs](/datasets/scrapers/managed-services). The Bright Data team of experts will work with you to design a solution that collects the exact data you’re looking for.

    Build Your Own Scraper

    For users with JavaScript knowledge or access to developer resources, we also offer the option to build your own scraper using our [Integrated Development Environment (IDE)](/datasets/scraper-studio/introduction). This gives you full control and flexibility to create a scraper that meets your unique requirements.

    Have questions or need assistance? The Bright Data team of experts is always here to help. Let’s get started\\!
  </Accordion>

  <Accordion title="How do I scrape data from google maps?">
    1. Find the "Google Maps reviews" scraper on the dashboard and choose if you want to run it as an API request or initiate it using the "No code" option from the control panel
    2. Enter the input parameters (The place page URL and, Number of days to retrieve reviews from)
    3. Configure the needed request parameters if using an API
    4. Initiate the run and collect the data
  </Accordion>

  <Accordion title="How do I cancel a running snapshot?">
    To cancel a running snapshot, use one of the following methods:

    1. **API Request:**
       * Send a `POST` request to the endpoint:

         POST /datasets/v3/snapshot/cencel ([playgrownd](/api-reference/scrapers/management-apis/cancel-snapshot))
       * Replace `{snapshot_id}` with the ID of the snapshot you want to cancel.
    2. **Control Panel:**
       * Go to the **Logs** tab of the scraper.
       * Locate the running snapshot.
       * Hover over the specific run and click the **"X"** to cancel it.

    Both methods will stop the snapshot process if it is currently running.
  </Accordion>

  <Accordion title="Does the chatGPT scraper works with “SearchGPT” active? ">
    Yes, Bright Data GPT scraper always works with the “Search” function active.
  </Accordion>

  <Accordion title="Can I view the code behind the scraper?">
    Scrapers available in the Web Scrapers Library are pre-built solutions, and their underlying code is not accessible for modification or viewing.\
    For those interested in seeing how scrapers work, the Web Scraper IDE provides several example templates when you create a new scraper. These examples serve as practical references to help you understand scraping techniques and build your own custom solutions.
  </Accordion>

  <Accordion title="Can i get the results directly to my machine or software while using the Scrapers?">
    Yes, using the Scrapers you can return the scrape data to the request point\
    Using the following endpoint - `POST api.brightdata.com/datasets/v3/scrape`\
    This endpoint allows you to fetch data efficiently and ensures seamless integration with your applications or workflows.\
    \
    **How does it works?**\
    The API enables you to send a scraping request and receive the results directly at the request point. This eliminates the need for data retrieval or the need to send to external storage, streamlines your data collection process.\
    \
    **Limitations**

    * For long collection operations the best practice is to use our [tigger/ ](/api-reference/rest-api/scraper/asynchronous-requests)endpoing (In case the collection request is taking too long while using /scrape endpoint, you will get the \
      snapshot ID, which you will use to [download](/api-reference/scrapers/delivery-apis/download-snapshot) the data once ready)
  </Accordion>

  <Accordion title="What is a dataset id and where can I find it?">
    A Dataset ID is a unique identifier used in Scrapers requests. It's included in the request URL to specify which particular Web Scraper you want to access. This ID ensures that your API call retrieves data from the correct scraper in Bright Data. Here is how it is used: `https://api.brightdata.com/datasets/v3/trigger?dataset_id=DATASET_ID_HERE`

    A dataset id will look like: `gd_XXXXXXXXXXXXXXXXX` For example: `gd_l1viktl72bvl7bjuj0`

    You can find the exact dataset ID in two places:

    1. In the **browser URL bar** when viewing a scraper page, it appears as `/cp/scrapers/gd_xxx`
    2. In the **Code examples** panel on the scraper's **Configuration** tab, it is pre-filled in the curl command, ready to copy.

    Note: An id that looks like `s_XXXXXXXXXXXXXXXXXX`for example: `s_m7hm4et0141r2rhojq` is not a dataset ID, it is a snapshot id - a snapshot is a collection of data that is collected from a single Scrapers request.
  </Accordion>

  <Accordion title="What is 'Discovery only' mode?">
    In Discovery-only mode, the results obtained during the discovery phase are returned as the final output and do not proceed to the PDP (Product Detail Page) stage.

    \
    For example, if an Amazon product discovery scraper is initiated in Discovery-only mode, it will return only the product URLs found during the discovery phase. When this mode is turned off, the scraper will continue to visit and extract data from each individual product page identified during discovery.
  </Accordion>

  <Accordion title="Is there an option to rerun failed snapshots?">
    Yes - you can rerun a snapshot using the rerun API.

    Example:

    curl --request POST --url [https://api.brightdata.com/datasets/v3/snapshot/\{snapshot\_id}/rerun](https://api.brightdata.com/datasets/v3/snapshot/\{snapshot_id}/rerun) --header 'Authorization: Bearer '
  </Accordion>

  <Accordion title="How to retrieve your original inputs?">
    You can use the following API call to get your input data back:

    ```bash theme={null}
    curl -H "Authorization: Bearer TOKEN API" -H "Content-Type: application/json" "https://api.brightdata.com/datasets/v3/snapshot/sd_XXXX/input" -k
    ```

    Simply replace:

    * `YOUR_API_KEY` with your actual API key
    * `sd_XXXX` with your snapshot ID
  </Accordion>

  <Accordion title="What is the difference between 'Synchronous (Real-time)' and 'Asynchronous' in the UI?">
    The Control Panel uses two UI labels that map directly to API endpoints:

    | UI Label                    | API Endpoint                | Use when                                                        |
    | --------------------------- | --------------------------- | --------------------------------------------------------------- |
    | **Synchronous (Real-time)** | `POST /datasets/v3/scrape`  | You need instant results for 1–20 URLs                          |
    | **Asynchronous**            | `POST /datasets/v3/trigger` | You're processing bulk URLs, discovery tasks, or large datasets |
  </Accordion>

  <Accordion title="Where do I get a Snapshot ID?">
    Snapshot IDs are returned when you trigger a collection (POST `/datasets/v3/trigger`), filter a dataset (POST `/datasets/filter`), or via a dataset subscription. You can also list all your snapshots with GET `/datasets/v3/snapshots`.
  </Accordion>

  <Accordion title="What do I do with the delivery job ID in the response?">
    The `id` in the response is a delivery job ID. Use it to track delivery progress by calling GET `/datasets/v3/delivery/{delivery\_id}`. Poll until status is "done".
  </Accordion>

  <Accordion title="Does the snapshot need to be in a specific status?">
    Yes. The snapshot must be in `ready` status. Check with GET `/datasets/snapshots/{id}` before calling deliver. Possible statuses: `scheduled`, `building`, `ready`, `failed`.
  </Accordion>

  <Accordion title="Can I deliver the same snapshot to multiple destinations?">
    Yes. Call this endpoint multiple times with different delivery configurations for the same snapshot ID.
  </Accordion>

  <Accordion title="What file formats are supported?">
    `json`, `jsonl`, and `csv`.
  </Accordion>

  <Accordion title="How do I split large snapshots into smaller files?">
    Use the `batch_size` parameter to set the number of records per file. Each file (batch) must stay under the 5GB hard limit. Estimate `batch_size` by dividing 5GB by your average record size, then start lower and adjust based on the actual file size you get.

    For example, if your average record is \~5KB, a `batch_size` of 1,000,000 records lands right at the \~5GB limit. Start at 500,000 records (\~2.5GB) to stay safely under, then raise or lower `batch_size` based on the file size you receive.
  </Accordion>

  <Accordion title="Why did my request return a 400 error?">
    The most common cause is that your `batch_size` produces a file larger than 5GB. For example, if your average record size is \~5KB, a `batch_size` of 1,000,000 produces a \~5GB file that may exceed the limit. Lower your `batch_size` (e.g., to 100,000) and retry.
  </Accordion>

  <Accordion title="Can I compress the output?">
    Yes. Set `compress: true` to receive gzip-compressed files.
  </Accordion>

  <Accordion title="What is the maximum file size per batch?">
    5GB. This is a hard limit per delivered file. Use `batch_size` to control how many records go into each file and ensure each stays under this threshold.
  </Accordion>
</AccordionGroup>


# Clay integration
Source: https://docs.brightdata.com/datasets/scrapers/scrapers-library/integrations/clay

Integrate Bright Data's Web Scraper API (1000+ pre-built scrapers) with Clay to automate data collection and enrich workflows with structured web data.

This article will provide you with information on integrating Clay to Bright Data web scrapes APIs, Clay is a powerful tool for managing and automating workflows. By integrating your Scrapers into Clay, you can:

* Automate data scraping from targeted websites.

* Process and generate insights on the collected data in Clay workflows.

* Streamline the delivery of web-scraped data into other tools or services via Clay.

***

## Prerequisites

Before you begin, ensure the following:

1. Access to Clay: You must have a Clay account with administrator privileges.

2. Scrapers Access: You should have your Bright Data API key including authentication details, the needed endpoints, and request/response structures in place.

***

## How to integrate with Clay

### Step 1: Set Up the Scrapers

1. Choose the target website from our variety of Bright data API offerings

2. Pick the specific scraper you need

3. Update the desired list of Inputs via JSON or CSV

4. Enable the “Include errors report with the results” toggle button

5. Enable the “Deliver results to external storage” toggle OR the “Send to webhook” toggle button according to your preference

***

### Step 2: Create an API Request Workflow in Clay

Clay allows you to create automated workflows using its user-friendly interface. To call your Scrapers, follow these steps:

1. **Log in to Clay**:

   * Log into your Clay account.

   * Navigate to the Workflows section.

2. **Set Up a Trigger**:

   * Choose how you'd like to trigger the workflow (e.g., manually, scheduled, or based on an event in another service integrated with Clay).

3. **Add an HTTP Request Action**:

   * Add an HTTP request block to your workflow.

   * Select the HTTP method supported by your Scrapers (POST "[Trigger a collection](/api-reference/scrapers/delivery-apis/download-snapshot)").

4. **Configure the Request**:

   * In the HTTP request block, input the following:

   * URL: Enter the API endpoint (e.g., [https://api.brightdata.com/datasets/v3/trigger](/api-reference/rest-api/scraper/asynchronous-requests)).

   * Headers: Include any required headers, such as:

   ```JSON theme={null}
     {
         "Authorization": "Bearer YOUR_API_KEY",
         "Content-Type": "application/json"
     }
   ```

   * Body (if required): Add any parameters required in the body as JSON.

5. **Test the Request**:

   * Send a test request using Clay's testing tools to ensure that the Scrapers responds with the expected data.

***

### Step 3: Process the Response in Clay

Once you’ve successfully connected to the Scrapers, you can process the response data:

1. **Integrate with Other Services**:

   * Use Clay to send the data to a database, Google Sheets, email, or any other service.

2. **Add Conditions/Logic**:

   * Create conditions or filters in your workflow. For example, only process items with a price above a certain threshold.

***

### Step 4: Schedule or Deploy Your Workflow

Configure your workflow to run automatically based on your preferred schedule (e.g., every hour or daily) or trigger it manually when needed.


# Scrapers library overview
Source: https://docs.brightdata.com/datasets/scrapers/scrapers-library/overview

Use Bright Data's Scrapers Library to extract structured data from 1000+ pre-built scrapers via synchronous or asynchronous API calls.

The [Scrapers](https://brightdata.com/cp/scrapers/browse) lets you extract data from websites programmatically. It offers both synchronous and asynchronous scraping methods for different use cases, from quick data retrieval to complex, large-scale extraction jobs.

The API handles real-time processing for single URL inputs, and batch processing for 2 or more inputs, accommodating various scraping requirements.

<Frame>
  <img alt="overview.png" />
</Frame>

## Which scraping methods are available

### Synchronous scraping (`/scrape`)

[Synchronous scraping](/api-reference/scrapers/synchronous-requests) allows you to initiate a scrape and receive results in a single request, ideal for real-time quick data retrieval.

<CodeGroup>
  ```powershell cURL theme={null}
    curl "https://api.brightdata.com/datasets/v3/scrape?dataset_id=gd_l1viktl72bvl7bjuj0&format=json" \
    -H "Authorization: Bearer API_KEY" \
    -H "Content-Type: application/json" \
    -d '[{"url": "https://www.linkedin.com/in/elad-moshe-05a90413/"}]'
  ```

  ```javascript sync-scrape.js theme={null}
      (async function synchronousScrape() {
        try {
          const response = await fetch(
            'https://api.brightdata.com/datasets/v3/scrape?dataset_id=gd_l1viktl72bvl7bjuj0&format=json',
            {
              method: 'POST',
              headers: {
                'Authorization': 'Bearer API_KEY',
                'Content-Type': 'application/json'
              },
              body: JSON.stringify([
                {"url": "https://www.linkedin.com/in/elad-moshe-05a90413/"}
              ])
            }
          );
          
          const data = await response.json();
          console.log('Scrape completed:', data);
          return data;
        } catch (error) {
          console.error('Error during scrape:', error);
        }
      })();
  ```

  ```python sync_scrape.py theme={null}
      import requests

      def synchronous_scrape():
          url = "https://api.brightdata.com/datasets/v3/scrape"
          
          params = {
              "dataset_id": "gd_l1viktl72bvl7bjuj0",
              "format": "json"
          }
          
          headers = {
              "Authorization": "Bearer API_KEY",
              "Content-Type": "application/json"
          }
          
          data = [
              {"url": "https://www.linkedin.com/in/elad-moshe-05a90413/"}
          ]
          
          response = requests.post(url, params=params, headers=headers, json=data)
          response.raise_for_status()
          
          print("Scrape completed:", response.json())
          return response.json()
      
      synchronous_scrape()
  ```

  ```json sample-response.json theme={null}
  [
    {
      "id": "john-doe-123abc",
      "name": "John Doe",
      "city": "San Francisco",
      "country_code": "US",
      "about": "Lorem ipsum dolor sit amet, consectetur adipiscing elit. Proin vel magna at nunc commodo...",
      "current_company": {
        "link": "https://www.linkedin.com/company/acme-corp",
        "name": "ACME Corporation",
        "company_id": "acme-corp"
      },
      "url": "https://www.linkedin.com/in/john-doe-123abc/",
      "people_also_viewed": [
        {
          "profile_link": "https://www.linkedin.com/in/jane-smith",
          "name": "Jane Smith",
          "location": "New York, USA"
        },
        {
          "profile_link": "https://www.linkedin.com/in/robert-johnson",
          "name": "Robert Johnson",
          "location": "Boston, USA"
        }
      ],
      "educations_details": "Stanford University",
      "education": [
        {
          "title": "Stanford University",
          "url": "https://www.linkedin.com/school/stanford-university/",
          "start_year": "2010",
          "end_year": "2014"
        }
      ],
      "avatar": "https://example.com/avatar.jpg",
      "courses": [
        {
          "subtitle": "-",
          "title": "Machine Learning"
        },
        {
          "subtitle": "-",
          "title": "Data Structures"
        },
        {
          "subtitle": "-",
          "title": "Cloud Computing"
        }
      ],
      "followers": 1250,
      "connections": 500,
      "current_company_name": "ACME Corporation",
      "projects": [
        {
          "title": "Open Source Project X",
          "start_date": "January 2022",
          "end_date": "Present",
          "description": "Lorem ipsum dolor sit amet, consectetur adipiscing elit. Sed do eiusmod tempor incididunt ut labore et dolore magna aliqua."
        }
      ],
      "timestamp": "2023-06-15T14:27:07.001Z",
      "input": {
        "url": "https://www.linkedin.com/in/john-doe-123abc/"
      }
    }
  ]
  ```
</CodeGroup>

#### Key features of synchronous scraping:

* Real-time results in the same request
* Perfect for single URL and quick extractions
* Simplified error handling
* 1-minute timeout (automatically switches to async if exceeded)

### Asynchronous scraping (`/trigger`)

[Asynchronous scraping](/api-reference/rest-api/scraper/asynchronous-requests) initiates a job that runs in the background, allowing you to handle larger and more complex scraping tasks in batch mode. Batch mode allows up to 100 concurrent requests, and each batch can process up to 1GB of inputs file size, making it ideal for high-volume data collection projects.

Discovery tasks (finding related products, scraping multiple pages) require the asynchronous scraping (`/trigger`) due to their need to navigate and extract data across multiple web pages.

<CodeGroup>
  ```shell cURL theme={null}
  curl "https://api.brightdata.com/datasets/v3/trigger?dataset_id=gd_l1viktl72bvl7bjuj0&format=json&uncompressed_webhook=true" \
    -H "Authorization: Bearer API_KEY" \
    -H "Content-Type: application/json" \
    -d '[
      {"url": "https://www.linkedin.com/in/elad-moshe-05a90413/"},
      {"url": "https://www.linkedin.com/in/jonathan-myrvik-3baa01109"},
      {"url": "https://www.linkedin.com/in/aviv-tal-75b81/"},
      {"url": "https://www.linkedin.com/in/bulentakar/"},
      {"url": "https://www.linkedin.com/in/nnikolaev/"}
    ]'
  ```

  ```javascript trigger-async-scrape.js theme={null}
      (async function asynchronousScrape() {
        try {
          const response = await fetch(
            'https://api.brightdata.com/datasets/v3/trigger?dataset_id=gd_l1viktl72bvl7bjuj0&format=json',
            {
              method: 'POST',
              headers: {
                'Authorization': 'Bearer API_KEY',
                'Content-Type': 'application/json'
              },
              body: JSON.stringify([
                {"url": "https://www.linkedin.com/in/elad-moshe-05a90413/"},
                {"url": "https://www.linkedin.com/in/jonathan-myrvik-3baa01109"},
                {"url": "https://www.linkedin.com/in/aviv-tal-75b81/"},
                {"url": "https://www.linkedin.com/in/bulentakar/"},
                {"url": "https://www.linkedin.com/in/nnikolaev/"}
              ])
            }
          );
          
          const data = await response.json();
          console.log('Snapshot ID:', data);
          return data;
        } catch (error) {
          console.error('Error during scrape:', error);
        }
      })();
  ```

  ```python trigger-async-scrape.py theme={null}
      import requests

      def asynchronous_scrape():
          url = "https://api.brightdata.com/datasets/v3/trigger"
          
          params = {
              "dataset_id": "gd_l1viktl72bvl7bjuj0",
              "format": "json"
          }
          
          headers = {
              "Authorization": "Bearer API_KEY",
              "Content-Type": "application/json"
          }
          
          data = [
              {"url": "https://www.linkedin.com/in/elad-moshe-05a90413/"},
              {"url": "https://www.linkedin.com/in/jonathan-myrvik-3baa01109"},
              {"url": "https://www.linkedin.com/in/aviv-tal-75b81/"},
              {"url": "https://www.linkedin.com/in/bulentakar/"},
              {"url": "https://www.linkedin.com/in/nnikolaev/"}
          ]
          
          response = requests.post(url, params=params, headers=headers, json=data)
          response.raise_for_status()
          
          print("Snapshot ID:", response.json())
          return response.json()
      
      asynchronous_scrape()
  ```

  ```json sample-respone.json theme={null}
  {
      "snapshot_id": "s_maof15r7v28n4gc95"
  }
  ```
</CodeGroup>

#### Key features of asynchronous scraping:

* Handles multiple URLs in batch processing (up to 1GB of inputs file size)
* No timeout limitations for long-running jobs
* [Progress monitoring](/api-reference/scrapers/management-apis/monitor-progress#monitor-progress) via status checks
* Ideal for large datasets
* Required for "discovery" tasks that need to crawl multiple pages or perform complex data extraction

### Understanding Synchronous and Asynchronous Scraping

When dealing with web scraping, it's essential to choose the right method based on your needs:

#### Synchronous Scraping, `/scrape` (labeled **"Synchronous (Real-time)"** in the UI):

* **Purpose**: Designed for quick, single-url jobs where instant results are required.
* **Response**: Returns the scraped data directly within the same request.
* **Ideal for**: Quick data checks, single-page extractions without long runtimes.

<Tip>
  Have a simple one-link case? Consider trying Synchronous Requests for instant results.
</Tip>

#### Asynchronous Scraping, `/trigger` (labeled **"Asynchronous"** in the UI):

* **Purpose**: Used for large, complex, or long-running scraping jobs.
* **Response**: Immediately returns a snapshot\_id instead of data. This snapshot\_id is used to track job progress or download the data later.
* **Ideal for**: Batch processing, multiple URLs, or high-volume data collection. Requires managing multiple pages or complex data extractions.

<Tip>
  Looking for large-scale scraping? Asynchronous Requests might be suited for your complex tasks.
</Tip>

## How To Collect?

## [Trigger a Collection](/api-reference/rest-api/scraper/asynchronous-requests) ([Demo](https://app.arcade.software/share/BPGoTdRmf89Ip1EQuIOW))

1. Choose your target website from our [API offerings](https://brightdata.com/cp/scrapers/browse?category=all)
2. Select the appropriate scraper for your needs
3. Decide between synchronous or asynchronous scraping based on your requirements:
   * Use synchronous (`/scrape`) for immediate results and simple extractions
   * Use asynchronous (`/trigger`) for complex scraping, multiple URLs, or large datasets
4. Provide your input URLs via JSON or CSV
5. Enable error reporting to track any issues
6. Select your preferred delivery method
   * [External storage](#via-deliver-to-external-storage:)
   * [Webhook](/datasets/scrapers/scrapers-library/overview#via-webhook%3A)

### How to deliver via webhook

1. Set your webhook URL and Authorization header if needed
2. Select your preferred file format (JSON, NDJSON, JSON lines, CSV)
3. Choose whether to send it compressed or not
4. Test webhook to validate that the operation runs successfully (using sample data)
5. Copy the code and run it.

<Frame>
  <img alt="via-webhook.png" />
</Frame>

### Via Deliver to external storage:

1. Select your preferred delivery location (S3, Google Cloud, Snowflake, or any other available option)
2. Fill out the needed credentials according to your pick
3. Select your preferred file format (JSON, NDJSON, JSON lines, CSV)
4. Copy the code and run it.

<Frame>
  <img alt="via-deliver-to-external-storage.png" />
</Frame>

### How to limit records per input

While running a discovery API, you can set a limit of the number of results per input provided

<Frame>
  <img alt="limit-per-input-disabled.png" />
</Frame>

In the example below, we’ve set a limitation of 10 results per input

<Frame>
  <img alt="limit-per-input-10.png" />
</Frame>

## How to manage snapshots with the Management APIs

Additional actions you can do using our different API endpoints

<Frame>
  <img alt="management-apis.png" />
</Frame>

### Get snapshot list

Check your snapshot history with this API. It returns a list of all available snapshots, including the snapshot ID, creation date, and status. ([link to endpoint playground](/api-reference/scrapers/management-apis/get-snapshots))

<Frame>
  <img alt="get-snapshot-list.png" />
</Frame>

<Tip>
  If you are confused by receiving a `snapshot_id`, it means an asynchronous call was made. Consider using the synchronous `/scrape` endpoint for simpler, immediate tasks.
</Tip>

### Monitor Progress

Check your data collection status with this API. It should return "collecting" while gathering data, "digesting" when processing, and "ready" when available. ([link to endpoint playground](/api-reference/scrapers/management-apis/monitor-progress))

<Frame>
  <img alt="monitor-progress.png" />
</Frame>

### How to cancel a snapshot

Cancel a running collection, stop your data collection before finishing with this API. It should return "ok" while managing to stop the collection. ([link to endpoint playground](/api-reference/scrapers/management-apis/cancel-snapshot))

### Monitor Delivery

Check your delivery status with this API. It should return "done" while the delivery was completed, "canceled" when the delivery was canceled, and "Failed" when the delivery was not completed. ([link to endpoint playground](/api-reference/scrapers/management-apis/monitor-delivery))

<Frame>
  <img alt="monitor-progress.png" />
</Frame>

## Known system limitations

### Maximum file size

|                  |                                               |
| ---------------- | --------------------------------------------- |
| Input            | up to 1GB                                     |
| Webhook delivery | up to 1GB                                     |
| API Download     | up to 5GB (for bigger files use API delivery) |
| Delivery API     | unlimited                                     |

## Rate Limits & Concurrent Requests

To ensure stable performance and fair usage, the Scrapers enforces rate limits based on the type of request: single input or batch input. Exceeding these limits will result in a 429 error response.

### **What is the Rate Limit?**

The Scrapers supports a maximum number of 5,000 concurrent jobs (or snapshots), regardless to the amount of inputs.

If your application exceeds these limits, the API will return the following error:

> **429 Client Error: Too Many Requests for URL**

This error indicates that your request rate has surpassed the allowed threshold.

### **How to Avoid Hitting Rate Limits**

To reduce the number of concurrent requests and stay within the rate limits:

* Use the **batch input method** whenever possible, and batch as many inputs as possible.
* A single batch request can include up to **1GB of input data** (file size).
* By combining multiple inputs into one batch request, you can minimize the total number of requests sent concurrently.

<Tip>
  When using the Discovery Scraper the system automatically utilizes batch input method where rate limit is up to 100 requests.
</Tip>

### **Best Practices for Managing API Rate Limits**

* Monitor your request volume and adjust your concurrency accordingly.
* Use batch requests to group multiple scraping tasks into fewer API calls.
* Contact our support team if you need help optimizing your requests.


# Scrapers - quick start
Source: https://docs.brightdata.com/datasets/scrapers/scrapers-library/quickstart

Get started with the Bright Data Scrapers Library (1000+ pre-built scrapers): pick a target site, trigger a collection, and retrieve results in 3 steps.

<Steps>
  <Step title="Prerequisites">
    * A Bright Data account (Sign Up → 2 min)
    * An active API Key ([How to get an API Key](/api-reference/authentication))
  </Step>

  <Step title="Pick the target site">
    1. Go to the [Scraper Library](https://brightdata.com/cp/scrapers/browse)
    2. Browse the list and click the site you need.
    3. Can’t find it? Check out the [Managed Services](/datasets/scrapers/managed-services) or [Scraper Studio IDE](/datasets/scraper-studio/introduction) products for a solution tailored to your needs!
  </Step>

  <Step title="Choose the scraper endpoint">
    Inside a site you’ll see multiple Scraper Endpoints, for example:

    * LinkedIn
      * Profile by URL – supply profile URLs, get public data fields.
      * Profiles by Keyword – supply a search term, get matching profile URLs (+ optional full data).
      * Company Jobs – collect job postings from a company page.
    * Amazon
      * Product by ASIN, Search Results, Reviews, “Frequently Bought Together”, etc.

    Pick the endpoint that returns the information you need, then click it to open the scraper's Configuration tab.

    <Frame>
      <img alt="collect-by-url" />
    </Frame>
  </Step>

  <Step title="Build the request">
    The central panel now shows a form. Work through top-to-bottom:

    **A. Inputs**

    * "Single Input”: paste a URL/keyword right in the textbox.
    * “Bulk CSV”: upload a CSV according to the input parameters of the scraper

    **B. Scraper Settings (optional)**

    1. Output Schema – tick only the data fields you require (saves bandwidth & storage).
    2. External Storage – plug credentials for S3 / GCS / Azure / etc. Result files land there automatically.
    3. Webhook URL – we POST the job’s JSON to your endpoint once finished, great for real-time pipelines.
  </Step>

  <Step title="Pick run mode: /scrape vs /trigger">
    The Code Snippet panel (right side) updates live according to your configuration setup. To run the request you can choose between two endpoints:

    | Mode  | UI Label                | API endpoint                                                   | Behaviour                                                                                                                                      | Good For                                        |
    | :---- | :---------------------- | :------------------------------------------------------------- | :--------------------------------------------------------------------------------------------------------------------------------------------- | :---------------------------------------------- |
    | Sync  | Synchronous (Real-time) | [/scrape](/api-reference/scrapers/synchronous-requests)        | Return the data as a response to the API call in real time. This endpoint has a 1-minute timeout, If it runs longer it auto-switches to async. | Quick and light jobs with results in real time. |
    | Async | Asynchronous            | [/trigger](/api-reference/rest-api/scraper/trigger-collection) | Returns snapshot\_id instantly;   you poll `/snapshots/{id}` or wait for the results in your `logs/webhook/storage`.                           | Production & large jobs                         |
  </Step>

  <Step title="Copy the Code">
    * Language selector – choose your preferred programming language using the code block dropdown.
    * Snippet already contains: endpoint URL, your API key header, payload JSON (inputs + options).
    * Paste it into a terminal / IDE / serverless function.
  </Step>

  <Step title="Monitor & Retrieve Results">
    1. Scraper page → Logs tab

    <Frame>
      <img alt="logs-tab" />
    </Frame>

    * Real-time state (running, ready, failed).
    * Download JSON/CSV/etc with one click.

    2. Webhook (if set)
       * Your server receives `{snapshot_id, status, result_url}` payload.
    3. External Storage
       * The result file appears in the bucket path you configured.
    4. [Snapshot Management API](/api-reference/scrapers/management-apis/monitor-progress)
       * Use these endpoints to monitor the snapshot progress.
  </Step>
</Steps>

🎉 You’re now ready to scrape at scale, happy collecting!


# Streamed and file delivery
Source: https://docs.brightdata.com/datasets/scrapers/scrapers-library/stream-and-file-delivery

Configure streamed delivery to receive large snapshots in real-time batches across 1000+ scrapers, or file delivery to retrieve raw page files alongside data.

This guide shows you how to use two advanced delivery features for scrapers: **streamed delivery** for large snapshots and **file delivery** to retrieve raw page files with your data.

<Info>
  **Prerequisites:**

  * A Bright Data account with an active scraper
  * Delivery method set to **Storage** or **Webhook** (both features require this)
</Info>

***

## How to stream delivery in batches

When a snapshot is large, streamed delivery lets you receive results immediately as they're collected, in batches, rather than waiting for the full snapshot to complete.

### Enable streamed delivery

#### Control panel

1. Open your scraper's **Delivery settings** tab.
2. Toggle **Stream results** on.
3. Enter how many data lines each batch should contain.

<Frame>
  <img alt="Stream results toggle in Delivery settings" />
</Frame>

#### Web Scraper API parameter

Add `&stream_max_lines=1000` to your Web Scraper API (WSAPI) request:

```bash theme={null}
curl "https://api.brightdata.com/datasets/v3/trigger?dataset_id=<DATASET_ID>&stream_max_lines=1000" \
  -H "Authorization: Bearer API_KEY"
```

### Limits

| Setting            | Value         |
| ------------------ | ------------- |
| Minimum batch size | 10 lines      |
| Maximum batch size | 100,000 lines |

<Warning>
  Streamed delivery requires a **Storage** or **Webhook** delivery method. It is not compatible with API download.
</Warning>

***

## How to deliver raw page files

File delivery lets you retrieve raw page files (HTML snapshots, WARC archives, or screenshots) alongside your scraped data.

### How to enable file delivery

Add `&download_fields=` to your WSAPI request with one or more of the available file types:

```bash theme={null}
curl "https://api.brightdata.com/datasets/v3/trigger?dataset_id=<DATASET_ID>&download_fields=html" \
  -H "Authorization: Bearer API_KEY"
```

To request multiple file types, pass them as a comma-separated list:

```bash theme={null}
curl "https://api.brightdata.com/datasets/v3/trigger?dataset_id=<DATASET_ID>&download_fields=html,screenshot" \
  -H "Authorization: Bearer API_KEY"
```

### Available file types

| Type         | Availability         | Description                                      |
| ------------ | -------------------- | ------------------------------------------------ |
| `html`       | Always available     | Raw HTML of the scraped page                     |
| `warc`       | Not always available | Full WARC archive including request and response |
| `screenshot` | Not always available | Screenshot of the page at time of scraping       |

<Warning>
  File delivery works only when the delivery method is set to **Storage** or **Webhook**.
</Warning>

***

## Related

<CardGroup>
  <Card title="Delivery options" icon="truck" href="/datasets/scrapers/scrapers-library/delivery-options">
    Configure your storage destination and output format
  </Card>

  <Card title="API reference" icon="code" href="/datasets/scrapers/scrapers-library/api-reference">
    Full API parameters for triggering and managing snapshots
  </Card>
</CardGroup>


# Success rate alerts for scrapers
Source: https://docs.brightdata.com/datasets/scrapers/scrapers-library/success-rate

Configure per-scraper email alerts in the Bright Data Control Panel for any of 1000+ scrapers when a Web Scraper API success rate drops or recovers.

## Why this is good (and why it matters)

* Faster time-to-detection: Instead of discovering issues after a workflow breaks (or after opening a ticket), you get notified as soon as SR degrades.
* More production-ready monitoring: Your team can react quickly to failures or partial degradation and reduce downtime for data pipelines.
* Clarity instead of a “black box”: SR changes are surfaced proactively, so you don't need to constantly check dashboards to know if a scraper is struggling.
* Automatic recovery signal: You get a second email when SR returns to normal - useful for closing incidents and restoring paused jobs.

## How to set up Success Rate (SR) email alerts for a Web Scraper API scraper

This guide shows you how to configure email notifications in the Control Panel so your team gets alerted when a scraper's SR drops below a threshold - and when it recovers.

## What SR email alerts do

Once enabled per scraper, SR alerts send:

* Drop alert: An email when the scraper's Success Rate falls below the threshold you set (example: below 25%).
* Recovery alert: A second email when the scraper's Success Rate rises back above that same threshold.
  You can select one or multiple recipients from the email addresses available in your Control Panel settings.

<Note>
  **Default behavior**: By default, alerts are configured to notify only if the scraper is in outage. You can manually increase the threshold from the scraper page to detect issues earlier (before a full outage).
</Note>

## Configure SR alerts (per scraper)

1. Open the Control Panel and go to Web Scraper API.
2. Select the scraper you want to monitor.
3. In the scraper page, find Success Rate (SR) email alerts (notification settings).

<Frame>
  <img alt="notification-tab.png" />
</Frame>

4. Enable the SR email alerts for this scraper.

<Frame>
  <img alt="success-rate-notifications.png" />
</Frame>

5. Set the SR threshold (example: 25%).
6. Select recipients (one or multiple email addresses).
7. Save your changes.

## Troubleshooting

| Issue                            | What it usually means                                                      | How to fix                                                                                       |
| :------------------------------- | :------------------------------------------------------------------------- | :----------------------------------------------------------------------------------------------- |
| No recipients to choose from     | No emails are defined/available in Control Panel Settings                  | Add/verify email addresses in Control Panel Settings, then return to the scraper and select them |
| Not receiving alerts             | Alerts aren't enabled for that scraper, or the threshold isn't appropriate | Re-check the scraper's SR alerts toggle, threshold value, and click Save                         |
| You only get outage-level alerts | Threshold is still at the default “outage only” behavior                   | Increase the threshold manually on the scraper page                                              |


# Working with sources in AI scrapers
Source: https://docs.brightdata.com/datasets/scrapers/scrapers-library/working-with-sources

Work with citation sources in Bright Data AI scrapers across 5 platforms: source generation, handling source errors and prompting for verifiable output.

## What are “Sources” in AI Scrapers?

Some AI scrapers can return citations / hyperlinks (“sources”) alongside the generated answer. Sources are useful when you need:

* Verifiable references for claims
* Links to original pages for auditing / compliance
* Research-style outputs (e.g., summaries with citations)

<Warning>
  Sources availability depends on whether the underlying AI product decides to use web search / browsing for that specific request.
</Warning>

<Tip>
  All our LLMs attempt to include sources in their responses. Some models provide an option to return an error if sources can’t be retrieved. For certain scrapers, sources are only returned if you explicitly enable the “source” option.
</Tip>

## How sources are generated

When you run an AI scraper with a prompt:

1. We send your prompt to the selected AI engine (e.g., ChatGPT).

2. The AI engine decides-based on its internal policies and runtime conditions-whether to:

   * answer from its existing knowledge, or
   * perform a web search and attach citations/sources.

3. If web search is used, sources/citations are returned in the response (when available).

4. If web search is not used, the answer may be returned without sources.

## What is a “Sources error”?

A Sources error typically means the run completed but the engine did not provide sources as expected (for example, the engine chose not to browse, browsing was unavailable, or citations weren’t returned for that request/country/version).

## Prompting best practices to increase the chance of getting sources

Because web-search and citations are influenced by the engine’s internal decisioning, prompt phrasing can materially impact whether sources appear.

Recommended tactics:

* Explicitly request sources/citations
  > **Example**: “Include sources with links for each key claim.”

* Ask for web-verified / up-to-date information
  > **Example**: “Use web search and cite sources from the last 12 months.”

* Request a citations section
  > **Example**: “At the end, add a ‘Sources’ section with URLs.”

* If you get missing sources, try a revised prompt rather than re-running the exact same prompt.
  * In our testing, changing the prompt can increase the likelihood of web search and returning sources.


# Async TikTok data collection
Source: https://docs.brightdata.com/datasets/scrapers/tiktok/async-requests

Trigger large-scale TikTok scraping jobs, monitor progress, and retrieve results using the Bright Data async /trigger endpoint. Supports batches of 20 URLs.

This guide shows you how to scrape TikTok data at scale using the asynchronous `/trigger` endpoint. Use this when you have more than 20 URLs, need discovery, or want delivery to a webhook or S3.

<Tip>
  Not sure whether to use sync or async? Read [Understanding sync vs. async requests](/datasets/scrapers/concepts/sync-vs-async).
</Tip>

## Prerequisites

* A [Bright Data account](https://brightdata.com/cp/start) with an active API key
* Familiarity with the [synchronous request flow](/datasets/scrapers/tiktok/send-first-request)

## Step 1: Trigger the collection

Send a `POST` request to the `/trigger` endpoint with your input URLs:

<CodeGroup>
  ```bash cURL theme={null}
  curl -X POST \
    "https://api.brightdata.com/datasets/v3/trigger?dataset_id=gd_l1villgoiiidt09ci&format=json" \
    -H "Authorization: Bearer YOUR_API_KEY" \
    -H "Content-Type: application/json" \
    -d '[
      {"url": "https://www.tiktok.com/@tiktok"},
      {"url": "https://www.tiktok.com/@charlidamelio"},
      {"url": "https://www.tiktok.com/@khaby.lame"},
      {"url": "https://www.tiktok.com/@bellapoarch"},
      {"url": "https://www.tiktok.com/@addisonre"}
    ]'
  ```

  ```python Python theme={null}
  import requests

  response = requests.post(
      "https://api.brightdata.com/datasets/v3/trigger",
      params={
          "dataset_id": "gd_l1villgoiiidt09ci",
          "format": "json",
      },
      headers={
          "Authorization": "Bearer YOUR_API_KEY",
          "Content-Type": "application/json",
      },
      json=[
          {"url": "https://www.tiktok.com/@tiktok"},
          {"url": "https://www.tiktok.com/@charlidamelio"},
          {"url": "https://www.tiktok.com/@khaby.lame"},
          {"url": "https://www.tiktok.com/@bellapoarch"},
          {"url": "https://www.tiktok.com/@addisonre"},
      ],
  )

  snapshot = response.json()
  print("Snapshot ID:", snapshot["snapshot_id"])
  ```

  ```javascript Node.js theme={null}
  const response = await fetch(
    "https://api.brightdata.com/datasets/v3/trigger?dataset_id=gd_l1villgoiiidt09ci&format=json",
    {
      method: "POST",
      headers: {
        "Authorization": "Bearer YOUR_API_KEY",
        "Content-Type": "application/json",
      },
      body: JSON.stringify([
        { url: "https://www.tiktok.com/@tiktok" },
        { url: "https://www.tiktok.com/@charlidamelio" },
        { url: "https://www.tiktok.com/@khaby.lame" },
        { url: "https://www.tiktok.com/@bellapoarch" },
        { url: "https://www.tiktok.com/@addisonre" },
      ]),
    }
  );

  const snapshot = await response.json();
  console.log("Snapshot ID:", snapshot.snapshot_id);
  ```
</CodeGroup>

You should see a `200` response with a `snapshot_id`:

```json theme={null}
{
  "snapshot_id": "s_m1a2b3c4d5e6f7g8h"
}
```

Save this ID. You need it to check progress and download results.

## Step 2: Monitor progress

Poll the snapshot status until it shows `ready`. This takes 30 seconds to several minutes depending on the number of URLs.

<CodeGroup>
  ```bash cURL theme={null}
  curl "https://api.brightdata.com/datasets/v3/progress/s_m1a2b3c4d5e6f7g8h" \
    -H "Authorization: Bearer YOUR_API_KEY"
  ```

  ```python Python theme={null}
  import time

  snapshot_id = "s_m1a2b3c4d5e6f7g8h"

  while True:
      status_response = requests.get(
          f"https://api.brightdata.com/datasets/v3/progress/{snapshot_id}",
          headers={"Authorization": "Bearer YOUR_API_KEY"},
      )
      status = status_response.json().get("status")
      print(f"Status: {status}")

      if status == "ready":
          break
      time.sleep(10)
  ```

  ```javascript Node.js theme={null}
  const snapshotId = "s_m1a2b3c4d5e6f7g8h";

  let status = "collecting";
  while (status !== "ready") {
    const statusResponse = await fetch(
      `https://api.brightdata.com/datasets/v3/progress/${snapshotId}`,
      { headers: { "Authorization": "Bearer YOUR_API_KEY" } }
    );
    const statusData = await statusResponse.json();
    status = statusData.status;
    console.log("Status:", status);

    if (status !== "ready") {
      await new Promise((r) => setTimeout(r, 10000));
    }
  }
  ```
</CodeGroup>

Status values:

| Status       | Meaning                             |
| :----------- | :---------------------------------- |
| `collecting` | Scraping is in progress             |
| `digesting`  | Data is being processed             |
| `ready`      | Results are available for download  |
| `failed`     | The collection encountered an error |

## Step 3: Download results

Once the status is `ready`, download the scraped data:

<CodeGroup>
  ```bash cURL theme={null}
  curl "https://api.brightdata.com/datasets/v3/snapshot/s_m1a2b3c4d5e6f7g8h?format=json" \
    -H "Authorization: Bearer YOUR_API_KEY" \
    -o results.json
  ```

  ```python Python theme={null}
  results_response = requests.get(
      f"https://api.brightdata.com/datasets/v3/snapshot/{snapshot_id}",
      params={"format": "json"},
      headers={"Authorization": "Bearer YOUR_API_KEY"},
  )

  results = results_response.json()
  print(f"Collected {len(results)} profiles")
  ```

  ```javascript Node.js theme={null}
  const resultsResponse = await fetch(
    `https://api.brightdata.com/datasets/v3/snapshot/${snapshotId}?format=json`,
    { headers: { "Authorization": "Bearer YOUR_API_KEY" } }
  );

  const results = await resultsResponse.json();
  console.log(`Collected ${results.length} profiles`);
  ```
</CodeGroup>

You've successfully triggered, monitored, and downloaded a batch TikTok scraping job.

## Skip polling with webhooks

If you don't want to poll for status, add an `endpoint` parameter to receive results automatically:

```bash theme={null}
curl -X POST \
  "https://api.brightdata.com/datasets/v3/trigger?dataset_id=gd_l1villgoiiidt09ci&format=json&endpoint=https://your-server.com/webhook" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '[{"url": "https://www.tiktok.com/@tiktok"}]'
```

See [How to receive TikTok data via webhooks](/datasets/scrapers/tiktok/data-delivery/webhooks) for the full setup.

## Limits and constraints

| Constraint                           | Value      |
| :----------------------------------- | :--------- |
| Max input file size                  | 1 GB       |
| Max concurrent batch requests        | 100        |
| Max concurrent single-input requests | 1,500      |
| Webhook delivery size                | Up to 1 GB |
| API download size                    | Up to 5 GB |

## Troubleshooting

<Accordion title="Getting a 429 Too Many Requests error?">
  You've exceeded the concurrent request limit. Reduce the number of parallel requests or combine inputs into fewer, larger batches. Each batch can include up to 1 GB of input data.
</Accordion>

<Accordion title="Snapshot status shows 'failed'?">
  Check that all input URLs are valid TikTok URLs. Review the error details in the snapshot response or in the [Logs tab](https://brightdata.com/cp/scrapers) of your Bright Data dashboard.
</Accordion>

<Accordion title="Results are incomplete or missing some URLs?">
  Some URLs may fail individually while the overall job succeeds. Check the snapshot response for any `errors` field. Retry failed URLs in a separate request.
</Accordion>

## Next steps

<CardGroup>
  <Card title="Set up webhooks" icon="webhook" href="/datasets/scrapers/tiktok/data-delivery/webhooks">
    Receive results without polling.
  </Card>

  <Card title="Deliver to S3" icon="bucket" href="/datasets/scrapers/tiktok/data-delivery/amazon-s3">
    Send results directly to your S3 bucket.
  </Card>
</CardGroup>


# TikTok data delivery to Amazon S3
Source: https://docs.brightdata.com/datasets/scrapers/tiktok/data-delivery/amazon-s3

Configure the Bright Data TikTok Scraper API to deliver scraped profiles, posts, comments and shop data directly to your Amazon S3 bucket on job completion.

This guide shows you how to configure the Bright Data TikTok Scraper API to deliver scraped data directly to your Amazon S3 bucket when a collection job completes.

## Prerequisites

* A [Bright Data account](https://brightdata.com/cp/start) with an active API key
* An AWS account with an S3 bucket
* IAM credentials with write access to the bucket
* Familiarity with the [async request workflow](/datasets/scrapers/tiktok/async-requests)

## Step 1: Create an S3 bucket

If you already have a bucket, skip to Step 2.

In the [AWS S3 Console](https://s3.console.aws.amazon.com/s3/buckets):

1. Click **Create bucket**
2. Enter a bucket name (e.g., `tiktok-scraper-data`)
3. Select your preferred AWS region
4. Keep default settings and click **Create bucket**

## Step 2: Set up IAM permissions

Create an IAM role that grants Bright Data write access to your bucket.

### Create a policy

In the [IAM Console](https://console.aws.amazon.com/iam/), go to **Policies** and create a new policy with this JSON:

```json theme={null}
{
  "Version": "2012-10-17",
  "Statement": [
    {
      "Effect": "Allow",
      "Action": ["s3:PutObject", "s3:GetObject"],
      "Resource": "arn:aws:s3:::tiktok-scraper-data/*"
    }
  ]
}
```

Replace `tiktok-scraper-data` with your actual bucket name.

### Create a role for Bright Data

1. Go to **Roles** > **Create role**
2. Select **AWS account** as the trusted entity type
3. Enter Bright Data's AWS account ID: `422310177405`
4. Attach the policy you created above
5. Name the role (e.g., `BrightDataS3Delivery`)
6. Note the role ARN (e.g., `arn:aws:iam::123456789012:role/BrightDataS3Delivery`)

Add an external ID condition to the trust policy:

```json theme={null}
{
  "Version": "2012-10-17",
  "Statement": [
    {
      "Effect": "Allow",
      "Principal": {
        "AWS": "arn:aws:iam::422310177405:role/brd.ec2.zs-dca-delivery"
      },
      "Action": "sts:AssumeRole",
      "Condition": {
        "StringEquals": {
          "sts:ExternalId": "YOUR_BRIGHT_DATA_CUSTOMER_ID"
        }
      }
    }
  ]
}
```

Find your customer ID in [Account settings](https://brightdata.com/cp/setting/customer_details).

## Step 3: Configure delivery in Bright Data

1. Navigate to your [scraper configuration](https://brightdata.com/cp/scrapers)
2. Click the **Delivery settings** tab
3. Select **Amazon S3** as the delivery destination
4. Enter your credentials:
   * **Bucket name**: Your S3 bucket name
   * **Role ARN**: The IAM role ARN from Step 2
   * **Region**: Your S3 bucket region
   * **Path prefix** (optional): A folder path within the bucket (e.g., `tiktok/profiles/`)
5. Select your preferred file format (JSON, NDJSON, or CSV)
6. Click **Save**

## Step 4: Trigger a collection

Trigger an async collection. Results are automatically delivered to your S3 bucket:

<CodeGroup>
  ```bash cURL theme={null}
  curl -X POST \
    "https://api.brightdata.com/datasets/v3/trigger?dataset_id=gd_l1villgoiiidt09ci&format=json" \
    -H "Authorization: Bearer YOUR_API_KEY" \
    -H "Content-Type: application/json" \
    -d '[
      {"url": "https://www.tiktok.com/@tiktok"},
      {"url": "https://www.tiktok.com/@charlidamelio"},
      {"url": "https://www.tiktok.com/@khaby.lame"}
    ]'
  ```

  ```python Python theme={null}
  import requests

  response = requests.post(
      "https://api.brightdata.com/datasets/v3/trigger",
      params={"dataset_id": "gd_l1villgoiiidt09ci", "format": "json"},
      headers={
          "Authorization": "Bearer YOUR_API_KEY",
          "Content-Type": "application/json",
      },
      json=[
          {"url": "https://www.tiktok.com/@tiktok"},
          {"url": "https://www.tiktok.com/@charlidamelio"},
          {"url": "https://www.tiktok.com/@khaby.lame"},
      ],
  )

  print("Snapshot ID:", response.json()["snapshot_id"])
  ```

  ```javascript Node.js theme={null}
  const response = await fetch(
    "https://api.brightdata.com/datasets/v3/trigger?dataset_id=gd_l1villgoiiidt09ci&format=json",
    {
      method: "POST",
      headers: {
        "Authorization": "Bearer YOUR_API_KEY",
        "Content-Type": "application/json",
      },
      body: JSON.stringify([
        { url: "https://www.tiktok.com/@tiktok" },
        { url: "https://www.tiktok.com/@charlidamelio" },
        { url: "https://www.tiktok.com/@khaby.lame" },
      ]),
    }
  );

  const data = await response.json();
  console.log("Snapshot ID:", data.snapshot_id);
  ```
</CodeGroup>

## Step 5: Verify delivery

Once the collection completes, check your S3 bucket for the delivered file:

```bash theme={null}
aws s3 ls s3://tiktok-scraper-data/tiktok/profiles/
```

You should see a file named with the snapshot ID (e.g., `s_m1a2b3c4d5e6f7g8h.json`).

Download and inspect it:

```bash theme={null}
aws s3 cp s3://tiktok-scraper-data/tiktok/profiles/s_m1a2b3c4d5e6f7g8h.json ./results.json
cat results.json | python -m json.tool | head -20
```

You can also verify delivery status using the [Monitor Delivery API](/api-reference/scrapers/management-apis/monitor-delivery).

## Troubleshooting

<Accordion title="Files not appearing in S3?">
  * Verify the IAM role ARN and external ID are correct
  * Check that the bucket policy allows `s3:PutObject` from Bright Data's account
  * Ensure the bucket region matches your configuration
  * Review delivery status in the Bright Data dashboard under **Logs**
</Accordion>

<Accordion title="Access denied errors?">
  Verify the trust policy on your IAM role includes Bright Data's account (`422310177405`) and your external ID matches your Bright Data customer ID found in [Account settings](https://brightdata.com/cp/setting/customer_details).
</Accordion>

<Accordion title="Delivered file is empty or missing records?">
  Check the collection status in the Bright Data dashboard. If some URLs failed, the delivered file contains only successful results. Retry failed URLs in a separate request.
</Accordion>

## Next steps

<CardGroup>
  <Card title="Set up webhooks" icon="webhook" href="/datasets/scrapers/tiktok/data-delivery/webhooks">
    Receive results at your HTTP endpoint.
  </Card>

  <Card title="All delivery options" icon="truck" href="/datasets/scrapers/scrapers-library/delivery-options">
    Snowflake, Azure, GCS, SFTP, and more.
  </Card>
</CardGroup>


# TikTok data delivery via webhook
Source: https://docs.brightdata.com/datasets/scrapers/tiktok/data-delivery/webhooks

Configure the Bright Data TikTok Scraper API to push scraped profiles, posts and comments to your HTTPS webhook as each job completes across 5 endpoints.

This guide shows you how to set up webhook delivery so your server receives scraped TikTok data automatically when a collection job finishes.

## Prerequisites

* A [Bright Data account](https://brightdata.com/cp/start) with an active API key
* Familiarity with the [async request workflow](/datasets/scrapers/tiktok/async-requests)
* A publicly accessible HTTP endpoint (or a testing tool like [webhook.site](https://webhook.site))

## How webhooks work

When you trigger an async collection with an `endpoint` URL, Bright Data sends a `POST` request to that URL with the scraped data once the job completes. No polling required.

```text theme={null}
Your app --> POST /trigger (with webhook URL) --> Bright Data scrapes --> POST to your webhook
```

## Step 1: Set up a test webhook

For testing, use [webhook.site](https://webhook.site) to get a temporary public URL:

1. Open [webhook.site](https://webhook.site) in your browser
2. Copy the unique URL displayed (e.g., `https://webhook.site/abc-123-def`)
3. Keep the page open to monitor incoming requests

## Step 2: Trigger a collection with the webhook URL

Add the `endpoint` query parameter to your async `/trigger` request:

<CodeGroup>
  ```bash cURL theme={null}
  curl -X POST \
    "https://api.brightdata.com/datasets/v3/trigger?dataset_id=gd_l1villgoiiidt09ci&format=json&endpoint=https://webhook.site/abc-123-def&uncompressed_webhook=true" \
    -H "Authorization: Bearer YOUR_API_KEY" \
    -H "Content-Type: application/json" \
    -d '[
      {"url": "https://www.tiktok.com/@tiktok"},
      {"url": "https://www.tiktok.com/@charlidamelio"}
    ]'
  ```

  ```python Python theme={null}
  import requests

  WEBHOOK_URL = "https://webhook.site/abc-123-def"

  response = requests.post(
      "https://api.brightdata.com/datasets/v3/trigger",
      params={
          "dataset_id": "gd_l1villgoiiidt09ci",
          "format": "json",
          "webhook": WEBHOOK_URL,
          "uncompressed_webhook": "true",
      },
      headers={
          "Authorization": "Bearer YOUR_API_KEY",
          "Content-Type": "application/json",
      },
      json=[
          {"url": "https://www.tiktok.com/@tiktok"},
          {"url": "https://www.tiktok.com/@charlidamelio"},
      ],
  )

  print("Snapshot ID:", response.json()["snapshot_id"])
  ```

  ```javascript Node.js theme={null}
  const WEBHOOK_URL = "https://webhook.site/abc-123-def";

  const response = await fetch(
    `https://api.brightdata.com/datasets/v3/trigger?dataset_id=gd_l1villgoiiidt09ci&format=json&endpoint=${encodeURIComponent(WEBHOOK_URL)}&uncompressed_webhook=true`,
    {
      method: "POST",
      headers: {
        "Authorization": "Bearer YOUR_API_KEY",
        "Content-Type": "application/json",
      },
      body: JSON.stringify([
        { url: "https://www.tiktok.com/@tiktok" },
        { url: "https://www.tiktok.com/@charlidamelio" },
      ]),
    }
  );

  const data = await response.json();
  console.log("Snapshot ID:", data.snapshot_id);
  ```
</CodeGroup>

Key parameters:

| Parameter              | Description                                                  |
| :--------------------- | :----------------------------------------------------------- |
| `endpoint`             | Your HTTP endpoint URL that receives the `POST` payload      |
| `uncompressed_webhook` | Set to `true` to receive uncompressed JSON (default is gzip) |
| `format`               | Output format: `json`, `ndjson`, or `csv`                    |

## Step 3: Verify delivery

Once the collection completes (typically 30-60 seconds for a few profiles), check your webhook.site page. You should see a `POST` request with the scraped data.

The payload is the same JSON array you would receive from a direct API download:

```json theme={null}
[
  {
    "nickname": "TikTok",
    "account_id": "tiktok",
    "followers": 85600000,
    "likes": 520000000,
    "is_verified": true
  },
  {
    "nickname": "Charli D'Amelio",
    "account_id": "charlidamelio",
    "followers": 155000000,
    "likes": 11400000000,
    "is_verified": true
  }
]
```

## Production webhook setup

For production, point the `endpoint` URL to your own server endpoint.

### How to handle webhooks in Express.js

```javascript server.js theme={null}
const express = require("express");
const app = express();

app.use(express.json({ limit: "100mb" }));

app.post("/webhook/tiktok", (req, res) => {
  const profiles = req.body;
  console.log(`Received ${profiles.length} profiles`);

  for (const profile of profiles) {
    console.log(`- ${profile.username} (${profile.followers} followers)`);
  }

  res.status(200).json({ received: true });
});

app.listen(3000, () => console.log("Webhook server running on port 3000"));
```

### How to handle webhooks in Flask

```python server.py theme={null}
from flask import Flask, request, jsonify

app = Flask(__name__)

@app.route("/webhook/tiktok", methods=["POST"])
def handle_webhook():
    profiles = request.get_json()
    print(f"Received {len(profiles)} profiles")

    for profile in profiles:
        print(f"- {profile['username']} ({profile.get('followers')} followers)")

    return jsonify({"received": True}), 200

if __name__ == "__main__":
    app.run(port=3000)
```

<Warning>
  Return a `200` status code within 30 seconds to acknowledge receipt. If your endpoint fails or times out, Bright Data retries delivery.
</Warning>

## Webhook with authorization

If your endpoint requires authentication, add the `webhook_header_Authorization` parameter:

```bash theme={null}
curl -X POST \
  "https://api.brightdata.com/datasets/v3/trigger?dataset_id=gd_l1villgoiiidt09ci&format=json&endpoint=https://your-server.com/webhook&webhook_header_Authorization=Bearer+YOUR_SECRET_TOKEN" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '[{"url": "https://www.tiktok.com/@tiktok"}]'
```

## Allowlist webhook IPs

If your server uses an IP allowlist, add the following Bright Data webhook source IPs:

```text theme={null}
54.175.27.69
34.225.9.175
100.28.38.247
100.29.18.195
52.72.185.255
35.174.112.248
54.165.183.124
3.91.140.7
52.202.75.37
98.82.225.117
100.27.150.189
18.214.10.85
35.169.71.210
44.194.183.74
```

## Troubleshooting

<Accordion title="Webhook not receiving data?">
  * Verify the URL is publicly accessible (not `localhost`)
  * Check that your endpoint returns a `200` status code within 30 seconds
  * Verify the webhook IPs above are allowlisted if you have firewall rules
</Accordion>

<Accordion title="Receiving compressed data?">
  If you omit `uncompressed_webhook=true`, data arrives gzip-compressed. Add `uncompressed_webhook=true` to your trigger URL, or decompress the payload on your server.
</Accordion>

<Accordion title="Payload too large for your server?">
  Large collections can produce payloads up to 1 GB. Set `express.json({ limit: "100mb" })` in Express.js or equivalent in your framework. If you need to handle very large datasets, use [S3 delivery](/datasets/scrapers/tiktok/data-delivery/amazon-s3) instead.
</Accordion>

## Next steps

<CardGroup>
  <Card title="Deliver to Amazon S3" icon="bucket" href="/datasets/scrapers/tiktok/data-delivery/amazon-s3">
    Store results directly in your S3 bucket.
  </Card>

  <Card title="All delivery options" icon="truck" href="/datasets/scrapers/scrapers-library/delivery-options">
    Snowflake, Azure, GCS, and more.
  </Card>
</CardGroup>


# TikTok Scraper API
Source: https://docs.brightdata.com/datasets/scrapers/tiktok/introduction

Extract structured data from TikTok profiles, posts, comments and shop products with the Bright Data [TikTok Scraper API](https://brightdata.com/products/web-scraper/tiktok). Up to 20 URLs per request.

Send a TikTok URL, get structured JSON back. The Bright Data TikTok Scraper API handles proxies, CAPTCHAs, and parsing so you can focus on your data pipeline.

<Tip>
  New to Bright Data? [Create a free account](https://brightdata.com/products/web-scraper/amazon/?hs_signup=1\&utm_source=docs) and get **5,000 free credits every month**, no credit card required. That's up to **5,000 TikTok records** to start scraping. See the [free tier](/general/account/billing-and-pricing/free-tier).
</Tip>

## How it works

You send one or more TikTok URLs to the Bright Data TikTok Scraper API. Bright Data handles the scraping infrastructure and returns clean, structured JSON.

```text theme={null}
Your app  -->  Bright Data API  -->  Structured JSON
           POST /datasets/v3/scrape
           Authorization: Bearer YOUR_API_KEY
```

All requests use a `dataset_id` to specify the data type (profiles, posts, shop, or comments) and return results in JSON, NDJSON, or CSV.

## What the response looks like

```bash theme={null}
curl -X POST "https://api.brightdata.com/datasets/v3/scrape?dataset_id=gd_l1villgoiiidt09ci&format=json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '[{"url": "https://www.tiktok.com/@tiktok"}]'
```

```json theme={null}
{
  "nickname": "TikTok",
  "account_id": "tiktok",
  "biography": "Make your day.",
  "followers": 85600000,
  "following": 580,
  "likes": 520000000,
  "videos_count": 1250,
  "is_verified": true,
  "url": "https://www.tiktok.com/@tiktok",
  "profile_pic_url": "https://..."
}
```

## Supported data types

<CardGroup>
  <Card title="Profiles" icon="user" href="/api-reference/scrapers/social-media-apis/tiktok-profiles-collect-by-url">
    Follower counts, bios, verification status, likes, and video counts. Discover profiles by search URL.
  </Card>

  <Card title="Posts" icon="video" href="/api-reference/scrapers/social-media-apis/tiktok-posts-collect-by-url">
    Captions, likes, comments, shares, views, hashtags, and video URLs. Discover posts by keyword or profile URL.
  </Card>

  <Card title="TikTok Shop" icon="store" href="/api-reference/scrapers/social-media-apis/tiktok-shop-collect-by-url">
    Product names, prices, ratings, reviews, and seller details. Discover products by category, keyword, or shop.
  </Card>

  <Card title="Comments" icon="comments" href="/api-reference/scrapers/social-media-apis/tiktok-comments-collect-by-url">
    Comment text, likes, replies, and commenter details for any post.
  </Card>

  <Card title="Posts by Profile Fast API" icon="bolt" href="/api-reference/scrapers/social-media-apis/tiktok-posts-by-profile-fast-api-collect-by-url">
    Quickly collect all posts from a specific TikTok profile URL.
  </Card>
</CardGroup>

## Request methods

The Bright Data TikTok Scraper API supports two request methods. Choose based on your volume and latency needs.

| Method           | Endpoint                                                  | Best for                                   |
| :--------------- | :-------------------------------------------------------- | :----------------------------------------- |
| **Synchronous**  | [`/scrape`](/datasets/scrapers/tiktok/send-first-request) | Real-time lookups, up to 20 URLs           |
| **Asynchronous** | [`/trigger`](/datasets/scrapers/tiktok/async-requests)    | Batch jobs, 20+ URLs, production pipelines |

Learn more in [Understanding sync vs. async requests](/datasets/scrapers/concepts/sync-vs-async).

## Capabilities and limits

| Capability                     | Detail                                                                                                                                                                                                                                 |
| :----------------------------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Output formats**             | JSON, NDJSON, CSV                                                                                                                                                                                                                      |
| **Max URLs per sync request**  | 20                                                                                                                                                                                                                                     |
| **Max URLs per async request** | 5,000                                                                                                                                                                                                                                  |
| **Data freshness**             | Real-time (scraped on demand)                                                                                                                                                                                                          |
| **Delivery options**           | API download, [Webhook](/datasets/scrapers/tiktok/data-delivery/webhooks), [Amazon S3](/datasets/scrapers/tiktok/data-delivery/amazon-s3), Snowflake, Azure, GCS ([all options](/datasets/scrapers/scrapers-library/delivery-options)) |
| **Pricing**                    | Pay per successful record ([see pricing](https://brightdata.com/pricing/web-scraper))                                                                                                                                                  |

## Common questions

<Accordion title="Is the data scraped in real time?">
  Yes. Each request triggers a live scrape. There is no cached or stale data. Response times vary by endpoint: profiles typically return in 10-30 seconds (sync), while discovery requests may take longer depending on result volume.
</Accordion>

<Accordion title="What is the difference between URL collection and discovery?">
  **URL collection** scrapes a specific TikTok page you provide (e.g., a profile URL). **Discovery** finds TikTok content matching search criteria (e.g., all posts containing a keyword) and scrapes the results. Discovery is only available via async requests.
</Accordion>

<Accordion title="How is this different from scraping using proxies or Web Unlocker?">
  When scraping using proxies or Web Unlocker, you still need to write and maintain your own parsing logic and update it whenever TikTok changes its page structure. The TikTok Scraper API handles the entire stack: proxy rotation, anti-bot bypassing and parsing. You simply send a TikTok URL and get clean, structured JSON back with no scraping infrastructure or parser maintenance required on your end.
</Accordion>

## Next steps

<CardGroup>
  <Card title="Quickstart" icon="rocket" href="/datasets/scrapers/tiktok/quickstart">
    Scrape your first TikTok profile in 5 minutes.
  </Card>

  <Card title="Send your first request" icon="bolt" href="/datasets/scrapers/tiktok/send-first-request">
    Full code examples in cURL, Python, and Node.js.
  </Card>

  <Card title="API reference" icon="code" href="/api-reference/scrapers/social-media-apis/tiktok-profiles-collect-by-url">
    Endpoint specs, parameters, and response schemas.
  </Card>
</CardGroup>


# TikTok scraper quickstart
Source: https://docs.brightdata.com/datasets/scrapers/tiktok/quickstart

Set up the Bright Data TikTok Scraper API and collect your first profile, post or shop record as structured JSON in under 5 minutes from the Control Panel.

This tutorial shows you how to scrape a TikTok profile and get structured JSON data using the Bright Data TikTok Scraper API.

## Prerequisites

* A [Bright Data account](https://brightdata.com/cp/start) (includes \$2 free credit)
* cURL, Python 3, or Node.js 18+ installed

<Steps>
  <Step title="Get your API key">
    Go to the [user settings page](https://brightdata.com/cp/setting/users) in your Bright Data account and copy your API key.

    If you don't have an account yet, [sign up at brightdata.com](https://brightdata.com/cp/start). New users get \$2 free credit for testing.

    <Warning>
      Your API key is shown only once when created. Copy and store it securely.
    </Warning>
  </Step>

  <Step title="Send a request">
    We'll use the **Profiles endpoint** with a synchronous request. Replace `YOUR_API_KEY` with your actual token:

    <CodeGroup>
      ```bash cURL theme={null}
      curl -X POST \
        "https://api.brightdata.com/datasets/v3/scrape?dataset_id=gd_l1villgoiiidt09ci&format=json" \
        -H "Authorization: Bearer YOUR_API_KEY" \
        -H "Content-Type: application/json" \
        -d '[{"url": "https://www.tiktok.com/@tiktok"}]'
      ```

      ```python Python theme={null}
      import requests

      response = requests.post(
          "https://api.brightdata.com/datasets/v3/scrape",
          params={"dataset_id": "gd_l1villgoiiidt09ci", "format": "json"},
          headers={
              "Authorization": "Bearer YOUR_API_KEY",
              "Content-Type": "application/json",
          },
          json=[{"url": "https://www.tiktok.com/@tiktok"}],
      )

      print(response.json())
      ```

      ```javascript Node.js theme={null}
      const response = await fetch(
        "https://api.brightdata.com/datasets/v3/scrape?dataset_id=gd_l1villgoiiidt09ci&format=json",
        {
          method: "POST",
          headers: {
            "Authorization": "Bearer YOUR_API_KEY",
            "Content-Type": "application/json",
          },
          body: JSON.stringify([
            { url: "https://www.tiktok.com/@tiktok" }
          ]),
        }
      );

      const data = await response.json();
      console.log(data);
      ```
    </CodeGroup>

    You should see a `200` status code. This takes 10-30 seconds.
  </Step>

  <Step title="Review the response">
    The Bright Data TikTok Scraper API returns a JSON array with structured profile data:

    ```json theme={null}
    [
      {
        "nickname": "TikTok",
        "account_id": "tiktok",
        "biography": "Make your day.",
        "followers": 85600000,
        "following": 580,
        "likes": 520000000,
        "videos_count": 1250,
        "is_verified": true,
        "url": "https://www.tiktok.com/@tiktok"
      }
    ]
    ```

    Each profile object includes fields covering follower counts, bio, verification status, and more. See the [full response schema](/api-reference/scrapers/social-media-apis/tiktok-profiles-collect-by-url).
  </Step>
</Steps>

You've successfully scraped your first TikTok profile using the Bright Data TikTok Scraper API.

## Common questions

<Accordion title="Can I scrape multiple profiles in one request?">
  Yes. Add more objects to the input array. Synchronous requests support up to 20 URLs. For larger batches, use the [async `/trigger` endpoint](/datasets/scrapers/tiktok/async-requests).

  ```json theme={null}
  [
    {"url": "https://www.tiktok.com/@tiktok"},
    {"url": "https://www.tiktok.com/@charlidamelio"},
    {"url": "https://www.tiktok.com/@khaby.lame"}
  ]
  ```
</Accordion>

<Accordion title="Getting a 401 or 403 error?">
  Verify your API key is correct and hasn't expired. Generate a new token from [Account settings](https://brightdata.com/cp/setting/users). See the [authentication guide](/api-reference/authentication) for details.
</Accordion>

<Accordion title="Request is timing out?">
  Synchronous requests have a 1-minute timeout. If the request exceeds this limit, it automatically switches to async and returns a `snapshot_id`. Use the [async workflow](/datasets/scrapers/tiktok/async-requests) for large batches.
</Accordion>

<Accordion title="Empty or partial response data?">
  Verify the TikTok profile URL is publicly accessible and correctly formatted. The URL should follow the pattern `https://www.tiktok.com/@username`.
</Accordion>

## Next steps

<CardGroup>
  <Card title="Send your first request" icon="bolt" href="/datasets/scrapers/tiktok/send-first-request">
    Explore all five endpoint types with full examples.
  </Card>

  <Card title="Async batch requests" icon="layer-group" href="/datasets/scrapers/tiktok/async-requests">
    Scrape hundreds of URLs in a single batch job.
  </Card>

  <Card title="Set up webhooks" icon="webhook" href="/datasets/scrapers/tiktok/data-delivery/webhooks">
    Receive results automatically when scraping completes.
  </Card>
</CardGroup>


# Send your first TikTok API request
Source: https://docs.brightdata.com/datasets/scrapers/tiktok/send-first-request

Send synchronous requests to all 5 Bright Data TikTok Scraper API endpoints with copy-paste examples for profiles, posts, comments and shop data.

This tutorial walks you through sending a synchronous request to each Bright Data TikTok Scraper API endpoint. By the end, you'll have working examples for profiles, posts, TikTok Shop, comments, and posts by profile.

## Prerequisites

* A [Bright Data account](https://brightdata.com/cp/start) with an active API key
* Completed the [Quickstart](/datasets/scrapers/tiktok/quickstart)

## Request structure

Every synchronous request follows the same pattern:

```http theme={null}
POST https://api.brightdata.com/datasets/v3/scrape?dataset_id={DATASET_ID}&format=json
Authorization: Bearer YOUR_API_KEY
Content-Type: application/json

[{"url": "https://www.tiktok.com/..."}]
```

The only thing that changes between endpoints is the `dataset_id` and the input URL format.

<Note>
  Synchronous requests support up to 20 URLs and have a 1-minute timeout. If the request takes longer, the API automatically returns a `snapshot_id` instead. See [async requests](/datasets/scrapers/tiktok/async-requests).
</Note>

## How to scrape TikTok profiles

**Dataset ID:** `gd_l1villgoiiidt09ci`

```bash theme={null}
curl -X POST \
  "https://api.brightdata.com/datasets/v3/scrape?dataset_id=gd_l1villgoiiidt09ci&format=json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '[{"url": "https://www.tiktok.com/@tiktok"}]'
```

You should see a `200` response. This takes 10-30 seconds.

<Accordion title="Example response">
  ```json theme={null}
  [
    {
      "nickname": "TikTok",
      "account_id": "tiktok",
      "biography": "Make your day.",
      "followers": 85600000,
      "following": 580,
      "likes": 520000000,
      "videos_count": 1250,
      "is_verified": true,
      "url": "https://www.tiktok.com/@tiktok",
      "profile_pic_url": "https://..."
    }
  ]
  ```
</Accordion>

[Full Profiles response schema](/api-reference/scrapers/social-media-apis/tiktok-profiles-collect-by-url)

## How to scrape TikTok posts

**Dataset ID:** `gd_lu702nij2f790tmv9h`

```bash theme={null}
curl -X POST \
  "https://api.brightdata.com/datasets/v3/scrape?dataset_id=gd_lu702nij2f790tmv9h&format=json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '[{"url": "https://www.tiktok.com/@tiktok/video/7345678901234567890"}]'
```

<Accordion title="Example response">
  ```json theme={null}
  [
    {
      "url": "https://www.tiktok.com/@tiktok/video/7345678901234567890",
      "author": "tiktok",
      "description": "Making every moment count #fyp #trending",
      "likes": 245000,
      "comments": 3200,
      "shares": 18500,
      "views": 5200000,
      "date_posted": "2024-04-10T15:30:00.000Z",
      "hashtags": ["fyp", "trending"],
      "video_url": "https://..."
    }
  ]
  ```
</Accordion>

[Full Posts response schema](/api-reference/scrapers/social-media-apis/tiktok-posts-collect-by-url)

## How to scrape TikTok Shop

**Dataset ID:** `gd_m45m1u911dsa4274pi`

```bash theme={null}
curl -X POST \
  "https://api.brightdata.com/datasets/v3/scrape?dataset_id=gd_m45m1u911dsa4274pi&format=json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '[{"url": "https://www.tiktok.com/@shop/product/1234567890"}]'
```

<Accordion title="Example response">
  ```json theme={null}
  [
    {
      "url": "https://www.tiktok.com/@shop/product/1234567890",
      "product_name": "Wireless Bluetooth Earbuds",
      "price": 29.99,
      "currency": "USD",
      "rating": 4.7,
      "reviews_count": 1850,
      "seller_name": "TechStore Official",
      "category": "Electronics"
    }
  ]
  ```
</Accordion>

[Full TikTok Shop response schema](/api-reference/scrapers/social-media-apis/tiktok-shop-collect-by-url)

## How to scrape TikTok comments

**Dataset ID:** `gd_lkf2st302ap89utw5k`

```bash theme={null}
curl -X POST \
  "https://api.brightdata.com/datasets/v3/scrape?dataset_id=gd_lkf2st302ap89utw5k&format=json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '[{"url": "https://www.tiktok.com/@tiktok/video/7345678901234567890"}]'
```

<Accordion title="Example response">
  ```json theme={null}
  [
    {
      "url": "https://www.tiktok.com/@tiktok/video/7345678901234567890",
      "comment_user": "creator_fan",
      "comment_user_url": "https://www.tiktok.com/@creator_fan",
      "comment_date": "2024-04-11T08:15:00.000Z",
      "comment": "This is amazing content!",
      "likes": 42,
      "replies": 3
    }
  ]
  ```
</Accordion>

[Full Comments response schema](/api-reference/scrapers/social-media-apis/tiktok-comments-collect-by-url)

## Posts by Profile Fast API

**Dataset ID:** `gd_m7n5v2gq296pex2f5m`

```bash theme={null}
curl -X POST \
  "https://api.brightdata.com/datasets/v3/scrape?dataset_id=gd_m7n5v2gq296pex2f5m&format=json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '[{"url": "https://www.tiktok.com/@tiktok"}]'
```

<Accordion title="Example response">
  ```json theme={null}
  [
    {
      "url": "https://www.tiktok.com/@tiktok/video/7345678901234567890",
      "author": "tiktok",
      "description": "Making every moment count #fyp",
      "likes": 245000,
      "comments": 3200,
      "shares": 18500,
      "views": 5200000,
      "date_posted": "2024-04-10T15:30:00.000Z"
    },
    {
      "url": "https://www.tiktok.com/@tiktok/video/7345678901234567891",
      "author": "tiktok",
      "description": "New feature alert! #tiktok #newfeature",
      "likes": 180000,
      "comments": 2100,
      "shares": 9500,
      "views": 3800000,
      "date_posted": "2024-04-08T12:00:00.000Z"
    }
  ]
  ```
</Accordion>

[Full Posts by Profile Fast API response schema](/api-reference/scrapers/social-media-apis/tiktok-posts-by-profile-fast-api-collect-by-url)

## Quick reference: dataset IDs

| Endpoint                  | Dataset ID              | URL pattern                         |
| :------------------------ | :---------------------- | :---------------------------------- |
| Profiles                  | `gd_l1villgoiiidt09ci`  | `tiktok.com/@{username}`            |
| Posts                     | `gd_lu702nij2f790tmv9h` | `tiktok.com/@{username}/video/{id}` |
| TikTok Shop               | `gd_m45m1u911dsa4274pi` | `tiktok.com/@shop/product/{id}`     |
| Comments                  | `gd_lkf2st302ap89utw5k` | `tiktok.com/@{username}/video/{id}` |
| Posts by Profile Fast API | `gd_m7n5v2gq296pex2f5m` | `tiktok.com/@{username}`            |

## Output formats

Control the response format with the `format` query parameter:

| Value    | Description                                 |
| :------- | :------------------------------------------ |
| `json`   | JSON array (default)                        |
| `ndjson` | Newline-delimited JSON, one record per line |
| `csv`    | Comma-separated values                      |

## Next steps

<CardGroup>
  <Card title="Async batch requests" icon="layer-group" href="/datasets/scrapers/tiktok/async-requests">
    Scrape hundreds of URLs in a single batch job.
  </Card>

  <Card title="API reference" icon="code" href="/api-reference/scrapers/social-media-apis/tiktok-profiles-collect-by-url">
    Full parameter and response field reference.
  </Card>
</CardGroup>


# Build a daily Amazon price monitor
Source: https://docs.brightdata.com/datasets/scrapers/tutorials/amazon-price-monitor

Schedule a daily Amazon SKU scrape with the Bright Data Amazon Scraper API, delivered to S3 and orchestrated by a GitHub Actions cron workflow.

You track prices and stock on a list of Amazon SKUs and you need fresh numbers every morning before your team starts work. You don't want to run a server just for this. You don't want to babysit a cron job on a laptop.

In this tutorial we'll build exactly that pipeline. You'll commit a SKU list to a GitHub repo, write a small Python script that triggers the Bright Data Amazon Scraper API against it, wrap the script in a GitHub Actions workflow that runs on a daily cron, and configure Bright Data to deliver the results directly to an S3 bucket. Each morning a fresh JSON file lands in S3, keyed by snapshot ID, ready for your BI pipeline to pick up.

No servers, no webhook handlers, no glue code. Just a workflow file, a script and a delivery config.

## What you'll build

A GitHub repository containing:

1. A `skus.json` file listing the Amazon product URLs to monitor
2. A Python script that POSTs the SKU list to the Bright Data Amazon Scraper API
3. A GitHub Actions workflow that runs the script on a daily schedule
4. Bright Data configured to deliver each snapshot to your S3 bucket

By the end, you'll see a new JSON file in S3 every day, each containing fresh price, rating and availability data for every SKU on the list.

**Estimated time:** 30 minutes.

## Prerequisites

* A [Bright Data account](https://brightdata.com/cp/start) with an API key ([get your key](https://brightdata.com/cp/setting/users))
* An S3 bucket with Bright Data delivery already configured. Follow [Amazon to S3 delivery](/datasets/scrapers/amazon/data-delivery/amazon-s3) once, then come back. This tutorial assumes the delivery destination is already saved in your Amazon scraper's settings.
* A [GitHub account](https://github.com/signup) and a new (empty) repository
* Python 3.9+ installed locally
* Git installed locally

## Part 1: Create the SKU list

Clone your empty GitHub repo locally and create a `skus.json` file at the repo root:

```json skus.json theme={null}
[
  "https://www.amazon.com/dp/B0D1XD1ZV3",
  "https://www.amazon.com/dp/B0863TXGM3",
  "https://www.amazon.com/dp/B09V3KXJPB"
]
```

These are three real product URLs (AirPods Pro 2, Sony WH-1000XM4 headphones and iPad Air M1). Swap them for your own SKUs later.

<Tip>
  Keeping the SKU list in the repo means every edit is version-controlled and every change ships through normal pull-request review. Large SKU lists can live in a CSV loaded by the script instead, we'll mention that in "Next steps."
</Tip>

## Part 2: Write the trigger script

Create `trigger_scrape.py` at the repo root:

```python trigger_scrape.py theme={null}
import json
import os
import sys

import requests

DATASET_ID = "gd_l7q7dkf244hwjntr0"  # Amazon products by URL
TRIGGER_URL = "https://api.brightdata.com/datasets/v3/trigger"


def main() -> int:
    api_key = os.environ.get("BRIGHT_DATA_API_KEY")
    if not api_key:
        print("BRIGHT_DATA_API_KEY environment variable is not set.")
        return 1

    with open("skus.json") as f:
        urls = json.load(f)

    payload = [{"url": url} for url in urls]

    response = requests.post(
        TRIGGER_URL,
        params={"dataset_id": DATASET_ID, "format": "json"},
        headers={
            "Authorization": f"Bearer {api_key}",
            "Content-Type": "application/json",
        },
        json=payload,
        timeout=30,
    )
    response.raise_for_status()

    snapshot_id = response.json().get("snapshot_id")
    print(f"Triggered scrape for {len(urls)} SKUs. Snapshot: {snapshot_id}")
    return 0


if __name__ == "__main__":
    sys.exit(main())
```

Then create `requirements.txt`:

```text theme={null}
requests==2.32.3
```

Two things worth noticing:

* **The script does not wait for results.** It fires the trigger and exits. Bright Data runs the scrape asynchronously and delivers the results directly to S3 via the delivery config you saved in your scraper settings. That's the whole point: the script is a cheap, stateless trigger.
* **The API key comes from an environment variable.** Never commit keys to a repo. We'll wire this to GitHub Actions Secrets in Part 4.

## Part 3: Run it locally

Install the dependency and run the script with your key:

```bash theme={null}
pip install -r requirements.txt
export BRIGHT_DATA_API_KEY=your_actual_key_here
python trigger_scrape.py
```

You should see output like:

```text theme={null}
Triggered scrape for 3 SKUs. Snapshot: sd_mntfmunq1yy7gi201q
```

Wait 60 to 90 seconds, then check your S3 bucket:

```bash theme={null}
aws s3 ls s3://your-bucket-name/amazon/products/
```

You should see a new file named with the snapshot ID:

```text theme={null}
2026-04-10 09:14:22   14382 sd_mntfmunq1yy7gi201q.json
```

Download it and inspect one record:

```bash theme={null}
aws s3 cp s3://your-bucket-name/amazon/products/sd_mntfmunq1yy7gi201q.json ./latest.json
python -m json.tool latest.json | head -30
```

You should see structured product data for each SKU:

```json theme={null}
[
  {
    "title": "Sony WH-1000XM4 Wireless Premium Noise Canceling Overhead Headphones",
    "asin": "B0863TXGM3",
    "brand": "Sony",
    "final_price": 209.99,
    "currency": "USD",
    "rating": 4.6,
    "reviews_count": 62492,
    "availability": "Only 1 left in stock - order soon.",
    "url": "https://www.amazon.com/dp/B0863TXGM3"
  }
]
```

<Note>
  The price field is `final_price`, and it can be `null` for products that are out of stock or currency-ambiguous listings. Your BI pipeline should handle that case explicitly rather than crashing on a missing key.
</Note>

Notice that the file is keyed by `snapshot_id`, not by date. That's deliberate: each snapshot is immutable, and you can walk the bucket chronologically by listing creation timestamps or by enabling versioning. We'll discuss naming conventions in "Next steps."

## Part 4: Schedule the workflow on GitHub Actions

Now let's move the trigger off your laptop and onto a daily schedule.

Create `.github/workflows/daily-scrape.yml`:

```yaml .github/workflows/daily-scrape.yml theme={null}
name: Daily Amazon price scrape

on:
  schedule:
    - cron: "0 6 * * *"   # 06:00 UTC every day
  workflow_dispatch:        # Allows manual runs from the Actions tab

jobs:
  trigger:
    runs-on: ubuntu-latest
    steps:
      - name: Check out the repo
        uses: actions/checkout@v4

      - name: Set up Python
        uses: actions/setup-python@v5
        with:
          python-version: "3.11"

      - name: Install dependencies
        run: pip install -r requirements.txt

      - name: Trigger Bright Data scrape
        env:
          BRIGHT_DATA_API_KEY: ${{ secrets.BRIGHT_DATA_API_KEY }}
        run: python trigger_scrape.py
```

Two key elements:

* **`schedule: cron: "0 6 * * *"`** runs the job at 06:00 UTC every day. Adjust the cron expression for your timezone. GitHub's scheduled workflows have no guaranteed precision, but daily runs typically fire within a few minutes of the scheduled time.
* **`workflow_dispatch`** adds a **Run workflow** button in the Actions tab so you can kick off the job on demand without waiting for the schedule.

Now add your Bright Data key as a repo secret:

1. In your GitHub repo, go to **Settings** > **Secrets and variables** > **Actions**
2. Click **New repository secret**
3. Name it `BRIGHT_DATA_API_KEY` and paste your key
4. Click **Add secret**

<Warning>
  Treat your Bright Data API key like a password. Never commit it to the repo, never paste it into workflow logs, and rotate it if you suspect it's been exposed.
</Warning>

## Part 5: Push and verify

Commit everything and push:

```bash theme={null}
git add skus.json trigger_scrape.py requirements.txt .github/workflows/daily-scrape.yml
git commit -m "Add daily Amazon price monitor"
git push
```

Open your repo on GitHub and go to the **Actions** tab. You should see the **Daily Amazon price scrape** workflow listed.

Click **Run workflow** > **Run workflow** to kick it off manually. Within a few seconds a new run appears. Click into it and watch the steps execute. The final step should log:

```text theme={null}
Triggered scrape for 3 SKUs. Snapshot: sd_mntfn4abcdefghij
```

Wait a minute, then check S3 again:

```bash theme={null}
aws s3 ls s3://your-bucket-name/amazon/products/
```

You should now see two snapshot files, the one from Part 3 and the one from the workflow run.

From here, GitHub Actions will run the workflow every day at the scheduled time, and a fresh file will appear in S3 each morning. No server, no cron job, no babysitting.

## Congratulations

You've built a fully automated daily price monitor:

* A **SKU list** version-controlled in GitHub
* A **Python trigger script** that fires the Bright Data scrape and exits
* A **GitHub Actions workflow** that runs on a daily cron and authenticates via a repo secret
* **Bright Data S3 delivery** that drops each snapshot into your bucket asynchronously

Every moving part is declarative and in the repo. Editing the SKU list, the cron schedule or the destination is a one-line pull request.

## Next steps

<CardGroup>
  <Card title="Stream large snapshots" icon="arrow-down-to-line" href="/datasets/scrapers/scrapers-library/stream-and-file-delivery">
    Use `stream_max_lines` to start receiving batches as soon as the first records are ready.
  </Card>

  <Card title="Amazon async reference" icon="layer-group" href="/datasets/scrapers/amazon/async-requests">
    Full parameter list for the async trigger endpoint, including `include_errors` and `limit_per_input`.
  </Card>

  <Card title="Monitor delivery status" icon="magnifying-glass-chart" href="/api-reference/scrapers/management-apis/monitor-delivery">
    Programmatically check snapshot status and delivery result from inside the workflow.
  </Card>

  <Card title="All delivery options" icon="truck" href="/datasets/scrapers/scrapers-library/delivery-options">
    Swap S3 for GCS, Azure, Snowflake or SFTP with the same trigger call.
  </Card>
</CardGroup>


# Send LinkedIn profiles to your CRM
Source: https://docs.brightdata.com/datasets/scrapers/tutorials/linkedin-to-crm

Build a pipeline that scrapes LinkedIn profiles with Bright Data and delivers CRM-ready contact records to a Next.js 14 webhook handler deployed on Vercel.

You want to enrich inbound leads automatically. A signup form gives you a LinkedIn URL, and a minute later a contact record with job title, company, location and follower count lands in your CRM. No manual copy-paste, no Zapier-style glue code.

In this tutorial we'll build that pipeline end-to-end. You'll deploy a tiny Next.js webhook handler to Vercel, trigger the Bright Data LinkedIn Scraper API against a handful of profile URLs and watch mapped contact records appear in your Vercel logs within a minute.

We stop at the mapped object. Sending it to a specific CRM is a one-line fetch call we'll sketch out at the end.

## What you'll build

A Next.js API route deployed on Vercel that:

1. Accepts a POST from Bright Data containing a JSON array of scraped LinkedIn profiles
2. Maps each profile into a normalized CRM-shaped contact record
3. Logs the mapped records so you can inspect them in the Vercel dashboard

You'll then trigger a scrape from your terminal pointed at your deployed Vercel URL, and see two profiles get mapped and logged end-to-end.

**Estimated time:** 25 minutes.

## Prerequisites

* A [Bright Data account](https://brightdata.com/cp/start) with an API key ([get your key](https://brightdata.com/cp/setting/users))
* A free [Vercel account](https://vercel.com/signup)
* Node.js 18+ installed locally
* The [Vercel CLI](https://vercel.com/docs/cli) installed: `npm install -g vercel`

## Part 1: Scaffold the Next.js project

In a new terminal, create a minimal Next.js project:

```bash theme={null}
npx create-next-app@latest linkedin-to-crm
```

Accept all defaults. You'll get a working Next.js 14+ project with the App Router. Then move into it:

```bash theme={null}
cd linkedin-to-crm
```

## Part 2: Add the webhook route

Create the file `app/api/webhook/linkedin/route.ts`:

```typescript app/api/webhook/linkedin/route.ts theme={null}
export async function POST(request: Request) {
  const profiles = await request.json();
  console.log(`Received ${profiles.length} profiles from Bright Data`);

  for (const profile of profiles) {
    console.log(`- ${profile.name} (${profile.position})`);
  }

  return Response.json({ received: profiles.length });
}
```

That's the whole receiver. Next.js App Router treats any `route.ts` file as an API endpoint, so this file alone gives you a working `POST /api/webhook/linkedin` route once deployed.

## Part 3: Deploy to Vercel

From the project root:

```bash theme={null}
vercel
```

The first run walks you through login and project creation. Accept the defaults. After a minute you should see output ending with:

```text theme={null}
Production: https://linkedin-to-crm-<hash>.vercel.app
```

Copy that URL. Your webhook endpoint is:

```http theme={null}
https://linkedin-to-crm-<hash>.vercel.app/api/webhook/linkedin
```

<Tip>
  Open your project in the [Vercel dashboard](https://vercel.com/dashboard) and keep the **Logs** tab visible. That's where your `console.log` output will appear when Bright Data POSTs to the endpoint.
</Tip>

## Part 4: Trigger the scrape

Open a second terminal and trigger the Bright Data LinkedIn scraper, pointing it at your Vercel URL:

```bash theme={null}
curl -X POST \
  "https://api.brightdata.com/datasets/v3/trigger?dataset_id=gd_l1viktl72bvl7bjuj0&format=json&uncompressed_webhook=true&endpoint=https://linkedin-to-crm-<hash>.vercel.app/api/webhook/linkedin" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '[
    {"url": "https://www.linkedin.com/in/satyanadella"},
    {"url": "https://www.linkedin.com/in/jeffweiner08"}
  ]'
```

Replace `YOUR_API_KEY` with your Bright Data API key and `linkedin-to-crm-<hash>` with your actual Vercel URL.

You should see a response like this immediately:

```json theme={null}
{"snapshot_id":"sd_mntfn0zq7xj0zeay"}
```

The scrape runs asynchronously. You don't need to do anything with the `snapshot_id`. Bright Data POSTs the results to your Vercel endpoint when the job finishes. For two profiles, that usually takes 30 to 60 seconds.

Switch to the Vercel **Logs** tab. Within a minute you should see something like:

```text theme={null}
Received 2 profiles from Bright Data
- Satya Nadella (Chairman and CEO at Microsoft)
- Jeff Weiner (Executive Chairman at LinkedIn)
```

Notice that both profiles arrive in a single POST. Bright Data delivers the whole snapshot in one request, not one profile at a time.

## Part 5: Map profiles to a CRM shape

Right now the handler just logs names and positions. Real CRMs expect contact records with specific field names: `full_name`, `job_title`, `company`, and so on. Let's normalize the Bright Data payload into that shape.

Replace `app/api/webhook/linkedin/route.ts` with:

```typescript app/api/webhook/linkedin/route.ts theme={null}
type BrightDataProfile = {
  name?: string;
  position?: string;
  current_company?: { name?: string };
  country_code?: string;
  city?: string;
  followers?: number;
  url: string;
};

type CrmContact = {
  full_name: string | null;
  job_title: string | null;
  company: string | null;
  country: string | null;
  city: string | null;
  linkedin_url: string;
  follower_count: number;
};

function mapToCrmContact(profile: BrightDataProfile): CrmContact {
  return {
    full_name: profile.name ?? null,
    job_title: profile.position ?? null,
    company: profile.current_company?.name ?? null,
    country: profile.country_code ?? null,
    city: profile.city ?? null,
    linkedin_url: profile.url,
    follower_count: profile.followers ?? 0,
  };
}

export async function POST(request: Request) {
  const profiles: BrightDataProfile[] = await request.json();
  console.log(`Received ${profiles.length} profiles from Bright Data`);

  const contacts = profiles.map(mapToCrmContact);

  for (const contact of contacts) {
    console.log(JSON.stringify(contact, null, 2));
  }

  // Next step: POST each contact to your CRM.
  // Example for HubSpot:
  //   await fetch("https://api.hubapi.com/crm/v3/objects/contacts", {
  //     method: "POST",
  //     headers: {
  //       Authorization: `Bearer ${process.env.HUBSPOT_TOKEN}`,
  //       "Content-Type": "application/json",
  //     },
  //     body: JSON.stringify({ properties: contact }),
  //   });

  return Response.json({ received: contacts.length });
}
```

Redeploy:

```bash theme={null}
vercel --prod
```

Re-run the same curl command from Part 4. This time your Vercel logs should show two complete mapped contacts:

```json theme={null}
Received 2 profiles from Bright Data
{
  "full_name": "Satya Nadella",
  "job_title": "Chairman and CEO at Microsoft",
  "company": "Microsoft",
  "country": "US",
  "city": "Redmond",
  "linkedin_url": "https://www.linkedin.com/in/satyanadella",
  "follower_count": 10842560
}
{
  "full_name": "Jeff Weiner",
  "job_title": "Executive Chairman at LinkedIn",
  "company": "Next Chapter",
  "country": "US",
  "city": "San Francisco Bay Area",
  "linkedin_url": "https://www.linkedin.com/in/jeffweiner08",
  "follower_count": 1200000
}
```

Each object in that log is a complete CRM-ready contact. Sending it to your CRM is a single fetch call. The commented-out block in the handler sketches the HubSpot version. Swap the URL and header for Salesforce, Pipedrive or whatever you use.

## Securing the webhook

Right now anyone who guesses your Vercel URL could POST fake profile data to it. Before you pipe live data into a real CRM, lock down the endpoint.

Bright Data's trigger call accepts a `webhook_header_Authorization` query parameter, which gets forwarded as the `Authorization` header on the webhook POST:

```bash theme={null}
curl -X POST \
  "https://api.brightdata.com/datasets/v3/trigger?dataset_id=gd_l1viktl72bvl7bjuj0&format=json&uncompressed_webhook=true&endpoint=https://linkedin-to-crm-<hash>.vercel.app/api/webhook/linkedin&webhook_header_Authorization=Bearer+YOUR_SHARED_SECRET" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '[{"url": "https://www.linkedin.com/in/satyanadella"}]'
```

Then verify that header in the handler before processing:

```typescript theme={null}
export async function POST(request: Request) {
  const auth = request.headers.get("authorization");
  if (auth !== `Bearer ${process.env.WEBHOOK_SECRET}`) {
    return new Response("Unauthorized", { status: 401 });
  }

  const profiles = await request.json();
  // ...rest of the handler
}
```

Set `WEBHOOK_SECRET` as an environment variable in your Vercel project settings, then redeploy.

<Note>
  Bright Data also publishes a list of webhook source IPs you can allowlist. See [Allowlist webhook IPs](/datasets/scrapers/linkedin/data-delivery/webhooks#allowlist-webhook-ips) in the webhook reference.
</Note>

## Congratulations

You've built an end-to-end pipeline that scrapes LinkedIn profiles and delivers CRM-ready contact records to your own server:

* A **Next.js API route** deployed on Vercel that receives Bright Data webhooks
* A **mapper function** that normalizes Bright Data's profile schema into a CRM-shaped contact
* A **trigger call** that fires the scrape asynchronously and tells Bright Data exactly where to send the results

The final hop, POSTing each mapped contact to HubSpot, Salesforce or your own CRM, is a single fetch call that the commented-out block in `route.ts` sketches.

## Next steps

<CardGroup>
  <Card title="Async batch requests" icon="layer-group" href="/datasets/scrapers/linkedin/async-requests">
    Scrape hundreds of URLs in a single batch job.
  </Card>

  <Card title="Amazon S3 delivery" icon="bucket" href="/datasets/scrapers/linkedin/data-delivery/amazon-s3">
    Swap the webhook for an S3 bucket when payloads exceed Vercel's 4.5 MB body limit.
  </Card>

  <Card title="Webhook reference" icon="webhook" href="/datasets/scrapers/linkedin/data-delivery/webhooks">
    Full parameter list, auth headers and IP allowlist.
  </Card>

  <Card title="HubSpot Contacts API" icon="hubspot" href="https://developers.hubspot.com/docs/api/crm/contacts">
    Drop-in replacement for the commented POST in the handler.
  </Card>
</CardGroup>


# Build a keyword social listener
Source: https://docs.brightdata.com/datasets/scrapers/tutorials/social-listener

Build a keyword social listener with Bright Data SERP API (31 languages) and social scrapers. Discover Instagram, TikTok and X posts, then collect full data.

You want to know when a keyword (a brand name, a product, a competitor) shows up in a post on Instagram, TikTok or X. You don't have the URLs in advance, so you can't just hand a list to a scraper. You need a discovery step first.

In this tutorial we'll build that discovery pipeline with one Python script. You'll use the Bright Data **SERP API** in `parsed_light` mode to run `site:instagram.com "your keyword"` style queries, take the top 10 organic links from each response, classify them by platform and fire the matching social scraper asynchronously. At the end you'll have one snapshot per platform, ready to be delivered to S3 or a webhook.

We stop at the trigger step. Routing the snapshots into storage is a delivery-config change that the other two tutorials in this series already cover.

## What you'll build

A single Python script that:

1. Runs three SERP API queries, one per platform, for your keyword
2. Reads the top 10 organic results from each `parsed_light` response
3. Classifies each link as an Instagram post, a TikTok video or an X post
4. Triggers the matching Bright Data social scraper for each platform's URL list
5. Prints one snapshot ID per platform

Run it once, get three snapshot IDs. Wire the same script into GitHub Actions later and you've got a daily mention monitor.

**Estimated time:** 25 minutes.

## Prerequisites

* A [Bright Data account](https://brightdata.com/cp/start) with an API key ([get your key](https://brightdata.com/cp/setting/users))
* A **SERP API zone** created in the control panel. Follow the [SERP API introduction](/scraping-automation/serp-api/introduction) once, then come back with the zone name
* Python 3.9+ installed locally

## Part 1: Set up the project

Create a new folder and drop in a `requirements.txt`:

```bash theme={null}
mkdir social-listener && cd social-listener
```

```text requirements.txt theme={null}
requests==2.32.3
```

Install the dependency:

```bash theme={null}
pip install -r requirements.txt
```

Export the credentials the script will read from the environment. The API key authenticates both the SERP API and the social scraper triggers; the zone name tells the SERP API which SERP zone to route the request through:

```bash theme={null}
export BRIGHT_DATA_API_KEY=your_api_key
export BRIGHT_DATA_SERP_ZONE=your_serp_zone_name
```

## Part 2: Discover mentions with the SERP API

The SERP API is a single REST endpoint: `POST https://api.brightdata.com/request`. You hand it a zone name and a Google Search URL, and it returns the SERP for that query. Pass `data_format: "parsed_light"` and you get back a compact JSON payload with just the top 10 organic results, no ads, no knowledge panels, no parsing to do on your side.

Create `listen.py` and start with the discovery step:

```python listen.py theme={null}
import os
import sys
import urllib.parse

import requests

SERP_URL = "https://api.brightdata.com/request"
TRIGGER_URL = "https://api.brightdata.com/datasets/v3/trigger"

PLATFORMS = ["instagram.com", "tiktok.com", "x.com"]


def discover(keyword: str, api_key: str, zone: str) -> dict[str, list[dict]]:
    headers = {
        "Authorization": f"Bearer {api_key}",
        "Content-Type": "application/json",
    }

    results_by_platform: dict[str, list[dict]] = {}

    for site in PLATFORMS:
        query = f'site:{site} "{keyword}"'
        google_url = (
            "https://www.google.com/search"
            f"?q={urllib.parse.quote_plus(query)}&hl=en&gl=us"
        )

        response = requests.post(
            SERP_URL,
            headers=headers,
            json={
                "zone": zone,
                "url": google_url,
                "format": "raw",
                "data_format": "parsed_light",
            },
            timeout=180,
        )
        response.raise_for_status()
        organic = response.json().get("organic", [])
        results_by_platform[site] = organic

    return results_by_platform
```

Three things worth noticing:

* **`data_format: "parsed_light"`** is the key. It tells the SERP API to return only the top 10 organic results in a compact `organic` array, skipping ads and knowledge panels. Faster response, less data to classify.
* **`format: "raw"`** is required alongside `data_format`. It refers to the outer HTTP response envelope, not the parsed payload. The SERP API docs [spell this out](/scraping-automation/serp-api/introduction#get-only-top-10-results-faster-response).
* **`timeout=180`** is generous on purpose. Most SERP API calls return in well under a second, but a single query can occasionally take longer during Google rate-limiting. Three seconds of budget each keeps the script robust without being wasteful.

## Part 3: Classify the URLs by platform

Each SERP response gives you an `organic` array, and each entry has a `link` field pointing to a real post URL. You need to bucket those links so each scraper gets only the URLs it understands.

Add these helpers to `listen.py`:

```python listen.py theme={null}
import re

INSTAGRAM_POST_RE = re.compile(r"https://(?:www\.)?instagram\.com/(?:p|reel)/[^/?#]+")
TIKTOK_POST_RE    = re.compile(r"https://(?:www\.)?tiktok\.com/@[^/]+/video/\d+")
X_POST_RE         = re.compile(r"https://(?:www\.)?x\.com/[^/]+/status/\d+")


def classify(results_by_platform: dict[str, list[dict]]) -> dict[str, list[str]]:
    buckets: dict[str, list[str]] = {"instagram": [], "tiktok": [], "x": []}

    for organic in results_by_platform.values():
        for result in organic:
            link = result.get("link", "")
            if INSTAGRAM_POST_RE.match(link):
                buckets["instagram"].append(link)
            elif TIKTOK_POST_RE.match(link):
                buckets["tiktok"].append(link)
            elif X_POST_RE.match(link):
                buckets["x"].append(link)

    for platform in buckets:
        buckets[platform] = list(dict.fromkeys(buckets[platform]))

    return buckets
```

Notice the regexes match only **post-shaped `https://` URLs**, not profile pages or topic pages. A profile URL like `instagram.com/tiktok` is rejected because this tutorial's scrapers only take post URLs as input. The `https://` prefix is strict on purpose: the social scrapers reject plain `http://` URLs at validation time, so dropping them here avoids a `400 validation_error` from the trigger step later. The `dict.fromkeys` trick de-duplicates while preserving order.

## Part 4: Trigger the social scrapers

You now have three lists of post URLs. Fire them at the matching social scrapers with async triggers so each scraper can run on its own schedule without blocking the script:

```python listen.py theme={null}
SOCIAL_DATASETS = {
    "instagram": "gd_lk5ns7kz21pck8jpis",  # Instagram posts
    "tiktok":    "gd_lu702nij2f790tmv9h",  # TikTok posts
    "x":         "gd_lwxkxvnf1cynvib9co",  # X posts
}


def trigger(platform: str, urls: list[str], api_key: str) -> str | None:
    if not urls:
        print(f"  {platform}: no URLs to trigger")
        return None

    response = requests.post(
        TRIGGER_URL,
        params={"dataset_id": SOCIAL_DATASETS[platform], "format": "json"},
        headers={
            "Authorization": f"Bearer {api_key}",
            "Content-Type": "application/json",
        },
        json=[{"url": url} for url in urls],
        timeout=30,
    )
    response.raise_for_status()
    snapshot_id = response.json().get("snapshot_id")
    print(f"  {platform}: {len(urls)} URLs -> snapshot {snapshot_id}")
    return snapshot_id
```

Two things worth noticing:

* **Discovery is synchronous, scraping is async.** The SERP API returns in under a second per query, so you loop over three queries inline. The social scrapers can take several minutes each, so you trigger and exit. Bright Data runs them in the background.
* **The script returns snapshot IDs, not data.** The actual posts land wherever your scraper's delivery config points (API download, webhook, or S3/GCS/Azure). See the two companion tutorials for [webhook delivery](/datasets/scrapers/tutorials/linkedin-to-crm) and [S3 delivery](/datasets/scrapers/tutorials/amazon-price-monitor).

## Part 5: Wire it together and run

Add a `main` block that glues the three steps:

```python listen.py theme={null}
def main() -> int:
    api_key = os.environ.get("BRIGHT_DATA_API_KEY")
    zone = os.environ.get("BRIGHT_DATA_SERP_ZONE")

    if not (api_key and zone):
        print("Set BRIGHT_DATA_API_KEY and BRIGHT_DATA_SERP_ZONE before running.")
        return 1

    if len(sys.argv) < 2:
        print("Usage: python listen.py \"your keyword\"")
        return 1

    keyword = sys.argv[1]
    print(f"Discovering mentions of: {keyword}")

    results_by_platform = discover(keyword, api_key, zone)
    buckets = classify(results_by_platform)

    print("Classified URLs:")
    for platform, urls in buckets.items():
        print(f"  {platform}: {len(urls)}")

    print("Triggering scrapers:")
    for platform, urls in buckets.items():
        trigger(platform, urls, api_key)

    return 0


if __name__ == "__main__":
    sys.exit(main())
```

Run it with a keyword that is likely to show up on all three platforms:

```bash theme={null}
python listen.py "bright data"
```

You should see output like:

```text theme={null}
Discovering mentions of: bright data
Classified URLs:
  instagram: 9
  tiktok: 10
  x: 10
Triggering scrapers:
  instagram: 9 URLs -> snapshot sd_mnte2pbv16riike0ao
  tiktok: 10 URLs -> snapshot sd_mnte2q1nw3g36l4z1
  x: 10 URLs -> snapshot sd_mnte2qt91ga85uuq8r
```

Three snapshot IDs, one per platform. Each is now running asynchronously at Bright Data and will deliver results to wherever you've configured that scraper's delivery destination.

## Congratulations

You've built a keyword social listener that:

* Uses the **SERP API** in `parsed_light` mode as a compact, sub-second discovery engine
* Takes the **top 10 organic results** per query and classifies them by platform with post-shape regexes
* **Triggers** the Instagram, TikTok and X scrapers in parallel on the discovered URLs
* Exits immediately after trigger, leaving the heavy work to Bright Data

The whole pipeline is one Python file. No proxy setup, no glue services and no batch jobs.

## Next steps

<CardGroup>
  <Card title="Deliver to a webhook" icon="webhook" href="/datasets/scrapers/tutorials/linkedin-to-crm">
    Point each social scraper at a webhook handler (like the Next.js one in the LinkedIn tutorial) to get mapped post records back in real time.
  </Card>

  <Card title="Deliver to S3" icon="bucket" href="/datasets/scrapers/tutorials/amazon-price-monitor">
    Configure S3 delivery on each scraper and schedule this script with GitHub Actions for a daily mention report.
  </Card>

  <Card title="Narrow the search" icon="filter" href="/scraping-automation/serp-api/query-parameters/google">
    Full list of Google-specific query parameters you can add to the search URL, including `gl`, `hl`, `uule` and time filters.
  </Card>

  <Card title="SERP API reference" icon="bolt" href="/scraping-automation/serp-api/introduction">
    All supported engines, parsed output schema and async request mode for large volumes.
  </Card>
</CardGroup>


# Async batch requests for X (Twitter)
Source: https://docs.brightdata.com/datasets/scrapers/twitter/async-requests

Trigger large-scale X scraping jobs, monitor progress, and retrieve results using the Bright Data async /trigger endpoint. Handles up to 20 URLs per request.

This guide shows you how to scrape X (formerly Twitter) data at scale using the asynchronous `/trigger` endpoint. Use this when you have more than 20 URLs, need discovery, or want delivery to a webhook or S3.

<Tip>
  Not sure whether to use sync or async? Read [Understanding sync vs. async requests](/datasets/scrapers/concepts/sync-vs-async).
</Tip>

## Prerequisites

* A [Bright Data account](https://brightdata.com/cp/start) with an active API key
* Familiarity with the [synchronous request flow](/datasets/scrapers/twitter/send-first-request)

## Step 1: Trigger the collection

Send a `POST` request to the `/trigger` endpoint with your input URLs:

<CodeGroup>
  ```bash cURL theme={null}
  curl -X POST \
    "https://api.brightdata.com/datasets/v3/trigger?dataset_id=gd_lwxmeb2u1cniijd7t4&format=json" \
    -H "Authorization: Bearer YOUR_API_KEY" \
    -H "Content-Type: application/json" \
    -d '[
      {"url": "https://x.com/elonmusk"},
      {"url": "https://x.com/BillGates"},
      {"url": "https://x.com/NASA"},
      {"url": "https://x.com/Google"},
      {"url": "https://x.com/Microsoft"}
    ]'
  ```

  ```python Python theme={null}
  import requests

  response = requests.post(
      "https://api.brightdata.com/datasets/v3/trigger",
      params={
          "dataset_id": "gd_lwxmeb2u1cniijd7t4",
          "format": "json",
      },
      headers={
          "Authorization": "Bearer YOUR_API_KEY",
          "Content-Type": "application/json",
      },
      json=[
          {"url": "https://x.com/elonmusk"},
          {"url": "https://x.com/BillGates"},
          {"url": "https://x.com/NASA"},
          {"url": "https://x.com/Google"},
          {"url": "https://x.com/Microsoft"},
      ],
  )

  snapshot = response.json()
  print("Snapshot ID:", snapshot["snapshot_id"])
  ```

  ```javascript Node.js theme={null}
  const response = await fetch(
    "https://api.brightdata.com/datasets/v3/trigger?dataset_id=gd_lwxmeb2u1cniijd7t4&format=json",
    {
      method: "POST",
      headers: {
        "Authorization": "Bearer YOUR_API_KEY",
        "Content-Type": "application/json",
      },
      body: JSON.stringify([
        { url: "https://x.com/elonmusk" },
        { url: "https://x.com/BillGates" },
        { url: "https://x.com/NASA" },
        { url: "https://x.com/Google" },
        { url: "https://x.com/Microsoft" },
      ]),
    }
  );

  const snapshot = await response.json();
  console.log("Snapshot ID:", snapshot.snapshot_id);
  ```
</CodeGroup>

You should see a `200` response with a `snapshot_id`:

```json theme={null}
{
  "snapshot_id": "s_m1a2b3c4d5e6f7g8h"
}
```

Save this ID. You need it to check progress and download results.

## Step 2: Monitor progress

Poll the snapshot status until it shows `ready`. This takes 30 seconds to several minutes depending on the number of URLs.

<CodeGroup>
  ```bash cURL theme={null}
  curl "https://api.brightdata.com/datasets/v3/progress/s_m1a2b3c4d5e6f7g8h" \
    -H "Authorization: Bearer YOUR_API_KEY"
  ```

  ```python Python theme={null}
  import time

  snapshot_id = "s_m1a2b3c4d5e6f7g8h"

  while True:
      status_response = requests.get(
          f"https://api.brightdata.com/datasets/v3/progress/{snapshot_id}",
          headers={"Authorization": "Bearer YOUR_API_KEY"},
      )
      status = status_response.json().get("status")
      print(f"Status: {status}")

      if status == "ready":
          break
      time.sleep(10)
  ```

  ```javascript Node.js theme={null}
  const snapshotId = "s_m1a2b3c4d5e6f7g8h";

  let status = "collecting";
  while (status !== "ready") {
    const statusResponse = await fetch(
      `https://api.brightdata.com/datasets/v3/progress/${snapshotId}`,
      { headers: { "Authorization": "Bearer YOUR_API_KEY" } }
    );
    const statusData = await statusResponse.json();
    status = statusData.status;
    console.log("Status:", status);

    if (status !== "ready") {
      await new Promise((r) => setTimeout(r, 10000));
    }
  }
  ```
</CodeGroup>

Status values:

| Status       | Meaning                             |
| :----------- | :---------------------------------- |
| `collecting` | Scraping is in progress             |
| `digesting`  | Data is being processed             |
| `ready`      | Results are available for download  |
| `failed`     | The collection encountered an error |

## Step 3: Download results

Once the status is `ready`, download the scraped data:

<CodeGroup>
  ```bash cURL theme={null}
  curl "https://api.brightdata.com/datasets/v3/snapshot/s_m1a2b3c4d5e6f7g8h?format=json" \
    -H "Authorization: Bearer YOUR_API_KEY" \
    -o results.json
  ```

  ```python Python theme={null}
  results_response = requests.get(
      f"https://api.brightdata.com/datasets/v3/snapshot/{snapshot_id}",
      params={"format": "json"},
      headers={"Authorization": "Bearer YOUR_API_KEY"},
  )

  results = results_response.json()
  print(f"Collected {len(results)} profiles")
  ```

  ```javascript Node.js theme={null}
  const resultsResponse = await fetch(
    `https://api.brightdata.com/datasets/v3/snapshot/${snapshotId}?format=json`,
    { headers: { "Authorization": "Bearer YOUR_API_KEY" } }
  );

  const results = await resultsResponse.json();
  console.log(`Collected ${results.length} profiles`);
  ```
</CodeGroup>

You've successfully triggered, monitored, and downloaded a batch X scraping job.

## Skip polling with webhooks

If you don't want to poll for status, add an `endpoint` parameter to receive results automatically:

```bash theme={null}
curl -X POST \
  "https://api.brightdata.com/datasets/v3/trigger?dataset_id=gd_lwxmeb2u1cniijd7t4&format=json&endpoint=https://your-server.com/webhook" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '[{"url": "https://x.com/elonmusk"}]'
```

See [How to receive X data via webhooks](/datasets/scrapers/twitter/data-delivery/webhooks) for the full setup.

## Limits and constraints

| Constraint                           | Value      |
| :----------------------------------- | :--------- |
| Max input file size                  | 1 GB       |
| Max concurrent batch requests        | 100        |
| Max concurrent single-input requests | 1,500      |
| Webhook delivery size                | Up to 1 GB |
| API download size                    | Up to 5 GB |

## Troubleshooting

<Accordion title="Getting a 429 Too Many Requests error?">
  You've exceeded the concurrent request limit. Reduce the number of parallel requests or combine inputs into fewer, larger batches. Each batch can include up to 1 GB of input data.
</Accordion>

<Accordion title="Snapshot status shows 'failed'?">
  Check that all input URLs are valid X URLs. Review the error details in the snapshot response or in the [Logs tab](https://brightdata.com/cp/scrapers) of your Bright Data dashboard.
</Accordion>

<Accordion title="Results are incomplete or missing some URLs?">
  Some URLs may fail individually while the overall job succeeds. Check the snapshot response for any `errors` field. Retry failed URLs in a separate request.
</Accordion>

## Next steps

<CardGroup>
  <Card title="Set up webhooks" icon="webhook" href="/datasets/scrapers/twitter/data-delivery/webhooks">
    Receive results without polling.
  </Card>

  <Card title="Deliver to S3" icon="bucket" href="/datasets/scrapers/twitter/data-delivery/amazon-s3">
    Send results directly to your S3 bucket.
  </Card>
</CardGroup>


# X (Twitter) data delivery to Amazon S3
Source: https://docs.brightdata.com/datasets/scrapers/twitter/data-delivery/amazon-s3

Configure the Bright Data X (Twitter) Scraper API to deliver scraped profiles, posts and search results directly to your Amazon S3 bucket on job completion.

This guide shows you how to configure the Bright Data X Scraper API to deliver scraped data directly to your Amazon S3 bucket when a collection job completes.

## Prerequisites

* A [Bright Data account](https://brightdata.com/cp/start) with an active API key
* An AWS account with an S3 bucket
* IAM credentials with write access to the bucket
* Familiarity with the [async request workflow](/datasets/scrapers/twitter/async-requests)

## Step 1: Create an S3 bucket

If you already have a bucket, skip to Step 2.

In the [AWS S3 Console](https://s3.console.aws.amazon.com/s3/buckets):

1. Click **Create bucket**
2. Enter a bucket name (e.g., `twitter-scraper-data`)
3. Select your preferred AWS region
4. Keep default settings and click **Create bucket**

## Step 2: Set up IAM permissions

Create an IAM role that grants Bright Data write access to your bucket.

### Create a policy

In the [IAM Console](https://console.aws.amazon.com/iam/), go to **Policies** and create a new policy with this JSON:

```json theme={null}
{
  "Version": "2012-10-17",
  "Statement": [
    {
      "Effect": "Allow",
      "Action": ["s3:PutObject", "s3:GetObject"],
      "Resource": "arn:aws:s3:::twitter-scraper-data/*"
    }
  ]
}
```

Replace `twitter-scraper-data` with your actual bucket name.

### Create a role for Bright Data

1. Go to **Roles** > **Create role**
2. Select **AWS account** as the trusted entity type
3. Enter Bright Data's AWS account ID: `422310177405`
4. Attach the policy you created above
5. Name the role (e.g., `BrightDataS3Delivery`)
6. Note the role ARN (e.g., `arn:aws:iam::123456789012:role/BrightDataS3Delivery`)

Add an external ID condition to the trust policy:

```json theme={null}
{
  "Version": "2012-10-17",
  "Statement": [
    {
      "Effect": "Allow",
      "Principal": {
        "AWS": "arn:aws:iam::422310177405:role/brd.ec2.zs-dca-delivery"
      },
      "Action": "sts:AssumeRole",
      "Condition": {
        "StringEquals": {
          "sts:ExternalId": "YOUR_BRIGHT_DATA_CUSTOMER_ID"
        }
      }
    }
  ]
}
```

Find your customer ID in [Account settings](https://brightdata.com/cp/setting/customer_details).

## Step 3: Configure delivery in Bright Data

1. Navigate to your [scraper configuration](https://brightdata.com/cp/scrapers)
2. Click the **Delivery settings** tab
3. Select **Amazon S3** as the delivery destination
4. Enter your credentials:
   * **Bucket name**: Your S3 bucket name
   * **Role ARN**: The IAM role ARN from Step 2
   * **Region**: Your S3 bucket region
   * **Path prefix** (optional): A folder path within the bucket (e.g., `twitter/profiles/`)
5. Select your preferred file format (JSON, NDJSON, or CSV)
6. Click **Save**

## Step 4: Trigger a collection

Trigger an async collection. Results are automatically delivered to your S3 bucket:

<CodeGroup>
  ```bash cURL theme={null}
  curl -X POST \
    "https://api.brightdata.com/datasets/v3/trigger?dataset_id=gd_lwxmeb2u1cniijd7t4&format=json" \
    -H "Authorization: Bearer YOUR_API_KEY" \
    -H "Content-Type: application/json" \
    -d '[
      {"url": "https://x.com/elonmusk"},
      {"url": "https://x.com/BillGates"},
      {"url": "https://x.com/NASA"}
    ]'
  ```

  ```python Python theme={null}
  import requests

  response = requests.post(
      "https://api.brightdata.com/datasets/v3/trigger",
      params={"dataset_id": "gd_lwxmeb2u1cniijd7t4", "format": "json"},
      headers={
          "Authorization": "Bearer YOUR_API_KEY",
          "Content-Type": "application/json",
      },
      json=[
          {"url": "https://x.com/elonmusk"},
          {"url": "https://x.com/BillGates"},
          {"url": "https://x.com/NASA"},
      ],
  )

  print("Snapshot ID:", response.json()["snapshot_id"])
  ```

  ```javascript Node.js theme={null}
  const response = await fetch(
    "https://api.brightdata.com/datasets/v3/trigger?dataset_id=gd_lwxmeb2u1cniijd7t4&format=json",
    {
      method: "POST",
      headers: {
        "Authorization": "Bearer YOUR_API_KEY",
        "Content-Type": "application/json",
      },
      body: JSON.stringify([
        { url: "https://x.com/elonmusk" },
        { url: "https://x.com/BillGates" },
        { url: "https://x.com/NASA" },
      ]),
    }
  );

  const data = await response.json();
  console.log("Snapshot ID:", data.snapshot_id);
  ```
</CodeGroup>

## Step 5: Verify delivery

Once the collection completes, check your S3 bucket for the delivered file:

```bash theme={null}
aws s3 ls s3://twitter-scraper-data/twitter/profiles/
```

You should see a file named with the snapshot ID (e.g., `s_m1a2b3c4d5e6f7g8h.json`).

Download and inspect it:

```bash theme={null}
aws s3 cp s3://twitter-scraper-data/twitter/profiles/s_m1a2b3c4d5e6f7g8h.json ./results.json
cat results.json | python -m json.tool | head -20
```

You can also verify delivery status using the [Monitor Delivery API](/api-reference/scrapers/management-apis/monitor-delivery).

## Troubleshooting

<Accordion title="Files not appearing in S3?">
  * Verify the IAM role ARN and external ID are correct
  * Check that the bucket policy allows `s3:PutObject` from Bright Data's account
  * Ensure the bucket region matches your configuration
  * Review delivery status in the Bright Data dashboard under **Logs**
</Accordion>

<Accordion title="Access denied errors?">
  Verify the trust policy on your IAM role includes Bright Data's account (`422310177405`) and your external ID matches your Bright Data customer ID found in [Account settings](https://brightdata.com/cp/setting/customer_details).
</Accordion>

<Accordion title="Delivered file is empty or missing records?">
  Check the collection status in the Bright Data dashboard. If some URLs failed, the delivered file contains only successful results. Retry failed URLs in a separate request.
</Accordion>

## Next steps

<CardGroup>
  <Card title="Set up webhooks" icon="webhook" href="/datasets/scrapers/twitter/data-delivery/webhooks">
    Receive results at your HTTP endpoint.
  </Card>

  <Card title="All delivery options" icon="truck" href="/datasets/scrapers/scrapers-library/delivery-options">
    Snowflake, Azure, GCS, SFTP, and more.
  </Card>
</CardGroup>


# X (Twitter) data delivery via webhook
Source: https://docs.brightdata.com/datasets/scrapers/twitter/data-delivery/webhooks

Configure the Bright Data X (Twitter) Scraper API to push scraped profiles, posts and search results to your HTTPS webhook across 2 endpoints as jobs complete.

This guide shows you how to set up webhook delivery so your server receives scraped X (formerly Twitter) data automatically when a collection job finishes.

## Prerequisites

* A [Bright Data account](https://brightdata.com/cp/start) with an active API key
* Familiarity with the [async request workflow](/datasets/scrapers/twitter/async-requests)
* A publicly accessible HTTP endpoint (or a testing tool like [webhook.site](https://webhook.site))

## How webhooks work

When you trigger an async collection with an `endpoint` URL, Bright Data sends a `POST` request to that URL with the scraped data once the job completes. No polling required.

```text theme={null}
Your app --> POST /trigger (with webhook URL) --> Bright Data scrapes --> POST to your webhook
```

## Step 1: Set up a test webhook

For testing, use [webhook.site](https://webhook.site) to get a temporary public URL:

1. Open [webhook.site](https://webhook.site) in your browser
2. Copy the unique URL displayed (e.g., `https://webhook.site/abc-123-def`)
3. Keep the page open to monitor incoming requests

## Step 2: Trigger a collection with the webhook URL

Add the `endpoint` query parameter to your async `/trigger` request:

<CodeGroup>
  ```bash cURL theme={null}
  curl -X POST \
    "https://api.brightdata.com/datasets/v3/trigger?dataset_id=gd_lwxmeb2u1cniijd7t4&format=json&endpoint=https://webhook.site/abc-123-def&uncompressed_webhook=true" \
    -H "Authorization: Bearer YOUR_API_KEY" \
    -H "Content-Type: application/json" \
    -d '[
      {"url": "https://x.com/elonmusk"},
      {"url": "https://x.com/BillGates"}
    ]'
  ```

  ```python Python theme={null}
  import requests

  WEBHOOK_URL = "https://webhook.site/abc-123-def"

  response = requests.post(
      "https://api.brightdata.com/datasets/v3/trigger",
      params={
          "dataset_id": "gd_lwxmeb2u1cniijd7t4",
          "format": "json",
          "webhook": WEBHOOK_URL,
          "uncompressed_webhook": "true",
      },
      headers={
          "Authorization": "Bearer YOUR_API_KEY",
          "Content-Type": "application/json",
      },
      json=[
          {"url": "https://x.com/elonmusk"},
          {"url": "https://x.com/BillGates"},
      ],
  )

  print("Snapshot ID:", response.json()["snapshot_id"])
  ```

  ```javascript Node.js theme={null}
  const WEBHOOK_URL = "https://webhook.site/abc-123-def";

  const response = await fetch(
    `https://api.brightdata.com/datasets/v3/trigger?dataset_id=gd_lwxmeb2u1cniijd7t4&format=json&endpoint=${encodeURIComponent(WEBHOOK_URL)}&uncompressed_webhook=true`,
    {
      method: "POST",
      headers: {
        "Authorization": "Bearer YOUR_API_KEY",
        "Content-Type": "application/json",
      },
      body: JSON.stringify([
        { url: "https://x.com/elonmusk" },
        { url: "https://x.com/BillGates" },
      ]),
    }
  );

  const data = await response.json();
  console.log("Snapshot ID:", data.snapshot_id);
  ```
</CodeGroup>

Key parameters:

| Parameter              | Description                                                  |
| :--------------------- | :----------------------------------------------------------- |
| `endpoint`             | Your HTTP endpoint URL that receives the `POST` payload      |
| `uncompressed_webhook` | Set to `true` to receive uncompressed JSON (default is gzip) |
| `format`               | Output format: `json`, `ndjson`, or `csv`                    |

## Step 3: Verify delivery

Once the collection completes (typically 30-60 seconds for a few profiles), check your webhook.site page. You should see a `POST` request with the scraped data.

The payload is the same JSON array you would receive from a direct API download:

```json theme={null}
[
  {
    "user_name": "elonmusk",
    "name": "Elon Musk",
    "description": "Read @WallStreetSilv",
    "followers": 214000000,
    "is_verified": true
  },
  {
    "user_name": "BillGates",
    "name": "Bill Gates",
    "description": "Sharing things I'm learning...",
    "followers": 65000000,
    "is_verified": true
  }
]
```

## Production webhook setup

For production, point the `endpoint` URL to your own server endpoint.

### How to handle webhooks in Express.js

```javascript server.js theme={null}
const express = require("express");
const app = express();

app.use(express.json({ limit: "100mb" }));

app.post("/webhook/twitter", (req, res) => {
  const profiles = req.body;
  console.log(`Received ${profiles.length} profiles`);

  for (const profile of profiles) {
    console.log(`- ${profile.user_name} (${profile.followers} followers)`);
  }

  res.status(200).json({ received: true });
});

app.listen(3000, () => console.log("Webhook server running on port 3000"));
```

### How to handle webhooks in Flask

```python server.py theme={null}
from flask import Flask, request, jsonify

app = Flask(__name__)

@app.route("/webhook/twitter", methods=["POST"])
def handle_webhook():
    profiles = request.get_json()
    print(f"Received {len(profiles)} profiles")

    for profile in profiles:
        print(f"- {profile['user_name']} ({profile.get('followers')} followers)")

    return jsonify({"received": True}), 200

if __name__ == "__main__":
    app.run(port=3000)
```

<Warning>
  Return a `200` status code within 30 seconds to acknowledge receipt. If your endpoint fails or times out, Bright Data retries delivery.
</Warning>

## Webhook with authorization

If your endpoint requires authentication, add the `webhook_header_Authorization` parameter:

```bash theme={null}
curl -X POST \
  "https://api.brightdata.com/datasets/v3/trigger?dataset_id=gd_lwxmeb2u1cniijd7t4&format=json&endpoint=https://your-server.com/webhook&webhook_header_Authorization=Bearer+YOUR_SECRET_TOKEN" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '[{"url": "https://x.com/elonmusk"}]'
```

## Allowlist webhook IPs

If your server uses an IP allowlist, add the following Bright Data webhook source IPs:

```text theme={null}
54.175.27.69
34.225.9.175
100.28.38.247
100.29.18.195
52.72.185.255
35.174.112.248
54.165.183.124
3.91.140.7
52.202.75.37
98.82.225.117
100.27.150.189
18.214.10.85
35.169.71.210
44.194.183.74
```

## Troubleshooting

<Accordion title="Webhook not receiving data?">
  * Verify the URL is publicly accessible (not `localhost`)
  * Check that your endpoint returns a `200` status code within 30 seconds
  * Verify the webhook IPs above are allowlisted if you have firewall rules
</Accordion>

<Accordion title="Receiving compressed data?">
  If you omit `uncompressed_webhook=true`, data arrives gzip-compressed. Add `uncompressed_webhook=true` to your trigger URL, or decompress the payload on your server.
</Accordion>

<Accordion title="Payload too large for your server?">
  Large collections can produce payloads up to 1 GB. Set `express.json({ limit: "100mb" })` in Express.js or equivalent in your framework. If you need to handle very large datasets, use [S3 delivery](/datasets/scrapers/twitter/data-delivery/amazon-s3) instead.
</Accordion>

## Next steps

<CardGroup>
  <Card title="Deliver to Amazon S3" icon="bucket" href="/datasets/scrapers/twitter/data-delivery/amazon-s3">
    Store results directly in your S3 bucket.
  </Card>

  <Card title="All delivery options" icon="truck" href="/datasets/scrapers/scrapers-library/delivery-options">
    Snowflake, Azure, GCS, and more.
  </Card>
</CardGroup>


# X (Twitter) Scraper API
Source: https://docs.brightdata.com/datasets/scrapers/twitter/introduction

Use the Bright Data [X (Twitter) Scraper API](https://brightdata.com/products/web-scraper/twitter) to extract structured data from profiles and posts. Handles up to 20 URLs per request.

Send an X.com URL, get structured JSON back. The Bright Data X Scraper API handles proxies, CAPTCHAs, and parsing so you can focus on your data pipeline.

<Tip>
  New to Bright Data? [Create a free account](https://brightdata.com/cp/start) and get \$2 credit to start scraping.
</Tip>

## How it works

You send one or more X (formerly Twitter) URLs to the Bright Data X Scraper API. Bright Data handles the scraping infrastructure and returns clean, structured JSON.

```text theme={null}
Your app  -->  Bright Data API  -->  Structured JSON
           POST /datasets/v3/scrape
           Authorization: Bearer YOUR_API_KEY
```

All requests use a `dataset_id` to specify the data type (profiles or posts) and return results in JSON, NDJSON, or CSV.

## What the response looks like

```bash theme={null}
curl -X POST "https://api.brightdata.com/datasets/v3/scrape?dataset_id=gd_lwxmeb2u1cniijd7t4&format=json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '[{"url": "https://x.com/elonmusk"}]'
```

```json theme={null}
{
  "user_name": "elonmusk",
  "name": "Elon Musk",
  "description": "Read @WallStreetSilv",
  "followers": 214000000,
  "following": 870,
  "number_of_tweets": 52000,
  "is_verified": true,
  "profile_image_link": "https://..."
}
```

## Supported data types

<CardGroup>
  <Card title="Profiles" icon="user" href="/api-reference/scrapers/social-media-apis/twitter-profiles-collect-by-url">
    Follower counts, bios, verification status, profile images. Discover profiles by username.
  </Card>

  <Card title="Posts" icon="message" href="/api-reference/scrapers/social-media-apis/twitter-posts-collect-by-url">
    Post text, likes, reposts, replies, media, and hashtags. Discover posts by profile URL.
  </Card>
</CardGroup>

## Request methods

The Bright Data X Scraper API supports two request methods. Choose based on your volume and latency needs.

| Method           | Endpoint                                                   | Best for                                   |
| :--------------- | :--------------------------------------------------------- | :----------------------------------------- |
| **Synchronous**  | [`/scrape`](/datasets/scrapers/twitter/send-first-request) | Real-time lookups, up to 20 URLs           |
| **Asynchronous** | [`/trigger`](/datasets/scrapers/twitter/async-requests)    | Batch jobs, 20+ URLs, production pipelines |

Learn more in [Understanding sync vs. async requests](/datasets/scrapers/concepts/sync-vs-async).

## Capabilities and limits

| Capability                     | Detail                                                                                                                                                                                                                                   |
| :----------------------------- | :--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Output formats**             | JSON, NDJSON, CSV                                                                                                                                                                                                                        |
| **Max URLs per sync request**  | 20                                                                                                                                                                                                                                       |
| **Max URLs per async request** | 5,000                                                                                                                                                                                                                                    |
| **Data freshness**             | Real-time (scraped on demand)                                                                                                                                                                                                            |
| **Delivery options**           | API download, [Webhook](/datasets/scrapers/twitter/data-delivery/webhooks), [Amazon S3](/datasets/scrapers/twitter/data-delivery/amazon-s3), Snowflake, Azure, GCS ([all options](/datasets/scrapers/scrapers-library/delivery-options)) |
| **Pricing**                    | Pay per successful record ([see pricing](https://brightdata.com/pricing/web-scraper))                                                                                                                                                    |

## Common questions

<Accordion title="Is the data scraped in real time?">
  Yes. Each request triggers a live scrape. There is no cached or stale data. Response times vary by endpoint: profiles typically return in 10-30 seconds (sync), while discovery requests may take longer depending on result volume.
</Accordion>

<Accordion title="What is the difference between URL collection and discovery?">
  **URL collection** scrapes a specific X page you provide (e.g., a profile URL). **Discovery** finds X content matching search criteria (e.g., all posts from a profile URL) and scrapes the results. Discovery is only available via async requests.
</Accordion>

<Accordion title="How is this different from scraping using proxies or Web Unlocker?">
  When scraping using proxies or Web Unlocker, you still need to write and maintain
  your own parsing logic and update it whenever X changes its page structure.
  The X Scraper API handles the entire stack: proxy rotation, anti-bot bypassing
  and parsing. You simply send an X.com URL and get clean, structured JSON back with
  no scraping infrastructure or parser maintenance required on your end.
</Accordion>

## Next steps

<CardGroup>
  <Card title="Quickstart" icon="rocket" href="/datasets/scrapers/twitter/quickstart">
    Scrape your first X profile in 5 minutes.
  </Card>

  <Card title="Send your first request" icon="bolt" href="/datasets/scrapers/twitter/send-first-request">
    Full code examples in cURL, Python, and Node.js.
  </Card>

  <Card title="API reference" icon="code" href="/api-reference/scrapers/social-media-apis/twitter-profiles-collect-by-url">
    Endpoint specs, parameters, and response schemas.
  </Card>
</CardGroup>


# X (Twitter) scraper quickstart
Source: https://docs.brightdata.com/datasets/scrapers/twitter/quickstart

Set up the Bright Data X (Twitter) Scraper API and collect your first profile or post as structured JSON in under 5 minutes from the Control Panel.

This tutorial shows you how to scrape an X (formerly Twitter) profile and get structured JSON data using the Bright Data X Scraper API.

## Prerequisites

* A [Bright Data account](https://brightdata.com/cp/start) (includes \$2 free credit)
* cURL, Python 3, or Node.js 18+ installed

<Steps>
  <Step title="Get your API key">
    Go to the [user settings page](https://brightdata.com/cp/setting/users) in your Bright Data account and copy your API key.

    If you don't have an account yet, [sign up at brightdata.com](https://brightdata.com/cp/start). New users get \$2 free credit for testing.

    <Warning>
      Your API key is shown only once when created. Copy and store it securely.
    </Warning>
  </Step>

  <Step title="Send a request">
    We'll use the **Profiles endpoint** with a synchronous request. Replace `YOUR_API_KEY` with your actual token:

    <CodeGroup>
      ```bash cURL theme={null}
      curl -X POST \
        "https://api.brightdata.com/datasets/v3/scrape?dataset_id=gd_lwxmeb2u1cniijd7t4&format=json" \
        -H "Authorization: Bearer YOUR_API_KEY" \
        -H "Content-Type: application/json" \
        -d '[{"url": "https://x.com/elonmusk"}]'
      ```

      ```python Python theme={null}
      import requests

      response = requests.post(
          "https://api.brightdata.com/datasets/v3/scrape",
          params={"dataset_id": "gd_lwxmeb2u1cniijd7t4", "format": "json"},
          headers={
              "Authorization": "Bearer YOUR_API_KEY",
              "Content-Type": "application/json",
          },
          json=[{"url": "https://x.com/elonmusk"}],
      )

      print(response.json())
      ```

      ```javascript Node.js theme={null}
      const response = await fetch(
        "https://api.brightdata.com/datasets/v3/scrape?dataset_id=gd_lwxmeb2u1cniijd7t4&format=json",
        {
          method: "POST",
          headers: {
            "Authorization": "Bearer YOUR_API_KEY",
            "Content-Type": "application/json",
          },
          body: JSON.stringify([
            { url: "https://x.com/elonmusk" }
          ]),
        }
      );

      const data = await response.json();
      console.log(data);
      ```
    </CodeGroup>

    You should see a `200` status code. This takes 10-30 seconds.
  </Step>

  <Step title="Review the response">
    The Bright Data X Scraper API returns a JSON array with structured profile data:

    ```json theme={null}
    [
      {
        "user_name": "elonmusk",
        "name": "Elon Musk",
        "description": "Read @WallStreetSilv",
        "followers": 214000000,
        "following": 870,
        "number_of_tweets": 52000,
        "is_verified": true,
        "url": "https://x.com/elonmusk"
      }
    ]
    ```

    Each profile object includes fields covering follower counts, bio, verification status, and more. See the [full response schema](/api-reference/scrapers/social-media-apis/twitter-profiles-collect-by-url).
  </Step>
</Steps>

You've successfully scraped your first X profile using the Bright Data X Scraper API.

## Common questions

<Accordion title="Can I scrape multiple profiles in one request?">
  Yes. Add more objects to the input array. Synchronous requests support up to 20 URLs. For larger batches, use the [async `/trigger` endpoint](/datasets/scrapers/twitter/async-requests).

  ```json theme={null}
  [
    {"url": "https://x.com/elonmusk"},
    {"url": "https://x.com/BillGates"},
    {"url": "https://x.com/NASA"}
  ]
  ```
</Accordion>

<Accordion title="Getting a 401 or 403 error?">
  Verify your API key is correct and hasn't expired. Generate a new token from [Account settings](https://brightdata.com/cp/setting/users). See the [authentication guide](/api-reference/authentication) for details.
</Accordion>

<Accordion title="Request is timing out?">
  Synchronous requests have a 1-minute timeout. If the request exceeds this limit, it automatically switches to async and returns a `snapshot_id`. Use the [async workflow](/datasets/scrapers/twitter/async-requests) for large batches.
</Accordion>

<Accordion title="Empty or partial response data?">
  Verify the X profile URL is publicly accessible and correctly formatted. The URL should follow the pattern `https://x.com/username`.
</Accordion>

## Next steps

<CardGroup>
  <Card title="Send your first request" icon="bolt" href="/datasets/scrapers/twitter/send-first-request">
    Explore both endpoint types with full examples.
  </Card>

  <Card title="Async batch requests" icon="layer-group" href="/datasets/scrapers/twitter/async-requests">
    Scrape hundreds of URLs in a single batch job.
  </Card>

  <Card title="Set up webhooks" icon="webhook" href="/datasets/scrapers/twitter/data-delivery/webhooks">
    Receive results automatically when scraping completes.
  </Card>
</CardGroup>


# Send your first X (Twitter) API request
Source: https://docs.brightdata.com/datasets/scrapers/twitter/send-first-request

Send synchronous requests to all 2 Bright Data X (Twitter) Scraper API endpoints with copy-paste examples for profiles and posts collection.

This tutorial walks you through sending a synchronous request to each Bright Data X Scraper API endpoint. By the end, you'll have working examples for profiles and posts.

## Prerequisites

* A [Bright Data account](https://brightdata.com/cp/start) with an active API key
* Completed the [Quickstart](/datasets/scrapers/twitter/quickstart)

## Request structure

Every synchronous request follows the same pattern:

```http theme={null}
POST https://api.brightdata.com/datasets/v3/scrape?dataset_id={DATASET_ID}&format=json
Authorization: Bearer YOUR_API_KEY
Content-Type: application/json

[{"url": "https://x.com/..."}]
```

The only thing that changes between endpoints is the `dataset_id` and the input URL format.

<Note>
  Synchronous requests support up to 20 URLs and have a 1-minute timeout. If the request takes longer, the API automatically returns a `snapshot_id` instead. See [async requests](/datasets/scrapers/twitter/async-requests).
</Note>

## How to scrape X (Twitter) profiles

**Dataset ID:** `gd_lwxmeb2u1cniijd7t4`

```bash theme={null}
curl -X POST \
  "https://api.brightdata.com/datasets/v3/scrape?dataset_id=gd_lwxmeb2u1cniijd7t4&format=json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '[{"url": "https://x.com/elonmusk"}]'
```

You should see a `200` response. This takes 10-30 seconds.

<Accordion title="Example response">
  ```json theme={null}
  [
    {
      "user_name": "elonmusk",
      "name": "Elon Musk",
      "description": "Read @WallStreetSilv",
      "followers": 214000000,
      "following": 870,
      "number_of_tweets": 52000,
      "is_verified": true,
      "profile_image_link": "https://..."
    }
  ]
  ```
</Accordion>

[Full Profiles response schema](/api-reference/scrapers/social-media-apis/twitter-profiles-collect-by-url)

## How to scrape X (Twitter) posts

**Dataset ID:** `gd_lwxkxvnf1cynvib9co`

```bash theme={null}
curl -X POST \
  "https://api.brightdata.com/datasets/v3/scrape?dataset_id=gd_lwxkxvnf1cynvib9co&format=json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '[{"url": "https://x.com/elonmusk/status/1234567890123456789"}]'
```

<Accordion title="Example response">
  ```json theme={null}
  [
    {
      "url": "https://x.com/elonmusk/status/1234567890123456789",
      "user_posted": "elonmusk",
      "description": "Exciting times ahead...",
      "date_posted": "2024-04-03T14:30:00.000Z",
      "likes": 125000,
      "retweets": 18000,
      "replies": 5200,
      "hashtags": ["technology", "innovation"]
    }
  ]
  ```
</Accordion>

[Full Posts response schema](/api-reference/scrapers/social-media-apis/twitter-posts-collect-by-url)

## Quick reference: dataset IDs

| Endpoint | Dataset ID              | URL pattern                    |
| :------- | :---------------------- | :----------------------------- |
| Profiles | `gd_lwxmeb2u1cniijd7t4` | `x.com/{username}`             |
| Posts    | `gd_lwxkxvnf1cynvib9co` | `x.com/{username}/status/{id}` |

## Output formats

Control the response format with the `format` query parameter:

| Value    | Description                                 |
| :------- | :------------------------------------------ |
| `json`   | JSON array (default)                        |
| `ndjson` | Newline-delimited JSON, one record per line |
| `csv`    | Comma-separated values                      |

## Next steps

<CardGroup>
  <Card title="Async batch requests" icon="layer-group" href="/datasets/scrapers/twitter/async-requests">
    Scrape hundreds of URLs in a single batch job.
  </Card>

  <Card title="API reference" icon="code" href="/api-reference/scrapers/social-media-apis/twitter-profiles-collect-by-url">
    Full parameter and response field reference.
  </Card>
</CardGroup>


# Async batch requests for YouTube
Source: https://docs.brightdata.com/datasets/scrapers/youtube/async-requests

Trigger large-scale YouTube scraping jobs, monitor progress, and retrieve results using the Bright Data async /trigger endpoint. Supports batches of 20 URLs.

This guide shows you how to scrape YouTube data at scale using the asynchronous `/trigger` endpoint. Use this when you have more than 20 URLs, need discovery, or want delivery to a webhook or S3.

<Tip>
  Not sure whether to use sync or async? Read [Understanding sync vs. async requests](/datasets/scrapers/concepts/sync-vs-async).
</Tip>

## Prerequisites

* A [Bright Data account](https://brightdata.com/cp/start) with an active API key
* Familiarity with the [synchronous request flow](/datasets/scrapers/youtube/send-first-request)

## Step 1: Trigger the collection

Send a `POST` request to the `/trigger` endpoint with your input URLs:

<CodeGroup>
  ```bash cURL theme={null}
  curl -X POST \
    "https://api.brightdata.com/datasets/v3/trigger?dataset_id=gd_lk538t2k2p1k3oos71&format=json" \
    -H "Authorization: Bearer YOUR_API_KEY" \
    -H "Content-Type: application/json" \
    -d '[
      {"url": "https://www.youtube.com/@MrBeast"},
      {"url": "https://www.youtube.com/@PewDiePie"},
      {"url": "https://www.youtube.com/@mkbhd"},
      {"url": "https://www.youtube.com/@veritasium"},
      {"url": "https://www.youtube.com/@TEDx"}
    ]'
  ```

  ```python Python theme={null}
  import requests

  response = requests.post(
      "https://api.brightdata.com/datasets/v3/trigger",
      params={
          "dataset_id": "gd_lk538t2k2p1k3oos71",
          "format": "json",
      },
      headers={
          "Authorization": "Bearer YOUR_API_KEY",
          "Content-Type": "application/json",
      },
      json=[
          {"url": "https://www.youtube.com/@MrBeast"},
          {"url": "https://www.youtube.com/@PewDiePie"},
          {"url": "https://www.youtube.com/@mkbhd"},
          {"url": "https://www.youtube.com/@veritasium"},
          {"url": "https://www.youtube.com/@TEDx"},
      ],
  )

  snapshot = response.json()
  print("Snapshot ID:", snapshot["snapshot_id"])
  ```

  ```javascript Node.js theme={null}
  const response = await fetch(
    "https://api.brightdata.com/datasets/v3/trigger?dataset_id=gd_lk538t2k2p1k3oos71&format=json",
    {
      method: "POST",
      headers: {
        "Authorization": "Bearer YOUR_API_KEY",
        "Content-Type": "application/json",
      },
      body: JSON.stringify([
        { url: "https://www.youtube.com/@MrBeast" },
        { url: "https://www.youtube.com/@PewDiePie" },
        { url: "https://www.youtube.com/@mkbhd" },
        { url: "https://www.youtube.com/@veritasium" },
        { url: "https://www.youtube.com/@TEDx" },
      ]),
    }
  );

  const snapshot = await response.json();
  console.log("Snapshot ID:", snapshot.snapshot_id);
  ```
</CodeGroup>

You should see a `200` response with a `snapshot_id`:

```json theme={null}
{
  "snapshot_id": "s_m1a2b3c4d5e6f7g8h"
}
```

Save this ID. You need it to check progress and download results.

## Step 2: Monitor progress

Poll the snapshot status until it shows `ready`. This takes 30 seconds to several minutes depending on the number of URLs.

<CodeGroup>
  ```bash cURL theme={null}
  curl "https://api.brightdata.com/datasets/v3/progress/s_m1a2b3c4d5e6f7g8h" \
    -H "Authorization: Bearer YOUR_API_KEY"
  ```

  ```python Python theme={null}
  import time

  snapshot_id = "s_m1a2b3c4d5e6f7g8h"

  while True:
      status_response = requests.get(
          f"https://api.brightdata.com/datasets/v3/progress/{snapshot_id}",
          headers={"Authorization": "Bearer YOUR_API_KEY"},
      )
      status = status_response.json().get("status")
      print(f"Status: {status}")

      if status == "ready":
          break
      time.sleep(10)
  ```

  ```javascript Node.js theme={null}
  const snapshotId = "s_m1a2b3c4d5e6f7g8h";

  let status = "collecting";
  while (status !== "ready") {
    const statusResponse = await fetch(
      `https://api.brightdata.com/datasets/v3/progress/${snapshotId}`,
      { headers: { "Authorization": "Bearer YOUR_API_KEY" } }
    );
    const statusData = await statusResponse.json();
    status = statusData.status;
    console.log("Status:", status);

    if (status !== "ready") {
      await new Promise((r) => setTimeout(r, 10000));
    }
  }
  ```
</CodeGroup>

Status values:

| Status       | Meaning                             |
| :----------- | :---------------------------------- |
| `collecting` | Scraping is in progress             |
| `digesting`  | Data is being processed             |
| `ready`      | Results are available for download  |
| `failed`     | The collection encountered an error |

## Step 3: Download results

Once the status is `ready`, download the scraped data:

<CodeGroup>
  ```bash cURL theme={null}
  curl "https://api.brightdata.com/datasets/v3/snapshot/s_m1a2b3c4d5e6f7g8h?format=json" \
    -H "Authorization: Bearer YOUR_API_KEY" \
    -o results.json
  ```

  ```python Python theme={null}
  results_response = requests.get(
      f"https://api.brightdata.com/datasets/v3/snapshot/{snapshot_id}",
      params={"format": "json"},
      headers={"Authorization": "Bearer YOUR_API_KEY"},
  )

  results = results_response.json()
  print(f"Collected {len(results)} channels")
  ```

  ```javascript Node.js theme={null}
  const resultsResponse = await fetch(
    `https://api.brightdata.com/datasets/v3/snapshot/${snapshotId}?format=json`,
    { headers: { "Authorization": "Bearer YOUR_API_KEY" } }
  );

  const results = await resultsResponse.json();
  console.log(`Collected ${results.length} channels`);
  ```
</CodeGroup>

You've successfully triggered, monitored, and downloaded a batch YouTube scraping job.

## Skip polling with webhooks

If you don't want to poll for status, add an `endpoint` parameter to receive results automatically:

```bash theme={null}
curl -X POST \
  "https://api.brightdata.com/datasets/v3/trigger?dataset_id=gd_lk538t2k2p1k3oos71&format=json&endpoint=https://your-server.com/webhook" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '[{"url": "https://www.youtube.com/@MrBeast"}]'
```

See [How to receive YouTube data via webhooks](/datasets/scrapers/youtube/data-delivery/webhooks) for the full setup.

## Limits and constraints

| Constraint                           | Value      |
| :----------------------------------- | :--------- |
| Max input file size                  | 1 GB       |
| Max concurrent batch requests        | 100        |
| Max concurrent single-input requests | 1,500      |
| Webhook delivery size                | Up to 1 GB |
| API download size                    | Up to 5 GB |

## Troubleshooting

<Accordion title="Getting a 429 Too Many Requests error?">
  You've exceeded the concurrent request limit. Reduce the number of parallel requests or combine inputs into fewer, larger batches. Each batch can include up to 1 GB of input data.
</Accordion>

<Accordion title="Snapshot status shows 'failed'?">
  Check that all input URLs are valid YouTube URLs. Review the error details in the snapshot response or in the [Logs tab](https://brightdata.com/cp/scrapers) of your Bright Data dashboard.
</Accordion>

<Accordion title="Results are incomplete or missing some URLs?">
  Some URLs may fail individually while the overall job succeeds. Check the snapshot response for any `errors` field. Retry failed URLs in a separate request.
</Accordion>

## Next steps

<CardGroup>
  <Card title="Set up webhooks" icon="webhook" href="/datasets/scrapers/youtube/data-delivery/webhooks">
    Receive results without polling.
  </Card>

  <Card title="Deliver to S3" icon="bucket" href="/datasets/scrapers/youtube/data-delivery/amazon-s3">
    Send results directly to your S3 bucket.
  </Card>
</CardGroup>


# YouTube data delivery to Amazon S3
Source: https://docs.brightdata.com/datasets/scrapers/youtube/data-delivery/amazon-s3

Configure the Bright Data YouTube Scraper API to deliver scraped channel, video and comment data directly to your Amazon S3 bucket on job completion.

This guide shows you how to configure the Bright Data YouTube Scraper API to deliver scraped data directly to your Amazon S3 bucket when a collection job completes.

## Prerequisites

* A [Bright Data account](https://brightdata.com/cp/start) with an active API key
* An AWS account with an S3 bucket
* IAM credentials with write access to the bucket
* Familiarity with the [async request workflow](/datasets/scrapers/youtube/async-requests)

## Step 1: Create an S3 bucket

If you already have a bucket, skip to Step 2.

In the [AWS S3 Console](https://s3.console.aws.amazon.com/s3/buckets):

1. Click **Create bucket**
2. Enter a bucket name (e.g., `youtube-scraper-data`)
3. Select your preferred AWS region
4. Keep default settings and click **Create bucket**

## Step 2: Set up IAM permissions

Create an IAM role that grants Bright Data write access to your bucket.

### Create a policy

In the [IAM Console](https://console.aws.amazon.com/iam/), go to **Policies** and create a new policy with this JSON:

```json theme={null}
{
  "Version": "2012-10-17",
  "Statement": [
    {
      "Effect": "Allow",
      "Action": ["s3:PutObject", "s3:GetObject"],
      "Resource": "arn:aws:s3:::youtube-scraper-data/*"
    }
  ]
}
```

Replace `youtube-scraper-data` with your actual bucket name.

### Create a role for Bright Data

1. Go to **Roles** > **Create role**
2. Select **AWS account** as the trusted entity type
3. Enter Bright Data's AWS account ID: `422310177405`
4. Attach the policy you created above
5. Name the role (e.g., `BrightDataS3Delivery`)
6. Note the role ARN (e.g., `arn:aws:iam::123456789012:role/BrightDataS3Delivery`)

Add an external ID condition to the trust policy:

```json theme={null}
{
  "Version": "2012-10-17",
  "Statement": [
    {
      "Effect": "Allow",
      "Principal": {
        "AWS": "arn:aws:iam::422310177405:role/brd.ec2.zs-dca-delivery"
      },
      "Action": "sts:AssumeRole",
      "Condition": {
        "StringEquals": {
          "sts:ExternalId": "YOUR_BRIGHT_DATA_CUSTOMER_ID"
        }
      }
    }
  ]
}
```

Find your customer ID in [Account settings](https://brightdata.com/cp/setting/customer_details).

## Step 3: Configure delivery in Bright Data

1. Navigate to your [scraper configuration](https://brightdata.com/cp/scrapers)
2. Click the **Delivery settings** tab
3. Select **Amazon S3** as the delivery destination
4. Enter your credentials:
   * **Bucket name**: Your S3 bucket name
   * **Role ARN**: The IAM role ARN from Step 2
   * **Region**: Your S3 bucket region
   * **Path prefix** (optional): A folder path within the bucket (e.g., `youtube/channels/`)
5. Select your preferred file format (JSON, NDJSON, or CSV)
6. Click **Save**

## Step 4: Trigger a collection

Trigger an async collection. Results are automatically delivered to your S3 bucket:

<CodeGroup>
  ```bash cURL theme={null}
  curl -X POST \
    "https://api.brightdata.com/datasets/v3/trigger?dataset_id=gd_lk538t2k2p1k3oos71&format=json" \
    -H "Authorization: Bearer YOUR_API_KEY" \
    -H "Content-Type: application/json" \
    -d '[
      {"url": "https://www.youtube.com/@MrBeast"},
      {"url": "https://www.youtube.com/@PewDiePie"},
      {"url": "https://www.youtube.com/@mkbhd"}
    ]'
  ```

  ```python Python theme={null}
  import requests

  response = requests.post(
      "https://api.brightdata.com/datasets/v3/trigger",
      params={"dataset_id": "gd_lk538t2k2p1k3oos71", "format": "json"},
      headers={
          "Authorization": "Bearer YOUR_API_KEY",
          "Content-Type": "application/json",
      },
      json=[
          {"url": "https://www.youtube.com/@MrBeast"},
          {"url": "https://www.youtube.com/@PewDiePie"},
          {"url": "https://www.youtube.com/@mkbhd"},
      ],
  )

  print("Snapshot ID:", response.json()["snapshot_id"])
  ```

  ```javascript Node.js theme={null}
  const response = await fetch(
    "https://api.brightdata.com/datasets/v3/trigger?dataset_id=gd_lk538t2k2p1k3oos71&format=json",
    {
      method: "POST",
      headers: {
        "Authorization": "Bearer YOUR_API_KEY",
        "Content-Type": "application/json",
      },
      body: JSON.stringify([
        { url: "https://www.youtube.com/@MrBeast" },
        { url: "https://www.youtube.com/@PewDiePie" },
        { url: "https://www.youtube.com/@mkbhd" },
      ]),
    }
  );

  const data = await response.json();
  console.log("Snapshot ID:", data.snapshot_id);
  ```
</CodeGroup>

## Step 5: Verify delivery

Once the collection completes, check your S3 bucket for the delivered file:

```bash theme={null}
aws s3 ls s3://youtube-scraper-data/youtube/channels/
```

You should see a file named with the snapshot ID (e.g., `s_m1a2b3c4d5e6f7g8h.json`).

Download and inspect it:

```bash theme={null}
aws s3 cp s3://youtube-scraper-data/youtube/channels/s_m1a2b3c4d5e6f7g8h.json ./results.json
cat results.json | python -m json.tool | head -20
```

You can also verify delivery status using the [Monitor Delivery API](/api-reference/scrapers/management-apis/monitor-delivery).

## Troubleshooting

<Accordion title="Files not appearing in S3?">
  * Verify the IAM role ARN and external ID are correct
  * Check that the bucket policy allows `s3:PutObject` from Bright Data's account
  * Ensure the bucket region matches your configuration
  * Review delivery status in the Bright Data dashboard under **Logs**
</Accordion>

<Accordion title="Access denied errors?">
  Verify the trust policy on your IAM role includes Bright Data's account (`422310177405`) and your external ID matches your Bright Data customer ID found in [Account settings](https://brightdata.com/cp/setting/customer_details).
</Accordion>

<Accordion title="Delivered file is empty or missing records?">
  Check the collection status in the Bright Data dashboard. If some URLs failed, the delivered file contains only successful results. Retry failed URLs in a separate request.
</Accordion>

## Next steps

<CardGroup>
  <Card title="Set up webhooks" icon="webhook" href="/datasets/scrapers/youtube/data-delivery/webhooks">
    Receive results at your HTTP endpoint.
  </Card>

  <Card title="All delivery options" icon="truck" href="/datasets/scrapers/scrapers-library/delivery-options">
    Snowflake, Azure, GCS, SFTP, and more.
  </Card>
</CardGroup>


# YouTube data delivery via webhook
Source: https://docs.brightdata.com/datasets/scrapers/youtube/data-delivery/webhooks

Configure the Bright Data YouTube Scraper API to push scraped channel, video and comment data to your HTTPS webhook across 3 endpoints as each job completes.

This guide shows you how to set up webhook delivery so your server receives scraped YouTube data automatically when a collection job finishes.

## Prerequisites

* A [Bright Data account](https://brightdata.com/cp/start) with an active API key
* Familiarity with the [async request workflow](/datasets/scrapers/youtube/async-requests)
* A publicly accessible HTTP endpoint (or a testing tool like [webhook.site](https://webhook.site))

## How webhooks work

When you trigger an async collection with an `endpoint` URL, Bright Data sends a `POST` request to that URL with the scraped data once the job completes. No polling required.

```text theme={null}
Your app --> POST /trigger (with webhook URL) --> Bright Data scrapes --> POST to your webhook
```

## Step 1: Set up a test webhook

For testing, use [webhook.site](https://webhook.site) to get a temporary public URL:

1. Open [webhook.site](https://webhook.site) in your browser
2. Copy the unique URL displayed (e.g., `https://webhook.site/abc-123-def`)
3. Keep the page open to monitor incoming requests

## Step 2: Trigger a collection with the webhook URL

Add the `endpoint` query parameter to your async `/trigger` request:

<CodeGroup>
  ```bash cURL theme={null}
  curl -X POST \
    "https://api.brightdata.com/datasets/v3/trigger?dataset_id=gd_lk538t2k2p1k3oos71&format=json&endpoint=https://webhook.site/abc-123-def&uncompressed_webhook=true" \
    -H "Authorization: Bearer YOUR_API_KEY" \
    -H "Content-Type: application/json" \
    -d '[
      {"url": "https://www.youtube.com/@MrBeast"},
      {"url": "https://www.youtube.com/@PewDiePie"}
    ]'
  ```

  ```python Python theme={null}
  import requests

  WEBHOOK_URL = "https://webhook.site/abc-123-def"

  response = requests.post(
      "https://api.brightdata.com/datasets/v3/trigger",
      params={
          "dataset_id": "gd_lk538t2k2p1k3oos71",
          "format": "json",
          "webhook": WEBHOOK_URL,
          "uncompressed_webhook": "true",
      },
      headers={
          "Authorization": "Bearer YOUR_API_KEY",
          "Content-Type": "application/json",
      },
      json=[
          {"url": "https://www.youtube.com/@MrBeast"},
          {"url": "https://www.youtube.com/@PewDiePie"},
      ],
  )

  print("Snapshot ID:", response.json()["snapshot_id"])
  ```

  ```javascript Node.js theme={null}
  const WEBHOOK_URL = "https://webhook.site/abc-123-def";

  const response = await fetch(
    `https://api.brightdata.com/datasets/v3/trigger?dataset_id=gd_lk538t2k2p1k3oos71&format=json&endpoint=${encodeURIComponent(WEBHOOK_URL)}&uncompressed_webhook=true`,
    {
      method: "POST",
      headers: {
        "Authorization": "Bearer YOUR_API_KEY",
        "Content-Type": "application/json",
      },
      body: JSON.stringify([
        { url: "https://www.youtube.com/@MrBeast" },
        { url: "https://www.youtube.com/@PewDiePie" },
      ]),
    }
  );

  const data = await response.json();
  console.log("Snapshot ID:", data.snapshot_id);
  ```
</CodeGroup>

Key parameters:

| Parameter              | Description                                                  |
| :--------------------- | :----------------------------------------------------------- |
| `endpoint`             | Your HTTP endpoint URL that receives the `POST` payload      |
| `uncompressed_webhook` | Set to `true` to receive uncompressed JSON (default is gzip) |
| `format`               | Output format: `json`, `ndjson`, or `csv`                    |

## Step 3: Verify delivery

Once the collection completes (typically 30-60 seconds for a few channels), check your webhook.site page. You should see a `POST` request with the scraped data.

The payload is the same JSON array you would receive from a direct API download:

```json theme={null}
[
  {
    "channel_name": "MrBeast",
    "channel_url": "https://www.youtube.com/@MrBeast",
    "subscribers": 358000000,
    "total_videos": 850,
    "is_verified": true
  },
  {
    "channel_name": "PewDiePie",
    "channel_url": "https://www.youtube.com/@PewDiePie",
    "subscribers": 111000000,
    "total_videos": 4800,
    "is_verified": true
  }
]
```

## Production webhook setup

For production, point the `endpoint` URL to your own server endpoint.

### How to handle webhooks in Express.js

```javascript server.js theme={null}
const express = require("express");
const app = express();

app.use(express.json({ limit: "100mb" }));

app.post("/webhook/youtube", (req, res) => {
  const channels = req.body;
  console.log(`Received ${channels.length} channels`);

  for (const channel of channels) {
    console.log(`- ${channel.channel_name} (${channel.subscribers} subscribers)`);
  }

  res.status(200).json({ received: true });
});

app.listen(3000, () => console.log("Webhook server running on port 3000"));
```

### How to handle webhooks in Flask

```python server.py theme={null}
from flask import Flask, request, jsonify

app = Flask(__name__)

@app.route("/webhook/youtube", methods=["POST"])
def handle_webhook():
    channels = request.get_json()
    print(f"Received {len(channels)} channels")

    for channel in channels:
        print(f"- {channel['channel_name']} ({channel.get('subscribers')} subscribers)")

    return jsonify({"received": True}), 200

if __name__ == "__main__":
    app.run(port=3000)
```

<Warning>
  Return a `200` status code within 30 seconds to acknowledge receipt. If your endpoint fails or times out, Bright Data retries delivery.
</Warning>

## Webhook with authorization

If your endpoint requires authentication, add the `webhook_header_Authorization` parameter:

```bash theme={null}
curl -X POST \
  "https://api.brightdata.com/datasets/v3/trigger?dataset_id=gd_lk538t2k2p1k3oos71&format=json&endpoint=https://your-server.com/webhook&webhook_header_Authorization=Bearer+YOUR_SECRET_TOKEN" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '[{"url": "https://www.youtube.com/@MrBeast"}]'
```

## Allowlist webhook IPs

If your server uses an IP allowlist, add the following Bright Data webhook source IPs:

```text theme={null}
54.175.27.69
34.225.9.175
100.28.38.247
100.29.18.195
52.72.185.255
35.174.112.248
54.165.183.124
3.91.140.7
52.202.75.37
98.82.225.117
100.27.150.189
18.214.10.85
35.169.71.210
44.194.183.74
```

## Troubleshooting

<Accordion title="Webhook not receiving data?">
  * Verify the URL is publicly accessible (not `localhost`)
  * Check that your endpoint returns a `200` status code within 30 seconds
  * Verify the webhook IPs above are allowlisted if you have firewall rules
</Accordion>

<Accordion title="Receiving compressed data?">
  If you omit `uncompressed_webhook=true`, data arrives gzip-compressed. Add `uncompressed_webhook=true` to your trigger URL, or decompress the payload on your server.
</Accordion>

<Accordion title="Payload too large for your server?">
  Large collections can produce payloads up to 1 GB. Set `express.json({ limit: "100mb" })` in Express.js or equivalent in your framework. If you need to handle very large datasets, use [S3 delivery](/datasets/scrapers/youtube/data-delivery/amazon-s3) instead.
</Accordion>

## Next steps

<CardGroup>
  <Card title="Deliver to Amazon S3" icon="bucket" href="/datasets/scrapers/youtube/data-delivery/amazon-s3">
    Store results directly in your S3 bucket.
  </Card>

  <Card title="All delivery options" icon="truck" href="/datasets/scrapers/scrapers-library/delivery-options">
    Snowflake, Azure, GCS, and more.
  </Card>
</CardGroup>


# YouTube Scraper API
Source: https://docs.brightdata.com/datasets/scrapers/youtube/introduction

Use the Bright Data [YouTube Scraper API](https://brightdata.com/products/web-scraper/youtube) to extract structured data from channels, videos and comments. Handles up to 20 URLs per request.

Send a YouTube URL, get structured JSON back. The Bright Data YouTube Scraper API handles proxies, CAPTCHAs, and parsing so you can focus on your data pipeline.

<Tip>
  New to Bright Data? [Create a free account](https://brightdata.com/cp/start) and get \$2 credit to start scraping.
</Tip>

## How it works

You send one or more YouTube URLs to the Bright Data YouTube Scraper API. Bright Data handles the scraping infrastructure and returns clean, structured JSON.

```text theme={null}
Your app  -->  Bright Data API  -->  Structured JSON
           POST /datasets/v3/scrape
           Authorization: Bearer YOUR_API_KEY
```

All requests use a `dataset_id` to specify the data type (videos, channels, or comments) and return results in JSON, NDJSON, or CSV.

## What the response looks like

```bash theme={null}
curl -X POST "https://api.brightdata.com/datasets/v3/scrape?dataset_id=gd_lk538t2k2p1k3oos71&format=json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '[{"url": "https://www.youtube.com/@MrBeast"}]'
```

```json theme={null}
{
  "channel_name": "MrBeast",
  "channel_url": "https://www.youtube.com/@MrBeast",
  "subscribers": 358000000,
  "total_videos": 850,
  "total_views": 50000000000,
  "description": "...",
  "is_verified": true
}
```

## Supported data types

<CardGroup>
  <Card title="Videos" icon="video" href="/api-reference/scrapers/social-media-apis/youtube-videos-collect-by-url">
    Titles, views, likes, descriptions, durations, and thumbnails. Discover videos by keyword, hashtag, or explore.
  </Card>

  <Card title="Channels" icon="user" href="/api-reference/scrapers/social-media-apis/youtube-channels-collect-by-url">
    Subscriber counts, video counts, descriptions, and verification status. Discover channels by keyword.
  </Card>

  <Card title="Comments" icon="comments" href="/api-reference/scrapers/social-media-apis/youtube-comments-collect-by-url">
    Comment text, likes, replies, commenter details for any video.
  </Card>
</CardGroup>

## Request methods

The Bright Data YouTube Scraper API supports two request methods. Choose based on your volume and latency needs.

| Method           | Endpoint                                                   | Best for                                   |
| :--------------- | :--------------------------------------------------------- | :----------------------------------------- |
| **Synchronous**  | [`/scrape`](/datasets/scrapers/youtube/send-first-request) | Real-time lookups, up to 20 URLs           |
| **Asynchronous** | [`/trigger`](/datasets/scrapers/youtube/async-requests)    | Batch jobs, 20+ URLs, production pipelines |

Learn more in [Understanding sync vs. async requests](/datasets/scrapers/concepts/sync-vs-async).

## Capabilities and limits

| Capability                     | Detail                                                                                                                                                                                                                                   |
| :----------------------------- | :--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Output formats**             | JSON, NDJSON, CSV                                                                                                                                                                                                                        |
| **Max URLs per sync request**  | 20                                                                                                                                                                                                                                       |
| **Max URLs per async request** | 5,000                                                                                                                                                                                                                                    |
| **Data freshness**             | Real-time (scraped on demand)                                                                                                                                                                                                            |
| **Delivery options**           | API download, [Webhook](/datasets/scrapers/youtube/data-delivery/webhooks), [Amazon S3](/datasets/scrapers/youtube/data-delivery/amazon-s3), Snowflake, Azure, GCS ([all options](/datasets/scrapers/scrapers-library/delivery-options)) |
| **Pricing**                    | Pay per successful record ([see pricing](https://brightdata.com/pricing/web-scraper))                                                                                                                                                    |

## Common questions

<Accordion title="Is the data scraped in real time?">
  Yes. Each request triggers a live scrape. There is no cached or stale data. Response times vary by endpoint: channels typically return in 10-30 seconds (sync), while discovery requests may take longer depending on result volume.
</Accordion>

<Accordion title="What is the difference between URL collection and discovery?">
  **URL collection** scrapes a specific YouTube page you provide (e.g., a channel URL). **Discovery** finds YouTube content matching search criteria (e.g., videos by keyword or hashtag) and scrapes the results. Discovery is only available via async requests.
</Accordion>

<Accordion title="How is this different from scraping using proxies or Web Unlocker?">
  When scraping using proxies or Web Unlocker, you still need to write and maintain
  your own parsing logic and update it whenever YouTube changes its page structure.
  The YouTube Scraper API handles the entire stack: proxy rotation, anti-bot bypassing
  and parsing. You simply send a YouTube URL and get clean, structured JSON back with
  no scraping infrastructure or parser maintenance required on your end.
</Accordion>

## Next steps

<CardGroup>
  <Card title="Quickstart" icon="rocket" href="/datasets/scrapers/youtube/quickstart">
    Scrape your first YouTube channel in 5 minutes.
  </Card>

  <Card title="Send your first request" icon="bolt" href="/datasets/scrapers/youtube/send-first-request">
    Full code examples in cURL, Python, and Node.js.
  </Card>

  <Card title="API reference" icon="code" href="/api-reference/scrapers/social-media-apis/youtube-channels-collect-by-url">
    Endpoint specs, parameters, and response schemas.
  </Card>
</CardGroup>


# YouTube scraper quickstart
Source: https://docs.brightdata.com/datasets/scrapers/youtube/quickstart

Set up the Bright Data YouTube Scraper API and collect your first channel, video or comment as structured JSON in under 5 minutes from the Control Panel.

This tutorial shows you how to scrape a YouTube channel and get structured JSON data using the Bright Data YouTube Scraper API.

## Prerequisites

* A [Bright Data account](https://brightdata.com/cp/start) (includes \$2 free credit)
* cURL, Python 3, or Node.js 18+ installed

<Steps>
  <Step title="Get your API key">
    Go to the [user settings page](https://brightdata.com/cp/setting/users) in your Bright Data account and copy your API key.

    If you don't have an account yet, [sign up at brightdata.com](https://brightdata.com/cp/start). New users get \$2 free credit for testing.

    <Warning>
      Your API key is shown only once when created. Copy and store it securely.
    </Warning>
  </Step>

  <Step title="Send a request">
    We'll use the **Channels endpoint** with a synchronous request. Replace `YOUR_API_KEY` with your actual token:

    <CodeGroup>
      ```bash cURL theme={null}
      curl -X POST \
        "https://api.brightdata.com/datasets/v3/scrape?dataset_id=gd_lk538t2k2p1k3oos71&format=json" \
        -H "Authorization: Bearer YOUR_API_KEY" \
        -H "Content-Type: application/json" \
        -d '[{"url": "https://www.youtube.com/@MrBeast"}]'
      ```

      ```python Python theme={null}
      import requests

      response = requests.post(
          "https://api.brightdata.com/datasets/v3/scrape",
          params={"dataset_id": "gd_lk538t2k2p1k3oos71", "format": "json"},
          headers={
              "Authorization": "Bearer YOUR_API_KEY",
              "Content-Type": "application/json",
          },
          json=[{"url": "https://www.youtube.com/@MrBeast"}],
      )

      print(response.json())
      ```

      ```javascript Node.js theme={null}
      const response = await fetch(
        "https://api.brightdata.com/datasets/v3/scrape?dataset_id=gd_lk538t2k2p1k3oos71&format=json",
        {
          method: "POST",
          headers: {
            "Authorization": "Bearer YOUR_API_KEY",
            "Content-Type": "application/json",
          },
          body: JSON.stringify([
            { url: "https://www.youtube.com/@MrBeast" }
          ]),
        }
      );

      const data = await response.json();
      console.log(data);
      ```
    </CodeGroup>

    You should see a `200` status code. This takes 10-30 seconds.
  </Step>

  <Step title="Review the response">
    The Bright Data YouTube Scraper API returns a JSON array with structured channel data:

    ```json theme={null}
    [
      {
        "channel_name": "MrBeast",
        "channel_url": "https://www.youtube.com/@MrBeast",
        "subscribers": 358000000,
        "total_videos": 850,
        "total_views": 50000000000,
        "description": "...",
        "is_verified": true
      }
    ]
    ```

    Each channel object includes fields covering subscriber counts, video counts, description, and more. See the [full response schema](/api-reference/scrapers/social-media-apis/youtube-channels-collect-by-url).
  </Step>
</Steps>

You've successfully scraped your first YouTube channel using the Bright Data YouTube Scraper API.

## Common questions

<Accordion title="Can I scrape multiple channels in one request?">
  Yes. Add more objects to the input array. Synchronous requests support up to 20 URLs. For larger batches, use the [async `/trigger` endpoint](/datasets/scrapers/youtube/async-requests).

  ```json theme={null}
  [
    {"url": "https://www.youtube.com/@MrBeast"},
    {"url": "https://www.youtube.com/@PewDiePie"},
    {"url": "https://www.youtube.com/@mkbhd"}
  ]
  ```
</Accordion>

<Accordion title="Getting a 401 or 403 error?">
  Verify your API key is correct and hasn't expired. Generate a new token from [Account settings](https://brightdata.com/cp/setting/users). See the [authentication guide](/api-reference/authentication) for details.
</Accordion>

<Accordion title="Request is timing out?">
  Synchronous requests have a 1-minute timeout. If the request exceeds this limit, it automatically switches to async and returns a `snapshot_id`. Use the [async workflow](/datasets/scrapers/youtube/async-requests) for large batches.
</Accordion>

<Accordion title="Empty or partial response data?">
  Verify the YouTube channel URL is publicly accessible and correctly formatted. The URL should follow the pattern `https://www.youtube.com/@handle`.
</Accordion>

## Next steps

<CardGroup>
  <Card title="Send your first request" icon="bolt" href="/datasets/scrapers/youtube/send-first-request">
    Explore all three endpoint types with full examples.
  </Card>

  <Card title="Async batch requests" icon="layer-group" href="/datasets/scrapers/youtube/async-requests">
    Scrape hundreds of URLs in a single batch job.
  </Card>

  <Card title="Set up webhooks" icon="webhook" href="/datasets/scrapers/youtube/data-delivery/webhooks">
    Receive results automatically when scraping completes.
  </Card>
</CardGroup>


# Send your first YouTube API request
Source: https://docs.brightdata.com/datasets/scrapers/youtube/send-first-request

Send synchronous requests to all 3 Bright Data YouTube Scraper API endpoints with copy-paste examples for channels, videos and comments collection.

This tutorial walks you through sending a synchronous request to each Bright Data YouTube Scraper API endpoint. By the end, you'll have working examples for channels, videos, and comments.

## Prerequisites

* A [Bright Data account](https://brightdata.com/cp/start) with an active API key
* Completed the [Quickstart](/datasets/scrapers/youtube/quickstart)

## Request structure

Every synchronous request follows the same pattern:

```http theme={null}
POST https://api.brightdata.com/datasets/v3/scrape?dataset_id={DATASET_ID}&format=json
Authorization: Bearer YOUR_API_KEY
Content-Type: application/json

[{"url": "https://www.youtube.com/..."}]
```

The only thing that changes between endpoints is the `dataset_id` and the input URL format.

<Note>
  Synchronous requests support up to 20 URLs and have a 1-minute timeout. If the request takes longer, the API automatically returns a `snapshot_id` instead. See [async requests](/datasets/scrapers/youtube/async-requests).
</Note>

## How to scrape YouTube channels

**Dataset ID:** `gd_lk538t2k2p1k3oos71`

```bash theme={null}
curl -X POST \
  "https://api.brightdata.com/datasets/v3/scrape?dataset_id=gd_lk538t2k2p1k3oos71&format=json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '[{"url": "https://www.youtube.com/@MrBeast"}]'
```

You should see a `200` response. This takes 10-30 seconds.

<Accordion title="Example response">
  ```json theme={null}
  [
    {
      "channel_name": "MrBeast",
      "channel_url": "https://www.youtube.com/@MrBeast",
      "subscribers": 358000000,
      "total_videos": 850,
      "total_views": 50000000000,
      "description": "...",
      "is_verified": true
    }
  ]
  ```
</Accordion>

[Full Channels response schema](/api-reference/scrapers/social-media-apis/youtube-channels-collect-by-url)

## How to scrape YouTube videos

**Dataset ID:** `gd_lk56epmy2i5g7lzu0k`

```bash theme={null}
curl -X POST \
  "https://api.brightdata.com/datasets/v3/scrape?dataset_id=gd_lk56epmy2i5g7lzu0k&format=json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '[{"url": "https://www.youtube.com/watch?v=dQw4w9WgXcQ"}]'
```

<Accordion title="Example response">
  ```json theme={null}
  [
    {
      "url": "https://www.youtube.com/watch?v=dQw4w9WgXcQ",
      "title": "Rick Astley - Never Gonna Give You Up",
      "channel_name": "Rick Astley",
      "views": 1500000000,
      "likes": 16000000,
      "date_posted": "2009-10-25T00:00:00.000Z",
      "duration": "3:33",
      "description": "...",
      "num_comments": 2700000
    }
  ]
  ```
</Accordion>

[Full Videos response schema](/api-reference/scrapers/social-media-apis/youtube-videos-collect-by-url)

## How to scrape YouTube comments

**Dataset ID:** `gd_lk9q0ew71spt1mxywf`

```bash theme={null}
curl -X POST \
  "https://api.brightdata.com/datasets/v3/scrape?dataset_id=gd_lk9q0ew71spt1mxywf&format=json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '[{"url": "https://www.youtube.com/watch?v=dQw4w9WgXcQ"}]'
```

<Accordion title="Example response">
  ```json theme={null}
  [
    {
      "url": "https://www.youtube.com/watch?v=dQw4w9WgXcQ",
      "comment_user": "user123",
      "comment_user_url": "https://www.youtube.com/@user123",
      "comment_date": "2024-04-05T12:30:00.000Z",
      "comment": "This song never gets old!",
      "likes": 250,
      "replies": 12,
      "comment_id": "UgyKz0..."
    }
  ]
  ```
</Accordion>

[Full Comments response schema](/api-reference/scrapers/social-media-apis/youtube-comments-collect-by-url)

## Quick reference: dataset IDs

| Endpoint | Dataset ID              | URL pattern                      |
| :------- | :---------------------- | :------------------------------- |
| Videos   | `gd_lk56epmy2i5g7lzu0k` | `youtube.com/watch?v={video_id}` |
| Channels | `gd_lk538t2k2p1k3oos71` | `youtube.com/@{handle}`          |
| Comments | `gd_lk9q0ew71spt1mxywf` | `youtube.com/watch?v={video_id}` |

## Output formats

Control the response format with the `format` query parameter:

| Value    | Description                                 |
| :------- | :------------------------------------------ |
| `json`   | JSON array (default)                        |
| `ndjson` | Newline-delimited JSON, one record per line |
| `csv`    | Comma-separated values                      |

## Next steps

<CardGroup>
  <Card title="Async batch requests" icon="layer-group" href="/datasets/scrapers/youtube/async-requests">
    Scrape hundreds of URLs in a single batch job.
  </Card>

  <Card title="API reference" icon="code" href="/api-reference/scrapers/social-media-apis/youtube-channels-collect-by-url">
    Full parameter and response field reference.
  </Card>
</CardGroup>


# Bright Data's Asset Shield
Source: https://docs.brightdata.com/scraping-automation/bright-shield/asset-shield

Protect your domain with Bright Data Asset Shield in 4 steps: monitor traffic, set rules and receive alerts to secure your online assets at scale.

Asset shield product provides data about the incoming brightdata traffic to the customers' domain, in order to:

* Successfully split organic and proxy traffic to their domain
* Monitor specific endpoints to ensure forbidden endpoints are not accessed
* Define rate limit for site paths/specific patterns inside the results
* Discover trends according to what people are scraping from my site

## Asset shield features

To use Asset Shield features, the customer will need to add a domain and verify that he owns it.

### Add a domain

* Login to your account and navigate to the Asset Shield page.
* Add a new domain
  * If you don't have a domain yet, click the “Add domain” button
  * If you do have a domain, click on the domain dropdown and select “Add domain” option
* Follow the instructions in the form
  * Enter your domain
  * Copy record into the DNS configuration of your domain
  * Click verify

<Note>
  DNS changes may take some time to apply. If we can't find the record immediately, wait a day and try to verify again.
</Note>

### How to monitor your data

The Data Monitor feature allows customers to view the traffic volume of other Bright Data's customers to their domain for the chosen timeframe, monitor specific endpoints in their website based on their path or a custom pattern, and get alerts when the amount of requests to these endpoints cross the threshold they defined.

<Accordion title="What can I see in the Data Monitor page?">
  On the Data Monitor page, you can access a chart that visualizes all incoming proxy traffic to your domain. This chart offers filtering options based on IP type (desktop/mobile), Proxy IP country, and crawler country (request origin).

  <Frame>
    <img alt="Number of Requests" />

    <img alt="Filters" />
  </Frame>

  Below the chart, you'll find the rules table for further review.
</Accordion>

### Adding and using rules

Asset Shield offers customers the ability to establish rules for specific paths or patterns within their own domain. Once a rule is set up, a new entry is created in the table, displaying the number of requests to the specified path or pattern. Customers can also set a threshold for hourly requests, triggering an alert when exceeded.

To add rules:

<Steps>
  <Step title="Login">
    Login and navigate to the Asset Shield page.
  </Step>

  <Step title="Select a Domain">
    <Note>
      If you don't have any domains, follow the "How to Add a Domain" guide first.
    </Note>
  </Step>

  <Step title="Open Data Monitor">
    * Click "Manage" next to Data Monitor.
    * Click on "Add Rule."
  </Step>

  <Step title="Choose Rule Type">
    * Select "Add New" under the preset options.
    * Choose between a path rule or a pattern rule.

    <Tabs>
      <Tab title="Path Rule">
        Enter the desired path using regex.

        Example: `/path1/path2/*` will track all requests to any path starting with `/path1/path2/`.
      </Tab>

      <Tab title="Pattern Rule">
        Specify a pattern or content to track using regex.

        Example: entering "electronics" will track requests containing the word "electronics."
      </Tab>
    </Tabs>
  </Step>

  <Step title="Set Alerts (Optional)">
    * Add email addresses of designated users to receive alerts when the hourly request amount exceeds a custom threshold.
    * Choose the threshold value for the alert.
  </Step>
</Steps>

<Frame>
  <img alt="Adding and using rules" />
</Frame>

## Asset Shield Billing

Asset Shield's pricing is based on the bandwidth to the selected domain, starting at \$0.2 per gigabyte with a minimum monthly commitment of \$10,000. This commitment is separate from any other monthly commitments the account may have.

<Tip>
  For larger packages with reduced bandwidth rates, please get in touch with your account manager for further details.
</Tip>


# Get to know Bright Shield
Source: https://docs.brightdata.com/scraping-automation/bright-shield/introduction

Bright Shield is Bright Data's risk management suite for ensuring web scraping activities are conducted legally, ethically, and in a compliant manner.

Bright-Shield is a risk management suite of solutions, ensures scraping activities are being done legally, ethically and in a compliant manner, protecting both the business doing the scraping, and the target website.

<CardGroup>
  <Card title="Asset Shield" icon="shield" href="/scraping-automation/bright-shield/asset-shield">
    Monitor traffic originated from Bright Data to your website
  </Card>

  <Card title="Scraping Shield" icon="spider" href="/scraping-automation/bright-shield/scraping-shield">
    Monitor traffic sent from your Bright Data account
  </Card>
</CardGroup>


# Bright Data's Scraping Shield
Source: https://docs.brightdata.com/scraping-automation/bright-shield/scraping-shield

Control outgoing proxy traffic with Scraping Shield across 4 steps: classify domains, set rules, block requests and receive alerts to secure data flow.

Scraping shield provides data about the outgoing proxy traffic of the customers so they can have better control on their traffic, additionally, it also allows to trigger predefined actions when certain conditions are met, such as: send email alerts, block requests, etc.

## Scraping shield features

### How domains are classified

The domain classification feature categorizes outgoing traffic from the customer's proxy operations into groups like Shopping, Social Media, and Travel. Customers can see how much traffic goes to each category and drill down to see specific domains. They can also set rules to block specific categories or domains from proxy usage, and alert designated users when there is an access attempt.

<Accordion title="What can I see in the Domain Classification page?">
  On the domain classification page, you can view a chart that displays all outgoing proxy traffic from your account. This chart can be broken down by classification, domain, or zone.

  <Frame>
    <img alt="Traffic Chart" />
  </Frame>

  Additionally, there is a table that shows all traffic broken down by classification. Customers can expand each row of this table to see the specific domains or zones used, along with the number of requests and the amount of traffic to these domains/zones.

  <Frame>
    <img alt="Classification Table" />
  </Frame>

  Customers can also add rules to perform specific actions when a specific class/domain is targeted.
</Accordion>

### Adding and using rules

Rules provide the ability for the customer to set specific actions or alerts based on the classification or domains of outgoing traffic. These rules include the ability to block requests to certain classifications or domains and to set alerts when a specific class or domain has been targeted.

There are 2 ways to add rules:

<Tabs>
  <Tab title="Create rule from scratch">
    * Login to your account and go to Domain Classification page.
    * Choose the 'Rules' tab in the top of the page.
    * Click on 'Add rule'
    * Choose if the rule should apply to an entire classification or a specific domain
    * The “Block requests” checkbox will block all requests to the chosen classification/domain when enabled.
    * The “Notify..” checkbox will allow you to send alerts to designated users when a minimum number of requests have been sent to the chosen classification/domain.

    <Frame>
      <img alt="Create rule from Scratch" />
    </Frame>
  </Tab>

  <Tab title="Create rule from stats table">
    * Login to your account and go to Domain Classification page.
    * Review the table below the graph, and choose a classification or domain you want to add a rule to
    * Hover the mouse over the rules cell in the chosen class/domain and click the + icon
    * The “Block requests” checkbox will block all requests to the chosen classification/domain when enabled.
    * The “Notify..” checkbox will allow you to send alerts to designated users when a minimum number of requests have been sent to the chosen classification/domain.

    <Frame>
      <img alt="Create rule from stats table" />
    </Frame>
  </Tab>
</Tabs>

***

<Accordion title="Downloading sample requests">
  You can view sample requests sent from your account to the chosen domain, which include the timestamp of the request, origin IP, zone, bandwidth (in bytes), and the total duration of the request.
</Accordion>

## Scraping Shield - Billing

Scraping Shields pricing is \$10k/month at the minimum. The price for customers with usage costs of more than \$200k/month will be an additional 5% of their usage costs instead. (Actual usage costs, not the monthly commitment itself).

For example, a customer with usage costs of \$150k/month will pay the minimum \$10k/month, but a customer with \$220k/month will pay \$11k/month.

The usage cost is the total amount of money that was utilized by using the service, and only for products that are relevant for Scraping Shield usage are taken into account: All proxy products, Web-Scraper IDE and Custom Datasets. (all products but marketplace datasets)

<Tip>
  [Click here](/api-reference/scraping-shield-api/all-classification-data) to learn about Scraping Shield API Reference
</Tip>


# Crawl API overview
Source: https://docs.brightdata.com/scraping-automation/crawl-api/overview

Use Crawl API to extract content as Markdown, HTML, or JSON. Built for AI training data, SEO audits, and content workflows.

## Key Features

* Crawl Any Domain. Extract Any Data.
* Collect static and dynamic content in Markdown, HTML, or plain text
* Automate at scale with scheduler support and webhook delivery
* Developer-first: works with Python, Node.js, BeautifulSoup, Cheerio, and more
* No-code option available via our Control Panel

## Use Cases

* AI/LLM training data collection
* Competitive research and content aggregation
* Compliance and accessibility checks
* Content migration and archiving


# Getting started
Source: https://docs.brightdata.com/scraping-automation/crawl-api/quick-start

Get started with the Bright Data Crawl API using either of 2 methods (API or no-code Control Panel) to trigger crawl jobs and retrieve structured data.

There are two ways to use Crawl API:

1. API-Based collection
2. No-Code collection (via Control Panel)

## How to collect via API

1. [Trigger a data collection](/api-reference/rest-api/scraper/asynchronous-requests) job via a simple HTTP POST
2. Specify the URLs and output format
3. Receive a `snapshot_id` to retrieve results later.

```sh Code Example theme={null}
curl -H "Authorization: Bearer API_KEY" -H "Content-Type: application/json" -d '[{"url":"https://example.com"},{"url":"https://example.com/1"}]' "https://api.brightdata.com/datasets/v3/trigger?dataset_id=<dataset_id>&include_errors=<true/false>&custom_output_fields=<custom_output_fields>"
```

### Query Parameters:

<ParamField type="query">
  Your dataset ID (e.g., `gd_m6gjtfmeh43we6cqc`)
</ParamField>

<ParamField type="query">
  include error logs in results
</ParamField>

<ParamField type="query">
  `markdown`, `html`, `ld_json`, etc.  \\

  Choose the format that best fits your workflow:

  <CodeGroup>
    ```md markdown theme={null}
    # Main Article Title

    This is the introduction paragraph with **bold text** and *italics*.

    ## Subheading

    - List item one
    - List item two

    > This is a blockquote from the articlesh Code Example


    [Link text](https://example.com/more-info)
    ![Image description](https://example.com/image.jpg)
    ```

    ```html html2text theme={null}

    Main Article Title

    This is the introduction paragraph with bold text and italics.

    Subheading

    * List item one
    * List item two

    This is a blockquote from the articlesh Code Example


    Link text [https://example.com/more-info]
    [Image: Image description]
    ```

    ```html page_html theme={null}
    <!DOCTYPE html>
    <html lang="en">
    <head>
      <meta charset="UTF-8">
      <meta name="viewport" content="width=device-width, initial-scale=1.0">
      <title>Example Article</title>
      <link rel="stylesheet" href="/styles.css">
      <script src="/analytics.js"></script>
    </head>
    <body>
      <header>
        <nav><!-- Navigation HTML --></nav>
      </header>
      <main>
        <h1>Main Article Title</h1>
        <p>This is the introduction paragraph with <strong>bold text</strong> and <em>italics</em>.</p>
        <h2>Subheading</h2>
        <ul>
          <li>List item one</li>
          <li>List item two</li>
        </ul>
        <blockquote>This is a blockquote from the article</blockquote>
        <a href="https://example.com/more-info">Link text</a>
        <img src="https://example.com/image.jpg" alt="Image description">sh Code Example
      </main>
    </body>
      <footer><!-- Footer HTML --></footer>
    </html>
    ```

    ```json ld_json theme={null}
    {
      "@context":"https://schema.org",
      "@type":"Article",
      "headline":"Main Article Title",
      "author":{
        "@type":"Person",
        "name":"Jane Smith"
      },
      "datePublished":"2023-08-15T12:00:00Z",
      "dateModified":"2023-08-15T14:22:31Z",
      "publisher":{
        "@type":"Organization",
        "name":"Example Publication",
        "logo":{
          "@type":"ImageObject",
          "url":"https://example.com/logo.png"
        }
      },
      "image":"https://example.com/image.jpg",
      "description":"This is the introduction paragraph with bold text and italics.",
      "mainEntityOfPage":"https://example.com/article"
    }
    ```
  </CodeGroup>
</ParamField>

## How results are delivered

Deliver results to:

* Webhooks
* External storage (S3, GCS, etc.)
* Direct download via API or Control Panel

## No-Code Scraper (Control Panel)

Use our Control Panel to launch crawls without writing a single line of code.
Steps:

1. Open the Crawl API Control Panel
2. Enter the target domain or URLs
3. Choose your output format
4. Start the crawl
5. Download results directly from the dashboard


# Easy Scraper FAQs
Source: https://docs.brightdata.com/scraping-automation/easy-scraper/faqs

FAQs about Bright Data Easy Scraper across 4 topics: getting started, managing inputs, choosing delivery formats and troubleshooting issues quickly.

<AccordionGroup>
  <Accordion title="What is Easy Scraper?">
    Easy Scraper is a user-friendly data collection tool that allows users to gather information from various online platforms using predefined scrapers. It's designed to simplify the scraping process, making it accessible to users with minimal technical expertise.
  </Accordion>

  <Accordion title="How do I get started with Easy Scraper?">
    To get started, log into your account, navigate to the Easy Scraper section, select a scraper, input your parameters, and run the scraper. You can then get the data in your preferred format.
  </Accordion>

  <Accordion title="How do I use Easy Scraper?">
    Use Easy Scraper by selecting a scraper, adding your inputs, setting a result limit if necessary, choosing where to store the data, and starting the collection process. You can monitor and retrieve your data from the Logs tab.
  </Accordion>

  <Accordion title="What is the difference between the scrapers?">
    Each scraper is designed to collect data from a specific domain. For example, the Amazon products scraper collects product information, while the LinkedIn profiles scraper gathers data from LinkedIn profiles. The specific inputs required and the type of data collected will vary depending on the domain.
  </Accordion>

  <Accordion title="Are there any limitations on the scrapers?">
    Certain scrapers may have limitations based on the data source, such as rate limits or restricted data access. all limitations will be display on the specific scraper page, The system will notify you if any limitations are encountered during the scraping process.
  </Accordion>

  <Accordion title="What data formats does the Easy Scraper support?">
    The Scrapers supports data extraction in various formats, including JSON, NDJSON, JSON Lines, and CSV. Specify your desired format in the request parameters.
  </Accordion>

  <Accordion title="What are the rates for the Easy Scraper?">
    We charge based on records delivered from valid inputs. The rate per record depends on your subscription plan. Please check [our pricing plans](https://brightdata.com/pricing/web-scraper) or your account details for specific rates.
  </Accordion>

  <Accordion title="How can I upgrade my subscription plan?">
    To upgrade your subscription plan, go to the billing section of your dashboard and select the desired plan. For further assistance, contact our support team: you can do this from the Question Mark (?) button on the top right corner of your Control Panel, directly from this link: [https://brightdata.zendesk.com/hc/en-us/requests/new](https://brightdata.zendesk.com/hc/en-us/requests/new), or by sending an email to [support@brightdata.com](mailto:support@brightdata.com).
  </Accordion>

  <Accordion title="How fast is the Easy Scraper?">
    The Easy Scraper response time is influenced by factors such as the load time of the target URL and the execution of user-defined page interactions. An indication of the avg response time per for each scraper can be found on the specific Scraper page.

    <Frame>
      <img alt="response-time-per-input.png" />
    </Frame>
  </Accordion>

  <Accordion title="How can i use your tools to access the same info in a user-friendly manner?">
    For every API scraper, we also offer a no-code simple scraper, which you can leverage to retrieve the same data&#x20;
  </Accordion>
</AccordionGroup>


# Five-minute how-to: Easy Scraper
Source: https://docs.brightdata.com/scraping-automation/easy-scraper/five-minute-how-to

Collect your first dataset with Bright Data Easy Scraper in 5 minutes. No code, no setup: select a scraper, enter inputs and download your results.

This guide helps you collect your first dataset using **Easy Scraper** in under five minutes.\
No code. No setup. Just select a scraper, run it, and download your data.

## What you’ll do in 5 minutes

* Open Easy Scraper
* Select a ready-made scraper
* Enter inputs
* Run the scraper
* Download the results

## Step 1: Open Easy Scraper

1. Log in to your Bright Data account.
2. From the dashboard, go to **Easy Scraper**.
3. You’ll see a list of available scrapers such as Amazon, Airbnb, Instagram, and LinkedIn.

## Step 2: Choose a Scraper

1. Click the scraper that matches the website you want to collect data from.
2. This opens the scraper configuration page.

Each scraper is prebuilt for a specific platform and data type.

## Step 3: Enter Inputs

1. Provide the required inputs for the selected scraper, such as:
   * Keywords
   * URLs
   * Profiles, posts, or listing links (depending on the scraper)
2. Make sure the inputs are valid and complete.

## Step 4: Optional Result Limit

1. Set a maximum number of records if needed.
2. Leave it empty to collect all available data.

This is useful for testing or small sample collections.

## Step 5: Start Collecting

1. Click **Start Collecting**.
2. You will be redirected to the **Logs** page.

From the Logs page, you can view:

* Job status
* Snapshot ID
* Number of records collected
* File size
* Any errors

## Step 6: Download Your Data

1. Once the job is completed, download the dataset.
2. Available formats include:
   * JSON
   * CSV
   * NDJSON
   * JSON Lines

Choose the format that best fits your workflow.


# Product overview
Source: https://docs.brightdata.com/scraping-automation/easy-scraper/overview

Use Bright Data Easy Scraper to collect structured data from supported sites with prebuilt scrapers configured from the Control Panel, no custom code required.

Easy Scraper is a **plug-and-play data collection solution** that enables users to quickly collect structured data from supported websites using **prebuilt scrapers**.

It eliminates the need for custom scraping logic or infrastructure. Through an intuitive control panel, users can:

* Select a ready-made scraper for a specific domain
* Provide basic input parameters
* Configure simple collection preferences
* Retrieve data in multiple download formats

Easy Scraper is designed for users who want fast results with minimal setup, making it suitable for both technical and non-technical users.

<Frame>
  <img alt="initiate-data-collection.png" />
</Frame>

Limitations&#x20;
File size
---------

Easy Scraper supports the following file size limits:

* **Input size:** Up to **1 GB**
* **Download size:** Up to **5 GB**

For datasets larger than 5 GB, we recommend using **API-based delivery** to ensure reliable and efficient data transfer.


# Getting started with Easy Scraper
Source: https://docs.brightdata.com/scraping-automation/easy-scraper/quickstart

Get started with Bright Data Easy Scraper in 3 steps: select a prebuilt scraper, run it and download structured data from popular sites without code.

The **Easy Scraper** allows you to collect structured data from popular websites without writing code or managing scraping infrastructure. It provides prebuilt scrapers for common platforms and handles extraction, scaling, and data formatting automatically.

This guide walks you through the complete process, from selecting a scraper to downloading your data.

<Steps>
  <Step title="Access the Control Panel">
    * Log in to your Bright Data account and open the dashboard.
    * Navigate to the [**Easy Scraper**](https://brightdata.com/products/web-scraper/easy-scraper) section from the left-hand menu.
    * You will see a catalog of prebuilt scrapers designed for popular platforms such as Amazon products, Airbnb listings, Instagram posts, LinkedIn profiles, and more.
    * Each scraper is optimized to collect structured data from its specific domain.

    <Frame>
      <img alt="select-target.png" />
    </Frame>
  </Step>

  <Step title="Select a Scraper">
    * Choose the scraper that matches the website or platform you want to collect data from.
    * Click on the corresponding scraper card to open its configuration screen.
    * Selecting the correct scraper ensures accurate extraction and domain-specific data fields.
  </Step>

  <Step title="Input Parameters">
    * Provide the required input parameters for the selected scraper.
    * Inputs vary depending on the platform and may include:
      * Keywords or search terms
      * Profile URLs or post URLs
      * Listing or category page URLs
    * Enter accurate inputs to ensure relevant and complete results.

    <Frame>
      <img alt="instagram-posts.png" />
    </Frame>
  </Step>

  <Step title="Set Result Limit (Optional)">
    * Optionally, define the maximum number of records you want to collect.
    * If a limit is set, the scraper stops once the limit is reached.
    * If no limit is specified, the scraper will collect all available data based on your inputs.
    * Setting a limit is useful when testing or when you only need a sample dataset.
  </Step>

  <Step title="Run and Monitor">
    * Click the **Start Collecting** button to begin the data collection process.
    * You will be redirected to the **Logs** tab, where you can monitor the job in real time.
    * The Logs tab displays key details such as:
      * Snapshot ID
      * Dataset name
      * Timestamp
      * Job status (Running, Completed, Failed)
      * Collection time
      * Number of records collected
      * File size
      * Any errors or warnings
  </Step>

  <Step title="Retrieve Data">
    * Once the data collection is complete, your dataset will be available for download.
    * You can download the results in one of the following formats:
      1. `JSON`
      2. `CSV`
      3. `NDJSON`
      4. `JSON Lines`
    * Choose the format that best fits your analysis or integration workflow.

    <Frame>
      <img alt="retrieve-data.png" />
    </Frame>
  </Step>
</Steps>


# FAQ: Scraping automation products
Source: https://docs.brightdata.com/scraping-automation/faqs

FAQs on integrating, configuring and using Bright Data's Scraping Automation products (1000+ scrapers), including IP types, geotargeting and error codes.

<AccordionGroup>
  <Accordion title="How can I avoid getting blocked by Cloudflare or Cloudflare Turnstile?">
    To scrape data from sites that use Cloudflare or Cloudflare Turnstile, we recommend using our [Web Unlocker API](/scraping-automation/web-unlocker/introduction) or [Browser API](/scraping-automation/scraping-browser/introduction) solutions.

    Both solutions use different methods such as CAPTCHA solving, custom fingerprints and headers and can easily overcome cloud flare.

    [Web Unlocker API](/scraping-automation/web-unlocker/introduction) is recommended if you simply need to `GET` HTML from a website, without doing any interactions on the page.

    [Browser API](/scraping-automation/scraping-browser/introduction) is recommended if you need to interact with the page (for example, fill forms, click buttons et cetera)

    In both cases, you will be able to access the information you need on the page, even if it uses Cloudflare or Cloudflare Turnstile.
  </Accordion>

  <Accordion title="How can I avoid getting blocked by Datadome?">
    To scrape data from sites that use Datadome, we recommend using our [Web Unlocker API](/scraping-automation/web-unlocker/introduction) or [Browser API](/scraping-automation/scraping-browser/introduction) solutions.

    Both solutions use different methods such as CAPTCHA solving, custom fingerprints and headers and can easily overcome cloud flare.

    [Web Unlocker API](/scraping-automation/web-unlocker/introduction) is recommended if you simply need to `GET` HTML from a website, without doing any interactions on the page.

    [Browser API](/scraping-automation/scraping-browser/introduction) is recommended if you need to interact with the page (for example, fill forms, click buttons et cetera)

    In both cases, you will be able to access the information you need on the page, even if it uses Datadome.
  </Accordion>

  <Accordion title="Which websites are classified as Premium Domains?">
    Premium domains are websites that require additional Web Unlocker API resources due to their complexity in unblocking. See more details on [premium domains and pricing](/scraping-automation/web-unlocker/features#web-unlocker-api-premium-domains).

    ### List of Premium Domains

    <Note> The premium domains list is updated quarterly using our website classification logic and we’ll notify you via email 30 days in advance of any changes to your domains. You can always access the most up-to-date list in your Web Unlocker API zone.</Note>

    |                        |                      |                           |
    | ---------------------- | -------------------- | ------------------------- |
    | advanceautoparts.com   | giantfoodstores.com  | realcanadiansuperstore.ca |
    | affitto.it             | gopuff.com           | realestate.com.au         |
    | agoda.cn               | gplay.bg             | restaurantguru.com        |
    | albertsons.com         | hermes.com           | searchpeoplefree.com      |
    | allpeople.com          | hyatt.com            | shopee.cl                 |
    | autozone.com           | idealo.de            | shopee.co.id              |
    | bestbuy.com            | immobilienscout24.de | shopee.co.th              |
    | bestwestern.com        | ingatlan.com         | shopee.com.br             |
    | billiger.de            | instacart.com        | shopee.com.co             |
    | bottlerover.com        | intersport.fr        | shopee.com.mx             |
    | carousell.com          | joann.com            | shopee.com.my             |
    | carousell.com.hk       | kroger.com           | shopee.ph                 |
    | carousell.com.my       | lazada.co.id         | shopee.sg                 |
    | carousell.ph           | lazada.co.th         | shopee.tw                 |
    | carousell.sg           | lazada.com.my        | shopee.vn                 |
    | carsales.com.au        | lazada.com.ph        | similarweb.com            |
    | cdiscount.com          | lazada.sg            | skyscanner.co.kr          |
    | chewy.com              | lazada.vn            | skyscanner.net            |
    | costco.com             | lowes.ca             | stopandshop.com           |
    | cvs.com                | lowes.com            | target.com                |
    | despegar.com.mx        | mcmaster.com         | temu.com                  |
    | dickssportinggoods.com | mediamarkt.de        | ticketmaster.com          |
    | dynos.es               | mediamarkt.es        | totalwine.com             |
    | emaxme.com             | medline.com          | tractorsupply.com         |
    | familytreenow\.com     | mscdirect.com        | walmart.com.mx            |
    | feuvert.fr             | napaonline.com       | wayfair.com               |
    | flooranddecor.com      | nofrills.ca          | weismarkets.com           |
    | foodlion.com           | peoplefinders.com    | wizzair.com               |
    | footlocker.co.uk       | platt.com            | worten.pt                 |
    | footlocker.com         | publicdatausa.com    |                           |
  </Accordion>

  <Accordion title="How to enable JavaScript rendering with the Web Unlocker API?">
    If you require the Web Unlocker API to render a page using JavaScript, you should utilize the following feature: [Manual Expect Elements](/scraping-automation/web-unlocker/features#manual-'expect'-elements)

    This will ensure that the response that is returned by the Web Unlocker API includes the part of the page you require to be rendered.

    If your use case requires interactions within the page (click, scroll, hover, etc.), you should instead use [Browser API](/scraping-automation/scraping-browser/introduction)
  </Accordion>

  <Accordion title="Where can I find my public IP when using Web Unlocker API, SERP API, or Browser API?">
    The public IPs used by these "Web Unlocker API" products are not visible to customers. Web Unlocker API, SERP API, and Browser API use a dynamic IP pool that include real-world residential IPs. For compliance and privacy reasons, these IPs are intentionally hidden and constantly rotated to ensure anonymity and optimal unblocking of your target site.

    You can view other metadata surrounding your IP, such as country, ASN, and city by sending a request to the following test URL: `http://brdtest.com/myip.json`

    **Note:** The IP field will not be included in the response.
  </Accordion>

  <Accordion title="Is there a rate limit for the Web Unlocker API or SERP API?">
    Unfunded accounts are restricted to a default rate limit of 1,000 requests per minute. You can check the specific rate limit applied to your zone in the Control Panel, under the zone's Overview tab > Access details. This default limit is removed once funds are added to your account.
  </Accordion>

  <Accordion title="How do I scrape specific sites?">
    To scrape specific sites, follow these steps:

    1. **Select the Right Product for you:** Bright Data offers various tools like the **Web Scraper IDE**, **Scrapers**, and **Managed Services**. Choose the one that best suits your needs for scraping the target site.

    2. **Search for Target Site Templates:** If you're using the Scrapers, browse or search for pre-built scraping templates for popular websites. These templates make it easier to start scraping without building a scraper from scratch.

    3. **Customize or Build Your Scraper:**

       * If your target site isn't available as a pre-built option, use the **Web Scraper IDE** to build a custom scraper tailored to the specific site or the **Managed Services** option if you want us to build it for you

       * Write your script using the provided editor and tools, or modify an existing template to match your requirements.

    4. **Test and Execute Your Scraper:** Run the scraper within the Bright Data platform to collect the desired data. Use the debugging tools available in the IDE to refine the process if needed.

    5. **Export and Use the Data:** Once the scrape is complete, download or export the collected data in your preferred format, such as JSON, CSV, or Excel, for analysis or integration into your systems.

    If you're looking for a no-code solution or need assistance, Bright Data's support team can help, or you can request a custom dataset tailored to your needs.
  </Accordion>
</AccordionGroup>


# Custom CDP functions
Source: https://docs.brightdata.com/scraping-automation/scraping-browser/cdp-functions/custom

Reference for Bright Data Browser API custom CDP functions (60+ tools) that extend the standard Chrome DevTools Protocol with unblocking and session controls.

## How to solve CAPTCHAs

When navigating a page with Browser API, our integrated CAPTCHA solver **automatically solves all CAPTCHAs** by default. You can monitor this auto-solving process in your code with the following custom CDP functions.

<Note>
  If you would like to disable CAPTCHA solver entirely through the Control Panel see our feature for [Disable Captcha Solver](/scraping-automation/scraping-browser/features/captcha-solver)
</Note>

<Note>
  Once a CAPTCHA is solved, if there is a form to submit, it will be submitted by default.
</Note>

## CAPTCHA Solver - Automatic Solve

<AccordionGroup>
  <Accordion title="Captcha.solve">
    Use this command to return the status after the captcha was solved, failed, or not detected.

    <CodeGroup>
      ```js Captcha.solve theme={null}
      Captcha.solve({
          detectTimeout?: number // Detect timeout in millisecond for solver to detect captcha  
          options?: CaptchaOptions[] // Configuration options for captcha solving  
      }) : SolveResult
      ```

      ```js SolveResult theme={null}
      SolveResult : {  
        status: SolveStatus // Detect and solve status  
        type?: string // Detected captcha type  
        error?: string // Error if captcha was not solved  
      }
      ```

      ```js SolveStatus theme={null}
      SolveStatus : string enum {  
        "not_detected" // Captcha was not detected  
        "solve_finished" // Captcha successfully solved  
        "solve_failed" // Captcha detected, but was not solved  
        "invalid" // Something goes wrong  
      }
      ```
    </CodeGroup>

    **Examples**

    <CodeGroup>
      ```js NodeJS - Puppeteer theme={null}
      const page = await browser.newPage();
      const client = await page.createCDPSession();
      await page.goto('https://site-with-captcha.com/');  

      // Note 1: If no captcha was found it will return not_detected status after detectTimeout   
      // Note 2: Once a CAPTCHA is solved, if there is a form to submit, it will be submitted by default   
       
      const {status} = await client.send('Captcha.solve', {detectTimeout: 30*1000});   
      console.log(`Captcha solve status: ${status}`)
      ```

      ```python Python - Playwright theme={null}
      page = await browser.new_page()   
      client = await page.context.new_cdp_session(page)   
      await page.goto('https://site-with-captcha.com/') 
       
      # Note 1: If no captcha was found it will return not_detected status after detectTimeout   
      # Note 2: Once a CAPTCHA is solved, if there is a form to submit, it will be submitted by default  

      solve_result = await client.send('Captcha.solve', { 'detectTimeout': 30*1000 })   
      status = solve_result['status']   
      print(f'Captcha solve status: {status}') 
      ```

      ```c# C# - PuppeteerSharp theme={null}
      var page = await browser.NewPageAsync();
      var client = page.Client;
      await page.GoToAsync(url);
      var result = await client.SendAsync("Captcha.solve", new
      {
          detectTimeout = 10 * 1000,
      });
      var status = result.Value.GetProperty("status").GetString();
      Log($"Captcha solve status: {status}");
      ```

      ```c# C# - Playwright theme={null}
      var page = await browser.NewPageAsync();
      var cdpSession = await page.Context.NewCDPSessionAsync(page);
      await page.GotoAsync(url);
      var result = await cdpSession.SendAsync("Captcha.solve", new Dictionary<string, object>
      {
          ["detectTimeout"] = 10 * 1000
      });
      var status = result.Value.GetProperty("status").GetString();
      Log($"Captcha solve status: {status}");
      ```
    </CodeGroup>

    <Note>
      If CAPTCHA-solving fails, please attempt a retry. If the issue persists, submit a support reques detailing the specific problem you encountered.
    </Note>
  </Accordion>

  <Accordion title="Custom CDP commands for CAPTCHA status">
    Use the commands below to pinpoint a more specific stage in the CAPTCHA solving flow:

    |                         |                                                                 |
    | ----------------------- | --------------------------------------------------------------- |
    | `Captcha.detected`      | Browser API has encountered a CAPTCHA and has begun to solve it |
    | `Captcha.solveFinished` | Browser API successfully solved the CAPTCHA                     |
    | `Captcha.solveFailed`   | Browser API failed in solving the CAPTCHA                       |
    | `Captcha.waitForSolve`  | Browser API waits for CAPTCHA solver to finish                  |

    **Examples**

    <Tabs>
      <Tab title="Asynchronous">
        The following code sets up a CDP session, listens for CAPTCHA events, and handles timeouts:

        <CodeGroup>
          ```js NodeJS - Puppeteer theme={null}
          // Node.js - Puppeteer - waiting for CAPTCHA solving events  
          const client = await page.target().createCDPSession();   
          await new Promise((resolve, reject)=>{   
            client.on('Captcha.solveFinished', resolve);   
            client.on('Captcha.solveFailed', ()=>reject(new Error('Captcha failed')));   
            setTimeout(reject, 5 * 60 * 1000, new Error('Captcha solve timeout'));  
          });
          ```

          ```python Python - Playwright theme={null}
          # Python - Playwright - waiting for CAPTCHA solving events  
          client = await page.context.new_cdp_session(page)  
          client.on('Captcha.detected', lambda c: print('Captcha detected', c))   
          client.on('Captcha.solveFinished', lambda _: print('Captcha solved!'))   
          client.on('Captcha.solveFailed', lambda _: print('Captcha failed!'))
          ```
        </CodeGroup>
      </Tab>

      <Tab title="Synchronous">
        <Warning>
          Selenium doesn't support asynchronous server-driven events like Puppeteer and Playwright.
        </Warning>

        The `Captcha.waitForSolve` command waits for Browser API's CAPTCHA solver to finish.

        ```python Python - Selenium theme={null}
        # Python Selenium - Waiting for Captcha to auto-solve after navigate  
        driver.execute('executeCdpCommand', {  
            'cmd': 'Captcha.waitForSolve',  
            'params': {},  
        })
        ```
      </Tab>
    </Tabs>
  </Accordion>
</AccordionGroup>

## CAPTCHA Solver - Manual Control

If you would like to either manually configure or fully disable our default CAPTCHA solver and instead call the solver manually or solve on your own, see the following CDP commands and functionality.

<AccordionGroup>
  <Accordion title="Captcha.setAutoSolve">
    This command is used to control the auto-solving of a CAPTCHA. You can disable auto-solve or configure algorithms for different CAPTCHA types and manually trigger this:

    <CodeGroup>
      ```js Captcha.setAutoSolve theme={null}
      Captcha.setAutoSolve({  
        autoSolve: boolean // Whether to automatically solve captcha after navigate  
        options?: CaptchaOptions[] // Configuration options for captcha auto-solving  
      }) : void
      ```

      ```js CaptchaOptions theme={null}
      CaptchaOptions : {  
        type: string // Captcha type  
        disabled?: boolean // Disable detect and solve for specified captcha  
        ... // additinal options related to captcha type  
      }
      ```
    </CodeGroup>

    Examples of CDP commands to disable auto-solver **completely** within the session:

    <CodeGroup>
      ```js NodeJS - Puppeteer theme={null}
      // Node.js Puppeteer - Disable Captcha auto-solver completely  
      const page = await browser.newPage();  
      const client = await page.target().createCDPSession();  
      await client.send('Captcha.setAutoSolve', { autoSolve: false })
      ```

      ```python Python - Playwright theme={null}
      # Python Playwright - Disable Captcha auto-solver completely  
      page = await browser.new_page()  
      client = await page.context.new_cdp_session(page)  
      await client.send('Captcha.setAutoSolve', {'autoSolve': False})
      ```

      ```python - Selenium theme={null}
      # Python Selenium - Disable Captcha auto-solver completely  
      driver.execute('executeCdpCommand', {  
          'cmd': 'Captcha.setAutoSolve',  
          'params': {'autoSolve': False},  
      })
      ```
    </CodeGroup>
  </Accordion>

  <Accordion title="Disable auto-solver for a specific CAPTCHA type only - Examples">
    <CodeGroup>
      ```js NodeJS - Puppeteer theme={null}
      // Node.js Puppeteer - Disable Captcha auto-solver for ReCaptcha only  
      const page = await browser.newPage();  
      const client = await page.target().createCDPSession();  
      await client.send('Captcha.setAutoSolve', {  
          autoSolve: true,  
          options: [{  
              type: 'usercaptcha',  
              disabled: true,  
          }],  
      });
      ```

      ```python Python - Playwright theme={null}
      # Python Playwright - Disable Captcha auto-solver for ReCaptcha only  
      page = await browser.new_page()  
      client = await page.context.new_cdp_session(page)  
      await client.send('Captcha.setAutoSolve', {  
          'autoSolve': True,  
          'options': [{  
              'type': 'usercaptcha',  
              'disabled': True,  
          }],  
      })
      ```
    </CodeGroup>
  </Accordion>

  <Accordion title="Manually solving CAPTCHAs - Examples">
    <CodeGroup>
      ```js NodeJS - Puppeteer theme={null}
      // Node.js Puppeteer - manually solving CAPTCHA after navigation  
      const page = await browser.newPage();  
      const client = await page.target().createCDPSession();  
      await client.send('Captcha.setAutoSolve', { autoSolve: false });  
      await page.goto('https://site-with-captcha.com', { timeout: 2*60*1000 });  
      const {status} = await client.send('Captcha.solve', { detectTimeout: 30*1000 });  
      console.log('Captcha solve status:', status);
      ```

      ```python Python - Playwright theme={null}
      # Python Playwright- manually solving CAPTCHA after navigation  
      page = await browser.new_page()  
      client = await page.context.new_cdp_session(page)  
      await client.send('Captcha.setAutoSolve', {'autoSolve': False})  
      await page.goto('https://site-with-captcha.com', timeout=2*60_000)  
      solve_result = await client.send('Captcha.solve', {'detectTimeout': 30_000})  
      print('Captcha solve status:', solve_result['status'])
      ```

      ```python Python - Selenium theme={null}
      # Python Selenium - manually solving CAPTCHA after navigation  
      driver.execute('executeCdpCommand', {  
          'cmd': 'Captcha.setAutoSolve',  
          'params': {'autoSolve': False},  
      })  
      driver.get('https://site-with-captcha.com')  
      solve_result = driver.execute('executeCdpCommand', {  
          'cmd': 'Captcha.solve',  
          'params': {'detectTimeout': 30_000},  
      })  
      print('Captcha solve status:', solve_result['value']['status'])
      ```
    </CodeGroup>
  </Accordion>

  <Accordion title="CaptchaOptions for other Captcha types">
    For the following three CAPTCHA types we support the following additional options to control and configure our auto-solving algorithm.

    <Tabs>
      <Tab title="CF Challenge">
        ```js CF Challenge theme={null}
        timeout: 40000  
        selector: '#challenge-body-text, .challenge-form'  
        check_timeout: 300  
        error_selector: '#challenge-error-title'  
        success_selector: '#challenge-success[style*=inline]'  
        check_success_timeout: 300  
        btn_selector: '#challenge-stage input[type=button]'  
        cloudflare_checkbox_frame_selector: '#turnstile-wrapper iframe'  
        checkbox_area_selector: '.ctp-checkbox-label .mark'  
        wait_timeout_after_solve: 500  
        wait_networkidle: {timeout: 500}
        ```
      </Tab>

      <Tab title="HCaptcha">
        ```js HCaptcha theme={null}
        detect_selector:  
          '#cf-hcaptcha-container, #challenge-hcaptcha-wrapper .hcaptcha-box, .h-captcha'  
        pass_proxy: true  
        submit_form: true  
        submit_selector: '#challenge-form body > form[action*="internalcaptcha/captchasubmit"]  
        value_selector: '.h-captcha textarea[id^="h-captcha-response"]'  
          
        ```
      </Tab>

      <Tab title="usercaptcha (reCAPTCHA)">
        ```js UserCaptcha (reCAPTCHA) theme={null}
        { // configuration keys and default values for reCAPTCHA (type=usercaptcha)  
          type: 'usercaptcha',  
          // selector to retrieve sitekey and/or action  
          selector: '.g-recaptcha, .recaptcha',  
          // attributes to search for sitekey  
          sitekey_attributes: ['data-sitekey', 'data-key'],  
          // attributes to search for action  
          action_attributes: ['data-action'],  
          // detect selectors  
          detect_selector: `  
            .g-recaptcha[data-sitekey] > *,  
            .recaptcha > *,  
            iframe[src*="[www.google.com/recaptcha/api2](http://www.google.com/recaptcha/api2)"],  
            iframe[src*="[www.recaptcha.net/recaptcha/api2](http://www.recaptcha.net/recaptcha/api2)"],  
            iframe[src*="[www.google.com/recaptcha/enterprise](http://www.google.com/recaptcha/enterprise)"]`,  
          // element to type response code into  
          reponse_selector: '#g-recaptcha-response, .g-recaptcha-response',  
          // should solver submit form automatically after captcha solved  
          submit_form: true,  
          // selector for submit button  
          submit_selector: '[type=submit]',  
        }
        ```
      </Tab>
    </Tabs>
  </Accordion>
</AccordionGroup>

## How to emulate devices

<AccordionGroup>
  <Accordion title="Emulation.getSupportedDevices">
    Use this command to get a list of all possible devices that can be emulated. This method returns an array of device options that can be used with the setDevice command.

    ```js Example theme={null}
    const devices = await client.send("Emulation.getSupportedDevices");
    console.log(devices);
    ```
  </Accordion>

  <Accordion title="Emulation.setDevice">
    Once you've received the list above of supported devices, you can emulate a specific device using the Emulation.setDevice command. This command changes the screen width, height, userAgent, and devicePixelRatio to match the specified device.

    <CodeGroup>
      ```js Usage theme={null}
      await client.send("Emulation.setDevice", { device: "[device_name]" });
      ```

      ```js Example theme={null}
      await client.send("Emulation.setDevice", { device: "Vivo X200 Pro" });
      ```
    </CodeGroup>

    ## Landscape mode

    If you wish to change the orientation to landscape (for devices that support it), add the string `landscape` after the `device_name`.

    ```js Example theme={null}
    await client.send("Emulation.setDevice", { device: "Vivo X200 Pro landscape" });
    ```
  </Accordion>
</AccordionGroup>

## How to block ads

Enabling our `AdBlock` feature can help **reduce bandwidth** usage and **improve performance** on ad-heavy websites.

### Ad blocker CDP commands

* `Unblocker.enableAdBlock` – Enables ad blocker (default: off)
* `Unblocker.disableAdBlock` – Disables ad blocker

<Tip>
  We recommend enabling ad blocking before navigating to the target page.
</Tip>

```js Example theme={null}
// Enable ad blocking before navigating
const client = await page.createCDPSession();

try {
    await client.send('Unblocker.enableAdBlock');
} catch (e) {
    console.error(e.stack || e);
}

await page.goto('https://www.w3schools.com/html/html_forms.asp');
```

See the full [ad blocker example script](https://github.com/luminati-io/sbr-examples/blob/main/nodejs/puppeteer-ad-block/scrape.js).

## How to persist sessions

Use this command to reuse the same proxy peer across multiple browsing sessions. This is useful for scenarios where maintaining a consistent session is required, such as preserving browser states or IP-based continuity.

### Session persistence CDP commands

* `Proxy.useSession` – Associates a session with a specific session ID.
* `sessionId` – A unique string that identifies your session.

<Note>
  Use the CDP command before navigation to the target page.
</Note>

```js Example theme={null}
const client = await page.createCDPSession();
await client.send('Proxy.useSession', { sessionId });
await page.goto('https://geo.brdtest.com/mygeo.json');
```

<Tip>
  See the full [session persistence example script](https://github.com/luminati-io/sbr-examples/blob/main/nodejs/puppeteer-proxy-session/scrape.js).
</Tip>

## Getting Session ID

Use this command to retrieve the unique ID of your current browser session. This is useful when you need to look up session logs via the [Session Logs API](/api-reference/browser-api/get-session), such as investigating errors, unexpected behavior, or high bandwidth usage.

### Session ID CDP command

* `Browser.getSessionId`

```js Example (Puppeteer) theme={null}
const page = await browser.newPage();
const client = await page.target().createCDPSession();
const result = await client.send('Browser.getSessionId');
const sessionId = result.sessionId;
console.log('Current session ID:', sessionId);
```

```json Returns theme={null}
{
  "sessionId": "XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX"
}
```

## How to download files

You can automate file downloads in your Browser API flows using the custom Download CDP domain. This is useful for workflows that require downloading files (e.g., CSV, PDF) directly during browser automation.

### File download CDP commands

* `Download.enable` – Enables file downloads for specified content types.
* `Download.downloadRequest` – Fires when request results in download.
* `Download.getLastCompleted` – Retrieves information about the last completed download.
* `Download.getDownloadedBody` – Gets the actual downloaded file content.

```js Example theme={null}
const client = await page.createCDPSession();

// Enable downloads for binary files like CSV
await client.send('Download.enable', { allowedContentTypes: ['application/octet-stream'] });

// initiate download file
await Promise.all([
  new Promise(resolve => client.once('Download.downloadRequest', resolve)),
  page.click(selector),
]);

// After download completes:
const { id } = await client.send('Download.getLastCompleted');
const { body, base64Encoded } = await client.send('Download.getDownloadedBody', { id });
const fs = require('fs');
fs.writeFileSync('./downloaded_file.csv', base64Encoded ? Buffer.from(body, 'base64') : body);
```

<Tip>
  See the full [file download example script](https://github.com/luminati-io/sbr-examples/blob/main/nodejs/puppeteer-file-download/scrape.js).
</Tip>

## Faster Text Input

For scenarios that need rapid or bulk text input, use the custom Input.type CDP command. This approach is much faster than standard CDP text input methods, making it well suited for automation tasks requiring high-speed typing or handling large volumes of text.

### Faster text input CDP commands

* `Input.type` - Sends keystrokes or simulates typing the specified text into the currently focused element.

```js Example theme={null}
const client = await page.createCDPSession();

// Focus the input element
await page.focus('input');

// Type a message
await client.send('Input.type', {
  text: 'what is the best place to try pizza and pasta?'
});
```

## Custom Client SSL/TLS Certificates

Use this command to install custom client SSL/TLS certificates where required for specific domain authentication. These certificates are applied for the duration of a **single** Browser API session and are automatically removed once the session ends.

<AccordionGroup>
  <Accordion title="Browser.addCertificate">
    ```javascript theme={null}
    Browser.addCertificate(params: {
      cert: string // base64 encoded certificate file
      pass: string // password for the certificate
    }) : void
    ```
  </Accordion>

  <Accordion title="Code examples">
    * Replace the example values `SBR_ZONE_FULL_USERNAME:SBR_ZONE_PASSWORD` with your valid Browser API credentials.
    * Replace `client.pfx` with the actual path to your certificate file. This file should be a valid SSL/TLS client certificate in .pfx format.
    * Replace `secret` with the actual password for the certificate.

      <CodeGroup>
        ```js NodeJS - Puppeteer theme={null}
        const puppeteer = require('puppeteer-core');
        const fs = require('fs/promises');
        const {
          AUTH = 'SBR_ZONE_FULL_USERNAME:SBR_ZONE_PASSWORD',
          TARGET_URL = 'https://example.com',
          CERT_FILE = 'client.pfx',
          CERT_PASS = 'secret',
        } = process.env;

        async function scrape(url = TARGET_URL, file = CERT_FILE, pass = CERT_PASS) {
          if (AUTH == 'SBR_ZONE_FULL_USERNAME:SBR_ZONE_PASSWORD') {
            throw new Error(`Provide Browser API credentials in AUTH`
                + ` environment variable or update the script.`);
          }
          console.log(`Connecting to Browser...`);
          const browserWSEndpoint = `wss://${AUTH}@brd.superproxy.io:9222`;
          const browser = await puppeteer.connect({ browserWSEndpoint });
          try {
            console.log(`Connected! Installing ${file} certificate...`);
            const page = await browser.newPage();
            const client = await page.createCDPSession();
            const cert = (await fs.readFile(CERT_FILE)).toString('base64');
            await client.send('Browser.addCertificate', { cert, pass });
            console.log(`Installed! Navigating to ${url}...`);
            await page.goto(url, { timeout: 2 * 60 * 1000 });
            console.log(`Navigated! Scraping page content...`);
            const data = await page.content();
            console.log(`Scraped! Data: ${data}`);
          } finally {
            await browser.close();
          }
        }

        scrape();
        ```

        ```python Python - Selenium theme={null}
        from os import environ
        from base64 import standard_b64encode
        from selenium.webdriver import Remote, ChromeOptions as Options
        from selenium.webdriver.chromium.remote_connection import ChromiumRemoteConnection as Connection

        AUTH = environ.get('AUTH', default='SBR_ZONE_FULL_USERNAME:SBR_ZONE_PASSWORD')
        TARGET_URL = environ.get('TARGET_URL', default='https://example.com')
        CERT_FILE = environ.get('CERT_FILE', default='client.pfx')
        CERT_PASS = environ.get('CERT_PASS', default='secret')

        def scrape(url=TARGET_URL, file=CERT_FILE, pswd=CERT_PASS):
            if AUTH == 'SBR_ZONE_FULL_USERNAME:SBR_ZONE_PASSWORD':
            raise Exception('Provide Browser API credentials in AUTH '
                            'environment variable or update the script.')
            print('Connecting to Browser...')
            server_addr = f'https://{AUTH}@brd.superproxy.io:9515'
            connection = Connection(server_addr, 'goog', 'chrome')
            driver = Remote(connection, options=Options())
            try:
                print(f'Connected! Installing {file} certificate...')
                with open(file, 'rb') as f:
                    cert = standard_b64encode(f.read()).decode()
                driver.execute('executeCdpCommand', {
                    'cmd': 'Browser.addCertificate',
                    'params': {'cert': cert, 'pass': pswd},
                })
                print(f'Installed! Navigating to {url}...')
                driver.get(url)
                print('Navigated! Scraping page content...')
                data = driver.page_source
                print(f'Scraped! Data: {data}')
            finally:
                driver.quit()

        scrape()
        ```
      </CodeGroup>
  </Accordion>
</AccordionGroup>


# Standard CDP functions
Source: https://docs.brightdata.com/scraping-automation/scraping-browser/cdp-functions/standard

Reference for standard CDP functions on the Bright Data Browser API (60+ tools): cookies, country targeting, navigation and Puppeteer or Playwright commands.

Browser API supports CDP so all puppeteer functions/features work within our browsers. You can find all puppeteer API documentation and usage examples on the [official puppeteer documentation page](https://pptr.dev/). We have also added a few Bright Data-specific [custom CDP events](/scraping-automation/scraping-browser/cdp-functions/custom) which can be useful as well.

The following are a few common browser navigation functions to get you started.

<AccordionGroup>
  <Accordion title="Get Page HTML">
    ```js NodeJS - Puppeteer theme={null}
    const page = await browser.newPage();  
    await page.goto('https://example.com');  
    const html = await page.content();
    ```

    For more info: [https://pptr.dev/api/puppeteer.page.content](https://pptr.dev/api/puppeteer.page.content)
  </Accordion>

  <Accordion title="Click on element">
    ```js NodeJS - Puppeteer theme={null}
    // node.js puppeteer   
    const page = await browser.newPage();  
    await page.goto('https://example.com');  
    await page.click('a[href]');
    ```

    For more info: [https://pptr.dev/api/puppeteer.page.click](https://pptr.dev/api/puppeteer.page.click)
  </Accordion>

  <Accordion title="Scroll to page bottom">
    You might need to scroll the viewport to the bottom at times, such as when activating 'infinite scroll'. Here's how:

    ```js NodeJS - Puppeteer theme={null}
    // node.js puppeteer   
    const page = await browser.newPage();  
    await page.goto('https://example.com');  
    await page.evaluate(()=>window.scrollBy(0, window.innerHeight));
    ```
  </Accordion>

  <Accordion title="Take Screenshot">
    <CodeGroup>
      ```js NodeJS - Puppeteer theme={null}
      // More info at https://pptr.dev/api/puppeteer.page.screenshot  
      await page.screenshot({ path: 'screenshot.png', fullPage: true });
      ```

      ```python Python - Playwright theme={null}
      # More info at <https://playwright.dev/python/docs/screenshots>  
      await page.screenshot(path='screenshot.png', full_page=True)
      ```

      ```cs C# - PuppeteerSharp theme={null}
      await page.ScreenshotAsync("screenshot.png", new ()  
      {  
          FullPage = true,  
      });
      ```

      ```C# C# - Playwright theme={null}
      var screenshotPath = "screenshot.png";
                  
      await page.ScreenshotAsync(new PageScreenshotOptions
      {
          Path = screenshotPath,
          FullPage = true
      });
      ```
    </CodeGroup>

    <Note>
      When running the example scripts above the screenshot above will be saved as “screenshot.png” within your files.
    </Note>
  </Accordion>

  <Accordion title="Set Cookies">
    Please note that this is supported onl for customers who completed the KYC verification process.

    ```js NodeJS Puppeteer theme={null}
    const page = await browser.newPage();  
    await page.setCookie({name: 'LANG', value: 'en-US', domain: 'example.com'});  
    await page.goto('https://example.com');
    ```

    For more info: [https://pptr.dev/api/puppeteer.page.setcookie](https://pptr.dev/api/puppeteer.page.setcookie)
  </Accordion>

  <Accordion title="Blocking Endpoints">
    It is possible to block endpoints that are not required to save bandwidth. See an example of this below:

    ```js NodeJS - Puppeteer theme={null}
    // connect to a remote browser...
    const blockedUrls = ['*doubleclick.net*'];
    const page = await browser.newPage();
    const client = await page.target().createCDPSession();
    await client.send('Network.enable');
    await client.send('Network.setBlockedURLs', {urls: blockedUrls});
    await page.goto('https://washingtonpost.com');
    ```
  </Accordion>

  <Accordion title="Country Targeting">
    When using the Browser API, the same **country-targeting** parameter is available to use as in our other proxy products.

    When setting up your script, add the `-country` flag, **after** your "USER" credentials within the Bright Data endpoint, followed by the 2-letter [ISO code](https://www.nationsonline.org/oneworld/country_code_list.htm) for that country.

    ```js theme={null}
    const SBR_WS_ENDPOINT = `wss://${USER-country-us:PASS}@brd.superproxy.io:9222`;
    ```

    In the example above, we added `-country-us` to the Bright Data endpoint within our script, so our request will originate from the United States ("us").

    #### EU region

    You can target the entire European Union region in the same manner as "Country" above by adding "eu" after "country" in your request: `-country-eu` Requests sent using `-country-eu`, will use IPs from **one** of the countries below which are included automatically within "eu":

    ```sh Countries theme={null}
    AL, AZ, KG, BA, UZ, BI, XK, SM, DE, AT, CH, UK, GB, IE, IM, FR, ES, NL, IT, PT, BE, AD, MT, MC, MA, LU, TN, DZ, GI, LI, SE, DK, FI, NO, AX, IS, GG, JE, EU, GL, VA, FX, FO
    ```

    <Note>
      The allocation of a country within the EU is random.
    </Note>
  </Accordion>
</AccordionGroup>


# Browser API code examples
Source: https://docs.brightdata.com/scraping-automation/scraping-browser/code-examples

Explore Bright Data Browser API code examples across 3 technologies (Playwright, Puppeteer, Selenium) for headless browser scraping at scale.

Below are examples of Browser API usage in various scenarios and libraries.

<Warning>
  Please make sure to install required libraries before continuing
</Warning>

## Make your first request in minutes

Test the Browser API in minutes with these ready-to-use code examples.

<CardGroup>
  <Card title="Nodejs Puppeteer Example" icon="code" href="https://github.com/luminati-io/bright-data-scraping-browser-nodejs-puppeteer-project" />

  <Card title="Node.js Playwright Example" icon="code" href="https://github.com/luminati-io/bright-data-scraping-browser-nodejs-playwright-project" />

  <Card title="Node.js Selenium Example" icon="code" href="https://github.com/luminati-io/bright-data-scraping-browser-nodejs-selenium-project" />
</CardGroup>

<Tabs>
  <Tab title="Basic">
    Simple scraping of targeted page

    ### Select your preferred tech-stack

    <Tabs>
      <Tab title="NodeJS">
        <CodeGroup>
          ```js Playwright theme={null}
          #!/usr/bin/env node
          const playwright = require('playwright');
          const {
              AUTH = 'SBR_ZONE_FULL_USERNAME:SBR_ZONE_PASSWORD',
              TARGET_URL = 'https://example.com',
          } = process.env;

          async function scrape(url = TARGET_URL) {
              if (AUTH == 'SBR_ZONE_FULL_USERNAME:SBR_ZONE_PASSWORD') {
                  throw new Error(`Provide Browser API credentials in AUTH`
                      + ` environment variable or update the script.`);
              }
              console.log(`Connecting to Browser...`);
              const endpointURL = `wss://${AUTH}@brd.superproxy.io:9222`;
              const browser = await playwright.chromium.connectOverCDP(endpointURL);
              try {
                  console.log(`Connected! Navigating to ${url}...`);
                  const page = await browser.newPage();
                  await page.goto(url, { timeout: 2 * 60 * 1000 });
                  console.log(`Navigated! Scraping page content...`);
                  const data = await page.content();
                  console.log(`Scraped! Data: ${data}`);
              } finally {
                  await browser.close();
              }
          }

          if (require.main == module) {
              scrape().catch(error => {
                  console.error(error.stack || error.message || error);
                  process.exit(1);
              });
          }
          ```

          ```js Puppeteer theme={null}
          #!/usr/bin/env node
          const puppeteer = require('puppeteer-core');
          const {
              AUTH = 'SBR_ZONE_FULL_USERNAME:SBR_ZONE_PASSWORD',
              TARGET_URL = 'https://example.com',
          } = process.env;

          async function scrape(url = TARGET_URL) {
              if (AUTH == 'SBR_ZONE_FULL_USERNAME:SBR_ZONE_PASSWORD') {
                  throw new Error(`Provide Browser API credentials in AUTH`
                      + ` environment variable or update the script.`);
              }
              console.log(`Connecting to Browser...`);
              const browserWSEndpoint = `wss://${AUTH}@brd.superproxy.io:9222`;
              const browser = await puppeteer.connect({ browserWSEndpoint });
              try {
                  console.log(`Connected! Navigating to ${url}...`);
                  const page = await browser.newPage();
                  await page.goto(url, { timeout: 2 * 60 * 1000 });
                  console.log(`Navigated! Scraping page content...`);
                  const data = await page.content();
                  console.log(`Scraped! Data: ${data}`);
              } finally {
                  await browser.close();
              }
          }

          function getErrorDetails(error) {
              if (error.target?._req?.res) {
                  const {
                      statusCode,
                      statusMessage,
                  } = error.target._req.res;
                  return `Unexpected Server Status ${statusCode}: ${statusMessage}`;
              }
          }

          if (require.main == module) {
              scrape().catch(error => {
                  console.error(getErrorDetails(error)
                      || error.stack
                      || error.message
                      || error);
                  process.exit(1);
              });
          }
          ```

          ```js Selenium theme={null}
          #!/usr/bin/env node
          const { Builder, Browser } = require('selenium-webdriver');
          const {
              AUTH = 'SBR_ZONE_FULL_USERNAME:SBR_ZONE_PASSWORD',
              TARGET_URL = 'https://example.com',
          } = process.env;

          async function scrape(url = TARGET_URL) {
              if (AUTH == 'SBR_ZONE_FULL_USERNAME:SBR_ZONE_PASSWORD') {
                  throw new Error(`Provide Browser API credentials in AUTH`
                      + ` environment variable or update the script.`);
              }
              console.log(`Connecting to Browser...`);
              const server = `https://${AUTH}@brd.superproxy.io:9515`;
              const driver = await new Builder()
                  .forBrowser(Browser.CHROME)
                  .usingServer(server)
                  .build();
              try {
                  console.log(`Connected! Navigating to ${url}...`);
                  await driver.get(url);
                  console.log(`Navigated! Scraping page content...`);
                  const data = await driver.getPageSource();
                  console.log(`Scraped! Data: ${data}`);
              } finally {
                  await driver.quit();
              }
          }

          if (require.main == module) {
              scrape().catch(error => {
                  console.error(error.stack || error.message || error);
                  process.exit(1);
              });
          }
          ```
        </CodeGroup>
      </Tab>

      <Tab title="Python">
        <CodeGroup>
          ```python Playwright - Async theme={null}
          #!/usr/bin/env python3
          import asyncio
          from os import environ
          from playwright.async_api import Playwright, async_playwright

          AUTH = environ.get('AUTH', default='SBR_ZONE_FULL_USERNAME:SBR_ZONE_PASSWORD')
          TARGET_URL = environ.get('TARGET_URL', default='https://example.com')


          async def scrape(playwright: Playwright, url=TARGET_URL):
              if AUTH == 'SBR_ZONE_FULL_USERNAME:SBR_ZONE_PASSWORD':
                  raise Exception('Provide Browser API credentials in AUTH ' +
                                  'environment variable or update the script.')
              print('Connecting to Browser...')
              endpoint_url = f'wss://{AUTH}@brd.superproxy.io:9222'
              browser = await playwright.chromium.connect_over_cdp(endpoint_url)
              try:
                  print(f'Connected! Navigating to {url}...')
                  page = await browser.new_page()
                  await page.goto(url, timeout=2*60_000)
                  print('Navigated! Scraping page content...')
                  data = await page.content()
                  print(f'Scraped! Data: {data}')
              finally:
                  await browser.close()


          async def main():
              async with async_playwright() as playwright:
                  await scrape(playwright)


          if __name__ == '__main__':
              asyncio.run(main())

          ```

          ```python Playwright - Sync theme={null}
          #!/usr/bin/env python3
          from os import environ
          from playwright.sync_api import Playwright, sync_playwright

          AUTH = environ.get('AUTH', default='SBR_ZONE_FULL_USERNAME:SBR_ZONE_PASSWORD')
          TARGET_URL = environ.get('TARGET_URL', default='https://example.com')


          def scrape(playwright: Playwright, url=TARGET_URL):
              if AUTH == 'SBR_ZONE_FULL_USERNAME:SBR_ZONE_PASSWORD':
                  raise Exception('Provide Browser API credentials in AUTH ' +
                                  'environment variable or update the script.')
              print('Connecting to Browser...')
              endpoint_url = f'wss://{AUTH}@brd.superproxy.io:9222'
              browser = playwright.chromium.connect_over_cdp(endpoint_url)
              try:
                  print(f'Connected! Navigating to {url}...')
                  page = browser.new_page()
                  page.goto(url, timeout=2*60_000)
                  print('Navigated! Scraping page content...')
                  data = page.content()
                  print(f'Scraped! Data: {data}')
              finally:
                  browser.close()


          def main():
              with sync_playwright() as playwright:
                  scrape(playwright)


          if __name__ == '__main__':
              main()

          ```

          ```python Selenium theme={null}
          #!/usr/bin/env python3
          from os import environ
          from selenium.webdriver import Remote, ChromeOptions as Options
          from selenium.webdriver.chromium.remote_connection import ChromiumRemoteConnection as Connection

          AUTH = environ.get('AUTH', default='SBR_ZONE_FULL_USERNAME:SBR_ZONE_PASSWORD')
          TARGET_URL = environ.get('TARGET_URL', default='https://example.com')


          def scrape(url=TARGET_URL):
              if AUTH == 'SBR_ZONE_FULL_USERNAME:SBR_ZONE_PASSWORD':
                  raise Exception('Provide Browser API credentials in AUTH ' +
                                  'environment variable or update the script.')
              print('Connecting to Browser...')
              server_addr = f'https://{AUTH}@brd.superproxy.io:9515'
              connection = Connection(server_addr, 'goog', 'chrome')
              driver = Remote(connection, options=Options())
              try:
                  print(f'Connected! Navigating to {url}...')
                  driver.get(url)
                  print('Navigated! Scraping page content...')
                  data = driver.page_source
                  print(f'Scraped! Data: {data}')
              finally:
                  driver.quit()


          if __name__ == '__main__':
              scrape()

          ```

          ```python Selenium - Mobile-agent theme={null}
          #!/usr/bin/env python3 
          from os import environ 
          from selenium.webdriver import Remote, ChromeOptions as Options 
          from selenium.webdriver.chromium.remote_connection import ChromiumRemoteConnection as Connection 

          AUTH = environ.get('AUTH', default='SBR_ZONE_FULL_USERNAME:SBR_ZONE_PASSWORD') 
          TARGET_URL = environ.get('TARGET_URL', default='https://httpbin.org/user-agent') 
          USER_AGENT = 'Mozilla/5.0 (iPhone; CPU iPhone OS 13_2_3 like Mac OS X) AppleWebKit/605.1.15 (KHTML, like Gecko) Version/13.0.3 Mobile/15E148 Safari/604.1' 
          SCREEN_WIDTH = 390 
          SCREEN_HEIGHT = 844 
          DEVICE_SCALE_FACTOR = 3 

          def scrape(url=TARGET_URL): 
              if AUTH == 'SBR_ZONE_FULL_USERNAME:SBR_ZONE_PASSWORD': 
                  raise Exception('Provide Browser API credentials in AUTH ' + 
                                  'environment variable or update the script.') 
              print('Connecting to Browser...') 
              server_addr = f'https://{AUTH}@brd.superproxy.io:9515' 
              connection = Connection(server_addr, 'goog', 'chrome') 
              driver = Remote(connection, options=Options()) 
              try: 
                  print(f'Connected! Emulating mobile...') 
                  driver.execute('executeCdpCommand', { 
                      'cmd': 'Emulation.setUserAgentOverride', 
                      'params': { 
                          'userAgent': USER_AGENT, 
                      }, 
                  }) 
                  driver.execute('executeCdpCommand', { 
                      'cmd': 'Emulation.setDeviceMetricsOverride', 
                      'params': { 
                          'width': SCREEN_WIDTH, 
                          'height': SCREEN_HEIGHT, 
                          'deviceScaleFactor': DEVICE_SCALE_FACTOR, 
                          'mobile': True, 
                      }, 
                  }) 
                  print(f'Navigating to {url}...') 
                  driver.get(url) 
                  print('Navigated! Checking screen and user-agent...') 
                  driver.get_screenshot_as_file('./page.png') 
                  ua = driver.execute_script('return navigator.userAgent') 
                  print(f'User-Agent is {ua}') 
              finally: 
                  driver.quit() 


          if __name__ == '__main__': 
              scrape()

          ```
        </CodeGroup>
      </Tab>

      <Tab title="C#">
        <CodeGroup>
          ```cs Puppeteer theme={null}
          using PuppeteerSharp;
          using System.Net.WebSockets;
          using System.Text;

          class Scraper
          {

              private string _auth;

              public Scraper(string auth)
              {
                  _auth = auth;
              }

              private async Task<IBrowser> Connect()
              {
                  if (_auth == "SBR_ZONE_FULL_USERNAME:SBR_ZONE_PASSWORD")
                  {
                      throw new Exception("Provide Browser API credentials in AUTH"
                              + " environment variable or update the script.");
                  }
                  var options = new ConnectOptions()
                  {
                      BrowserWSEndpoint = "wss://brd.superproxy.io:9222",
                      WebSocketFactory = async (uri, options, cToken) =>
                      {
                          var socket = new ClientWebSocket();
                          var authBytes = Encoding.UTF8.GetBytes(_auth);
                          var authHeader = "Basic " + Convert.ToBase64String(authBytes);
                          socket.Options.SetRequestHeader("Authorization", authHeader);
                          socket.Options.KeepAliveInterval = TimeSpan.Zero;
                          await socket.ConnectAsync(uri, cToken);
                          return socket;
                      },
                  };
                  return await Puppeteer.ConnectAsync(options);
              }

              public async Task Scrape(string url)
              {
                  Log("Connecting to Browser...");
                  var browser = await Connect();
                  try {
                      Log($"Connected! Navigating to {url}...");
                      var page = await browser.NewPageAsync();
                      await page.GoToAsync(url, /* timeout= */ 2 * 60 * 1000);
                      Log("Navigated! Scraping page content...");
                      var data = await page.GetContentAsync();
                      Log($"Scraped! Data: {data}");
                  } finally {
                      await browser.CloseAsync();
                  }
              }

              private static string Env(string name, string defaultValue)
              {
                  return Environment.GetEnvironmentVariable(name) ?? defaultValue;
              }

              private static void Log(string message)
              {
                  Console.WriteLine(message);
              }

              public static async Task Main()
              {
                  var auth = Env("AUTH", "SBR_ZONE_FULL_USERNAME:SBR_ZONE_PASSWORD");
                  var url = Env("TARGET_URL", "https://example.com");
                  var scraper = new Scraper(auth);
                  await scraper.Scrape(url);
              }

          }
          ```

          ```cs Selenium theme={null}
          using OpenQA.Selenium;
          using OpenQA.Selenium.Chrome;
          using OpenQA.Selenium.Remote;

          class Scraper
          {

              private string _auth;

              public Scraper(string auth)
              {
                  _auth = auth;
              }

              private IWebDriver Connect()
              {
                  if (_auth == "SBR_ZONE_FULL_USERNAME:SBR_ZONE_PASSWORD")
                  {
                      throw new Exception("Provide Browser API credentials in AUTH"
                              + " environment variable or update the script.");
                  }
                  var uri = new Uri($"https://{_auth}@brd.superproxy.io:9515");
                  var executor = new HttpCommandExecutor(uri, TimeSpan.FromSeconds(60));
                  var cdpCommand = new HttpCommandInfo(HttpCommandInfo.PostCommand,
                          "/session/{sessionId}/goog/cdp/execute");
                  executor.TryAddCommand("cdp", cdpCommand);
                  var capabilities = new ChromeOptions().ToCapabilities();
                  return new RemoteWebDriver(executor, capabilities);
              }

              public void Scrape(string url)
              {
                  Log("Connecting to Browser...");
                  var driver = Connect();
                  try {
                      Log($"Connected! Navigating to {url}...");
                      driver.Navigate().GoToUrl(url);
                      Log("Navigated! Scraping page content...");
                      var data = driver.PageSource;
                      Log($"Scraped! Data: {data}");
                  } finally {
                      driver.Quit();
                  }
              }

              private static string Env(string name, string defaultValue)
              {
                  return Environment.GetEnvironmentVariable(name) ?? defaultValue;
              }

              private static void Log(string message)
              {
                  Console.WriteLine(message);
              }

              public static void Main()
              {
                  var auth = Env("AUTH", "SBR_ZONE_FULL_USERNAME:SBR_ZONE_PASSWORD");
                  var url = Env("TARGET_URL", "https://example.com");
                  var scraper = new Scraper(auth);
                  scraper.Scrape(url);
              }

          }
          ```
        </CodeGroup>
      </Tab>
    </Tabs>
  </Tab>

  <Tab title="Captcha">
    Open a page and wait for captcha to solve

    ### Select your pefered tech-stack

    <Tabs>
      <Tab title="NodeJS">
        <CodeGroup>
          ```js Playwright theme={null}
          #!/usr/bin/env node
          const playwright = require('playwright');
          const {
              AUTH = 'SBR_ZONE_FULL_USERNAME:SBR_ZONE_PASSWORD',
              TARGET_URL = 'https://example.com',
          } = process.env;

          async function scrape(url = TARGET_URL) {
              if (AUTH == 'SBR_ZONE_FULL_USERNAME:SBR_ZONE_PASSWORD') {
                  throw new Error(`Provide Browser API credentials in AUTH`
                      + ` environment variable or update the script.`);
              }
              console.log(`Connecting to Browser...`);
              const endpointURL = `wss://${AUTH}@brd.superproxy.io:9222`;
              const browser = await playwright.chromium.connectOverCDP(endpointURL);
              try {
                  console.log(`Connected! Navigating to ${url}...`);
                  const page = await browser.newPage();
                  const client = await page.context().newCDPSession(page);
                  await page.goto(url, { timeout: 2 * 60 * 1000 });
                  console.log(`Navigated! Waiting captcha to detect and solve...`);
                  const { status } = await client.send('Captcha.waitForSolve', {
                      detectTimeout: 10 * 1000,
                  });
                  console.log(`Captcha status: ${status}`);
              } finally {
                  await browser.close();
              }
          }

          if (require.main == module) {
              scrape().catch(error => {
                  console.error(error.stack || error.message || error);
                  process.exit(1);
              });
          }
          ```

          ```js Puppeteer theme={null}
          #!/usr/bin/env node
          const puppeteer = require('puppeteer-core');
          const {
              AUTH = 'SBR_ZONE_FULL_USERNAME:SBR_ZONE_PASSWORD',
              TARGET_URL = 'https://example.com',
          } = process.env;

          async function scrape(url = TARGET_URL) {
              if (AUTH == 'SBR_ZONE_FULL_USERNAME:SBR_ZONE_PASSWORD') {
                  throw new Error(`Provide Browser API credentials in AUTH`
                      + ` environment variable or update the script.`);
              }
              console.log(`Connecting to Browser...`);
              const browserWSEndpoint = `wss://${AUTH}@brd.superproxy.io:9222`;
              const browser = await puppeteer.connect({ browserWSEndpoint });
              try {
                  console.log(`Connected! Navigating to ${url}...`);
                  const page = await browser.newPage();
                  const client = await page.createCDPSession();
                  await page.goto(url, { timeout: 2 * 60 * 1000 });
                  console.log(`Navigated! Waiting captcha to detect and solve...`);
                  const { status } = await client.send('Captcha.waitForSolve', {
                      detectTimeout: 10 * 1000,
                  });
                  console.log(`Captcha status: ${status}`);
              } finally {
                  await browser.close();
              }
          }

          function getErrorDetails(error) {
              if (error.target?._req?.res) {
                  const {
                      statusCode,
                      statusMessage,
                  } = error.target._req.res;
                  return `Unexpected Server Status ${statusCode}: ${statusMessage}`;
              }
          }

          if (require.main == module) {
              scrape().catch(error => {
                  console.error(getErrorDetails(error)
                      || error.stack
                      || error.message
                      || error);
                  process.exit(1);
              });
          }
          ```

          ```js Selenium theme={null}
          #!/usr/bin/env node
          const { Builder, Browser } = require('selenium-webdriver');
          const {
              AUTH = 'SBR_ZONE_FULL_USERNAME:SBR_ZONE_PASSWORD',
              TARGET_URL = 'https://example.com',
          } = process.env;

          async function scrape(url = TARGET_URL) {
              if (AUTH == 'SBR_ZONE_FULL_USERNAME:SBR_ZONE_PASSWORD') {
                  throw new Error(`Provide Browser API credentials in AUTH`
                      + ` environment variable or update the script.`);
              }
              console.log(`Connecting to Browser...`);
              const server = `https://${AUTH}@brd.superproxy.io:9515`;
              const driver = await new Builder()
                  .forBrowser(Browser.CHROME)
                  .usingServer(server)
                  .build();
              try {
                  console.log(`Connected! Navigating to ${url}...`);
                  await driver.get(url);
                  console.log(`Navigated! Waiting captcha to detect and solve...`);
                  const { status } = await driver.sendAndGetDevToolsCommand('Captcha.waitForSolve', {
                      detectTimeout: 10000,
                  });
                  console.log(`Captcha status: ${status}`);
              } finally {
                  await driver.quit();
              }
          }

          if (require.main == module) {
              scrape().catch(error => {
                  console.error(error.stack || error.message || error);
                  process.exit(1);
              });
          }
          ```
        </CodeGroup>
      </Tab>

      <Tab title="Python">
        <CodeGroup>
          ```python Playwright - Async theme={null}
          #!/usr/bin/env python3
          import asyncio
          from os import environ
          from playwright.async_api import Playwright, async_playwright

          AUTH = environ.get('AUTH', default='SBR_ZONE_FULL_USERNAME:SBR_ZONE_PASSWORD')
          TARGET_URL = environ.get('TARGET_URL', default='https://example.com')


          async def scrape(playwright: Playwright, url=TARGET_URL):
              if AUTH == 'SBR_ZONE_FULL_USERNAME:SBR_ZONE_PASSWORD':
                  raise Exception('Provide Browser API credentials in AUTH ' +
                                  'environment variable or update the script.')
              print('Connecting to Browser...')
              endpoint_url = f'wss://{AUTH}@brd.superproxy.io:9222'
              browser = await playwright.chromium.connect_over_cdp(endpoint_url)
              try:
                  print(f'Connected! Navigating to {url}...')
                  page = await browser.new_page()
                  client = await page.context.new_cdp_session(page)
                  await page.goto(url, timeout=2*60_000)
                  print('Navigated! Waiting captcha to detect and solve...')
                  result = await client.send('Captcha.waitForSolve', {
                      'detectTimeout': 10 * 1000,
                  })
                  status = result['status']
                  print(f'Captcha status: {status}')
              finally:
                  await browser.close()


          async def main():
              async with async_playwright() as playwright:
                  await scrape(playwright)


          if __name__ == '__main__':
              asyncio.run(main())

          ```

          ```python Playwright - Sync theme={null}
          #!/usr/bin/env python3
          from os import environ
          from playwright.sync_api import Playwright, sync_playwright

          AUTH = environ.get('AUTH', default='SBR_ZONE_FULL_USERNAME:SBR_ZONE_PASSWORD')
          TARGET_URL = environ.get('TARGET_URL', default='https://example.com')


          def scrape(playwright: Playwright, url=TARGET_URL):
              if AUTH == 'SBR_ZONE_FULL_USERNAME:SBR_ZONE_PASSWORD':
                  raise Exception('Provide Browser API credentials in AUTH ' +
                                  'environment variable or update the script.')
              print('Connecting to Browser...')
              endpoint_url = f'wss://{AUTH}@brd.superproxy.io:9222'
              browser = playwright.chromium.connect_over_cdp(endpoint_url)
              try:
                  print(f'Connected! Navigating to {url}...')
                  page = browser.new_page()
                  client = page.context.new_cdp_session(page)
                  page.goto(url, timeout=2*60_000)
                  print('Navigated! Waiting captcha to detect and solve...')
                  result = client.send('Captcha.waitForSolve', {
                      'detectTimeout': 10 * 1000,
                  })
                  status = result['status']
                  print(f'Captcha status: {status}')
              finally:
                  browser.close()


          def main():
              with sync_playwright() as playwright:
                  scrape(playwright)


          if __name__ == '__main__':
              main()

          ```

          ```python Selenium theme={null}
          #!/usr/bin/env python3
          from os import environ
          from selenium.webdriver import Remote, ChromeOptions as Options
          from selenium.webdriver.chromium.remote_connection import ChromiumRemoteConnection as Connection

          AUTH = environ.get('AUTH', default='SBR_ZONE_FULL_USERNAME:SBR_ZONE_PASSWORD')
          TARGET_URL = environ.get('TARGET_URL', default='https://example.com')


          def scrape(url=TARGET_URL):
              if AUTH == 'SBR_ZONE_FULL_USERNAME:SBR_ZONE_PASSWORD':
                  raise Exception('Provide Browser API credentials in AUTH ' +
                                  'environment variable or update the script.')
              print('Connecting to Browser...')
              server_addr = f'https://{AUTH}@brd.superproxy.io:9515'
              connection = Connection(server_addr, 'goog', 'chrome')
              driver = Remote(connection, options=Options())
              try:
                  print(f'Connected! Navigating to {url}...')
                  driver.get(url)
                  print('Navigated! Waiting captcha to detect and solve...')
                  result = driver.execute('executeCdpCommand', {
                      'cmd': 'Captcha.waitForSolve',
                      'params': {'detectTimeout': 10 * 1000},
                  })
                  status = result['value']['status']
                  print(f'Captcha status: {status}')
              finally:
                  driver.quit()


          if __name__ == '__main__':
              scrape()

          ```
        </CodeGroup>
      </Tab>

      <Tab title="C#">
        <CodeGroup>
          ```cs Puppeteer theme={null}
          using PuppeteerSharp;
          using System.Net.WebSockets;
          using System.Text;

          class Scraper
          {

              private string _auth;

              public Scraper(string auth)
              {
                  _auth = auth;
              }

              private async Task<IBrowser> Connect()
              {
                  if (_auth == "SBR_ZONE_FULL_USERNAME:SBR_ZONE_PASSWORD")
                  {
                      throw new Exception("Provide Browser API credentials in AUTH"
                              + " environment variable or update the script.");
                  }
                  var options = new ConnectOptions()
                  {
                      BrowserWSEndpoint = "wss://brd.superproxy.io:9222",
                      WebSocketFactory = async (uri, options, cToken) =>
                      {
                          var socket = new ClientWebSocket();
                          var authBytes = Encoding.UTF8.GetBytes(_auth);
                          var authHeader = "Basic " + Convert.ToBase64String(authBytes);
                          socket.Options.SetRequestHeader("Authorization", authHeader);
                          socket.Options.KeepAliveInterval = TimeSpan.Zero;
                          await socket.ConnectAsync(uri, cToken);
                          return socket;
                      },
                  };
                  return await Puppeteer.ConnectAsync(options);
              }

              public async Task Scrape(string url)
              {
                  Log("Connecting to Browser...");
                  var browser = await Connect();
                  try {
                      Log($"Connected! Navigating to {url}...");
                      var page = await browser.NewPageAsync();
                      var client = await page.Target.CreateCDPSessionAsync();
                      await page.GoToAsync(url, /* timeout= */ 2 * 60 * 1000);
                      Log("Navigated! Waiting captcha to detect and solve...");
                      var result = await client.SendAsync("Captcha.waitForSolve", new
                      {
                          detectTimeout = 10 * 1000,
                      });
                      var status = (string) result["status"]!;
                      Log($"Captcha status: {status}");
                  } finally {
                      await browser.CloseAsync();
                  }
              }

              private static string Env(string name, string defaultValue)
              {
                  return Environment.GetEnvironmentVariable(name) ?? defaultValue;
              }

              private static void Log(string message)
              {
                  Console.WriteLine(message);
              }

              public static async Task Main()
              {
                  var auth = Env("AUTH", "SBR_ZONE_FULL_USERNAME:SBR_ZONE_PASSWORD");
                  var url = Env("TARGET_URL", "https://example.com");
                  var scraper = new Scraper(auth);
                  await scraper.Scrape(url);
              }

          }
          ```

          ```cs Selenium theme={null}
          using OpenQA.Selenium;
          using OpenQA.Selenium.Chrome;
          using OpenQA.Selenium.Remote;

          class Scraper
          {

              private string _auth;

              public Scraper(string auth)
              {
                  _auth = auth;
              }

              private WebDriver Connect()
              {
                  if (_auth == "SBR_ZONE_FULL_USERNAME:SBR_ZONE_PASSWORD")
                  {
                      throw new Exception("Provide Browser API credentials in AUTH"
                              + " environment variable or update the script.");
                  }
                  var uri = new Uri($"https://{_auth}@brd.superproxy.io:9515");
                  var executor = new HttpCommandExecutor(uri, TimeSpan.FromSeconds(60));
                  var cdpCommand = new HttpCommandInfo(HttpCommandInfo.PostCommand,
                          "/session/{sessionId}/goog/cdp/execute");
                  executor.TryAddCommand("cdp", cdpCommand);
                  var capabilities = new ChromeOptions().ToCapabilities();
                  return new RemoteWebDriver(executor, capabilities);
              }

              public void Scrape(string url)
              {
                  Log("Connecting to Browser...");
                  var driver = Connect();
                  try {
                      Log($"Connected! Navigating to {url}...");
                      driver.Navigate().GoToUrl(url);
                      Log("Navigated! Waiting captcha to detect and solve...");
                      var result = (Dictionary<string, object>) driver.ExecuteCustomDriverCommand("cdp", new ()
                      {
                          {"cmd", "Captcha.waitForSolve"},
                          {"params", new Dictionary<string, object>(){
                              {"detectTimeout", 10000},
                          }},
                      }) as Dictionary<string, object>;
                      var status = (string) result!["status"];
                      Log($"Captcha status: {status}");
                  } finally {
                      driver.Quit();
                  }
              }

              private static string Env(string name, string defaultValue)
              {
                  return Environment.GetEnvironmentVariable(name) ?? defaultValue;
              }

              private static void Log(string message)
              {
                  Console.WriteLine(message);
              }

              public static void Main()
              {
                  var auth = Env("AUTH", "SBR_ZONE_FULL_USERNAME:SBR_ZONE_PASSWORD");
                  var url = Env("TARGET_URL", "https://example.com");
                  var scraper = new Scraper(auth);
                  scraper.Scrape(url);
              }

          }

          ```
        </CodeGroup>
      </Tab>
    </Tabs>
  </Tab>

  <Tab title="Advanced">
    Inspect scraping session, advanced scraping using js snippets

    ### Select your preferred tech-stack

    <Tabs>
      <Tab title="NodeJS">
        <CodeGroup>
          ```js Playwright theme={null}
          #!/usr/bin/env node
          const playwright = require('playwright');
          const {
              AUTH = 'SBR_ZONE_FULL_USERNAME:SBR_ZONE_PASSWORD',
              TARGET_URL = 'https://example.com',
          } = process.env;

          async function scrape(url = TARGET_URL) {
              if (AUTH == 'SBR_ZONE_FULL_USERNAME:SBR_ZONE_PASSWORD') {
                  throw new Error(`Provide Browser API credentials in AUTH`
                      + ` environment variable or update the script.`);
              }
              console.log(`Connecting to Browser...`);
              const endpointURL = `wss://${AUTH}@brd.superproxy.io:9222`;
              const browser = await playwright.chromium.connectOverCDP(endpointURL);
              try {
                  console.log(`Connected! Starting inspect session...`);
                  const page = await browser.newPage();
                  const client = await page.context().newCDPSession(page);
                  const { frameTree: { frame } } = await client.send('Page.getFrameTree');
                  const { url: inspectUrl } = await client.send('Page.inspect', {
                      frameId: frame.id,
                  });
                  console.log(`You can inspect this session at: ${inspectUrl}.`);
                  console.log(`Scraping will continue in 10 seconds...`);
                  await sleep(10);
                  console.log(`Navigating to ${url}...`);
                  await page.goto(url, { timeout: 2 * 60 * 1000 });
                  console.log(`Navigated! Scraping paragraphs...`);
                  const data = await page.$$eval('p', els => els.map(el => el.innerText));
                  console.log(`Scraped! Data:`, data);
                  console.log(`Session will be closed in 1 minute...`);
                  await sleep(60);
              } finally {
                  console.log(`Closing session.`);
                  await browser.close();
              }
          }

          function sleep(seconds) {
              return new Promise(resolve => setTimeout(resolve, seconds * 1000));
          }

          if (require.main == module) {
              scrape().catch(error => {
                  console.error(error.stack || error.message || error);
                  process.exit(1);
              });
          }
          ```

          ```js Puppeteer theme={null}
          #!/usr/bin/env node
          const puppeteer = require('puppeteer-core');
          const {
              AUTH = 'SBR_ZONE_FULL_USERNAME:SBR_ZONE_PASSWORD',
              TARGET_URL = 'https://example.com',
          } = process.env;

          async function scrape(url = TARGET_URL) {
              if (AUTH == 'SBR_ZONE_FULL_USERNAME:SBR_ZONE_PASSWORD') {
                  throw new Error(`Provide Browser API credentials in AUTH`
                      + ` environment variable or update the script.`);
              }
              console.log(`Connecting to Browser...`);
              const browserWSEndpoint = `wss://${AUTH}@brd.superproxy.io:9222`;
              const browser = await puppeteer.connect({ browserWSEndpoint });
              try {
                  console.log(`Connected! Starting inspect session...`);
                  const page = await browser.newPage();
                  const client = await page.createCDPSession();
                  const { frameTree: { frame } } = await client.send('Page.getFrameTree');
                  const { url: inspectUrl } = await client.send('Page.inspect', {
                      frameId: frame.id,
                  });
                  console.log(`You can inspect this session at: ${inspectUrl}.`);
                  console.log(`Scraping will continue in 10 seconds...`);
                  await sleep(10);
                  console.log(`Navigating to ${url}...`);
                  await page.goto(url, { timeout: 2 * 60 * 1000 });
                  console.log(`Navigated! Scraping paragraphs...`);
                  const data = await page.$$eval('p', els => els.map(el => el.innerText));
                  console.log(`Scraped! Data:`, data);
                  console.log(`Session will be closed in 1 minute...`);
                  await sleep(60);
              } finally {
                  console.log(`Closing session.`);
                  await browser.close();
              }
          }

          function sleep(seconds) {
              return new Promise(resolve => setTimeout(resolve, seconds * 1000));
          }

          function getErrorDetails(error) {
              if (error.target?._req?.res) {
                  const {
                      statusCode,
                      statusMessage,
                  } = error.target._req.res;
                  return `Unexpected Server Status ${statusCode}: ${statusMessage}`;
              }
          }

          if (require.main == module) {
              scrape().catch(error => {
                  console.error(getErrorDetails(error)
                      || error.stack
                      || error.message
                      || error);
                  process.exit(1);
              });
          }
          ```

          ```js Selenium theme={null}
          #!/usr/bin/env node
          const { Builder, Browser, By } = require('selenium-webdriver');
          const {
              AUTH = 'SBR_ZONE_FULL_USERNAME:SBR_ZONE_PASSWORD',
              TARGET_URL = 'https://example.com',
          } = process.env;

          async function scrape(url = TARGET_URL) {
              if (AUTH == 'SBR_ZONE_FULL_USERNAME:SBR_ZONE_PASSWORD') {
                  throw new Error(`Provide Browser API credentials in AUTH`
                      + ` environment variable or update the script.`);
              }
              console.log(`Connecting to Browser...`);
              const server = `https://${AUTH}@brd.superproxy.io:9515`;
              const driver = await new Builder()
                  .forBrowser(Browser.CHROME)
                  .usingServer(server)
                  .build();
              const cdp = (name, params = {}) => driver.sendAndGetDevToolsCommand(name, params);
              try {
                  console.log(`Connected! Starting inspect session...`);
                  const { frameTree: { frame } } = await cdp('Page.getFrameTree');
                  const { url: inspectUrl } = await cdp('Page.inspect', {
                      frameId: frame.id,
                  });
                  console.log(`You can inspect this session at: ${inspectUrl}.`);
                  console.log(`Scraping will continue in 10 seconds...`);
                  await sleep(10);
                  console.log(`Navigating to ${url}...`);
                  await driver.get(url);
                  console.log(`Navigated! Scraping paragraphs...`);
                  const paragraphs = await driver.findElements(By.css('p'));
                  const data = await driver.executeScript(els => els.map(el => el.innerText), paragraphs);
                  console.log(`Scraped! Data:`, data);
                  console.log(`Session will be closed in 1 minute...`);
                  await sleep(60);
              } finally {
                  console.log(`Closing session.`);
                  await driver.quit();
              }
          }

          function sleep(seconds) {
              return new Promise(resolve => setTimeout(resolve, seconds * 1000));
          }

          if (require.main == module) {
              scrape().catch(error => {
                  console.error(error.stack || error.message || error);
                  process.exit(1);
              });
          }
          ```
        </CodeGroup>
      </Tab>

      <Tab title="Python">
        <CodeGroup>
          ```python Playwright - Async theme={null}
          #!/usr/bin/env python3
          import asyncio
          from os import environ
          from playwright.async_api import Playwright, async_playwright

          AUTH = environ.get('AUTH', default='SBR_ZONE_FULL_USERNAME:SBR_ZONE_PASSWORD')
          TARGET_URL = environ.get('TARGET_URL', default='https://example.com')


          async def scrape(playwright: Playwright, url=TARGET_URL):
              if AUTH == 'SBR_ZONE_FULL_USERNAME:SBR_ZONE_PASSWORD':
                  raise Exception('Provide Browser API credentials in AUTH ' +
                                  'environment variable or update the script.')
              print('Connecting to Browser...')
              endpoint_url = f'wss://{AUTH}@brd.superproxy.io:9222'
              browser = await playwright.chromium.connect_over_cdp(endpoint_url)
              try:
                  print('Connected! Starting inspect session...')
                  page = await browser.new_page()
                  client = await page.context.new_cdp_session(page)
                  frames = await client.send('Page.getFrameTree')
                  frame_id = frames['frameTree']['frame']['id']
                  inspect = await client.send('Page.inspect', {
                      'frameId': frame_id,
                  })
                  inspect_url = inspect['url']
                  print(f'You can inspect this session at: {inspect_url}.')
                  print('Scraping will continue in 10 seconds...')
                  await asyncio.sleep(10)
                  print(f'Navigating to {url}...')
                  await page.goto(url, timeout=2*60_000)
                  print('Navigated! Scraping paragraphs...')
                  data = await page.eval_on_selector_all(
                      'p', 'els => els.map(el => el.innerText)')
                  print('Scraped! Data', data)
                  print('Session will be closed in 1 minute...')
                  await asyncio.sleep(60)
              finally:
                  print('Closing session.')
                  await browser.close()


          async def main():
              async with async_playwright() as playwright:
                  await scrape(playwright)


          if __name__ == '__main__':
              asyncio.run(main())

          ```

          ```python Playwright - Sync theme={null}
          #!/usr/bin/env python3
          from os import environ
          from time import sleep
          from playwright.sync_api import Playwright, sync_playwright

          AUTH = environ.get('AUTH', default='SBR_ZONE_FULL_USERNAME:SBR_ZONE_PASSWORD')
          TARGET_URL = environ.get('TARGET_URL', default='https://example.com')


          def scrape(playwright: Playwright, url=TARGET_URL):
              if AUTH == 'SBR_ZONE_FULL_USERNAME:SBR_ZONE_PASSWORD':
                  raise Exception('Provide Browser API credentials in AUTH ' +
                                  'environment variable or update the script.')
              print('Connecting to Browser...')
              endpoint_url = f'wss://{AUTH}@brd.superproxy.io:9222'
              browser = playwright.chromium.connect_over_cdp(endpoint_url)
              try:
                  print('Connected! Starting inspect session...')
                  page = browser.new_page()
                  client = page.context.new_cdp_session(page)
                  frames = client.send('Page.getFrameTree')
                  frame_id = frames['frameTree']['frame']['id']
                  inspect = client.send('Page.inspect', {
                      'frameId': frame_id,
                  })
                  inspect_url = inspect['url']
                  print(f'You can inspect this session at: {inspect_url}.')
                  print('Scraping will continue in 10 seconds...')
                  sleep(10)
                  print(f'Navigating to {url}...')
                  page.goto(url, timeout=2*60_000)
                  print('Navigated! Scraping paragraphs...')
                  data = page.eval_on_selector_all(
                      'p', 'els => els.map(el => el.innerText)')
                  print('Scraped! Data', data)
                  print('Session will be closed in 1 minute...')
                  sleep(60)
              finally:
                  print('Closing session.')
                  browser.close()


          def main():
              with sync_playwright() as playwright:
                  scrape(playwright)


          if __name__ == '__main__':
              main()

          ```

          ```python Selenium theme={null}
          #!/usr/bin/env python3
          from os import environ
          from time import sleep
          from selenium.webdriver import Remote, ChromeOptions as Options
          from selenium.webdriver.chromium.remote_connection import ChromiumRemoteConnection as Connection
          from selenium.webdriver.common.by import By

          AUTH = environ.get('AUTH', default='SBR_ZONE_FULL_USERNAME:SBR_ZONE_PASSWORD')
          TARGET_URL = environ.get('TARGET_URL', default='https://example.com')


          def scrape(url=TARGET_URL):
              if AUTH == 'SBR_ZONE_FULL_USERNAME:SBR_ZONE_PASSWORD':
                  raise Exception('Provide Browser API credentials in AUTH ' +
                                  'environment variable or update the script.')
              print('Connecting to Browser...')
              server_addr = f'https://{AUTH}@brd.superproxy.io:9515'
              connection = Connection(server_addr, 'goog', 'chrome')
              driver = Remote(connection, options=Options())

              def cdp(cmd, params={}):
                  return driver.execute('executeCdpCommand', {
                      'cmd': cmd,
                      'params': params,
                  })['value']
              try:
                  print('Connected! Starting inspect session...')
                  frames = cdp('Page.getFrameTree')
                  frame_id = frames['frameTree']['frame']['id']
                  inspect = cdp('Page.inspect', {
                      'frameId': frame_id,
                  })
                  inspect_url = inspect['url']
                  print(f'You can inspect this session at: {inspect_url}.')
                  print('Scraping will continue in 10 seconds...')
                  sleep(10)
                  print(f'Navigating to {url}...')
                  driver.get(url)
                  print('Navigated! Scraping paragraphs...')
                  paragraphs = driver.find_elements(By.TAG_NAME, 'p')
                  data = driver.execute_script(
                      'return arguments[0].map(el => el.innerText)', paragraphs)
                  print('Scraped! Data', data)
                  print('Session will be closed in 1 minute...')
                  sleep(60)
              finally:
                  print('Closing session.')
                  driver.quit()


          if __name__ == '__main__':
              scrape()

          ```
        </CodeGroup>
      </Tab>

      <Tab title="C#">
        <CodeGroup>
          ```cs Puppeteer theme={null}
          using PuppeteerSharp;
          using System.Net.WebSockets;
          using System.Text;

          class Scraper
          {

              private string _auth;

              public Scraper(string auth)
              {
                  _auth = auth;
              }

              private async Task<IBrowser> Connect()
              {
                  if (_auth == "SBR_ZONE_FULL_USERNAME:SBR_ZONE_PASSWORD")
                  {
                      throw new Exception("Provide Browser API credentials in AUTH"
                              + " environment variable or update the script.");
                  }
                  var options = new ConnectOptions()
                  {
                      BrowserWSEndpoint = "wss://brd.superproxy.io:9222",
                      WebSocketFactory = async (uri, options, cToken) =>
                      {
                          var socket = new ClientWebSocket();
                          var authBytes = Encoding.UTF8.GetBytes(_auth);
                          var authHeader = "Basic " + Convert.ToBase64String(authBytes);
                          socket.Options.SetRequestHeader("Authorization", authHeader);
                          socket.Options.KeepAliveInterval = TimeSpan.Zero;
                          await socket.ConnectAsync(uri, cToken);
                          return socket;
                      },
                  };
                  return await Puppeteer.ConnectAsync(options);
              }

              public async Task Scrape(string url)
              {
                  Log("Connecting to Browser...");
                  var browser = await Connect();
                  try {
                      Log("Connected! Starting inspect session...");
                      var page = await browser.NewPageAsync();
                      var client = await page.Target.CreateCDPSessionAsync();
                      var frames = await client.SendAsync("Page.getFrameTree");
                      var frameId = (string) frames!["frameTree"]!["frame"]!["id"]!;
                      var inspect = await client.SendAsync("Page.inspect",
                              new { frameId = frameId });
                      var inspectUrl = (string) inspect!["url"]!;
                      Log($"You can inspect this session at: {inspectUrl}");
                      Log("Scraping will continue in 10 seconds...");
                      await Task.Delay(10 * 1000);
                      Log($"Navigating to {url}...");
                      await page.GoToAsync(url, /* timeout= */ 2 * 60 * 1000);
                      Log("Navigated! Scraping paragraphs...");
                      var paragraphs = await page.QuerySelectorAllHandleAsync("p");
                      var data = await paragraphs.EvaluateFunctionAsync(
                              "els => els.map(el => el.innerText)");
                      Log($"Scraped! Data: {data}");
                      Log("Session will be closed in 1 minute...");
                      await Task.Delay(60 * 1000);
                  } finally {
                      Log("Closing session.");
                      await browser.CloseAsync();
                  }
              }

              private static string Env(string name, string defaultValue)
              {
                  return Environment.GetEnvironmentVariable(name) ?? defaultValue;
              }

              private static void Log(string message)
              {
                  Console.WriteLine(message);
              }

              public static async Task Main()
              {
                  var auth = Env("AUTH", "SBR_ZONE_FULL_USERNAME:SBR_ZONE_PASSWORD");
                  var url = Env("TARGET_URL", "https://example.com");
                  var scraper = new Scraper(auth);
                  await scraper.Scrape(url);
              }

          }

          ```

          ```cs Selenium theme={null}
          using OpenQA.Selenium;
          using OpenQA.Selenium.Chrome;
          using OpenQA.Selenium.Remote;

          class Scraper
          {

              private string _auth;

              public Scraper(string auth)
              {
                  _auth = auth;
              }

              private WebDriver Connect()
              {
                  if (_auth == "SBR_ZONE_FULL_USERNAME:SBR_ZONE_PASSWORD")
                  {
                      throw new Exception("Provide Browser API credentials in AUTH"
                              + " environment variable or update the script.");
                  }
                  var uri = new Uri($"https://{_auth}@brd.superproxy.io:9515");
                  var executor = new HttpCommandExecutor(uri, TimeSpan.FromSeconds(60));
                  var cdpCommand = new HttpCommandInfo(HttpCommandInfo.PostCommand,
                          "/session/{sessionId}/goog/cdp/execute");
                  executor.TryAddCommand("cdp", cdpCommand);
                  var capabilities = new ChromeOptions().ToCapabilities();
                  return new RemoteWebDriver(executor, capabilities);
              }

              public void Scrape(string url)
              {
                  Log("Connecting to Browser...");
                  var driver = Connect();
                  try {
                      Log("Connected! Starting inspect session...");
                      var frames = Cdp(driver, "Page.getFrameTree");
                      var frameId = frames.Get<string>("frameTree", "frame", "id");
                      var inspect = Cdp(driver, "Page.inspect", new (){
                          {"frameId", frameId},
                      });
                      var inspectUrl = inspect.Get<string>("url");
                      Log($"You can inspect this session at: {inspectUrl}");
                      Log("Scraping will continue in 10 seconds...");
                      Thread.Sleep(10 * 1000);
                      Log($"Navigating to {url}...");
                      driver.Navigate().GoToUrl(url);
                      Log("Navigated! Scraping paragraphs...");
                      var paragraphs = driver.FindElements(By.CssSelector("p"));
                      var data = (IEnumerable<object>) driver.ExecuteScript(
                              "return arguments[0].map(el => el.innerText);", paragraphs);
                      Log($"Scraped! Data: [{string.Join(", ", data)}]");
                      Log("Session will be closed in 1 minute...");
                      Thread.Sleep(60 * 1000);
                  } finally {
                      Log("Closing session.");
                      driver.Quit();
                  }
              }

              private Dictionary<string, object> Cdp(WebDriver driver, string cmd, Dictionary<string, object>? args = null)
              {
                  var result = driver.ExecuteCustomDriverCommand("cdp", new ()
                  {
                      {"cmd", cmd},
                      {"params", args ?? new ()},
                  });
                  return (Dictionary<string, object>) result;
              }

              private static string Env(string name, string defaultValue)
              {
                  return Environment.GetEnvironmentVariable(name) ?? defaultValue;
              }

              private static void Log(string message)
              {
                  Console.WriteLine(message);
              }

              public static void Main()
              {
                  var auth = Env("AUTH", "SBR_ZONE_FULL_USERNAME:SBR_ZONE_PASSWORD");
                  var url = Env("TARGET_URL", "https://example.com");
                  var scraper = new Scraper(auth);
                  scraper.Scrape(url);
              }

          }

          static class DictionaryUtility {
              static public T Get<T>(this Dictionary<string, object> dict, params string[] path)
              {
                  object result = dict;
                  foreach (var name in path)
                  {
                      if (result is Dictionary<string, object> obj)
                          result = obj[name];
                      else
                          throw new Exception("Wrong type");
                  }
                  return (T) result;
              }
          }

          ```
        </CodeGroup>
      </Tab>
    </Tabs>
  </Tab>
</Tabs>

***

## Optimizing Bandwidth Usage with Browser API

When optimizing your web scraping projects, conserving bandwidth is key. Explore our tips and guidelines below to utilize bandwidth-saving techniques within your script and ensure efficient, resource-friendly scraping.

### **Avoid Unnecessary Media Content**

Downloading unnecessary media (images, videos) is a common bandwidth drain. You can block these resources directly within your script.

<Note>
  Resource-blocking can occasionally impact page loading due to anti-bot expectations. If you see issues after blocking resources, revert your blocking logic before contacting support.
</Note>

<Tabs>
  <Tab title="Block All Images">
    <CodeGroup>
      ```js NodeJS - Puppeteer theme={null}
       const page = await browser.newPage();  
        
        // Enable request interception  
        await page.setRequestInterception(true);  
        
        // Listen for requests  
        page.on('request', (request) => {  
          if (request.resourceType() === 'image') {  
            // If the request is for an image, block it  
            request.abort();  
          } else {  
            // If it's not an image request, allow it to continue  
            request.continue();  
         }  
       });
      ```

      ```python Selenium theme={null}
      # Set the preference to not load images  
      prefs = {"profile.managed_default_content_settings.images": 2}  
      chrome_options.add_experimental_option("prefs", prefs)  
        
      # Create a new Chrome browser instance with the defined options  
      driver = webdriver.Chrome(options=chrome_options)  
        
      driver.get('https://example.com')
      ```
    </CodeGroup>
  </Tab>

  <Tab title="Block Specific Image Formats">
    ```js theme={null}
     const page = await browser.newPage();  
      
      // Enable request interception  
      await page.setRequestInterception(true);  
      
      // Listen for requests  
      page.on('request', (interceptedRequest) => {  
      
        // Check if the request URL ends with '.png' or '.jpg'  
        if (  
          interceptedRequest.url().endsWith('.png') ||  
          interceptedRequest.url().endsWith('.jpg')  
        ) {  
      
          // If the request is for a PNG or JPG image, block it  
          interceptedRequest.abort();  
        } else {  
          // If it's not a PNG or JPG image request, allow it to continue  
          interceptedRequest.continue();  
       }  
     });
    ```
  </Tab>

  <Tab title="Block images and fonts">
    ```js Playwright theme={null}
     // Create a new context with specific resource types blocked  
      const context = await browser.newContext({  
        fetchResourceTypesToBlock: ['image', 'font']  
      });  
      
      const page = await context.newPage();  
      
      // Navigate to a webpage  
      await page.goto('https://example.com');
    ```
  </Tab>
</Tabs>

***

### **Block Unnecessary Network Requests**

Blocking media type requests alone may not always reduce your bandwidth usage. Some websites have ad spaces that continuously refresh ads, and others use live bidding mechanisms that constantly search for new ads if one fails to load properly.

In such cases, it's important to identify and block these specific network requests. Doing so will decrease the number of network requests and, consequently, lower your bandwidth usage.

```js Example theme={null}
 const blocked_resources = [
     "image",
     "stylesheet",
     "font",
     "media",
     "svg"
 ];
 
 const blocked_urls = [
     'www.googletagmanager.com/gtm.js',
     'cdn.adapex.io/hb',
     'pagead2.googlesyndication.com/',
 ];
 
 await page.setRequestInterception(true);
 
 page.on('request', request => {
     counter++;
     const is_url_blocked = blocked_urls.some(p => request.url().includes(p));
     const is_resource_blocked = blocked_resources.includes(request.resourceType());
     if (is_url_blocked || is_resource_blocked) {
         request.abort();
     } else {
         request.continue();
     }
 });
```

***

### **Use Browser Cache Efficiently**

One common inefficiency in scraping jobs is the repeated downloading of the same resources during a single session.

Leveraging the browser's built-in cache can significantly increase your scraping efficiency. When you navigate to multiple pages on the same domain, static resources like CSS files, JavaScript libraries, images, and fonts are automatically cached and reused. This saves bandwidth by avoiding redundant fetches and ensures faster page loads for subsequent requests.

#### Code Example

<Note>
  This example demonstrates how browser caching improves performance across multiple navigations to the same domain. Make sure to replace USER:PASS with your own credentials
</Note>

```js Puppeteer theme={null}
#!/usr/bin/env node
const puppeteer = require('puppeteer-core');

const AUTH = process.env.AUTH || 'USER:PASS';
const SBR_WS_ENDPOINT = `wss://${AUTH}@brd.superproxy.io:9222`;
const URL = 'https://www.ebay.com';

async function main() {
    console.log('Connecting to Scraping Browser...');
    const browser = await puppeteer.connect({
        browserWSEndpoint: SBR_WS_ENDPOINT,
    });
    
    try {
        const page = await browser.newPage();
        page.setDefaultTimeout(2 * 60 * 1000);
        
        const searchTerms = ['laptop', 'headphones', 'keyboard'];
        const timings = [];
        
        for (let i = 0; i < 3; i++) {
            console.log(`Running search ${i + 1}/3 for "${searchTerms[i]}"...`);
            
            const start = Date.now();
            await page.goto(URL, { waitUntil: "domcontentloaded" });
            const navTime = Date.now() - start;
            timings.push(navTime);
            console.log(`Search ${i + 1} nav time is ${navTime}ms`);
            
            // Wait for search input and perform search
            await page.waitForSelector("#gh-ac", { timeout: 30000 });
            await page.type("#gh-ac", searchTerms[i]);
            await page.click("#gh-search-btn");
            
            // Wait for results
            await page.waitForSelector("#srp-river-main", { timeout: 30000 });
        }
        
        console.log('\nResults:');
        const diff1to2 = timings[1] - timings[0];
        const diff1to3 = timings[2] - timings[0];

        console.log(
		`1st: ${timings[0]}ms | `+
        `2nd: ${timings[1]}ms (${diff1to2 > 0 ? '+' : ''}${diff1to2}ms) | `+
        `3rd: ${timings[2]}ms (${diff1to3 > 0 ? '+' : ''}${diff1to3}ms)`);
        
    } catch (error) {
        console.error(`ERROR: ${error.message}`);
        process.exit(1);
    } finally {
        await browser.close();
    }
}

main().catch(error => {
    console.error(`ERROR: ${error.message}`);
    process.exit(1);
});
```

#### Expected Output

```text theme={null}
Connecting to Scraping Browser...
Running search 1/3 for "laptop"...
Search 1 nav time is 10417ms
Running search 2/3 for "headphones"...
Search 2 nav time is 3133ms
Running search 3/3 for "keyboard"...
Search 3 nav time is 3243ms

Results:
1st: 10417ms | 2nd: 3133ms (-7284ms) | 3rd: 3243ms (-7174ms)
```

### Other strategies to try

* **Limit Your Requests:** Scrape only the data you need.
* **Concurrency Control:** Avoid opening too many concurrent pages; this can overload resources.
* **Session Management:** Properly close sessions to save resources and bandwidth.
* **Opt for APIs:** Use official APIs when available, they're often less bandwidth-intense.
* **Fetch Incremental Data:** Only scrape new/updated content, not the entire dataset every time.

***

***


# How to configure the Browser API
Source: https://docs.brightdata.com/scraping-automation/scraping-browser/configuration

Configure the Bright Data Browser API with your username and password, connect 1 of 3 drivers (Puppeteer, Playwright, Selenium) and run browser sessions.

To get started, you’ll need your **Browser API credentials**, specifically the **Username** and **Password** used by your web automation tool. These credentials are available in the **Overview** tab of the Browser API zone you created earlier.

Before proceeding, make sure you have your preferred browser automation framework (such as Puppeteer, Playwright, or Selenium) already installed. If it’s not installed yet, complete that setup first to ensure a smooth configuration process.

## Browser API Quick Start Examples

Run these basic examples to check that your Browser API is working (remember to swap in your credentials and target URL):

<Tip>
  For advanced examples, such as handling [**captchas**](/scraping-automation/scraping-browser/cdp-functions/custom#captcha-solver), see the [**Code Examples**](/scraping-automation/scraping-browser/code-examples) section.
</Tip>

<Tabs>
  <Tab title="NodeJS">
    <CodeGroup>
      ```js Puppeteer theme={null}
      #!/usr/bin/env node
      const puppeteer = require('puppeteer-core');
      const {
          // Replace with your Browser API zone credentials
          AUTH = 'USER:PASS',
          TARGET_URL = 'https://example.com',
      } = process.env;

      async function scrape(url = TARGET_URL) {
          if (AUTH == 'USER:PASS') {
              throw new Error(`Provide Browser API credentials in AUTH`
                  + ` environment variable or update the script.`);
          }
          console.log(`Connecting to Browser...`);
          const browserWSEndpoint = `wss://${AUTH}@brd.superproxy.io:9222`;
          const browser = await puppeteer.connect({ browserWSEndpoint });
          try {
              console.log(`Connected! Navigating to ${url}...`);
              const page = await browser.newPage();
              const client = await page.createCDPSession();
              const { frameTree: { frame } } = await client.send('Page.getFrameTree');
              const { url: inspectUrl } = await client.send('Page.inspect', {
                  frameId: frame.id,
              });
              console.log(`You can inspect this session at: ${inspectUrl}.`);
              await page.goto(url, { timeout: 2 * 60 * 1000 });
              console.log(`Navigated! Scraping page content...`);
              const data = await page.content();
              console.log(`Scraped! Data: ${data}`);
          } finally {
              await browser.close();
          }
      }

      function getErrorDetails(error) {
          if (error.target?._req?.res) {
              const {
                  statusCode,
                  statusMessage,
              } = error.target._req.res;
              return `Unexpected Server Status ${statusCode}: ${statusMessage}`;
          }
      }

      if (require.main == module) {
          scrape().catch(error => {
              console.error(getErrorDetails(error)
                  || error.stack
                  || error.message
                  || error);
              process.exit(1);
          });
      }
      ```

      ```js Playwright theme={null}
      #!/usr/bin/env node
      const playwright = require('playwright');
      const {
          // Replace with your Browser API zone credentials
          AUTH = 'USER:PASS',
          TARGET_URL = 'https://example.com',
      } = process.env;

      async function scrape(url = TARGET_URL) {
          if (AUTH == 'USER:PASS') {
              throw new Error(`Provide Browser API credentials in AUTH`
                  + ` environment variable or update the script.`);
          }
          console.log(`Connecting to Browser...`);
          const endpointURL = `wss://${AUTH}@brd.superproxy.io:9222`;
          const browser = await playwright.chromium.connectOverCDP(endpointURL);
          try {
              console.log(`Connected! Navigating to ${url}...`);
              const page = await browser.newPage();
              const client = await page.context().newCDPSession(page);
              const { frameTree: { frame } } = await client.send('Page.getFrameTree');
              const { url: inspectUrl } = await client.send('Page.inspect', {
                  frameId: frame.id,
              });
              console.log(`You can inspect this session at: ${inspectUrl}.`);
              await page.goto(url, { timeout: 2 * 60 * 1000 });
              console.log(`Navigated! Scraping page content...`);
              const data = await page.content();
              // Print HTML data
              console.log(`Scraped! Data: ${data}`);
          } finally {
              await browser.close();
          }
      }

      if (require.main == module) {
          scrape().catch(error => {
              console.error(error.stack || error.message || error);
              process.exit(1);
          });
      }
      ```

      ```js Selenium theme={null}
      #!/usr/bin/env node
      const { Builder, Browser } = require('selenium-webdriver');
      const {
          // Replace with your Browser API zone credentials
          AUTH = 'USER:PASS',
          TARGET_URL = 'https://example.com',
      } = process.env;

      async function scrape(url = TARGET_URL) {
          if (AUTH == 'USER:PASS') {
              throw new Error(`Provide Browser API credentials in AUTH`
                  + ` environment variable or update the script.`);
          }
          console.log(`Connecting to Browser...`);
          const server = `https://${AUTH}@brd.superproxy.io:9515`;
          const driver = await new Builder()
              .forBrowser(Browser.CHROME)
              .usingServer(server)
              .build();
          const cdp = (name, params = {}) => driver.sendAndGetDevToolsCommand(name, params);
          try {
              console.log(`Connected! Navigating to ${url}...`);
              const { frameTree: { frame } } = await cdp('Page.getFrameTree');
              const { url: inspectUrl } = await cdp('Page.inspect', {
                  frameId: frame.id,
              });
              console.log(`You can inspect this session at: ${inspectUrl}.`);
              await driver.get(url);
              console.log(`Navigated! Scraping page content...`);
              const data = await driver.getPageSource();
              console.log(`Scraped! Data: ${data}`);
          } finally {
              await driver.quit();
          }
      }

      if (require.main == module) {
          scrape().catch(error => {
              console.error(error.stack || error.message || error);
              process.exit(1);
          });
      }
      ```
    </CodeGroup>
  </Tab>

  <Tab title="Python">
    <CodeGroup>
      ```python Playwright theme={null}
      #!/usr/bin/env python3
      import asyncio
      from os import environ
      from playwright.async_api import Playwright, async_playwright

      # Replace with your Browser API zone credentials
      AUTH = environ.get('AUTH', default='USER:PASS')
      TARGET_URL = environ.get('TARGET_URL', default='https://example.com')


      async def scrape(playwright: Playwright, url=TARGET_URL):
          if AUTH == 'USER:PASS':
              raise Exception('Provide Browser API credentials in AUTH '
                              'environment variable or update the script.')
          print('Connecting to Browser...')
          endpoint_url = f'wss://{AUTH}@brd.superproxy.io:9222'
          browser = await playwright.chromium.connect_over_cdp(endpoint_url)
          try:
              print(f'Connected! Navigating to {url}...')
              page = await browser.new_page()
              client = await page.context.new_cdp_session(page)
              frames = await client.send('Page.getFrameTree')
              frame_id = frames['frameTree']['frame']['id']
              inspect = await client.send('Page.inspect', {
                  'frameId': frame_id,
              })
              inspect_url = inspect['url']
              print(f'You can inspect this session at: {inspect_url}.')
              await page.goto(url, timeout=2*60_000)
              print('Navigated! Scraping page content...')
              data = await page.content()
              print(f'Scraped! Data: {data}')
          finally:
              await browser.close()


      async def main():
          async with async_playwright() as playwright:
              await scrape(playwright)


      if __name__ == '__main__':
          asyncio.run(main())
      ```

      ```python Selenium theme={null}
      #!/usr/bin/env python3
      from os import environ
      from selenium.webdriver import Remote, ChromeOptions as Options
      from selenium.webdriver.chromium.remote_connection import ChromiumRemoteConnection as Connection

      # Replace with your Browser API zone credentials
      AUTH = environ.get('AUTH', default='USER:PASS')
      TARGET_URL = environ.get('TARGET_URL', default='https://example.com')


      def scrape(url=TARGET_URL):
          if AUTH == 'USER:PASS':
              raise Exception('Provide Browser API credentials in AUTH '
                              'environment variable or update the script.')
          print('Connecting to Browser...')
          browserWSEndpoint = f'https://{AUTH}@brd.superproxy.io:9515'
          connection = Connection(browserWSEndpoint, 'goog', 'chrome')
          driver = Remote(connection, options=Options())

          def cdp(cmd, params={}):
              return driver.execute('executeCdpCommand', {
                  'cmd': cmd,
                  'params': params,
              })['value']

          try:
              print(f'Connected! Navigating to {url}...')
              frames = cdp('Page.getFrameTree')
              frame_id = frames['frameTree']['frame']['id']
              inspect = cdp('Page.inspect', {
                  'frameId': frame_id,
              })
              inspect_url = inspect['url']
              print(f'You can inspect this session at: {inspect_url}')
              driver.get(url)
              print('Navigated! Scraping page content...')
              data = driver.page_source
              print(f'Scraped! Data: {data}')
          finally:
              driver.quit()


      if __name__ == '__main__':
          scrape()
      ```
    </CodeGroup>
  </Tab>

  <Tab title="C#">
    <CodeGroup>
      ```cs PuppeteerSharp theme={null}
      using PuppeteerSharp;
      using System.Net.WebSockets;
      using System.Text;

      class Scraper
      {

          private string _auth;

          public Scraper(string auth)
          {
              _auth = auth;
          }

          private async Task<IBrowser> Connect()
          {
              if (_auth == "USER:PASS")
              {
                  throw new Exception("Provide Browser API credentials in AUTH"
                          + " environment variable or update the script.");
              }
              var options = new ConnectOptions()
              {
                  BrowserWSEndpoint = "wss://brd.superproxy.io:9222",
                  WebSocketFactory = async (uri, options, cToken) =>
                  {
                      var socket = new ClientWebSocket();
                      var authBytes = Encoding.UTF8.GetBytes(_auth);
                      var authHeader = "Basic " + Convert.ToBase64String(authBytes);
                      socket.Options.SetRequestHeader("Authorization", authHeader);
                      socket.Options.KeepAliveInterval = TimeSpan.Zero;
                      await socket.ConnectAsync(uri, cToken);
                      return socket;
                  },
              };
              return await Puppeteer.ConnectAsync(options);
          }

          public async Task Scrape(string url)
          {
              Console.WriteLine("Connecting to Browser...");
              var browser = await Connect();
              try {
                  Console.WriteLine($"Connected! Navigating to {url}...");
                  var page = await browser.NewPageAsync();
                  var client = await page.Target.CreateCDPSessionAsync();
                  var frames = await client.SendAsync("Page.getFrameTree");
                  var frameId = frames!.Value.GetProperty("frameTree").GetProperty("frame")
      										.GetProperty("id").GetString();
                  var parameters = new Dictionary<string, object> { { "frameId", frameId } };
                  var inspect = await client.SendAsync("Page.inspect", parameters);
                  var inspectUrl = inspect!.Value.GetProperty("url").GetString();
                  Console.WriteLine($"You can inspect this session at: {inspectUrl}");
                  await page.GoToAsync(url, /* timeout= */ 2 * 60 * 1000);
                  Console.WriteLine("Navigated! Scraping page content...");
                  var data = await page.GetContentAsync();
                  Console.WriteLine($"Scraped! Data: {data}");
              } finally {
                  await browser.CloseAsync();
              }
          }

          private static string Env(string name, string defaultValue)
          {
              return Environment.GetEnvironmentVariable(name) ?? defaultValue;
          }

          public static async Task Main()
          {
              // Replace with your Browser API zone credentials
              var auth = Env("AUTH", "USER:PASS");
              var url = Env("TARGET_URL", "https://example.com");
              var scraper = new Scraper(auth);
              await scraper.Scrape(url);
          }

      }
      ```

      ```cs Playwright theme={null}
      using Microsoft.Playwright;

      class Scraper
      {

          private IPlaywright _pw;
          private string _auth;

          public Scraper(IPlaywright pw, string auth)
          {
              _pw = pw;
              _auth = auth;
          }

          private async Task<IBrowser> Connect()
          {
              if (_auth == "USER:PASS")
              {
                  throw new Exception("Provide Browser API credentials in AUTH"
                          + " environment variable or update the script.");
              }
              var endpointURL = $"wss://{_auth}@brd.superproxy.io:9222";
              return await _pw.Chromium.ConnectOverCDPAsync(endpointURL);
          }

          public async Task Scrape(string url)
          {
              Console.WriteLine("Connecting to Browser...");
              var browser = await Connect();
              try {
                  Console.WriteLine($"Connected! Navigating to {url}...");
                  var page = await browser.NewPageAsync();
                  var client = await page.Context.NewCDPSessionAsync(page);
                  var frames = await client.SendAsync("Page.getFrameTree");
                  var frameId = frames!.Value.GetProperty("frameTree").GetProperty("frame")
      										.GetProperty("id").GetString();
                  var parameters = new Dictionary<string, object> { { "frameId", frameId } };
                  var inspect = await client.SendAsync("Page.inspect", parameters);
                  var inspectUrl = inspect!.Value.GetProperty("url").GetString();
                  Console.WriteLine($"You can inspect this session at: {inspectUrl}");
                  await page.GotoAsync(url, new (){ Timeout = 2 * 60 * 1000 });
                  Console.WriteLine("Navigated! Scraping page content...");
                  var data = await page.ContentAsync();
                  Console.WriteLine($"Scraped! Data: {data}");
              } finally {
                  await browser.CloseAsync();
              }
          }

          private static string Env(string name, string defaultValue)
          {
              return Environment.GetEnvironmentVariable(name) ?? defaultValue;
          }

          public static async Task Main()
          {
              // Replace with your Browser API zone credentials
              var auth = Env("AUTH", "USER:PASS");
              var url = Env("TARGET_URL", "https://example.com");
              var pw = await Playwright.CreateAsync();
              var scraper = new Scraper(pw, auth);
              await scraper.Scrape(url);
          }

      }
      ```

      ```cs Selenium theme={null}
      using OpenQA.Selenium;
      using OpenQA.Selenium.Chrome;
      using OpenQA.Selenium.Remote;

      class Scraper
      {

          private string _auth;

          public Scraper(string auth)
          {
              _auth = auth;
          }

          private WebDriver Connect()
          {
              if (_auth == "USER:PASS")
              {
                  throw new Exception("Provide Browser API credentials in AUTH"
                          + " environment variable or update the script.");
              }
              var uri = new Uri($"https://{_auth}@brd.superproxy.io:9515");
              var executor = new HttpCommandExecutor(uri, TimeSpan.FromSeconds(60));
              var cdpCommand = new HttpCommandInfo(HttpCommandInfo.PostCommand,
                      "/session/{sessionId}/goog/cdp/execute");
              executor.TryAddCommand("cdp", cdpCommand);
              var capabilities = new ChromeOptions().ToCapabilities();
              return new RemoteWebDriver(executor, capabilities);
          }

          public void Scrape(string url)
          {
              Console.WriteLine("Connecting to Browser...");
              var driver = Connect();
              try {
                  Console.WriteLine($"Connected! Navigating to {url}...");
                  var frames = Cdp(driver, "Page.getFrameTree");
                  var frameId = frames.Get<string>("frameTree", "frame", "id");
                  var inspect = Cdp(driver, "Page.inspect", new (){
                      {"frameId", frameId},
                  });
                  var inspectUrl = inspect.Get<string>("url");
                  Console.WriteLine($"You can inspect this session at: {inspectUrl}");
                  driver.Navigate().GoToUrl(url);
                  Console.WriteLine("Navigated! Scraping page content...");
                  var data = driver.PageSource;
                  Console.WriteLine($"Scraped! Data: {data}");
              } finally {
                  driver.Quit();
              }
          }

          private static string Env(string name, string defaultValue)
          {
              return Environment.GetEnvironmentVariable(name) ?? defaultValue;
          }

          private Dictionary<string, object> Cdp(WebDriver driver, string cmd, Dictionary<string, object>? args = null)
          {
              var result = driver.ExecuteCustomDriverCommand("cdp", new ()
              {
                  {"cmd", cmd},
                  {"params", args ?? new ()},
              });
              return (Dictionary<string, object>) result;
          }

          public static void Main()
          {
              // Replace with your Browser API zone credentials
              var auth = Env("AUTH", "USER:PASS");
              var url = Env("TARGET_URL", "https://example.com");
              var scraper = new Scraper(auth);
              scraper.Scrape(url);
          }

      }

      static class DictionaryUtility {

          static public T Get<T>(this Dictionary<string, object> dict, params string[] path)
          {
              object result = dict;
              foreach (var name in path)
              {
                  if (result is Dictionary<string, object> obj)
                      result = obj[name];
                  else
                      throw new Exception("Wrong type");
              }
              return (T) result;
          }
      }
      ```
    </CodeGroup>
  </Tab>
</Tabs>

## How same-domain navigation works

Browser API sessions are structured to allow unlimited navigations within the same domain. This means users can freely navigate, load new pages, click links, scroll, and perform other interactive actions throughout the session, as long as all navigations remain on the same domain. To start a scraping job on a different domain, it is necessary to begin a new session.

## Session Time Limits

Browser API has 2 kinds of timeouts aimed to safeguard our customers from uncontrolled usage.

1. Idle Session Timeout: in case a browser session is kept open for 5 minutes and above in an idle mode, meaning no usage going through it, Browser API will automatically timeout the session.
2. Maximum Session Length Timeout: Browser API session can last up to 60 minutes. Once the maximum session time is reached the session will automatically timeout.


# Browser API error codes
Source: https://docs.brightdata.com/scraping-automation/scraping-browser/error-codes

Reference for Bright Data Browser API error codes, grouped into four categories, with each code's meaning and a suggested action to resolve it.

This reference lists Bright Data Browser API error codes, grouped into four categories, with each code's meaning and a suggested action.

When a request fails, Browser API returns a specific error code. Find the code in the tables below and follow the "Suggested Action" column.

## Access and permissions

These errors indicate an access or permissions issue. The request was stopped either because your Browser API zone requires a configuration change, or because the target is restricted by Bright Data's compliance safeguards.

| <div>Error Code</div> | Meaning                                                         | Suggested Action                                                                                                                                                                |
| --------------------- | --------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `brob`                | Target is blocked by robots.txt.                                | Robots.txt is a limitation from the target site defining what bots can and can't access. To remove it, complete [KYC verification](/proxy-networks/residential/network-access). |
| `brul`                | Target restricted by Bright Data.                               | If accessing blocked resources is required, get permission from compliance at [compliance@brightdata.com](mailto:compliance@brightdata.com).                                    |
| `custom_headers`      | Customer does not have permission to change headers or cookies. | Enable **Custom headers and cookies** in your zone configurations in your Browser API zone.                                                                                     |
| `wrong_customer_name` | Invalid username.                                               | Verify your username is correct in the Bright Data control panel.                                                                                                               |
| `zone_not_found`      | The specified zone does not exist or is not active.             | Confirm that you're using the correct and active "Browser API" zone from the Bright Data control panel.                                                                         |
| `wrong_password`      | Incorrect zone password.                                        | Verify your zone password is correct in the Bright Data control panel.                                                                                                          |
| `missing_credentials` | Authentication credentials missing.                             | Add valid Browser API credentials to your script.                                                                                                                               |

## Proxy errors

These errors indicate a routing or connection issue between the Browser API and the underlying proxy network. They typically happen when the proxy network struggles to establish or maintain a stable connection.

| <div>Error Code</div>    | Meaning                                                                                                                | Suggested Action                                                                 |
| ------------------------ | ---------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------- |
| `no_peers`               | Failed to establish connection with peer.                                                                              | Retry after some time, or remove peer restrictions (country, session, location). |
| `proxy_no_peer`          | Failed to establish connection with peer.                                                                              | Retry after some time, or remove peer restrictions (country, session, location). |
| `reserve_no_result`      | No peers available in the targeted country.                                                                            | Try removing or changing country targeting.                                      |
| `geo_no_navigation`      | Cannot resolve geolocation before navigating (occurs when calling `Proxy.getGeolocation` before navigating to a page). | Navigate to a page first, then retry.                                            |
| `proxy_cooling_peers`    | No peers available because the assigned peer is in a cooling period.                                                   | Retry after some time, or remove peer restrictions (country, session, location). |
| `proxy_no_peers_cooling` | No peers available because the assigned peer is in a cooling period.                                                   | Retry after some time, or remove peer restrictions (country, session, location). |
| `proxy_timeout`          | Proxy connection timeout.                                                                                              | Retry after some time.                                                           |

### `proxy_error` messages

The `proxy_error` code is part of the Proxy errors above, but it covers several proxy-side conditions. The exact cause is described in the accompanying message:

| Message                                                   | Suggested Action                  |
| --------------------------------------------------------- | --------------------------------- |
| Country is not permitted for targeting.                   | Try a different country.          |
| Proxy unable to resolve the targeted site host.           | Check that the site is available. |
| Proxy connection timeout.                                 | Retry after some time.            |
| Peer failed to establish a connection to the target site. | Retry after some time.            |

## Session limits

Browser API sessions are time-boxed to ensure optimal performance. These errors occur when a session runs too long, sits idle, or navigates multiple domains. To avoid them, break your tasks into shorter sessions and close connections promptly.

| <div>Error Code</div>        | Meaning                                                            | Suggested Action                                                                     |
| ---------------------------- | ------------------------------------------------------------------ | ------------------------------------------------------------------------------------ |
| `session_timeout`            | Session reached the 60-minute limit.                               | Reduce session time; split into multiple sessions.                                   |
| `network_inactivity_timeout` | Session terminated after 5 minutes of no network activity.         | Disconnect from the browser after scraping (for WebDriver, also delete the session). |
| `client_timeout`             | Connection from customer to browser not established in time (30s). | Check your internet connection and retry.                                            |
| `navigate_domains_limit`     | Session limited to one domain.                                     | Open a new session per domain.                                                       |

## Browser and target site

These errors occur in the browser layer due to invalid script commands, timeouts or unexpected crashes. To resolve them, debug your automation code or retry the session.

| <div>Error Code</div>  | Meaning                                                                                                                                           | Suggested Action                                                                         |
| ---------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------- |
| `cdp_cmd_timeout`      | A command to the browser timed out.                                                                                                               | Retry the command.                                                                       |
| `browser_disconnected` | Browser disconnected due to a temporary internal error.                                                                                           | Retry, or establish a new session.                                                       |
| `no_free_workers`      | No browsers were available to handle the request. This occurs before a browser connection is established and usually indicates a temporary issue. | Retry after some time. If it persists, contact [support](mailto:support@brightdata.com). |
| `worker_disconnect`    | The browser worker crashed or there was an internal infrastructure failure.                                                                       | Retry, or establish a new session.                                                       |
| `job_killed`           | The browser session was closed due to an infrastructure failure.                                                                                  | Retry, or establish a new session.                                                       |
| `page_navigated_error` | An error occurred during navigation, usually related to an internal issue.                                                                        | Retry, or establish a new session.                                                       |

### `cdp_error` messages

The `cdp_error` code is part of the Browser and target site errors above, but it covers several browser-side conditions. The exact cause is described in the accompanying message:

| Message                                                                                    | Suggested Action                                                                                   |
| ------------------------------------------------------------------------------------------ | -------------------------------------------------------------------------------------------------- |
| The browser target or session was closed and can't accept commands.                        | Fix script errors in your code (often caused by a missing `await` statement).                      |
| A CDP command was misused (for example, invalid arguments passed to `Fetch.dropRequests`). | Verify the command name and its parameters are valid and correctly formatted for that CDP command. |

## Chromium network errors (net::ERR\_\*)

When the browser can't reach or load a target site, it returns a standard Chrome network error prefixed with `net::ERR_`. These are the same errors you'd see in a regular Chrome browser, and they typically point to the state of the target site. For example, the site is temporarily down, unreachable or has an invalid TLS certificate.

Error response format:

```text theme={null}
Error: net::ERR_CONNECTION_CLOSED at https://example.com
```

Because these are native Chrome errors, there are many possible codes. To understand a specific error and its cause, search the exact error name on [source.chromium.org](https://source.chromium.org).

<Note>
  **Need more help?** For further assistance, contact [support@brightdata.com](mailto:support@brightdata.com).
</Note>


# Browser API FAQs
Source: https://docs.brightdata.com/scraping-automation/scraping-browser/faqs

FAQs about Bright Data's Browser API across 3 supported drivers (Puppeteer, Playwright, Selenium), debugging tips and integration guidelines.

<AccordionGroup>
  <Accordion title="Can I choose the country that the Browser API will scrape from?">
    Browser API automatically selects the optimal IP type and location for each request using Bright Data’s advanced unblocking capabilities. While it’s possible to specify a location, this is generally not recommended because the automated system ensures the best success for page access.

    If you need to launch from a specific country, you can add the `-country` flag with the appropriate two-letter ISO code after your username in the endpoint. For full instructions and examples, see our [location targeting documentation](/scraping-automation/scraping-browser/features/proxy-location).

    If you need to target a specific region (not just a country), check out our [Proxy.setLocation guide.](/scraping-automation/scraping-browser/features/proxy-location#geolocation-radius)
  </Accordion>

  <Accordion title="Which programming languages and tools are fully supported by Browser API?">
    * Browser API has full, native support for these combinations:
      * **Node.js**: Puppeteer (native), Playwright (native), Selenium WebDriverJS
      * **Python**: Playwright for Python, Selenium WebDriver for Python
      * **Java**: Playwright for Java, Selenium WebDriver for Java
      * **C# (.NET)**: Playwright for .NET, Selenium WebDriver for .NET

    See the [code examples](/scraping-automation/scraping-browser/code-examples) page for a variety of examples using the supported libraries.
  </Accordion>

  <Accordion title="How can I use Browser API with other languages and tools?">
    * Browser API can also be integrated with other languages using community or third-party libraries:
      * **Java**: Puppeteer Java
      * **Ruby**: Puppeteer-Ruby, playwright-ruby-client, Selenium WebDriver for Ruby
      * **Go**: chromedp, playwright-go, Selenium WebDriver for Go
    * For languages not listed, integration is possible if the library supports remote Chrome DevTools Protocol or WebDriver.

    <Note>
      For best results and access to the full feature set, use the native integrations listed in the fully supported languages FAQ.
    </Note>
  </Accordion>

  <Accordion title="How do I see the status of the captcha?">
    You can use the CDP functionality to wait for a captcha to be solved and check its status. For detailed instructions and sample code, see this [guide](/scraping-automation/scraping-browser/cdp-functions/custom#captcha-solver)

    For example, you can add this code snippet at the point in your script where you expect a captcha to appear:

    <CodeGroup>
      ```sh NodeJS, Puppeteer theme={null}
      const client = await page.target().createCDPSession();  
      const {status} = await client.send('Captcha.solve', {detectTimeout: 30*1000});   
      console.log(`Captcha solve status: ${status}`)   
      ```
    </CodeGroup>
  </Accordion>

  <Accordion title="How can I debug what's happening behind the scenes during my Browser API session?">
    You can monitor a live Browser API session by launching the **Browser API Debugger** on your local machine. This is similar to setting headless browser to 'FALSE' on Puppeteer.

    The **Browser API Debugger** serves as a valuable resource, enabling you to inspect, analyze, and fine-tune your code alongside Chrome Dev Tools, resulting in better control, visibility, and efficiency.

    ## Where do I find the Browser API Debugger?

    The Browser API Debugger can be launched via two methods:

    * Manually via Control Panel
    * Remotely via your script.

      <Tabs>
        <Tab title="via Control Panel">
          The Browser API Debugger can be easily accessed within your Bright Data [Control Panel](https://brightdata.com/cp/zones). Follow these steps:

          1. Within the control panel, go to [My Proxies](https://brightdata.com/cp/zones) view
          2. Click on your Browser API proxy
          3. Click on the **Overview** tab
          4. On the right side, Click on the "Chrome Dev Tools Debugger" button <img alt="chrome-devtools-debugger.png" /> **Getting Started with the Debugger & Chrome Dev Tools**

          <Steps>
            <Step title="Open a Browser API Session">
              * Ensure you have an **active** Browser API session
              * If you don't yet know how to launch a Browser API session, see our [Quick Start](/scraping-automation/scraping-browser/introduction) guide.
            </Step>

            <Step title="Launch the Debugger">
              * Once your session is up and running you can now launch the Debugger.
              * Click on the Debugger button within your *Overview* tab to launch the Browser API Debugger interface (see the screenshot [above](#h_01H17FZAYFCAKBQ358JN5G2FQP) )
            </Step>

            <Step title="Connect with your live browser sessions">
              * Within the Debugger interface, you will find a list of your live Browser API sessions.
              * Select the preferred session that you wish to debug
              * Click on the session link or copy/paste it into your browser of choice, and this will establish a connection between the Debugger and your selected session.
            </Step>
          </Steps>
        </Tab>

        <Tab title="via Code (remote)">
          To access and launch the debugger session directly from your script, you'll need to send the CDP command: `Page.inspect`.

          <CodeGroup>
            ```js Puppeteer theme={null}
            // Node.js Puppeteer - Inspect page using devtools  
            const page = await browser.newPage();  
            const client = await page.target().createCDPSession();  
            const {frameTree: {frame}} = await client.send('Page.getFrameTree', {});  
            const {url: inspectUrl} = await client.send('Page.inspect', {  
                frameId: frame.id,  
            });  
            console.log(`Inspect session at ${inspectUrl}`);
            ```

            ```js Playwright theme={null}
            // Node.js Playwright - Inspect page using devtools  
            const page = await browser.newPage();  
            const client = await page.context().newCDPSession(page);  
            const {frameTree: {frame}} = await client.send('Page.getFrameTree', {});  
            const {url: inspectUrl} = await client.send('Page.inspect', {  
                frameId: frame.id,  
            });  
            console.log(`Inspect session at ${inspectUrl}`);
            ```

            ```Python Playwright theme={null}
            # Python Playwright - Inspect page using devtools  
            page = await browser.new_page()  
            client = await page.context.new_cdp_session(page)  
            frame_tree = await client.send('Page.getFrameTree', {})  
            frame_id = frame_tree['frameTree']['frame']['id']  
            inspect = await client.send('Page.inspect', {'frameId': frame_id})  
            inspect_url = inspect['url']  
            print('Inspect session at', inspect_url)
            ```

            ```cs PuppeteerSharp theme={null}
            // C# PuppeteerSharp - Inspect page using devtools  
            var page = await browser.NewPageAsync();  
            var client = await page.Target.CreateCDPSessionAsync();  
            var frameTree = await client.SendAsync("Page.getFrameTree");  
            var frameId = frameTree!["frameTree"]!["frame"]!["id"]!;  
            var inspect = await client.SendAsync("Page.inspect", new { frameId = frameId });  
            var inspectUrl = inspect["url"]!;  
            Console.WriteLine($"Inspect session at {inspectUrl}");
            ```

            ```cs Playwright theme={null}
            // C# Playwright - Inspect page using devtools  
            var page = await browser.NewPageAsync();  
            var client = await page.Context.NewCDPSessionAsync(page);  
            var frameTree = await client.SendAsync("Page.getFrameTree");  
            var frameId = frameTree.Value  
                .GetProperty("frameTree")  
                .GetProperty("frame")  
                .GetProperty("id")  
                .GetString()!;  
            var inspect = await client.SendAsync("Page.inspect", new ()  
            {  
                { "frameId", frameId },  
            });  
            var inspectUrl = inspect.Value  
                .GetProperty("url")  
                .GetString()!;  
            Console.WriteLine($"Inspect session at {inspectUrl}");
            ```
          </CodeGroup>
        </Tab>
      </Tabs>

      **Leveraging Chrome Dev Tools**

      * With the Browser API Debugger now connected to your live session, you gain access to the powerful features of [Chrome Dev Tools](https://chromedevtools.github.io/devtools-protocol/).
      * Utilize the Dev Tools interface to inspect HTML elements, analyze network requests, debug JavaScript code, and monitor performance. Leverage breakpoints, console logging, and other debugging techniques to identify and resolve issues within your code. <img alt="test-sites.png" />
  </Accordion>

  <Accordion title="How to automatically launch devtools locally to view your live browser session?">
    If you would like to automatically launch devtools on every session to view your live browser session, you can integrate the following code snippet:

    ```js NodeJS - Puppeteer theme={null}
    // Node.js Puppeteer - launch devtools locally  

    // Add these requirements in addition to the other required imports
    const { exec } = require('child_process');  
    const chromeExecutable = 'google-chrome';  

    // Add these functions to the top of the script  
    const delay = ms => new Promise(resolve => setTimeout(resolve, ms));  
    const openDevtools = async (page, client) => {  
        // get current frameId  
        const frameId = page.mainFrame()._id;  
        // get URL for devtools from Browser API  
        const { url: inspectUrl } = await client.send('Page.inspect', { frameId });  
        // open devtools URL in local chrome  
        exec(`"${chromeExecutable}" "${inspectUrl}"`, error => {  
            if (error)  
                throw new Error('Unable to open devtools: ' + error);  
        });  
        // wait for devtools ui to load  
        await delay(5000);  
    };  

    // Add these lines before navigating to the target URL  
    const page = await browser.newPage();  
    const client = await page.target().createCDPSession();  
    await openDevtools(page, client);  
    await page.goto('http://example.com');

    ```
  </Accordion>

  <Accordion title="How can I get a screenshot of what's happening in the browser?">
    <Tabs>
      <Tab title="Triggering a screenshot">
        You can easily trigger a screenshot of the browser at any time by adding the following to your code:

        ```js NodeJS theme={null}
        // node.js puppeteer - Taking screenshot to file screenshot.png 
        await page.screenshot({ path: 'screenshot.png', fullPage: true });
        ```

        To take screenshots on Python and C# see [here.](/scraping-automation/scraping-browser/code-examples)
      </Tab>

      <Tab title="Launch devtools locally">
        See our full section on [opening devtools automatically.](/scraping-automation/scraping-browser/features/troubleshooting#scraping-browser-debugger)
      </Tab>
    </Tabs>
  </Accordion>

  <Accordion title="Why does the initial navigation for certain pages take longer than others?">
    There is a lot of “behind the scenes” work that goes into unlocking your targeted site.

    Some sites will take just a few seconds for navigation, while others might take even up to a minute or two as they require more complex unlocking procedures. As such, we recommend setting your navigation timeout to “2 minutes” to give the navigation enough time to succeed if needed.

    You can set your navigation timeout to 2 minutes by adding the following line in your script **before** your “page.goto” call.

    <CodeGroup>
      ```js Puppeteer theme={null}
      // node.js puppeteer - Navigate to site with 2 min timeout  
      page.goto('<https://example.com>', { timeout: 2*60*1000 });  
      ```

      ```python Playwright theme={null}
      # python playwright - Navigate to site with 2 min timeout   
      page.goto('<https://example.com>', timeout=2*60*1000)  
      ```

      ```cs PuppeteerSharp theme={null}
      // C# PuppeteerSharp - Navigate to site with 2 min timeout   
      await page.GoToAsync("https://example.com", new NavigationOptions()  
      {  
          Timeout = 2*60*1000,  
      });
      ```
    </CodeGroup>
  </Accordion>

  <Accordion title="What should I do when I get an error from the Browser API?">
    Each error returned by the Browser API includes an error code that indicates the cause of the failure. Check the [error codes page](https://docs.brightdata.com/scraping-automation/scraping-browser/error-codes) to find the meaning of the code you received and the suggested action.
  </Accordion>

  <Accordion title="Which status codes does the Browser API return for errors?">
    When a request fails, the Browser API may return a specific HTTP status code. Here are some common error codes, their meanings, and the suggested actions:

    | Error Code                      | Meaning                                 | Suggested Action                                                                                                                                            |
    | :------------------------------ | :-------------------------------------- | :---------------------------------------------------------------------------------------------------------------------------------------------------------- |
    | Unexpected server response: 407 | An issue with the remote browser's port | Check your remote browser's port. The correct port for the Browser API is `9222`.                                                                           |
    | Unexpected server response: 403 | Authentication Error                    | Check your authentication credentials (username, password) and verify that you are using the correct "Browser API" zone from the Bright Data control panel. |
    | Unexpected server response: 503 | Service Unavailable                     | We are likely scaling browsers right now to meet demand. Try to reconnect in 1 minute.                                                                      |
  </Accordion>

  <Accordion title="I can't seem to establish a connection with Browser API, do I have a connection issue?">
    If you're experiencing connection issues, you can test your local Browser API connection with a simple curl to the following endpoint:

    ```sh Shell theme={null}
    curl -v -u SBR_ZONE_FULL_USERNAME:SBR_ZONE_PASSWORD https://brd.superproxy.io:9222/json/protocol
    ```

    #### If a JSON is returned within the response:

    * Your authentication and connection to Browser API are successful. Confirm you are using these exact configurations in your script.
    * If you are still facing issues connecting to Browser API, [contact support](mailto:support@brightdata.com) for further assistance.

    #### If a JSON is not returned within the response:

    * Check your authentication details from your Browser API zone, and ensure the USER and PASS values are correct.
    * Verify network Configuration: Confirm your network and/or firewall is not blocking outbound connections to `https://brd.superproxy.io:9222`.
    * If the issue persists, please [contact support](mailto:support@brightdata.com) for further assistance.
  </Accordion>

  <Accordion title="How to Integrate Browser API with .NET Puppeteer Sharp?">
    Integration with the Browser API product with C# requires patching the PuppeteerSharp library to add support for websocket authentication. This can be done like the following:

    ```cs C# PuppeteerSharp theme={null}
    using PuppeteerSharp;  
    using System.Net.WebSockets;  
    using System.Text;  
      
    // Set the authentication credentials  
    var auth = "SBR_ZONE_FULL_USERNAME:SBR_ZONE_PASSWORD";  
    // Construct the WebSocket URL with authentication  
    var ws = $"wss://{auth}@brd.superproxy.io:9222";  
    // Custom WebSocket factory function  
    async Task<WebSocket> ws_factory(Uri url, IConnectionOptions options, CancellationToken cancellationToken)  
      
    {  
        // Create a new ClientWebSocket instance
        var socket = new ClientWebSocket();  
        // Extract the user information (username and password) from the URL  
        var user_info = url.UserInfo;  
        if (user_info != "")  
        {  
            // Encode the user information in Base64 format  
            var auth = Convert.ToBase64String(Encoding.Default.GetBytes(user_info));  
            // Set the "Authorization" header of the WebSocket options with the encoded credentials  
            socket.Options.SetRequestHeader("Authorization", $"Basic {auth}");  
        }  
      
        // Disable the WebSocket keep-alive interval  
        socket.Options.KeepAliveInterval = TimeSpan.Zero;  
        // Connect to the WebSocket endpoint  
        await socket.ConnectAsync(url, cancellationToken);  
        return socket;  
    }  
      
    // Create ConnectOptions and configure the options  
    var options = new ConnectOptions()  
      
    {  
        // Set the BrowserWSEndpoint to the WebSocket URL  
        BrowserWSEndpoint = ws,  
        // Set the WebSocketFactory to the custom factory function  
        WebSocketFactory = ws_factory,  
    };  
      
    // Connect to the browser using PuppeteerSharp  
    Console.WriteLine("Connecting to browser...");  
      
    using (var browser = await Puppeteer.ConnectAsync(options))  
    {  
        Console.WriteLine("Connected! Navigating...");  
        // Create a new page instance  
        var page = await browser.NewPageAsync();  
        // Navigate to the specified URL  
        await page.GoToAsync("https://example.com");  
        Console.WriteLine("Navigated! Scraping data...");  
        // Get the content of the page  
        var content = await page.GetContentAsync();  
        Console.WriteLine("Done!");  
        Console.WriteLine(content);  
    }
    ```
  </Accordion>

  <Accordion title="How does the Browser API pricing work?">
    Browser API pricing is simple: you only pay for gigabytes of traffic that you transferred through the Browser API.

    There is no cost for instances or time using the Browser API - only traffic.

    It doesn't matter what country you are using, traffic is billed at the same rates. Because you pay by traffic, you probably will want to minimize it.

    The only exception to this is premium domains, which cost more per gigabyte, because Bright Data needs to invest a significantly higher amount of effort and resources to unblock. You can find more information about premium domains in your Browser API configuration pages.
  </Accordion>

  <Accordion title="How do I reduce data and bandwidth consumption with Browser API?">
    To reduce bandwidth usage and make your scraping more efficient, you can:

    * Block unnecessary resources such as images, stylesheets, and ads using request interception or CDP custom functions
    * Take advantage of browser caching
    * Follow best practices for request management

    For practical tips and code examples, see our [**Bandwidth Optimization Guide.**](/scraping-automation/scraping-browser/code-examples#optimizing-bandwidth-usage-with-browser-api)<br />For instructions and code on blocking ads using CDP custom functions, see our custom **[Ad Blocker](/scraping-automation/scraping-browser/cdp-functions/custom#ad-blocker).**
  </Accordion>

  <Accordion title="Is password typing allowed with Browser API?">
    Bright Data is committed to collecting only publicly available data. To uphold this commitment, Browser API is configured by default to prevent any attempts to log in to accounts by disabling password entry. This restriction helps ensure that no non-public data, including any data accessible only behind a login, is scraped. For your reference, please review our Acceptable Use Policy at [https://brightdata.com/acceptable-use-policy](https://brightdata.com/acceptable-use-policy) .

    In certain cases, it may be possible to override this default block. If you require an exception, you must first complete our Know-Your-Customer (KYC) process available at [https://brightdata.com/cp/kyc](https://brightdata.com/cp/kyc). Once you have completed the process, please contact our compliance department directly at [compliance@brightdata.com](mailto:compliance@brightdata.com) to submit your request (you could also request the permissions during your KYC process).
  </Accordion>

  <Accordion title="How can I keep the same IP address in Browser API sessions?">
    The Browser API supports maintaining IP address across multiple browser sessions using a custom CDP function. This allows you to reuse the same proxy peer for consecutive requests by associating them with the same session ID.

    For implementation details and sample code, see our documentation on [Session Persistence](/scraping-automation/scraping-browser/cdp-functions/custom#session-persistence)
  </Accordion>

  <Accordion title="What’s the difference between integrating a proxy with automation scripts and using the Browser API?">
    **1. Integrating a Proxy with Automation Scripts**

    * You set up proxies directly in your own scripts using tools like Puppeteer, Playwright, or Selenium.
    * You manage everything: browser setup, sessions, scaling, anti-bot challenges (CAPTCHAs, fingerprints, headers, etc.).
    * Offers full control and flexibility, but you’re responsible for maintaining and troubleshooting all aspects, including unblocking and scalability.

    **2. Using the Browser API**

    * You connect your automation scripts to a managed browser running in Bright Data’s cloud.
    * Bright Data handles infrastructure, scaling, anti-bot/unblocking (CAPTCHAs, fingerprints, etc.), and proxy rotation.
    * You focus only on your scraping logic. It’s easier to scale, especially for complex interactive sites.
    * Ideal if you want powerful scraping without the need to maintain or build your own anti-bot solutions.

    **Summary:** With direct proxy integration, you’re in control but manage all complexity. With Browser API, Bright Data takes care of the hardest parts and you only write your scraping workflow.

    For more details, see the [Browser API introduction](/scraping-automation/scraping-browser/introduction).
  </Accordion>

  <Accordion title="How to make scraping faster with Browser API?">
    Browser API performance and optimization are managed on our side. We are always working to improve speed and reliability. There is no user-accessible setting to directly increase browser speed.

    Blocking unnecessary network requests (such as images, ads, and analytics) in your script can reduce data usage and may sometimes improve page load speed when using Browser API, but faster loading is not guaranteed. The main, reliable benefit is saving bandwidth.

    For more details and example code, see our [bandwidth-saving guide](/scraping-automation/scraping-browser/code-examples#optimizing-bandwidth-usage-with-browser-api).
  </Accordion>

  <Accordion title="How do I know what type of proxies the Browser API is using?">
    By default, Browser API uses Residential proxies. For some domains that require KYC, it may automatically switch to Datacenter proxies if needed for compliance.

    Learn more about KYC and Residential proxy access [here](/proxy-networks/residential/network-access).

    <Note>
      The linked page covers Residential proxy access and KYC requirements. Some details about SSL errors and other proxy types do not apply to Browser API.
    </Note>
  </Accordion>

  <Accordion title="How do I connect to Browser API with Playwright, Puppeteer, or Selenium?">
    To connect to the Browser API, you need your zone username and zone password.

    * For Playwright and Puppeteer, connect using a WebSocket (`wss://`) endpoint with the host `brd.superproxy.io` and port `9222`.
      * **Example connection URL:** `wss://${AUTH}@brd.superproxy.io:9222`
    * For Selenium, connect using an HTTPS endpoint with the host `brd.superproxy.io` and port `9515`.
      * **Example connection URL:** `https://${AUTH}@brd.superproxy.io:9515`

    See the [Configuration page](/scraping-automation/scraping-browser/configuration) for code examples on how to connect with each library, using your zone username and password in the connection URL.

    <Warning>
      Do not add extra or custom connection options to your settings, as this can break the connection or degrade performance. Simply use the provided WebSocket or HTTPS endpoints with your zone credentials.
    </Warning>

    <Note>
      Currently, the only way to connect to Browser API is via WebSocket or HTTPS endpoints using your zone credentials (username and password). There is no REST API connection method at this time.
    </Note>
  </Accordion>

  <Accordion title="Proxy vs. Browser API, what’s the difference and which endpoint do I use?">
    * Regular Proxy Network: you launch your own browser/process and route traffic through `brd.superproxy.io:44445`, authenticating with `brd-customer-<CID>-zone-<ZONE>:<PASSWORD>` .
    * Browser API (formerly Scraping Browser): Bright Data spins up a managed, cloud Chrome for you. You **do not** start `puppeteer.launch()`. Instead, you attach to the remote browser:

    <CodeGroup>
      ```sh NodeJS, Puppeteer theme={null}
      const puppeteer = require('puppeteer-core');

      const AUTH = 'SBR_ZONE_FULL_USERNAME:SBR_ZONE_PASSWORD';      // found in Browser API Zone → Overview
      const WS  = `wss://${AUTH}@brd.superproxy.io:9222`; 

      (async () => {
        const browser = await puppeteer.connect({browserWSEndpoint: WS});
        const page = await browser.newPage();
        await page.goto('https://example.com', {timeout: 2*60*1000});
        console.log(await page.title());
        await browser.close();
      })(); 
      ```
    </CodeGroup>
  </Accordion>

  <Accordion title="Can I navigate to multiple URLs in a single Browser API session?">
    Yes - Browser API sessions support unlimited navigations within the same domain. You can freely navigate between pages, click links, submit forms, scroll, and perform other interactive actions throughout the session, as long as all navigations remain on the same domain.

    To start a scraping job on a different domain, you need to begin a new session.
  </Accordion>
</AccordionGroup>


# Disable CAPTCHA solver
Source: https://docs.brightdata.com/scraping-automation/scraping-browser/features/captcha-solver

By default, as part of our full proxy unblocking solution, Browser API also solves CAPTCHAs that are encountered while returning your proxy request.

When disabling CAPTCHA solver, our unlocker algorithm still takes care of the entire ever-changing flow of finding the best proxy network, customizing headers, fingerprinting, and more, but intentionally does not solve CAPTCHAs automatically, giving your team a lightweight, streamlined solution, that broadens the scope of your potential scraping opportunities.

Best for:

* Scraping data from websites without getting blocked
* Emulating real-user web behavior

<Accordion title="How can I get started?">
  To disable CAPTCHA solving just open the relevant zone, go to the ‘configuration’ tab and open the advanced settings where you will find the ‘Automatic Captcha Solving’ controller. To disable CAPTCHA solving just switch off the toggle.

  <Frame>
    <img alt="automatic-captcha-solving.png" />
  </Frame>
</Accordion>

<Note>
  If you would like to manually configure our default CAPTCHA solver through CDP commands on your own, see [custom CDP functions](/scraping-automation/scraping-browser/cdp-functions/custom)
</Note>


# Browser API playground
Source: https://docs.brightdata.com/scraping-automation/scraping-browser/features/playground

Use the Bright Data Browser API Playground to run example scripts, watch live browser sessions and inspect logs. Currently supports 1 driver: Puppeteer in JS.

The Playground is a code editor for experimenting with the Browser API. With this tool you can run ready-made example scripts or edit the scripts and run your own for testing purposes.
Playground Supported Libraries, Languages and Features

While Browser API supports all common libraries and languages, the current version of the playground can be used with Puppeteer and JavaScript. We promise to add the rest soon enough!

Please note that any features that involve a connection with the user side infrastructure will be supported in production but not in the playground, for example saving files to the user’s file system or using pre-installed libraries like Cheerio. To test Browser API with it’s full capabilities use your usual coding environment.

## Which playground features are available

* Code editor:
  * By default the code editor will be hosting an example scraper script
  * Script examples can be edited freely or including completely removing them and building any custom script from scratch to run with the Browser API
  * A reset button to revert back to the original example script
* Console logs view
* Web interaction and results view: presents the raw HTML going through the browser or visualizes the browser interactions.

<Frame>
  <img alt="playground-features.png" />
</Frame>

## Ready Made Example

Run existing example scripts to instantly see the product at work. The example scripts demo the scraping of real target sites. You will be able to see the full script, console logs and a visualization of the browser interaction with the target site.

## How to edit code in the playground

Use the code editor to edit the default example scripts or replace them altogether with your own and run any custom scripts to view results or debug your code.
If needed you can always click the reset button and revert back to the original example script.


# Browser API: premium domains
Source: https://docs.brightdata.com/scraping-automation/scraping-browser/features/premium-domains

Enable Premium Domains on the Bright Data Browser API to unblock the hardest target sites, with pricing shown in your zone cost estimate before activation.

## Enable Premium Domains

When creating your Browser API zone, enable the 'Premium Domains' switch.

## Pricing

Once enabled, the premium price will be reflected in the "Estimated cost" section.

<Note>
  Even after enabled, only specific requests to these domains will be priced at the higher rate. Requests to other domains will be kept at the default lower tier.
</Note>

## Current List of Premium Domains

<Note>
  This list is frequently changing based on our website classification logic. You can see the most up-to-date list within your proxy zone.
</Note>

<div>Loading...</div>


# Browser API geolocation targeting
Source: https://docs.brightdata.com/scraping-automation/scraping-browser/features/proxy-location

Geo-target the Bright Data Browser API to countries, states or cities across 195 countries. Automatic peer selection is on by default; manual overrides.

<Tip>
  Browser API automatically selects the optimal peer location for your sessions, reducing the need for manual configuration in **most** cases. Manual geo-targeting is useful when accessing region-restricted or location-specific data.
</Tip>

* [**Country**](/scraping-automation/scraping-browser/features/proxy-location#country) - targets peers from a specific country
* [**Geolocation radius**](/scraping-automation/scraping-browser/features/proxy-location#geolocation-radius) – targets peers using an exact latitude, longitude, and radius simulating a precise physical location for more granular geo-targeted data collection.

## How to target a country

Add the `-country` flag, after your `USER` credentials within the Bright Data endpoint, followed by the 2-letter ISO code for that country.

For example, Browser API using Puppeteer in the USA:

<CodeGroup>
  ```sh NodeJS, Puppeteer theme={null}
  const SBR_WS_ENDPOINT = `wss://${USERNAME-country-us:PASSWORD}@brd.superproxy.io:9222`;
  ```
</CodeGroup>

**EU region** You can target the entire European Union region in the same manner as "Country" above by adding "eu" after "country" in your request: "-country-eu".

Requests sent using -country-eu, will use IPs from one of the countries below which are included automatically within "eu": `AL, AZ, KG, BA, UZ, BI, XK, SM, DE, AT, CH, UK, GB,IE, IM, FR, ES, NL, IT, PT, BE, AD, MT, MC, MA, LU, TN, DZ, GI, LI, SE, DK, FI, NO, AX, IS, GG, JE, EU, GL, VA, FX, FO.`

## How to set the geolocation radius

Use the `Proxy.setLocation` function to dynamically change the location of your proxies using an exact latitude, longitude, and radius.

### Parameters

<ParamField type="float">
  Specifies the latitude of the desired proxy location.
</ParamField>

<ParamField type="float">
  Specifies the longitude of the desired proxy location.
</ParamField>

<ParamField type="boolean">
  Defines the desired behavior in case no peers are available in the specified distance.

  `strict: true` - Bright Data will search for available peers only within the specific distance.

  `strict: false` - if no peers are available in the specified distance we will automatically expand the distance and look for the nearest available peers.
</ParamField>

### How to use proxy location targeting

The `Proxy.setLocation` command should be invoked before navigating to the site for which the proxy is intended. This ensures that the proxy location is set accurately according to the specified parameters before any data requests are made.

**How to run examples**

You need to get Browser API credentials in the control panel. Pass it in format `SBR_ZONE_FULL_USERNAME:SBR_ZONE_PASSWORD` as environment variable `AUTH`

<CodeGroup>
  ```sh Shell theme={null}
  export AUTH=brd-customer-<customer_id>-zone-<zone_name>:<zone_password>
  ```

  ```sh CMD theme={null}
  set AUTH=brd-customer-<customer_id>-zone-<zone_name>:<zone_password>
  ```

  ```powershell Powershell theme={null}
  $Env:AUTH = 'brd-customer-<customer_id>-zone-<zone_name>:<zone_password>'
  ```
</CodeGroup>

<Tip>
  You can also pass `TARGET_URL` environment variable to change default targeted website.
</Tip>

### Code Examples

Change proxy location before scraping

<Tip>
  Select your pefered tech-stack
</Tip>

<CodeGroup>
  ```js NodeJS - Playwright theme={null}
  #!/usr/bin/env node
  const playwright = require('playwright');
  const {
      AUTH = 'SBR_ZONE_FULL_USERNAME:SBR_ZONE_PASSWORD',
      TARGET_URL = 'https://geo.brdtest.com/mygeo.json',
      LOCATION = 'amsterdam',
  } = process.env;

  const LOCATIONS = Object.freeze({
      amsterdam: { lat: 52.377956, lon: 4.897070 },
      london: { lat: 51.509865, lon: -0.118092 },
      new_york: { lat: 40.730610, lon: -73.935242 },
      paris: { lat: 48.864716, lon: 2.349014 },
  });

  async function scrape(url = TARGET_URL, location = LOCATION) {
      if (AUTH == 'SBR_ZONE_FULL_USERNAME:SBR_ZONE_PASSWORD') {
          throw new Error(`Provide Browser API credentials in AUTH`
              + ` environment variable or update the script.`);
      }
      if (!LOCATIONS[location]) {
          throw new Error(`Unknown location`);
      }
      const { lat, lon } = LOCATIONS[location];
      console.log(`Connecting to Browser...`);
      const endpointURL = `wss://${AUTH}@brd.superproxy.io:9222`;
      const browser = await playwright.chromium.connectOverCDP(endpointURL);
      try {
          console.log(`Connected! Changing proxy location`
              + ` to ${location} (${lat}, ${lon})...`);
          const page = await browser.newPage();
          const client = await page.context().newCDPSession(page);
          await client.send('Proxy.setLocation', {
              lat, lon,
              distance: 50 /* kilometers */,
              strict: true,
          });
          console.log(`Navigating to ${url}...`);
          await page.goto(url, { timeout: 2 * 60 * 1000 });
          console.log(`Navigated! Scraping data...`);
          const data = await page.$eval('body', el => el.innerText);
          console.log(`Scraped! Data:`, JSON.parse(data));
      } finally {
          await browser.close();
      }
  }

  if (require.main == module) {
      scrape().catch(error => {
          console.error(error.stack || error.message || error);
          process.exit(1);
      });
  }
  ```

  ```js NodeJS - Puppeteer theme={null}
  #!/usr/bin/env node
  const puppeteer = require('puppeteer-core');
  const {
      AUTH = 'SBR_ZONE_FULL_USERNAME:SBR_ZONE_PASSWORD',
      TARGET_URL = 'https://geo.brdtest.com/mygeo.json',
      LOCATION = 'amsterdam',
  } = process.env;

  const LOCATIONS = Object.freeze({
      amsterdam: { lat: 52.377956, lon: 4.897070 },
      london: { lat: 51.509865, lon: -0.118092 },
      new_york: { lat: 40.730610, lon: -73.935242 },
      paris: { lat: 48.864716, lon: 2.349014 },
  });

  async function scrape(url = TARGET_URL, location = LOCATION) {
      if (AUTH == 'SBR_ZONE_FULL_USERNAME:SBR_ZONE_PASSWORD') {
          throw new Error(`Provide Browser API credentials in AUTH`
              + ` environment variable or update the script.`);
      }
      if (!LOCATIONS[location]) {
          throw new Error(`Unknown location`);
      }
      const { lat, lon } = LOCATIONS[location];
      console.log(`Connecting to Browser...`);
      const browserWSEndpoint = `wss://${AUTH}@brd.superproxy.io:9222`;
      const browser = await puppeteer.connect({ browserWSEndpoint });
      try {
          console.log(`Connected! Changing proxy location`
              + ` to ${location} (${lat}, ${lon})...`);
          const page = await browser.newPage();
          const client = await page.createCDPSession();
          await client.send('Proxy.setLocation', {
              lat, lon,
              distance: 50 /* kilometers */,
              strict: true,
          });
          console.log(`Navigating to ${url}...`);
          await page.goto(url, { timeout: 2 * 60 * 1000 });
          console.log(`Navigated! Scraping data...`);
          const data = await page.$eval('body', el => el.innerText);
          console.log(`Scraped! Data:`, JSON.parse(data));
      } finally {
          await browser.close();
      }
  }

  function getErrorDetails(error) {
      if (error.target?._req?.res) {
          const {
              statusCode,
              statusMessage,
          } = error.target._req.res;
          return `Unexpected Server Status ${statusCode}: ${statusMessage}`;
      }
  }

  if (require.main == module) {
      scrape().catch(error => {
          console.error(getErrorDetails(error)
              || error.stack
              || error.message
              || error);
          process.exit(1);
      });
  }
  ```

  ```js NodeJS - Selenium theme={null}
  #!/usr/bin/env node
  const { Builder, Browser, By } = require('selenium-webdriver');
  const {
      AUTH = 'SBR_ZONE_FULL_USERNAME:SBR_ZONE_PASSWORD',
      TARGET_URL = 'https://geo.brdtest.com/mygeo.json',
      LOCATION = 'amsterdam',
  } = process.env;

  const LOCATIONS = Object.freeze({
      amsterdam: { lat: 52.377956, lon: 4.897070 },
      london: { lat: 51.509865, lon: -0.118092 },
      new_york: { lat: 40.730610, lon: -73.935242 },
      paris: { lat: 48.864716, lon: 2.349014 },
  });

  async function scrape(url = TARGET_URL, location = LOCATION) {
      if (AUTH == 'SBR_ZONE_FULL_USERNAME:SBR_ZONE_PASSWORD') {
          throw new Error(`Provide Browser API credentials in AUTH`
              + ` environment variable or update the script.`);
      }
      if (!LOCATIONS[location]) {
          throw new Error(`Unknown location`);
      }
      const { lat, lon } = LOCATIONS[location];
      console.log(`Connecting to Browser...`);
      const server = `https://${AUTH}@brd.superproxy.io:9515`;
      const driver = await new Builder()
          .forBrowser(Browser.CHROME)
          .usingServer(server)
          .build();
      try {
          console.log(`Connected! Changing proxy location`
              + ` to ${location} (${lat}, ${lon})...`);
          await driver.sendAndGetDevToolsCommand('Proxy.setLocation', {
              lat, lon,
              distance: 50 /* kilometers */,
              strict: true,
          });
          console.log(`Navigating to ${url}...`);
          await driver.get(url);
          console.log(`Navigated! Scraping data...`);
          const body = await driver.findElement(By.css('body'));
          const data = await body.getText();
          console.log(`Scraped! Data:`, JSON.parse(data));
      } finally {
          await driver.quit();
      }
  }

  if (require.main == module) {
      scrape().catch(error => {
          console.error(error.stack || error.message || error);
          process.exit(1);
      });
  }
  ```
</CodeGroup>

## How to get proxy geolocation

Use this command to retrieve the exact geo-location information of the proxy peer assigned to your current browser session. This is useful for logging and verifying the assigned peer's location on your end.

### Proxy geolocation CDP command

* `Proxy.getGeolocation`

<Note>
  Use the CDP command after navigation to the target page.
</Note>

```js Example (Puppeteer) theme={null}
const page = await browser.newPage();
const client = await page.createCDPSession();
await page.goto('https://example.com');
const geolocation = await client.send('Proxy.getGeolocation');
console.log('Proxy Geolocation:', geolocation);
```

```json Returns theme={null}
{
  "result": {
    "ip_version": 4,
    "country": "us",
    "asn": {
      "asnum": 7018,
      "org_name": "AT&T Enterprises, LLC"
    },
    "geo": {
      "city": "Rogers",
      "city_slug": "rogers",
      "region": "ar",
      "region_slug": "ar",
      "region_name": "Arkansas",
      "postal_code": "72758",
      "latitude": 36.3174,
      "longitude": -94.1548,
      "tz": "America/Chicago"
    }
  }
}
```


# Browser API troubleshooting
Source: https://docs.brightdata.com/scraping-automation/scraping-browser/features/troubleshooting

Get troubleshooting tips for the Bright Data Browser API. Use the debugger to analyze and optimize web scraping with Chrome Dev Tools.

## Browser API Debugger

Web scraping projects often require intricate interactions with target websites and debugging is vital for identifying and resolving issues found during the development process. The Browser API Debugger serves as a valuable resource, enabling you to inspect, analyze, and fine-tune your code alongside Chrome Dev Tools, resulting in better control, visibility, and efficiency.

### Where to find it

Our Browser API Debugger can be launched via two methods:

1. Manually via Control Panel
2. Remotely via your script

Choose your preferred method below to see more:

<Tabs>
  <Tab title="Manually via Control Panel">
    The Browser API Debugger can be easily accessed within your Bright Data Control Panel. Follow these steps:

    1. Within the control panel, go to [My Zones](https://brightdata.com/cp/zones)
    2. Click on your specific Browser API zone
    3. Click on the **Overview** tab
    4. On the right side, Click on the "Chrome Dev Tools Debugger" button seen below: <img alt="Where to find it" />

    ### Getting Started with the Debugger & Chrome Dev Tools

    <Steps>
      <Step title="Open a Browser API Session">
        * Ensure you have an active Browser API session
        * If you don't yet know how to launch a Browser API session, see our Quick Start guide.
      </Step>

      <Step title="Launch the Debugger">
        * Once your session is up and running you can now launch the Debugger.
        * Click on the Debugger button within your 'Access parameters' tab to launch the Browser API Debugger interface (see the screenshot above )
      </Step>

      <Step title="Connect with your live browser sessions">
        * Within the Debugger interface, you will find a list of your live Browser API sessions.
        * Select the preferred session that you wish to debug
        * Click on the session link or copy/paste it into your browser of choice, and this will establish a connection between the Debugger and your selected session.

        <Frame>
          <img alt="Where to find it" />
        </Frame>
      </Step>
    </Steps>
  </Tab>

  <Tab title="Remotely via your script">
    To access and launch the debugger session directly from your script, you'll need to send the CDP command: `Page.inspect`.

    See the following examples:

    <CodeGroup>
      ```js NodeJS theme={null}
      // Puppeteer - Inspect page using devtools
      const page = await browser.newPage();
      const client = await page.target().createCDPSession();
      const {frameTree: {frame}} = await client.send('Page.getFrameTree', {});
      const {url: inspectUrl} = await client.send('Page.inspect', {
          frameId: frame.id,
      });
      console.log(`Inspect session at ${inspectUrl}`);

      // Playwright - Inspect page using devtools
      const page = await browser.newPage();
      const client = await page.context().newCDPSession(page);
      const {frameTree: {frame}} = await client.send('Page.getFrameTree', {});
      const {url: inspectUrl} = await client.send('Page.inspect', {
          frameId: frame.id,
      });
      console.log(`Inspect session at ${inspectUrl}`);
      ```

      ```python Python theme={null}
      # Playwright - Inspect page using devtools
      page = await browser.new_page()
      client = await page.context.new_cdp_session(page)
      frame_tree = await client.send('Page.getFrameTree', {})
      frame_id = frame_tree['frameTree']['frame']['id']
      inspect = await client.send('Page.inspect', {'frameId': frame_id})
      inspect_url = inspect['url']
      print('Inspect session at', inspect_url)
      ```

      ```cs C# theme={null}
      // PuppeteerSharp - Inspect page using devtools
      var page = await browser.NewPageAsync();
      var client = await page.Target.CreateCDPSessionAsync();
      var frameTree = await client.SendAsync("Page.getFrameTree");
      var frameId = frameTree!["frameTree"]!["frame"]!["id"]!;
      var inspect = await client.SendAsync("Page.inspect", new { frameId = frameId });
      var inspectUrl = inspect["url"]!;
      Console.WriteLine($"Inspect session at {inspectUrl}");

      // Playwright - Inspect page using devtools
      var page = await browser.NewPageAsync();
      var client = await page.Context.NewCDPSessionAsync(page);
      var frameTree = await client.SendAsync("Page.getFrameTree");
      var frameId = frameTree.Value
          .GetProperty("frameTree")
          .GetProperty("frame")
          .GetProperty("id")
          .GetString()!;
      var inspect = await client.SendAsync("Page.inspect", new ()
      {
          { "frameId", frameId },
      });
      var inspectUrl = inspect.Value
          .GetProperty("url")
          .GetString()!;
      Console.WriteLine($"Inspect session at {inspectUrl}");
      ```
    </CodeGroup>
  </Tab>
</Tabs>

### Leveraging Chrome Dev Tools

* With the Browser API Debugger now connected to your live session, you gain access to the powerful features of Chrome Dev Tools.
* Utilize the Dev Tools interface to inspect HTML elements, analyze network requests, debug JavaScript code, and monitor performance. Leverage breakpoints, console logging, and other debugging techniques to identify and resolve issues within your code.

<Frame>
  <img alt="test-sites.png" />
</Frame>

### Automatically opening devtools locally to view your live browser session

If you would like to automatically launch devtools on every session to view your live browser session, you can integrate the following code snippet:

```js NodeJS - Puppeteer theme={null}
// Launch devtools locally

const { exec } = require('child_process');
const chromeExecutable = 'google-chrome';

const delay = ms => new Promise(resolve => setTimeout(resolve, ms));
const openDevtools = async (page, client) => {
    // get current frameId
    const frameId = page.mainFrame()._id;
    // get URL for devtools from Browser API
    const { url: inspectUrl } = await client.send('Page.inspect', { frameId });
    // open devtools URL in local chrome
    exec(`"${chromeExecutable}" "${inspectUrl}"`, error => {
        if (error)
            throw new Error('Unable to open devtools: ' + error);
    });
    // wait for devtools ui to load
    await delay(5000);
};

const page = await browser.newPage();
const client = await page.target().createCDPSession();
await openDevtools(page, client);
await page.goto('http://example.com');
```

### How to use the debugger

Check out the Browser API Debugger in action below

<Frame>
  <iframe title="Debugger Walkthrough" />
</Frame>

## Error codes

Review the [full list of Browser API error codes](/scraping-automation/scraping-browser/error-codes), including each code's meaning and a suggested action.

## FAQs

Check out our [frequently asked questions](/scraping-automation/scraping-browser/faqs) regarding Browser API

## How To

Find out more about the [common library navigational functions](/scraping-automation/scraping-browser/code-examples) and examples for browser automation and specifically for Browser API


# Agent web access
Source: https://docs.brightdata.com/ai/agents

Complete web infrastructure for AI agents that need reliable, scalable web access. Achieves 99.3% success rate on production workloads.

<Card title="Building an AI startup?" href="https://brightdata.com/ai/ai-startups-program" icon="rocket-launch">
  You might be eligible for our Startup Program. Get fully funded access to the infrastructure you're reading about right now (up to \$20K value).
</Card>

## Agent Web Access

Complete web infrastructure for AI agents that need reliable, scalable web access.

Build AI agents that automatically enrich data, conduct competitive intelligence research, and evaluate model outputs. Production-ready APIs for enterprise-scale web access.

<CardGroup>
  <Card title="Get Started" icon="rocket" href="#architecture-patterns">
    Learn how to architect web access for AI agents
  </Card>

  <Card title="Product Selection" icon="list" href="#product-selection-guide">
    Choose the right products for your use case
  </Card>
</CardGroup>

***

## Why Standard Infrastructure Falls Short

<CardGroup>
  <Card title="Standard Infrastructure" icon="xmark">
    60%+ failure rate on protected sites due to anti-bot measures and rate limits

    CAPTCHA challenges stop agents completely

    Rate limiting blocks real-time scaling

    Frequent timeouts under high concurrency

    No SLA for business-critical applications
  </Card>

  <Card title="Bright Data Infrastructure" icon="check">
    99.3%+ success rate with automated CAPTCHA solving and unblocking

    Real-time data access at global scale

    1,000+ concurrent jobs with 99.99% uptime

    Sub-second response times, even under peak load

    Global proxy network with automated management
  </Card>
</CardGroup>

***

## Scalability and Performance

Scale from simple search-and-extract workflows (thousands of leads simultaneously) to complex multi-step research operations (browser automation, session management, historical data access).

With 99.99% uptime and sub-second response times, you can focus on building your AI agents while we handle the web access complexity.

<CardGroup>
  <Card title="99.99% Uptime" icon="shield-check">
    Enterprise-grade reliability ensures your AI agents never miss critical data
  </Card>

  <Card title="Sub-Second Response Times" icon="bolt">
    Lightning-fast web access keeps your agents responsive and efficient
  </Card>

  <Card title="Concurrent Operations" icon="server">
    Handle thousands of simultaneous operations with enterprise-scale infrastructure
  </Card>
</CardGroup>

***

## AI Agent Specific Features

Built for AI agent patterns, including:

* **Automatic CAPTCHA solving** - Never get blocked by CAPTCHAs or bot detection
* **Enterprise-scale concurrent operations** - Handle production workloads with confidence
* **Integrated proxy management** - Automatic IP rotation and session management
* **Browser automation** - Complex interactions with JavaScript-heavy sites
* **Historical data access** - Access archived web content for comprehensive research
* **Real-time search results** - Get fresh search data for discovery workflows

***

## How to architect AI agents

<CardGroup>
  <Card title="Search and Extract" icon="magnifying-glass" href="/scraping-automation/serp-api/introduction">
    Use SERP API to discover and extract data from search results
  </Card>

  <Card title="Browser Automation" icon="browser" href="/scraping-automation/scraping-browser/introduction">
    Use Browser API for complex JavaScript-heavy interactions
  </Card>

  <Card title="CAPTCHA Solving" icon="unlock" href="/scraping-automation/web-unlocker/introduction">
    Use Web Unlocker to automatically bypass CAPTCHAs and blocks
  </Card>

  <Card title="Historical Data" icon="archive" href="/datasets/archive/overview">
    Access archived web content for comprehensive research
  </Card>
</CardGroup>

***

## Product Selection Guide

Choose the right products for your AI agent use case:

### Discovery and Search

* **SERP API** - Real-time search results for agent discovery
* **Web Archive** - Historical data access for comprehensive research

### How to extract data

* **Scrapers** - Structured data extraction from popular domains
* **Browser API** - Complex interactions with JavaScript-heavy sites

### Reliability and Scale

* **Web Unlocker** - Automatic CAPTCHA solving and block bypass
* **Residential Proxies** - Real user IPs for maximum reliability

***

## How to scale AI agents

<CardGroup>
  <Card title="Rate Limits" icon="clock" href="/general/usage-monitoring/fair_use_allowance">
    Understand rate limits and best practices for high-volume usage
  </Card>

  <Card title="Error Handling" icon="exclamation-triangle" href="/proxy-networks/errorCatalog">
    Implement robust error handling for production workloads
  </Card>

  <Card title="Session Management" icon="key" href="/proxy-networks/residential/configure-your-proxy">
    Manage sessions for maintaining state across requests
  </Card>

  <Card title="Monitoring" icon="chart-line" href="/general/usage-monitoring/Usage">
    Monitor usage and performance to optimize your workflows
  </Card>
</CardGroup>

***

## Examples

### Simple Search and Extract

Extract search results for competitive intelligence:

<CodeGroup>
  ```javascript Node.js theme={null}
  const response = await fetch('https://api.brightdata.com/datasets/v3/trigger?dataset_id=YOUR_DATASET_ID', {
    method: 'POST',
    headers: {
      'Authorization': `Bearer ${apiKey}`,
      'Content-Type': 'application/json'
    },
    body: JSON.stringify([{
      url: 'https://www.google.com/search',
      keyword: 'competitor analysis',
      country: 'US'
    }])
  });
  ```

  ```python Python theme={null}
  import requests

  response = requests.post(
    'https://api.brightdata.com/datasets/v3/trigger?dataset_id=YOUR_DATASET_ID',
    headers={
      'Authorization': f'Bearer {api_key}',
      'Content-Type': 'application/json'
    },
    json=[{
      'url': 'https://www.google.com/search',
      'keyword': 'competitor analysis',
      'country': 'US'
    }]
  )
  ```
</CodeGroup>

### How to automate browser interactions

Automate complex interactions with JavaScript-heavy sites:

<CodeGroup>
  ```javascript Node.js theme={null}
  const response = await fetch('https://api.brightdata.com/browser_api/v1/run', {
    method: 'POST',
    headers: {
      'Authorization': `Bearer ${apiKey}`,
      'Content-Type': 'application/json'
    },
    body: JSON.stringify({
      url: 'https://example.com',
      browser: {
        headless: false,
        viewport: { width: 1920, height: 1080 }
      },
      actions: [
        { type: 'click', selector: '#button' },
        { type: 'wait', timeout: 2000 },
        { type: 'extract', selector: '.content' }
      ]
    })
  });
  ```

  ```python Python theme={null}
  import requests

  response = requests.post(
    'https://api.brightdata.com/browser_api/v1/run',
    headers={
      'Authorization': f'Bearer {api_key}',
      'Content-Type': 'application/json'
    },
    json={
      'url': 'https://example.com',
      'browser': {
        'headless': False,
        'viewport': {'width': 1920, 'height': 1080}
      },
      'actions': [
        {'type': 'click', 'selector': '#button'},
        {'type': 'wait', 'timeout': 2000},
        {'type': 'extract', 'selector': '.content'}
      ]
    }
  )
  ```
</CodeGroup>

***

## Next Steps

<CardGroup>
  <Card title="SERP API Quickstart" icon="rocket" href="/search-api-quickstart">
    Start collecting search results for your AI agents
  </Card>

  <Card title="Browser API Quickstart" icon="rocket" href="/browser-api-quickstart">
    Automate browser interactions for complex workflows
  </Card>

  <Card title="Web Unlocker Quickstart" icon="rocket" href="/unlocker-api-quickstart">
    Bypass CAPTCHAs and blocks automatically
  </Card>

  <Card title="Browse Examples" icon="code" href="/scraping-automation/serp-api/get-top-100-google-results">
    Explore code examples and use cases
  </Card>
</CardGroup>

<Info>
  **Need help?** Check out our [API Reference](/api-reference/authentication) or [contact support](https://brightdata.com/contact).
</Info>


# Answer engine
Source: https://docs.brightdata.com/ai/answer-engine

Build AI answer engines that retrieve, verify and deliver cited responses in real time. Achieves 97% factual accuracy on production workloads.

<Card title="Building an AI startup?" href="https://brightdata.com/ai/ai-startups-program" icon="rocket-launch">
  You might be eligible for our Startup Program. Get fully funded access to the infrastructure you're reading about right now (up to \$20K value).
</Card>

## Answer Engine

Build AI systems that generate, verify, and deliver accurate answers instantly, whether serving customer queries, powering internal knowledge bases, or enhancing RAG pipelines.

<CardGroup>
  <Card title="How It Works" icon="lightbulb" href="#how-it-works">
    Understand the answer engine architecture
  </Card>

  <Card title="Get Started" icon="rocket" href="#example-enterprise-answer-engine">
    See an end-to-end example
  </Card>
</CardGroup>

***

## Why Standard Answer Engines Fall Short

<CardGroup>
  <Card title="Standard Answer Engines" icon="xmark">
    High latency under load (1-2s average per query)

    Limited fact validation and missing source citations

    Frequent rate-limit errors under high concurrency

    Manual proxy and data-source management required

    No automated unblocking or data freshness checks

    Poor compliance and auditability for enterprise use
  </Card>

  <Card title="Bright Data Powered Answer Engine" icon="check">
    97%+ factual accuracy with independent source validation

    Real-time retrieval from verified, live sources

    Millisecond latency for cached or pre-fetched responses

    50K+ concurrent requests with 99.99% uptime

    Automated unblocking, proxy rotation, and CAPTCHA solving

    SOC 2 Type 2 compliant with full audit logging
  </Card>
</CardGroup>

***

## How It Works

1. **Input Layer:** Accepts queries from API, chat interfaces, or system triggers.

2. **Orchestration Layer:** Manages async tasks, session context, and coordinates multi-agent workflows using frameworks like [CrewAI](/integrations/crew-ai), [LangChain](/integrations/langchain), [Agno](/integrations/agno), and [Vercel AI SDK](/integrations/vercel-ai-sdk).

3. **Discovery Layer:** Performs real-time web search using [SERP API](/scraping-automation/serp-api/introduction) and ranks results by relevance and authority.

4. **Extraction Layer:** Extracts structured and unstructured data from sources using [Web Unlocker](/scraping-automation/web-unlocker/introduction) and [Browser API](/scraping-automation/scraping-browser/introduction) for dynamic or interactive pages.

5. **Synthesis Layer:** Combines and validates data using LLM-based synthesis, running secondary retrieval to verify factual accuracy.

6. **Output Layer:** Delivers final responses with source citations via API or user interface.

***

## Best Practices

* Use [Browser API](/scraping-automation/scraping-browser/introduction) for dynamic site interactions (navigation, form filling, clicking). It integrates with Puppeteer, Playwright, and Selenium and supports unlimited concurrent sessions.
* Use [Web Unlocker](/scraping-automation/web-unlocker/introduction) for high-scale, non-interactive data extraction where browser automation is not needed. You are only billed for successful requests.
* Use [SERP API](/scraping-automation/serp-api/introduction) in async mode for large-scale search queries. It returns structured, parsed JSON for consistency.
* Enable **async mode** for high-throughput answer generation to maximize concurrency and minimize rate-limit errors.
* Integrate feedback loops to auto-correct and retrain on non-factual responses.
* Log every output for transparency and compliance audits.

***

## Example: Enterprise Answer Engine

A company uses this architecture for customer-facing AI support and internal RAG systems:

1. A user submits a complex question via chat interface.
2. The engine retrieves live documentation, cached knowledge base entries, and external references in parallel.
3. The LLM synthesizes an answer, verified through secondary retrieval.
4. A confidence score and source citations are appended automatically.
5. The response is streamed to the frontend or CRM dashboard.

***

## Next Steps

<CardGroup>
  <Card title="SERP API" icon="magnifying-glass" href="/scraping-automation/serp-api/introduction">
    Real-time search results for answer discovery
  </Card>

  <Card title="Web Unlocker" icon="unlock" href="/scraping-automation/web-unlocker/introduction">
    Bypass blocks and CAPTCHAs for live source retrieval
  </Card>

  <Card title="Browser API" icon="browser" href="/scraping-automation/scraping-browser/introduction">
    Automate interactions on dynamic sites
  </Card>

  <Card title="AI Integrations" icon="robot" href="/integrations/ai-integrations">
    Connect with LangChain, CrewAI, and other AI frameworks
  </Card>
</CardGroup>

<Info>
  **Need help?** Check out our [API Reference](/api-reference/authentication) or [contact support](https://brightdata.com/contact).
</Info>


# Data enrichment agent quickstart
Source: https://docs.brightdata.com/ai/cookbooks/data-enrichment

Build an AI data enrichment agent in 10 minutes using LangGraph and Bright Data. Automate research and structured extraction from public web sources end-to-end.

<Card title="Building an AI startup?" href="https://brightdata.com/ai/ai-startups-program" icon="rocket-launch">
  You might be eligible for our Startup Program. Get fully funded access to the infrastructure you're reading about right now (up to \$20K value).
</Card>

Build an AI agent that automatically researches and extracts structured data using [LangGraph](https://langchain-ai.github.io/langgraph/) and [Bright Data](https://brightdata.com/).

<Info>
  This cookbook gets you from zero to a working AI enrichment agent in under 10 minutes.
</Info>

## What You'll Build

An AI agent that:

1. Takes a research topic and a JSON schema as input (e.g., "B2B enterprise CTOs from New York", "Stripe payments company", "history of renewable energy technologies")
2. Searches the web using **Bright Data SERP API** (real search results, geo-targeting)
3. Scrapes websites using **Bright Data Web Unlocker** (bypasses anti-bot measures)
4. Uses an LLM to extract and structure the data
5. Validates and returns structured JSON matching your schema

## Prerequisites

* A [Bright Data account](https://brightdata.com/?hs_signup=1\&utm_source=docs) with API key from the [dashboard](https://brightdata.com/cp/api_tokens)
* An [Anthropic](https://console.anthropic.com/) or [OpenAI](https://platform.openai.com/signup) API key
* Python 3.10+

***

## Step 1: Install Dependencies

```bash theme={null}
pip install langgraph langchain-brightdata langchain-anthropic
```

***

## Step 2: Set Environment Variables

Get your API keys:

* [Bright Data API Key](/api-reference/authentication#how-do-i-generate-a-new-api-key) - Generate from your dashboard
* [Anthropic API Key](https://console.anthropic.com/settings/keys) - Get from Console

```bash theme={null}
export BRIGHT_DATA_API_KEY="your-bright-data-api-key"
export ANTHROPIC_API_KEY="your-anthropic-api-key"
```

***

## Step 3: Create the Enrichment Agent

Create a file called `enrichment_agent.py` and build it in three parts:

### 3.1: Imports and State Definition

Define the agent's state to track the research topic, schema, messages, and extracted info.

```python theme={null}
"""Simple data enrichment agent using LangGraph + Bright Data."""

import json
from dataclasses import dataclass, field
from typing import Any, Annotated, List, Optional

from langchain_anthropic import ChatAnthropic
from langchain_brightdata import BrightDataSERP, BrightDataUnlocker
from langchain_core.messages import AIMessage, HumanMessage, BaseMessage
from langchain_core.tools import tool
from langgraph.graph import StateGraph
from langgraph.graph.message import add_messages
from langgraph.prebuilt import ToolNode


# Agent state tracks topic, schema, conversation history, and final output
@dataclass
class AgentState:
    """State for the enrichment agent."""
    topic: str                                                              # Research topic
    extraction_schema: dict[str, Any]                                       # JSON schema for output
    messages: Annotated[List[BaseMessage], add_messages] = field(default_factory=list)  # Chat history
    info: Optional[dict[str, Any]] = None                                   # Extracted result
```

### 3.2: Tool Definitions

Configure Bright Data tools for web search and content scraping.

```python theme={null}
# --- Tools ---

# SERP tool: Searches Google and returns structured results
serp_tool = BrightDataSERP(
    search_engine="google",
    country="us",
    language="en",
    results_count=5,
    parse_results=True,
)

# Unlocker tool: Scrapes any URL, bypassing anti-bot protection
unlocker_tool = BrightDataUnlocker(
    data_format="markdown",
)


@tool
async def search(query: str) -> str:
    """Search the web for information about a topic."""
    results = await serp_tool.ainvoke(query)
    return json.dumps(results, indent=2)


@tool
async def scrape_website(url: str) -> str:
    """Scrape and extract content from a specific URL."""
    content = await unlocker_tool.ainvoke(url)
    return str(content)[:20000]  # Limit content to avoid token overflow


tools = [search, scrape_website]
```

### 3.3: Agent Graph and Execution

Build the LangGraph workflow that orchestrates search → scrape → extract.

```python theme={null}
# --- Agent ---

# System prompt instructs the LLM on its research task
SYSTEM_PROMPT = """You are a research agent. Your task is to gather information about a topic and extract structured data.

You have access to these tools:
- search: Search the web for information
- scrape_website: Get content from a specific URL
- submit_info: Call this when you have gathered all the required information

Research topic: {topic}

Required information schema:
{schema}

Search for relevant information, scrape important pages, then call submit_info with the extracted data."""


def create_agent():
    """Create the enrichment agent graph."""
    llm = ChatAnthropic(model="claude-sonnet-4-20250514")

    async def call_model(state: AgentState) -> dict:
        """Call the LLM to decide next action or submit results."""
        prompt = SYSTEM_PROMPT.format(
            topic=state.topic,
            schema=json.dumps(state.extraction_schema, indent=2)
        )
        messages = [HumanMessage(content=prompt)] + list(state.messages)

        # Dynamic tool for structured output submission
        info_tool = {
            "name": "submit_info",
            "description": "Submit the extracted information when done researching.",
            "parameters": state.extraction_schema,
        }

        model = llm.bind_tools(tools + [info_tool])
        response = await model.ainvoke(messages)

        # Check if agent is submitting final info
        info = None
        if hasattr(response, 'tool_calls') and response.tool_calls:
            for tc in response.tool_calls:
                if tc["name"] == "submit_info":
                    info = tc["args"]
                    break

        return {"messages": [response], "info": info}

    def route(state: AgentState) -> str:
        """Route: end if info submitted, else continue tool loop."""
        if state.info:
            return "__end__"
        if not state.messages:
            return "agent"

        last_msg = state.messages[-1]
        if isinstance(last_msg, AIMessage) and hasattr(last_msg, 'tool_calls') and last_msg.tool_calls:
            for tc in last_msg.tool_calls:
                if tc["name"] == "submit_info":
                    return "__end__"
            return "tools"
        return "agent"

    # Build the graph: agent ↔ tools loop until info is extracted
    graph = StateGraph(AgentState)
    graph.add_node("agent", call_model)
    graph.add_node("tools", ToolNode(tools))
    graph.add_edge("__start__", "agent")
    graph.add_conditional_edges("agent", route)
    graph.add_edge("tools", "agent")

    return graph.compile()


async def enrich(topic: str, schema: dict) -> dict:
    """Run the enrichment agent and return structured data."""
    agent = create_agent()
    result = await agent.ainvoke({
        "topic": topic,
        "extraction_schema": schema,
    })
    return result.get("info", {})


# --- Example Usage ---
if __name__ == "__main__":
    import asyncio

    schema = {
        "type": "object",
        "properties": {
            "company_name": {"type": "string"},
            "industry": {"type": "string"},
            "headquarters": {"type": "string"},
            "founded": {"type": "string"},
            "key_products": {"type": "array", "items": {"type": "string"}},
        },
        "required": ["company_name", "industry"]
    }

    result = asyncio.run(enrich("Stripe payments company", schema))
    print(json.dumps(result, indent=2))
```

***

## Step 4: Run the Agent

```bash theme={null}
python enrichment_agent.py
```

**Expected output:**

```json theme={null}
{
  "company_name": "Stripe",
  "industry": "Financial Technology / Payments",
  "headquarters": "San Francisco, California",
  "founded": "2010",
  "key_products": [
    "Stripe Payments",
    "Stripe Billing",
    "Stripe Connect",
    "Stripe Atlas"
  ]
}
```

***

## How It Works

1. **Agent** receives topic and schema, decides what to search
2. **Search** uses Bright Data SERP API for real search results
3. **Scrape** uses Bright Data Web Unlocker to get page content
4. **Agent** analyzes content and either continues researching or submits info
5. **Output** is structured JSON matching your schema

***

## How to customize the agent

### Different Extraction Schema

```python theme={null}
# Extract competitor information
competitor_schema = {
    "type": "object",
    "properties": {
        "competitors": {
            "type": "array",
            "items": {
                "type": "object",
                "properties": {
                    "name": {"type": "string"},
                    "market_position": {"type": "string"},
                    "key_differentiator": {"type": "string"}
                }
            }
        }
    }
}

result = await enrich("Stripe competitors in payment processing", competitor_schema)
```

### How to target by geography

```python theme={null}
serp_tool = BrightDataSERP(
    search_engine="google",
    country="de",      # Germany
    language="de",     # German
    results_count=10,
)
```

### Use OpenAI Instead of Anthropic

```python theme={null}
from langchain_openai import ChatOpenAI

# Replace the LLM initialization
llm = ChatOpenAI(model="gpt-4o")
```

***

## Next Steps

<CardGroup>
  <Card title="LinkedIn Scraping" icon="linkedin" href="/api-reference/scrapers/social-media-apis/linkedin-profiles-collect-by-url">
    Add LinkedIn profile enrichment
  </Card>

  <Card title="LangChain Integration" icon="link" href="/integrations/langchain">
    Full langchain-brightdata documentation
  </Card>
</CardGroup>

## Where to find the source code

<Card title="GitHub Repository" icon="github" href="https://github.com/brightdata/ai-data-enrichment-agent">
  Full source code and additional examples
</Card>

<Check>
  You now have an AI-powered data enrichment agent! Customize the schema to extract any structured data you need.
</Check>


# Sales intelligence with Haystack
Source: https://docs.brightdata.com/ai/cookbooks/haystack-sales-intelligence

Build an AI sales research assistant in 5 stages with Haystack, MongoDB Atlas and Bright Data. Pulls live data from LinkedIn, Crunchbase and news for RAG Q&A.

<Card title="Building an AI startup?" href="https://brightdata.com/ai/ai-startups-program" icon="rocket-launch">
  You might be eligible for our Startup Program. Get fully funded access to the infrastructure you're reading about right now (up to \$20K value).
</Card>

Build an AI-powered sales research assistant that extracts live data from LinkedIn, Crunchbase, and news sources, stores it in MongoDB Atlas for semantic search, and answers complex sales questions using [Haystack](https://haystack.deepset.ai/) and [Bright Data](https://brightdata.com/).

<Info>
  This cookbook walks you through building a complete lead intelligence pipeline - from scraping to RAG-powered Q\&A.
</Info>

## What You'll Build

An AI sales research assistant that:

1. **Finds companies** matching your Ideal Customer Profile (ICP) criteria
2. **Identifies decision makers** and researches their backgrounds
3. **Extracts pain points** from job postings, news articles, and company data
4. **Generates personalized outreach** angles based on comprehensive company intelligence

**The Tech Stack:**

* **Bright Data**: Web scraping for 45+ data sources (LinkedIn, Crunchbase, news, job boards)
* **MongoDB Atlas**: Vector database for semantic search + structured metadata filtering
* **Haystack**: Open-source LLM framework for building RAG pipelines
* **Google Gemini 2.5**: Generate actionable sales intelligence from raw data

## How the architecture works

<img alt="Haystack Sales Intelligence Architecture" />

### How each component fits in

**1. Bright Data Layer** (Data Collection)

* **Scrapers**: Extracts structured data from 45+ sources
  * `linkedin_company_profile`: Company size, industry, description, location
  * `linkedin_person_profile`: Decision maker titles, backgrounds, experience
  * `crunchbase_company`: Funding rounds, investors, employee count
* **SERP API**: Real-time search results from Google/Bing
  * Company news and press releases
  * Job postings (signal for pain points)
  * Industry trends and mentions

**2. MongoDB Atlas** (Storage & Retrieval)

* **Vector Search**: Semantic similarity matching on embedded company/person descriptions
* **Metadata Filtering**: Hybrid search combining vectors with structured filters (industry, funding stage, location, company size, job titles)
* **Document Storage**: Stores raw scraped data + embeddings + metadata

**3. Haystack Pipeline** (Orchestration)

* **Embedder**: Converts queries and documents to vector representations using Google's text-embedding-004
* **Retriever**: Finds most relevant leads from MongoDB based on semantic + metadata match
* **Prompt Builder**: Constructs context-rich prompts with retrieved lead data
* **LLM Generator**: Gemini 2.5 Flash synthesizes insights and generates actionable intelligence

## Prerequisites

* A [Bright Data account](https://brightdata.com/?hs_signup=1\&utm_source=docs) with API key from the [dashboard](https://brightdata.com/cp/setting/users)
* A [MongoDB Atlas cluster](https://www.mongodb.com/docs/atlas/getting-started/) (M0 free tier is sufficient for testing)
* A [Google API Key](https://aistudio.google.com/) for Gemini access
* Python 3.10+

***

## Step 1: Install Dependencies

```bash theme={null}
pip install haystack-ai haystack-brightdata mongodb-atlas-haystack google-genai-haystack dotenv
```

***

## Step 2: Set Environment Variables

Get your API keys:

* [Bright Data API Key](/api-reference/authentication#how-do-i-generate-a-new-api-key) - Generate from your dashboard
* [MongoDB Connection String](https://www.mongodb.com/docs/atlas/getting-started/) - From your Atlas cluster
* [Google API Key](https://aistudio.google.com/) - For Gemini access

```python theme={null}
import os
from dotenv import load_dotenv

load_dotenv(override=True)

if not os.environ.get("GOOGLE_API_KEY") and os.environ.get("GOOGLE_AI_API_KEY"):
    os.environ["GOOGLE_API_KEY"] = os.environ["GOOGLE_AI_API_KEY"]

# Verify all required keys are loaded
required_keys = ["BRIGHT_DATA_API_KEY", "MONGO_CONNECTION_STRING", "GOOGLE_API_KEY"]
missing_keys = [key for key in required_keys if not os.environ.get(key)]

if missing_keys:
    raise ValueError(f"Please add {', '.join(missing_keys)} to your .env file")
else:
    print("All environment variables loaded successfully")
```

### Bright Data Datasets Reference

* [Crunchbase Company](https://brightdata.com/products/datasets/crunchbase)
* [LinkedIn Company Profile](https://brightdata.com/products/datasets/linkedin/company)
* [LinkedIn Person Profile](https://brightdata.com/products/datasets/linkedin/profiles)
* [Google SERP API](https://brightdata.com/products/serp-api/google-search)

***

## Step 3: Initialize Components

### List Available Datasets

```python theme={null}
from haystack_brightdata import BrightDataWebScraper

datasets = BrightDataWebScraper.get_supported_datasets()

print(f"Total available datasets: {len(datasets)}\n")
print("Sales research relevant datasets:")
print("-" * 50)

relevant_keywords = ["linkedin", "crunchbase", "company", "profile"]
for dataset in datasets:
    if any(keyword in dataset['id'].lower() for keyword in relevant_keywords):
        print(f"  {dataset['id']}")
        print(f"    {dataset['description']}\n")
```

### MongoDB Atlas Setup

MongoDB Atlas serves as the vector database for storing embedded lead data and enabling semantic search.

**1. Create a MongoDB Atlas Cluster**

Follow the [Get Started with Atlas](https://www.mongodb.com/docs/atlas/getting-started/) guide to:

* Create a free cluster (M0 tier is sufficient for testing)
* Set up database access credentials
* Configure network access (allow your IP or use 0.0.0.0/0 for testing)
* Get your connection string

**2. Create Vector Search Index**

1. Go to your cluster in the Atlas UI

2. Click the **"Search"** tab → "Create Search Index"

3. Select "Atlas Vector Search" → "JSON Editor"

4. Configure:
   * Index name: `lead_vector_index`
   * Database: `sales_intelligence`
   * Collection: `leads`

5. Paste this configuration:

```json theme={null}
{
  "fields": [
    {
      "type": "vector",
      "path": "embedding",
      "numDimensions": 768,
      "similarity": "cosine"
    }
  ]
}
```

6. Wait for the index status to change from "Building" to "Active"

### Initialize the Document Store

```python theme={null}
from haystack_integrations.document_stores.mongodb_atlas import MongoDBAtlasDocumentStore

# Initialize MongoDB Atlas Document Store
# Note: It automatically reads from MONGO_CONNECTION_STRING environment variable
document_store = MongoDBAtlasDocumentStore(
    database_name="sales_intelligence",
    collection_name="leads",
    vector_search_index="lead_vector_index",
    full_text_search_index="lead_fulltext_index"
)

print("MongoDB Atlas DocumentStore initialized")
print(f"  Database: sales_intelligence")
print(f"  Collection: leads")
print(f"  Vector Search Index: lead_vector_index")
```

### Initialize the Retriever and Scraper

```python theme={null}
from haystack_integrations.components.retrievers.mongodb_atlas import MongoDBAtlasEmbeddingRetriever

retriever = MongoDBAtlasEmbeddingRetriever(document_store=document_store)
```

```python theme={null}
from haystack_brightdata import BrightDataWebScraper

# Initialize the Web Scraper
# Note: Automatically uses BRIGHT_DATA_API_KEY from environment
scraper = BrightDataWebScraper()
```

***

## Step 4: Scrape Data from Multiple Sources

### Example 1: Scraping Crunchbase Company Data

Extract company intelligence from Crunchbase - funding information, investors, employee count, and more.

```python theme={null}
import json

company_url = "https://www.crunchbase.com/organization/openai"

def coalesce(data, *keys, default="N/A"):
    for key in keys:
        value = data.get(key)
        if value not in (None, "", [], {}):
            return value
    return default

def format_industries(industries):
    if not industries:
        return "N/A"
    if isinstance(industries, list):
        values = []
        for item in industries:
            if isinstance(item, dict):
                value = item.get("value") or item.get("name") or item.get("id")
                if value:
                    values.append(value)
            else:
                values.append(str(item))
        return ", ".join(values) if values else "N/A"
    return industries

def parse_company(result):
    raw = result.get("data", result)
    if isinstance(raw, str):
        raw = json.loads(raw)
    if isinstance(raw, list):
        return raw[0] if raw else {}
    if isinstance(raw, dict):
        return raw
    return {}

result = scraper.run(
    dataset="crunchbase_company",
    url=company_url
)

company_data = parse_company(result)
industries = format_industries(company_data.get("industries"))

print(f"Company: {coalesce(company_data, 'name', 'legal_name')}")
print(f"Overview: {coalesce(company_data, 'about', 'company_overview')}")
print(f"Industries: {industries}")
print(f"Operating Status: {coalesce(company_data, 'operating_status')}")
print(f"Website: {coalesce(company_data, 'website', 'url')}")
print(f"Employees: {coalesce(company_data, 'num_employees', 'number_of_employee_profiles')}")
```

**Expected output:**

```text theme={null}
Company: OpenAI
Overview: OpenAI is an AI research and deployment company that develops advanced AI models, including ChatGPT.
Industries: Agentic AI, Artificial Intelligence (AI), Generative AI, Machine Learning, SaaS
Operating Status: active
Website: https://www.openai.com
Employees: 1001-5000
```

### Example 2: Scraping LinkedIn Company Data

Extract broader company information from LinkedIn.

```python theme={null}
import json

linkedin_url = "https://www.linkedin.com/company/openai/"

result = scraper.run(
    dataset="linkedin_company_profile",
    url=linkedin_url
)

if isinstance(result["data"], str):
    company_data = json.loads(result["data"])
else:
    company_data = result["data"]

if isinstance(company_data, list):
    company_data = company_data[0] if company_data else {}

print(f"Company: {company_data.get('name', 'N/A')}")
print(f"Description: {company_data.get('description', 'N/A')[:200]}...")
print(f"Industry: {company_data.get('industry', 'N/A')}")
print(f"Company Size: {company_data.get('company_size', 'N/A')}")
print(f"Headquarters: {company_data.get('headquarters', 'N/A')}")
print(f"Website: {company_data.get('website', 'N/A')}")
```

### Example 3: Scraping LinkedIn Person Profile

Extract decision maker profiles from LinkedIn - key contacts, their backgrounds, and experience.

```python theme={null}
import json

person_url = "https://www.linkedin.com/in/satyanadella/"

result = scraper.run(
    dataset="linkedin_person_profile",
    url=person_url
)

if isinstance(result["data"], str):
    person_data = json.loads(result["data"])
else:
    person_data = result["data"]

if isinstance(person_data, list):
    person_data = person_data[0] if person_data else {}

print(f"Name: {person_data.get('name', 'N/A')}")
print(f"Position: {person_data.get('position', 'N/A')}")
print(f"Location: {person_data.get('city', 'N/A')}, {person_data.get('country_code', 'N/A')}")

current_company = person_data.get('current_company', {})
if current_company:
    print(f"Current Company: {current_company.get('name', 'N/A')}")

print(f"Followers: {person_data.get('followers', 'N/A')}")
print(f"Connections: {person_data.get('connections', 'N/A')}")

about = person_data.get('about')
if about:
    print(f"\nAbout: {about[:200]}...")

experience = person_data.get('experience', [])
if experience:
    print(f"\nExperience ({len(experience)} roles):")
    for i, exp in enumerate(experience[:3]):
        company = exp.get('company', 'N/A')
        title = exp.get('title', 'N/A')
        duration = exp.get('duration', 'N/A')
        print(f"  {i+1}. {title} at {company} ({duration})")
```

**Expected output:**

```text theme={null}
Name: Satya Nadella
Position: Chairman and CEO at Microsoft
Location: Redmond, Washington, United States, US
Current Company: Microsoft
Followers: 11816477
Connections: 500

Experience (5 roles):
  1. Chairman and CEO at Microsoft (N/A)
  2. Member Board Of Trustees at University of Chicago (N/A)
  3. Board Member at Starbucks (N/A)
```

***

## Step 5: SERP API for Market Signals

Bright Data's SERP API lets you gather market signals through search results - hiring signals, news, and pain points.

### Example SERP Queries for Sales Research

```python theme={null}
# Hiring signals
query = 'site:linkedin.com/jobs "Company Name" engineering'

# Funding news
query = '"Company Name" funding Series A announcement'

# Recent news
query = '"Company Name" news (2024 OR 2025)'
```

### Search for Company News

```python theme={null}
import json
from haystack_brightdata import BrightDataSERP

serp = BrightDataSERP()

company_name = "OpenAI"
search_query = f'"{company_name}" news funding OR announcement OR launch 2025 OR 2026'

result = serp.run(
    query=search_query,
    num_results=10
)

if isinstance(result["results"], str):
    serp_data = json.loads(result["results"])
else:
    serp_data = result["results"]

organic_results = serp_data.get("organic", [])
if not organic_results and "results" in serp_data:
    organic_results = serp_data.get("results", [])

print(f"Found {len(organic_results)} results\n")

for i, item in enumerate(organic_results[:5], 1):
    title = item.get("title", "N/A")
    link = item.get("link", item.get("url", "N/A"))
    snippet = item.get("snippet", item.get("description", "N/A"))

    print(f"{i}. {title}")
    print(f"   URL: {link}")
    print(f"   Snippet: {snippet[:150]}...")
    print()
```

***

## Step 6: Data Processing & Indexing Pipeline

Process and index scraped data into MongoDB Atlas for semantic search.

```text theme={null}
Raw Scraped Data → Document Creation → Embedding Generation → MongoDB Storage
     (JSON)            (Haystack)         (Gemini 768d)         (Vector DB)
```

### Helper Functions: Transform Scraped Data into Haystack Documents

```python theme={null}
import json
from datetime import datetime
from haystack import Document

def create_company_documents(scraper_result, source_url, dataset_type):
    """
    Transform company data from Crunchbase or LinkedIn into Haystack Documents.
    """
    if isinstance(scraper_result["data"], str):
        data = json.loads(scraper_result["data"])
    else:
        data = scraper_result["data"]

    if not isinstance(data, list):
        data = [data]

    documents = []
    scraped_date = datetime.now().strftime("%Y-%m-%d")

    for item in data:
        if dataset_type == "crunchbase_company":
            content = f"""Company: {item.get('name', 'N/A')}
Overview: {item.get('about', 'N/A')}
Industries: {item.get('industries', 'N/A')}
Operating Status: {item.get('operating_status', 'N/A')}
Location: {item.get('headquarters', 'N/A')}
Founded: {item.get('founded_year') or item.get('founded_date', 'N/A')}
Employees: {item.get('num_employees', 'N/A')}
Website: {item.get('website', 'N/A')}"""

        elif dataset_type == "linkedin_company_profile":
            content = f"""Company: {item.get('name', 'N/A')}
About: {item.get('about') or item.get('description', 'N/A')}
Industries: {item.get('industries', 'N/A')}
Company Size: {item.get('company_size', 'N/A')}
Headquarters: {item.get('headquarters', 'N/A')}
Founded: {item.get('founded', 'N/A')}
Website: {item.get('website', 'N/A')}
Followers: {item.get('followers', 'N/A')}
Employees on LinkedIn: {item.get('employees_in_linkedin', 'N/A')}"""

        else:
            content = f"Company: {item.get('name', 'N/A')}"

        industries = item.get('industries', item.get('industry', ''))
        if isinstance(industries, list):
            industries = ', '.join([
                ind.get('value', ind) if isinstance(ind, dict) else str(ind)
                for ind in industries
            ])

        documents.append(Document(
            content=content,
            meta={
                "source_url": source_url,
                "dataset_type": dataset_type,
                "company_name": item.get('name', ''),
                "industry": industries,
                "location": item.get('headquarters') or item.get('location', ''),
                "scraped_date": scraped_date
            }
        ))

    return documents
```

```python theme={null}
def create_person_documents(scraper_result, source_url):
    """
    Transform LinkedIn person profile data into Haystack Documents.
    """
    if isinstance(scraper_result["data"], str):
        data = json.loads(scraper_result["data"])
    else:
        data = scraper_result["data"]

    if not isinstance(data, list):
        data = [data]

    documents = []
    scraped_date = datetime.now().strftime("%Y-%m-%d")

    for person in data:
        experience = person.get('experience', [])
        experience_summary = []
        for exp in experience[:3]:
            company = exp.get('company', 'N/A')
            title = exp.get('title', 'N/A')
            duration = exp.get('duration', 'N/A')
            experience_summary.append(f"{title} at {company} ({duration})")
        experience_text = '\n'.join(experience_summary) if experience_summary else 'N/A'

        education = person.get('education', [])
        education_summary = []
        for edu in education[:2]:
            title = edu.get('title', 'N/A')
            years = f"{edu.get('start_year', '')}-{edu.get('end_year', '')}"
            education_summary.append(f"{title} ({years})")
        education_text = '\n'.join(education_summary) if education_summary else 'N/A'

        current_company = person.get('current_company', {})
        current_company_name = current_company.get('name', 'N/A') if current_company else 'N/A'

        content = f"""Name: {person.get('name', 'N/A')}
Position: {person.get('position', 'N/A')}
Current Company: {current_company_name}
Location: {person.get('city', 'N/A')}, {person.get('country_code', 'N/A')}
About: {person.get('about', 'N/A')}
Followers: {person.get('followers', 'N/A')}
Connections: {person.get('connections', 'N/A')}

Recent Experience:
{experience_text}

Education:
{education_text}"""

        documents.append(Document(
            content=content,
            meta={
                "source_url": source_url,
                "dataset_type": "linkedin_person_profile",
                "person_name": person.get('name', ''),
                "person_title": person.get('position', ''),
                "company": current_company_name,
                "location": f"{person.get('city', '')}, {person.get('country_code', '')}",
                "scraped_date": scraped_date
            }
        ))

    return documents
```

### Build the Indexing Pipeline

Create a Haystack pipeline that automatically generates embeddings and writes to MongoDB Atlas.

```python theme={null}
from haystack import Pipeline
from haystack.components.writers import DocumentWriter
from haystack_integrations.components.embedders.google_genai import GoogleGenAIDocumentEmbedder

indexing_pipeline = Pipeline()

indexing_pipeline.add_component("embedder", GoogleGenAIDocumentEmbedder(model="text-embedding-004"))
indexing_pipeline.add_component("writer", DocumentWriter(document_store=document_store))

indexing_pipeline.connect("embedder.documents", "writer.documents")

print("Indexing pipeline created")
print("  Documents → Embedder (Gemini text-embedding-004) → Writer (MongoDB)")
```

### Index Sample Companies

Test the complete indexing flow by scraping a company and indexing it into MongoDB Atlas.

```python theme={null}
from pymongo import MongoClient

client = MongoClient(os.environ.get("MONGO_CONNECTION_STRING"))
db = client[document_store.database_name]

if document_store.collection_name not in db.list_collection_names():
    db.create_collection(document_store.collection_name)
    print(f"Created collection '{document_store.collection_name}'")
else:
    print(f"Collection '{document_store.collection_name}' already exists")

collection = db[document_store.collection_name]
doc_count = collection.count_documents({})
print(f"  Current document count: {doc_count}")
```

```python theme={null}
# Scrape and index a company from Crunchbase
company_url = "https://www.crunchbase.com/organization/openai"

# Step 1: Scrape the company
scraper_result = scraper.run(
    dataset="crunchbase_company",
    url=company_url
)

# Step 2: Transform into Haystack Documents
documents = create_company_documents(
    scraper_result=scraper_result,
    source_url=company_url,
    dataset_type="crunchbase_company"
)

print(f"Created {len(documents)} document(s)")
print(f"Content (first 200 chars): {documents[0].content[:200]}...")
print(f"Metadata: {documents[0].meta}")

# Step 3: Generate embeddings and index into MongoDB
result = indexing_pipeline.run({"embedder": {"documents": documents}})

print(f"Indexed {result['writer']['documents_written']} document(s) into MongoDB")
```

***

## Step 7: RAG Pipeline for Sales Intelligence

RAG combines **retrieval** (finding relevant documents) with **generation** (LLM synthesis) to answer questions based on your indexed data.

```text theme={null}
User Question → Text Embedder → Retriever → Prompt Builder → Generator → Answer
```

### Which components to use

* [GoogleGenAITextEmbedder](https://docs.haystack.deepset.ai/docs/googlegenaitextembedder)
* [MongoDBAtlasEmbeddingRetriever](https://docs.haystack.deepset.ai/docs/mongodbatlasembeddingretriever)
* [ChatPromptBuilder](https://docs.haystack.deepset.ai/docs/chatpromptbuilder)
* [GoogleGenAIChatGenerator](https://docs.haystack.deepset.ai/docs/googlegenaichatgenerator)

### Build the RAG Pipeline

```python theme={null}
from haystack import Pipeline
from haystack.components.builders import ChatPromptBuilder
from haystack.dataclasses import ChatMessage
from haystack_integrations.components.embedders.google_genai import GoogleGenAITextEmbedder
from haystack_integrations.components.generators.google_genai import GoogleGenAIChatGenerator

system_message = ChatMessage.from_system("""
You are a sales intelligence assistant. Your role is to analyze company and people data to provide actionable sales intelligence.

When answering queries:
- Cite specific company names and details from the data
- Provide insights relevant for sales outreach
- Highlight key information like funding, company size, location, recent news
- Suggest talking points for personalized outreach
""")

user_template = """
Based on the following company/person data, answer the user's question.

Context:
{% for document in documents %}
{{ document.content }}
---
{% endfor %}

Question: {{ question }}

Provide a detailed, actionable answer based on the retrieved data.
"""

user_message = ChatMessage.from_user(user_template)

rag_pipeline = Pipeline()

rag_pipeline.add_component("text_embedder", GoogleGenAITextEmbedder(model="text-embedding-004"))
rag_pipeline.add_component("retriever", MongoDBAtlasEmbeddingRetriever(document_store=document_store, top_k=5))
rag_pipeline.add_component("prompt_builder", ChatPromptBuilder(template=[system_message, user_message]))
rag_pipeline.add_component("generator", GoogleGenAIChatGenerator(model="gemini-2.5-flash"))

rag_pipeline.connect("text_embedder.embedding", "retriever.query_embedding")
rag_pipeline.connect("retriever.documents", "prompt_builder.documents")
rag_pipeline.connect("prompt_builder.prompt", "generator.messages")

print("RAG pipeline created")
print("  Question → Text Embedder → Retriever → Prompt Builder → Generator → Answer")
```

***

## Step 8: Query the Sales Research Assistant

```python theme={null}
question = "What can you tell me about OpenAI? Include details about their industry, products, and any relevant information for sales outreach."

result = rag_pipeline.run(
    data={
        "text_embedder": {"text": question},
        "prompt_builder": {"question": question}
    },
    include_outputs_from={"retriever"}
)

answer = result["generator"]["replies"][0].text
print(answer)

# Show retrieved documents
if "retriever" in result:
    retrieved_docs = result["retriever"]["documents"]
    print(f"\nRetrieved {len(retrieved_docs)} relevant documents from MongoDB")

    for i, doc in enumerate(retrieved_docs, 1):
        print(f"\nDocument {i}:")
        print(f"  Company: {doc.meta.get('company_name', 'N/A')}")
        print(f"  Source: {doc.meta.get('dataset_type', 'N/A')}")
        print(f"  Location: {doc.meta.get('location', 'N/A')}")
        print(f"  Industry: {doc.meta.get('industry', 'N/A')}")
        print(f"  Content: {doc.content[:300]}...")
```

***

## Data Model Design

The lead intelligence database uses a flexible schema that accommodates data from multiple sources while enabling powerful hybrid search capabilities.

This structure enables three search modes:

1. **Semantic Search**: Find similar companies/people based on meaning
   * Query: "AI startups focused on enterprise automation"
   * Matches: Companies with similar descriptions, even if wording differs

2. **Metadata Filtering**: Exact match on structured fields
   * Filter: `funding_stage = "Series A" AND location = "New York, NY"`
   * Returns: Only companies meeting exact criteria

3. **Hybrid Search**: Combine both approaches
   * Semantic query: "Companies building developer tools"
   * * Filters: `funding_stage = "Series A"` AND `location = "San Francisco, CA"`
   * Result: Semantically relevant companies that also match exact criteria

### Example Documents

Each document has three components: `content` (human-readable text for LLM context), `embedding` (768-dim vector from text-embedding-004 for semantic search), and `meta` (structured fields for filtering).

**Company Document (Crunchbase):**

```python theme={null}
{
  "content": "Company: Acme AI\nIndustry: Artificial Intelligence\nFunding: $15M Series A...",
  "embedding": [0.123, -0.456, ...],  # 768 dimensions
  "meta": {
    "source_url": "https://www.crunchbase.com/organization/acme-ai",
    "dataset_type": "crunchbase_company",
    "company_name": "Acme AI",
    "industry": "AI/ML",
    "funding_stage": "Series A",
    "location": "San Francisco, CA",
    "scraped_date": "2026-01-19"
  }
}
```

**Person Document (LinkedIn):**

```python theme={null}
{
  "content": "Name: Jane Smith\nTitle: VP of Engineering\nCompany: Acme AI\nExperience: 10+ years...",
  "embedding": [0.234, -0.567, ...],  # 768 dimensions
  "meta": {
    "source_url": "https://www.linkedin.com/in/janesmith",
    "dataset_type": "linkedin_person",
    "person_name": "Jane Smith",
    "person_title": "VP of Engineering",
    "company": "Acme AI",
    "location": "San Francisco, CA",
    "scraped_date": "2026-01-19"
  }
}
```

**News Signal Document (SERP):**

```python theme={null}
{
  "content": "News: Acme AI raises $15M Series A\nSource: TechCrunch\nSnippet: AI startup...",
  "embedding": [0.345, -0.678, ...],  # 768 dimensions
  "meta": {
    "source_url": "https://techcrunch.com/...",
    "dataset_type": "news",
    "company_name": "Acme AI",
    "scraped_date": "2026-01-19"
  }
}
```

***

## Next Steps

<CardGroup>
  <Card title="LinkedIn Scraping" icon="linkedin" href="/api-reference/scrapers/social-media-apis/linkedin-profiles-collect-by-url">
    Add LinkedIn profile enrichment
  </Card>

  <Card title="Haystack Integration" icon="link" href="/integrations/haystack">
    Full haystack-brightdata documentation
  </Card>

  <Card title="SERP API" icon="magnifying-glass" href="/api-reference/rest-api/serp/serp-api">
    Explore the full SERP API reference
  </Card>

  <Card title="Scrapers" icon="globe" href="/api-reference/scrapers">
    Browse all 45+ supported datasets
  </Card>
</CardGroup>

<Check>
  You now have an AI-powered sales research assistant! Customize the pipeline to scrape additional data sources, add more metadata filters, or adjust the RAG prompts for your specific sales workflow.
</Check>


# Deep research
Source: https://docs.brightdata.com/ai/deep-research

Build AI research agents with Bright Data (1000+ scrapers): real-time SERP, historical data and multi-step site navigation for competitive intelligence.

<Card title="Building an AI startup?" href="https://brightdata.com/ai/ai-startups-program" icon="rocket-launch">
  You might be eligible for our Startup Program. Get fully funded access to the infrastructure you're reading about right now (up to \$20K value).
</Card>

## Deep Research Agents

Build AI agents that conduct comprehensive, multi-source research operations at scale.

Go beyond simple data extraction to create research workflows that combine real-time search, historical analysis, and complex site navigation. These capabilities form the foundation for competitive intelligence, market research, and investigative analysis systems.

<CardGroup>
  <Card title="Learn Research Patterns" icon="lightbulb" href="#multi-source-research-patterns">
    Understand multi-source research workflows
  </Card>

  <Card title="Get Started" icon="rocket" href="#examples">
    Explore research examples
  </Card>
</CardGroup>

***

## Why Basic Research Tools Fall Short

<CardGroup>
  <Card title="Basic Research Tools" icon="xmark">
    Surface-level data collection only, missing deep insights

    No access to historical or archived web data

    Blocked on complex interactive sites and login flows

    Limited concurrent source processing

    High failure rates on protected or dynamic sources
  </Card>

  <Card title="Bright Data Research Stack" icon="check">
    Deep, multi-source analysis combining real-time and historical data

    2PB+ historical archive for context-rich research

    Browser automation and unblocking for complex, dynamic sites

    20K+ concurrent extractions with 99.99% uptime

    Global proxy network ensuring access to any source, anywhere
  </Card>
</CardGroup>

***

## Research Challenges Handled

Handle research challenges that typically stop basic scraping:

* **Multi-step workflows** - Require session persistence across multiple requests
* **Complex site interactions** - Demand browser automation for JavaScript-heavy sites
* **Historical context** - Need archive access for comprehensive research
* **Research depth** - Require cross-source validation for accuracy

The infrastructure provides a full toolkit for comprehensive research operations.

<CardGroup>
  <Card title="Session Management" icon="key" href="/proxy-networks/residential/configure-your-proxy">
    Maintain session persistence across multi-step workflows
  </Card>

  <Card title="Browser Automation" icon="browser" href="/scraping-automation/scraping-browser/introduction">
    Handle complex site interactions with browser automation
  </Card>

  <Card title="Historical Data" icon="archive" href="/datasets/archive/overview">
    Access historical context through web archive
  </Card>

  <Card title="Cross-Source Validation" icon="check-circle" href="/datasets/deep-lookup/overview">
    Validate research across multiple sources
  </Card>
</CardGroup>

***

## Application and Purpose

From startup competitive analysis to enterprise market intelligence, research agents require infrastructure that can:

* Navigate complex workflows
* Maintain context across multiple sources
* Provide both current and historical perspectives

Built for research patterns that require both breadth and depth.

***

## Multi-Source Research Patterns

Combine multiple data sources for comprehensive research:

<CardGroup>
  <Card title="Real-Time Search" icon="magnifying-glass" href="/scraping-automation/serp-api/introduction">
    Use SERP API for real-time search results across multiple search engines
  </Card>

  <Card title="Historical Analysis" icon="archive" href="/datasets/archive/overview">
    Access historical data through web archive for trend analysis
  </Card>

  <Card title="Site-Specific Data" icon="globe" href="/scraping-automation/scraping-browser/introduction">
    Extract data from specific sites using browser automation
  </Card>

  <Card title="Cross-Reference Validation" icon="check-circle" href="/datasets/deep-lookup/overview">
    Validate findings across multiple sources for accuracy
  </Card>
</CardGroup>

***

## Historical Context with Web Archive

Access historical data for comprehensive research:

<CodeGroup>
  ```javascript Node.js theme={null}
  // Search historical data
  const response = await fetch('https://api.brightdata.com/datasets/v3/trigger?dataset_id=YOUR_ARCHIVE_DATASET_ID', {
    method: 'POST',
    headers: {
      'Authorization': `Bearer ${apiKey}`,
      'Content-Type': 'application/json'
    },
    body: JSON.stringify([{
      url: 'https://example.com',
      date: '2023-01-01',
      archive_type: 'web_archive'
    }])
  });
  ```

  ```python Python theme={null}
  import requests

  # Search historical data
  response = requests.post(
    'https://api.brightdata.com/datasets/v3/trigger?dataset_id=YOUR_ARCHIVE_DATASET_ID',
    headers={
      'Authorization': f'Bearer {api_key}',
      'Content-Type': 'application/json'
    },
    json=[{
      'url': 'https://example.com',
      'date': '2023-01-01',
      'archive_type': 'web_archive'
    }]
  )
  ```
</CodeGroup>

***

## Complex Site Navigation

Navigate complex sites with browser automation:

<CodeGroup>
  ```javascript Node.js theme={null}
  // Multi-step research workflow
  const response = await fetch('https://api.brightdata.com/browser_api/v1/run', {
    method: 'POST',
    headers: {
      'Authorization': `Bearer ${apiKey}`,
      'Content-Type': 'application/json'
    },
    body: JSON.stringify({
      url: 'https://example.com/research',
      browser: {
        headless: true,
        viewport: { width: 1920, height: 1080 }
      },
      actions: [
        { type: 'navigate', url: 'https://example.com/search' },
        { type: 'fill', selector: '#search', value: 'research topic' },
        { type: 'click', selector: '#submit' },
        { type: 'wait', timeout: 3000 },
        { type: 'extract', selector: '.results' },
        { type: 'navigate', url: 'https://example.com/details' },
        { type: 'extract', selector: '.content' }
      ]
    })
  });
  ```

  ```python Python theme={null}
  import requests

  # Multi-step research workflow
  response = requests.post(
    'https://api.brightdata.com/browser_api/v1/run',
    headers={
      'Authorization': f'Bearer {api_key}',
      'Content-Type': 'application/json'
    },
    json={
      'url': 'https://example.com/research',
      'browser': {
        'headless': True,
        'viewport': {'width': 1920, 'height': 1080}
      },
      'actions': [
        {'type': 'navigate', 'url': 'https://example.com/search'},
        {'type': 'fill', 'selector': '#search', 'value': 'research topic'},
        {'type': 'click', 'selector': '#submit'},
        {'type': 'wait', 'timeout': 3000},
        {'type': 'extract', 'selector': '.results'},
        {'type': 'navigate', 'url': 'https://example.com/details'},
        {'type': 'extract', 'selector': '.content'}
      ]
    }
  )
  ```
</CodeGroup>

***

## Research Workflow Orchestration

Orchestrate complex research workflows:

<Steps>
  <Step title="Define Research Query">
    Define your research query and objectives. Identify the questions you need to answer.

    ```json theme={null}
    {
      "query": "Market analysis for AI tools",
      "objectives": [
        "Identify key competitors",
        "Analyze pricing strategies",
        "Review customer feedback"
      ]
    }
    ```
  </Step>

  <Step title="Search Multiple Sources">
    Search across multiple sources simultaneously:

    * Real-time search results (SERP API)
    * Historical data (Web Archive)
    * Site-specific data (Browser API)

    <CodeGroup>
      ```javascript Node.js theme={null}
      const searchPromises = [
        searchSERP(query),
        searchArchive(query),
        searchSite(query)
      ];
      const results = await Promise.all(searchPromises);
      ```

      ```python Python theme={null}
      import asyncio

      search_tasks = [
        search_serp(query),
        search_archive(query),
        search_site(query)
      ]
      results = await asyncio.gather(*search_tasks)
      ```
    </CodeGroup>
  </Step>

  <Step title="Extract and Structure">
    Extract relevant data from each source and structure it for analysis.

    <Tip>
      Use data validation to ensure data quality and consistency across sources.
    </Tip>
  </Step>

  <Step title="Cross-Reference and Validate">
    Cross-reference findings across multiple sources and validate for accuracy.

    <Check>
      Validated research findings are ready for analysis and reporting.
    </Check>
  </Step>

  <Step title="Generate Research Report">
    Compile findings into a comprehensive research report.

    <Info>
      Include source attribution and validation status for transparency.
    </Info>
  </Step>
</Steps>

***

## Cross-Source Data Validation

Validate research findings across multiple sources:

<CodeGroup>
  ```javascript Node.js theme={null}
  async function validateResearch(findings, sources) {
    const validationResults = await Promise.all(
      findings.map(finding => 
        validateAgainstSources(finding, sources)
      )
    );
    
    return validationResults.filter(result => result.confidence > 0.8);
  }

  async function validateAgainstSources(finding, sources) {
    // Cross-reference finding across sources
    const matches = await Promise.all(
      sources.map(source => checkMatch(finding, source))
    );
    
    const confidence = matches.filter(m => m).length / sources.length;
    return { finding, confidence, sources: matches };
  }
  ```

  ```python Python theme={null}
  import asyncio

  async def validate_research(findings, sources):
      validation_results = await asyncio.gather(*[
          validate_against_sources(finding, sources)
          for finding in findings
      ])
      
      return [r for r in validation_results if r['confidence'] > 0.8]

  async def validate_against_sources(finding, sources):
      # Cross-reference finding across sources
      matches = await asyncio.gather(*[
          check_match(finding, source)
          for source in sources
      ])
      
      confidence = sum(matches) / len(sources)
      return {'finding': finding, 'confidence': confidence, 'sources': matches}
  ```
</CodeGroup>

***

## Enterprise Research Templates

Use pre-built templates for common research workflows:

<CardGroup>
  <Card title="Competitive Intelligence" icon="chart-line" href="/datasets/scrapers/scrapers-library">
    Template for competitive analysis and market research
  </Card>

  <Card title="Market Analysis" icon="building" href="/datasets/deep-lookup/overview">
    Template for comprehensive market research
  </Card>

  <Card title="Investigator Research" icon="search" href="/scraping-automation/serp-api/introduction">
    Template for investigative research workflows
  </Card>

  <Card title="Trend Analysis" icon="trending-up" href="/datasets/archive/overview">
    Template for historical trend analysis
  </Card>
</CardGroup>

***

## Examples

### Competitive Intelligence Research

Research competitors across multiple sources:

<CodeGroup>
  ```javascript Node.js theme={null}
  async function researchCompetitor(competitorName) {
    // Search real-time data
    const serpResults = await searchSERP(`${competitorName} pricing features`);
    
    // Search historical data
    const archiveResults = await searchArchive(competitorName, '2023-01-01');
    
    // Extract site-specific data
    const siteData = await extractFromSite(`https://${competitorName}.com`);
    
    // Cross-reference findings
    const validated = await validateResearch([
      ...serpResults,
      ...archiveResults,
      siteData
    ]);
    
    return {
      competitor: competitorName,
      findings: validated,
      sources: ['serp', 'archive', 'site']
    };
  }
  ```

  ```python Python theme={null}
  import asyncio

  async def research_competitor(competitor_name):
      # Search real-time data
      serp_results = await search_serp(f'{competitor_name} pricing features')
      
      # Search historical data
      archive_results = await search_archive(competitor_name, '2023-01-01')
      
      # Extract site-specific data
      site_data = await extract_from_site(f'https://{competitor_name}.com')
      
      # Cross-reference findings
      validated = await validate_research([
          *serp_results,
          *archive_results,
          site_data
      ])
      
      return {
          'competitor': competitor_name,
          'findings': validated,
          'sources': ['serp', 'archive', 'site']
      }
  ```
</CodeGroup>

### Market Research Workflow

Conduct comprehensive market research:

<CodeGroup>
  ```javascript Node.js theme={null}
  async function conductMarketResearch(topic) {
    // Step 1: Search current trends
    const currentTrends = await searchSERP(`${topic} trends 2024`);
    
    // Step 2: Analyze historical trends
    const historicalTrends = await searchArchive(topic, '2020-01-01');
    
    // Step 3: Extract competitor data
    const competitors = await findCompetitors(topic);
    const competitorData = await Promise.all(
      competitors.map(c => researchCompetitor(c))
    );
    
    // Step 4: Validate and compile
    const researchReport = {
      topic,
      currentTrends,
      historicalTrends,
      competitors: competitorData,
      validated: true
    };
    
    return researchReport;
  }
  ```

  ```python Python theme={null}
  import asyncio

  async def conduct_market_research(topic):
      # Step 1: Search current trends
      current_trends = await search_serp(f'{topic} trends 2024')
      
      # Step 2: Analyze historical trends
      historical_trends = await search_archive(topic, '2020-01-01')
      
      # Step 3: Extract competitor data
      competitors = await find_competitors(topic)
      competitor_data = await asyncio.gather(*[
          research_competitor(c)
          for c in competitors
      ])
      
      # Step 4: Validate and compile
      research_report = {
          'topic': topic,
          'current_trends': current_trends,
          'historical_trends': historical_trends,
          'competitors': competitor_data,
          'validated': True
      }
      
      return research_report
  ```
</CodeGroup>

***

## Next Steps

<CardGroup>
  <Card title="SERP API Quickstart" icon="rocket" href="/search-api-quickstart">
    Start collecting search results for research
  </Card>

  <Card title="Browser API Quickstart" icon="rocket" href="/browser-api-quickstart">
    Automate complex site navigation for research
  </Card>

  <Card title="Web Archive" icon="rocket" href="/datasets/archive/overview">
    Access historical data for trend analysis
  </Card>

  <Card title="Deep Lookup" icon="rocket" href="/datasets/deep-lookup/overview">
    Use Deep Lookup for comprehensive research
  </Card>
</CardGroup>

<Info>
  **Need help?** Check out our [Research Examples](/scraping-automation/serp-api/get-top-100-google-results) or [contact support](https://brightdata.com/contact).
</Info>


# Data enrichment
Source: https://docs.brightdata.com/ai/enrichment

Build AI agents that fill CRM fields, enrich leads and complete records using the Bright Data search-and-extract pattern (1000+ scrapers) for high-volume runs.

<Card title="Building an AI startup?" href="https://brightdata.com/ai/ai-startups-program" icon="rocket-launch">
  You might be eligible for our Startup Program. Get fully funded access to the infrastructure you're reading about right now (up to \$20K value).
</Card>

## Data Enrichment

Build AI agents that automatically fill CRM data, enrich leads, and complete customer records at enterprise scale.

Master the search-and-extract pattern for enrichment operations, from LinkedIn company data collection to lead scoring workflows.

<CardGroup>
  <Card title="Learn the Pattern" icon="lightbulb" href="#the-enrichment-pattern">
    Understand the enrichment workflow
  </Card>

  <Card title="Get Started" icon="rocket" href="#contact-enrichment---linkedin-example">
    Start with a LinkedIn example
  </Card>
</CardGroup>

***

## Why Standard Scraping Falls Short

<CardGroup>
  <Card title="Standard Scraping Stack" icon="xmark">
    \~50% success rate on protected sites like LinkedIn due to anti-bot measures

    Slow SERP responses (2-5 seconds) limit throughput

    Rate limits and IP bans break batch processing at scale

    Manual proxy management increases operational risk

    Unreliable beyond 1K concurrent enrichment jobs
  </Card>

  <Card title="Bright Data Stack" icon="check">
    95%+ enrichment success, including on protected sites

    50K+ concurrent extractions with 99.99% uptime

    Automated proxy rotation, unblocking, and CAPTCHA solving

    GDPR/CCPA-ready with strong security controls

    Global proxy network (400M+ monthly residential IPs) for broad market coverage
  </Card>
</CardGroup>

***

## How to handle enrichment complexity

Address common challenges in enrichment systems:

* **LinkedIn's aggressive anti-bot measures** - Automatically bypass with Web Unlocker
* **CAPTCHA challenges** - Automatic CAPTCHA solving with no manual intervention
* **Rate limiting** - Intelligent rate management and proxy rotation
* **Data quality issues** - Built-in validation and error handling

Bright Data's infrastructure solves these with automatic CAPTCHA solving, intelligent rate management, and production-ready reliability.

<CardGroup>
  <Card title="Automatic CAPTCHA Solving" icon="unlock" href="/scraping-automation/web-unlocker/introduction">
    Never get blocked by CAPTCHAs or bot detection
  </Card>

  <Card title="Rate Management" icon="clock" href="/proxy-networks/residential/configure-your-proxy">
    Intelligent rate limiting and proxy rotation
  </Card>

  <Card title="Data Validation" icon="check-circle" href="/datasets/data-validation/data-validation-for-customers">
    Built-in validation ensures data quality
  </Card>

  <Card title="Error Handling" icon="exclamation-triangle" href="/proxy-networks/errorCatalog">
    Robust error handling for production reliability
  </Card>
</CardGroup>

***

## How to scale enrichment

Scale from enriching hundreds of leads to processing millions of records with the same infrastructure.

Built for enrichment patterns like:

* **Parallel processing** for throughput
* **Error handling** for reliability
* **Data validation** for quality

<CardGroup>
  <Card title="Parallel Processing" icon="server">
    Process thousands of leads simultaneously with enterprise-scale infrastructure
  </Card>

  <Card title="Error Handling" icon="shield-check">
    Robust error handling ensures reliability at scale
  </Card>

  <Card title="Data Validation" icon="check-circle">
    Built-in validation ensures high-quality enriched data
  </Card>
</CardGroup>

***

## The Enrichment Pattern

The enrichment pattern typically follows these steps:

1. **Input** - Receive a list of leads or records that need enrichment
2. **Search** - Search for each lead using SERP API or web scraping
3. **Extract** - Extract relevant data from search results
4. **Validate** - Validate the extracted data for quality
5. **Enrich** - Add the enriched data to your CRM or database
6. **Monitor** - Monitor success rates and data quality

<Steps>
  <Step title="Prepare Input Data">
    Prepare your list of leads or records that need enrichment. Include identifiers like company names, domains, or email addresses.

    ```json theme={null}
    [
      {
        "company_name": "Example Corp",
        "domain": "example.com",
        "email": "contact@example.com"
      }
    ]
    ```
  </Step>

  <Step title="Search for Data">
    Use SERP API or web scraping to search for each lead and find relevant information.

    <CodeGroup>
      ```javascript Node.js theme={null}
      const response = await fetch('https://api.brightdata.com/datasets/v3/trigger?dataset_id=YOUR_DATASET_ID', {
        method: 'POST',
        headers: {
          'Authorization': `Bearer ${apiKey}`,
          'Content-Type': 'application/json'
        },
        body: JSON.stringify([{
          url: 'https://www.google.com/search',
          keyword: 'Example Corp company information',
          country: 'US'
        }])
      });
      ```

      ```python Python theme={null}
      import requests

      response = requests.post(
        'https://api.brightdata.com/datasets/v3/trigger?dataset_id=YOUR_DATASET_ID',
        headers={
          'Authorization': f'Bearer {api_key}',
          'Content-Type': 'application/json'
        },
        json=[{
          'url': 'https://www.google.com/search',
          'keyword': 'Example Corp company information',
          'country': 'US'
        }]
      )
      ```
    </CodeGroup>
  </Step>

  <Step title="Extract and Validate">
    Extract relevant data from search results and validate for quality.

    <Tip>
      Use data validation endpoints to ensure the extracted data meets your quality standards.
    </Tip>
  </Step>

  <Step title="Enrich Records">
    Add the enriched data to your CRM or database.

    <Check>
      Successfully enriched leads are saved with complete contact information.
    </Check>
  </Step>
</Steps>

***

## Contact Enrichment - LinkedIn Example

Enrich leads with LinkedIn company data:

### Step 1: Search LinkedIn

Search for company information on LinkedIn:

<CodeGroup>
  ```javascript Node.js theme={null}
  const response = await fetch('https://api.brightdata.com/datasets/v3/trigger?dataset_id=YOUR_LINKEDIN_DATASET_ID', {
    method: 'POST',
    headers: {
      'Authorization': `Bearer ${apiKey}`,
      'Content-Type': 'application/json'
    },
    body: JSON.stringify([{
      url: 'https://www.linkedin.com/company/example-corp',
      company_name: 'Example Corp'
    }])
  });
  ```

  ```python Python theme={null}
  import requests

  response = requests.post(
    'https://api.brightdata.com/datasets/v3/trigger?dataset_id=YOUR_LINKEDIN_DATASET_ID',
    headers={
      'Authorization': f'Bearer {api_key}',
      'Content-Type': 'application/json'
    },
    json=[{
      'url': 'https://www.linkedin.com/company/example-corp',
      'company_name': 'Example Corp'
    }]
  )
  ```
</CodeGroup>

### Step 2: Extract Company Data

Extract company information:

```json theme={null}
{
  "company_name": "Example Corp",
  "industry": "Technology",
  "employee_count": "1000-5000",
  "location": "San Francisco, CA",
  "website": "https://example.com",
  "description": "Leading technology company..."
}
```

### Step 3: Enrich Your CRM

Add the enriched data to your CRM:

<CodeGroup>
  ```javascript Node.js theme={null}
  // Add enriched data to your CRM
  await crm.addContact({
    company_name: enrichedData.company_name,
    industry: enrichedData.industry,
    employee_count: enrichedData.employee_count,
    location: enrichedData.location,
    website: enrichedData.website
  });
  ```

  ```python Python theme={null}
  # Add enriched data to your CRM
  crm.add_contact(
    company_name=enriched_data['company_name'],
    industry=enriched_data['industry'],
    employee_count=enriched_data['employee_count'],
    location=enriched_data['location'],
    website=enriched_data['website']
  )
  ```
</CodeGroup>

***

## How to process leads in bulk

Process large volumes of leads efficiently:

### How to process in parallel

Process multiple leads simultaneously:

<CodeGroup>
  ```javascript Node.js theme={null}
  const leads = [/* array of leads */];
  const enrichmentPromises = leads.map(lead => 
    enrichLead(lead)
  );

  const enrichedLeads = await Promise.all(enrichmentPromises);
  ```

  ```python Python theme={null}
  import asyncio

  leads = [/* list of leads */]

  async def enrich_lead(lead):
      # Enrichment logic
      pass

  async def enrich_all_leads():
      tasks = [enrich_lead(lead) for lead in leads]
      enriched_leads = await asyncio.gather(*tasks)
      return enriched_leads
  ```
</CodeGroup>

### How to process in batches

Process leads in batches to manage rate limits:

<CodeGroup>
  ```javascript Node.js theme={null}
  async function processBatch(leads, batchSize = 10) {
    for (let i = 0; i < leads.length; i += batchSize) {
      const batch = leads.slice(i, i + batchSize);
      await Promise.all(batch.map(lead => enrichLead(lead)));
      // Wait between batches to respect rate limits
      await new Promise(resolve => setTimeout(resolve, 1000));
    }
  }
  ```

  ```python Python theme={null}
  import time

  def process_batch(leads, batch_size=10):
      for i in range(0, len(leads), batch_size):
          batch = leads[i:i + batch_size]
          for lead in batch:
              enrich_lead(lead)
          # Wait between batches to respect rate limits
          time.sleep(1)
  ```
</CodeGroup>

***

## Common Data Sources

<CardGroup>
  <Card title="LinkedIn" icon="linkedin" href="/api-reference/scrapers/social-media-apis/linkedin-profiles-collect-by-url">
    Company and professional data from LinkedIn
  </Card>

  <Card title="Google Search" icon="magnifying-glass" href="/scraping-automation/serp-api/introduction">
    Search results for company information and news
  </Card>

  <Card title="Company Websites" icon="globe" href="/scraping-automation/scraping-browser/introduction">
    Extract company information directly from websites
  </Card>

  <Card title="Social Media" icon="share" href="/api-reference/scrapers/social-media-apis/overview">
    Social media profiles and engagement data
  </Card>
</CardGroup>

***

## How to handle errors

Implement robust error handling for production reliability:

<CodeGroup>
  ```javascript Node.js theme={null}
  async function enrichLeadWithRetry(lead, maxRetries = 3) {
    for (let attempt = 1; attempt <= maxRetries; attempt++) {
      try {
        const result = await enrichLead(lead);
        return result;
      } catch (error) {
        if (attempt === maxRetries) {
          throw error;
        }
        // Exponential backoff
        await new Promise(resolve => setTimeout(resolve, Math.pow(2, attempt) * 1000));
      }
    }
  }
  ```

  ```python Python theme={null}
  import time

  def enrich_lead_with_retry(lead, max_retries=3):
      for attempt in range(1, max_retries + 1):
          try:
              result = enrich_lead(lead)
              return result
          except Exception as error:
              if attempt == max_retries:
                  raise error
              # Exponential backoff
              time.sleep(2 ** attempt)
  ```
</CodeGroup>

***

## Pre-built enrichment templates

Use pre-built templates for common enrichment workflows:

<CardGroup>
  <Card title="LinkedIn Company Enrichment" icon="linkedin" href="/api-reference/scrapers/social-media-apis/linkedin-profiles-collect-by-url">
    Template for enriching leads with LinkedIn company data
  </Card>

  <Card title="Email Validation" icon="envelope" href="/datasets/deep-lookup/overview">
    Template for validating and enriching email addresses
  </Card>

  <Card title="Contact Information" icon="address-book" href="/datasets/deep-lookup/overview">
    Template for enriching contact information
  </Card>

  <Card title="Company Intelligence" icon="building" href="/datasets/deep-lookup/overview">
    Template for collecting company intelligence data
  </Card>
</CardGroup>

***

## Additional Use Cases

### Product Catalog Enrichment

Enrich product databases with up-to-date market data:

1. Ingest incomplete product records (SKU, name, category).
2. Scrape pricing, competitor data, and availability from live sources using [Web Unlocker](/scraping-automation/web-unlocker/introduction).
3. Merge and deduplicate entries across multiple vendors.
4. Generate enriched product descriptions, specifications, and metadata.
5. Sync enriched catalogs to inventory and recommendation systems.

### Research Data Normalization

Standardize and complete research datasets at scale:

1. Ingest raw data from multiple CSV files or APIs.
2. Extract and validate company information, rankings, or trends using [SERP API](/scraping-automation/serp-api/introduction).
3. Normalize inconsistent formats and fill missing values.
4. Enrich with external APIs and verified data sources.
5. Output clean, deduplicated datasets for analytics pipelines and ML models.

***

## Next Steps

<CardGroup>
  <Card title="SERP API Quickstart" icon="rocket" href="/search-api-quickstart">
    Start collecting search results for enrichment
  </Card>

  <Card title="LinkedIn Scrapers" icon="rocket" href="/api-reference/scrapers/social-media-apis/linkedin-profiles-collect-by-url">
    Use pre-built LinkedIn scrapers for company data
  </Card>

  <Card title="Deep Lookup" icon="rocket" href="/datasets/deep-lookup/overview">
    Use Deep Lookup for comprehensive data enrichment
  </Card>

  <Card title="Browse Examples" icon="code" href="/datasets/scrapers/scrapers-library">
    Explore pre-built scrapers for common data sources
  </Card>
</CardGroup>

<Info>
  **Need help?** Check out our [Data Validation Guide](/datasets/data-validation/data-validation-for-customers) or [contact support](https://brightdata.com/contact).
</Info>


# Query Bright Data docs from your agent
Source: https://docs.brightdata.com/ai/for-agents/docs-mcp

Connect your AI coding agent to Bright Data's docs via Model Context Protocol. Retrieve 1000+ scraper docs as native MCP resources, no scraping required.

## What is the Docs MCP?

The Docs MCP server at `https://docs.brightdata.com/mcp` exposes all Bright Data documentation as searchable MCP resources. Any MCP-compatible coding agent can connect and query the docs in real-time, directly inside its reasoning loop.

<Info>
  **Two Bright MCP servers - two different jobs:**

  | MCP Server   | URL                                            | Purpose                                           |
  | ------------ | ---------------------------------------------- | ------------------------------------------------- |
  | **Docs MCP** | `https://docs.brightdata.com/mcp`              | Search and retrieve Bright Data documentation     |
  | **Web MCP**  | `https://mcp.brightdata.com/mcp?token=<token>` | Access live web data - scraping, search, unlocker |

  This page covers the **Docs MCP**. To access live web data from your agent, see the [MCP Server docs →](/ai/mcp-server/overview)
</Info>

***

## Connect your agent

<Tabs>
  <Tab title="Claude Code">
    ```bash theme={null}
    claude mcp add --transport http brightdata-docs https://docs.brightdata.com/mcp
    ```

    Verify the connection:

    ```bash theme={null}
    claude mcp list
    # brightdata-docs: https://docs.brightdata.com/mcp (HTTP) - ✓ Connected
    ```
  </Tab>

  <Tab title="Cursor">
    Open **Settings → Tools & Integrations → Add Custom MCP** and paste:

    ```json theme={null}
    {
      "mcpServers": {
        "brightdata-docs": {
          "url": "https://docs.brightdata.com/mcp",
          "transport": "http"
        }
      }
    }
    ```
  </Tab>

  <Tab title="VS Code (Copilot)">
    Add to your `.vscode/mcp.json` or user MCP settings:

    ```json theme={null}
    {
      "servers": {
        "brightdata-docs": {
          "url": "https://docs.brightdata.com/mcp",
          "type": "http"
        }
      }
    }
    ```
  </Tab>

  <Tab title="Claude Desktop">
    Add to `claude_desktop_config.json` (usually at `~/.config/claude/`):

    ```json theme={null}
    {
      "mcpServers": {
        "brightdata-docs": {
          "url": "https://docs.brightdata.com/mcp",
          "transport": "http"
        }
      }
    }
    ```
  </Tab>

  <Tab title="Windsurf / Any MCP client">
    The Docs MCP uses standard HTTP transport - connect any MCP-compatible client to:

    ```http theme={null}
    https://docs.brightdata.com/mcp
    ```

    No authentication required. No API key needed.
  </Tab>
</Tabs>

***

## What can your agent do with it?

Once connected, your agent gains a **search tool** over the full Bright Data documentation index. It can:

* **Find the right API** - "What's the parameter for setting a custom geo-location in the SERP API?"
* **Retrieve product pages** - Pull the full reference for Web Unlocker, Scraping Browser, or any product
* **Look up code examples** - "Show me a Python example for paginating SERP results"
* **Explore integrations** - "How do I connect LangChain to Bright Data?"
* **Check pricing and limits** - "What are the rate limits for the Web MCP free tier?"

The agent queries docs during its reasoning loop - so it always has accurate, up-to-date information rather than relying on stale training data.

***

## Use both MCP servers together

For maximum capability, connect **both** MCP servers in a single session:

```bash theme={null}
# Docs: know how to use Bright Data
claude mcp add --transport http brightdata-docs https://docs.brightdata.com/mcp

# Data: actually use Bright Data
claude mcp add --transport sse brightdata https://mcp.brightdata.com/sse?token=<your-api-token>
```

Now your agent can look up documentation **and** execute real web data requests in the same session - no context switching required.

<Tip>
  The best setup for a coding agent is all three layers working together:

  1. A **[Skill](/ai/for-agents/skills)** for embedded baseline knowledge
  2. The **Docs MCP** for on-demand documentation lookup
  3. The **[Web MCP](/ai/mcp-server/overview)** for live web access

  Install the skill once, connect both MCP servers, and your agent is fully equipped.
</Tip>

***

## Rate limits

| Limit                        | Value |
| ---------------------------- | ----- |
| Requests per user per hour   | 200   |
| Requests per domain per hour | 1,000 |

These limits apply to the Mintlify-hosted Docs MCP. For higher throughput, use [llms-full.txt](/ai/for-agents/llm-references) to load the full docs locally.

***

## Next steps

<CardGroup>
  <Card title="Web MCP Server" icon="microchip-ai" href="/ai/mcp-server/overview">
    Add live web data access - search, scrape, and extract from the web
  </Card>

  <Card title="LLM References" icon="file-lines" href="/ai/for-agents/llm-references">
    Load llms.txt or llms-full.txt for offline or RAG-based access to all docs
  </Card>
</CardGroup>


# LLM-friendly documentation references
Source: https://docs.brightdata.com/ai/for-agents/llm-references

Plain-text and machine-readable versions of all Bright Data documentation across 1000+ pages, built for AI agents, RAG pipelines and LLM context injection.

## Overview

Bright Data publishes two machine-readable documentation files following the [llms.txt standard](https://llmstxt.org):

| File            | URL                                                   | Best for                                       |
| --------------- | ----------------------------------------------------- | ---------------------------------------------- |
| `llms.txt`      | [`docs.brightdata.com/llms.txt`](/llms.txt)           | Agent awareness, navigation, retrieval routing |
| `llms-full.txt` | [`docs.brightdata.com/llms-full.txt`](/llms-full.txt) | RAG pipelines, context injection, fine-tuning  |

***

## llms.txt - Documentation Index

`llms.txt` is a structured, markdown-formatted index of all Bright Data documentation pages - one entry per page with a short description and a direct link.

**Format:**

```markdown theme={null}
# Bright Data Docs

## Docs

- [Agent Web Access](/ai/agents.md): Complete web infrastructure for AI agents
- [SERP API Introduction](/scraping-automation/serp-api/introduction.md): Real-time search results
- [Web Unlocker](/scraping-automation/web-unlocker/introduction.md): Bypass bot detection
...
```

Note that every link points to the `.md` version of the page - clean markdown, no HTML.

**Use it when:**

* Loading into an agent's system prompt for full product awareness
* Feeding a retrieval system to decide which doc pages to fetch
* Giving a coding agent a map of available products before it starts a task

```bash theme={null}
# Quick preview
curl https://docs.brightdata.com/llms.txt | head -40

# Download for offline use
curl -o brightdata-llms.txt https://docs.brightdata.com/llms.txt
```

***

## llms-full.txt - Complete Documentation

`llms-full.txt` contains the complete text of all Bright Data documentation in a single file - clean markdown, no HTML, no navigation chrome.

**Use it when:**

* Building a RAG pipeline over Bright Data docs
* Injecting full product knowledge into a long-context model (Gemini 1.5 Pro, Claude, etc.)
* Creating a fine-tuning or evaluation dataset
* Giving an agent complete offline reference

```bash theme={null}
# Download
curl -o brightdata-llms-full.txt https://docs.brightdata.com/llms-full.txt
```

<Warning>
  `llms-full.txt` is large. For real-time agent sessions, loading `llms.txt` first and fetching specific pages on demand is more token-efficient.
</Warning>

***

## Loading into your agent

<Tabs>
  <Tab title="Claude Code">
    Reference the file directly in a prompt - Claude Code will fetch and read it:

    ```text theme={null}
    Please read https://docs.brightdata.com/llms.txt to understand the available
    Bright Data products, then help me choose the right API for scraping Amazon product pages.
    ```

    Or save it as a project context file:

    ```bash theme={null}
    mkdir -p .claude
    curl -o .claude/brightdata-docs.txt https://docs.brightdata.com/llms.txt
    ```

    Then reference it in your CLAUDE.md or system prompt:

    ```markdown theme={null}
    # Project context
    See .claude/brightdata-docs.txt for the full Bright Data product reference.
    ```
  </Tab>

  <Tab title="Cursor / Windsurf">
    Add as a project rules file so your agent has it in context automatically:

    ```bash theme={null}
    # Save to project rules directory
    curl -o .cursor/rules/brightdata.md https://docs.brightdata.com/llms.txt
    # or for Windsurf:
    curl -o .windsurf/rules/brightdata.md https://docs.brightdata.com/llms.txt
    ```

    Now every Cursor Composer or Windsurf Cascade session has Bright Data product awareness built in.
  </Tab>

  <Tab title="RAG Pipeline">
    ```python theme={null}
    import httpx
    from langchain.text_splitter import MarkdownTextSplitter

    # Fetch the full docs
    response = httpx.get("https://docs.brightdata.com/llms-full.txt")
    docs_content = response.text

    # Split into chunks
    splitter = MarkdownTextSplitter(chunk_size=1000, chunk_overlap=100)
    chunks = splitter.create_documents([docs_content])

    # Add to your vector store
    vectorstore.add_documents(chunks)
    ```
  </Tab>

  <Tab title="OpenAI / Custom LLM">
    ```python theme={null}
    import httpx

    # Fetch the index
    llms_txt = httpx.get("https://docs.brightdata.com/llms.txt").text

    messages = [
        {
            "role": "system",
            "content": f"""You are a helpful assistant with expertise in Bright Data's web data APIs.

    Here is the full index of available documentation:
    {llms_txt}

    Use this to understand which products and APIs are available, then fetch
    specific pages when you need full details on a product."""
        },
        {"role": "user", "content": "How do I scrape Amazon product pages?"}
    ]
    ```
  </Tab>
</Tabs>

***

## Per-page markdown access

Every Bright Data documentation page is also available as clean markdown. Append `.md` to any page URL:

| Page                                                                | Markdown URL                                                                           |
| ------------------------------------------------------------------- | -------------------------------------------------------------------------------------- |
| `docs.brightdata.com/ai/agents`                                     | [`docs.brightdata.com/ai/agents.md`](/ai/agents.md)                                    |
| `docs.brightdata.com/scraping-automation/web-unlocker/introduction` | [`...web-unlocker/introduction.md`](/scraping-automation/web-unlocker/introduction.md) |
| `docs.brightdata.com/ai/mcp-server/overview`                        | [`...mcp-server/overview.md`](/ai/mcp-server/overview.md)                              |

This lets agents fetch specific pages on demand without parsing any HTML.

<Tip>
  **Recommended pattern for agents:** Load `llms.txt` to understand what's available → identify the relevant page → fetch that page's `.md` URL for full details. This keeps token usage efficient while giving the agent complete information when needed.
</Tip>

***

## Next steps

<CardGroup>
  <Card title="Install a Skill" icon="bolt" href="/ai/for-agents/skills">
    Pre-packaged agent knowledge bundles with runnable scripts
  </Card>

  <Card title="Connect the Docs MCP" icon="server" href="/ai/for-agents/docs-mcp">
    Query Bright Data docs as MCP resources from inside your agent tool
  </Card>
</CardGroup>


# Bright Data for AI coding agents
Source: https://docs.brightdata.com/ai/for-agents/overview

Everything a coding agent needs to work with Bright Data - LLM-optimized docs, skills, MCP server, and plain-text references. Covers 100+ sources.

## For Coding Agents

This section is designed for **AI coding agents** (Claude Code, Cursor, Copilot, Windsurf, Gemini CLI, etc.) and the developers building with them.

Bright Data gives agents production-grade access to the live web: search results, web page content, structured datasets, and anti-bot bypass - all through simple APIs.

***

## Where to start

<CardGroup>
  <Card title="llms.txt" icon="file-lines" href="/llms.txt">
    Machine-readable index of all Bright Data documentation. Feed this to your agent for full product awareness.
  </Card>

  <Card title="llms-full.txt" icon="file-code" href="/llms-full.txt">
    Complete documentation in a single plain-text file - ideal for RAG pipelines or direct context injection.
  </Card>

  <Card title="Skills" icon="bolt" href="https://github.com/brightdata/skills">
    Pre-packaged skill bundles for Claude Code, Cursor, and more. Install and instantly gain Bright Data expertise.
  </Card>

  <Card title="Docs MCP" icon="server" href="/mcp">
    MCP server that gives your agent access to Bright Data's full documentation as queryable resources.
  </Card>
</CardGroup>

***

## What can agents do with Bright Data?

<CardGroup>
  <Card title="Search the web" icon="magnifying-glass" href="/scraping-automation/serp-api/introduction">
    Real-time Google, Bing, and SERP results via API
  </Card>

  <Card title="Scrape any page" icon="unlock" href="/scraping-automation/web-unlocker/introduction">
    Bypass CAPTCHAs, bot protection, and dynamic content
  </Card>

  <Card title="Use structured datasets" icon="table" href="/datasets/marketplace/overview">
    Ready-to-use datasets for Amazon, LinkedIn, and 100+ sources
  </Card>
</CardGroup>

***

## Security & Compliance

Bright Data's MCP Server and APIs are covered under **ISO 27001:2022, ISO 27017, and ISO 27018** certifications, all explicitly scoped to AI agent and RAG system use cases. See the full security posture:

<Card title="Security & Compliance" icon="shield-check" href="/general/security/security-overview">
  ISO certifications, SOC 2 Type II, penetration test results, encryption standards, and best practices for agentic workflows.
</Card>

***

## Recommended path for agents

<Steps>
  <Step title="Install a Skill">
    Start with a ready-made skill bundle. Skills teach your agent Bright Data APIs with embedded best practices and runnable scripts.

    See [Skills →](/ai/for-agents/skills)
  </Step>

  <Step title="Connect the Web MCP Server">
    Add Bright Data's Web MCP server so your agent can search and fetch live web data directly from inside any supported tool.

    See [Web MCP Server →](/ai/mcp-server/overview)
  </Step>

  <Step title="Load the LLM reference">
    Point your agent at `llms.txt` or `llms-full.txt` for a full map of Bright Data products and APIs.

    See [LLM References →](/ai/for-agents/llm-references)
  </Step>
</Steps>


# Bright Data skills for coding agents
Source: https://docs.brightdata.com/ai/for-agents/skills

Install Bright Data skills (1000+ scrapers) into your AI coding agent for best-practice API usage, working scripts and embedded product knowledge instantly.

## What are Skills?

Skills are **reusable instruction sets** - defined in `SKILL.md` files - that extend your coding agent's capabilities with Bright Data APIs. Each skill gives your agent embedded best practices, parameter knowledge, and runnable shell scripts it can execute directly.

Install Bright Data skills and your agent immediately knows:

* Which API to call for search, scraping, or structured data extraction
* How to authenticate and structure requests correctly
* How to handle pagination, errors, and edge cases
* Real scripts it can invoke to take action

Skills are part of the [open agent skills ecosystem](https://github.com/vercel-labs/skills) and work across 40+ coding agents. Bright Data's skills are hosted at [github.com/brightdata/skills](https://github.com/brightdata/skills).

***

## Which skills are available

<CardGroup>
  <Card title="Search" icon="magnifying-glass" href="https://github.com/brightdata/skills">
    Search Google and get structured JSON results with titles, links, and descriptions. Supports pagination. Powered by the Bright Data SERP API.
  </Card>

  <Card title="Scrape" icon="unlock" href="https://github.com/brightdata/skills">
    Scrape any webpage as clean markdown with automatic bot detection bypass, CAPTCHA solving, and JavaScript rendering. Powered by the Web Unlocker API.
  </Card>

  <Card title="Data Feeds" icon="database" href="https://github.com/brightdata/skills">
    Extract structured data from 40+ websites - Amazon, LinkedIn, Instagram, TikTok, YouTube, eBay, Walmart, and more - with automatic polling.
  </Card>

  <Card title="Bright Web MCP" icon="server" href="https://github.com/brightdata/skills">
    Orchestrate 60+ MCP tools for search, scraping, structured extraction, and browser automation in a single integration.
  </Card>

  <Card title="Best Practices" icon="star" href="https://github.com/brightdata/skills/tree/main/skills/bright-data-best-practices">
    Production-ready API reference for coding agents. Covers Web Unlocker, SERP API, Scrapers, and Browser API - with an API selection guide, auth patterns, and code examples in Python and JavaScript.
  </Card>
</CardGroup>

***

## Quick Start

<Steps>
  <Step title="Prerequisites">
    Install the required CLI tools and set your Bright Data credentials:

    ```bash theme={null}
    # macOS
    brew install curl jq

    # Ubuntu / Debian
    sudo apt-get install curl jq
    ```

    ```bash theme={null}
    export BRIGHTDATA_API_KEY="your-api-key"
    export BRIGHTDATA_UNLOCKER_ZONE="your-zone-name"
    ```

    Get your API key from the [Bright Data user settings page](https://brightdata.com/cp/setting/users). To create a Web Unlocker zone, see the [Web Unlocker quickstart](/scraping-automation/web-unlocker/quickstart).
  </Step>

  <Step title="Install with npx skills">
    Use the `npx skills` CLI to install Bright Data skills into your agent:

    ```bash theme={null}
    # Install all skills (auto-detects your installed agents)
    npx skills add brightdata/skills

    # Install to a specific agent only
    npx skills add brightdata/skills -a claude-code
    npx skills add brightdata/skills -a cursor

    # Install a specific skill only
    npx skills add brightdata/skills --skill search
    npx skills add brightdata/skills --skill scrape
    npx skills add brightdata/skills --skill data-feeds
    npx skills add brightdata/skills --skill bright-data-best-practices

    # Install globally (available across all your projects)
    npx skills add brightdata/skills -g
    ```

    The CLI detects which agents you have installed and places skill files in the correct directories automatically.
  </Step>

  <Step title="Use the skills in your agent">
    Once installed, your agent can run the skills directly:

    ```bash theme={null}
    # Search Google
    bash skills/search/scripts/search.sh "your query" [page]

    # Scrape a URL as clean markdown
    bash skills/scrape/scripts/scrape.sh "https://example.com"

    # Extract structured data (run without args to see all 40+ dataset types)
    bash skills/data-feeds/scripts/datasets.sh

    # With a specific dataset type and URL
    bash skills/data-feeds/scripts/datasets.sh amazon_product "https://amazon.com/dp/ASIN"
    bash skills/data-feeds/scripts/datasets.sh linkedin_person_profile "https://linkedin.com/in/username"
    ```
  </Step>
</Steps>

***

## Installation per agent

<Tabs>
  <Tab title="Claude Code">
    ```bash theme={null}
    npx skills add brightdata/skills -a claude-code
    ```

    Skills are installed into `.claude/skills/` in your project (or `~/.claude/skills/` with `-g` for global). Claude Code discovers them automatically on the next session.

    To verify installation:

    ```bash theme={null}
    npx skills list -a claude-code
    ```
  </Tab>

  <Tab title="Cursor">
    ```bash theme={null}
    npx skills add brightdata/skills -a cursor
    ```

    Skills land in `.cursor/skills/` in your project. Cursor Composer picks them up automatically. Reference them in chat:

    ```text theme={null}
    Use the scrape skill to extract content from https://example.com
    ```
  </Tab>

  <Tab title="Windsurf">
    ```bash theme={null}
    npx skills add brightdata/skills -a windsurf
    ```

    Windsurf's Cascade reads skills from `.windsurf/skills/` and loads them into its context automatically.
  </Tab>

  <Tab title="All agents at once">
    ```bash theme={null}
    # Install to every agent you have installed
    npx skills add brightdata/skills --all

    # Non-interactive (CI/CD friendly)
    npx skills add brightdata/skills --all -y
    ```

    The CLI auto-detects all installed agents and distributes the skill files to each one.
  </Tab>

  <Tab title="Manual / any agent">
    Clone the repo and reference the `SKILL.md` files directly:

    ```bash theme={null}
    git clone https://github.com/brightdata/skills.git
    ```

    Each skill's `SKILL.md` is plain markdown - inject it into any agent's system prompt, RAG index, or context window:

    ```bash theme={null}
    cat skills/search/SKILL.md                      # Paste into system prompt
    cat skills/scrape/SKILL.md
    cat skills/data-feeds/SKILL.md
    cat skills/bright-data-best-practices/SKILL.md  # API selection + best practices
    ```
  </Tab>
</Tabs>

***

## How skills are structured

Each Bright Data skill follows the standard skill format:

```text theme={null}
skills/
├── search/
│   ├── SKILL.md              # Instructions + metadata - loaded by the agent
│   └── scripts/
│       └── search.sh         # Executable script the agent can run
├── scrape/
│   ├── SKILL.md
│   └── scripts/
│       └── scrape.sh
├── data-feeds/
│   ├── SKILL.md
│   └── scripts/
│       ├── datasets.sh       # Dataset wrapper (40+ types)
│       └── fetch.sh          # Core polling + response handling
├── bright-data-mcp/
│   ├── SKILL.md
│   └── references/           # MCP tool reference docs
└── bright-data-best-practices/
    ├── SKILL.md              # API selection guide + auth patterns + code examples
    └── references/
        ├── web-unlocker.md   # Full Web Unlocker reference
        ├── serp-api.md       # Full SERP API reference (Google, Bing, Maps, Trends...)
        ├── scrapers.md       # Scrapers reference (100+ platforms)
        └── browser-api.md    # Browser API reference (CDP functions, geo, CAPTCHA)
```

`SKILL.md` contains YAML frontmatter with a `name` and `description`, followed by structured instructions that tell the agent when and how to use the skill.

***

## Data Feeds coverage

The Data Feeds skill supports structured extraction from 40+ platforms across four categories:

<CardGroup>
  <Card title="E-Commerce" icon="cart-shopping">
    Amazon (products, reviews, search), Walmart, eBay, Best Buy, Etsy, Home Depot, Zara, Google Shopping
  </Card>

  <Card title="Professional Networks" icon="briefcase">
    LinkedIn (profiles, companies, jobs, posts), Crunchbase, ZoomInfo
  </Card>

  <Card title="Social Media" icon="share-nodes">
    Instagram, TikTok, Facebook, X/Twitter, YouTube, Reddit
  </Card>

  <Card title="Other" icon="globe">
    Google Maps reviews, Yahoo Finance, Zillow, Booking.com, GitHub, App Stores
  </Card>
</CardGroup>

***

## Managing your skills

```bash theme={null}
# List all installed skills
npx skills list

# Check for updates
npx skills check

# Update all skills to latest
npx skills update

# Remove a skill
npx skills remove brightdata/skills
```

***

<Tip>
  For the richest agent setup, combine skills with the [Bright Web MCP Server](/ai/mcp-server/overview). Skills give your agent embedded knowledge and runnable scripts; the MCP server gives it live web access with 60+ tools - all without leaving your coding environment.
</Tip>

<Info>
  New skills are added regularly. Star the [GitHub repository](https://github.com/brightdata/skills) to stay updated.
</Info>


# Web data infrastructure for AI
Source: https://docs.brightdata.com/ai/introduction

Bright Data web infrastructure for AI: production APIs (1000+ scrapers), SDKs and headless browsers that let LLMs and agents search, read and extract live data.

<Card title="Building an AI startup?" href="https://brightdata.com/ai/ai-startups-program" icon="rocket-launch">
  You might be eligible for our Startup Program. Get fully funded access to the infrastructure you're reading about right now (up to \$20K value).
</Card>

## **Web access APIs for LLMs, Copilots and AI agents**

Bright Data provides production-grade web access [APIs](/api-reference/authentication), [SDKs](/api-reference/SDK) and headless browser infrastructure for AI systems that need to search, read, extract, and validate real-world data.

## Quick Start

<CardGroup>
  <Card title="MCP - Fastest way to start" icon="microchip-ai" href="/ai/mcp-server/overview">
    Connect AI assistants and agents to web data
  </Card>

  <Card title="AI Agent Web Access" icon="bolt" href="/ai/agents">
    Complete infrastructure for agent web access
  </Card>

  <Card title="Training Data" icon="table" href="/ai/training">
    Video, image, and text data at scale
  </Card>

  <Card title="For AI Coding Agents" icon="robot" href="/ai/for-agents/overview">
    Skills, LLM references, and Docs MCP for Claude Code, Cursor, and more
  </Card>
</CardGroup>

***

## Use Case Guides

<CardGroup>
  <Card title="Data Enrichment Agents" icon="database" href="/ai/enrichment">
    CRM filling, lead completion workflows
  </Card>

  <Card title="Deep Research Agents" icon="magnifying-glass" href="/ai/deep-research">
    Multi-source research and analysis
  </Card>

  <Card title="LLM Grounding & Evaluation" icon="check-circle" href="/ai/llm-grounding">
    Fact-checking and validation
  </Card>
</CardGroup>

***

## Which Bright Data products to use

<CardGroup>
  <Card title="SERP API" icon="magnifying-glass" href="/scraping-automation/serp-api/introduction">
    Real-time search results for agent discovery
  </Card>

  <Card title="Web Unlocker" icon="unlock" href="/scraping-automation/web-unlocker/introduction">
    Automatic CAPTCHA solving and block bypass
  </Card>

  <Card title="Web Archive" icon="archive" href="/datasets/archive/overview">
    Historical data access for comprehensive research
  </Card>

  <Card title="Agent Browser" icon="browser" href="/scraping-automation/scraping-browser/introduction">
    Browser automation for complex interactions
  </Card>
</CardGroup>

***

## Why developers choose us?

<Card>
  * **99.99% Uptime**: Enterprise-grade reliability ensures your AI agents never miss critical data
  * **Sub-Second Response Times**: Lightning-fast web access keeps your agents responsive and efficient
  * **Built-in Proxy Management**: Automatic IP rotation and session management - no infrastructure to manage
  * **Scale from Prototype to Production**: Start small and scale seamlessly as your AI applications grow
</Card>

***

## How to integrate Bright Data

<CardGroup>
  <Card title="MCP Server" icon="server" href="/ai/mcp-server/overview">
    Connect AI assistants like Claude and Cursor to web data via Model Context Protocol
  </Card>

  <Card title="REST APIs" icon="code" href="/api-reference/authentication">
    Direct API access for custom integrations and workflows
  </Card>

  <Card title="AI Integrations" icon="puzzle-piece" href="/integrations/ai-integrations">
    Pre-built integrations with LangChain, LlamaIndex, Crew AI, and more
  </Card>

  <Card title="SDKs" icon="code-bracket" href="/api-reference/SDK">
    Python & JavaScript
  </Card>
</CardGroup>

***

## Next Steps

<CardGroup>
  <Card title="MCP Server Quickstart" icon="rocket" href="/ai/mcp-server/remote/quickstart">
    Get started with MCP Server in 5 minutes
  </Card>

  <Card title="SERP API Quickstart" icon="rocket" href="/search-api-quickstart">
    Start collecting search results for your AI agents
  </Card>

  <Card title="Web Unlocker Quickstart" icon="rocket" href="/unlocker-api-quickstart">
    Bypass CAPTCHAs and blocks automatically
  </Card>

  <Card title="Browse Integrations" icon="puzzle-piece" href="/integrations/ai-integrations">
    Explore pre-built AI framework integrations
  </Card>
</CardGroup>

<Info>
  **Need help?** Check out our [MCP Server FAQs](/ai/mcp-server/faqs) or [contact support](https://brightdata.com/contact).
</Info>


# LLM grounding & evaluation
Source: https://docs.brightdata.com/ai/llm-grounding

Build AI systems that fact-check model outputs, validate training data and ground LLMs in live web data across 1000+ Bright Data scrapers with verification.

<Card title="Building an AI startup?" href="https://brightdata.com/ai/ai-startups-program" icon="rocket-launch">
  You might be eligible for our Startup Program. Get fully funded access to the infrastructure you're reading about right now (up to \$20K value).
</Card>

## LLM Grounding & Evaluation

Build AI systems that fact-check model outputs, validate training data, and ground language models in real-world information.

Create evaluation workflows that test model accuracy against live web data, verify claims through multi-source validation, and maintain model reliability through continuous real-world grounding.

<CardGroup>
  <Card title="Learn Fact-Checking" icon="lightbulb" href="#fact-checking-workflows">
    Understand fact-checking workflows
  </Card>

  <Card title="Get Started" icon="rocket" href="#model-output-validation">
    Start validating model outputs
  </Card>
</CardGroup>

***

## Which grounding challenges to address

Handle the unique challenges of AI evaluation at scale:

* **Real-time fact verification** - Requiring fast web access for immediate validation
* **Comprehensive testing** - Demanding broad source coverage for thorough evaluation
* **Historical validation** - Needing archive access for fact-checking historical claims
* **Continuous evaluation** - Requiring reliable infrastructure that never goes down

From simple fact-checking to comprehensive model evaluation frameworks, grounding systems need infrastructure that provides both speed and reliability.

<CardGroup>
  <Card title="Fast Web Access" icon="bolt" href="/scraping-automation/serp-api/introduction">
    Real-time fact verification with sub-second response times
  </Card>

  <Card title="Broad Source Coverage" icon="globe" href="/datasets/deep-lookup/overview">
    Comprehensive testing across multiple sources
  </Card>

  <Card title="Historical Validation" icon="archive" href="/datasets/archive/overview">
    Access historical data for fact-checking past claims
  </Card>

  <Card title="Reliable Infrastructure" icon="shield-check">
    99.99% uptime ensures continuous evaluation never stops
  </Card>
</CardGroup>

***

## What grounding aims to achieve

Built for evaluation patterns that maintain model accuracy and user trust through rigorous real-world validation.

***

## How to build fact-checking workflows

Verify claims against real-world data:

<Steps>
  <Step title="Extract Claims from Model Output">
    Extract factual claims from model outputs that need verification.

    ```json theme={null}
    {
      "claims": [
        {
          "text": "The company was founded in 2020",
          "entity": "company_name",
          "type": "factual"
        }
      ]
    }
    ```
  </Step>

  <Step title="Search for Verification">
    Search for verification across multiple sources:

    * Real-time search results (SERP API)
    * Historical data (Web Archive)
    * Structured data (Deep Lookup)

    <CodeGroup>
      ```javascript Node.js theme={null}
      async function verifyClaim(claim) {
        const searches = await Promise.all([
          searchSERP(claim.text),
          searchArchive(claim.entity, '2020-01-01'),
          searchDeepLookup(claim.entity)
        ]);
        
        return searches;
      }
      ```

      ```python Python theme={null}
      import asyncio

      async def verify_claim(claim):
          searches = await asyncio.gather(
              search_serp(claim['text']),
              search_archive(claim['entity'], '2020-01-01'),
              search_deep_lookup(claim['entity'])
          )
          
          return searches
      ```
    </CodeGroup>
  </Step>

  <Step title="Validate Against Sources">
    Validate claims against multiple sources and determine confidence.

    <Tip>
      Use cross-source validation to increase confidence in fact-checking results.
    </Tip>
  </Step>

  <Step title="Report Validation Results">
    Report validation results with source attribution and confidence scores.

    <Check>
      Validated claims are marked with confidence scores and source references.
    </Check>
  </Step>
</Steps>

***

## Model Output Validation

Validate model outputs in real-time:

<CodeGroup>
  ```javascript Node.js theme={null}
  async function validateModelOutput(output, claims) {
    const validationPromises = claims.map(claim => 
      verifyClaim(claim)
    );
    
    const validationResults = await Promise.all(validationPromises);
    
    const validatedOutput = {
      original: output,
      claims: validationResults.map((result, index) => ({
        claim: claims[index],
        verified: result.confidence > 0.8,
        confidence: result.confidence,
        sources: result.sources
      }))
    };
    
    return validatedOutput;
  }
  ```

  ```python Python theme={null}
  import asyncio

  async def validate_model_output(output, claims):
      validation_tasks = [verify_claim(claim) for claim in claims]
      validation_results = await asyncio.gather(*validation_tasks)
      
      validated_output = {
          'original': output,
          'claims': [
              {
                  'claim': claim,
                  'verified': result['confidence'] > 0.8,
                  'confidence': result['confidence'],
                  'sources': result['sources']
              }
              for claim, result in zip(claims, validation_results)
          ]
      }
      
      return validated_output
  ```
</CodeGroup>

***

## Training Data Verification

Verify training data against real-world sources:

<CodeGroup>
  ```javascript Node.js theme={null}
  async function verifyTrainingData(dataset) {
    const verificationResults = await Promise.all(
      dataset.map(item => verifyDataItem(item))
    );
    
    const verified = verificationResults.filter(r => r.verified);
    const unverified = verificationResults.filter(r => !r.verified);
    
    return {
      total: dataset.length,
      verified: verified.length,
      unverified: unverified.length,
      accuracy: verified.length / dataset.length,
      issues: unverified
    };
  }
  ```

  ```python Python theme={null}
  import asyncio

  async def verify_training_data(dataset):
      verification_tasks = [verify_data_item(item) for item in dataset]
      verification_results = await asyncio.gather(*verification_tasks)
      
      verified = [r for r in verification_results if r['verified']]
      unverified = [r for r in verification_results if not r['verified']]
      
      return {
          'total': len(dataset),
          'verified': len(verified),
          'unverified': len(unverified),
          'accuracy': len(verified) / len(dataset),
          'issues': unverified
      }
  ```
</CodeGroup>

***

## Historical Fact Validation with Archive

Validate historical claims using web archive:

<CodeGroup>
  ```javascript Node.js theme={null}
  async function validateHistoricalFact(claim, date) {
    // Search archive for historical data
    const archiveResults = await searchArchive(claim.entity, date);
    
    // Compare with claim
    const matches = archiveResults.filter(result => 
      result.text.includes(claim.text)
    );
    
    return {
      claim,
      date,
      verified: matches.length > 0,
      confidence: matches.length / archiveResults.length,
      sources: matches
    };
  }
  ```

  ```python Python theme={null}
  import asyncio

  async def validate_historical_fact(claim, date):
      # Search archive for historical data
      archive_results = await search_archive(claim['entity'], date)
      
      # Compare with claim
      matches = [
          result for result in archive_results
          if claim['text'] in result['text']
      ]
      
      return {
          'claim': claim,
          'date': date,
          'verified': len(matches) > 0,
          'confidence': len(matches) / len(archive_results) if archive_results else 0,
          'sources': matches
      }
  ```
</CodeGroup>

***

## How to cross-reference multiple sources

Cross-reference facts across multiple sources:

<CodeGroup>
  ```javascript Node.js theme={null}
  async function crossReferenceFact(fact) {
    const sources = await Promise.all([
      searchSERP(fact.query),
      searchDeepLookup(fact.entity),
      searchArchive(fact.entity, fact.date),
      searchSite(fact.url)
    ]);
    
    // Find common findings across sources
    const commonFindings = findCommonFindings(sources);
    
    return {
      fact,
      sources: sources.length,
      commonFindings,
      confidence: commonFindings.length / sources.length,
      validated: commonFindings.length >= sources.length * 0.7
    };
  }
  ```

  ```python Python theme={null}
  import asyncio

  async def cross_reference_fact(fact):
      sources = await asyncio.gather(
          search_serp(fact['query']),
          search_deep_lookup(fact['entity']),
          search_archive(fact['entity'], fact['date']),
          search_site(fact['url'])
      )
      
      # Find common findings across sources
      common_findings = find_common_findings(sources)
      
      return {
          'fact': fact,
          'sources': len(sources),
          'common_findings': common_findings,
          'confidence': len(common_findings) / len(sources) if sources else 0,
          'validated': len(common_findings) >= len(sources) * 0.7
      }
  ```
</CodeGroup>

***

## Continuous Evaluation Systems

Build continuous evaluation systems for ongoing model validation:

<CardGroup>
  <Card title="Real-Time Monitoring" icon="chart-line" href="/general/usage-monitoring/Usage">
    Monitor model outputs in real-time for continuous validation
  </Card>

  <Card title="Automated Testing" icon="robot" href="/scraping-automation/serp-api/introduction">
    Automate fact-checking workflows for continuous evaluation
  </Card>

  <Card title="Alert Systems" icon="bell" href="/general/webhook_notifications">
    Set up alerts for unverified claims or low confidence scores
  </Card>

  <Card title="Performance Tracking" icon="chart-bar" href="/general/usage-monitoring/fair_use_allowance">
    Track evaluation performance and model accuracy over time
  </Card>
</CardGroup>

***

## Pre-built grounding templates

Use pre-built templates for common grounding workflows:

<CardGroup>
  <Card title="Fact-Checking Template" icon="check-circle" href="/scraping-automation/serp-api/introduction">
    Template for real-time fact-checking workflows
  </Card>

  <Card title="Model Evaluation Template" icon="clipboard-check" href="/datasets/deep-lookup/overview">
    Template for comprehensive model evaluation
  </Card>

  <Card title="Training Data Validation" icon="database" href="/datasets/data-validation/data-validation-for-customers">
    Template for validating training datasets
  </Card>

  <Card title="Historical Validation" icon="archive" href="/datasets/archive/overview">
    Template for historical fact validation
  </Card>
</CardGroup>

***

## Next Steps

<CardGroup>
  <Card title="SERP API Quickstart" icon="rocket" href="/search-api-quickstart">
    Start fact-checking with real-time search results
  </Card>

  <Card title="Deep Lookup Quickstart" icon="rocket" href="/deep-lookup-quickstart">
    Use Deep Lookup for comprehensive fact validation
  </Card>

  <Card title="Web Archive" icon="rocket" href="/datasets/archive/overview">
    Access historical data for fact-checking
  </Card>

  <Card title="Browse Examples" icon="code" href="/datasets/deep-lookup/code-examples">
    Explore grounding and evaluation examples
  </Card>
</CardGroup>

<Info>
  **Need help?** Check out our [Evaluation Examples](/datasets/deep-lookup/code-examples) or [contact support](https://brightdata.com/contact).
</Info>


# FAQ: MCP
Source: https://docs.brightdata.com/ai/mcp-server/faqs

FAQs about the Bright Data MCP server (60+ tools): setup, hosted versus self-hosted modes, available tools, token usage and billing for AI agents.

<Card title="Building an AI startup?" href="https://brightdata.com/ai/ai-startups-program" icon="rocket-launch">
  You might be eligible for our Startup Program. Get fully funded access to the infrastructure you're reading about right now (up to \$20K value).
</Card>

<AccordionGroup>
  <Accordion title="What is Bright Data MCP Server?">
    Bright Data MCP (Model Context Protocol) is a server that enables LLMs, AI agents, and applications to access, discover, and extract web data in real-time. \
    It allows MCP clients like Claude Desktop, Cursor, and Windsurf to search the web, navigate websites, take actions, and retrieve data without getting blocked, making it perfect for web scraping tasks.\\

    * New MCP users get a **free tier** with 5,000 requests per month

    The MCP server provides advanced capabilities, including:

    * Bypassing geo-restrictions to access content regardless of location
    * Navigating websites with bot detection protection using unlocker technology
    * Structured data extraction from platforms like Amazon, LinkedIn, Instagram, and many other data feeds
    * Remote browser automation for complex web interactions
    * Access to a global IP network to avoid blocking or rate limiting

    **Get started with Bright Data MCP:**

    1. [**Explore the MCP GitHub repository**](https://github.com/brightdata/brightdata-mcp) to review the source code, contribute, or deploy your own instance.
    2. [**Read the MCP documentation**](/ai/mcp-server/overview) to understand the API, request structure, and supported features.
    3. [Get your API key](https://brightdata.com/cp/setting/users)
    4. [**Try the Bright Data AI Playground**](https://brightdata.com/ai/playground-chat) to test and experiment with live requests in a no-code environment.
  </Accordion>

  <Accordion title="Are there limitations for the Bright Data free tier?">
    Yes, the free tier includes up to 5,000 requests per month for web search and web page scraping via Web Unlocker.
  </Accordion>

  <Accordion title="Where do I get my API keys?">
    You can get your API token from the [user settings page](https://brightdata.com/cp/setting/users) in your Bright Data account. Make sure you have an account on [brightdata.com](https://brightdata.com) - new users get free credit for testing, and pay-as-you-go options are available after that.
  </Accordion>

  <Accordion title="Do I need a username to use the MCP server?">
    No. The Bright Data MCP server only requires an API token, for both the remote (hosted) and local (self-hosted) setup. Usernames (format: `brd-customer-{customer_id}-zone-{zone_name}`) are only used for native proxy access and are not needed for MCP, SDK or API integrations.

    If a third-party tool or integration asks for a username, you can leave it empty or check whether it is actually configuring proxy access.
  </Accordion>

  <Accordion title="How do I use Bright Data MCP Server?">
    Bright Data MCP (Model Context Protocol) is a server that allows AI agents, LLMs, and dev tools to access and extract real-time web data using Bright Data’s infrastructure. It is available as both a [remote (hosted)](/ai/mcp-server/remote/quickstart) and [local (self-hosted)](/ai/mcp-server/local/quickstart) server.

    To get started: [**BrightData MCP Overview**](/ai/mcp-server/overview)

    **Helpful links:**

    * [MCP GitHub Repository](https://github.com/brightdata/brightdata-mcp)
    * [MCP Documentation](/ai/mcp-server/overview)
    * [Try MCP in the AI Playground](https://brightdata.com/ai/playground-chat)
  </Accordion>

  <Accordion title="What can I do with Bright Data MCP Server?">
    Bright Data MCP allows you to integrate real-time web access into your AI agents or dev tools. It supports:

    **Search & Scraping:**

    * `search_engine`: Search Google, Bing, Yandex
    * `scrape_as_markdown`, `scrape_as_html`: Get content in clean formats
    * `session_stats`: Monitor tool usage

    **Structured Data Extraction:**

    * Amazon: `web_data_amazon_product`, `web_data_amazon_product_reviews`
    * LinkedIn: `web_data_linkedin_person_profile`, `web_data_linkedin_company_profile`
    * Instagram: `web_data_instagram_profiles`, `web_data_instagram_posts`, `web_data_instagram_reels`
    * Facebook: `web_data_facebook_posts`, `web_data_facebook_marketplace_listings`
    * Others: `web_data_x_posts`, `web_data_youtube_videos`, `web_data_zillow_properties_listing`

    **Browser Automation:**

    * `scraping_browser_navigate`, `scraping_browser_click`, `scraping_browser_type`
    * `scraping_browser_get_html`, `scraping_browser_screenshot`, `scraping_browser_wait_for`

    **🔗 Full list of tools:** [MCP Tools on GitHub](https://github.com/brightdata-com/brightdata-mcp/blob/main/assets/Tools.md)
  </Accordion>

  <Accordion title="Which AI agents and tools can integrate with Bright Data MCP Server?">
    Bright Data MCP is designed to work with a wide range of AI tools and agents, including:

    * **Claude Desktop** (Anthropic)
    * **Cursor IDE**
    * **Windsurf**
    * **LangChain**
    * **AutoGPT / AgentGPT**
    * **Smithery**
    * **Custom LLMs or AI agents** that support MCP

    These tools can use MCP to:

    * Perform real-time web searches
    * Scrape structured data
    * Automate browser interactions
    * Access geo-restricted or protected content

    Try it live: [Bright Data AI Playground](https://brightdata.com/ai/playground-chat)
  </Accordion>

  <Accordion title="How do I enable browser control tools?">
    All you need is your Bright Data API key, the MCP server automatically creates and configures the required browser zone for you.

    To access browser tools, enable them using one of these methods:

    * **Pro mode:** Set `&pro=1` (remote) or `PRO_MODE=true` (self-hosted) to enable all tools, including browser automation
    * **Tool groups:** Set `&groups=browser` (remote) or `GROUPS=browser` (self-hosted) to enable just the browser automation tools

    For example, with the remote MCP:

    ```http theme={null}
    https://mcp.brightdata.com/sse?token=YOUR_API_TOKEN&groups=browser
    ```

    See the [Remote Advanced Configuration](/ai/mcp-server/remote/advanced) or [Local Advanced Configuration](/ai/mcp-server/local/advanced) for more details.
  </Accordion>

  <Accordion title="What tools are available in the Bright Data MCP Server?">
    For the full list of tools, please refer to our GitHub repo: [MCP Tools](https://github.com/brightdata-com/brightdata-mcp/blob/main/assets/Tools.md).

    Bright Data MCP offers a comprehensive set of tools, including:

    **Search and basic scraping:**

    * `search_engine`: Scrape search results from Google, Bing, or Yandex
    * `scrape_as_markdown`: Scrape a webpage and get results in Markdown format
    * `scrape_as_html`: Scrape a webpage and get results in HTML format
    * `session_stats`: View tool usage during the current session

    **Structured data extraction:**

    * Amazon: `web_data_amazon_product`, `web_data_amazon_product_reviews`
    * LinkedIn: `web_data_linkedin_person_profile`, `web_data_linkedin_company_profile`
    * ZoomInfo: `web_data_zoominfo_company_profile`
    * Instagram: `web_data_instagram_profiles`, `web_data_instagram_posts`, `web_data_instagram_reels`, `web_data_instagram_comments`
    * Facebook: `web_data_facebook_posts`, `web_data_facebook_marketplace_listings`, `web_data_facebook_company_reviews`
    * Various others: `web_data_x_posts`, `web_data_zillow_properties_listing`, `web_data_booking_hotel_listings`, `web_data_youtube_videos`

    **Browser automation:**

    * `scraping_browser_navigate`: Navigate to a URL
    * `scraping_browser_go_back`/`scraping_browser_go_forward`: Navigate browser history
    * `scraping_browser_click`: Click on an element
    * `scraping_browser_links`: Get all links on the current page
    * `scraping_browser_type`: Type text into an element
    * `scraping_browser_wait_for`: Wait for an element to appear
    * `scraping_browser_screenshot`: Take a screenshot
    * `scraping_browser_get_html`/`scraping_browser_get_text`: Get page content
  </Accordion>

  <Accordion title="How do I handle timeout issues when using Bright Data MCP Server?">
    Some web data tools can take longer to execute, especially when dealing with complex websites. To ensure your agent can consume the data:

    1. Set a high enough timeout in your agent settings (180 seconds is recommended)
    2. For particularly slow sites, you may need to increase this value further
    3. Use the specialized `web_data_*` tools when available, as they're often faster than general scraping
    4. For browser automation sequences, keep operations close together in time
  </Accordion>

  <Accordion title="What security considerations should I keep in mind?">
    Always treat scraped web content as untrusted data. Never use raw scraped content directly in LLM prompts to avoid potential prompt injection risks. Instead:

    * Filter and validate all web data before passing it to the LLM
    * Use structured data extraction rather than raw text when possible
    * Be cautious with executing JavaScript from scraped content
  </Accordion>

  <Accordion title="Why am I getting a 'spawn npx ENOENT' error?">
    This error occurs when your system cannot find the `npx` command. To fix it:

    1. Find your Node.js path:
       * On macOS: Run `which node` in Terminal
       * On Windows: Run `where node` in Command Prompt
    2. Update your MCP configuration to use the full path instead of `npx`:

    ```json theme={null}
    {
      "mcpServers": {
        "Bright Data": {
          "command": "/usr/local/bin/node", // Replace with your actual Node.js path
          "args": ["node_modules/@brightdata/mcp/index.js"],
          "env": {
            "API_TOKEN": "<your-api-token>"
          }
        }
      }
    }
    ```
  </Accordion>

  <Accordion title="How do I monitor my usage and costs?">
    You can use the `session_stats` tool to check your usage during the current session. For comprehensive usage tracking and billing information, log in to your Bright Data account dashboard. The `session_stats` tool will show you information about:

    * Number of requests made during the current session
    * Tools used and their frequency
  </Accordion>

  <Accordion title="Is there a playground where I can try Bright Data MCP Server?">
    Yes, you can try Bright Data MCP without any setup using the [Bright Data AI Playground](https://brightdata.com/ai/playground-chat). It provides an easy way to explore the capabilities of Bright Data MCP without any local setup. Just sign in and start experimenting with web data collection!
  </Accordion>

  <Accordion title="How do I connect my AI agent with Bright Data's MCP?">
    You can connect your AI agent with Bright Data by following these steps:

    1. Install [Node.js](https://nodejs.org/en/download) (only required for the self-hosted option)
    2. Create a [Bright Data account](https://brightdata.com/?hs_signup=1\&utm_source=docs) (new users get free credit for testing)
    3. Copy your API key from the [user settings page](https://brightdata.com/cp/setting/users) (new users receive an **API key** in the welcome email)
    4. Configure your agent with your API key. For more detailed examples, visit us on [GitHub](https://github.com/brightdata/brightdata-mcp?tab=readme-ov-file#-usage-examples) or check our [MCP documentation](/ai/mcp-server/overview#configuration).
  </Accordion>

  <Accordion title="When using MCP, should I create zones or configure them?">
    No, zones are created automatically for you. All you need is Node.js (for self-hosted) and your Bright Data API key. If you want to change your zone name to something specific, you can always do so through the [control panel](https://brightdata.com/cp/zones).
  </Accordion>

  <Accordion title="Is there a free access tier for the Bright Data MCP?">
    Yes! Bright Data provides a free tier of **5,000 requests/month** to new MCP users. The free tier includes web search and web page scraping via Web Unlocker. See [What is the MCP free tier?](#) below for more details.
  </Accordion>

  <Accordion title="What is the MCP free tier?">
    The MCP free tier allows you to connect your AI agent via MCP (Model Context Protocol) to Bright Data services for free.
    You get up to 5,000 requests per month for web search and scraping any public webpage via Web Unlocker at no cost. This is ideal for testing, development, or light usage.

    The MCP free tier is not a separate grant. It is the same account-level [free tier](/general/account/billing-and-pricing/free-tier) of 5,000 credits per month, drawn from a single shared pool, because the MCP server runs on the Web Unlocker API.

    For more information, see the [Remote MCP Quickstart](/ai/mcp-server/remote/quickstart).
  </Accordion>

  <Accordion title="What happens when the free tier limit is reached?">
    When you exceed the 5,000 monthly request limit on the free tier, requests will start failing. To continue using the MCP server, you need to create a new Web Unlocker zone and configure the MCP to use it:

    1. Go to [brightdata.com/cp](https://brightdata.com/cp) and click **Add** (top-right)
    2. Select **Unlocker zone** and create it with any name (e.g., `my_unlocker`)
    3. Update your MCP configuration to use the new zone:
       * **Remote MCP:** Add `&unlocker=ZONE_NAME` to your MCP URL
       * **Self-hosted MCP:** Set the `WEB_UNLOCKER_ZONE=ZONE_NAME` environment variable
    4. Restart your MCP client (e.g., Claude Desktop, Cursor) after the configuration change
  </Accordion>

  <Accordion title="Can I run multiple MCP instances in parallel?">
    Yes, you can run multiple MCP instances for parallelized workloads. However, if you are using the self-hosted (local) MCP with `npx`, each instance downloads and caches the package separately, which can consume significant disk space.

    For parallel use cases, we recommend using the **Remote MCP** instead. It requires no local installation, runs entirely in the cloud, and eliminates disk space concerns. Simply point each instance to the remote endpoint:

    ```http theme={null}
    https://mcp.brightdata.com/sse?token=YOUR_API_TOKEN
    ```

    See the [Remote MCP Quickstart](/ai/mcp-server/remote/quickstart) for setup instructions.
  </Accordion>
</AccordionGroup>


# Agent Builder MCP server integration
Source: https://docs.brightdata.com/ai/mcp-server/integrations/agent-builder

Connect OpenAI Agent Builder to the Bright Data MCP server (60+ tools) to build AI agents with real-time web search, scraping and structured data access.

<Card title="Building an AI startup?" href="https://brightdata.com/ai/ai-startups-program" icon="rocket-launch">
  You might be eligible for our Startup Program. Get fully funded access to the infrastructure you're reading about right now (up to \$20K value).
</Card>

**Requirements:**

* [Bright Data account](https://brightdata.com/?hs_signup=1\&utm_source=docs)
* OpenAI Account with a [verified organization](https://help.openai.com/en/articles/10910291-api-organization-verification)

<Steps>
  <Step title="Create a new flow">
    Go to [Agent Builder](https://platform.openai.com/agent-builder) and create a new flow

    <img alt="Agent Builder MCP Server Integration" />
  </Step>

  <Step title="Click on the agent node">
    <img alt="Agent Builder MCP Server Integration" />

    After clicking the agent node, the agent configuration panel will appear on the left side of the screen.
  </Step>

  <Step title="Click on Tools to add the MCP">
    <img alt="Agent Builder MCP Server Integration" />
  </Step>

  <Step title="Choose MCP and add the Web MCP server">
    Copy and paste the following URL into the URL section:

    ```http theme={null}
    https://mcp.brightdata.com/mcp?token=YOUR_API_KEY
    ```

    Replace `YOUR_API_KEY` with your actual Bright Data API key.

    <Note>
      You can copy this URL with a pre-filled API key from your [control panel](https://brightdata.com/cp/mcp)
    </Note>

    Then click the Connect button.

    <img alt="Agent Builder MCP Server Integration" />
  </Step>

  <Step title="Choose your preferred tools and add them">
    Here you can choose the relevant tools you want to expose to the agent, or add all of them by clicking the Add button.

    <img alt="Agent Builder MCP Server Integration" />
  </Step>

  <Step title="Configure your agent with a name and instructions">
    Give your agent a name, provide an instruction set, choose the reasoning effort level, and click the Preview button to test it.

    <img alt="Agent Builder MCP Server Integration" />
  </Step>

  <Step title="Test your agent">
    Ask your agent any question that requires real-time web data and get an instant answer.

    <img alt="Screenshot 2025-10-10 at 10.52.31.png" />
  </Step>
</Steps>


# OpenAI's ChatGPT MCP server integration
Source: https://docs.brightdata.com/ai/mcp-server/integrations/chat-gpt

Connect ChatGPT to the Bright Data MCP server to give your custom GPTs real-time web search, scraping and structured data access in a few setup steps.

<Card title="Building an AI startup?" href="https://brightdata.com/ai/ai-startups-program" icon="rocket-launch">
  You might be eligible for our Startup Program. Get fully funded access to the infrastructure you're reading about right now (up to \$20K value).
</Card>

**Requirements:**

* [Bright Data account](https://brightdata.com/?hs_signup=1\&utm_source=docs)
* OpenAI account

<Steps>
  <Step title="Add a new source">
    Go to [ChatGPT](https://chatgpt.com/) and click the "+" button to add a new source.

    <img alt="OpenAI's ChatGPT MCP Server Integration" />
  </Step>

  <Step title="Connect more">
    Click the "Add" button, then select "Connect more".

    <img alt="OpenAI's ChatGPT MCP Server Integration" />
  </Step>

  <Step title="Advanced settings">
    Click on "Advanced settings", enable Developer Mode, then click "Create app".

    <img alt="OpenAI's ChatGPT MCP Server Integration" />
  </Step>

  <Step title="Connect Bright Data MCP">
    Click "Create app" and fill in the following details:

    * **App name**
    * **MCP Server URL:**

    ```http theme={null}
    https://mcp.brightdata.com/mcp?token=<your_api_token>
    ```

    * **Authentication: no authentication**

    Here is how it should look like:

    <img alt="OpenAI's ChatGPT MCP Server Integration" />
  </Step>

  <Step title="Unlock the web">
    Tag Bright Data MCP and chat with the open web without getting blocked!

    <img alt="OpenAI's ChatGPT MCP Server Integration" />
  </Step>
</Steps>


# Claude Desktop integration
Source: https://docs.brightdata.com/ai/mcp-server/integrations/claude

Connect Claude Desktop to the Bright Data MCP server to give Claude real-time web search, scraping and structured data access. Exposes 60+ tools.

<Card title="Building an AI startup?" href="https://brightdata.com/ai/ai-startups-program" icon="rocket-launch">
  You might be eligible for our Startup Program. Get fully funded access to the infrastructure you're reading about right now (up to \$20K value).
</Card>

**Getting Started Video**:

<iframe title="Easiest way to start with Claude" />

## Hosted MCP

<Steps>
  <Step title="Get your API token">
    1. Go to [Bright Data user settings](https://brightdata.com/cp/setting/users)
    2. Copy your API token (it looks like: `2dceb1aa0***************************`)
  </Step>

  <Step title="Configure your MCP server">
    1. Open Claude Desktop
    2. Go to: Settings → Developer → Edit Config
    3. Add this to your `claude_desktop_config.json`:

    ```json theme={null}
    {
      "mcpServers": {
        "Bright Data": {
          "command": "npx",
          "args": [
            "mcp-remote",
            "https://mcp.brightdata.com/mcp?token=YOUR_API_TOKEN_HERE"
          ]
        }
      }
    }
    ```

    4. **`Replace YOUR_API_TOKEN_HERE`** with your actual API token from Step 1
    5. Save and restart Claude Desktop
  </Step>

  <Step title="Test it works">
    1. Ask your AI: "Can you search Google for 'weather today'?"
    2. Claude will ask for permission - click "Allow"
    3. You should see results!
  </Step>

  <Step title="Monitor usage">
    1. View your API usage at [My Zones](https://brightdata.com/cp/zones) in your Bright Data dashboard
    2. Your free tier includes 5,000 requests per month
  </Step>
</Steps>

## Self-hosted MCP

<Steps>
  <Step title="Prerequisites">
    Before you begin, ensure you have the following:

    * [Node.js ](https://nodejs.org/en/download) is installed and up to date
    * [A Bright Data account](https://brightdata.com/?hs_signup=1\&utm_source=docs)  (new users get free credit for testing, and then you can pay as you go)
    * **An API key** from the [user settings page](https://brightdata.com/cp/setting/users) (New users receive an **API key** in the welcome email.)

    <Tip>
      If you prefer to use a different zone name, you can specify it with the `WEB_UNLOCKER_ZONE `environment variable in your configuration
    </Tip>
  </Step>

  <Step title="Basic Configuration">
    Go to Claude -> Settings -> Developer -> Edit Config -> `claude_desktop_config.json` to include the following:

    ```json expandable theme={null}
    {
      "mcpServers": {
        "Bright Data": {
          "command": "npx",
          "args": ["@brightdata/mcp"],
          "env": {
            "API_TOKEN": "<insert your api key from https://brightdata.com/cp/setting/users>"     
          }
        }
      }
    }
    ```
  </Step>

  <Step title="Advanced Configuration">
    If you want to use advanced features like rate limiting or custom zones, you can add more environment variables:

    ```json expandable theme={null}
    {
      "mcpServers": {
        "Bright Data": {
          "command": "npx",
          "args": ["@brightdata/mcp"],
          "env": {
            "API_TOKEN": "<insert your api key from https://brightdata.com/cp/setting/users>",
            "WEB_UNLOCKER_ZONE": "<Optional - if you want to use a specific name for web_unlocker, the name goes here. If not - REMOVE this field>",
            "BROWSER_ZONE": "<Optional - if you want to use a specific name for browser_api, the name goes here. If not - REMOVE this field>",
            "RATE_LIMIT": "<Optional - rate limit format, possible values: limit/time+unit, e.g., 100/1h, 50/30m, 10/5s. If not in use - REMOVE this field>",
            "PRO_MODE": "<Optional - set to true to enable all 60+ tools>",
            "GROUPS": "<Optional - comma-separated tool groups, e.g., browser,ecommerce,social>",
            "TOOLS": "<Optional - comma-separated individual tool names to enable>"
          }
        }
      }
    }
    ```
  </Step>
</Steps>


# Claude Code MCP server integration
Source: https://docs.brightdata.com/ai/mcp-server/integrations/claude-code

Connect Claude Code to the Bright Data MCP server (60+ tools) with a 1-line install command to give your coding agent real-time web search and scraping.

<Card title="Building an AI startup?" href="https://brightdata.com/ai/ai-startups-program" icon="rocket-launch">
  You might be eligible for our Startup Program. Get fully funded access to the infrastructure you're reading about right now (up to \$20K value).
</Card>

## Quick Install

To integrate Bright Data into Claude Code, simply copy this command to your terminal:

```bash theme={null}
claude mcp add --transport sse brightdata "https://mcp.brightdata.com/sse?token=<your-api-token>"
```

## Self-hosted MCP

<Steps>
  <Step title="Prerequisites">
    Before you begin, ensure you have the following:

    * [Claude Code](https://docs.anthropic.com/en/docs/claude-code) is installed and configured
    * [A Bright Data account](https://brightdata.com/?hs_signup=1\&utm_source=docs) (new users get free credit for testing, and then you can pay as you go)
    * **An API key** from the [user settings page](https://brightdata.com/cp/setting/users) (New users receive an **API key** in the welcome email.)

    <Tip>
      If you prefer to use a different zone name, you can specify it with the `unlocker` url parameter variable in your configuration
    </Tip>
  </Step>

  <Step title="Basic Configuration">
    Add the Bright Data MCP server to your Claude Code configuration:

    ```bash theme={null}
    claude mcp add --transport sse brightdata https://mcp.brightdata.com/sse?token=<your-api-token>
    ```

    Replace `<your-api-token>` with your actual API token from Bright Data.
  </Step>

  <Step title="Validation">
    Verify the integration by running:

    ```bash theme={null}
    claude mcp list
    ```

    You should see the following output confirming successful connection:

    ```text theme={null}
    brightdata: https://mcp.brightdata.com/sse?token=<yourapikey>(SSE) - ✓ Connected
    ```
  </Step>
</Steps>


# Cloudflare Agents SDK integration
Source: https://docs.brightdata.com/ai/mcp-server/integrations/cloudflare-agents

How to integrate Cloudflare's Agents SDK with Bright Data's Web MCP server for building AI agents on Cloudflare Workers. Exposes 60+ MCP tools.

<Card title="Building an AI startup?" href="https://brightdata.com/ai/ai-startups-program" icon="rocket-launch">
  You might be eligible for our Startup Program. Get fully funded access to the infrastructure you're reading about right now (up to \$20K value).
</Card>

## Hosted MCP

<Steps>
  <Step title="Get your API token">
    1. Go to [Bright Data user settings](https://brightdata.com/cp/setting/users)
    2. Copy your API token (it looks like: `2dceb1aa0***************************`)
  </Step>

  <Step title="Set up your Cloudflare environment">
    Make sure you have Node.js 20+ installed, then log in to Cloudflare:

    ```shell theme={null}
    npx wrangler login
    ```
  </Step>

  <Step title="Install the Agents Starter template">
    ```shell theme={null}
    npx create-cloudflare@latest mcp-demo --template cloudflare/agents-starter
    cd mcp-example
    npm install
    ```
  </Step>

  <Step title="Configure environment variables">
    Copy the example env file and add your OpenAI API key:

    ```shell theme={null}
    cp .dev.vars.example .dev.vars
    ```

    Edit `.dev.vars`:

    ```env theme={null}
    OPENAI_API_KEY=sk-...
    ```
  </Step>

  <Step title="Connect Bright Data MCP in your agent">
    In `src/server.ts`, find the default commented-out MCP connection inside `onChatMessage`:

    ```ts theme={null}
    // const mcpConnection = await this.mcp.connect(
    //   "https://path-to-mcp-server/sse"
    // );
    ```

    Replace it with the Bright Data MCP connection:

    ```ts expandable theme={null}
    // Connect to Bright Data MCP server
    const mcpConnection = await this.mcp.connect(
      "https://mcp.brightdata.com/mcp?token=<API_TOKEN>"
    );

    // Merge MCP tools with local tools
    const allTools = {
      ...tools,
      ...this.mcp.getAITools()
    };
    ```

    <Note>
      Make sure `mcp.connect()` is called **before** `this.mcp.getAITools()` to avoid `jsonSchema not initialized` errors.
    </Note>
  </Step>

  <Step title="Test it works">
    1. Replace `<API_TOKEN>` with your actual Bright Data API token
    2. Start the development server:

    ```shell theme={null}
    npm start
    ```

    3. Open the app in your browser and ask the agent a question, for example:

    ```text theme={null}
    Find the latest 3 news items about Cloudflare Agents and summarize them in bullets with links.
    ```

    You should see the agent use Bright Data's web scraping tools to fetch and summarize live results:

    <img alt="Hosted MCP" />
  </Step>

  <Step title="Monitor usage">
    1. View your API usage at [My Zones](https://brightdata.com/cp/zones) in your Bright Data dashboard
    2. Your free tier includes 5,000 requests per month
  </Step>
</Steps>


# Codex MCP server integration
Source: https://docs.brightdata.com/ai/mcp-server/integrations/codex

Connect OpenAI Codex CLI to the Bright Data MCP server (60+ tools) via config.toml or the codex mcp add command for real-time web search and scraping.

<Card title="Building an AI startup?" href="https://brightdata.com/ai/ai-startups-program" icon="rocket-launch">
  You might be eligible for our Startup Program. Get fully funded access to the infrastructure you're reading about right now (up to \$20K value).
</Card>

Add the Bright Data MCP server to OpenAI's Codex CLI so your coding agent can search, scrape and browse the live web without getting blocked. Codex reads MCP server definitions from `~/.codex/config.toml`, which you can edit directly or update with the `codex mcp add` command.

## Prerequisites

* [Codex CLI](https://github.com/openai/codex) is installed and signed in
* [Node.js](https://nodejs.org/en/download) is installed and up to date (required only for the self-hosted server)
* [A Bright Data account](https://brightdata.com/?hs_signup=1\&utm_source=docs) (new users get free credit for testing, and then you can pay as you go)
* An API key from the [user settings page](https://brightdata.com/cp/setting/users) (new users receive an API key in the welcome email)

## Hosted MCP

The hosted server needs no local install. Add the following table to `~/.codex/config.toml`, replacing `<your-api-token>` with your Bright Data API key:

```toml theme={null}
[mcp_servers.brightdata]
url = "https://mcp.brightdata.com/mcp?token=<your-api-token>"
```

The `[mcp_servers.<id>]` table uses `url` for streamable HTTP servers. The Bright Data hosted MCP accepts the API key as the `token` query parameter, so no separate authentication header is required.

<Tip>
  If you prefer to use a different zone name, specify it with the `unlocker` URL parameter, for example `...?token=<your-api-token>&unlocker=<your-zone>`.
</Tip>

## Self-hosted MCP

The self-hosted server runs locally through `npx` and reads your API key from an environment variable.

<Steps>
  <Step title="Add the server with the CLI">
    Run the following command in your terminal. The `--` separator tells Codex where the environment flags end and the server command begins:

    ```bash theme={null}
    codex mcp add brightdata --env API_TOKEN=<your-api-token> -- npx -y @brightdata/mcp
    ```
  </Step>

  <Step title="Or edit config.toml directly">
    Alternatively, add this table to `~/.codex/config.toml`:

    ```toml theme={null}
    [mcp_servers.brightdata]
    command = "npx"
    args = ["-y", "@brightdata/mcp"]

    [mcp_servers.brightdata.env]
    API_TOKEN = "<your-api-token>"
    ```
  </Step>
</Steps>

## Validation

Verify the integration by listing the configured MCP servers:

```bash theme={null}
codex mcp list
```

You should see `brightdata` in the output, confirming the server is configured. Start a Codex session and ask it to fetch a live web page to confirm the tools respond.


# CrewAI integration
Source: https://docs.brightdata.com/ai/mcp-server/integrations/crewai

Connect CrewAI multi-agent crews to the Bright Data MCP server, using either the hosted endpoint or self-hosted mode for real-time web data access.

<Card title="Building an AI startup?" href="https://brightdata.com/ai/ai-startups-program" icon="rocket-launch">
  You might be eligible for our Startup Program. Get fully funded access to the infrastructure you're reading about right now (up to \$20K value).
</Card>

## Hosted MCP

<Steps>
  <Step title="Get your API token">
    1. Go to [Bright Data user settings](https://brightdata.com/cp/setting/users)
    2. Copy your API token (it looks like: `2dceb1aa0***************************`)
  </Step>

  <Step title="Configure your MCP server">
    ```python expandable theme={null}
    from crewai import Agent, Task, Crew
    from crewai_tools import MCPServerAdapter
    import os


    server_params = {
        "url": "https://mcp.brightdata.com/sse?token=API_TOKEN",
        "transport": "sse"
    }

    try:
        with MCPServerAdapter(server_params) as mcp_tools:
            print(f"Available tools: {[tool.name for tool in mcp_tools]}")
            
            my_agent = Agent(
                role="Web Scraping Specialist",
                goal="Extract data from websites using Bright Data tools",
                backstory="I am an expert at web scraping and data extraction using MCP tools.",
                tools=mcp_tools,
                verbose=True,
                llm="gpt-4o-mini",
            )
            
            task = Task(
                description="Search for flights from New York to San Francisco and provide a summary of what you found. Use the search_engine tool to find flight information and return the results in a clear format.",
                expected_output="A clear summary of available flights from New York to San Francisco, including key details like airlines, times, and prices if available.",
                agent=my_agent
            )
            
            crew = Crew(
                agents=[my_agent],
                tasks=[task],
                verbose=True
            )
            
            result = crew.kickoff()
            print("\n=== RESULT ===")
            print(result)
            
    except Exception as e:
        print(f"Error connecting to MCP server: {e}")
        print("Make sure you have:")
        print("1. Set your BRIGHT_DATA_API_KEY environment variable")
        print("2. Installed the Bright Data MCP server: npm install -g @bright_data/ai/mcp-server-bright-data")
        print("3. Have Node.js installed on your system")
    ```
  </Step>

  <Step title="Test it works">
    1. Run your CrewAI script with the flight search task
    2. The agent will use Bright Data tools to search for flight information
    3. You should see results with flight details
  </Step>

  <Step title="Monitor usage">
    1. View your API usage at [My Zones](https://brightdata.com/cp/zones) in your Bright Data dashboard
    2. Your free tier includes 5,000 requests per month
  </Step>
</Steps>


# Cursor MCP server integration
Source: https://docs.brightdata.com/ai/mcp-server/integrations/cursor

Connect Cursor IDE to the Bright Data MCP server (60+ tools) in either hosted or self-hosted mode, for AI coding assistant web search and scraping.

<Card title="Building an AI startup?" href="https://brightdata.com/ai/ai-startups-program" icon="rocket-launch">
  You might be eligible for our Startup Program. Get fully funded access to the infrastructure you're reading about right now (up to \$20K value).
</Card>

## Self-hosted MCP

<Steps>
  <Step title="Prerequisites">
    Before you begin, ensure you have the following:

    * [Node.js ](https://nodejs.org/en/download) is installed and up to date
    * [A Bright Data account](https://brightdata.com/?hs_signup=1\&utm_source=docs)  (new users get free credit for testing, and then you can pay as you go)
    * **An API key** from the [user settings page](https://brightdata.com/cp/setting/users) (New users receive an **API key** in the welcome email.)

    <Tip>
      If you prefer to use a different zone name, you can specify it with the `WEB_UNLOCKER_ZONE `environment variable in your configuration
    </Tip>
  </Step>

  <Step title="Basic Configuration">
    Go to Cursor -> Click the gear icon -> Tools & Integrations -> Add Custom MCP -> include the following:

    ```json expandable theme={null}
    {
        "mcpServers": {
        "brightdata-mcp": {
            "command": "npx",
            "args": ["-y", "@brightdata/mcp"],
            "env": {
            "API_TOKEN": "<your API token>"
            }
        }
        }
    }
    ```

    <Frame>
      <img alt="Screenshot 2025-07-14 at 13.50.57.png" title="Screenshot 2025-07-14 at 13.50.57.png" />
    </Frame>

    Then you need to see:

    <Frame>
      <img alt="Screenshot 2025-07-14 at 14.18.16.png" title="Screenshot 2025-07-14 at 14.18.16.png" />
    </Frame>
  </Step>
</Steps>


# Google ADK integration
Source: https://docs.brightdata.com/ai/mcp-server/integrations/google-adk

Connect Google Agent Development Kit (ADK) to the Bright Data MCP server (60+ tools) for Gemini-powered agents with web search and structured extraction.

<Card title="Building an AI startup?" href="https://brightdata.com/ai/ai-startups-program" icon="rocket-launch">
  You might be eligible for our Startup Program. Get fully funded access to the infrastructure you're reading about right now (up to \$20K value).
</Card>

## Remote MCP

<Steps>
  <Step title="Get your API token">
    1. Go to [Bright Data user settings](https://brightdata.com/cp/setting/users)
    2. Copy your API token (it looks like: `2dceb1aa0***************************`)
  </Step>

  <Step title="Install required packages">
    ```shell theme={null}
    pip install google-adk
    ```
  </Step>

  <Step title="Configure your MCP server">
    ```python expandable theme={null}
    from google.adk.agents import Agent
    from google.adk.tools.mcp_tool.mcp_session_manager import StreamableHTTPServerParams
    from google.adk.tools.mcp_tool.mcp_toolset import MCPToolset

    BRIGHTDATA_API_TOKEN = "YOUR_BRIGHTDATA_API_TOKEN"

    root_agent = Agent(
    model="gemini-2.5-pro",
    name="brightdata_agent",
    instruction="""Help users access web data using Bright Data""",
    tools=[
        MCPToolset(
            connection_params=StreamableHTTPServerParams(
                url=f"https://mcp.brightdata.com/mcp?token={BRIGHTDATA_API_TOKEN}",
            ),
        )
    ],
    )
    ```
  </Step>

  <Step title="Set up environment variables (optional)">
    For better security, you can store your API token as an environment variable:

    ```python theme={null}
    import os
    BRIGHTDATA_API_TOKEN = os.getenv("BRIGHTDATA_API_TOKEN")
    ```

    Then create a `.env` file in your project directory:

    ```env theme={null}
    BRIGHTDATA_API_TOKEN=your_brightdata_api_token_here
    ```
  </Step>

  <Step title="Test it works">
    1. Replace `YOUR_BRIGHTDATA_API_TOKEN` with your actual Bright Data API token
    2. Run your Google ADK script
    3. You should see the agent execute web searches and provide comprehensive responses
  </Step>

  <Step title="Monitor usage">
    1. View your API usage at [My Zones](https://brightdata.com/cp/zones) in your Bright Data dashboard
    2. Your free tier includes 5,000 requests per month
  </Step>
</Steps>

## Local MCP Server

<Steps>
  <Step title="Get your API token">
    1. Go to [Bright Data user settings](https://brightdata.com/cp/setting/users)
    2. Copy your API token (it looks like: `2dceb1aa0***************************`)
  </Step>

  <Step title="Install required packages">
    ```shell theme={null}
    pip install google-genai
    npm install -g @brightdata/mcp
    ```
  </Step>

  <Step title="Configure your local MCP server">
    ```python expandable theme={null}
    from google.adk.agents import Agent
    from google.adk.tools.mcp_tool.mcp_session_manager import StdioConnectionParams
    from google.adk.tools.mcp_tool.mcp_toolset import MCPToolset
    from mcp import StdioServerParameters

    BRIGHTDATA_API_TOKEN = "YOUR_BRIGHTDATA_API_TOKEN"

    root_agent = Agent(
    model="gemini-2.5-pro",
    name="brightdata_agent",
    instruction="Help users access web data using Bright Data",
    tools=[
        MCPToolset(
            connection_params=StdioConnectionParams(
                server_params = StdioServerParameters(
                    command="npx",
                    args=[
                        "@brightdata/mcp",
                    ],
                    env={
                        "API_TOKEN": BRIGHTDATA_API_TOKEN,
                        "PRO_MODE": "true",  # Optional: Enable all 60+ tools
                    }
                ),
                timeout=300,
            ),
        )
    ],
    )
    ```
  </Step>

  <Step title="Test it works">
    1. Replace `YOUR_BRIGHTDATA_API_TOKEN` with your actual Bright Data API token
    2. Run your Google ADK script with the local MCP server
    3. The agent will use the locally installed MCP server to access all available tools
  </Step>

  <Step title="Monitor usage">
    1. View your API usage at [My Zones](https://brightdata.com/cp/zones) in your Bright Data dashboard
    2. Your free tier includes 5,000 requests per month
  </Step>
</Steps>

## Available Tools

The Bright Data MCP server provides access to powerful web scraping capabilities:

* **Rapid Mode (Free Tier)**: 4 essential tools including search, scraping, and extraction
* **Pro Mode**: 60+ additional tools including batch operations, browser automation, and structured data APIs for major platforms

[View complete tool documentation](../tools)

[Visit Google ADK docs ](https://google.github.io/adk-docs/)


# LangChain integration
Source: https://docs.brightdata.com/ai/mcp-server/integrations/langchain

Connect LangChain and LangGraph agents to the Bright Data MCP server to add real-time web search, scraping and structured data tools to your AI workflows.

<Card title="Building an AI startup?" href="https://brightdata.com/ai/ai-startups-program" icon="rocket-launch">
  You might be eligible for our Startup Program. Get fully funded access to the infrastructure you're reading about right now (up to \$20K value).
</Card>

## Hosted MCP

<Steps>
  <Step title="Get your API token">
    1. Go to [Bright Data user settings](https://brightdata.com/cp/setting/users)
    2. Copy your API token (it looks like: `2dceb1aa0***************************`)
  </Step>

  <Step title="Install required packages">
    ```shell theme={null}
    pip install langchain-mcp-adapters
    ```
  </Step>

  <Step title="Configure your MCP server">
    ```python expandable theme={null}
    import asyncio
    from langchain_openai import ChatOpenAI
    from langgraph.prebuilt import create_react_agent
    from langchain_mcp_adapters.client import MultiServerMCPClient
    from dotenv import load_dotenv
    import os

    load_dotenv()

    async def main():
        # Configure MCP client
        client = MultiServerMCPClient({
            "bright_data": {
                "url": "https://mcp.brightdata.com/sse?token=<API_TOKEN>",
                "transport": "sse",
            }
        })

        # Get available tools
        tools = await client.get_tools()
        print("Available tools:", [tool.name for tool in tools])

        # Configure LLM
        llm = ChatOpenAI(
            openai_api_key=os.getenv("OPENROUTER_API_KEY"),
            openai_api_base="https://openrouter.ai/api/v1",
            model_name="moonshotai/kimi-k2"
        )

        # System prompt for web search agent
        system_prompt = """
        You are a web search agent with comprehensive scraping capabilities. Your tools include:
        - **search_engine**: Get search results from Google/Bing/Yandex
        - **scrape_as_markdown**: Extract content from any webpage with bot detection bypass
        - **Structured extractors**: Fast, reliable data from major platforms (Amazon, LinkedIn, Instagram, Facebook, X, TikTok, YouTube, Reddit, Zillow, etc.)
        - **Browser automation**: Navigate, click, type, screenshot for complex interactions

        Guidelines:
        - Use structured web_data_* tools for supported platforms when possible (faster/more reliable)
        - Use general scraping for other sites
        - Handle errors gracefully and respect rate limits
        - Think step by step about what information you need and which tools to use
        - Be thorough in your research and provide comprehensive answers

        When responding, follow this pattern:
        1. Think about what information is needed
        2. Choose the appropriate tool(s)
        3. Execute the tool(s)
        4. Analyze the results
        5. Provide a clear, comprehensive answer
        """

        # Create ReAct agent
        agent = create_react_agent(
            model=llm,
            tools=tools,
            prompt=system_prompt
        )

        # Test the agent
        print("Testing ReAct Agent with available tools...")
        print("=" * 50)

        result = await agent.ainvoke({
            "messages": [("human", "Search for the latest news about AI developments")]
        })

        print("\nAgent Response:")
        print(result["messages"][-1].content)

    if __name__ == "__main__":
        asyncio.run(main())
    ```
  </Step>

  <Step title="Set up environment variables">
    Create a `.env` file in your project directory:

    ```env theme={null}
    OPENROUTER_API_KEY=your_openrouter_api_key_here
    ```
  </Step>

  <Step title="Test it works">
    1. Replace `<API_TOKEN>` with your actual Bright Data API token
    2. Run your LangChain script
    3. You should see the agent execute web searches and provide comprehensive responses
  </Step>

  <Step title="Monitor usage">
    1. View your API usage at [My Zones](https://brightdata.com/cp/zones) in your Bright Data dashboard
    2. Your free tier includes 5,000 requests per month
  </Step>
</Steps>


# LlamaIndex integration
Source: https://docs.brightdata.com/ai/mcp-server/integrations/llamaindex

Connect LlamaIndex agents to the Bright Data MCP server to add live web search, scraping and structured data retrieval to your RAG and indexing pipelines.

<Card title="Building an AI startup?" href="https://brightdata.com/ai/ai-startups-program" icon="rocket-launch">
  You might be eligible for our Startup Program. Get fully funded access to the infrastructure you're reading about right now (up to \$20K value).
</Card>

## Hosted MCP

<Steps>
  <Step title="Get your API token">
    1. Go to [Bright Data user settings](https://brightdata.com/cp/setting/users)
    2. Copy your API token (it looks like: `2dceb1aa0***************************`)
  </Step>

  <Step title="Install LlamaIndex MCP Toolkit ">
    ```shell theme={null}
    pip install llama-index-tools-mcp
    ```
  </Step>

  <Step title="Configure your MCP server">
    ```python expandable theme={null}
    import asyncio
    from llama_index.tools.mcp import BasicMCPClient

    async def main():
        http_client = BasicMCPClient("https://mcp.brightdata.com/mcp?token=<API_TOKEN>")

        # List tools
        tools = await http_client.list_tools()
        print("Tools:", tools)

        # Call a tool
        result = await http_client.call_tool("scrape_as_markdown", {"url":"https://docs.llamaindex.ai/en/stable/examples/tools/mcp/"})
        print("Result:", result)

    asyncio.run(main())

    ```
  </Step>

  <Step title="Test it works">
    1. Run your LlamaIndex script with the manual tool calling
    2. You should see the requested URL in markdown
  </Step>

  <Step title="Monitor usage">
    1. View your API usage at [My Zones](https://brightdata.com/cp/zones) in your Bright Data dashboard
    2. Your free tier includes 5,000 requests per month
  </Step>
</Steps>


# How to set up the Web MCP with n8n
Source: https://docs.brightdata.com/ai/mcp-server/integrations/n8n

Connect the Bright Data MCP server to n8n to build automated, no-code data workflows with web search, scraping and structured extraction nodes.

<Card title="Building an AI startup?" href="https://brightdata.com/ai/ai-startups-program" icon="rocket-launch">
  You might be eligible for our Startup Program. Get fully funded access to the infrastructure you're reading about right now (up to \$20K value).
</Card>

## Overview

This guide explains how to integrate **Bright Data Web MCP** with **n8n** to build automated, AI-driven workflows.

You can connect MCP to n8n in two ways:

1. **Streamable HTTP MCP** – Easiest, cloud-based setup

2. **Self-hosted MCP Client** – Advanced, customizable deployment

Choose the approach that best fits your infrastructure and control requirements.

***

## Streamable HTTP MCP Integration

Streamable HTTP is the **recommended option** for most users.

It requires no local setup and allows n8n AI agents to interact with Bright Data MCP over HTTPS with real-time streaming.

### Requirements

* A **Bright Data account**\
  [https://brightdata.com/?hs\_signup=1\&utm\_source=docs](https://brightdata.com/?hs_signup=1\&utm_source=docs)

* An **API token** from your user settings\
  [https://brightdata.com/cp/setting/users](https://brightdata.com/cp/setting/users)

* An AI-enabled workflow (e.g., an **AI Agent**) in n8n

***

### How to configure remote MCP

1. **Create an AI Agent** in n8n or your preferred AI orchestration platform.

2. **Attach the following components:**

   * A **Chat Model** (e.g., `gpt-4`, `gpt-4o`)

   * An **MCP Client** node

3. **Configure the Remote MCP URL** using your API token:

```text theme={null}
https://mcp.brightdata.com/mcp?token=YOUR_API_TOKEN_HERE
```

4. **Select MCP tools**

   * Expose specific tools explicitly, or

   * Allow the AI agent to choose tools dynamically

Once configured, the AI agent will invoke MCP tools as needed and stream responses in real time back into your workflow.

### When to Use Streamable HTTP

* No-code or low-code automation

* Fast setup with minimal infrastructure

* Cloud-hosted n8n deployments

* Real-time, AI-driven data extraction

***

## Self-hosted MCP Integration (MCP Client – Community Node)

The self-hosted option provides maximum control by running the Bright Data MCP client locally or within your own infrastructure.

This approach is best suited for advanced users who require custom rate limits, isolated environments, or internal networking.

### Requirements

* Node.js installed\
  [https://nodejs.org/en/download](https://nodejs.org/en/download)

* A Bright Data account\
  [https://brightdata.com/?hs\_signup=1\&utm\_source=docs](https://brightdata.com/?hs_signup=1\&utm_source=docs)

* An API token from user settings\
  [https://brightdata.com/cp/setting/users](https://brightdata.com/cp/setting/users)

* n8n with support for community or custom nodes

### How to configure self-hosted MCP

1. **Create an AI Agent** in n8n.

2. **Attach the following components:**

   * A **Chat Model** (e.g., `gpt-4`, `gpt-4o`)

   * **Bright Data MCP Client** (via HTTP or WebSocket)

3. **Configure the MCP client execution settings:**

   | Variable     | Value                                                                                                                                        |
   | ------------ | -------------------------------------------------------------------------------------------------------------------------------------------- |
   | Command      | `npx`                                                                                                                                        |
   | Arguments    | `@brightdata/mcp`                                                                                                                            |
   | Environments | `API_KEY=<api-key>`<br />`WEB_UNLOCKER_ZONE=<unlocker_api_zone_name>`<br />`BROWSER_ZONE=<browser_zone_name>`<br />`RATE_LIMIT=<rate-limit>` |

4. **Example values for RATE\_LIMIT:**

   * `100/1h`
   * `50/30m`
   * `10/5s`

   These limits help control request throughput and prevent overuse of MCP tools.

### When to Use Self-hosted MCP

* Enterprise or regulated environments

* Custom networking or security requirements

* Fine-grained rate limiting

* On-premise or private-cloud n8n deployments

***

## Summary

By integrating Bright Data Web MCP with n8n, you can build powerful AI-driven automation pipelines without writing complex code.

* **Streamable HTTP MCP** → Fastest and simplest setup

* **Self-hosted MCP Client** → Maximum flexibility and control

Both approaches enable AI agents to access Bright Data tools seamlessly, unlocking advanced data workflows at scale.
Bright Data - All in One Platform for Proxies and Web Scraping
Award winning proxy networks, powerful web scrapers, and ready-to-use datasets for download. Welcome to the world's #1 web data platform.


# NVIDIA NeMo Agent Toolkit integration
Source: https://docs.brightdata.com/ai/mcp-server/integrations/nvidia-nemo

Connect the NVIDIA NeMo Agent Toolkit to the Bright Data MCP server (60+ tools) to give NeMo-powered agents web search, scraping and structured data.

<Card title="Building an AI startup?" href="https://brightdata.com/ai/ai-startups-program" icon="rocket-launch">
  You might be eligible for our Startup Program. Get fully funded access to the infrastructure you're reading about right now (up to \$20K value).
</Card>

## Overview

NVIDIA NeMo Agent Toolkit is an open-source framework for building, profiling, and optimizing AI agents and workflows. It provides framework-agnostic architecture, YAML-based configuration, built-in MCP support, and unified monitoring across multi-agent systems.

## Hosted MCP

<Steps>
  <Step title="Get your API token">
    1. Go to [Bright Data user settings](https://brightdata.com/cp/setting/users)
    2. Copy your API token (it looks like: `2dceb1aa0***************************`)
  </Step>

  <Step title="Install NeMo Agent Toolkit">
    ```bash theme={null}
    pip install nvidia-nat[mcp]
    ```
  </Step>

  <Step title="Create workflow configuration">
    Create a file named `brightdata-mcp-config.yml`:

    ```yaml expandable theme={null}
    function_groups:
      brightdata_web:
        _type: mcp_client
        server:
          transport: streamable-http
          url: "https://mcp.brightdata.com/mcp?token=<YOUR_BRIGHTDATA_API_TOKEN>"
        tool_call_timeout: 120  # Increase timeout for web requests
        auth_flow_timeout: 300
        reconnect_enabled: true
        reconnect_max_attempts: 3


    llms:
      nim_llm:
        _type: nim
        model_name: "meta/llama-3.1-8b-instruct"
        temperature: 0.0
        api_key: "${env:NVIDIA_API_KEY}"

    workflow:
      _type: react_agent
      tool_names:
        - brightdata_web
      llm_name: nim_llm
      max_iterations: 10
      verbose: true
    ```

    Replace `YOUR_BRIGHTDATA_API_TOKEN` with your actual token from Step 1.
  </Step>

  <Step title="Set up environment variables">
    ```bash theme={null}
    # Set your NVIDIA API key (for NIM or NGC)
    export NVIDIA_API_KEY="your-nvidia-api-key"
    ```
  </Step>

  <Step title="Verify MCP connection">
    Test the connection to Bright Data's MCP server:

    ```bash theme={null}
    nat mcp client ping --url "https://mcp.brightdata.com/mcp?token=YOUR_BRIGHTDATA_API_TOKEN"
    ```

    Expected output:

    ```text theme={null}
    Successfully connected to MCP server
    Server version: 1.0
    Available tools: 15
    ```
  </Step>

  <Step title="List available tools">
    Inspect the tools provided by Bright Data MCP:

    ```bash theme={null}
    nat mcp client tool list --url "https://mcp.brightdata.com/mcp?token=YOUR_TOKEN"
    ```
  </Step>

  <Step title="Run your first agent">
    Execute the workflow with a query:

    ```bash theme={null}
    nat run --config_file brightdata-mcp-config.yml \
      --input "Search for the latest NVIDIA GPU releases and extract their specifications"
    ```

    The agent will use Bright Data's web scraping tools to search and extract information.
  </Step>

  <Step title="Monitor usage">
    1. View your API usage at [My Zones](https://brightdata.com/cp/zones) in your Bright Data dashboard
    2. Your free tier includes 5,000 requests per month
    3. Monitor tool calls in logs with: `nat run --config_file brightdata-mcp-config.yml`
  </Step>
</Steps>

## Where to learn more

* [NeMo Agent Toolkit Documentation](https://docs.nvidia.com/nemo/agent-toolkit/)
* [NeMo Agent Toolkit GitHub](https://github.com/NVIDIA/NeMo-Agent-Toolkit)
* [Bright Data MCP Documentation](/mcp-server/)


# OpenAI SDK integration
Source: https://docs.brightdata.com/ai/mcp-server/integrations/openai

Connect the OpenAI SDK to the Bright Data MCP server to give GPT-4o and o-series models real-time web search, scraping and structured data access.

<Card title="Building an AI startup?" href="https://brightdata.com/ai/ai-startups-program" icon="rocket-launch">
  You might be eligible for our Startup Program. Get fully funded access to the infrastructure you're reading about right now (up to \$20K value).
</Card>

## Hosted MCP

<Steps>
  <Step title="Get your API token">
    1. Go to [Bright Data user settings](https://brightdata.com/cp/setting/users)
    2. Copy your API token (it looks like: `2dceb1aa0***************************`)
  </Step>

  <Step title="Configure your MCP server">
    ```python expandable theme={null}
    from openai import OpenAI

    client = OpenAI()

    resp = client.responses.create(
      model="gpt-4o",
      tools=[
        {
          "type": "mcp",
          "server_label": "BrightData",
          "server_url": "https://mcp.brightdata.com/sse?token=API_TOKEN",
          "require_approval": "never",
        },
      ],
      input="What is the weather in Paris ?",
    )

    print(resp.output_text)
    ```
  </Step>

  <Step title="Test it works">
    1. Ask your AI: "Can you search Google for 'weather today'?"
    2. Claude will ask for permission - click "Allow"
    3. You should see results!
  </Step>

  <Step title="Monitor usage">
    1. View your API usage at [My Zones](https://brightdata.com/cp/zones) in your Bright Data dashboard
    2. Your free tier includes 5,000 requests per month
  </Step>
</Steps>


# MCP server integrations overview
Source: https://docs.brightdata.com/ai/mcp-server/integrations/overview

Connect Bright Data's MCP server (60+ tools) to AI frameworks and agent tools to give models real-time web access for search, scraping and browsing tasks.

<Card title="Building an AI startup?" href="https://brightdata.com/ai/ai-startups-program" icon="rocket-launch">
  You might be eligible for our Startup Program. Get fully funded access to the infrastructure you're reading about right now (up to \$20K value).
</Card>

## Which MCP integrations are supported

<CardGroup>
  <Card title="Codex" icon="https://mintcdn.com/brightdata/0sd4eqxAli7ENzfc/images/ai/mcp-server/integrations/overview/chat-gpt.png?fit=max&auto=format&n=0sd4eqxAli7ENzfc&q=85&s=1b6248abdcac611fa55723d0f6ee1538" href="/ai/mcp-server/integrations/codex">
    Connect OpenAI Codex CLI to Bright Data for live web search and scraping.
  </Card>

  <Card title="Claude Code" icon="https://mintcdn.com/brightdata/0sd4eqxAli7ENzfc/images/ai/mcp-server/integrations/overview/claude.png?fit=max&auto=format&n=0sd4eqxAli7ENzfc&q=85&s=8903bd9f0f63a1e0592df197ecabeed9" href="/ai/mcp-server/integrations/claude-code">
    Integrate Bright Data with Claude Code for enhanced AI capabilities.
  </Card>

  <Card title="Agent Builder" icon="https://mintcdn.com/brightdata/0sd4eqxAli7ENzfc/images/ai/mcp-server/integrations/overview/agent-builder.png?fit=max&auto=format&n=0sd4eqxAli7ENzfc&q=85&s=90393a5535a08aa4a3709218fca037b1" href="/ai/mcp-server/integrations/agent-builder">
    Build intelligent AI agents with Bright Data and Agent Builder.
  </Card>

  <Card title="Claude Desktop" icon="https://mintcdn.com/brightdata/0sd4eqxAli7ENzfc/images/ai/mcp-server/integrations/overview/claude.png?fit=max&auto=format&n=0sd4eqxAli7ENzfc&q=85&s=8903bd9f0f63a1e0592df197ecabeed9" href="/ai/mcp-server/integrations/claude">
    Enhance your AI applications with Bright Data and Claude Desktop.
  </Card>

  <Card title="CrewAI" icon="https://mintcdn.com/brightdata/0sd4eqxAli7ENzfc/images/ai/mcp-server/integrations/overview/crewai.png?fit=max&auto=format&n=0sd4eqxAli7ENzfc&q=85&s=6ad6da69aeeecbaecdee583ec9cbc54d" href="/ai/mcp-server/integrations/crewai">
    Build and scale AI workflows with Bright Data and CrewAI.
  </Card>

  <Card title="Cursor" icon="https://mintcdn.com/brightdata/0sd4eqxAli7ENzfc/images/ai/mcp-server/integrations/overview/cursor.png?fit=max&auto=format&n=0sd4eqxAli7ENzfc&q=85&s=5f00f45f8da176504434535708dc17c7" href="/ai/mcp-server/integrations/cursor">
    Empower your AI applications with Bright Data and Cursor.
  </Card>

  <Card title="LlamaIndex" icon="https://mintcdn.com/brightdata/0sd4eqxAli7ENzfc/images/ai/mcp-server/integrations/overview/llamaindex.png?fit=max&auto=format&n=0sd4eqxAli7ENzfc&q=85&s=e8db55cd80dc2f130c0f3ea4e87ba82d" href="/ai/mcp-server/integrations/llamaindex">
    Integrate Bright Data with LlamaIndex for enhanced AI capabilities.
  </Card>

  <Card title="n8n" icon="https://mintcdn.com/brightdata/0sd4eqxAli7ENzfc/images/ai/mcp-server/integrations/overview/n8n.png?fit=max&auto=format&n=0sd4eqxAli7ENzfc&q=85&s=b46fb873b2b1bfb12bdc364aead1b3de" href="/ai/mcp-server/integrations/n8n">
    Automate workflows with Bright Data and n8n integration.
  </Card>

  <Card title="LangChain" icon="https://mintcdn.com/brightdata/0sd4eqxAli7ENzfc/images/ai/mcp-server/integrations/overview/langchain.png?fit=max&auto=format&n=0sd4eqxAli7ENzfc&q=85&s=891270e257137b04a2a2de3f376bec4a" href="/ai/mcp-server/integrations/langchain">
    Build intelligent AI agents with Bright Data and LangChain.
  </Card>

  <Card title="Snowflake" icon="https://mintcdn.com/brightdata/0sd4eqxAli7ENzfc/images/ai/mcp-server/integrations/overview/snowflake.png?fit=max&auto=format&n=0sd4eqxAli7ENzfc&q=85&s=a58a5ebc949f6b5a8e01db96e988c06f" href="/ai/mcp-server/integrations/snowflake">
    Integrate live, structured web data directly into your Snowflake data lake workflows.
  </Card>

  <Card title="VS Code" icon="https://mintcdn.com/brightdata/0sd4eqxAli7ENzfc/images/ai/mcp-server/integrations/overview/vscode.png?fit=max&auto=format&n=0sd4eqxAli7ENzfc&q=85&s=ec73515b3aaa501a72eea304dcbea2db" href="/ai/mcp-server/integrations/vscode">
    Enhance your AI applications with Bright Data and VS Code.
  </Card>

  <Card title="Vapi AI" icon="https://mintcdn.com/brightdata/0sd4eqxAli7ENzfc/images/ai/mcp-server/integrations/overview/vapi.png?fit=max&auto=format&n=0sd4eqxAli7ENzfc&q=85&s=754d2fa6edaf572d6acdee878ff99740" href="/ai/mcp-server/integrations/vapi">
    Build and scale AI workflows with Bright Data and Vapi AI.
  </Card>

  <Card title="NVIDIA NeMo" icon="https://mintcdn.com/brightdata/0sd4eqxAli7ENzfc/images/ai/mcp-server/integrations/overview/nvidia-nemo.png?fit=max&auto=format&n=0sd4eqxAli7ENzfc&q=85&s=668caf062adf9c1089de5146d65226ae" href="/ai/mcp-server/integrations/nvidia-nemo">
    Empower your AI applications with Bright Data and NVIDIA NeMo.
  </Card>

  <Card title="ChatGPT" icon="https://mintcdn.com/brightdata/0sd4eqxAli7ENzfc/images/ai/mcp-server/integrations/overview/chat-gpt.png?fit=max&auto=format&n=0sd4eqxAli7ENzfc&q=85&s=1b6248abdcac611fa55723d0f6ee1538" href="/ai/mcp-server/integrations/chat-gpt">
    Empower your AI applications with Bright Data and Google ADK.
  </Card>

  <Card title="Cloudflare agents" icon="https://mintcdn.com/brightdata/0sd4eqxAli7ENzfc/images/ai/mcp-server/integrations/overview/cloudflare.png?fit=max&auto=format&n=0sd4eqxAli7ENzfc&q=85&s=255c96a68ad09febde6b6248991a97e5" href="/ai/mcp-server/integrations/cloudflare-agents">
    Build intelligent Cloudflare Workers agents powered by Bright Data's live web data.
  </Card>
</CardGroup>

***

<Card title="AI Frameworks" icon="layer-group" href="/integrations/ai-integrations">
  <p>Connect to our MCP clients for seamless integration.</p>
</Card>


# Snowflake integration
Source: https://docs.brightdata.com/ai/mcp-server/integrations/snowflake

Connect Snowflake Cortex to the Bright Data MCP server (60+ tools) to enrich tables with live web data and run automated extraction inside your warehouse.

<Card title="Building an AI startup?" href="https://brightdata.com/ai/ai-startups-program" icon="rocket-launch">
  You might be eligible for our Startup Program. Get fully funded access to the infrastructure you're reading about right now (up to \$20K value).
</Card>

<Steps>
  <Step title="Get your Bright Data API token">
    1. Go to [Bright Data user settings](https://brightdata.com/cp/setting/users)
    2. Copy your API token (it looks like: `2dceb1aa0***************************`)
    3. Keep it secure - you'll use it when connecting to the MCP
  </Step>

  <Step title="Install the Bright Data Web MCP app">
    1. Navigate to **Apps** in your Snowflake interface
    2. Find and click **Bright Data Web MCP**
    3. Click **Install** to add the application to your account
  </Step>

  <Step title="Configure external access">
    1. Open the installed app
    2. You'll see a request for **Bright Data External Access**
    3. Click **Review** to see the network configuration
    4. Click **Connect** - this automatically creates the necessary network rules
    5. Click **Activate** to enable the external access integration

    The app now has all the resources it needs to run.
  </Step>

  <Step title="Start the MCP service and get the endpoint">
    Start the application and retrieve the MCP endpoint URL.

    ```sql expandable theme={null}
    -- Start the app
    CALL <application-name>.app_public.start_app();

    -- Check application status
    CALL <application-name>.app_public.service_status();

    -- Get the endpoint URL
    SHOW ENDPOINTS IN SERVICE <application-name>.core.mcp_service;
    ```

    Copy the endpoint URL from the output, you'll need it to connect your MCP client.
  </Step>

  <Step title="Create a Snowflake Personal Access Token (PAT)">
    1. In Snowflake, go to **Settings**
    2. Navigate to **Authentication** → **Programmatic Access Tokens**
    3. Click **Generate New Token**
    4. Save the token securely, it will be used for MCP authentication
  </Step>

  <Step title="Connect to the Bright Data MCP">
    Use the following endpoint format in your MCP client:

    ```text theme={null}
    https://<endpoint>.snowflakecomputing.app/mcp?token=<BRIGHT_DATA_API_TOKEN>
    ```

    Include the required authentication header:

    ```text theme={null}
    Authorization: Snowflake Token="YOUR_SNOWFLAKE_PAT"
    ```

    Replace:

    * `<endpoint>` with the Snowflake endpoint from the previous step
    * `<BRIGHT_DATA_API_TOKEN>` with your Bright Data API token
    * `YOUR_SNOWFLAKE_PAT` with your Snowflake Personal Access Token
  </Step>

  <Step title="Test the integration">
    1. Connect to the MCP endpoint from your MCP-compatible client (e.g. Claude Desktop)
    2. Invoke a tool such as web browsing or scraping
    3. Confirm that responses are returned successfully
  </Step>

  <Step title="Monitor usage">
    1. Visit [My Zones](https://brightdata.com/cp/zones) in your Bright Data dashboard
    2. Track request volume and usage
    3. Your free tier includes **5,000 requests per month**
  </Step>
</Steps>


# Vapi AI MCP server integration
Source: https://docs.brightdata.com/ai/mcp-server/integrations/vapi

Connect Vapi AI voice agents to the Bright Data MCP server (60+ tools) to give voice assistants real-time web search, scraping and structured data retrieval.

<Card title="Building an AI startup?" href="https://brightdata.com/ai/ai-startups-program" icon="rocket-launch">
  You might be eligible for our Startup Program. Get fully funded access to the infrastructure you're reading about right now (up to \$20K value).
</Card>

## Watch the demo

<iframe title="YouTube video player" />

## Quick Install

To integrate Bright Data into Vapi AI, add the following MCP server URL to your Vapi tools:

```http theme={null}
https://mcp.brightdata.com/sse?token=<your-api-token>
```

## How to set up Vapi AI

<Steps>
  <Step title="Prerequisites">
    Before you begin, ensure you have the following:

    * [A Vapi AI account](https://vapi.ai) (sign up if you don't have one)
    * [A Bright Data account](https://brightdata.com/?hs_signup=1\&utm_source=docs) (new users get free credit for testing, and then you can pay as you go)
    * **An API key** from the [user settings page](https://brightdata.com/cp/setting/users) (New users receive an **API key** in the welcome email.)

    <Tip>
      If you prefer to use a different zone name, you can specify it with the `unlocker` url parameter variable in your configuration
    </Tip>
  </Step>

  <Step title="Login to Vapi AI">
    Navigate to [vapi.ai](https://vapi.ai) and log in to your account.
  </Step>

  <Step title="Claim Your Bright Data API Key">
    Log in to your Bright Data account and navigate to the [user settings page](https://brightdata.com/cp/setting/users) to retrieve your API key.
  </Step>

  <Step title="Access Tools in Vapi">
    In your Vapi dashboard, click on **Tools** in the navigation menu.

    <img alt="Setup Guide" />
  </Step>

  <Step title="Create a New Tool">
    Click on **Create tool** button to start adding the Bright Data MCP integration.

    <img alt="Setup Guide" />
  </Step>

  <Step title="Choose MCP">
    Select **MCP** as the tool type from the available options.

    <img alt="Setup Guide" />
  </Step>

  <Step title="Configure the MCP Server">
    Configure your tool with the following settings:

    * **Name**: `brightdata`
    * **MCP Server URL**: `https://mcp.brightdata.com/sse?token=<your-api-token>`
    * Set the timeout to 120 seconds to avoid getting errors.

    Replace `<your-api-token>` with your actual API token from Bright Data.

    <img alt="Setup Guide" />
  </Step>

  <Step title="Add Tool to Assistant">
    Navigate to your assistant settings and add the newly created Bright Data tool to enable the integration.

    <img alt="Setup Guide" />
  </Step>

  <Step title="Test the Integration">
    Verify the integration works correctly by:

    * Testing through the Vapi chat interface
    * Making a test web call to your assistant

    You should see the Bright Data tools available and responding to your requests.

    <img alt="Setup Guide" />
  </Step>
</Steps>

## What's Next?

Now that you've integrated Bright Data with Vapi AI, you can:

* Use web scraping capabilities directly in your voice AI conversations
* Use [Vapi's workflows](https://docs.vapi.ai/workflows/quickstart) for creating more complex voice AI agents
* Access real-time data from various sources
* Enhance your assistant with powerful data collection features

For more information about Bright Data's MCP capabilities, visit the [Bright Data documentation](https://brightdata.com/products/web-scraper/mcp).


# VS Code MCP server integration
Source: https://docs.brightdata.com/ai/mcp-server/integrations/vscode

Connect VS Code MCP-enabled chat to the Bright Data MCP server (60+ tools) to give GitHub Copilot real-time web search, scraping and structured data tools.

<Card title="Building an AI startup?" href="https://brightdata.com/ai/ai-startups-program" icon="rocket-launch">
  You might be eligible for our Startup Program. Get fully funded access to the infrastructure you're reading about right now (up to \$20K value).
</Card>

## Quick Install

Click the button below to automatically install and configure the Bright Data MCP server in VS Code:

## Self-hosted MCP

<Steps>
  <Step title="Prerequisites">
    Before you begin, ensure you have the following:

    * [Node.js ](https://nodejs.org/en/download) is installed and up to date
    * [A Bright Data account](https://brightdata.com/?hs_signup=1\&utm_source=docs)  (new users get free credit for testing, and then you can pay as you go)
    * **An API key** from the [user settings page](https://brightdata.com/cp/setting/users) (New users receive an **API key** in the welcome email.)

    <Tip>
      If you prefer to use a different zone name, you can specify it with the `WEB_UNLOCKER_ZONE `environment variable in your configuration
    </Tip>
  </Step>

  <Step title="Basic Configuration">
    Click on the Vs code logo to automatically install the web MCP:

    <a href="vscode:mcp/install?%7B%22name%22%3A%22the-web-mcp%22%2C%22type%22%3A%22stdio%22%2C%22command%22%3A%22npx%22%2C%22args%22%3A%5B%22%40brightdata%2Fmcp%22%5D%2C%22env%22%3A%7B%22API_TOKEN%22%3A%22%24input%3Aapi-token%22%7D%7D">
      <img alt="Install in VS Code" title="" />
    </a>
  </Step>
</Steps>


# Local MCP server advanced configuration
Source: https://docs.brightdata.com/ai/mcp-server/local/advanced

Customize the local Bright Data MCP server (60+ tools): enable Browser API, configure proxies, set rate limits and pass environment variables.

<Card title="Building an AI startup?" href="https://brightdata.com/ai/ai-startups-program" icon="rocket-launch">
  You might be eligible for our Startup Program. Get fully funded access to the infrastructure you're reading about right now (up to \$20K value).
</Card>

## MCP Server Modes

Bright Data's MCP server offers two modes to suit different needs:

* **Rapid (Free)** - Quickly scrape search results and unlock any public webpage as clean Markdown.
* **Pro** - Access advanced scraping, structured data from top platforms (Amazon, LinkedIn, X, Instagram, etc.), and full browser automation. Built for dynamic and large-scale use cases.
* **Groups** - Unlock targeted capabilities with pre-built bundles. Whether you're monitoring competitors, analyzing social trends, or automating browsers, select the exact tool groups your project requires.
* **Tools** -  Fine-tune your toolkit. Cherry-pick individual tools to supplement your Groups or build a completely custom setup for specialized use cases.

<Tip>
  **Rapid (Free)** mode is enabled by default and is **recommended** for everyday browsing and data needs.
</Tip>

***

## How to configure the local MCP server

When using the MCP server locally, you can set environment variables for finer control:

* `RATE_LIMIT` - Set the rate limit for requests (*default:* `100/1h`).
* `WEB_UNLOCKER_ZONE` - Override the default web unlocker zone (*default:* `mcp_unlocker`).
* `BROWSER_ZONE` - Override the default browser zone (*default:* `mcp_browser`).
* `PRO_MODE` - Set to true/false to enable/disable Pro tools (*default:* `false`).
* `GROUPS` - Comma-separated list of tool group IDs to enable (e.g., `browser,ecommerce,social`). Available groups: `ecommerce`, `social`, `browser`, `finance`, `business`, `research`, `app_stores`, `travel`, `advanced_scraping`, `geo`, `code`.
* `TOOLS` - Comma-separated list of individual tool names to add on top of selected groups (e.g., `web_data_linkedin_person_profile,scrape_as_html`). Use this to fine-tune your toolkit with specific capabilities.

> **Note:** `PRO_MODE=true` enables all tools. If you use `GROUPS` or `TOOLS`, they take priority and override Pro mode.

<Tip>
  Use `PRO_MODE=true` to enable **Pro mode**.
</Tip>

### Example configuration

```json theme={null}
{
  "mcpServers":{
    "Bright Data":{
      "command":"npx",
      "args":["@brightdata/mcp"],
      "env":{
        "API_TOKEN":"<insert-your-api-token-here>",
        "WEB_UNLOCKER_ZONE": "my_zone_name",
        "BROWSER_ZONE": "my_browser_zone",
        "PRO_MODE": "true",
        "GROUPS": "browser,advanced_scraping",
        "TOOLS": "web_data_linkedin_person_profile,web_data_amazon_product"
      }
    }
  }
}
```


# How to set up local (self-hosted) MCP
Source: https://docs.brightdata.com/ai/mcp-server/local/quickstart

Set up a self-hosted Bright Data MCP server: step-by-step installation, configuration and connection to AI agents like Claude or Cursor in under 10 minutes.

<Card title="Building an AI startup?" href="https://brightdata.com/ai/ai-startups-program" icon="rocket-launch">
  You might be eligible for our Startup Program. Get fully funded access to the infrastructure you're reading about right now (up to \$20K value).
</Card>

<Steps>
  <Step title="Prerequisites">
    Before you begin, make sure you have the following:

    <CardGroup>
      <Card title="Bright Data Account" icon="user" href="https://brightdata.com/?hs_signup=1&utm_source=docs">
        *Sign up for free and receive **5,000 requests** per month at no cost.*
      </Card>

      <Card title="Your Bright Data API Key" icon="key" href="https://brightdata.com/cp/setting">
        *New users receive their API key in the welcome email.*
      </Card>
    </CardGroup>

    <Card title="Node.js" icon="node-js" href="https://nodejs.org/en/download">
      *Ensure Node.js is installed and up to date.*
    </Card>

    <Tip>
      No username is required. The self-hosted MCP server authenticates with your `API_TOKEN` only. Usernames (format: `brd-customer-{customer_id}-zone-{zone_name}`) are for native proxy access, not MCP. If a third-party tool asks for a username, leave it empty.
    </Tip>
  </Step>

  <Step title="Choose Your Client">
    Select and configure your preferred MCP client:

    * <a href="/ai/mcp-server/ai/mcp-server/integrations/claude#self-hosted-mcp"><span> Claude</span></a>
    * <a href="/integrations/n8n#self-hosted-mcp-integration"><span> n8n</span></a>
  </Step>

  <Step title="Quick Examples">
    Try these example prompts with your MCP server:

    <AccordionGroup>
      <Accordion title="Extract real-time data from Google">
        “Extract all flight times departing from JFK Airport to Heathrow in the next 24 hours.”
      </Accordion>

      <Accordion title="Extract company data from LinkedIn">
        “Extract the Bright Data overview section from LinkedIn.”
      </Accordion>

      <Accordion title="Extract dynamic data from eBay">
        “Go to ebay.com, click the ‘Shop by category’ button in the navigation bar, and extract all categories.”
      </Accordion>
    </AccordionGroup>
  </Step>
</Steps>

<Card title="Advanced Configuration" icon="sliders" href="/ai/mcp-server/local/advanced">
  See the Advanced Configuration page for more details.
</Card>


# MCP server overview
Source: https://docs.brightdata.com/ai/mcp-server/overview

Use the Bright Data MCP server to give AI agents real-time access to public web data with 5,000 free requests per month and zero infrastructure setup.

<Card title="Building an AI startup?" href="https://brightdata.com/ai/ai-startups-program" icon="rocket-launch">
  You might be eligible for our Startup Program. Get fully funded access to the infrastructure you're reading about right now (up to \$20K value).
</Card>

The **Bright Data MCP server** gives AI agents and assistants real-time access to public web data through the Model Context Protocol (MCP). Connect it to Claude, Cursor or any MCP-compatible client, and your agent can search, scrape and read live web pages without you building or maintaining data pipelines.

The MCP server runs on the Web Unlocker API, so every request handles proxy rotation, anti-bot challenges and CAPTCHA solving automatically. Every new account includes 5,000 free requests per month. You can run the server two ways: a fully managed remote server, or a self-hosted local instance.

<Card title="Get started for free" icon="rocket" href="https://brightdata.com/?hs_signup=1&utm_source=docs">
  Start using the Bright Data MCP server with **5,000 requests** per month, completely free.
</Card>

## Choose your MCP server

<CardGroup>
  <Card title="Remote (hosted) MCP" icon="cloud" href="/ai/mcp-server/remote/quickstart">
    Launch a fully managed MCP server in the cloud, no setup required.
  </Card>

  <Card title="Local (self-hosted) MCP" icon="house" href="/ai/mcp-server/local/quickstart">
    Set up your own MCP server instance on-premise or in your private cloud.
  </Card>
</CardGroup>

<Tip>
  **Optimize your token usage:** Select only the tools you need using [tool groups](/ai/mcp-server/tools) (e.g., `groups=ecommerce,social`) or individual tools (e.g., `tools=web_data_amazon_product`). This reduces context size and maximizes your usage.
</Tip>

## Explore MCP server resources

<CardGroup>
  <Card title="Tools" icon="wrench" href="/ai/mcp-server/tools">
    Discover the built-in tools available for your MCP server.
  </Card>

  <Card title="FAQs" icon="book-open" href="/ai/mcp-server/faqs">
    Get quick answers to frequently asked MCP server questions.
  </Card>

  <Card title="Usage examples" icon="code" href="/ai/mcp-server/usage-examples">
    Learn from practical examples to accelerate your implementation.
  </Card>

  <Card title="Integrations" icon="puzzle-piece" href="/ai/mcp-server/integrations/overview">
    Connect the MCP server with leading AI platforms like Claude, Cursor and more.
  </Card>

  <Card title="Source code" icon="github" href="https://github.com/brightdata/brightdata-mcp?tab=readme-ov-file#-usage-examples">
    Explore the MCP server source code on GitHub.
  </Card>
</CardGroup>

<Note>
  The MCP free tier is the same account-level [free tier](/general/account/billing-and-pricing/free-tier) of 5,000 credits per month, drawn from a single shared pool, because the MCP server runs on the Web Unlocker API. For team accounts, that free tier is shared across all users within the account. If you require additional credits, please contact your account manager.
</Note>


# Remote MCP server advanced configuration
Source: https://docs.brightdata.com/ai/mcp-server/remote/advanced

Customize the remote Bright Data MCP server (60+ tools): configure auth tokens, switch proxies, tune timeouts and enable advanced tools per session.

<Card title="Building an AI startup?" href="https://brightdata.com/ai/ai-startups-program" icon="rocket-launch">
  You might be eligible for our Startup Program. Get fully funded access to the infrastructure you're reading about right now (up to \$20K value).
</Card>

## MCP Server Modes

Bright Data's MCP server offers two modes to suit different needs:

* **Rapid (Free)** - Quickly scrape search results and unlock any public webpage as clean Markdown.
* **Pro** - Access advanced scraping, structured data from top platforms (Amazon, LinkedIn, X, Instagram, etc.), and full browser automation. Built for dynamic and large-scale use cases.
* **Groups** - Unlock targeted capabilities with pre-built bundles. Whether you're monitoring competitors, analyzing social trends, or automating browsers, select the exact tool groups your project requires.
* **Tools** -  Fine-tune your toolkit. Cherry-pick individual tools to supplement your Groups or build a completely custom setup for specialized use cases.

<Tip>
  **Rapid (Free)** mode is enabled by default and is **recommended** for everyday browsing and data needs.
</Tip>

***

## How to configure the remote MCP server

When using a remote MCP server, you can configure advanced options by passing query parameters to your endpoint:

<ParamField type="string">
  Use a custom zone name for web scraping.

  > **For example:** `&unlocker=my_zone_name`
</ParamField>

<ParamField type="string">
  Use a custom zone name for browser automation.

  > **For example:** `&browser=my_browser_zone`
</ParamField>

<ParamField type="number">
  Enable advanced (Pro) processing.

  > **For example:** `&pro=1`

  <Tip>
    Use `&pro=1` to enable **Pro mode**.
  </Tip>
</ParamField>

<ParamField type="string">
  Select pre-built tool bundles tailored to your domain. Comma-separated list of group IDs.

  > **For example:** `&groups=browser,ecommerce,social`

  <Tip>
    Available groups: `ecommerce`, `social`, `browser`, `finance`, `business`, `research`, `app_stores`, `travel`, `advanced_scraping`, `geo`, `code`
  </Tip>
</ParamField>

<ParamField type="string">
  Handpick individual tools to complement your groups selection. Comma-separated list of tool names.

  > **For example:** `&tools=scrape_as_markdown,web_data_linkedin_person_profile`

  <Warning>
    Using `groups` or `tools` overrides `pro=1`. Tool selection takes priority over Pro mode.
  </Warning>
</ParamField>

### Example configurations

<CodeGroup>
  ```sh SSE - Pro Mode (All Tools) theme={null}
  https://mcp.brightdata.com/sse?token=YOUR_API_TOKEN&pro=1
  ```

  ```sh SSE - Tool Groups theme={null}
  https://mcp.brightdata.com/sse?token=YOUR_API_TOKEN&groups=browser,ecommerce,social
  ```

  ```sh SSE - Custom Tools theme={null}
  https://mcp.brightdata.com/sse?token=YOUR_API_TOKEN&groups=browser&tools=web_data_linkedin_person_profile,scrape_as_html
  ```

  ```sh HTTP - Pro Mode (All Tools) theme={null}
  https://mcp.brightdata.com/mcp?token=YOUR_API_TOKEN&pro=1
  ```

  ```sh HTTP - Tool Groups theme={null}
  https://mcp.brightdata.com/mcp?token=YOUR_API_TOKEN&groups=browser,ecommerce,social
  ```

  ```sh HTTP - Custom Tools theme={null}
  https://mcp.brightdata.com/mcp?token=YOUR_API_TOKEN&groups=browser&tools=web_data_linkedin_person_profile,scrape_as_html
  ```
</CodeGroup>

***


# How to get started with remote MCP server
Source: https://docs.brightdata.com/ai/mcp-server/remote/quickstart

Connect AI agents to the fully managed Bright Data Remote MCP server (60+ tools) with no setup: authentication, tool selection and a working sample request.

<Card title="Building an AI startup?" href="https://brightdata.com/ai/ai-startups-program" icon="rocket-launch">
  You might be eligible for our Startup Program. Get fully funded access to the infrastructure you're reading about right now (up to \$20K value).
</Card>

<Steps>
  <Step title="Prerequisites">
    Before getting started, make sure you have the following:

    <CardGroup>
      <Card title="Bright Data Account" icon="user" href="https://brightdata.com/?hs_signup=1&utm_source=docs">
        *Sign up for free and receive **5,000 requests** per month at no cost.*
      </Card>

      <Card title="Your Bright Data API Key" icon="key" href="https://brightdata.com/cp/setting">
        *New users receive their API key via the welcome email.*
      </Card>
    </CardGroup>
  </Step>

  <Step title="Select Your Endpoint">
    Use one of the following endpoints to connect to the Remote MCP Server:

    <CodeGroup>
      ```sh SSE (Server-Sent Events) endpoint: theme={null}
      https://mcp.brightdata.com/sse?token=YOUR_API_TOKEN
      ```

      ```sh Streamable HTTP endpoint: theme={null}
      https://mcp.brightdata.com/mcp?token=YOUR_API_TOKEN
      ```
    </CodeGroup>

    <Tip>
      Replace `YOUR_API_TOKEN` with your actual Bright Data API token.
    </Tip>

    <Tip>
      No username is required. The Remote MCP server authenticates with your API token only. Usernames (format: `brd-customer-{customer_id}-zone-{zone_name}`) are for native proxy access, not MCP. If a third-party tool asks for a username, leave it empty.
    </Tip>
  </Step>

  <Step title="Choose Your Client">
    Select and configure your preferred client:

    * <a href="/ai/mcp-server/integrations/claude#hosted-mcp"><span> Claude</span></a>
    * <a href="/ai/mcp-server/integrations/cursor"><span> Cursor</span></a>
    * <a href="/integrations/n8n#sse-based-mcp-integration"><span> n8n</span></a>
  </Step>

  <Step title="Quick Examples">
    Try these sample prompts with your MCP Server:

    <AccordionGroup>
      <Accordion title="Extract real-time data from Google">
        “Extract all flight times departing from JFK Airport to Heathrow in the next 24 hours.”
      </Accordion>

      <Accordion title="Extract company data from LinkedIn">
        “Extract the Bright Data overview section from LinkedIn.”
      </Accordion>

      <Accordion title="Extract dynamic data from eBay">
        “Go to ebay.com, click the ‘Shop by category’ button in the navigation bar, and extract all categories.”
      </Accordion>
    </AccordionGroup>
  </Step>
</Steps>

<Card title="Advanced Configuration" icon="sliders" href="/ai/mcp-server/remote/advanced#remote-configuration">
  See the Advanced Configuration page for more details.
</Card>


# Tools
Source: https://docs.brightdata.com/ai/mcp-server/tools

Reference for the Bright Data MCP server tools (60+ tools): web search, scraping, structured data and platform extractors for ecommerce and social workflows.

<Card title="Building an AI startup?" href="https://brightdata.com/ai/ai-startups-program" icon="rocket-launch">
  You might be eligible for our Startup Program. Get fully funded access to the infrastructure you're reading about right now (up to \$20K value).
</Card>

<Note>
  ### Modes: Rapid (Free), Pro and 11 tool groups

  Bright Data's MCP server offers two modes to suit different needs:

  * <Icon icon="gift" />   **Rapid (Free)** - Quickly scrape search results and unlock any public webpage as clean Markdown.
  * <Icon icon="gem" />   **Pro** - Access advanced scraping, structured data from top platforms (Amazon, LinkedIn, X, Instagram, etc.), and full browser automation. Built for dynamic and large-scale use cases.
  * <Icon icon="layer-group" />  **Groups** - Pre-configured tool collections for specific use cases including E-commerce, Social Media, Browser Automation, Business Intelligence, Finance, Research, App Stores, Travel, Advanced Scraping, GEO & LLM Visibility, and Code. Each group bundles relevant tools and data feeds for its domain.

  ***

  To use **Pro mode**:

  * In Remote MCP, request Pro features by setting `&pro=1`.
  * In Local MCP, enable Pro features with `PRO_MODE=true`.

  To use **Groups:**

  * In Remote MCP, request the Groups by setting `&groups=<group_name>`.
  * In Local MCP, enable Groups  with `GROUPS=<group_name>`.
</Note>

<Tip>
  **Rapid (Free)** mode is enabled by default and is **recommended** for everyday browsing and data needs.
</Tip>

## Bright Data MCP Tools Reference

|         Mode         | Tool Name                                | Description                                                                                                                                                                                           | Group               |
| :------------------: | :--------------------------------------- | :---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------- |
| <Icon icon="gift" /> | `search_engine`                          | Scrape search results from Google, Bing, or Yandex. Returns SERP results in JSON for Google and Markdown for Bing/Yandex; supports pagination with the cursor parameter.                              | `all`               |
| <Icon icon="gift" /> | `scrape_as_markdown`                     | Scrape a single webpage with advanced extraction and return Markdown. Uses Bright Data's unlocker to handle bot protection and CAPTCHA.                                                               | `all`               |
| <Icon icon="gift" /> | `discover`                               | Search the web and rank results by AI-driven relevance. Returns scored results with title, description, and URL. Supports intent-based ranking, geo-targeting, date filtering, and keyword filtering. | `all`               |
| <Icon icon="gift" /> | `search_engine_batch`                    | Run up to 10 search queries in parallel. Returns JSON for Google results and Markdown for Bing/Yandex.                                                                                                | `advanced_scraping` |
| <Icon icon="gift" /> | `scrape_batch`                           | Scrape up to 10 webpages in one request and return an array of URL/content pairs in Markdown format.                                                                                                  | `advanced_scraping` |
|  <Icon icon="gem" /> | `scrape_as_html`                         | Scrape a single webpage with advanced extraction and return the HTML response body. Handles sites protected by bot detection or CAPTCHA.                                                              | `advanced_scraping` |
|  <Icon icon="gem" /> | `extract`                                | Scrape a webpage as Markdown and convert it to structured JSON using AI sampling, with an optional custom extraction prompt.                                                                          | `advanced_scraping` |
|  <Icon icon="gem" /> | `session_stats`                          | Report how many times each tool has been called during the current MCP session.                                                                                                                       | `advanced_scraping` |
|  <Icon icon="gem" /> | `web_data_amazon_product`                | Quickly read structured Amazon product data. Requires a valid product URL containing /dp/. Often faster and more reliable than scraping.                                                              | `ecommerce`         |
|  <Icon icon="gem" /> | `web_data_amazon_product_reviews`        | Quickly read structured Amazon product review data. Requires a valid product URL containing /dp/. Often faster and more reliable than scraping.                                                       | `ecommerce`         |
|  <Icon icon="gem" /> | `web_data_amazon_product_search`         | Retrieve structured Amazon search results. Requires a search keyword and Amazon domain URL; limited to the first page of results.                                                                     | `ecommerce`         |
|  <Icon icon="gem" /> | `web_data_walmart_product`               | Quickly read structured Walmart product data. Requires a product URL containing /ip/. Often faster and more reliable than scraping.                                                                   | `ecommerce`         |
|  <Icon icon="gem" /> | `web_data_walmart_seller`                | Quickly read structured Walmart seller data. Requires a valid Walmart seller URL. Often faster and more reliable than scraping.                                                                       | `ecommerce`         |
|  <Icon icon="gem" /> | `web_data_ebay_product`                  | Quickly read structured eBay product data. Requires a valid eBay product URL. Often faster and more reliable than scraping.                                                                           | `ecommerce`         |
|  <Icon icon="gem" /> | `web_data_homedepot_products`            | Quickly read structured Home Depot product data. Requires a valid homedepot.com product URL. Often faster and more reliable than scraping.                                                            | `ecommerce`         |
|  <Icon icon="gem" /> | `web_data_zara_products`                 | Quickly read structured Zara product data. Requires a valid Zara product URL. Often faster and more reliable than scraping.                                                                           | `ecommerce`         |
|  <Icon icon="gem" /> | `web_data_etsy_products`                 | Quickly read structured Etsy product data. Requires a valid Etsy product URL. Often faster and more reliable than scraping.                                                                           | `ecommerce`         |
|  <Icon icon="gem" /> | `web_data_bestbuy_products`              | Quickly read structured Best Buy product data. Requires a valid Best Buy product URL. Often faster and more reliable than scraping.                                                                   | `ecommerce`         |
|  <Icon icon="gem" /> | `web_data_linkedin_person_profile`       | Quickly read structured LinkedIn people profile data. Requires a valid LinkedIn profile URL. Often faster and more reliable than scraping.                                                            | `social`            |
|  <Icon icon="gem" /> | `web_data_linkedin_company_profile`      | Quickly read structured LinkedIn company profile data. Requires a valid LinkedIn company URL. Often faster and more reliable than scraping.                                                           | `social`            |
|  <Icon icon="gem" /> | `web_data_linkedin_job_listings`         | Quickly read structured LinkedIn job listings data. Requires a valid LinkedIn jobs URL. Often faster and more reliable than scraping.                                                                 | `social`            |
|  <Icon icon="gem" /> | `web_data_linkedin_posts`                | Quickly read structured LinkedIn posts data. Requires a valid LinkedIn post URL. Often faster and more reliable than scraping.                                                                        | `social`            |
|  <Icon icon="gem" /> | `web_data_linkedin_people_search`        | Quickly read structured LinkedIn people search data. Requires a LinkedIn people search URL. Often faster and more reliable than scraping.                                                             | `social`            |
|  <Icon icon="gem" /> | `web_data_crunchbase_company`            | Quickly read structured Crunchbase company data. Requires a valid Crunchbase company URL. Often faster and more reliable than scraping.                                                               | `business`          |
|  <Icon icon="gem" /> | `web_data_zoominfo_company_profile`      | Quickly read structured ZoomInfo company profile data. Requires a valid ZoomInfo company URL. Often faster and more reliable than scraping.                                                           | `business`          |
|  <Icon icon="gem" /> | `web_data_instagram_profiles`            | Quickly read structured Instagram profile data. Requires a valid Instagram profile URL. Often faster and more reliable than scraping.                                                                 | `social`            |
|  <Icon icon="gem" /> | `web_data_instagram_posts`               | Quickly read structured Instagram post data. Requires a valid Instagram post URL. Often faster and more reliable than scraping.                                                                       | `social`            |
|  <Icon icon="gem" /> | `web_data_instagram_reels`               | Quickly read structured Instagram reel data. Requires a valid Instagram reel URL. Often faster and more reliable than scraping.                                                                       | `social`            |
|  <Icon icon="gem" /> | `web_data_instagram_comments`            | Quickly read structured Instagram comments data. Requires a valid Instagram URL. Often faster and more reliable than scraping.                                                                        | `social`            |
|  <Icon icon="gem" /> | `web_data_facebook_posts`                | Quickly read structured Facebook post data. Requires a valid Facebook post URL. Often faster and more reliable than scraping.                                                                         | `social`            |
|  <Icon icon="gem" /> | `web_data_facebook_marketplace_listings` | Quickly read structured Facebook Marketplace listing data. Requires a valid Marketplace listing URL. Often faster and more reliable than scraping.                                                    | `social`            |
|  <Icon icon="gem" /> | `web_data_facebook_company_reviews`      | Quickly read structured Facebook company reviews data. Requires a valid Facebook company URL and review count. Often faster and more reliable than scraping.                                          | `social`            |
|  <Icon icon="gem" /> | `web_data_facebook_events`               | Quickly read structured Facebook events data. Requires a valid Facebook event URL. Often faster and more reliable than scraping.                                                                      | `social`            |
|  <Icon icon="gem" /> | `web_data_tiktok_profiles`               | Quickly read structured TikTok profile data. Requires a valid TikTok profile URL. Often faster and more reliable than scraping.                                                                       | `social`            |
|  <Icon icon="gem" /> | `web_data_tiktok_posts`                  | Quickly read structured TikTok post data. Requires a valid TikTok post URL. Often faster and more reliable than scraping.                                                                             | `social`            |
|  <Icon icon="gem" /> | `web_data_tiktok_shop`                   | Quickly read structured TikTok Shop product data. Requires a valid TikTok Shop product URL. Often faster and more reliable than scraping.                                                             | `social`            |
|  <Icon icon="gem" /> | `web_data_tiktok_comments`               | Quickly read structured TikTok comments data. Requires a valid TikTok video URL. Often faster and more reliable than scraping.                                                                        | `social`            |
|  <Icon icon="gem" /> | `web_data_google_maps_reviews`           | Quickly read structured Google Maps reviews data. Requires a valid Google Maps URL and optional days\_limit (default 3). Often faster and more reliable than scraping.                                | `business`          |
|  <Icon icon="gem" /> | `web_data_google_shopping`               | Quickly read structured Google Shopping product data. Requires a valid Google Shopping product URL. Often faster and more reliable than scraping.                                                     | `ecommerce`         |
|  <Icon icon="gem" /> | `web_data_google_play_store`             | Quickly read structured Google Play Store app data. Requires a valid Play Store app URL. Often faster and more reliable than scraping.                                                                | `app_stores`        |
|  <Icon icon="gem" /> | `web_data_apple_app_store`               | Quickly read structured Apple App Store app data. Requires a valid App Store app URL. Often faster and more reliable than scraping.                                                                   | `app_stores`        |
|  <Icon icon="gem" /> | `web_data_github_repository_file`        | Quickly read structured GitHub repository file data. Requires a valid GitHub file URL. Often faster and more reliable than scraping.                                                                  | `research`          |
|  <Icon icon="gem" /> | `web_data_yahoo_finance_business`        | Quickly read structured Yahoo Finance company profile data. Requires a valid Yahoo Finance business URL. Often faster and more reliable than scraping.                                                | `finance`           |
|  <Icon icon="gem" /> | `web_data_x_posts`                       | Quickly read structured X (Twitter) post data. Requires a valid X post URL. Often faster and more reliable than scraping.                                                                             | `social`            |
|  <Icon icon="gem" /> | `web_data_x_profile_posts`               | Quickly read structured X posts from a profile. Requires a valid X profile URL. Returns the most recent posts, with optional date range filtering.                                                    | `social`            |
|  <Icon icon="gem" /> | `web_data_zillow_properties_listing`     | Quickly read structured Zillow property listing data. Requires a valid Zillow listing URL. Often faster and more reliable than scraping.                                                              | `business`          |
|  <Icon icon="gem" /> | `web_data_booking_hotel_listings`        | Quickly read structured Booking.com hotel listing data. Requires a valid Booking.com listing URL. Often faster and more reliable than scraping.                                                       | `travel`            |
|  <Icon icon="gem" /> | `web_data_youtube_videos`                | Quickly read structured YouTube video metadata. Requires a valid YouTube video URL. Often faster and more reliable than scraping.                                                                     | `social`            |
|  <Icon icon="gem" /> | `web_data_youtube_profiles`              | Quickly read structured YouTube channel profile data. Requires a valid YouTube channel URL. Often faster and more reliable than scraping.                                                             | `social`            |
|  <Icon icon="gem" /> | `web_data_youtube_comments`              | Quickly read structured YouTube comments data. Requires a valid YouTube video URL and optional num\_of\_comments (default 10). Often faster and more reliable than scraping.                          | `social`            |
|  <Icon icon="gem" /> | `web_data_reddit_posts`                  | Quickly read structured Reddit post data. Requires a valid Reddit post URL. Often faster and more reliable than scraping.                                                                             | `social`            |
|  <Icon icon="gem" /> | `scraping_browser_navigate`              | Open or reuse a scraping-browser session and navigate to the provided URL, resetting tracked network requests.                                                                                        | `browser`           |
|  <Icon icon="gem" /> | `scraping_browser_go_back`               | Navigate the active scraping-browser session back to the previous page and report the new URL and title.                                                                                              | `browser`           |
|  <Icon icon="gem" /> | `scraping_browser_go_forward`            | Navigate the active scraping-browser session forward to the next page and report the new URL and title.                                                                                               | `browser`           |
|  <Icon icon="gem" /> | `scraping_browser_snapshot`              | Capture an ARIA snapshot of the current page listing interactive elements and their refs for later ref-based actions.                                                                                 | `browser`           |
|  <Icon icon="gem" /> | `scraping_browser_click_ref`             | Click an element using its ref from the latest ARIA snapshot; requires a ref and human-readable element description.                                                                                  | `browser`           |
|  <Icon icon="gem" /> | `scraping_browser_type_ref`              | Fill an element identified by ref from the ARIA snapshot, optionally pressing Enter to submit after typing.                                                                                           | `browser`           |
|  <Icon icon="gem" /> | `scraping_browser_screenshot`            | Capture a screenshot of the current page; supports optional full\_page mode for full-length images.                                                                                                   | `browser`           |
|  <Icon icon="gem" /> | `scraping_browser_network_requests`      | List the network requests recorded since page load with HTTP method, URL, and response status for debugging.                                                                                          | `browser`           |
|  <Icon icon="gem" /> | `scraping_browser_wait_for_ref`          | Wait until an element identified by ARIA ref becomes visible, with an optional timeout in milliseconds.                                                                                               | `browser`           |
|  <Icon icon="gem" /> | `scraping_browser_get_text`              | Return the text content of the current page's body element.                                                                                                                                           | `browser`           |
|  <Icon icon="gem" /> | `scraping_browser_get_html`              | Return the HTML content of the current page; avoid the full\_page option unless head or script tags are required.                                                                                     | `browser`           |
|  <Icon icon="gem" /> | `scraping_browser_scroll`                | Scroll to the bottom of the current page in the scraping-browser session.                                                                                                                             | `browser`           |
|  <Icon icon="gem" /> | `scraping_browser_scroll_to_ref`         | Scroll the page until the element referenced in the ARIA snapshot is in view.                                                                                                                         | `browser`           |
|  <Icon icon="gem" /> | `web_data_chatgpt_ai_insights`           | Send a prompt to ChatGPT and get back AI-generated insights. Returns structured answer text, citations, recommendations, and markdown. Useful for GEO and LLM as a judge.                             | `geo`               |
|  <Icon icon="gem" /> | `web_data_grok_ai_insights`              | Send a prompt to Grok and get back AI-generated insights. Returns structured answer text in markdown format. Useful for GEO and LLM as a judge.                                                       | `geo`               |
|  <Icon icon="gem" /> | `web_data_perplexity_ai_insights`        | Send a prompt to Perplexity and get back AI-generated insights. Returns structured answer text in markdown format. Useful for GEO and LLM as a judge.                                                 | `geo`               |
|  <Icon icon="gem" /> | `web_data_npm_package`                   | Quickly read structured npm package data. Requires a valid npm package name (e.g., `@brightdata/sdk`). Often faster and more reliable than scraping.                                                  | `code`              |
|  <Icon icon="gem" /> | `web_data_pypi_package`                  | Quickly read structured PyPI package data. Requires a valid PyPI package name (e.g., `langchain-brightdata`). Often faster and more reliable than scraping.                                           | `code`              |


# TOON format
Source: https://docs.brightdata.com/ai/mcp-server/toon

Use Token-Oriented Object Notation (TOON) with the Bright Data MCP server (60+ tools) to cut token usage on large web data payloads without losing structure.

<Card title="Building an AI startup?" href="https://brightdata.com/ai/ai-startups-program" icon="rocket-launch">
  You might be eligible for our Startup Program. Get fully funded access to the infrastructure you're reading about right now (up to \$20K value).
</Card>

## What is TOON?

**Token-Oriented Object Notation (TOON)** is a compact, human-readable encoding of the JSON data model designed specifically for LLM input. It minimizes token usage while maintaining full data fidelity, making it an excellent choice for reducing costs when processing large amounts of structured data.

TOON combines YAML's indentation-based structure with a CSV-style tabular layout for uniform arrays, achieving **30-60% token reduction** compared to standard JSON.

<Info>
  TOON is a **translation layer** - use JSON programmatically in your code, and encode it as TOON when passing data to LLMs.
</Info>

***

## How TOON Works

### The Problem with JSON

Standard JSON repeats field names for every record, which is token-expensive:

```json theme={null}
{
  "products": [
    { "id": 1, "name": "Laptop", "price": 999 },
    { "id": 2, "name": "Mouse", "price": 29 },
    { "id": 3, "name": "Keyboard", "price": 79 }
  ]
}
```

### The TOON Solution

TOON declares fields once and streams data as compact rows:

```yaml theme={null}
products[3]{id,name,price}:
  1,Laptop,999
  2,Mouse,29
  3,Keyboard,79
```

* `[3]` declares the array length (helps detect truncation)
* `{id,name,price}` declares field names once
* Each row contains comma-separated values

***

## Token Savings Example

<CardGroup>
  <Card title="JSON" icon="file-code">
    **235 tokens**

    Verbose with repeated keys
  </Card>

  <Card title="TOON" icon="compress">
    **106 tokens**

    \~55% reduction
  </Card>
</CardGroup>

```json JSON (235 tokens) theme={null}
{
  "context": {
    "task": "Product catalog",
    "category": "Electronics"
  },
  "items": [
    { "id": 1, "name": "Laptop", "price": 999, "stock": 50, "active": true },
    { "id": 2, "name": "Mouse", "price": 29, "stock": 200, "active": true },
    { "id": 3, "name": "Keyboard", "price": 79, "stock": 150, "active": false }
  ]
}
```

```yaml TOON (106 tokens) theme={null}
context:
  task: Product catalog
  category: Electronics
items[3]{id,name,price,stock,active}:
  1,Laptop,999,50,true
  2,Mouse,29,200,true
  3,Keyboard,79,150,false
```

***

## When to Use TOON

<Check>
  **TOON excels with flat, uniform arrays of objects** - data where items share the same structure across all records.
</Check>

### Ideal Use Cases

| Data Type        | Example               | Token Savings |
| ---------------- | --------------------- | ------------- |
| Product listings | E-commerce catalogs   | 40-60%        |
| User records     | Flat profile data     | 35-55%        |
| Log entries      | Structured logs       | 45-60%        |
| Search results   | SERP data (flat)      | 40-55%        |
| Simple tables    | Spreadsheet-like data | 50-65%        |

***

## When NOT to Use TOON

<Warning>
  **TOON performs poorly on deeply nested or non-uniform data structures.** This is particularly relevant for Bright Data MCP responses.
</Warning>

### Avoid TOON When:

<AccordionGroup>
  <Accordion title="Data is deeply nested" icon="sitemap">
    Complex objects with multiple nesting levels don't benefit from TOON's tabular format. JSON-compact often uses fewer tokens for such structures.

    **Example:** LinkedIn profiles with nested experience, education, and skills objects.
  </Accordion>

  <Accordion title="Data is non-uniform" icon="shuffle">
    When array items have different fields or optional properties, TOON's header-based approach breaks down.

    **Example:** Mixed product types with varying attributes.
  </Accordion>

  <Accordion title="Using Bright Data MCP structured endpoints" icon="database">
    Most Bright Data web data endpoints return **richly nested JSON** with hierarchical relationships. TOON won't provide meaningful savings here.

    **Example:** `web_data_amazon_product`, `web_data_linkedin_person_profile`, etc.
  </Accordion>
</AccordionGroup>

***

## TOON with Bright Data MCP

### Understanding the Limitation

Bright Data's MCP server returns structured data from platforms like Amazon, LinkedIn, Instagram, and more. This data is typically **nested and hierarchical**, making it unsuitable for TOON optimization.

<Tabs>
  <Tab title="Remote MCP (SSE)">
    Connect via Server-Sent Events:

    ```http theme={null}
    https://mcp.brightdata.com/mcp?token=YOUR_API_TOKEN
    ```
  </Tab>

  <Tab title="Local MCP (STDIO)">
    Configure in your MCP client:

    ```json theme={null}
    {
      "mcpServers": {
        "Bright Data": {
          "command": "npx",
          "args": ["@brightdata/mcp"],
          "env": {
            "API_TOKEN": "<insert-your-api-token-here>",
            "WEB_UNLOCKER_ZONE": "my_zone_name",
            "BROWSER_ZONE": "my_browser_zone",
            "PRO_MODE": "true",
            "GROUPS": "browser,advanced_scraping",
            "TOOLS": "web_data_linkedin_person_profile,web_data_amazon_product"
          }
        }
      }
    }
    ```
  </Tab>
</Tabs>

### When TOON Can Help

While most Bright Data endpoints return nested data, there are scenarios where TOON can be beneficial:

<Steps>
  <Step title="Flatten the data first">
    Post-process MCP responses to extract flat arrays before encoding to TOON.
  </Step>

  <Step title="Use for batch results">
    When using `scrape_batch` or `search_engine_batch`, the URL/content pairs can be flattened.
  </Step>

  <Step title="Custom extraction">
    Use the `extract` tool with a prompt that requests flat, tabular data.
  </Step>
</Steps>

***

## Quick Start with TOON

### How to install TOON

<CodeGroup>
  ```bash npm theme={null}
  npm install @toon-format/toon
  ```

  ```bash pnpm theme={null}
  pnpm add @toon-format/toon
  ```

  ```bash yarn theme={null}
  yarn add @toon-format/toon
  ```
</CodeGroup>

### How to encode and decode data

```typescript theme={null}
import { encode, decode } from '@toon-format/toon'

// Your flat data (ideal for TOON)
const data = {
  products: [
    { id: 1, name: 'Laptop', price: 999 },
    { id: 2, name: 'Mouse', price: 29 },
    { id: 3, name: 'Keyboard', price: 79 }
  ]
}

// Encode to TOON for LLM input
const toonData = encode(data)
console.log(toonData)
// Output:
// products[3]{id,name,price}:
//   1,Laptop,999
//   2,Mouse,29
//   3,Keyboard,79

// Decode back to JSON (lossless round-trip)
const jsonData = decode(toonData)
```

### How to use the CLI

```bash theme={null}
# Convert JSON to TOON
npx @toon-format/cli input.json -o output.toon

# Convert TOON back to JSON
npx @toon-format/cli input.toon -o output.json
```

***

## Practical Example: Using TOON with MCP Client

This example demonstrates a complete workflow: connecting to Bright Data's MCP server, fetching data, flattening the nested response, and converting it to TOON format for token-efficient LLM processing.

### Full MCP Client Example

```typescript theme={null}
import { Client } from '@modelcontextprotocol/sdk/client/index.js'
import { SSEClientTransport } from '@modelcontextprotocol/sdk/client/sse.js'
import { encode } from '@toon-format/toon'

// Initialize MCP client with Bright Data (ecommerce group for Amazon tools)
const transport = new SSEClientTransport(
  new URL('https://mcp.brightdata.com/sse?token=YOUR_API_TOKEN&groups=ecommerce')
)

const client = new Client({
  name: 'toon-example-client',
  version: '1.0.0'
})

await client.connect(transport)

// Fetch Amazon product data using MCP (with timeout for slow responses)
const result = await client.callTool(
  {
    name: 'web_data_amazon_product',
    arguments: {
      url: 'https://www.amazon.com/dp/B0EXAMPLE123'
    }
  },
  undefined,
  { timeout: 120000 } // 2 minutes timeout
)

// The MCP response is an array with nested product data
const mcpResponse = JSON.parse(result.content[0].text)
console.log('Raw MCP Response:', JSON.stringify(mcpResponse, null, 2))
// [
//   {
//     "title": "Ceramic Vase Set of 3...",
//     "final_price": 29.99,
//     "initial_price": 29.99,
//     "currency": "USD",
//     "rating": 4.5,
//     "reviews_count": 1250,
//     "seller_name": "HomeDecorStore",
//     "brand": "Lyeec",
//     "is_available": true,
//     "asin": "B0G13HFJNB",
//     ...
//   }
// ]

// Flatten the nested data for TOON optimization
// Map actual MCP field names to flat structure
function flattenProduct(product: any) {
  return {
    title: product.title,
    price: product.final_price,
    original_price: product.initial_price,
    currency: product.currency,
    rating: product.rating,
    reviews: product.reviews_count,
    seller: product.seller_name,
    brand: product.brand,
    in_stock: product.is_available
  }
}

// Response is an array - flatten all products
const flatProducts = mcpResponse.map(flattenProduct)

// Encode to TOON - now it's efficient!
const toonOutput = encode({ products: flatProducts })
console.log('TOON Output:', toonOutput)
// products[1]{title,price,original_price,currency,rating,reviews,seller,brand,in_stock}:
//   Ceramic Vase Set of 3...,29.99,29.99,USD,4.5,1250,HomeDecorStore,Lyeec,true

// Use the TOON-encoded data in your LLM prompt
const prompt = `Analyze this product data and suggest pricing strategy:\n\n${toonOutput}`
```

### Batch Processing Multiple Products

For larger datasets, the token savings become even more significant:

```typescript theme={null}
import { Client } from '@modelcontextprotocol/sdk/client/index.js'
import { SSEClientTransport } from '@modelcontextprotocol/sdk/client/sse.js'
import { encode } from '@toon-format/toon'

const transport = new SSEClientTransport(
  new URL('https://mcp.brightdata.com/sse?token=YOUR_API_TOKEN&groups=ecommerce')
)

const client = new Client({ name: 'batch-example', version: '1.0.0' })
await client.connect(transport)

// Fetch multiple products
const productUrls = [
  'https://www.amazon.com/dp/B0EXAMPLE1',
  'https://www.amazon.com/dp/B0EXAMPLE2',
  'https://www.amazon.com/dp/B0EXAMPLE3'
]

const results = await Promise.all(
  productUrls.map(async (url) => {
    const result = await client.callTool(
      { name: 'web_data_amazon_product', arguments: { url } },
      undefined,
      { timeout: 120000 }
    )
    // MCP returns an array, get the first item
    return JSON.parse(result.content[0].text)[0]
  })
)

// Flatten all products for TOON using actual MCP field names
const flattenedProducts = results.map(p => ({
  title: p.title,
  price: p.final_price,
  currency: p.currency,
  rating: p.rating,
  reviews: p.reviews_count,
  seller: p.seller_name,
  brand: p.brand,
  in_stock: p.is_available
}))

// Convert to TOON - massive token savings with multiple items!
const toonData = encode({ products: flattenedProducts })
console.log(toonData)
// products[3]{title,price,currency,rating,reviews,seller,brand,in_stock}:
//   Wireless Mouse,29.99,USD,4.5,1250,TechGear,Logitech,true
//   Gaming Keyboard,89.99,USD,4.7,890,KeyMaster,Razer,true
//   USB Hub,19.99,USD,4.2,2100,PortPlus,Anker,false

// Token comparison for 3 products:
// - JSON: ~180 tokens
// - TOON: ~65 tokens (64% savings!)
```

### Creating a Reusable Flattener

For production use, create a reusable utility with the correct MCP field mappings:

```typescript theme={null}
import { encode } from '@toon-format/toon'

// Generic flattener for common MCP data structures
// These map the actual field names returned by Bright Data MCP
const flatteners = {
  amazon_product: (p: any) => ({
    title: p.title,
    price: p.final_price,
    original_price: p.initial_price,
    currency: p.currency,
    rating: p.rating,
    reviews: p.reviews_count,
    seller: p.seller_name,
    brand: p.brand,
    in_stock: p.is_available
  }),

  linkedin_profile: (p: any) => ({
    name: p.full_name,
    headline: p.headline,
    location: p.city,
    country: p.country,
    connections: p.connections_count,
    followers: p.followers_count,
    company: p.current_company_name,
    position: p.position
  }),

  instagram_post: (p: any) => ({
    caption: p.description?.substring(0, 100),
    likes: p.likes,
    comments: p.comments,
    posted: p.upload_date,
    author: p.channel
  })
}

// Helper to process MCP response and convert to TOON
function mcpToToon<T>(
  data: T | T[],
  flattener: (item: T) => Record<string, any>,
  key: string = 'items'
): string {
  const items = Array.isArray(data) ? data : [data]
  const flattened = items.map(flattener)
  return encode({ [key]: flattened })
}

// Usage example
const result = await client.callTool(
  { name: 'web_data_amazon_product', arguments: { url: '...' } },
  undefined,
  { timeout: 120000 }
)
const mcpData = JSON.parse(result.content[0].text)
const toonOutput = mcpToToon(mcpData, flatteners.amazon_product, 'products')
```

***

## Summary

<CardGroup>
  <Card title="Use TOON For" icon="check">
    * Flat, uniform arrays
    * Tabular data structures
    * Large datasets with repeated schemas
    * Post-processed, flattened MCP data
  </Card>

  <Card title="Avoid TOON For" icon="xmark">
    * Deeply nested objects
    * Non-uniform data structures
    * Direct MCP endpoint responses
    * Complex hierarchical data
  </Card>
</CardGroup>

<Info>
  **Bottom Line:** TOON is a powerful tool for token optimization, but it's designed for flat, uniform data. Bright Data MCP responses are typically nested, so apply TOON only after flattening the data to a tabular structure.
</Info>

***

## Where to learn more

<CardGroup>
  <Card title="TOON Specification" icon="book" href="https://github.com/toon-format/spec">
    Official format specification
  </Card>

  <Card title="TypeScript SDK" icon="npm" href="https://www.npmjs.com/package/@toon-format/toon">
    NPM package documentation
  </Card>

  <Card title="TOON Website" icon="globe" href="https://toonformat.dev">
    Interactive playground and docs
  </Card>
</CardGroup>


# MCP usage examples
Source: https://docs.brightdata.com/ai/mcp-server/usage-examples

Browse community demos and reference projects built on the Bright Data MCP server (60+ tools), covering AI agents, scraping pipelines and integrations.

<Card title="Building an AI startup?" href="https://brightdata.com/ai/ai-startups-program" icon="rocket-launch">
  You might be eligible for our Startup Program. Get fully funded access to the infrastructure you're reading about right now (up to \$20K value).
</Card>

1. AI voice agent that closed 4 deals & made \$596 overnight 🤑

* <Icon icon="github" />   [GitHub Repo](https://github.com/llSourcell/my_ai_intern)

* <Icon icon="youtube" />   [YouTube Demo](https://www.youtube.com/watch?v=YGzT3sVdwdY)

<iframe title="AI voice agent that closed 4 deals & made $596 overnight" />

***

2. LangGraph with mcp-adapters demo

* <Icon icon="github" />   [GitHub Repo](https://github.com/techwithtim/BrightDataMCPServerAgent)

* <Icon icon="youtube" />   [YouTube Demo](https://www.youtube.com/watch?v=6DXuadyaJ4g)

<iframe title="LangGraph with mcp-adapters demo" />

***

3. Researcher Agent built with Google ADK that is connected to Bright Data's MCP to fetch real-time data

* <Icon icon="github" />   [GitHub Repo](https://github.com/MeirKaD/MCP_ADK)

* <Icon icon="youtube" />   [YouTube Demo](https://www.youtube.com/watch?v=r7WG6dXWdUI)

<iframe title="Researcher Agent with Google ADK using Bright Data MCP" />

***

4. Multi-Agent job finder using Bright Data MCP and TypeScript from SCRATCH

* <Icon icon="github" />   [GitHub Repo](https://github.com/bitswired/jobwizard)

* <Icon icon="youtube" />   [YouTube Demo](https://www.youtube.com/watch?v=45OtteCGFiI)

<iframe title="Multi-Agent job finder with Bright Data MCP and TypeScript" />

***

5. Replacing 3 MCP servers with our MCP server to avoid getting blocked 🤯

* <Icon icon="youtube" />   [YouTube Demo](https://www.youtube.com/watch?v=0xmE0OJrNmg)

<iframe title="Replacing 3 MCP servers with Bright Data MCP server" />

***

6. Scrape ANY Website In Realtime With This Powerful AI MCP Server

* <Icon icon="youtube" />   [YouTube Demo](https://www.youtube.com/watch?v=bL5JIeGL3J0)

<iframe title="Scrape any website in realtime with Bright Data MCP server" />

***

7. Usage example with Gemini CLI

* <Icon icon="youtube" />   [YouTube Demo](https://www.youtube.com/watch?v=FE1LChbgFEw)

<iframe title="Usage example with Gemini CLI and Bright Data MCP" />


# Training data for AI models
Source: https://docs.brightdata.com/ai/training

Technical overview of Bright Data infrastructure (1000+ scrapers) for building AI training data pipelines: large-scale acquisition, extraction and delivery.

<Card title="Building an AI startup?" href="https://brightdata.com/ai/ai-startups-program" icon="rocket-launch">
  You might be eligible for our Startup Program. Get fully funded access to the infrastructure you're reading about right now (up to \$20K value).
</Card>

## Training Data for AI Models: A Technical Guide

Acquiring high-quality, large-scale training data is a critical challenge for AI engineers. This guide provides a comprehensive technical overview of Bright Data's infrastructure for building and managing data acquisition pipelines, designed to help you make informed decisions and get started quickly.

## Technical Quick Reference

| Feature             | Specification                                                                                                                                                |
| ------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| **Data Formats**    | `JSON`, `NDJSON`, `CSV`, `XLSX`, and `Parquet`. Specify your desired format in the API request.                                                              |
| **Authentication**  | All API requests are authenticated using a bearer token. Include your API key in the `Authorization` header.                                                 |
| **Data Freshness**  | **Archive:** Historical. **Pre-collected:** Updated daily, weekly, or monthly. **Custom:** On-demand, near real-time.                                        |
| **Compliance**      | GDPR, CCPA, and SOC2 compliant. We adhere to a strict ethical framework for all data collection. See our [Trust Center](https://brightdata.com/trustcenter). |
| **Developer Tools** | We provide SDKs for [**Python**](/api-reference/SDK-PY) and [**Javascript**](/api-reference/SDK-JS).                                                         |
| **Free Trial**      | Sign up and receive a credit to test Bright Data. Download data samples for any dataset before purchasing.                                                   |

## Data Acquisition Strategies

Your strategy for data acquisition depends on your model's needs. Choose the method that best fits your use case, from foundational training to specialized, real-time data collection.

<Tabs>
  <Tab title="Web Archive">
    **Best for:** Foundational, large-scale model training.

    The Web Archive provides access to a petabyte-scale repository of historical web data, making it the ideal source for training large language and diffusion models that require a comprehensive understanding of the digital world.

    * **Use Case:** Pre-training LLMs, historical analysis, building base models.
    * **Next Step:** [Contact our data experts](https://brightdata.com/ai/video-data#popup-170970) for access and pricing.
    * **Learn More:** [Web Archive Documentation](/datasets/archive/overview)
  </Tab>

  <Tab title="Pre-collected Datasets">
    **Best for:** Fine-tuning models on specific domains.

    Our curated datasets provide structured, high-quality data across numerous industries, allowing you to efficiently specialize your model for specific tasks without the overhead of data collection.

    * **Use Case:** Fine-tuning, industry-specific models, market research.
    * **Pricing:** Starts from **\$250 per 100,000 records**.
    * **Quality:** Rigorously validated. Free samples are available for evaluation.
    * **Next Step:** [Explore Datasets](/datasets/marketplace/dataset-view)
  </Tab>

  <Tab title="Custom Collection">
    **Best for:** Fresh, on-demand data from specific sources.

    Initiate programmatic data collection jobs to get real-time, structured data from any public URL. This gives you complete control over the freshness and specificity of your training data.

    * **Use Case:** Real-time applications, tracking dynamic data, custom knowledge bases.
    * **Pricing:** Based on the complexity and scale of the request.
    * **Next Step:** [Contact us for a custom quote](https://brightdata.com/ai/video-data#popup-170970).
    * **Learn More:** [Custom Dataset API Documentation](/datasets/scrapers/custom-scrapers/custom-dataset-api)

    **API Example:**

    ```bash theme={null}
    curl "https://api.brightdata.com/datasets/initiate?dataset_id=YOUR_DATASET_ID&type=url_collection&view=YOUR_VIEW_ID" \
      -H "Authorization: Bearer YOUR_API_KEY" \
      -H "Content-Type: application/json" \
      -d '[{"url":"https://example.com"}]'
    ```
  </Tab>

  <Tab title="Video & Media">
    **Best for:** Training multimodal models at scale.

    Overcome the limitations of tools like `yt-dlp` by using our resilient infrastructure. The Web Unlocker API handles rate limits, geo-restrictions, and bot detection to ensure a reliable video data pipeline.

    * **Use Case:** Training video, audio, and image models.
    * **KYC Required:** Access requires a Know Your Customer process to ensure ethical and compliant data sourcing due to the sensitive nature of media content.
    * **Next Step:** [Book a meeting with our data experts](https://brightdata.com/ai/video-data#popup-170970) to begin the approval process.
    * **API Reference:** [Media Data API](/api-reference/media-data-api/media-data-api), download video, audio, captions, thumbnails, and storyboards from YouTube, Vimeo, TikTok, and Bilibili.
  </Tab>
</Tabs>

## How data is delivered

Once your data is collected, it can be delivered to a variety of destinations to seamlessly integrate with your existing cloud infrastructure.

**Supported Delivery Options:**

* Amazon S3
* Google Cloud Storage
* Microsoft Azure Storage
* Webhook
* SFTP/FTP
* Snowflake
* API Download

For detailed instructions on setting up your preferred delivery method, please see our [Delivery Options documentation](/datasets/scrapers/scrapers-library/delivery-options).


# Python SDK
Source: https://docs.brightdata.com/api-reference/SDK

Install the Bright Data Python SDK (1000+ scrapers) to scrape URLs, search the web, run platform scrapers and connect Playwright to the Browser API.

This guide shows how to install the Bright Data Python SDK and call every feature it exposes: URL scraping, search engines, platform-specific scrapers (LinkedIn, Amazon, Instagram, TikTok, YouTube, Reddit, Pinterest, ChatGPT, Perplexity, Digikey), the Discover API, Scraper Studio, datasets, and the Browser API.

<img alt="Final Banner Pn" />

## Installation and setup

Install the package via pip:

```bash theme={null}
pip install brightdata-sdk
```

### Configuration

You must provide your API token. You can find it in your [Bright Data Control Panel](https://brightdata.com/cp/api_keys).

**Option 1: Environment variable (recommended)**

```bash theme={null}
export BRIGHTDATA_API_TOKEN="your_api_token_here"
```

**Option 2: Direct initialization**

```python theme={null}
# Async client
from brightdata import BrightDataClient

async with BrightDataClient(token="your_api_token_here") as client:
    ...

# Sync client
from brightdata import SyncBrightDataClient

with SyncBrightDataClient(token="your_api_token_here") as client:
    ...
```

## Basic usage

Use `SyncBrightDataClient` for simple scripts. Use `BrightDataClient` with asyncio for high-concurrency workloads.

<CodeGroup>
  ```python Synchronous theme={null}
  from brightdata import SyncBrightDataClient

  with SyncBrightDataClient() as client:
      # Scrape a URL
      data = client.scrape_url("https://example.com")
      print(f"Result: {data.data}")

      # Search Google
      search = client.search.google(query="Bright Data")
      print(f"Found: {len(search.data)}")
  ```

  ```python Asynchronous theme={null}
  import asyncio
  from brightdata import BrightDataClient

  async def main():
      async with BrightDataClient() as client:
          result = await client.scrape_url("https://example.com")
          print(result.data)

          search = await client.search.google(query="Bright Data")
          print(f"Found: {len(search.data)}")

  if __name__ == "__main__":
      asyncio.run(main())
  ```
</CodeGroup>

## Launch scrapes and web searches

<CodeGroup>
  ```python Search Engines theme={null}
  from brightdata import BrightDataClient

  client = BrightDataClient()

  # Google search
  results = client.search.google(
      query="best shoes of 2025",
      location="United States",
      language="en",
      num_results=20
  )

  # Bing search
  results = client.search.bing(
      query="python tutorial",
      location="United States"
  )

  # Yandex search
  results = client.search.yandex(
      query="latest news",
      location="Germany"
  )

  if results.success:
      print(f"Cost: ${results.cost:.4f}")
      print(f"Time: {results.elapsed_ms():.2f}ms")
  ```

  ```python Web Scraping theme={null}
  from brightdata import BrightDataClient

  client = BrightDataClient()

  # Scrape single URL
  result = client.scrape_url("https://example.com")

  # Scrape multiple URLs concurrently
  urls = [
      "https://example1.com",
      "https://example2.com",
      "https://example3.com"
  ]
  results = client.scrape_url(urls)

  for r in results:
      if r.success:
          print(f"Success: {r.data[:200]}...")
          r.save_to_file(f"result_{hash(r.data)}.json")
  ```
</CodeGroup>

<Check>
  When working with multiple queries or URLs, requests are handled concurrently for optimal performance.
</Check>

## Use platform-specific scrapers for structured data

Extract structured data from Amazon, LinkedIn, Facebook, Instagram, TikTok, YouTube, Reddit, Pinterest, ChatGPT, Perplexity, and Digikey.

<CodeGroup>
  ```python Amazon theme={null}
  # Async
  from brightdata import BrightDataClient

  async with BrightDataClient() as client:
      products = await client.scrape.amazon.products(url="https://amazon.com/dp/B0CRMZHDG8")
      reviews = await client.scrape.amazon.reviews(
          url="https://amazon.com/dp/B0CRMZHDG8",
          pastDays=30,
          keyWord="quality"
      )
      sellers = await client.scrape.amazon.sellers(
          url="https://amazon.com/sp?seller=AXXXXXXXXXXX"
      )

  # Sync
  from brightdata import SyncBrightDataClient

  with SyncBrightDataClient() as client:
      products = client.scrape.amazon.products(url="https://amazon.com/dp/B0CRMZHDG8")
      reviews = client.scrape.amazon.reviews(
          url="https://amazon.com/dp/B0CRMZHDG8",
          pastDays=30,
          keyWord="quality"
      )
      sellers = client.scrape.amazon.sellers(
          url="https://amazon.com/sp?seller=AXXXXXXXXXXX"
      )
  ```

  ```python LinkedIn theme={null}
  # Async: collect by URL, then discover by parameters
  from brightdata import BrightDataClient

  async with BrightDataClient() as client:
      profiles = await client.scrape.linkedin.profiles(
          url="https://www.linkedin.com/in/johndoe"
      )
      companies = await client.scrape.linkedin.companies(
          url="https://www.linkedin.com/company/bright-data"
      )
      jobs = await client.scrape.linkedin.jobs(
          url="https://www.linkedin.com/jobs/view/123456"
      )
      posts = await client.scrape.linkedin.posts(
          url="https://www.linkedin.com/feed/update/urn:li:activity:123"
      )

      # Discover by parameters
      job_results = await client.search.linkedin.jobs(
          keyword="python developer",
          location="New York",
          remote=True
      )
      profile_results = await client.search.linkedin.profiles(
          firstName="John",
          lastName="Doe"
      )

  # Sync
  from brightdata import SyncBrightDataClient

  with SyncBrightDataClient() as client:
      profiles = client.scrape.linkedin.profiles(url="https://www.linkedin.com/in/johndoe")
      companies = client.scrape.linkedin.companies(
          url="https://www.linkedin.com/company/bright-data"
      )
      jobs = client.scrape.linkedin.jobs(url="https://www.linkedin.com/jobs/view/123456")
      posts = client.scrape.linkedin.posts(
          url="https://www.linkedin.com/feed/update/urn:li:activity:123"
      )
  ```

  ```python Facebook & Instagram theme={null}
  # Async
  from brightdata import BrightDataClient

  async with BrightDataClient() as client:
      await client.scrape.facebook.posts_by_profile(
          url="https://www.facebook.com/nasa", num_of_posts=10
      )
      await client.scrape.facebook.posts_by_group(
          url="https://www.facebook.com/groups/example"
      )
      await client.scrape.facebook.posts_by_url(
          url="https://www.facebook.com/post/123456"
      )
      await client.scrape.facebook.comments(
          url="https://www.facebook.com/post/123456", num_of_comments=100
      )
      await client.scrape.facebook.reels(url="https://www.facebook.com/nasa")

      await client.scrape.instagram.profiles(url="https://www.instagram.com/nasa/")
      await client.scrape.instagram.posts(url="https://www.instagram.com/p/Cuf4s0MNqNr")
      await client.scrape.instagram.reels(
          url="https://www.instagram.com/reel/C5Rdyj_q7YN/"
      )
      await client.scrape.instagram.comments(
          url="https://www.instagram.com/p/CesFC7JLyFl/"
      )

  # Sync
  from brightdata import SyncBrightDataClient

  with SyncBrightDataClient() as client:
      client.scrape.facebook.posts_by_profile(
          url="https://www.facebook.com/nasa", num_of_posts=10
      )
      client.scrape.instagram.profiles(url="https://www.instagram.com/nasa/")
  ```

  ```python TikTok theme={null}
  # Async
  from brightdata import BrightDataClient

  async with BrightDataClient() as client:
      profiles = await client.scrape.tiktok.profiles(
          url="https://www.tiktok.com/@username"
      )
      posts = await client.scrape.tiktok.posts(
          url="https://www.tiktok.com/@user/video/7433494424040017194"
      )
      comments = await client.scrape.tiktok.comments(
          url="https://www.tiktok.com/@user/video/7216019547806092550"
      )
      fast_posts = await client.scrape.tiktok.posts_by_profile_fast(
          url="https://www.tiktok.com/@bbc"
      )
      search = await client.scrape.tiktok.posts_by_search_url_fast(
          url="https://www.tiktok.com/search?q=cats", num_of_posts=10
      )
  ```

  ```python YouTube theme={null}
  # Async
  from brightdata import BrightDataClient

  async with BrightDataClient() as client:
      videos = await client.scrape.youtube.videos(
          url="https://www.youtube.com/watch?v=dQw4w9WgXcQ",
          transcription_language="English"
      )
      channels = await client.scrape.youtube.channels(
          url="https://www.youtube.com/@MrBeast/about"
      )
      comments = await client.scrape.youtube.comments(
          url="https://www.youtube.com/watch?v=dQw4w9WgXcQ", num_of_comments=100
      )
  ```

  ```python Reddit theme={null}
  # Async
  from brightdata import BrightDataClient

  async with BrightDataClient() as client:
      posts = await client.scrape.reddit.posts(
          url="https://www.reddit.com/r/python/comments/abc123/"
      )
      by_keyword = await client.scrape.reddit.posts_by_keyword(
          keyword="machine learning", sort_by="Top", date="Past week"
      )
      by_subreddit = await client.scrape.reddit.posts_by_subreddit(
          url="https://www.reddit.com/r/datascience/"
      )
      comments = await client.scrape.reddit.comments(
          url="https://www.reddit.com/r/python/comments/abc123/", days_back=30
      )
  ```

  ```python Pinterest theme={null}
  # Async
  from brightdata import BrightDataClient

  async with BrightDataClient() as client:
      posts = await client.scrape.pinterest.posts(
          url="https://www.pinterest.com/pin/3166662230556591/"
      )
      profiles = await client.scrape.pinterest.profiles(
          url="https://www.pinterest.com/boredpanda/"
      )

      # Discover by parameters
      by_keyword = await client.search.pinterest.posts_by_keyword(
          keyword="spaghetti recipes"
      )
      by_profile = await client.search.pinterest.posts_by_profile(
          url="https://www.pinterest.com/grandmapowpow/", num_of_posts=20
      )

  # Sync
  from brightdata import SyncBrightDataClient

  with SyncBrightDataClient() as client:
      posts = client.scrape.pinterest.posts(
          url="https://www.pinterest.com/pin/3166662230556591/"
      )
      profiles = client.scrape.pinterest.profiles(
          url="https://www.pinterest.com/boredpanda/"
      )
  ```

  ```python ChatGPT theme={null}
  # Async
  from brightdata import BrightDataClient

  async with BrightDataClient() as client:
      result = await client.scrape.chatgpt.prompt(
          prompt="Explain async programming", web_search=True
      )
      batch = await client.scrape.chatgpt.prompts(
          prompts=["Explain Python", "Explain JavaScript"]
      )

  # Sync
  from brightdata import SyncBrightDataClient

  with SyncBrightDataClient() as client:
      result = client.scrape.chatgpt.prompt(
          prompt="Explain async programming", web_search=True
      )
      batch = client.scrape.chatgpt.prompts(
          prompts=["Explain Python", "Explain JavaScript"]
      )
  ```

  ```python Digikey & Perplexity theme={null}
  from brightdata import BrightDataClient

  async with BrightDataClient() as client:
      parts = await client.scrape.digikey.products(
          url="https://www.digikey.com/en/products/detail/abc"
      )
      answer = await client.scrape.perplexity.search(
          url="https://www.perplexity.ai/search?q=battery+tech"
      )
  ```
</CodeGroup>

## Search the web with AI-powered ranking (Discover API)

```python theme={null}
# Async
from brightdata import BrightDataClient

async with BrightDataClient() as client:
    result = await client.discover(
        query="AI trends 2026",
        intent="latest technology developments"
    )
    # result.data is [{ title, link, description, relevance_score }]

    # Manual: trigger, wait, fetch
    job = await client.discover_trigger(
        query="SaaS pricing",
        intent="competitor pricing strategies"
    )
    await job.wait(timeout=60)
    data = await job.fetch()

# Sync
from brightdata import SyncBrightDataClient

with SyncBrightDataClient() as client:
    result = client.discover(
        query="AI trends 2026",
        intent="latest technology developments"
    )
```

## Run your custom Scraper Studio scrapers

```python theme={null}
# Async
from brightdata import BrightDataClient

async with BrightDataClient() as client:
    data = await client.scraper_studio.run(
        collector="c_abc123",
        input={"url": "https://example.com/product/1"}
    )
    job = await client.scraper_studio.trigger(
        "c_abc123", {"url": "https://example.com/product/1"}
    )
    data = await job.wait_and_fetch(timeout=120)
    status = await client.scraper_studio.status("j_abc123")

# Sync
from brightdata import SyncBrightDataClient

with SyncBrightDataClient() as client:
    data = client.scraper_studio.run(
        collector="c_abc123",
        input={"url": "https://example.com/product/1"}
    )
    status = client.scraper_studio.status("j_abc123")
```

## Datasets API

Access pre-collected data snapshots.

```python theme={null}
from brightdata import SyncBrightDataClient

with SyncBrightDataClient() as client:
    # 1. Request snapshot with filters
    print("Requesting snapshot...")
    snapshot_id = client.datasets.imdb_movies(
        filter={"name": "year", "operator": "=", "value": 2024},
        records_limit=10
    )

    # 2. Download (SDK polls automatically)
    print(f"Snapshot {snapshot_id} ready. Downloading...")
    data = client.datasets.imdb_movies.download(snapshot_id)
    print(f"Downloaded {len(data)} records.")
```

<Tip>
  In your IDE, hover over the `BrightDataClient` class or **any of its methods** to view available parameters, type hints, and usage examples. The SDK provides full IntelliSense support.
</Tip>

## Use dataclass payloads for type safety

The SDK includes dataclass payloads with runtime validation and helper properties.

```python theme={null}
from brightdata import BrightDataClient
from brightdata.payloads import (
    AmazonProductPayload,
    LinkedInJobSearchPayload,
    ChatGPTPromptPayload
)

client = BrightDataClient()

# Amazon product with validation
amazon_payload = AmazonProductPayload(
    url="https://amazon.com/dp/B123456789",
    reviews_count=50  # Runtime validated.
)
print(f"ASIN: {amazon_payload.asin}")  # Helper property
print(f"Domain: {amazon_payload.domain}")

# LinkedIn job search
linkedin_payload = LinkedInJobSearchPayload(
    keyword="python developer",
    location="San Francisco",
    remote=True
)
print(f"Remote search: {linkedin_payload.is_remote_search}")

# Use with client
result = client.scrape.amazon.products(**amazon_payload.to_dict())
```

## Connect to scraping browser

Connect Playwright to Bright Data's cloud browser via the Browser API.

```python theme={null}
from brightdata import BrightDataClient
from playwright.async_api import async_playwright

client = BrightDataClient(
    browser_username="brd-customer-xxxx-zone-scraping_browser1",
    browser_password="YOUR_ZONE_PASSWORD",
)

async with async_playwright() as pw:
    browser = await pw.chromium.connect_over_cdp(client.browser.get_connect_url())
    page = await browser.new_page()
    await page.goto("https://example.com", timeout=120000)
    print(await page.content())
    await browser.close()
```

## Use the CLI tool

The SDK includes a command-line interface for terminal usage.

```bash theme={null}
# Search operations
brightdata search google "python tutorial" --location "United States"
brightdata search linkedin jobs --keyword "python developer" --remote

# Scrape operations
brightdata scrape amazon products "https://amazon.com/dp/B123"
brightdata scrape linkedin profiles "https://linkedin.com/in/johndoe"

# Generic web scraping
brightdata scrape generic "https://example.com" --output-format pretty

# Save results to file
brightdata search google "AI news" --output-file results.json
```

## Async usage for better performance

For concurrent operations, pass a list of URLs to `scrape_url` and run inside an async context manager.

```python theme={null}
import asyncio
from brightdata import BrightDataClient

async def main():
    async with BrightDataClient() as client:
        results = await client.scrape_url([
            "https://example1.com",
            "https://example2.com",
            "https://example3.com",
        ], mode="async", poll_timeout=180)

        for result in results:
            print(result.data)

asyncio.run(main())
```

## Resources

<CardGroup>
  <Card title="GitHub repository" icon="github" href="https://github.com/brightdata/sdk-python">
    View source code, examples, and contribute
  </Card>

  <Card title="Examples directory" icon="code" href="https://github.com/brightdata/sdk-python/tree/main/examples">
    10+ working examples for all features
  </Card>

  <Card title="PyPI page" icon="box" href="https://pypi.org/project/brightdata-sdk/">
    Package listing and release history
  </Card>
</CardGroup>

## What's new

| Feature              | Description                                                                                                                                             |
| -------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Discover API**     | `client.discover()` / `client.discover_trigger()`. AI-powered web search with intent-based relevance ranking. Available on both sync and async clients. |
| **Scraper Studio**   | `client.scraper_studio.run/trigger/status()`. Trigger and fetch your custom Scraper Studio scrapers. Available on both sync and async clients.          |
| **Browser API**      | `client.browser.get_connect_url()`. Connect Playwright/Puppeteer to Bright Data's cloud browser. Replaces `client.connect_browser()`.                   |
| **New scrapers**     | TikTok, YouTube, Reddit, Pinterest, Digikey, Perplexity added to `client.scrape.*`                                                                      |
| **Platform search**  | `client.search.linkedin` / `amazon` / `instagram` / `tiktok` / `youtube` / `pinterest` / `chatgpt`. Discover content by parameters, not just URLs.      |
| **126+ Datasets**    | Full catalog via `client.datasets.*` with `.sample()` and `.download()`                                                                                 |
| **Full sync parity** | `SyncBrightDataClient` now covers all features: scrapers, search, discover, scraper studio, browser                                                     |


# JavaScript SDK
Source: https://docs.brightdata.com/api-reference/SDK-JS

Install and use the Bright Data JavaScript SDK (1000+ scrapers) to scrape URLs, search Google/Bing/Yandex and connect to the Browser API from Node.js.

This guide shows how to install the Bright Data JavaScript SDK, scrape URLs, run searches, call platform-specific scrapers (LinkedIn, Amazon, Instagram, and more), and connect to the Browser API and Scraper Studio from Node.js.

## Install the package

Open the terminal and run:

```bash theme={null}
npm install @brightdata/sdk
```

In your code file, import the package and launch your first requests:

```javascript theme={null}
import { bdclient } from '@brightdata/sdk';

const client = new bdclient({ apiKey: 'YOUR_API_KEY' });

const html = await client.scrapeUrl('https://example.com');
const google = await client.search.google('pizza restaurants');

console.log(google);
await client.close();
```

## Launch scrapes and web searches

<CodeGroup>
  ```javascript search(...) theme={null}
  import { bdclient } from '@brightdata/sdk';

  const client = new bdclient({ apiKey: 'YOUR_API_KEY' });

  const google = await client.search.google('best laptops 2026');
  const bing = await client.search.bing('python tutorial');
  const yandex = await client.search.yandex('AI news');

  console.log({ google, bing, yandex });
  await client.close();
  ```

  ```javascript scrape(...) theme={null}
  import { bdclient } from '@brightdata/sdk';

  const client = new bdclient({ apiKey: 'YOUR_API_KEY' });

  const html = await client.scrapeUrl('https://example.com');
  const md = await client.scrapeUrl('https://example.com', {
      dataFormat: 'markdown',
      country: 'us',
  });

  console.log({ html, md });
  await client.close();
  ```
</CodeGroup>

## Platform scrapers and datasets

Collect data from popular platforms by URL, or discover content by parameters.

<CodeGroup>
  ```javascript LinkedIn theme={null}
  import { bdclient } from '@brightdata/sdk';

  const client = new bdclient({ apiKey: 'YOUR_API_KEY' });

  // Collect by URL
  const profiles = await client.scrape.linkedin.collectProfiles([
      'https://www.linkedin.com/in/satyanadella/',
  ]);
  const companies = await client.scrape.linkedin.collectCompanies([
      'https://www.linkedin.com/company/bright-data',
  ]);
  const jobs = await client.scrape.linkedin.collectJobs([
      'https://www.linkedin.com/jobs/view/123456',
  ]);
  const posts = await client.scrape.linkedin.collectPosts([
      'https://www.linkedin.com/feed/update/urn:li:activity:123',
  ]);

  // Discover by parameters
  const byKeyword = await client.scrape.linkedin.discoverJobs(
      [{ keyword: 'python developer', location: 'New York', remote: true }],
      {}
  );
  const byName = await client.scrape.linkedin.discoverProfiles(
      [{ firstName: 'John', lastName: 'Doe' }],
      {}
  );
  const compPosts = await client.scrape.linkedin.discoverCompanyPosts(
      [{ url: 'https://www.linkedin.com/company/bright-data' }],
      {}
  );
  const userPosts = await client.scrape.linkedin.discoverUserPosts(
      [{ url: 'https://www.linkedin.com/in/satyanadella' }],
      {}
  );
  ```

  ```javascript Amazon theme={null}
  import { bdclient } from '@brightdata/sdk';

  const client = new bdclient({ apiKey: 'YOUR_API_KEY' });

  // Collect by URL
  const products = await client.scrape.amazon.collectProducts(
      ['https://www.amazon.com/dp/B0D77BX8Y4'],
      {}
  );
  const reviews = await client.scrape.amazon.collectReviews(
      ['https://www.amazon.com/dp/B0D77BX8Y4'],
      {}
  );
  const sellers = await client.scrape.amazon.collectSellers(
      ['https://www.amazon.com/sp?seller=AXXX'],
      {}
  );

  // Discover by parameters
  const byKeyword = await client.scrape.amazon.discoverProductsByKeyword(
      [{ keyword: 'wireless headphones' }],
      {}
  );
  const byCategory = await client.scrape.amazon.discoverProductsByCategoryURL(
      ['https://amazon.com/s?category=electronics'],
      {}
  );
  const byBSUrl = await client.scrape.amazon.discoverProductsByBestSellerURL(
      ['https://amazon.com/gp/bestsellers/electronics'],
      {}
  );

  // One-call orchestrated (trigger, poll, and return)
  const result = await client.scrape.amazon.products([
      'https://www.amazon.com/dp/B0D77BX8Y4',
  ]);
  ```

  ```javascript Instagram theme={null}
  const profiles = await client.scrape.instagram.collectProfiles([
      'https://www.instagram.com/natgeo/',
  ]);
  const posts = await client.scrape.instagram.collectPosts([
      'https://www.instagram.com/p/ABC123/',
  ]);
  const reels = await client.scrape.instagram.collectReels([
      'https://www.instagram.com/reel/XYZ789/',
  ]);
  const comments = await client.scrape.instagram.collectComments([
      'https://www.instagram.com/p/ABC123/',
  ]);
  ```

  ```javascript Facebook theme={null}
  const profilePosts = await client.scrape.facebook.collectPostsByProfile([
      'https://www.facebook.com/nasa',
  ]);
  const groupPosts = await client.scrape.facebook.collectPostsByGroup([
      'https://www.facebook.com/groups/example',
  ]);
  const postByUrl = await client.scrape.facebook.collectPostsByUrl([
      'https://www.facebook.com/post/123456',
  ]);
  const comments = await client.scrape.facebook.collectComments([
      'https://www.facebook.com/post/123456',
  ]);
  const reels = await client.scrape.facebook.collectReels([
      'https://www.facebook.com/nasa',
  ]);
  ```

  ```javascript TikTok theme={null}
  const profiles = await client.scrape.tiktok.collectProfiles([
      'https://www.tiktok.com/@tiktok',
  ]);
  const posts = await client.scrape.tiktok.collectPosts([
      'https://www.tiktok.com/@user/video/7433494424040017194',
  ]);
  const comments = await client.scrape.tiktok.collectComments([
      'https://www.tiktok.com/@user/video/7216019547806092550',
  ]);
  ```

  ```javascript YouTube theme={null}
  const videos = await client.scrape.youtube.collectVideos([
      'https://www.youtube.com/watch?v=dQw4w9WgXcQ',
  ]);
  ```

  ```javascript Reddit theme={null}
  const posts = await client.scrape.reddit.collectPosts([
      'https://www.reddit.com/r/technology/top/',
  ]);
  ```

  ```javascript ChatGPT / Perplexity / Digikey / Pinterest theme={null}
  const chatgpt = await client.scrape.chatGPT.search([
      'What are the latest trends in AI?',
  ]);
  const perplexity = await client.scrape.perplexity.search([
      'Latest breakthroughs in battery tech?',
  ]);
  const parts = await client.scrape.digikey.collectProducts([
      'https://www.digikey.com/en/products/detail/abc',
  ]);
  const pins = await client.scrape.pinterest.collectPosts([
      'https://www.pinterest.com/pin/123456',
  ]);
  ```
</CodeGroup>

## Discover API

Search the web and get AI-ranked results in one call, or trigger and poll manually.

```javascript theme={null}
// One-shot: searches, polls, and returns AI-ranked results
const result = await client.discover('AI trends 2026', {
    intent: 'latest technology developments',
});
// result.data is [{ title, link, description, relevance_score }]

// Manual: trigger, wait, and fetch
const job = await client.discoverTrigger('SaaS pricing', {
    intent: 'competitor pricing strategies',
});
await job.wait({ timeout: 60_000 });
const data = await job.fetch();
```

## Scraper Studio

Run your custom Scraper Studio collectors from the SDK.

```javascript theme={null}
// Run and get results in one call
const results = await client.scraperStudio.run('c_your_collector_id', {
    input: { url: 'https://example.com/product/1' },
});
// results is [{ input, data, error, responseId, elapsedMs }]

// Manual: trigger, wait, and fetch
const job = await client.scraperStudio.trigger('c_your_collector_id', {
    url: 'https://example.com/product/1',
});
const data = await job.waitAndFetch();

// Check status
const status = await client.scraperStudio.status('j_abc123');
// status.status is 'queued' | 'running' | 'done' | 'failed'
```

## Browser API

Connect Playwright to Bright Data's cloud browser.

```javascript theme={null}
import { bdclient } from '@brightdata/sdk';
import { chromium } from 'playwright';

const client = new bdclient({
    apiKey: 'YOUR_API_KEY',
    browserUsername: 'brd-customer-xxxx-zone-scraping_browser1',
    browserPassword: 'YOUR_ZONE_PASSWORD',
});

const browser = await chromium.connectOverCDP(client.browser.getConnectUrl());
const page = await browser.newPage();
await page.goto('https://example.com');
await browser.close();
await client.close();
```

## Datasets API

Query and download from any of the 126+ Bright Data datasets.

```javascript theme={null}
const ds = client.datasets;

// Query, then download
const snapshotId = await ds.instagramProfiles.query(
    { url: 'https://www.instagram.com/natgeo/' },
    { records_limit: 10 }
);
const rows = await ds.instagramProfiles.download(snapshotId);

// Same pattern across the full catalog
await ds.amazonProducts.query({ url: 'https://amazon.com/dp/B123' });
await ds.linkedinProfiles.query({ url: 'https://linkedin.com/in/johndoe' });
await ds.imdbMovies.query({}, { records_limit: 50 });
await ds.redditPosts.query({ subreddit: 'technology' });
await ds.glassdoorReviews.query({ company: 'Bright Data' });

// Get field metadata
const meta = await ds.instagramProfiles.getMetadata();
```

## Client and method parameters

<AccordionGroup>
  <Accordion title="Client" description="Add client parameters" icon="circle-info">
    | Parameter           | Type      | Description                                                        | Default  |
    | ------------------- | --------- | ------------------------------------------------------------------ | -------- |
    | `apiKey`            | `string`  | Your API key (or `BRIGHTDATA_API_KEY` env var)                     | .        |
    | `autoCreateZones`   | `boolean` | Auto-create zones if they do not exist                             | `true`   |
    | `webUnlockerZone`   | `string`  | Custom Web Unlocker zone name                                      | .        |
    | `serpZone`          | `string`  | Custom SERP zone name                                              | .        |
    | `browserUsername`   | `string`  | Browser API username (or `BRIGHTDATA_BROWSERAPI_USERNAME` env var) | .        |
    | `browserPassword`   | `string`  | Browser API password (or `BRIGHTDATA_BROWSERAPI_PASSWORD` env var) | .        |
    | `logLevel`          | `string`  | Log level                                                          | `'INFO'` |
    | `structuredLogging` | `boolean` | Use structured JSON logging                                        | `true`   |
    | `verbose`           | `boolean` | Enable verbose logging                                             | `false`  |

    ```javascript theme={null}
    const client = new bdclient({
        apiKey: 'YOUR_API_KEY',
        autoCreateZones: true,
        webUnlockerZone: 'unlocker_zone1',
        serpZone: 'serp_zone1',
        browserUsername: 'brd-customer-xxxx-zone-scraping_browser1',
        browserPassword: 'YOUR_ZONE_PASSWORD',
        logLevel: 'INFO',
        structuredLogging: true,
        verbose: false,
    });
    ```
  </Accordion>

  <Accordion title="Search" description="Add advanced search parameters" icon="magnifying-glass-chart">
    Search the web using the SERP API.

    | Name                   | Type                                   | Description                               | Default    |
    | ---------------------- | -------------------------------------- | ----------------------------------------- | ---------- |
    | `query`                | `string \| string[]`                   | Search query string or array of queries   | .          |
    | `options.searchEngine` | `'google' \| 'bing' \| 'yandex'`       | Search engine                             | `'google'` |
    | `options.zone`         | `string`                               | Zone identifier (auto-configured if null) | .          |
    | `options.format`       | `'json' \| 'raw'`                      | Response format                           | `'raw'`    |
    | `options.method`       | `string`                               | HTTP method                               | `'GET'`    |
    | `options.country`      | `string`                               | Two-letter country code                   | `''`       |
    | `options.dataFormat`   | `'markdown' \| 'screenshot' \| 'html'` | Returned content format                   | `'html'`   |
    | `options.concurrency`  | `number`                               | Max parallel workers                      | `10`       |
    | `options.timeout`      | `number (ms)`                          | Request timeout                           | `30000`    |
  </Accordion>

  <Accordion title="Scrape" description="Add advanced scrape parameters" icon="spider">
    Scrape a single URL or list of URLs using the Web Unlocker API.

    | Name                  | Type                                   | Description                               | Default  |
    | --------------------- | -------------------------------------- | ----------------------------------------- | -------- |
    | `url`                 | `string \| string[]`                   | Single URL string or array of URLs        | .        |
    | `options.zone`        | `string`                               | Zone identifier (auto-configured if null) | .        |
    | `options.format`      | `'json' \| 'raw'`                      | Response format                           | `'raw'`  |
    | `options.method`      | `string`                               | HTTP method                               | `'GET'`  |
    | `options.country`     | `string`                               | Two-letter country code                   | `''`     |
    | `options.dataFormat`  | `'markdown' \| 'screenshot' \| 'html'` | Returned content format                   | `'html'` |
    | `options.concurrency` | `number`                               | Max parallel workers                      | `10`     |
    | `options.timeout`     | `number (ms)`                          | Request timeout                           | `30000`  |
  </Accordion>

  <Accordion title="saveResults" description="Save content to local file." icon="floppy-disk">
    | Name               | Type                       | Description                              | Default |
    | ------------------ | -------------------------- | ---------------------------------------- | ------- |
    | `content`          | `any`                      | Content to save                          | .       |
    | `options.filename` | `string`                   | Output filename (auto-generated if null) | .       |
    | `options.format`   | `'json' \| 'csv' \| 'txt'` | File format                              | .       |
  </Accordion>
</AccordionGroup>

## Error handling

<AccordionGroup>
  <Accordion title="Logging" description="Enable advanced logging" icon="ballot">
    Enable `VERBOSE` in the Client for advanced logging (see Client parameters). Use the `listZones()` function to check available zones.
  </Accordion>

  <Accordion title="Authentication" description="Bright Data Auth" icon="rectangle-barcode">
    Create a [Bright Data](https://brightdata.com/) account and copy your API key. Go to [account settings](https://brightdata.com/cp/setting/users) and make sure your API key has **admin permissions**.
  </Accordion>
</AccordionGroup>

## Resources

<CardGroup>
  <Card title="GitHub" icon="github" href="https://github.com/brightdata/bright-data-sdk-js?tab=readme-ov-file">
    Visit the Bright Data SDK GitHub repository
  </Card>
</CardGroup>


# Authentication
Source: https://docs.brightdata.com/api-reference/authentication

Authenticate with Bright Data using 1 of 2 methods: API Access with an API key or Native Access with proxy username and password. Billed at the same rate.

Bright Data ensures secure access to its services.

Bright Data provides two primary methods for authentication:

1. **API Access** - Authenticate and interact with the Bright Data platform using an API key/token.
2. **Native Access** - Authenticate and interact with the Bright Data platform using proxy protocol `username` and `password`.

<Note>
  Both API and Native access methods are billed at the same rate. Usage is charged according to your pricing plan for each Bright Data product.
</Note>

## How do I authenticate with API Key?

An API key is a secure hashed token used to authenticate with Bright Data API. We create a default key for you upon account creation automatically.
You can create additional API keys for different users and with different permissions.

<Note>
  Manage your API Keys anytime in the [Account settings](https://brightdata.com/cp/setting/users).
</Note>

### How do I relay the API key within a request?

Here’s an example request:

```sh Sample Request theme={null}
curl --request POST \
  --url https://api.brightdata.com/request \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
    "zone": "my_unlocker_zone",
    "url": "https://example.com/page",
    "format": "json",
    "method": "GET",
    "country": "us",
    "data_format": "markdown"
  }'
```

The important part of this request is the `Authorization` header:

```sh theme={null}
'Authorization: Bearer <token>'
```

This `<token>` is your **API key**, which is required for every API request.

### How do I generate a new API key?

To generate a new API key, follow these steps:

<Steps>
  <Step title="Sign In">
    Sign in to Bright Data's control panel and go to your [Account settings](https://brightdata.com/cp/setting/users).
  </Step>

  <Step title="Click 'Add API key'">
    Click the **Add API key** button in the top right of the API key section.

    <Warning>
      If you don’t see the 'API key' section, switch to an **admin account**. only admins can generate API keys.\
      Note: Each user can generate only one API key. The total number of API keys cannot exceed the number of account users.
    </Warning>
  </Step>

  <Step title="Configure your API key">
    Set the User, Permissions, and Expiration date (or choose 'Unlimited'), then click **Save**.
  </Step>

  <Step title="Save your API key locally">
    <Warning>
      Once generated, your API key will only be shown once. Be sure to **save it in a secure location**.
    </Warning>
  </Step>
</Steps>

### What are API Key options and configuration?

When creating an API key, you can assign one of five permission levels to control access and ensure security based on user roles or use cases. [Learn more about user roles here](/api-reference/authentication#understanding-api-key-permissions).

#### What permissions level does an API key have?

There are 5 types of permissions to choose from to control API key access:

* **Admin:** Grants full access to the account, including all Billing, Financial, product settings and configurations.
* **Finance:** Allows access to Billing and Financial pages only.
* **Ops:** Allows access to proxy/API configurations but restricts Billing access.
* **Limit:** Permits management of proxy passwords and IP allowlists/denylists.
* **User:** Enables API usage on the proxy/API level without access to Billing or product configuration pages.

#### Does the API Key have an expiration date?

When creating an API key, you can setup its expiration date. Requests authenticating with this key past the expiration date will be denied.

You can setup the expiration date as `unlimited` - although this is possible, we strongly recommend to setup an expiration date.

Consult your organization's information or data security officer for instructions.

#### How can I view the API Key settings and configuration?

You can view and manage your API Keys in [Account settings](https://brightdata.com/cp/setting/users).

#### Why can't I see a plain text version of my API Key, or copy it?

For your security, we do not allow plain text view of  API keys with `admin` permissions. After creation you will be offered to copy and save the key.

#### Can I refresh the API key?

Yes. Once you click "Refresh" we will generate a new API key. After the refresh, any request you will send with the old key will fail to authenticate.

#### Where should I save the API key with admin permissions?

API keys are like passwords and should be dealt and saved with outmost care and under controlled access. Consult your IT manager or security administrator on how and where to save the keys per your organizations' processes and regulation.

## How do I authenticate with native proxy protocol?

### Which products can I access with proxy protocol?

Proxy protocol access is supported by:

* All proxy networks (Datacenter, ISP, Residential, and Mobile)
* Web Unlocker
* Scraping Browser

### How do I authenticate with native proxy username and password?

Here’s an example of a Native Access request:

```sh Sample Request theme={null}
curl "https://www.example.com" \
  -i --proxy brd.superproxy.io:44445 \
  --proxy-user brd-customer-[ACCOUNT_ID]-zone-[PROXY_NAME]:[PROXY_PASSWORD]
```

The key part of this request is the `--proxy-user` parameter which holds the authentication credentials:

```sh proxy-user theme={null}
brd-customer-[ACCOUNT_ID]-zone-[PROXY_NAME]:[PROXY_PASSWORD]
```

This parameter is made up of three elements combined into a single string:

1. `ACCOUNT_ID` - your unique customer identifier.
2. `PROXY_NAME` - the name you gave your proxy or API (e.g., `web_unlocker1`, `datacenter_proxy1`).
3. `PROXY_PASSWORD` - the password shown in your Access Details.

Together, they form the complete proxy-user value.

### Username/password format

* All parameters are case sensitive.
* The string must be consecutive without spaces.
* `-` (dash/minus sign) separates the username substrings, and `:` (colon) separates the username from the password.

#### Account ID

Your Account ID is a unique identifier automatically generated when your Bright Data account is created. It is used for authentication and account-related operations.

To find your Account ID, follow these steps:

<Steps>
  <Step title={<>Click on <a href="https://brightdata.com/cp/setting/customer_details">Account Settings</a> in the left-hand menu.</>} />

  <Step title="Open the Profile tab." />

  <Step title="Locate and copy your Account ID." />
</Steps>

<Frame>
  <img alt="Account ID " />
</Frame>

<Note>
  Your Account ID is always a text string that begins with `hl_###`.
</Note>

#### Username

Each product you create in the Bright Data dashboard is assigned a **Username** visible in the product's **Access Details** section. The username follows this format:

```text theme={null}
brd-customer-[ACCOUNT_ID]-zone-[PRODUCT_NAME]
```

For example: `brd-customer-hl_7abed23d-zone-web_unlocker1`

This name is set **once** when you create a proxy or API and cannot be changed later. You can find your username by opening your proxy or API (under [Proxies](https://brightdata.com/cp/zones) or [Web Access](https://brightdata.com/cp/zones)) and checking the **Access Details** section.

#### Password

Each proxy or API is assigned a unique **Password** that is required for authenticating Native Access requests. You can find it in the **Access Details** section.

To view or update your password, follow these steps:

<Steps>
  <Step title="Open your product in the dashboard (under Proxies or Web Access)." />

  <Step title="Locate the Password field in the Access Details section." />

  <Step title="Copy your current password, or generate a new one from the Configuration tab under Security Settings." />
</Steps>

## Comparing API Access vs. Native Access

| Feature                                                 | API Access                                                                                                                                                                                                                                                                                                         | Native Access                                                                                                                    |
| :------------------------------------------------------ | :----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | :------------------------------------------------------------------------------------------------------------------------------- |
| **Used for**                                            | Seamless integration with scripts, automation tools, or third-party APIs                                                                                                                                                                                                                                           | Direct proxy connections in browsers, crawlers, or proxy-compatible tools                                                        |
| **Recommended products**                                | - [Web Unlocker API](/scraping-automation/web-unlocker)<br />- [SERP](/scraping-automation/serp-api)<br />- [Browsers](/scraping-automation/scraping-browser)<br />- [Scrapers](/datasets/scrapers/overview)<br />- [Functions](/datasets/scraper-studio/introduction)<br />- [Marketplace](/datasets/marketplace) | [Proxies](/proxy-networks)                                                                                                       |
| [**SSL certificate**](/general/account/ssl-certificate) | Not required                                                                                                                                                                                                                                                                                                       | Required to access without KYC the residential network & unlocker. More info [here.](/proxy-networks/residential/network-access) |
| **Connection via**                                      | API endpoint                                                                                                                                                                                                                                                                                                       | Proxy endpoint                                                                                                                   |
| **Authentication**                                      | [API key](/api-reference/authentication#how-do-i-generate-a-new-api-key%3F)                                                                                                                                                                                                                                        | `username:password`                                                                                                              |
| **Output options**                                      | HTML or JSON                                                                                                                                                                                                                                                                                                       | HTML                                                                                                                             |


# Bright Data API Postman collection
Source: https://docs.brightdata.com/api-reference/postman-collection

Quickly test and explore Bright Data's APIs (1000+ scrapers) using our Postman collection. View, run and fork requests without setting up your own backend.

<div>
  <Card title="Postman collection" icon="user-astronaut" href="https://www.postman.com/bright-data-api/bright-data-api/collection/2f4u0m8/bright-data-api-collection" />
</div>

## Getting Started

Get up and running with Bright Data API Postman collection in just 3 simple steps:

1. **Get your Bright Data API key**: Generate your [Bright Data API key from your account dashboard](/api-reference/authentication#how-do-i-generate-a-new-api-key%3F)
2. **Update Postman collection environment variable**: Set your `BRIGHT_DATA_API_KEY` in the Postman collection environment variables under Production environment.
   <img alt="postman-collection-environment-varaible.jpg" />
3. **Start scraping**: Select the `Production` environment from the dropdown menu in the top-right corner, then customize the request body and parameters. Once configured, simply click the **Send** button to execute your request and retrieve the results.

<Note>
  This Postman collection includes few popular endpoints and will expand based on user needs. For complete documentation, see the official [Bright Data API reference](/api-reference).
</Note>


# SERP async request
Source: https://docs.brightdata.com/api-reference/rest-api/serp/request

async-api-reference POST /serp/req
Use the Bright Data SERP API async endpoint (31 languages). POST /serp/req submits or retrieves a queued SERP request and returns 200 OK as JSON.



# SERP API
Source: https://docs.brightdata.com/api-reference/rest-api/serp/serp-api

api-reference/serp-rest-api POST /request
Use the Bright Data SERP API (31 languages) to extract structured results from Google, Bing, Yandex and DuckDuckGo with organic listings, ads and shopping data.

Related guide: [SERP API Introduction](/scraping-automation/serp-api/introduction)

<a href="https://www.postman.com/bright-data-api/bright-data-api/request/kpq952m/google-search">
  <img alt="Run in Postman" />
</a>

<Card title="Bright Data Python SDK" icon="python" href="/api-reference/SDK">
  For an easy start using our tools check out our new Python SDK.
</Card>


# Unlocker async response
Source: https://docs.brightdata.com/api-reference/rest-api/unlocker/get-results

async-api-reference GET /unblocker/get_result
Use the Bright Data Web Unlocker API (98% success rate) async endpoint. GET /unblocker/get_result submits or retrieves a queued unlock request as JSON.



# Unlocker async request
Source: https://docs.brightdata.com/api-reference/rest-api/unlocker/request

async-api-reference POST /unblocker/req
Use the Bright Data Web Unlocker API (98% success rate) async endpoint. POST /unblocker/req submits or retrieves a queued unlock request as JSON.



# Web Unlocker API
Source: https://docs.brightdata.com/api-reference/rest-api/unlocker/unlock-website

api-reference/unlocker-rest-api POST /request
Use the Bright Data Web Unlocker API (98% success rate) to test and unlock websites in real time, bypassing anti-bot protections, proxies and CAPTCHAs.

Related guide: [Web Unlocker API Introduction](/scraping-automation/web-unlocker/introduction)

<a href="https://www.postman.com/bright-data-api/bright-data-api/request/f0g939o/unlock-website">
  <img alt="Run in Postman" />
</a>

<Card title="Bright Data Python SDK" icon="python" href="/api-reference/SDK">
  For an easy start using our tools check out our new Python SDK.
</Card>


# Terminology
Source: https://docs.brightdata.com/api-reference/terminology

Reference for Bright Data documentation terminology in 2026: API keys, proxies and product names used across the developer docs and 1000+ scrapers.

## Zones

Zones are the foundation for how you configure and manage Bright Data products. Each zone represents a specific product or setup, such as Residential, Mobile, Datacenter, or Web Unlocker API. Access your zones [here](https://brightdata.com/cp/zones).

<img alt="bright-data-zones.png" />

### What is a zone?

A zone is a logical container that defines how a Bright Data product behaves. When you enable a product, a corresponding zone is created. Each zone includes its own configuration settings, such as:

* Targeting rules (e.g., country, city, ASN)
* Output format
* Headers and request behavior
* Access permissions

### Using zones in your workflow

You can create multiple zones for the same product to support different use cases, targets, or operational needs. This gives you more control and flexibility when managing traffic.

Example use cases:

* `zone_1` for targeting example.com
* `zone_2` for targeting anotherexample.com

By separating traffic into different zones, you can:

* Apply unique settings per target or workflow
* Monitor usage and performance independently
* Simplify debugging and optimization
* Maintain cleaner, more organized configurations

<Tip>
  You can rename your zones at any time to better reflect their purpose or target.
</Tip>

## Snapshot

Snapshot in Bright Data represent saved state of data collection at the time of trigger. It is used to track, manage, and retrieve the exact data that was collected during a specific run of a dataset.

### What is Snapshot?

A snapshot is a record of a single data collection event. Each time a dataset is triggered, whether manually or via API, a snapshot is created to store the results and the inputs used for that specific run.

Snapshots are especially useful when:

* You need to retrieve historical data from previous runs
* You want to verify what inputs were used to trigger a collection
* You are delivering data in batches and need to track how many parts were generated

### Example Scenarios

* You’ve triggered a dataset to collect product listings from an e-commerce site. A snapshot is automatically created, capturing the results and the inputs (e.g., URL, filters, headers).
* You’ve requested the data to be delivered in batches. You can use the snapshot to check how many parts were generated and ensure the delivery settings match your request.

### Snapshot ID

A Snapshot ID is a unique identifier assigned to a specific data [snapshot](#Snapshot).
Example: `s_manlyn268d2p9hdmx`

## Dataset

A [dataset](https://brightdata.com/products/datasets) in the context of Bright Data refers to a structured collection of data that has been gathered and organized for specific use cases, such as eCommerce, social media, real estate, etc. These datasets are available in the Dataset Marketplace.

### Dataset ID

A Dataset ID is a unique identifier assigned to each [dataset](#dataset) in the Dataset Marketplace. It helps in identifying and accessing specific datasets for data retrieval and management.

You can find all Dataset IDs of all Scraper APIs, you can use the [dataset lists API endpoint](/api-reference/marketplace-dataset-api/get-dataset-list) to retrieve a list of available datasets.


# Command reference
Source: https://docs.brightdata.com/cli/commands

Reference for every Bright Data CLI command across 4 areas (scrape, search, pipelines and config), with flags, global options and copy-paste examples.

## Global options

These flags work with any command:

| Flag                  | Description                       |
| --------------------- | --------------------------------- |
| `-k, --api-key <key>` | Override API key for this request |
| `--timing`            | Show request timing info          |
| `-v, --version`       | Show CLI version                  |

***

## `brightdata login`

Authenticate with Bright Data. Opens the browser for OAuth by default.

| Flag                     | Description                                   |
| ------------------------ | --------------------------------------------- |
| `-k, --api-key <key>`    | Use API key directly (skips browser)          |
| `-c, --customer-id <id>` | Bright Data account ID (optional)             |
| `-d, --device`           | Use device flow for SSH/headless environments |

```bash theme={null}
brightdata login                        # Browser OAuth (recommended)
brightdata login --device               # Headless/SSH environments
brightdata login --api-key <key>        # Direct API key
```

<Tip>
  On first login, the CLI automatically creates `cli_unlocker` and `cli_browser` proxy zones and sets sensible defaults.
</Tip>

***

## `brightdata logout`

Clear stored credentials.

```bash theme={null}
brightdata logout
```

***

## `brightdata scrape <url>`

Scrape any URL using Bright Data's Web Unlocker. Handles CAPTCHAs, JavaScript rendering, and anti-bot protections automatically.

| Flag                  | Description                                                |
| --------------------- | ---------------------------------------------------------- |
| `-f, --format <fmt>`  | `markdown` (default), `html`, `screenshot`, `json`         |
| `--country <code>`    | ISO country code for geo-targeting (e.g. `us`, `de`, `jp`) |
| `--zone <name>`       | Web Unlocker zone name                                     |
| `--mobile`            | Use a mobile user agent                                    |
| `--async`             | Submit async, return a snapshot ID                         |
| `-o, --output <path>` | Write output to file                                       |
| `--json`              | Force JSON output                                          |
| `--pretty`            | Pretty-print JSON output                                   |

<CodeGroup>
  ```bash Markdown (default) theme={null}
  brightdata scrape https://news.ycombinator.com
  ```

  ```bash HTML theme={null}
  brightdata scrape https://example.com -f html
  ```

  ```bash JSON with geo-targeting theme={null}
  brightdata scrape https://amazon.com -f json --country us -o product.json
  ```

  ```bash Screenshot theme={null}
  brightdata scrape https://example.com -f screenshot -o page.png
  ```

  ```bash Async mode theme={null}
  brightdata scrape https://example.com --async
  ```

  ```bash Pipe to markdown reader theme={null}
  brightdata scrape https://docs.github.com | glow -
  ```
</CodeGroup>

***

## `brightdata search <query>`

Search Google, Bing, or Yandex via Bright Data's SERP API. Google returns structured JSON with organic results, ads, People Also Ask, and related searches. Bing and Yandex return markdown by default.

| Flag                  | Description                                   |
| --------------------- | --------------------------------------------- |
| `--engine <name>`     | `google` (default), `bing`, `yandex`          |
| `--country <code>`    | Localized results (e.g. `us`, `de`)           |
| `--language <code>`   | Language code (e.g. `en`, `fr`)               |
| `--page <n>`          | Page number, 0-indexed (default: `0`)         |
| `--type <type>`       | `web` (default), `news`, `images`, `shopping` |
| `--device <type>`     | `desktop`, `mobile`                           |
| `--zone <name>`       | SERP zone name                                |
| `-o, --output <path>` | Write output to file                          |
| `--json`              | Force JSON output                             |
| `--pretty`            | Pretty-print JSON output                      |

<CodeGroup>
  ```bash Basic search theme={null}
  brightdata search "typescript best practices"
  ```

  ```bash Localized search theme={null}
  brightdata search "restaurants berlin" --country de --language de
  ```

  ```bash News search theme={null}
  brightdata search "AI regulation" --type news
  ```

  ```bash Pagination theme={null}
  brightdata search "web scraping" --page 1
  ```

  ```bash Extract URLs with jq theme={null}
  brightdata search "open source scraping" --json | jq -r '.organic[].link'
  ```

  ```bash Bing search theme={null}
  brightdata search "bright data pricing" --engine bing
  ```
</CodeGroup>

***

## `brightdata discover <query>`

AI-powered web discovery. Submit a query with optional intent, and Bright Data finds, ranks, and optionally extracts full-page content for each result.

| Flag                        | Description                                          |
| --------------------------- | ---------------------------------------------------- |
| `--intent <text>`           | AI intent to evaluate and rank result relevance      |
| `--country <code>`          | ISO country code (default: `US`)                     |
| `--city <name>`             | City for localized results (e.g. `"New York"`)       |
| `--language <code>`         | Language code (default: `en`)                        |
| `--num-results <n>`         | Number of results to return                          |
| `--filter-keywords <words>` | Comma-separated keywords that must appear in results |
| `--include-content`         | Include full page content (markdown) in each result  |
| `--no-remove-duplicates`    | Keep duplicate results                               |
| `--start-date <date>`       | Only content updated from date (`YYYY-MM-DD`)        |
| `--end-date <date>`         | Only content updated until date (`YYYY-MM-DD`)       |
| `--timeout <seconds>`       | Polling timeout (default: `600`)                     |
| `-o, --output <path>`       | Write output to file                                 |
| `--json` / `--pretty`       | JSON output (raw / indented)                         |

<CodeGroup>
  ```bash Basic discovery theme={null}
  brightdata discover "AI trends"
  ```

  ```bash With AI intent for relevance ranking theme={null}
  brightdata discover "AI trends" \
    --intent "Prioritize institutional reports for VC research"
  ```

  ```bash Include full page content theme={null}
  brightdata discover "AI trends" --include-content --num-results 5
  ```

  ```bash Geo-targeted with date range theme={null}
  brightdata discover "best restaurants" --country US --city "New York" \
    --start-date 2025-01-01 --end-date 2025-12-31
  ```

  ```bash Filter by keywords theme={null}
  brightdata discover "generative AI SaaS" --filter-keywords "revenue,SaaS"
  ```

  ```bash JSON output to file theme={null}
  brightdata discover "AI trends" --num-results 10 --pretty -o results.json
  ```
</CodeGroup>

<Tip>
  For best results with `--intent`, use a structured formula: describe your persona, what to prioritize, the depth of analysis, and what to exclude. See the [Discover API reference](/api-reference/discover) for detailed guidance.
</Tip>

***

## `brightdata pipelines <type> [params...] [options]`

Extract structured data from 40+ platforms. Triggers an async collection job, polls until results are ready, and returns the data.

| Flag                  | Description                                |
| --------------------- | ------------------------------------------ |
| `--format <fmt>`      | `json` (default), `csv`, `ndjson`, `jsonl` |
| `--timeout <seconds>` | Polling timeout (default: `600`)           |
| `-o, --output <path>` | Write output to file                       |
| `--json`              | Force JSON output                          |
| `--pretty`            | Pretty-print JSON output                   |

```bash theme={null}
# List all available pipeline types
brightdata pipelines list
```

<CodeGroup>
  ```bash LinkedIn profile theme={null}
  brightdata pipelines linkedin_person_profile "https://linkedin.com/in/username"
  ```

  ```bash Amazon product theme={null}
  brightdata pipelines amazon_product "https://amazon.com/dp/B09V3KXJPB"
  ```

  ```bash Amazon search theme={null}
  brightdata pipelines amazon_product_search "laptop" "https://amazon.com"
  ```

  ```bash Instagram profile theme={null}
  brightdata pipelines instagram_profiles "https://instagram.com/username"
  ```

  ```bash YouTube comments theme={null}
  brightdata pipelines youtube_comments "https://youtube.com/watch?v=..." 50
  ```

  ```bash CSV export theme={null}
  brightdata pipelines amazon_product "https://amazon.com/dp/..." --format csv -o product.csv
  ```
</CodeGroup>

### Supported platforms

<AccordionGroup>
  <Accordion title="E-Commerce" icon="cart-shopping">
    | Type                     | Platform               | Parameters               |
    | ------------------------ | ---------------------- | ------------------------ |
    | `amazon_product`         | Amazon product page    | `<url>`                  |
    | `amazon_product_reviews` | Amazon reviews         | `<url>`                  |
    | `amazon_product_search`  | Amazon search results  | `<keyword> <domain_url>` |
    | `walmart_product`        | Walmart product page   | `<url>`                  |
    | `walmart_seller`         | Walmart seller profile | `<url>`                  |
    | `ebay_product`           | eBay listing           | `<url>`                  |
    | `bestbuy_products`       | Best Buy               | `<url>`                  |
    | `etsy_products`          | Etsy                   | `<url>`                  |
    | `homedepot_products`     | Home Depot             | `<url>`                  |
    | `zara_products`          | Zara                   | `<url>`                  |
    | `google_shopping`        | Google Shopping        | `<url>`                  |
  </Accordion>

  <Accordion title="Professional Networks" icon="briefcase">
    | Type                       | Platform               | Parameters                       |
    | -------------------------- | ---------------------- | -------------------------------- |
    | `linkedin_person_profile`  | LinkedIn person        | `<url>`                          |
    | `linkedin_company_profile` | LinkedIn company       | `<url>`                          |
    | `linkedin_job_listings`    | LinkedIn jobs          | `<url>`                          |
    | `linkedin_posts`           | LinkedIn posts         | `<url>`                          |
    | `linkedin_people_search`   | LinkedIn people search | `<url> <first_name> <last_name>` |
    | `crunchbase_company`       | Crunchbase             | `<url>`                          |
    | `zoominfo_company_profile` | ZoomInfo               | `<url>`                          |
  </Accordion>

  <Accordion title="Social Media" icon="hashtag">
    | Type                            | Platform             | Parameters             |
    | ------------------------------- | -------------------- | ---------------------- |
    | `instagram_profiles`            | Instagram profiles   | `<url>`                |
    | `instagram_posts`               | Instagram posts      | `<url>`                |
    | `instagram_reels`               | Instagram reels      | `<url>`                |
    | `instagram_comments`            | Instagram comments   | `<url>`                |
    | `facebook_posts`                | Facebook posts       | `<url>`                |
    | `facebook_marketplace_listings` | Facebook Marketplace | `<url>`                |
    | `facebook_company_reviews`      | Facebook reviews     | `<url> [num_reviews]`  |
    | `facebook_events`               | Facebook events      | `<url>`                |
    | `tiktok_profiles`               | TikTok profiles      | `<url>`                |
    | `tiktok_posts`                  | TikTok posts         | `<url>`                |
    | `tiktok_shop`                   | TikTok shop          | `<url>`                |
    | `tiktok_comments`               | TikTok comments      | `<url>`                |
    | `x_posts`                       | X (Twitter) posts    | `<url>`                |
    | `youtube_profiles`              | YouTube channels     | `<url>`                |
    | `youtube_videos`                | YouTube videos       | `<url>`                |
    | `youtube_comments`              | YouTube comments     | `<url> [num_comments]` |
    | `reddit_posts`                  | Reddit posts         | `<url>`                |
  </Accordion>

  <Accordion title="Maps, Reviews & Other" icon="map-location-dot">
    | Type                        | Platform                | Parameters           |
    | --------------------------- | ----------------------- | -------------------- |
    | `google_maps_reviews`       | Google Maps reviews     | `<url> [days_limit]` |
    | `google_play_store`         | Google Play             | `<url>`              |
    | `apple_app_store`           | Apple App Store         | `<url>`              |
    | `github_repository_file`    | GitHub repository files | `<url>`              |
    | `yahoo_finance_business`    | Yahoo Finance           | `<url>`              |
    | `zillow_properties_listing` | Zillow                  | `<url>`              |
    | `booking_hotel_listings`    | Booking.com             | `<url>`              |
  </Accordion>
</AccordionGroup>

<Tip>
  Run `brightdata pipelines list` in your terminal to see all available types at any time.
</Tip>

***

## `brightdata scraper`

Build, run, and maintain custom [Bright Data Scraper Studio](/datasets/scraper-studio/build-with-the-cli) scrapers from the terminal. Each scraper is identified by a Collector ID (a `c_*` string) that stays stable across runs and self-healing.

### `brightdata scraper create <url> <description>`

Build a scraper from a natural-language description using Bright Data's AI Agent. Returns a Collector ID.

```bash theme={null}
brightdata scraper create https://news.ycombinator.com \
  "Extract top stories: title, url, points, author, comment count"
```

AI generation typically takes 5 to 15 minutes and can run up to 25 minutes on complex targets.

### `brightdata scraper run <collector_id> [url]`

Run a scraper on one or more URLs and return the data. The CLI tries real-time mode first and falls back to batch mode automatically when a run exceeds the real-time page-load limit.

| Flag                  | Description              |
| --------------------- | ------------------------ |
| `-o, --output <path>` | Write output to file     |
| `--json`              | Force JSON output        |
| `--pretty`            | Pretty-print JSON output |

```bash theme={null}
brightdata scraper run c_mpohus372o5tmid1jk https://news.ycombinator.com --pretty
```

### `brightdata scraper heal <collector_id> <prompt>`

Fix an existing scraper in place via AI self-healing. The Collector ID does not change. By default, `heal` stops at an approval gate and returns `status: "awaiting_approval"` with a `preview_result`.

| Flag                  | Description                                                            |
| --------------------- | ---------------------------------------------------------------------- |
| `--url <url>`         | Verify target woven into the next-step hint. Not sent to the heal call |
| `--auto-approve`      | Approve automatically at the gate and poll through to `done`           |
| `--timeout <seconds>` | Polling timeout (default: `600`)                                       |
| `--max-retries <n>`   | Max retries on the AI-Flow concurrent-job 429 cap (default: `4`)       |
| `--no-retry`          | Fail immediately on 429 instead of waiting through the cap             |
| `-o, --output <path>` | Write output to file                                                   |
| `--json` / `--pretty` | JSON output (raw / indented)                                           |

```bash theme={null}
brightdata scraper heal c_mpohus372o5tmid1jk \
  "The price field returns null since the redesign. Re-capture price and currency." \
  --url https://example.com/product/1
```

### `brightdata scraper approve <collector_id>`

Commit a heal that is awaiting approval, or reject it with `--reject`.

| Flag                  | Description                                            |
| --------------------- | ------------------------------------------------------ |
| `--reject`            | Reject the proposed fix instead of approving it        |
| `--url <url>`         | Verify target woven into the next-step hint on success |
| `--timeout <seconds>` | Polling timeout (default: `600`)                       |
| `-o, --output <path>` | Write output to file                                   |
| `--json` / `--pretty` | JSON output                                            |

```bash theme={null}
brightdata scraper approve c_mpohus372o5tmid1jk --url https://example.com/product/1
brightdata scraper approve c_mpohus372o5tmid1jk --reject
```

<Tip>
  The self-healing flow is run, inspect, `heal`, `approve`, re-run. See the [Scraper Studio CLI quickstart](/datasets/scraper-studio/build-with-the-cli) for a full walkthrough. `scraper heal` and `scraper approve` were added in CLI v0.3.1.
</Tip>

***

## `brightdata status <job-id>`

Check the status of an async snapshot job (from `--async` scrapes or pipeline collections).

| Flag                  | Description                      |
| --------------------- | -------------------------------- |
| `--wait`              | Poll until the job completes     |
| `--timeout <seconds>` | Polling timeout (default: `600`) |
| `-o, --output <path>` | Write output to file             |
| `--json` / `--pretty` | JSON output                      |

```bash theme={null}
brightdata status s_abc123xyz
brightdata status s_abc123xyz --wait --pretty
brightdata status s_abc123xyz --wait --timeout 300
```

***

## `brightdata browser`

Control a real browser session powered by Bright Data's [Scraping Browser](/scraping-automation/scraping-browser). A lightweight local daemon holds the browser connection open between commands, giving you persistent state without reconnecting on every call.

```bash theme={null}
brightdata browser <subcommand> [options]
```

### Global flags

These flags work with every `browser` subcommand:

| Flag                  | Description                                                                          |
| --------------------- | ------------------------------------------------------------------------------------ |
| `--session <name>`    | Session name for running multiple isolated sessions in parallel (default: `default`) |
| `--country <code>`    | Geo-target by ISO country code. On `open`, changing country reconnects the browser   |
| `--zone <name>`       | Scraping Browser zone (default: `cli_browser`)                                       |
| `--timeout <ms>`      | IPC command timeout in milliseconds (default: `30000`)                               |
| `--idle-timeout <ms>` | Daemon auto-shutdown after idle (default: `600000` / 10 min)                         |
| `--json` / `--pretty` | JSON output                                                                          |
| `-o, --output <path>` | Write output to file                                                                 |

### Subcommands

<AccordionGroup>
  <Accordion title="browser open" icon="globe">
    Navigate to a URL. Starts the daemon and browser session automatically if not already running.

    ```bash theme={null}
    brightdata browser open <url>
    brightdata browser open https://amazon.com --country us --session shop
    ```

    | Flag                  | Description                                                                         |
    | --------------------- | ----------------------------------------------------------------------------------- |
    | `--country <code>`    | Geo-targeting. Reconnects the browser if the country changes on an existing session |
    | `--zone <name>`       | Browser zone name                                                                   |
    | `--idle-timeout <ms>` | Daemon idle timeout for this session                                                |
  </Accordion>

  <Accordion title="browser snapshot" icon="camera">
    Capture the page as a text accessibility tree. This is the primary way AI agents read page content - far more token-efficient than raw HTML.

    Each interactive element gets a `ref` (e.g. `e1`, `e2`) that you pass to `click`, `type`, `fill`, and other interaction commands.

    ```bash theme={null}
    brightdata browser snapshot
    brightdata browser snapshot --compact          # Interactive elements + ancestors only
    brightdata browser snapshot --interactive      # Interactive elements as a flat list
    brightdata browser snapshot --depth 3          # Limit tree depth
    brightdata browser snapshot --selector "main"  # Scope to a CSS subtree
    ```

    **Example output:**

    ```text theme={null}
    Page: Example Domain
    URL: https://example.com

    - heading "Example Domain" [level=1]
    - paragraph "This domain is for use in illustrative examples."
    - link "More information..." [ref=e1]
    ```

    | Flag               | Description                                                                     |
    | ------------------ | ------------------------------------------------------------------------------- |
    | `--compact`        | Only interactive elements and their ancestors (70-90% fewer tokens)             |
    | `--interactive`    | Only interactive elements, as a flat list                                       |
    | `--depth <n>`      | Limit tree depth                                                                |
    | `--selector <sel>` | Scope snapshot to elements matching a CSS selector                              |
    | `--wrap`           | Wrap output in content boundaries (useful for AI agent prompt injection safety) |
  </Accordion>

  <Accordion title="browser screenshot" icon="image">
    Capture a PNG screenshot of the current viewport.

    ```bash theme={null}
    brightdata browser screenshot
    brightdata browser screenshot ./result.png
    brightdata browser screenshot --full-page -o page.png
    brightdata browser screenshot --base64
    ```

    | Flag          | Description                                                |
    | ------------- | ---------------------------------------------------------- |
    | `[path]`      | Where to save the PNG (default: temp directory)            |
    | `--full-page` | Capture the full scrollable page, not just the viewport    |
    | `--base64`    | Output base64-encoded PNG data instead of saving to a file |
  </Accordion>

  <Accordion title="browser click / type / fill" icon="hand-pointer">
    Interact with elements using their snapshot `ref` values.

    ```bash theme={null}
    # Click an element
    brightdata browser click e3

    # Type text into a field (clears first by default)
    brightdata browser type e5 "search query"
    brightdata browser type e5 " more text" --append    # Append to existing value
    brightdata browser type e5 "search query" --submit  # Press Enter after typing

    # Fill a form field directly (no keyboard simulation)
    brightdata browser fill e2 "user@example.com"

    # Select a dropdown option by visible label
    brightdata browser select e4 "United States"

    # Check / uncheck a checkbox or radio button
    brightdata browser check e7
    brightdata browser uncheck e7

    # Hover over an element
    brightdata browser hover e2
    ```

    | Flag (for `type`) | Description                                          |
    | ----------------- | ---------------------------------------------------- |
    | `--append`        | Append to existing value using key-by-key simulation |
    | `--submit`        | Press Enter after typing                             |
  </Accordion>

  <Accordion title="browser scroll" icon="arrows-up-down">
    Scroll the viewport or scroll an element into view.

    ```bash theme={null}
    brightdata browser scroll                          # Scroll down 300px (default)
    brightdata browser scroll --direction up
    brightdata browser scroll --direction down --distance 600
    brightdata browser scroll --ref e10                # Scroll element into view
    ```

    | Flag                | Description                                           |
    | ------------------- | ----------------------------------------------------- |
    | `--direction <dir>` | `up`, `down`, `left`, `right` (default: `down`)       |
    | `--distance <px>`   | Pixels to scroll (default: `300`)                     |
    | `--ref <ref>`       | Scroll this element into view instead of the viewport |
  </Accordion>

  <Accordion title="browser get text / get html" icon="code">
    Get text or HTML content from the page or a specific element.

    ```bash theme={null}
    # Text content
    brightdata browser get text            # Full page text
    brightdata browser get text "h1"       # Text of the first h1
    brightdata browser get text "#price"   # Text inside #price

    # HTML content
    brightdata browser get html              # Full page outer HTML
    brightdata browser get html ".product"   # innerHTML of .product
    ```
  </Accordion>

  <Accordion title="browser network / cookies / status" icon="network-wired">
    Inspect session state.

    ```bash theme={null}
    # HTTP requests captured since last navigation
    brightdata browser network

    # Cookies for the active session
    brightdata browser cookies

    # Current session state
    brightdata browser status
    brightdata browser status --session shop --pretty

    # List all active sessions
    brightdata browser sessions
    ```
  </Accordion>

  <Accordion title="browser back / forward / reload" icon="rotate">
    Navigation controls.

    ```bash theme={null}
    brightdata browser back
    brightdata browser forward
    brightdata browser reload
    ```
  </Accordion>

  <Accordion title="browser close" icon="xmark">
    Close a session and stop its daemon.

    ```bash theme={null}
    brightdata browser close                    # Close the default session
    brightdata browser close --session shop     # Close a named session
    brightdata browser close --all              # Close all active sessions
    ```
  </Accordion>
</AccordionGroup>

<Note>
  Element `ref` values (e.g. `e1`, `e3`) are re-assigned on every `snapshot` call. After navigating or clicking, take a fresh snapshot before using refs again.
</Note>

***

## `brightdata zones`

List and inspect Bright Data proxy zones.

```bash theme={null}
brightdata zones                        # List all active zones
brightdata zones info <name>            # Full details for a zone
brightdata zones --json -o zones.json   # Export as JSON
brightdata zones info my_zone --pretty  # Pretty-print zone info
```

***

## `brightdata budget`

View account balance and per-zone cost/bandwidth. Read-only.

| Subcommand    | Description                            |
| ------------- | -------------------------------------- |
| *(none)*      | Quick account balance                  |
| `balance`     | Balance + pending charges              |
| `zones`       | Cost & bandwidth table for all zones   |
| `zone <name>` | Detailed cost & bandwidth for one zone |

| Flag                  | Description                                      |
| --------------------- | ------------------------------------------------ |
| `--from <datetime>`   | Start of date range (e.g. `2024-01-01T00:00:00`) |
| `--to <datetime>`     | End of date range                                |
| `--json` / `--pretty` | JSON output                                      |

```bash theme={null}
brightdata budget
brightdata budget balance
brightdata budget zones
brightdata budget zone my_zone
brightdata budget zones --from 2024-01-01T00:00:00 --to 2024-02-01T00:00:00
```

***

## `brightdata config`

View and manage CLI configuration.

| Subcommand          | Description        |
| ------------------- | ------------------ |
| *(none)*            | Show all config    |
| `get <key>`         | Get a single value |
| `set <key> <value>` | Set a value        |

| Config Key              | Description                                 |
| ----------------------- | ------------------------------------------- |
| `default_zone_unlocker` | Default zone for `scrape` and `search`      |
| `default_zone_serp`     | Override zone for `search` only             |
| `default_format`        | Default output format: `markdown` or `json` |
| `api_url`               | Override API base URL                       |

```bash theme={null}
brightdata config
brightdata config set default_zone_unlocker my_zone
brightdata config set default_format json
brightdata config get default_zone_unlocker
```

***

## `brightdata init`

Interactive setup wizard. Walks through authentication, zone selection, and default configuration.

| Flag                  | Description                  |
| --------------------- | ---------------------------- |
| `--skip-auth`         | Skip the authentication step |
| `-k, --api-key <key>` | Provide API key directly     |

```bash theme={null}
brightdata init
```

***

## `brightdata skill`

Install Bright Data AI agent skills into coding agents (Claude Code, Cursor, Copilot, etc.).

| Subcommand   | Description                                        |
| ------------ | -------------------------------------------------- |
| `add`        | Interactive picker - choose skills + target agents |
| `add <name>` | Install a specific skill directly                  |
| `list`       | List all available skills                          |

Available skills: `search`, `scrape`, `data-feeds`, `bright-data-mcp`, `bright-data-best-practices`

```bash theme={null}
brightdata skill add              # Interactive picker
brightdata skill add scrape       # Direct install
brightdata skill list             # See what's available
```

***

## `brightdata add mcp`

Add the Bright Data MCP server to Claude Code, Cursor, or Codex. Uses the API key stored by `brightdata login`.

```bash theme={null}
brightdata add mcp                               # Interactive agent + scope prompts
brightdata add mcp --agent claude-code --global
brightdata add mcp --agent claude-code,cursor --project
brightdata add mcp --agent codex --global
```

| Flag               | Description                                               |
| ------------------ | --------------------------------------------------------- |
| `--agent <agents>` | Comma-separated targets: `claude-code`, `cursor`, `codex` |
| `--global`         | Install to the agent's global config file                 |
| `--project`        | Install to the current project's config file              |

### Config file locations

| Agent       | Global path                                   | Project path            |
| ----------- | --------------------------------------------- | ----------------------- |
| Claude Code | `~/.claude.json`                              | `.claude/settings.json` |
| Cursor      | `~/.cursor/mcp.json`                          | `.cursor/mcp.json`      |
| Codex       | `$CODEX_HOME/mcp.json` or `~/.codex/mcp.json` | Not supported           |

The command writes the MCP server entry under `mcpServers["bright-data"]`. Existing config is preserved - only the `bright-data` key is added or replaced.

<Warning>
  `brightdata add mcp` uses the API key stored by `brightdata login`. It does not read `BRIGHTDATA_API_KEY` or the `--api-key` flag, so run `brightdata login` first.
</Warning>


# Usage examples
Source: https://docs.brightdata.com/cli/examples

Real-world workflows and recipes for the Bright Data CLI (1000+ scrapers), from 1-line scrapes returning clean markdown to scheduled pipelines feeding LLMs.

## How to scrape with the CLI

### Get clean content from any website

```bash theme={null}
# Clean markdown - great for reading or feeding to LLMs
brightdata scrape https://news.ycombinator.com

# Save to file
brightdata scrape https://docs.python.org/3/tutorial/ -o python-tutorial.md

# Get raw HTML for parsing
brightdata scrape https://example.com -f html -o page.html
```

### How to scrape with geo-targeting

```bash theme={null}
# See Amazon prices as a US customer
brightdata scrape https://amazon.com/dp/B09V3KXJPB --country us

# Scrape a German news site from Germany
brightdata scrape https://spiegel.de --country de

# Mobile user agent for mobile-optimized pages
brightdata scrape https://example.com --mobile
```

### How to take screenshots

```bash theme={null}
# Full-page screenshot
brightdata scrape https://example.com -f screenshot -o homepage.png

# Screenshot from a specific country
brightdata scrape https://amazon.co.uk -f screenshot --country gb -o uk-amazon.png
```

***

## How to run search workflows

### Basic web search

```bash theme={null}
# Google search with formatted table output
brightdata search "best web scraping tools 2025"

# Get raw JSON for processing
brightdata search "typescript best practices" --json

# Pretty-print for inspection
brightdata search "AI startups" --pretty
```

### Localized and specialized search

```bash theme={null}
# Local restaurant search from Germany, in German
brightdata search "restaurants berlin" --country de --language de

# News-only results
brightdata search "AI regulation 2025" --type news

# Shopping results
brightdata search "wireless headphones" --type shopping

# Image search
brightdata search "mountain landscape wallpaper" --type images
```

### Pagination

```bash theme={null}
# First page (default)
brightdata search "web scraping tutorials"

# Second page
brightdata search "web scraping tutorials" --page 1

# Third page
brightdata search "web scraping tutorials" --page 2
```

***

## How to run discovery workflows

### How to run AI-powered research

```bash theme={null}
# Basic discovery with formatted table output
brightdata discover "AI trends"

# With AI intent for targeted relevance ranking
brightdata discover "AI trends" \
  --intent "Prioritize institutional reports for VC research"

# Include full page content for each result
brightdata discover "AI trends" --include-content --num-results 5
```

### How to discover with geo-targeting

```bash theme={null}
# Local results with date filtering
brightdata discover "best restaurants" --country US --city "New York" \
  --start-date 2025-01-01 --end-date 2025-12-31

# Filter results by required keywords
brightdata discover "generative AI SaaS" --filter-keywords "revenue,SaaS"
```

### Export discovery results

```bash theme={null}
# Save as JSON
brightdata discover "AI trends" --num-results 10 --pretty -o results.json

# Pipe-friendly - redirected stdout outputs JSON automatically
brightdata discover "AI trends" --include-content --num-results 3 > results.json
```

***

## How to run browser workflows

### Navigate and read pages

```bash theme={null}
# Open a page and read its content
brightdata browser open https://example.com
brightdata browser snapshot

# Compact snapshot for AI agents (70-90% fewer tokens)
brightdata browser snapshot --compact

# Scope to a specific section
brightdata browser snapshot --selector "main"
```

### Interact with pages

```bash theme={null}
# Open a page
brightdata browser open https://example.com

# Read the page structure
brightdata browser snapshot --compact

# Click, type, and submit using refs from the snapshot
brightdata browser click e3
brightdata browser type e5 "search query" --submit

# Get updated snapshot after interaction
brightdata browser snapshot --compact

# Take a screenshot for visual verification
brightdata browser screenshot ./result.png

# Clean up
brightdata browser close
```

### How to compare multiple sessions

```bash theme={null}
# Open the same page from different countries
brightdata browser open https://amazon.com --session us --country us
brightdata browser open https://amazon.com --session de --country de

# Capture both snapshots
brightdata browser snapshot --session us --json > us.json
brightdata browser snapshot --session de --json > de.json

# Close all sessions
brightdata browser close --all
```

### Extract content from dynamic pages

```bash theme={null}
# Navigate to a page that requires JavaScript
brightdata browser open https://example.com/dashboard

# Get text content from specific elements
brightdata browser get text "#total-revenue"
brightdata browser get text ".summary-table"

# Get HTML for parsing
brightdata browser get html ".product-grid"

# Check network requests
brightdata browser network
```

***

## Structured data extraction

### How to extract e-commerce data

```bash theme={null}
# Amazon product details
brightdata pipelines amazon_product "https://amazon.com/dp/B09V3KXJPB"

# Amazon product reviews
brightdata pipelines amazon_product_reviews "https://amazon.com/dp/B09V3KXJPB"

# Amazon search - requires keyword + domain
brightdata pipelines amazon_product_search "wireless headphones" "https://amazon.com"

# Walmart product
brightdata pipelines walmart_product "https://walmart.com/ip/123456"

# Export as CSV
brightdata pipelines amazon_product "https://amazon.com/dp/B09V3KXJPB" --format csv -o product.csv
```

### Social media profiles

```bash theme={null}
# LinkedIn person
brightdata pipelines linkedin_person_profile "https://linkedin.com/in/username"

# LinkedIn company
brightdata pipelines linkedin_company_profile "https://linkedin.com/company/bright-data"

# Instagram profile
brightdata pipelines instagram_profiles "https://instagram.com/username"

# TikTok profile
brightdata pipelines tiktok_profiles "https://tiktok.com/@username"
```

### Reviews and comments

```bash theme={null}
# Google Maps reviews - last 7 days
brightdata pipelines google_maps_reviews "https://maps.google.com/maps/place/..." 7

# YouTube comments - top 50
brightdata pipelines youtube_comments "https://youtube.com/watch?v=dQw4w9WgXcQ" 50

# Facebook company reviews - 25 reviews
brightdata pipelines facebook_company_reviews "https://facebook.com/company" 25

# Instagram comments
brightdata pipelines instagram_comments "https://instagram.com/p/ABC123"
```

***

## Piping and automation

The CLI is designed to be pipe-friendly. When stdout is not a TTY, colors and spinners are automatically disabled.

### Chain search → scrape

```bash theme={null}
# Search Google, extract the first URL, then scrape it
brightdata search "best python frameworks 2025" --json \
  | jq -r '.organic[0].link' \
  | xargs brightdata scrape
```

### Scrape and read in terminal

```bash theme={null}
# Pipe markdown output to a terminal reader
brightdata scrape https://docs.github.com | glow -

# Or use less
brightdata scrape https://docs.github.com | less
```

### Export to CSV for analysis

```bash theme={null}
# Amazon product data to CSV
brightdata pipelines amazon_product "https://amazon.com/dp/B09V3KXJPB" --format csv > product.csv

# LinkedIn jobs to CSV
brightdata pipelines linkedin_job_listings "https://linkedin.com/jobs/view/123" --format csv -o jobs.csv
```

### Extract specific fields with jq

```bash theme={null}
# Get just the titles and prices from Amazon search
brightdata pipelines amazon_product_search "laptop" "https://amazon.com" \
  | jq '[.[] | {title, price: .final_price}]'

# Get just organic result URLs from search
brightdata search "web scraping" --json | jq -r '.organic[].link'
```

### Async jobs for heavy workloads

```bash theme={null}
# Submit an async scrape
JOB_ID=$(brightdata scrape https://heavy-page.com --async --json | jq -r '.snapshot_id')

# Do other work...

# Check back later
brightdata status $JOB_ID --wait --pretty
```

***

## How to manage your account

### Monitor costs

```bash theme={null}
# Quick balance check
brightdata budget

# Detailed balance with pending charges
brightdata budget balance

# Cost breakdown by zone
brightdata budget zones

# Specific zone in a date range
brightdata budget zone cli_unlocker --from 2024-01-01T00:00:00 --to 2024-02-01T00:00:00
```

### Manage configuration

```bash theme={null}
# View current config
brightdata config

# Set default output to JSON
brightdata config set default_format json

# Use a custom zone for scraping
brightdata config set default_zone_unlocker my_custom_zone

# Override SERP zone
brightdata config set default_zone_serp my_serp_zone
```

***

## AI agent integration

### Add the MCP server to your coding agent

```bash theme={null}
# Interactive - choose agent and scope
brightdata add mcp

# Add to Claude Code globally
brightdata add mcp --agent claude-code --global

# Add to multiple agents at once
brightdata add mcp --agent claude-code,cursor --project

# Add to Codex
brightdata add mcp --agent codex --global
```

### Install skills into coding agents

```bash theme={null}
# Interactive picker - choose skills and target agents
brightdata skill add

# Install the scraping skill into your agent
brightdata skill add scrape

# Install search capabilities
brightdata skill add search

# See all available skills
brightdata skill list
```

<Tip>
  Skills are pre-packaged bundles of prompts and configuration that teach AI coding agents how to use Bright Data effectively. See [Skills](/ai/for-agents/skills) for more details.
</Tip>

***

## Supported environment variables

Override any stored configuration with environment variables:

| Variable                     | Purpose                                                |
| ---------------------------- | ------------------------------------------------------ |
| `BRIGHTDATA_API_KEY`         | API key (skips login entirely)                         |
| `BRIGHTDATA_UNLOCKER_ZONE`   | Default Web Unlocker zone                              |
| `BRIGHTDATA_SERP_ZONE`       | Default SERP zone                                      |
| `BRIGHTDATA_POLLING_TIMEOUT` | Polling timeout in seconds                             |
| `BRIGHTDATA_BROWSER_ZONE`    | Default Scraping Browser zone (default: `cli_browser`) |

```bash theme={null}
# Use in CI/CD without login
BRIGHTDATA_API_KEY=your_key brightdata scrape https://example.com

# Override timeout for large pipeline jobs
BRIGHTDATA_POLLING_TIMEOUT=1200 brightdata pipelines amazon_product "https://amazon.com/dp/..."
```


# Bright Data CLI FAQs
Source: https://docs.brightdata.com/cli/faqs

FAQs and troubleshooting for the Bright Data CLI: brightdata and bdata aliases, authentication, installation issues and common errors across 1000+ scrapers.

## Frequently asked general questions

<AccordionGroup>
  <Accordion title="What is the difference between `brightdata` and `bdata`?">
    They are identical - `bdata` is a shorthand alias installed alongside `brightdata`. Use whichever you prefer.
  </Accordion>

  <Accordion title="Do I need a Bright Data account to use the CLI?">
    Yes. The CLI connects to Bright Data's infrastructure to handle web requests. You can [sign up for free](https://brightdata.com/?hs_signup=1\&utm_source=docs) and get started with the free tier.
  </Accordion>

  <Accordion title="What platforms can I extract data from?">
    The CLI supports 40+ platforms through the `pipelines` command, including Amazon, LinkedIn, Instagram, TikTok, YouTube, Facebook, Reddit, Google Maps, Walmart, eBay, and many more. Run `brightdata pipelines list` to see the full list.
  </Accordion>

  <Accordion title="What output formats are supported?">
    * **Scrape:** `markdown` (default), `html`, `json`, `screenshot`
    * **Search:** Formatted table (default), `json`, `pretty`
    * **Pipelines:** `json` (default), `csv`, `ndjson`, `jsonl`

    All commands support `-o <path>` to write output to a file.
  </Accordion>

  <Accordion title="Can I use the CLI in scripts and CI/CD pipelines?">
    Yes. The CLI is fully pipe-friendly. When stdout is not a TTY, colors and spinners are automatically disabled. Use `--json` for machine-readable output and `BRIGHTDATA_API_KEY` environment variable for non-interactive authentication.
  </Accordion>
</AccordionGroup>

## Authentication

<AccordionGroup>
  <Accordion title="Where are my credentials stored?">
    Credentials are stored locally on your machine:

    | OS      | Path                                                            |
    | ------- | --------------------------------------------------------------- |
    | macOS   | `~/Library/Application Support/brightdata-cli/credentials.json` |
    | Linux   | `~/.config/brightdata-cli/credentials.json`                     |
    | Windows | `%APPDATA%\brightdata-cli\credentials.json`                     |

    The file is set to mode `0o600` (owner read/write only).
  </Accordion>

  <Accordion title="How do I log in on a remote server without a browser?">
    Use the device flow:

    ```bash theme={null}
    brightdata login --device
    ```

    This prints a URL and a verification code. Open the URL on any device with a browser, enter the code, and authentication completes on the server.
  </Accordion>

  <Accordion title="How do I switch between Bright Data accounts?">
    Run `brightdata logout` followed by `brightdata login` with the new account. Or pass a different API key directly:

    ```bash theme={null}
    brightdata login --api-key <new_key>
    ```
  </Accordion>
</AccordionGroup>

## Troubleshooting

<AccordionGroup>
  <Accordion title="&#x22;No Web Unlocker zone specified&#x22;">
    This means no default zone is configured. Fix it by either:

    ```bash theme={null}
    # Re-run login (auto-creates zones)
    brightdata login

    # Or set a zone manually
    brightdata config set default_zone_unlocker <zone_name>
    ```
  </Accordion>

  <Accordion title="&#x22;Invalid or expired API key&#x22;">
    Your stored API key is no longer valid. Re-authenticate:

    ```bash theme={null}
    brightdata login
    ```
  </Accordion>

  <Accordion title="&#x22;Access denied&#x22;">
    Your API key does not have permission for the requested zone or operation. Check zone permissions in the [Bright Data control panel](https://brightdata.com/cp).
  </Accordion>

  <Accordion title="&#x22;Rate limit exceeded&#x22;">
    You've hit the rate limit for your zone. Options:

    * Wait a moment and retry
    * Use `--async` for large jobs to avoid blocking
    * Contact your account manager to increase limits
  </Accordion>

  <Accordion title="Pipeline job timed out">
    The default polling timeout is 600 seconds (10 minutes). For large datasets, increase it:

    ```bash theme={null}
    # Per-command
    brightdata pipelines amazon_product "<url>" --timeout 1200

    # Via environment variable
    export BRIGHTDATA_POLLING_TIMEOUT=1200
    ```
  </Accordion>

  <Accordion title="Colors or spinners look broken in my terminal">
    The CLI auto-detects TTY support. If detection fails, pipe through `cat` to force plain output:

    ```bash theme={null}
    brightdata scrape https://example.com | cat
    ```

    Or use `--json` for clean, parseable output.
  </Accordion>
</AccordionGroup>

## Frequently asked configuration questions

<AccordionGroup>
  <Accordion title="How do I change the default output format?">
    ```bash theme={null}
    brightdata config set default_format json
    ```

    Valid values: `markdown`, `json`.
  </Accordion>

  <Accordion title="What is the configuration priority order?">
    Settings are resolved in this order (highest priority first):

    1. **CLI flags** - e.g., `--zone my_zone`
    2. **Environment variables** - e.g., `BRIGHTDATA_UNLOCKER_ZONE`
    3. **config.json** - e.g., `default_zone_unlocker`
    4. **Defaults** - built-in fallbacks
  </Accordion>

  <Accordion title="How do I reset all configuration?">
    Delete the configuration directory:

    ```bash theme={null}
    # Linux
    rm -rf ~/.config/brightdata-cli/

    # macOS
    rm -rf ~/Library/Application\ Support/brightdata-cli/
    ```

    Then run `brightdata login` to start fresh.
  </Accordion>
</AccordionGroup>


# Installation & setup
Source: https://docs.brightdata.com/cli/installation

Install the Bright Data CLI (1000+ scrapers) via npm or curl and authenticate your account with an API key in 1 minute. Includes setup verification commands.

## Install the CLI

The fastest way to run the Bright Data CLI is `npx`, which executes the latest version with no global install:

```bash theme={null}
npx -p @brightdata/cli brightdata --version
```

Prefix any command in these docs with `npx -p @brightdata/cli` to run it the same way, with no global dependency to maintain. The Bright Data CLI requires Node.js 20 or later.

For a persistent `brightdata` command and faster startup, install the CLI globally instead:

<CodeGroup>
  ```bash npm (recommended) theme={null}
  npm install -g @brightdata/cli
  ```

  ```bash yarn theme={null}
  yarn global add @brightdata/cli
  ```

  ```bash pnpm theme={null}
  pnpm add -g @brightdata/cli
  ```
</CodeGroup>

Verify a global install:

```bash theme={null}
brightdata --version
```

<Tip>
  The shorthand alias `bdata` is also available, both with `npx -p @brightdata/cli bdata` and after a global install - use whichever you prefer.
</Tip>

## Update the CLI

Upgrade to the latest version with the same package manager you installed with:

<CodeGroup>
  ```bash npm theme={null}
  npm install -g @brightdata/cli@latest
  ```

  ```bash yarn theme={null}
  yarn global add @brightdata/cli@latest
  ```

  ```bash pnpm theme={null}
  pnpm add -g @brightdata/cli@latest
  ```
</CodeGroup>

Check your installed version against the latest published version:

```bash theme={null}
brightdata --version           # your installed version
npm view @brightdata/cli version   # latest version on npm
```

<Tip>
  New commands ship in CLI releases. For example, `scraper heal` and `scraper approve` were added in v0.3.1. Run the update command above to pick them up. See the [release notes](https://github.com/brightdata/cli/releases) for what changed in each version.
</Tip>

## Authenticate

Run the login command to connect your Bright Data account:

```bash theme={null}
brightdata login
```

This opens your browser for secure OAuth authentication. Once complete, the CLI:

1. Validates and stores your API key locally
2. Auto-creates required proxy zones (`cli_unlocker`, `cli_browser`)
3. Sets sensible defaults so you can start immediately

<Check>
  You only need to log in **once**. All subsequent commands authenticate automatically.
</Check>

### Alternative authentication methods

<AccordionGroup>
  <Accordion title="Headless / SSH environments" icon="server">
    When no browser is available, use the device flow:

    ```bash theme={null}
    brightdata login --device
    ```

    This prints a URL and a code. Open the URL on any device, enter the code, and the CLI completes authentication.
  </Accordion>

  <Accordion title="Direct API key" icon="key">
    For CI/CD pipelines or non-interactive environments, pass your API key directly:

    ```bash theme={null}
    brightdata login --api-key YOUR_API_KEY
    ```

    You can find your API key in the [Bright Data control panel](https://brightdata.com/cp/setting).
  </Accordion>

  <Accordion title="Environment variable" icon="leaf">
    Set the `BRIGHTDATA_API_KEY` environment variable to skip login entirely:

    ```bash theme={null}
    export BRIGHTDATA_API_KEY=YOUR_API_KEY
    ```

    This is useful for Docker containers, GitHub Actions, and other automated environments.
  </Accordion>
</AccordionGroup>

## Interactive setup wizard

For a guided first-time experience, use the init command:

```bash theme={null}
brightdata init
```

This walks you through authentication, zone selection, and default configuration step by step.

| Flag                  | Description                                         |
| --------------------- | --------------------------------------------------- |
| `--skip-auth`         | Skip the authentication step (if already logged in) |
| `-k, --api-key <key>` | Provide API key directly                            |

## Verify your setup

After logging in, confirm everything is working:

```bash theme={null}
# Check your configuration
brightdata config

# Verify API connectivity
brightdata budget

# Try a quick scrape
brightdata scrape https://example.com
```

## Where configuration is stored

The CLI stores credentials and configuration locally:

| OS      | Path                                            |
| ------- | ----------------------------------------------- |
| macOS   | `~/Library/Application Support/brightdata-cli/` |
| Linux   | `~/.config/brightdata-cli/`                     |
| Windows | `%APPDATA%\brightdata-cli\`                     |

Two files are created:

| File               | Purpose                           | Permissions          |
| ------------------ | --------------------------------- | -------------------- |
| `credentials.json` | API key                           | `0o600` (owner-only) |
| `config.json`      | Zones, output format, preferences | Standard             |

<Tip>
  **Priority order for configuration:** CLI flags → Environment variables → `config.json` → Defaults. You can always override any setting on a per-command basis.
</Tip>

## Next steps

<CardGroup>
  <Card title="Commands" icon="code" href="/cli/commands">
    Explore the full command reference.
  </Card>

  <Card title="Usage Examples" icon="book-open" href="/cli/examples">
    Jump into real-world workflows and recipes.
  </Card>
</CardGroup>


# Bright Data CLI
Source: https://docs.brightdata.com/cli/overview

Scrape websites, search the web, extract structured data from 40+ platforms, and manage your Bright Data account from the terminal.

<Card title="Get Started in 60 Seconds" icon="rocket" href="/cli/installation">
  Install the CLI, log in once, and start scraping - CAPTCHAs, anti-bot protections, and JavaScript rendering are handled automatically.
</Card>

## What can you do with the CLI?

<CardGroup>
  <Card title="Scrape any website" icon="globe">
    Get clean markdown, HTML, JSON, or screenshots from any URL - anti-bot bypass and JS rendering included.
  </Card>

  <Card title="Search the web" icon="magnifying-glass">
    Query Google, Bing, or Yandex and get structured results with organic listings, ads, and People Also Ask.
  </Card>

  <Card title="Discover with AI" icon="wand-magic-sparkles">
    AI-powered web discovery - find, rank, and extract content by intent with relevance scoring.
  </Card>

  <Card title="Extract structured data" icon="table">
    Pull product details, profiles, reviews, and more from 40+ platforms like Amazon, LinkedIn, Instagram, and TikTok.
  </Card>

  <Card title="Control a browser" icon="window-maximize">
    Navigate, click, type, screenshot, and read pages using a real remote browser session with persistent state.
  </Card>

  <Card title="Power up AI agents" icon="robot">
    Install skills or add the Bright Data MCP server into Claude Code, Cursor, Codex, and other AI coding agents.
  </Card>

  <Card title="Manage zones & budget" icon="gauge">
    List proxy zones, inspect configurations, and monitor account balance and per-zone costs.
  </Card>

  <Card title="Automate with pipes" icon="pipe-section">
    JSON output, file export, and pipe-friendly design make it easy to chain commands and build workflows.
  </Card>
</CardGroup>

## What the CLI looks like

```bash theme={null}
# Scrape a page as clean markdown
brightdata scrape https://news.ycombinator.com

# Search Google and get structured results
brightdata search "best web scraping tools 2025"

# AI-powered discovery with relevance ranking
brightdata discover "AI trends" --intent "Prioritize institutional reports for VC research"

# Extract an Amazon product as JSON
brightdata pipelines amazon_product "https://amazon.com/dp/B09V3KXJPB" --format json

# Control a remote browser session
brightdata browser open https://example.com
brightdata browser snapshot --compact

# Add Bright Data MCP server to your coding agent
brightdata add mcp
```

<Tip>
  The CLI alias `bdata` is available as a shorthand - e.g., `bdata scrape https://example.com`.
</Tip>

## How it works

The Bright Data CLI wraps the full Bright Data web data platform into simple terminal commands. Under the hood, it:

1. **Authenticates once** via OAuth, device flow, or API key - credentials are stored locally and never need to be entered again
2. **Auto-provisions zones** (`cli_unlocker`, `cli_browser`) on first login so you can start immediately
3. **Routes requests** through Bright Data's infrastructure, handling CAPTCHAs, bot detection, IP rotation, and JavaScript rendering
4. **Returns clean output** - formatted tables in the terminal, or structured JSON/CSV/markdown for automation

## Explore CLI resources

<CardGroup>
  <Card title="Installation" icon="download" href="/cli/installation">
    Install the CLI and authenticate with Bright Data.
  </Card>

  <Card title="Commands" icon="code" href="/cli/commands">
    Full reference for every command, flag, and option.
  </Card>

  <Card title="Usage Examples" icon="book-open" href="/cli/examples">
    Real-world workflows and recipes for common tasks.
  </Card>

  <Card title="FAQs" icon="question" href="/cli/faqs">
    Answers to common questions and troubleshooting tips.
  </Card>
</CardGroup>

<Check>
  **Zero configuration required.** After a one-time `brightdata login`, every command works out of the box - no tokens to manage, no zones to create, no proxies to configure.
</Check>


# Archive API reference
Source: https://docs.brightdata.com/datasets/archive/api-reference

API reference for Bright Data's Web Archive search, including endpoints for running queries and retrieving archived web data.



# How data range affects delivery time
Source: https://docs.brightdata.com/datasets/archive/data-range-vs-delivery-time

Understand how your selected data range affects delivery time in Bright Data's Web Archive, including S3 Glacier retrieval delays for older data.

If your query is matching data within **last 24 hours** - your snapshot will start processing/delivering immediately.

If some of your matched data is **older than 24 hours** - it needs to be retrieved from **S3 Glacier Deep Archive** storage tier before delivery, which may take **up to 72 hours**.

<Warning>
  Avoid queries that span the retention boundary (approximately 24 hours from now).

  Requests with `max_age` or time ranges that fall within \~24h ± 2h of the current time may include files that have already been migrated to archive storage tier. Attempting a dump for such queries can cause the dump to stall or remain incomplete because of files storage class transition.
</Warning>

<Tip>
  **Recommendations:**

  * We recommend using `max_age` = `24h` for initial testing to ensure fast delivery.
  * For real-time data needs: use `max_age: "24h"` or a narrower window to avoid the retention edge.
  * For historical data (older than 24h): use explicit `min_date`/`max_date` filters rather than `max_age`.
  * If a dump appears stalled: we usually retry automatically, please open a ticket if it didn't happen.
</Tip>


# FAQ: Archive API
Source: https://docs.brightdata.com/datasets/archive/faqs

FAQs about the Bright Data Archive API: available data, freshness, refresh cadence, pricing model and 4 supported delivery destinations for archive snapshots.

<AccordionGroup>
  <Accordion title="What is Archive API?">
    Archive API is a massive, continuously expanding, cached repository by Bright Data, designed to capture and deliver public web data at scale.

    It provides full web pages and metadata, making it ideal for AI training, machine learning, and large-scale data analysis.

    Unlike traditional web crawls, Archive API prioritizes **relevance**, **freshness**, and **usability**, giving you access to the most important parts of the internet as they are scraped daily.
  </Accordion>

  <Accordion title="How much data is available?">
    Bright Data’s Archive API has already collected \~90 PB of data, covering \~500 billion+ unique URLs from \~380 million domains.

    We continue to add \~1 PB of new data every week, alongside \~2 billion unique URLs, making Archive the **largest**, up-to-date, web data repository available - perfect for AI and data-driven applications.
  </Accordion>

  <Accordion title="How quickly can I access the data?">
    You can start accessing data immediately through our [Archive API](/datasets/archive/overview). The API allows you to search, retrieve and filter data snapshots from Archive seamlessly and efficiently.

    * Data from the last 24 hours: Will take from within minutes and up to a few hours to deliver (depending on snapshot size)
    * Data older than 24 hours: Will take up to 72 hours to process and deliver (depending on snapshot size)
  </Accordion>

  <Accordion title="How can my data be delivered?">
    Archive offers three delivery options to ensure seamless integration into your existing workflows:

    * **Amazon S3 bucket:** Have your Data Snapshot delivered directly to your S3 bucket.
    * **Azure Blob Storage:** Deliver the data snapshot directly to your Azure Blob container.
    * **Webhook:** Retrieved via webhook for real-time integration into your systems.
  </Accordion>

  <Accordion title="Can I filter Archive's data to get only what I need?">
    Absolutely! Archive API allows filtering by category, domains, date, languages, and country before retrieving data, ensuring you only get what you need.
  </Accordion>

  <Accordion title="How does Bright Data's Archive compare to Common Crawl?">
    When working with large-scale web data, **freshness**, **relevance**, and **accessibility** are key. While Common Crawl provides a broad historical snapshot of the web, Bright Data’s Archive API offers real-time, continuously updated data with advanced filtering and delivery options. Here’s how they compare:

    | **Feature**                      | **Bright Data’s Archive**                                                                                                           | **Common Crawl**                                                                          |
    | -------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------- |
    | **Data Collection**              | Continuously captures public web data in real time, providing results as recent as “now.”                                           | Periodic web crawling (not real-time), updated monthly or bimonthly. Data can be outdated |
    | **Data Volume**                  | \~90 PB collected in a few years, covering \~500 billion pages across \~380M domains. Adds \~1 PB and \~2 billion unique URLs/week. | 250b pages collected over 18 years.                                                       |
    | **Website Coverage & Relevance** | Focuses on high-value, relevant website data based on real scraping business needs.                                                 | Crawls indiscriminately, including outdated or low-quality pages.                         |
    | **Data Types**                   | Full web pages (JS-rendered)                                                                                                        | 98.6% HTML and text                                                                       |
    | **Filtering & Delivery**         | Full discovery and delivery platform- filtering by category, domain, language, date etc. Delivered via Amazon S3, Azure or webhook. | No built-in filtering or delivery. Need to manually process huge raw WARC files.          |
  </Accordion>
</AccordionGroup>


# Web Archive overview
Source: https://docs.brightdata.com/datasets/archive/overview

The Web Archive gives access to Bright Data's stored web traffic (250+ domains), a growing repository of pages collected through Unlocker and SERP APIs.

## What it does

Instead of running your own crawlers, you search the archive, filter what you need (by time range, domain, URL patterns, language, blocking signals), and export ready-to-use datasets as HTML files + metadata.

## Common use cases

* **LLM training and RAG pipelines**: Build or refresh training corpora from targeted web segments
* **Search and indexing**: Backfill indexes with historical content across large domain sets
* **Search product augmentation**: Improve coverage for sites with advanced blocking, supporting reliable page retrieval at scale

## How it works

<Card title="Run a search" icon="search" href="/api-reference/archive-api/run-a-search">
  Filter by time range, domains, URL patterns, language, or signals (CAPTCHA, robots blocks, etc.)
</Card>

<Card title="Review the estimate" icon="clipboard-list" href="/api-reference/archive-api/get-search-status">
  See matched file count, snapshot size, expected duration, and cost
</Card>

<Card title="Create and deliver a dump" icon="file-export" href="/api-reference/archive-api/deliver-to-cloud">
  Export the snapshot as HTML files + metadata (URL, timestamp, collection attributes) to Amazon S3, Azure Blob Storage, or via webhook
</Card>


# Data validation for customers
Source: https://docs.brightdata.com/datasets/data-validation/data-validation-for-customers

How Bright Data's automated dataset validation works across 250+ domains for customers: verification checks, error handling and approval flow before delivery.

## Overview

Bright Data’s automated dataset creation platform consists of a verification and approval phase before the dataset delivery. Bright Data facilitates error handling, validation checks, and customization, ensuring data accuracy and reliability. These validation checks are crucial in saving time, reducing errors in the data, and keeping the data quality at the desired level.

<img alt="flow-chart.png" />

## How does it work?

Once the dataset snapshot is ready:

<Tabs>
  <Tab title="✅ If all validation tests pass">
    The user will get the dataset with an indication in the Bright Data Control Panel that all tests passed.
  </Tab>

  <Tab title="❌ If all/some of the validation tests fail">
    The developer reviews the issues and will decide whether to:

    1. Fix the dataset according to the failed tests.
    2. Deliver the dataset to the user, explaining why the validation test failed but was overridden.

    The user can then decide to:

    1. Approve the snapshot.
    2. Approve the snapshot for this time frame only.
    3. Reject the snapshot, and we will fix the scraper accordingly.
  </Tab>
</Tabs>

When the user approves the dataset snapshot, they proceed to the delivery phase.

## Which validation rules apply

<AccordionGroup>
  <Accordion title="Uniqueness">
    The dataset must contain a certain percentage of unique values.

    * Example: In the LinkedIn company profiles dataset, each company's LinkedIn URL should be unique. If duplicate URLs exist, the same company is listed more than once, violating the uniqueness rule.
  </Accordion>

  <Accordion title="Filling Rate">
    The dataset must contain a minimum percentage of filled values.

    * Example: In a LinkedIn company profiles dataset, at least 90% of the profiles must have the 'Industry' field filled. If more than 10% of the profiles are missing this information (leaving the 'Industry' field blank), the dataset does not meet the required filling rate.
  </Accordion>

  <Accordion title="Required fields">
    Certain fields must be filled; an error will occur if they remain empty.

    * Example: Fields like 'Company Name' and 'Headquarters Location' might be mandatory in the LinkedIn dataset. Any profile lacking this information is flagged as an error.
  </Accordion>

  <Accordion title="Data Stability">
    Compared to previous values collected, the number value must not change by more than X.

    * Example: If the dataset is updated regularly, the number of employees for a company shouldn’t drastically change between updates (e.g., a sudden jump from 50 to 5000 employees) unless there's a known reason (like a merger).
  </Accordion>

  <Accordion title="Type Verification">
    Verifies each entry's data type against its field type (e.g., string, number, date) and flags mismatches for correction.

    * Example: The dataset should only accept date formats in the 'Foundation Date' field. If a text string like 'unknown' is entered, it should be flagged for correction.
  </Accordion>

  <Accordion title="Schema and Field Custom Validation">
    Create a custom rule to validate whether a field exists and its value is valid, such as requiring the size string to be 'S,' 'M,' or 'L.'

    * Example: The dataset might have a field for 'Company Size' with accepted values like 'Small,' 'Medium,' and 'Large.' A record must be flagged if it has a value outside these options.
  </Accordion>

  <Accordion title="Minimum Records Threshold">
    The dataset must have X records (each URL should have X records from the total URL inputs).

    * Example: If the dataset aims to represent companies in a specific sector, like technology, it must have a minimum number of company profiles from this sector to be considered complete and representative.
  </Accordion>

  <Accordion title="Data Size Fluctuation Threshold">
    Determines whether dataset size fluctuations are within a +/- X% range.

    * Example: For datasets updated monthly, the total number of companies listed shouldn’t fluctuate wildly (e.g., more than 10% increase or decrease) from one month to the next unless a specific event or trend is affecting the industry.
  </Accordion>

  <Accordion title="Record Completeness Validation">
    Checks each individual record in the dataset to ensure it doesn't have a high percentage of empty or null fields. If a record has more than a predetermined threshold (e.g., 70%) of its fields empty or null, it triggers an error.

    * Example: In the LinkedIn company profiles dataset, if a specific company's profile has more than 70% of its fields (like industry, size, location, description) empty, this rule would flag it as incomplete.
  </Accordion>

  <Accordion title="Unique Identity and Duplicates Validation">
    Detects and resolves issues that lead to multiple duplicate records in the dataset due to improper identity assignment or entry errors. It ensures each record is distinct and accurately represents a unique data point.

    * Example: In the LinkedIn dataset, this rule would identify cases where the same company is listed multiple times due to errors in assigning unique identifiers. For instance, if slight variations in company profiles (like different spellings of a company name) result in the same company appearing as separate entries, this rule would flag them for correction.
  </Accordion>
</AccordionGroup>

## Main components and functionality

<Frame>
  <img alt="overall-view.png" />
</Frame>

### Evaluating the validation test results

<Frame>
  <img alt="evaluate.png" />
</Frame>

Once the dataset snapshot validation errors are handled, the user is notified to evaluate and choose whether to:

1. Approve
2. Approve temporarily
3. Reject the snapshot.

### How to act on evaluation results

For each failed validation test, the user has three options:

1. **Set a new threshold**
   1. Set custom values - If the developer doesn't reach the default set value, the user can choose a new threshold. The snapshot is returned to the developer once a new threshold is set.
   2. Set for X% - Accept the success rate the developer reached and set the threshold to the value the developer managed to extract.
2. **Ignore test (one time only)** - Accept the value that the developer extracted just once (the default value will not change for the next dataset snapshot)
3. **Reject** - The user doesn’t accept the adjustments to the failed tests; the issues will be returned to the developer to fix. The status will be marked as “Rejected” for additional fixes and will later on be re-send to the customer for approval.

<Frame>
  <img alt="evaluate-options.png" />
</Frame>

In case all issues are ignored/approved, click on “Deliver dataset” to deliver the snapshot.

<Note>A snapshot delivery will be automatically delivered when pending customer approval for 14 days.</Note>

<Frame>
  <img alt="validations-results.png" />
</Frame>

In case all/some issues are rejected, click on “send back to the developer” to send it back for additional fixes.

<Frame>
  <img alt="failed-results.png" />
</Frame>

## Communications and notifications

Users are notified of status updates through their account in the control panel and via email.


# Data validation for partners
Source: https://docs.brightdata.com/datasets/data-validation/data-validation-for-partners

How Bright Data's data staging and validation process works across 250+ domains for partners: error handling, approval workflows and quality checks.

## Overview

We are introducing a new data staging process, enabling both developers and owners to verify and approve datasets before delivery.

The system will facilitate error handling, validation checks, and customization, ensuring accuracy and reliability.

It will help everyone save time, reduce the number of open tickets, and keep the needed level of quality to maintain the level of quality we want.

<img alt="flowchart.png" />

## How does it work?

Once the dataset snapshot is ready, we run its validation tests.

<Tabs>
  <Tab title="✅ If all the validation tests are okay">
    The customer will get the dataset snapshot with an indication on the CP that all test was passed.
  </Tab>

  <Tab title="❌ If all/some of the validation tests fail">
    The partner will review the issues and will choose:

    1. To fix the failed tests
    2. To deliver the snapshot as it is to the customer (**with an explanation of why this test failed but still override**).

    The customer can then decide (per fail test or as a batch):

    1. If he is willing to accept it as it is
    2. Accept it as it is only for this specific snapshot
    3. Reject it and return it to the partner to fix what needs to be fixed
  </Tab>
</Tabs>

Once the customer approves, the snapshot goes to the delivery phase.

## The validation tests

<AccordionGroup>
  <Accordion title="Uniqueness">
    Ensures a minimum percentage of unique values in the dataset.
  </Accordion>

  <Accordion title="Filling Rate">
    Mandates a minimum percentage for filled values.
  </Accordion>

  <Accordion title="Persistence Validation">
    Makes a field mandatory once filled; triggers an error if left empty afterward.
  </Accordion>

  <Accordion title="Data Stability">
    The value number must not change by more than X amount compared to previous values.
  </Accordion>

  <Accordion title="Type Verification">
    Checks each entry's data type against its field type (e.g., string, number, date) to ensure integrity and flag mismatches for correction before processing.
  </Accordion>

  <Accordion title="Schema and Field Custom Validation">
    Establish a custom rule to validate if the specific field exists and the field value is valid, such as requiring the size string to be 'S', 'M', or 'L'; any other value is considered an error.
  </Accordion>

  <Accordion title="Minimum Records Threshold">
    Requires a minimum of X records for the initial dataset (in specific URL should per the minimum of X records from the total URL inputs)
  </Accordion>

  <Accordion title="Data Size Fluctuation Threshold">
    Validates fluctuations within a +/- X% range.
  </Accordion>
</AccordionGroup>

## **Main components and functionality**

<Frame>
  <img alt="snapshots.png" />
</Frame>

<AccordionGroup>
  <Accordion title="Dataset test view">
    There are three filter options (All results, Passed, Failed) for dataset test view

    <img alt="dataset-view.png" />
  </Accordion>

  <Accordion title="Reparse button">
    This will allow you to reparse the cached data

    <img alt="reparse-button.png" />
  </Accordion>

  <Accordion title="Ignore button">
    An option to override a test because the data seems healthy/or it makes sense that the specific dataset does not meet the threshold (note! In case of an override, you will need to write an explanation to the customer)

    <Frame>
      <img alt="ignore-button.png" />

      <img alt="undo-ignore.png" />
    </Frame>

    <Frame>
      <img alt="confirm-undo.png" />
    </Frame>
  </Accordion>

  <Accordion title="“Show related records” and “View & Edit code”">
    In case the test failed, click on the “show related records” to see example of the records and then on “View\&Edit code” to get to the IDE and start fixing the issues

    <img alt="view-edit-code.png" />
  </Accordion>

  <Accordion title="What is the difference between Reparse or Recrawl?">
    Reparse:

    Reparse involves reprocessing the existing raw data that has already been collected.
    It applies the parsing logic, rules, or transformations to the data without fetching fresh data from the web.
    Reparse is useful when changes are needed in data structure, new fields are added to parsing logic, or existing data needs to be restructured or re-extracted.

    Recrawl:

    Recrawl involves revisiting the source website to collect new or updated data.
    It fetches fresh data directly from the source to reflect recent changes or additions on the website.
    Recrawling is useful when the content on the source website changes frequently, or when up-to-date data is critical for analysis or reporting.
  </Accordion>

  <Accordion title="Reparse or Recrawl buttons">
    Once you finish working on the needed fix, you’ll be able to Reparse or recrawl according to your needs

    <img alt="reparse-recrawl.png" />
  </Accordion>

  <Accordion title="Rerun test">
    This will allow you to run the validation tests again if needed

    <img alt="rerun-tests.png" />
  </Accordion>

  <Accordion title="IDE button">
    This will allow you to redirect to the IDE in context in case you need to edit the collector and recrawl (e.g in case there are no records at all)

    <img alt="ide-button.png" />
  </Accordion>

  <Accordion title="Deliver Dataset button">
    After reviewing the needed data and fixing/ignoring issues, you should click on this button and send the snapshot to the owner for review. The ignored tests should be equipped with a reasoning to explain why you chose to ignore the test

    <img alt="deliver-dataset.png" />
  </Accordion>

  <Accordion title="Rejected tests">
    In case not all rejected test was accepted by the owner, the issues will be sent back to you and will be marked with the “Rejected” label for additional fixes and re-sending to the owner for approval

    <img alt="failed.png" />
  </Accordion>
</AccordionGroup>

## Communications and notifications

Status changes and additional notifications will be presented to you as a megaphone on the CP.

## Tickets and bugs

Now, once we introduce the staging process, fixing a collector is not the end of the bug/issue

The process consists of two steps:

1. Fix the collector
2. Fix the snapshot

Hence, the bug processing workflow will be amended to align with the new 2-step process.
<Note>Tickets related to validation issues should not be allowed to be marked as “resolved” before the snapshot is delivered to the dataset owner!</Note>

## Changes to the flow:

We are removing the “Resolve” button from the option on the ticket


# Code examples
Source: https://docs.brightdata.com/datasets/deep-lookup/code-examples

Python, Node.js and shell examples for the Bright Data Deep Lookup API: submit a query, poll for results and parse the structured response end-to-end.

<CodeGroup>
  ```python Python - Complete Research Flow theme={null}
  import requests
  import time

  class DeepLookupAPI:
      def __init__(self, api_key):
          self.api_key = api_key
          self.base_url = "https://api.brightdata.com/datasets/deep_lookup/v1"
          self.headers = {"Authorization": f"Bearer {api_key}"}
      
      def research_with_spec(self, query, columns, limit=100):
          # Create detailed specification
          spec = {
              "name": "companies",
              "query": query,
              "title": query.replace("Find all ", ""),
              "columns": columns
          }
          
          # Trigger research
          trigger_response = requests.post(
              f"{self.base_url}/trigger",
              headers=self.headers,
              json={
                  "query": query,
                  "spec": spec,
                  "result_limit": limit
              }
          ).json()
          
          request_id = trigger_response["request_id"]
          
          # Poll for completion
          while True:
              status_response = requests.get(
                  f"{self.base_url}/request/{request_id}/status",
                  headers=self.headers
              ).json()
              
              print(f"Progress: {status_response.get('progress', 0)}%")
              
              if status_response["status"] == "completed":
                  break
              elif status_response["status"] == "failed":
                  raise Exception("Research failed")
              
              time.sleep(5)
          
          # Get results
          results = requests.get(
              f"{self.base_url}/request/{request_id}",
              headers=self.headers
          ).json()
          
          return results
      
      def monitor_progress(self, request_id):
          """Monitor detailed progress of a research request"""
          while True:
              result = requests.get(
                  f"{self.base_url}/request/{request_id}",
                  headers=self.headers
              ).json()
              
              step = result.get('step', 'unknown')
              
              if step == 'identifying':
                  print("Analyzing your query...")
              elif step == 'generating_schema':
                  print("Creating data structure...")
              elif step == 'generating':
                  pages = result.get('pages_read', 0)
                  matched = result.get('matched_records', 0)
                  print(f"Processing data: {pages} pages read, {matched} matches found")
              elif step == 'done':
                  print("Research completed!")
                  return result
              
              time.sleep(3)

  # Usage
  api = DeepLookupAPI("YOUR_API_KEY")

  columns = [
      {
          "name": "company_name",
          "description": "Name of the company",
          "type": "enrichment"
      },
      {
          "name": "is_ai_company",
          "description": "Must be an AI/ML focused company",
          "type": "constraint"
      },
      {
          "name": "employee_count",
          "description": "Number of employees",
          "type": "enrichment"
      },
      {
          "name": "min_50_employees",
          "description": "Must have at least 50 employees",
          "type": "constraint"
      }
  ]

  results = api.research_with_spec(
      "Find all AI companies in Israel with more than 50 employees",
      columns,
      limit=100
  )

  print(f"Found {results['matched_records']} companies")
  print(f"Skipped {results['skipped_records']} companies (didn't match all criteria)")
  print(f"Total cost: {results['total_cost']}")

  ```

  ```javascript Node.js - Preview and Execute with Progress Monitoring theme={null}
  const axios = require('axios');

  class DeepLookupAPI {
    constructor(apiKey) {
      this.apiKey = apiKey;
      this.baseURL = 'https://api.brightdata.com/datasets/deep_lookup/v1';
      this.headers = {
        'Authorization': `Bearer ${apiKey}`,
        'Content-Type': 'application/json'
      };
    }

    async previewAndExecute(query, limit = 100) {
      // Create preview
      const previewResponse = await axios.post(
        `${this.baseURL}/preview`,
        { query },
        { headers: this.headers }
      );
      
      const previewId = previewResponse.data.preview_id;
      
      // Wait for preview to complete
      let previewData;
      do {
        await new Promise(resolve => setTimeout(resolve, 2000));
        const response = await axios.get(
          `${this.baseURL}/preview/${previewId}`,
          { headers: this.headers }
        );
        previewData = response.data;
      } while (previewData.status !== 'completed');
      
      console.log('Preview ready with', previewData.sample_data.length, 'samples');
      
      // Trigger full research
      const triggerResponse = await axios.post(
        `${this.baseURL}/trigger`,
        {
          preview_id: previewId,
          result_limit: limit
        },
        { headers: this.headers }
      );
      
      const requestId = triggerResponse.data.request_id;
      
      // Monitor detailed progress
      let lastStep = '';
      let result;
      
      do {
        await new Promise(resolve => setTimeout(resolve, 3000));
        const response = await axios.get(
          `${this.baseURL}/request/${requestId}`,
          { headers: this.headers }
        );
        
        result = response.data;
        
        if (result.step !== lastStep) {
          lastStep = result.step;
          switch(result.step) {
            case 'identifying':
              console.log('Analyzing query...');
              break;
            case 'generating_schema':
              console.log('Creating data structure...');
              break;
            case 'generating':
              console.log('Collecting data from sources...');
              break;
            case 'done':
              console.log('Research completed!');
              break;
          }
        }
        
        if (result.step === 'generating' && result.matched_records) {
          console.log(`   Found ${result.matched_records} matches so far...`);
        }
        
      } while (result.step !== 'done' && result.status !== 'failed');
      
      return result;
    }

    async enrichResults(requestId, columnName, columnQuery) {
      // Add enrichment column
      const enrichResponse = await axios.post(
        `${this.baseURL}/request/${requestId}/enrich`,
        {
          column_name: columnName,
          query: columnQuery
        },
        { headers: this.headers }
      );
      
      console.log(`Adding "${columnName}" column...`);
      console.log(`Maximum additional cost: ${enrichResponse.data.max_additional_cost}`);
      
      // Wait for enrichment to complete
      // (Implementation would depend on actual API behavior)
      
      return enrichResponse.data;
    }
  }

  // Usage
  const api = new DeepLookupAPI('YOUR_API_KEY');

  async function runResearch() {
    const results = await api.previewAndExecute(
      'Find all B2B marketplaces in Europe', 
      50
    );
    
    console.log(`Found ${results.matched_records} marketplaces`);
    console.log(`Skipped ${results.skipped_records} that didn't match criteria`);
    console.log(`Cost: ${results.total_cost}`);
    
    // Add an enrichment column
    await api.enrichResults(
      results.request_id,
      'ceo_name',
      'CEO or founder name'
    );
  }

  runResearch();
  ```
</CodeGroup>


# Error handling
Source: https://docs.brightdata.com/datasets/deep-lookup/errors

Reference for Deep Lookup API error codes and response formats, including INVALID_QUERY and other common errors with resolution guidance.

## Error Response Format

```json theme={null}
{
  "error": {
    "code": "INVALID_QUERY",
    "message": "Query must start with 'Find all'",
    "details": "Please rephrase your query to begin with 'Find all' followed by what you're looking for"
  }
}
```

## Common Error Codes

| Code                   | Description                      | Resolution                  |
| :--------------------- | :------------------------------- | :-------------------------- |
| `INVALID_API_KEY`      | API key is missing or invalid    | Check your API key          |
| `RATE_LIMIT_EXCEEDED`  | Too many requests                | Wait and retry with backoff |
| `INVALID_QUERY`        | Query format is incorrect        | Follow query guidelines     |
| `INSUFFICIENT_CREDITS` | Account has insufficient credits | Add credits to account      |
| `REQUEST_NOT_FOUND`    | Request ID doesn't exist         | Verify request ID           |
| `PROCESSING_ERROR`     | Internal processing error        | Contact support             |


# Deep Lookup documentation
Source: https://docs.brightdata.com/datasets/deep-lookup/overview

Deep Lookup is an AI-powered research tool for finding companies, professionals, and entities from 1,000+ public sources with 95%+ accuracy.

## Introduction

Deep Lookup is an AI-powered research tool that allows you to search the public web like a database. Find any set of companies or professionals with precision and get table-ready structured data. With Deep Lookup, you can quickly identify real-world entities such as professionals, companies, products, news and articles, locations, and events that meet specific filters and criteria.

## Why Deep Lookup?

<CardGroup>
  <Card title="Lightning Fast Research" icon="bolt-lightning">
    Turn weeks of manual research into minutes. Deep Lookup searches 1,000+ sources simultaneously, delivering comprehensive results instantly.
  </Card>

  <Card title="95%+ Accuracy" icon="check">
    Our advanced AI models validate data across multiple sources, ensuring the highest quality results for critical business decisions.
  </Card>

  <Card title="Natural Language Queries" icon="language">
    No complex query builders or SQL knowledge needed. Simply describe what you're looking for in plain English, starting with "Find all..."
  </Card>

  <Card title="Pay Only for Value" icon="sparkles">
    Never pay for unmatched results. Our transparent pricing means you only pay for the verified data you receive, not for skipped or filtered-out records.
  </Card>
</CardGroup>

## Key Features

**Universal Entity Search**\
Find companies, professionals, products, news, locations, and events using specific, measurable criteria.

**Smart Data Enrichment**\
Automatically add valuable data points to your results:

* Contact information and emails
* Revenue and employee counts
* Technology stacks and funding data
* Social profiles and company details

**Preview Mode**\
Get 10 free sample records to validate your approach before running the full research.

**Post-Run Enhancement**\
Add new data columns even after your initial research is complete.

**Source Transparency**\
See exactly where each data point comes from with full source attribution.

**Real-Time Extraction**\
Access the most current data available from the public web, not outdated databases.

## How Deep Lookup Works

<Steps>
  <Step title="Start Your Query">
    Begin with "Find all" followed by what you're looking for.
  </Step>

  <Step title="Be Specific">
    The more specific your query, the better your results. Deep Lookup works best when you provide clear, measurable criteria.
  </Step>

  <Step title="Preview & Refine">
    Get 10 free sample records to validate your approach before running the full research.
  </Step>
</Steps>

## Understanding Column Types

When building your research in Preview Mode, you'll work with two types of columns:

### How enrich columns work

**Purpose:** Add new attributes to each result using data from the public web.

These columns provide additional information about your entities without filtering results. For example:

* CEO name for a company
* Revenue figures
* Contact information
* Social media profiles
* Technology stack used

### How filter columns work

**Purpose:** Limit results by applying specific conditions to your query.

These columns determine which records are included in your dataset. For example:

* Companies with revenue greater than \$10 million
* Professionals with 5+ years experience
* Products priced under \$100
* Articles published in the last 30 days

## Understanding "Skipped" Results

When you see "skipped" in a cell, it means the candidate entity did not match at least one of your filter criteria. This is how Deep Lookup ensures precision in your results.

### Important Points About Skipped Results:

* **More filters = fewer results**: The more filters you apply, the more precise your results become, but you may get fewer total matches
* **Each filter must be satisfied**: All filter conditions must be met for an entity to be included
* **Optimization tip**: If you're getting too many skipped results, consider removing some filters to broaden your search
* **Quality over quantity**: Skipped results ensure you only pay for data that exactly matches your criteria

### Example:

If you search for "Find all SaaS companies in California with >100 employees AND revenue >\$10M AND founded after 2020":

* A company with 150 employees and \$15M revenue but founded in 2019 would be skipped
* Only companies meeting ALL criteria appear in your final results

## Deep Lookup Modes

### Preview Mode (Recommended)

The best way to ensure accurate results before spending credits:

* **Free preview results** - Get up to 10 sample records at no cost to understand expected outcomes
* **Query refinement** - Deep Lookup's AI assistant helps you refine and improve query accuracy
* **Column customization** - Review and adjust column names, types, and specifications before running
* **Specs panel control** - Tweak column settings, reorder fields, change types, or add new columns
* **Runtime estimates** - See processing time and cost estimates before committing

### When to use Instant Mode

For fast, one-shot results when you know exactly what you need:

* Run queries immediately for simple, well-defined searches
* Best for repeat queries with proven parameters
* Skip the preview step when you're confident in your criteria

### When to use Advanced Mode

For complex, multi-step research:

* Build sophisticated queries with multiple refinement steps
* Perfect for deep market research or complex data gathering
* Combine multiple data sources and relationships

## Writing Effective Queries

### The Basic Structure

Start every query with "Find all" and describe exactly what you need:

```text theme={null}
Find all B2B SaaS companies in Texas with revenue greater 
than $10 million and less than 100 employees founded after 2020
```

### Key Success Tips

**1. Use Natural Language Comparisons**

* "greater than 50 employees"
* "less than \$5 million in revenue"
* "between 100 and 500 employees"

**2. Specify Geographic Boundaries**

* "in California"
* "headquartered in London"
* "operating in Southeast Asia"

**3. Add Revenue or Size Constraints**

* "with annual revenue greater than \$20 million"
* "having between 50 and 200 employees"

**4. Combine 2-4 Specific Criteria**
The sweet spot for queries is combining a few specific requirements

**5. Include Industry-Specific Terms**

* For tech: "SaaS", "API-first", "cloud-native"
* For finance: "Series B funded", "EBITDA positive"
* For retail: "D2C", "omnichannel", "subscription-based"

## Popular Use Cases

### Sales & Lead Generation

**B2B Decision Maker Targeting** - 100% match rate

```text theme={null}
Find all VPs of Sales at fintech companies in New York with 
50-200 employees including their verified email addresses
```

### How to research competitors

**Competitor Pricing Research** - 97% match rate

```text theme={null}
Find all project management software with pricing between 
$10-100 per user that offer kanban board features
```

### Recruitment & Talent Acquisition

**Executive Search** - 96% match rate

```text theme={null}
Find all Chief Technology Officers at healthcare companies 
in California with more than 500 employees
```

### How to run market research

**Industry Analysis** - 95% match rate

```text theme={null}
Find all electric vehicle manufacturers in the United States 
with manufacturing facilities and more than 500 employees
```

### How to research investments

**Deal Flow Discovery** - 90% match rate

```text theme={null}
Find all Series A fintech startups in Europe that raised 
between $5M and $20M in the last 18 months
```

## What success looks like

| Metric           | Value             | Impact                                   |
| :--------------- | :---------------- | :--------------------------------------- |
| **Time Saved**   | 20-30 min/record  | Weeks of research completed in minutes   |
| **Data Sources** | 1,000+ per result | Comprehensive validation                 |
| **Match Rates**  | 90-100%           | Industry-leading accuracy                |
| **ROI**          | 10-20x            | Each lead worth \$10-20 in research time |

## What to Avoid

### Overly Broad Queries

**Avoid:** "Find all companies"\
**Better:** "Find all software companies in Boston with 50 to 200 employees"

### Too Many Constraints

**Avoid:** Queries with more than 5-6 different criteria\
**Better:** Focus on 2-4 most important criteria

### Avoid vague terms

**Avoid:** "Find all big companies"\
**Better:** "Find all companies with revenue greater than \$100 million"

### Individual Person Searches Without Context

**Avoid:** "Find all people named John"\
**Better:** "Find all executives named John at Fortune 500 companies"

## FAQ

<AccordionGroup>
  <Accordion title="How is Deep Lookup different from Google or ChatGPT?">
    Deep Lookup provides structured, table-ready data from 1,000+ sources. Unlike search engines that give you links or AI that generates text, we deliver verified, actionable business data you can immediately use.
  </Accordion>

  <Accordion title="What happens if I get too many skipped results?">
    Skipped results indicate entities that don't match all your filter criteria. To get more results, try removing some filters or making your criteria less restrictive. Remember, you only pay for matched results, not skipped ones.
  </Accordion>

  <Accordion title="Can I change column types after preview?">
    Yes! In Preview Mode, you can adjust column types, add new columns, and modify specifications before running your full research.
  </Accordion>

  <Accordion title="How accurate is the data?">
    95%+ accuracy with full source transparency. Every data point is validated across multiple sources before delivery.
  </Accordion>

  <Accordion title="Can I test before buying?">
    Yes! Preview Mode gives you 10 free sample records for any query to validate quality before running a full research project.
  </Accordion>
</AccordionGroup>

## Ready to Start Your Research?

Start with 5 free queries to experience the power of Deep Lookup. No credit card required.

[Get Started Free](https://brightdata.com/products/deep-lookup) | [View Pricing](/datasets/deep-lookup/pricing) | [API Documentation](/api-reference/deep-lookup)


# Deep Lookup - pricing
Source: https://docs.brightdata.com/datasets/deep-lookup/pricing

Bright Data Deep Lookup pricing is pay-per-result: you pay only for successfully matched records. Skipped or unmatched results are free. Achieves 95% accuracy.

## Pricing Structure

**\$1.00** per matched record

* 10 enrichment columns included
* Additional columns at \$0.05 each
* 95%+ accuracy
* Source transparency
* Post-run enrichment
* Real-time data extraction
* No charge for skipped results

## How Our Pricing Works

<CardGroup>
  <Card title="Set Your Parameters" icon="square-1">
    Define your research criteria and choose enrichment columns (first 10 included)
  </Card>

  <Card title="See Maximum Cost" icon="square-2">
    View the worst-case cost before running - full transparency, no surprises
  </Card>

  <Card title="Pay Only for Matches" icon="square-3">
    You're only charged for successfully matched records, typically 40-60% less than the maximum
  </Card>
</CardGroup>

## Understanding Skipped Results & Pricing

<Warning>
  **Important:** You never pay for skipped results. When Deep Lookup filters out entities that don't match your criteria, those skipped records don't count toward your bill. This ensures you only pay for data that exactly meets your requirements.
</Warning>

## Pricing Calculator

### Example: Finding 500 B2B Leads

**Your Research:**

* Target: 500 SaaS companies
* Enrichments: 5 columns (all included)

**Results:**

* Records searched: 500
* **Actual matches: 300**
* Skipped (not charged): 200
* Maximum estimate: \$500
* **You pay: \$300**
* **You save: \$200 (40%)**

### Example: Deep Competitor Research

**Your Research:**

* Target: 200 competitors
* Enrichments: 15 columns (10 included + 5 extra)

**Results:**

* Records searched: 200
* **Actual matches: 100**
* Skipped (not charged): 100
* Maximum estimate: \$250
* **You pay: \$125**
* **You save: \$125 (50%)**

## How volume discounts work

Scale your research with progressive savings:

| Monthly Volume       | Discount | Your Price    |
| :------------------- | :------- | :------------ |
| 1-1,000 records      | -        | \$1.00/record |
| 1,001-5,000 records  | 20% off  | \$0.80/record |
| 5,001-10,000 records | 30% off  | \$0.70/record |
| 10,000+ records      | Custom   | Contact sales |

## How Deep Lookup compares for ROI

| Alternative     | Cost        | Time          | Quality           |
| :-------------- | :---------- | :------------ | :---------------- |
| Manual Research | \$30-50/row | 20-30 min/row | Variable          |
| **Deep Lookup** | **\$1/row** | **Instant**   | **95%+ accuracy** |

### Cost Breakdown Example

**Traditional Manual Research:**

* Analyst hourly rate: \$60-100/hour
* Time per record: 20-30 minutes
* Cost per record: \$30-50
* 100 records = \$3,000-5,000

**Deep Lookup:**

* Cost per record: \$1
* Time per record: Instant
* 100 records = \$100
* **Savings: \$2,900-4,900 (97% cost reduction)**

## What every project includes

### Every Research Project Includes

* Real-time data extraction
* 1,000+ sources per result
* Natural language queries
* CSV/JSON export
* Preview mode (10 free samples)
* Source transparency
* Post-run enrichment

### Which enrichments are popular

**Included (first 10 columns):**

* Company name & website
* Industry & description
* Location & headquarters
* Employee count
* Revenue estimates
* Contact emails
* Phone numbers
* Social profiles
* Technology stack
* Funding information

**Additional enrichments (\$0.05 each):**

* Executive names & titles
* Competitor analysis
* News mentions
* Product details
* And 100+ more options

## Frequently asked billing questions

<AccordionGroup>
  <Accordion title="Why do I see a maximum cost estimate?">
    We show the worst-case scenario for full transparency. You'll only pay for actual matches, typically 40-60% less.
  </Accordion>

  <Accordion title="What about skipped results?">
    You never pay for skipped results. These are entities that didn't match your filter criteria and are automatically excluded from billing.
  </Accordion>

  <Accordion title="Can I add enrichments after running my research?">
    Yes! Add new columns anytime at \$0.05 per column per matched record.
  </Accordion>

  <Accordion title="Are there any hidden fees?">
    Never. You only pay for matched records. No setup fees, minimums, or charges for failed matches or skipped results.
  </Accordion>

  <Accordion title="How do credits work during the trial?">
    You get 5 free queries to test Deep Lookup. Each query can search up to 100 records.
  </Accordion>

  <Accordion title="Can I get a refund if I'm not satisfied?">
    We offer a satisfaction policy. If results don't meet expectations, contact support for resolution.
  </Accordion>
</AccordionGroup>

## Ready to Start?

<CardGroup>
  <Card title="Free Trial" icon="" href="https://brightdata.com/products/deep-lookup">
    * \- 5 queries included
    * \- Up to 100 records each
    * \- No credit card required
    *  
  </Card>

  <Card title="Pay As You Go" icon="" href="https://brightdata.com/products/deep-lookup">
    * \- No minimum commitment
    * \- Cancel anytime
    * \- Usage-based billing
    *  
  </Card>

  <Card title="Enterprise" icon="" href="mailto:sales@brightdata.com">
    * \- Volume discounts
    * \- Custom pricing
    * \- Dedicated support
    * \- API access
  </Card>
</CardGroup>


# Customization and filtering
Source: https://docs.brightdata.com/datasets/marketplace/customization-and-filtering

Customize fields and apply filters to Bright Data Marketplace datasets (250+ domains) using the UI or API to get the data subset you need.

Narrow down Bright Data Marketplace datasets (250+ domains) to the exact records and fields you need using the UI or API by creating filtered subsets and selecting the fields to include.

**What you can do:**

* **Customize fields:** choose which columns (fields) to include in your dataset view or export.
* **Filter a dataset:** create a saved subset using filter rules.

**Permissions:** You need access to the dataset and permission to create subsets.

<Frame>
  <img alt="Animated walkthrough of customizing a dataset: selecting fields and applying filters on the preview table" />
</Frame>

## How to customize fields

Choose which fields (columns) appear in your Bright Data Marketplace dataset view and exports.

1. Navigate to the dataset you want to work with.
2. Open the Fields selector.
3. Select the fields you want to include in the view.
4. Click Apply, and save the view if prompted.

**Expected result:** The dataset preview and any export from this view include only the selected fields.

<Frame>
  <img alt="Fields selector open, showing available fields with selected fields checked" />
</Frame>

## How to filter a dataset

Create a saved subset of a Bright Data Marketplace dataset by applying filter rules in the UI or through the API.

<Frame>
  <img alt="Filter panel open with Include filters and Create subset visible" />
</Frame>

### Filter a dataset using the UI

1. Navigate to the dataset you want to filter.
2. Click the Filter icon (top right).
3. Enter a name so you can find this subset later.
4. Under Include filters, add one or more filters (for example: country, job title, date).
5. Click Create subset.

**Expected result:** A new subset appears with only the records that match your filters.

### Filter operators reference

#### Select

Match one or more exact values from a predefined list (for example: countries or regions).

#### Boolean (true/false)

Filter fields that can only be true or false (for example: a field like `verified`).

#### Date

Filter records within a specific date range (start date and end date).

#### Number (operators)

* **Is:** match an exact numeric value.
* **Not:** exclude a numeric value.
* **Exists:** include only records where the field is not empty.
* **List (exact match):** match any value in a provided list.
* **Lower than / Lower or equal to:** match values below (or up to) a threshold.
* **Greater than / Greater or equal to:** match values above (or at) a threshold.

#### String

Filter text fields using the match types available in the UI (for example: exact match or contains).

#### Array

Use Array includes to match records where a multi-value (array) field contains a specific value (for example: categories, attributes or labels).

#### Upload a CSV list

If you need to match many values, use the CSV upload option in the value input. Upload a CSV with one value per row. After upload, the filter matches records where the array contains any value from the uploaded list.

#### CSV upload limitations

* **CSV format:** upload a `.csv` file with one value per row (single column).
* **Maximum 10,000 values per list:** to match more, split the values across multiple CSV lists, up to 100,000 values total, and apply them as filters in separate subsets.
* **No empty or whitespace-only lines:** lines that contain only spaces are rejected.
* **Single column only:** the CSV must contain only one column. If you include a header, it must be a single column.
* **One value per row:** put exactly one filter value on each row. Do not comma-separate multiple values on the same row.

### Includes vs List (exact match)

#### Includes

Use Includes to match records where the field contains the value you enter (partial match).

Example: if the field is `name` and you filter with Includes = `john`, you match values like `John Smith` and `Johnson`.

#### List (exact match)

Use List (exact match) to match records where the field value is exactly one of the values in your list (no partial matches).

Example: List (exact match) = `John Smith`, `Jane Doe` matches only those exact values.

### Group filters (rule-based filters)

1. Click + Add filter.
2. Select Add group.
3. Define your group rules (for example: category is "Electronics" and brand is "Dell" or "Apple").

**Expected result:** The subset includes only records that match your group logic.

### Limitations

* Groups can't be nested.
* A maximum of two groups per filter is allowed.
* A maximum of four inputs per filter group is allowed.
* To filter by more values, use a CSV list upload option (if available) or contact your account manager.
* For more complex queries, contact your account manager.

## Troubleshooting

* **I can't see the Filter icon.** Make sure you're viewing the dataset table and that your account has permission to create subsets.
* **My subset returns no results.** Remove filters one by one to identify the restrictive condition, then reapply the correct values and operators.

## Next steps

* [Export or download a dataset subset](/datasets/marketplace/data-delivery-and-export)
* [Filter a dataset by API](/datasets/marketplace/filter-dataset-by-api)
* [Bright Data Marketplace datasets overview](/datasets/marketplace/overview)


# Marketplace data delivery
Source: https://docs.brightdata.com/datasets/marketplace/data-delivery-and-export

Receive Bright Data Marketplace datasets in JSON, NDJSON, CSV, XLSX or Parquet via email, API, webhooks or cloud destinations like S3 and Snowflake.

Once you purchase or subscribe to a dataset, Bright Data delivers it directly to your preferred destination. Choose from 9 delivery methods and 5 output formats to fit your existing infrastructure and workflow.

## Output formats

Datasets are available in the following formats:

| Format  | Description                                 |
| ------- | ------------------------------------------- |
| JSON    | Standard structured format                  |
| NDJSON  | Newline-delimited JSON, ideal for streaming |
| CSV     | Spreadsheet-compatible format               |
| XLSX    | Microsoft Excel format                      |
| Parquet | Columnar format optimized for analytics     |

<Tip>
  You can also receive data in compressed (gzip) format to reduce file size.
</Tip>

## Which delivery methods are supported

Choose how and where your data is delivered:

| Method               | Description                                          |
| -------------------- | ---------------------------------------------------- |
| Email                | Receive datasets directly in your inbox              |
| API download         | Download via the Bright Data API using a snapshot ID |
| Webhook              | Get data pushed to your endpoint automatically       |
| Amazon S3            | Deliver directly to your S3 bucket                   |
| Google Cloud Storage | Deliver to your GCS bucket                           |
| Google Cloud Pub/Sub | Stream data via GCP Pub/Sub                          |
| Microsoft Azure      | Deliver to your Azure Blob Storage container         |
| Snowflake            | Load directly into your Snowflake data warehouse     |
| SFTP                 | Deliver via secure file transfer protocol            |

## How to set up delivery

<Steps>
  <Step title="Open My Datasets">
    After purchasing a dataset, go to **Control Panel → My Datasets**.
  </Step>

  <Step title="Open Delivery Settings">
    Select your dataset and click **Delivery Settings**.
  </Step>

  <Step title="Choose method and format">
    Pick your preferred delivery method and output format.
  </Step>

  <Step title="Configure credentials">
    Enter the destination credentials (bucket name, webhook URL, SFTP host, and so on).
  </Step>

  <Step title="Save">
    Click **Save**. Your data is delivered automatically on each refresh.
  </Step>
</Steps>

## Related

* [Purchase options](/datasets/marketplace/purchase-options)
* [Pricing](/datasets/marketplace/pricing)
* [Filter dataset by API](/datasets/marketplace/filter-dataset-by-api)


# Dataset view
Source: https://docs.brightdata.com/datasets/marketplace/dataset-view

Browse dataset details in the Bright Data Marketplace (250+ domains), including data fields, freshness, sample downloads and purchase options.

## How to preview a data sample

<Frame>
  <img alt="Data sample" />
</Frame>

* Data-fields
* Records
* Freshness
* Min order
* Download data sample: JSON, CSV, number records (display 30 records but you get 1,000 records)
* CSV/JSON
* Create a subset
* Contact us
* Purchase options

### How to customize a dataset

* Customize - Create a custom subset by hiding/showing and renaming fields and filter the dataset according to your requirements.
* Customize Fields
* Filter

## Where to view the data dictionary

<Frame>
  <img alt="Dictionary" />
</Frame>

* Search attribute
* Table
  * Column name
  * Description
  * Data type

## When to use this dataset

<Frame>
  <img alt="Use-cases" />
</Frame>

* Case study
* Related subset
* What category it’s related to

## What this dataset covers

<Frame>
  <img alt="About" />
</Frame>

* Description about the dataset
* What domain we collect from
* Use case categories
* Customize dataset CTA
* Delivery options
* FAQ

## Initiate by API

* Ability to submit a request through the API or the UI  to collect fresh data based on your own URLs (inputs)
* +Add input
* Upload CSV
* Creating API key to initiate a collection
* Setting the expected records
* Data Collection Choices
  * Discover new records
  * Specific URL collection
* Purchase options


# Dataset marketplace FAQs
Source: https://docs.brightdata.com/datasets/marketplace/faqs

FAQs about Bright Data's Dataset Marketplace (250+ domains), including available datasets, delivery options and purchase choices for ready-to-use data.

<AccordionGroup>
  <Accordion title="What are some of the datasets available on the Dataset Marketplace?">
    The following is a partial list of datasets available for immediate download from the Datasets Marketplace:

    **Popular Datasets**

    * Amazon products
    * Crunchbase companies information
    * Facebook - Posts by group URL
    * Github repository
    * Glassdoor companies overview information
    * LinkedIn company information
    * LinkedIn people profiles
    * LinkedIn posts
    * Zillow properties listing information

    The datasets are broken up by category. Here are the main categories and some of the datasets:

    **eCommerce Data**

    * amazon.com, amazon.co.uk, amazon.de, amazon.es, amazon.fr, amazon.in, amazon.it,
    * homedepot.com, homedepot.ca
    * lazada.com.my, lazada.sg, lazada.vn

    **Real Estate Data**

    These datasets include information regarding housing data, real estate prices, rent prices etc.

    * Bayut UAE Property Listings
    * Booking.com Property Listings
    * Dubizzle UAE Property Listings
    * PropertyFinder Property Listings
    * US Consumer Property
    * ZoomProperty UAE Property Listings
    * infocasas.com.uy
    * inmuebles24.com
    * metrocuadrado.com
    * otodom.pl
    * properati.com.co
    * realestate.com.au
    * toctoc.com
    * zillow\.com
    * zonaprop.com.ar
    * zoopla.co.uk

    **Social Media Data**

    * facebook.com
    * instagram.com
    * linkedin.com
    * pinterest.com
    * reddit.com
    * tiktok.com
    * unashamedcataddicts.quora.com
    * vimeo.com
    * x.com
    * youtube.com

    **Travel Data**

    * Booking.com Hotel Room Pricing and Availability
    * Deliveroo Restaurant Listings
    * OpenTable Restaurant Listings
    * Short-Term Rental Occupancy & Pricing Dataset
    * Talabat Restaurant Listings
    * Tripadvisor Restaurant Listings
    * Zomato UAE Restaurant Listings
    * airbnb.com

    **B2B Data**

    * Business Contacts Dataset
    * Business Firmographic Data
    * Business Intelligence Dataset
    * Business Location (POI) Dataset
    * Companies Hierarchy Dataset
    * Online Intent Data
    * Politically Exposed Persons List
    * Tech Install base Data Feed
    * US B2B Employees
    * US Consumer Demographics
    * crunchbase.com
    * g2.com
    * glassdoor.com
    * google.com
    * indeed.com
    * linkedin.com
    * manta.com
    * owler.com
    * slintel.com
    * stackoverflow\.com
    * trustpilot.com
    * ventureradar.com
    * xing.com
    * yelp.com

    The datasets marketplace is continously updated with fresh datasets. For the complete list, click on "Web Data" on the sidebar, and then on "Datasets Marketplace" on the top bar.

    If the domains you need aren't exist in the Marketplace, you can request them through the Custom Dataset (CDS).
  </Accordion>

  <Accordion title="Do you offer any free datasets?">
    Yes! you can download a few free datasets:

    * espn.com - NBA data
    * goodreads.com
    * imdb.com
    * worldpopulationreview\.com

    The datasets marketplace is continously updated with fresh datasets. For the complete list, click on “Web Data” on the sidebar, and then on “Datasets Marketplace” on the top bar.
  </Accordion>

  <Accordion title="Why does the timestamp differ from the delivery date in the marketplace dataset?">
    The schedule run is designed to ensure timely delivery.

    The delivery deadline is calculated based on previous collection cycles and the estimated refresh duration.

    Therefore, the collection may start earlier than the delivery date to guarantee that the data is delivered on time.
  </Accordion>

  <Accordion title="How do I see data snapshots that are ready?">
    You can find your data snapshots under the "My datasets" tab. There, you'll see a table with information about each snapshot, including its status: ready, failed, or in building.
  </Accordion>

  <Accordion title="What do I do with the Snapshot ID?">
    A Snapshot ID is a unique identifier assigned to a specific data snapshot, formatted as "snap\_XXXXXX".

    You should use the Snapshot ID whenever there is an issue with a particular data snapshot. Including this ID in your support ticket helps the support team quickly identify the exact snapshot in question, leading to faster issue resolution.

    The Snapshot ID ensures that both you and the support team are referring to the same data set, reducing confusion and delays in addressing your problem.
  </Accordion>
</AccordionGroup>

<AccordionGroup>
  <Accordion title="How do you set the record limit?">
    You can set a record limit in two ways:

    **Using the control panel:** Before purchasing a dataset, click “Proceed to purchase.” On the “Choose delivery frequency” page, select the “Too pricey? Limit dataset records” option to specify your desired record limit.

    **Through the Filter API:** Add a parameter to limit the number of records returned by the API. For reference, see: [Dataset Filter API - records\_limit](/api-reference/marketplace-dataset-api/filter-dataset#body-records-limit).
  </Accordion>

  <Accordion title="What is a commitment cost for the Dataset (Filter) API?">
    Currently, there is no monthly commitment or minimum order of \$250 required when using the Dataset Filter API. You only pay based on your actual record consumption.
  </Accordion>

  <Accordion title="I ran a filter request and was charged before buying the data. What's going on?">
    When you submit a dataset filter API request, compute resources are used to identify records matching your filter criteria. If matching records are found, you will be charged based on the amount of these matched records. However, if no matching records are found, you will not be charged. To avoid charges while exploring your filter criteria, you can test filters through the dataset preview table in the control panel, which offers up to 10 free filters per day.
  </Accordion>

  <Accordion title="Why are some fields not fully fillable?">
    Some fields may have lower fill rates due to limitations or gaps in the publicly available source data. Fill rates vary depending on dataset type and source quality - which can result in partial coverage for specific attributes. We provide detailed fill rates and statistics for each dataset to help you evaluate completeness before purchasing.
  </Accordion>

  <Accordion title="I need datasets">
    Bright Data offers several services for accessing and managing datasets:

    1. **Dataset Marketplace**: This is a centralized platform where you can discover, customize, and purchase high-quality datasets from over 250 domains. You can browse pre-built datasets across multiple domains, examine data samples, and apply advanced filters. [Explore the Dataset Marketplace here](https://brightdata.com/datasets/marketplace/browse).

    2. **Dataset APIs**: These APIs allow you to request, initiate, and manage data collections. You can define parameters for new dataset collections, check the status of your requests, and download datasets using snapshot IDs. [Learn more about Dataset APIs here](https://brightdata.com/api-reference/marketplace-dataset-api/request-a-collection).

    3. **Deep Lookup**: This service provides a more granular and streamlined way to request and manage data collections, facilitating effective dataset generation according to your specific needs. [Explore Deep Lookup here](/datasets/deep-lookup/overview).

    Would you like more information on how to use any of these services?
  </Accordion>
</AccordionGroup>

<AccordionGroup>
  <Accordion title="Does the &#x22;LinkedIn People Profiles&#x22; dataset include email addresses or phone numbers?">
    * By default, standard LinkedIn profile records **do not** include email addresses or phone numbers. This information is not publicly available on LinkedIn.
    * However, Bright Data offers an **enriched business contact** solution (in partnership with RevenueBase) that adds business emails and phone numbers for many LinkedIn people profiles, fully GDPR-compliant and sourced via third-party validation.
    * Contact data coverage may vary by profile and use case.
  </Accordion>

  <Accordion title="How can I request enriched records with email and phone?">
    * In the Dataset Marketplace, after selecting "LinkedIn People Profiles", use the **Contact filters** button (on the right side of the Data sample view) to choose your contact data options:
      * **Standard LinkedIn profile data:** No contact info.
      * **Enriched business contact info:** Select “Standard Profiles + Enriched with Business Contact Info” or “Only Profiles with Business Contact Info” to receive available business emails and phone numbers (where provided via RevenueBase partnership and in accordance with GDPR/compliance).
    * Click “Apply filter” to preview and purchase the dataset with your chosen contact enrichment.
  </Accordion>

  <Accordion title="Is the enrichment GDPR-compliant?">
    Yes. All provided business contact data is sourced and processed according to GDPR and other compliance requirements, using approved partners such as RevenueBase.
  </Accordion>

  <Accordion title="Can I get contact info using Deep Lookup?">
    Yes. Bright Data’s [Deep Lookup](https://brightdata.com/cp/deep-lookup) can search for people and return available business contact details (email/phone), where legally sourced and compliant. Specify your entity and required columns in the query (e.g., email, phone).
  </Accordion>

  <Accordion title="How do I check what fields are included before purchase?">
    * Go to Control Panel → Dataset Marketplace → LinkedIn People Profiles.
    * Click “Preview sample” to review all available fields.
    * For enriched datasets, use the **Contact filters** panel as described above, and preview sample rows before placing your order.
  </Accordion>

  <Accordion title="What if I have a compliance or usage question?">
    For full details on compliance, permissible usage, and supported geographies, speak directly with your Bright Data account manager or reach out via [Support](https://brightdata.com/cp/support).

    **Summary:**

    * **Standard LinkedIn profiles** don’t include emails/phones.
    * **Enriched business contact info** (email/phone) is available: just use the Contact filters button in the Dataset Marketplace view.
    * **Deep Lookup** is another route for contact discovery.
    * **Always review** the filtered sample before purchasing, and contact support for custom requirements.

    Let me know if you want a live demo, pricing, or coverage estimate!
  </Accordion>
</AccordionGroup>

<AccordionGroup>
  <Accordion title="What is the API rate limit?">
    The Filter API rate limit is 120 requests per hour. This applies to all API calls and snapshot triggers within the specified time frame.
    Note: Plan your API calls accordingly to stay within the hourly limit. Consider implementing retry logic with exponential backoff for optimal performance.
  </Accordion>

  <Accordion title="What is the maximum number of values I can send to the API filters?">
    You can send up to 10,000 input lines in a single API request when using list filters or include filters.
    Best Practice: For large datasets, consider batching your requests to stay within the 10,000 line limit while maintaining efficient processing.
  </Accordion>

  <Accordion title="What is the maximum input file size for the API?">
    The maximum input file size is 200 MiB for any single API request.
    Warning: Files exceeding 200 MiB will be rejected. Compress your data or split large files into smaller chunks before submission.
  </Accordion>

  <Accordion title="What is the maximum snapshot size for single-file downloads?">
    You can download snapshots up to 5 GB as a single file.

    <Tip>
      For snapshots larger than 5 GB, the API will automatically provide chunked download options or streaming capabilities to handle the data efficiently.
    </Tip>

    ### Quick Reference

    | Limit Type        | Value    | Description                            |
    | :---------------- | :------- | :------------------------------------- |
    | Rate Limit        | 120/hour | Maximum API calls per hour             |
    | Input Lines       | 10,000   | Maximum values in list/include filters |
    | Input File Size   | 200 MiB  | Maximum size for uploaded files        |
    | Snapshot Download | 5 GB     | Maximum size for single-file download  |

    <Note>
      **Need Higher Limits?**\
      Contact our Enterprise team for custom rate limits and increased capacity options tailored to your business needs.
    </Note>
  </Accordion>
</AccordionGroup>

<AccordionGroup>
  <Accordion title="Where do I get a Snapshot ID?">
    Snapshot IDs are returned when you [Trigger Collection](/api-reference/rest-api/scraper/asynchronous-requests) (POST `/datasets/v3/trigger`), [Filter Dataset](/api-reference/marketplace-dataset-api/filter-dataset-with-csv-json-files) (POST `/datasets/filter`), or via a dataset subscription. You can also [list all your snapshots](/api-reference/marketplace-dataset-api/get-dataset-list) with GET `/datasets/v3/snapshots`.

    > See "[Before you begin](/api-reference/marketplace-dataset-api/deliver-snapshot#before-you-begin)" for more details.
  </Accordion>

  <Accordion title="What do I do with the delivery job ID in the response?">
    The `id` in the response is a delivery job ID. Use it to track delivery progress by calling GET `/datasets/v3/delivery/{delivery_id}`. Poll until status is "done".

    > See [Tracking delivery status](/api-reference/marketplace-dataset-api/deliver-snapshot#tracking-delivery-status) for more details.
  </Accordion>

  <Accordion title="Does the snapshot need to be in a specific status?">
    Yes. The snapshot must be in `ready` status. Check with GET `/datasets/snapshots/{id}` before calling deliver.

    > Possible statuses: `scheduled`, `building`, `ready`, `failed`.
  </Accordion>

  <Accordion title="Can I deliver the same snapshot to multiple destinations?">
    Yes. Call this endpoint multiple times with different delivery configurations for the same snapshot ID.
  </Accordion>

  <Accordion title="What file formats are supported?">
    json, jsonl, and csv.
  </Accordion>

  <Accordion title="How do I split large snapshots into smaller files?">
    Use the `batch_size` parameter to set the number of records per file. Each file (batch) must stay under the 5GB hard limit. Estimate `batch_size` by dividing 5GB by your average record size, then start lower and adjust based on the actual file size you get.

    For example, if your average record is \~5KB, a `batch_size` of 1,000,000 records lands right at the \~5GB limit. Start at 500,000 records (\~2.5GB) to stay safely under, then raise or lower `batch_size` based on the file size you receive.
  </Accordion>

  <Accordion title="Why did my request return a 400 error?">
    The most common cause is that your `batch_size` produces a file larger than 5GB. For example, if your average record size is \~5KB, a `batch_size` of 1,000,000 produces a \~5GB file that may exceed the limit. Lower your `batch_size` (e.g., to 100,000) and retry.
  </Accordion>

  <Accordion title="Can I compress the output?">
    Yes. Set `compress: true` to receive gzip-compressed files.
  </Accordion>

  <Accordion title="What is the maximum file size per batch?">
    5GB. This is a hard limit per delivered file. Use `batch_size` to control how many records go into each file and ensure each stays under this threshold.
  </Accordion>
</AccordionGroup>


# Marketplace fill rates
Source: https://docs.brightdata.com/datasets/marketplace/fill-rates-and-statistics

Review per-field fill rates, record counts and data freshness on the Statistics tab of any Bright Data Marketplace dataset (250+ domains) before purchase.

Every Bright Data Marketplace dataset page exposes a Statistics tab with field-level fill rates, the total record count and a freshness indicator. Review these before purchase to confirm the dataset meets your requirements.

## What are fill rates?

A fill rate is the percentage of records in a dataset where a specific field is populated. A fill rate of 100 percent means every record contains a value for that field. A lower fill rate means some records are missing values for that field.

Fill rates vary depending on:

* The dataset type (social media, B2B, eCommerce)
* The source quality and what is publicly available
* The specific field being measured (email, phone number, location)

## Where to find fill rates

Fill rates and statistics are shown on each dataset's page in the Marketplace.

<Steps>
  <Step title="Open the Marketplace">
    In the Bright Data Control Panel, go to **Dataset Marketplace**.
  </Step>

  <Step title="Select a dataset">
    Open the dataset whose coverage you want to review.
  </Step>

  <Step title="Open the Statistics tab">
    Navigate to the **Statistics** tab to view field-level fill rates and record counts.
  </Step>
</Steps>

## What statistics are available?

For each dataset you can review:

* **Fill rate per field**: percentage of records with a value
* **Record count**: total number of available records
* **Freshness**: how recently the data was collected

## Why do some fields have low fill rates?

Some fields have lower fill rates because of limitations or gaps in the publicly available source data. For example, phone numbers and email addresses are not always publicly listed, so contact fields commonly show lower fill rates than name or location fields.

<Tip>
  Always review fill rates before purchasing to confirm the data meets your specific requirements.
</Tip>


# Filter dataset by API
Source: https://docs.brightdata.com/datasets/marketplace/filter-dataset-by-api

Filter Bright Data Marketplace datasets programmatically using the Filter Dataset API. See the full API reference for parameters and examples.

See [Filter Dataset](/api-reference/marketplace-dataset-api/filter-dataset) API Reference page


# Dataset marketplace overview
Source: https://docs.brightdata.com/datasets/marketplace/overview

Browse and buy 350+ ready-to-use datasets from 250+ domains. Updated on a schedule, customizable by field and delivered in your preferred format.

## Introduction to the Dataset Marketplace

The Dataset Marketplace is a one-stop platform for discovering, customizing and purchasing high-quality datasets from over 250 domains. Datasets are regularly updated and ethically sourced from publicly available information, ensuring both accuracy and compliance. Whether you need ready-to-use or on-demand solutions covering social media, real estate, B2B data or AI training, flexible purchase options and field-level customization give you the exact data you need.

## Get started

<Card>
  <CardGroup>
    <Card title="Explore" href="https://brightdata.com/cp/datasets/browse" icon="store">
      Browse a wide range of pre-built, validated datasets across multiple domains.
    </Card>

    <Card title="Dataset view" href="/datasets/marketplace/dataset-view" icon="table">
      Examine data samples, data fields and customization options before purchase.
    </Card>

    <Card title="Customize and Filter" href="/datasets/marketplace/customization-and-filtering" icon="filter">
      Refine datasets with advanced filters, custom field selection and rule-based subsets.
    </Card>

    <Card title="Download data sample" href="/datasets/marketplace/dataset-view" icon="download">
      Preview and download a sample of any dataset in multiple formats.
    </Card>

    <Card title="Fill rates and statistics" href="/datasets/marketplace/fill-rates-and-statistics" icon="chart-line">
      Review data completeness and field coverage to ensure accuracy.
    </Card>

    <Card title="Purchase options" href="/datasets/marketplace/purchase-options" icon="cart-shopping">
      Choose between one-time purchases, subscriptions and flexible data delivery models.
    </Card>

    <Card title="Pricing" href="/datasets/marketplace/pricing" icon="dollar-sign">
      Understand per-record costs, compute fees and available pricing plans.
    </Card>

    <Card title="Data delivery and export" href="/datasets/marketplace/data-delivery-and-export" icon="truck">
      Learn how to receive datasets via email, API, webhooks and cloud services including S3, Azure, Google Cloud, Snowflake and SFTP.
    </Card>
  </CardGroup>
</Card>


# Pricing
Source: https://docs.brightdata.com/datasets/marketplace/pricing

Understand how Bright Data Marketplace datasets are priced, including per-record costs and compute fees for pre-collected and fresh records.

* Pre-collected records
* Fresh records
* Pricing is determined based on compute cost and record cost to reach and collect the data.

For delivery methods and output formats, see [Data delivery and export](/datasets/marketplace/data-delivery-and-export).


# Purchase options
Source: https://docs.brightdata.com/datasets/marketplace/purchase-options

Compare 2 Bright Data Marketplace purchase options: one-time or subscription, pre-collected or fresh data, with supported delivery destinations.

* Purchase options → Flexibility
  * One-time purchase
  * Subscription
* Select data type
  * Pre-collected data - Access data that was collected recently and is ready for use.
  <Frame>
    <img alt="Purchase Options" />
  </Frame>
  * Fresh data - Access data that's up-to-date and fresh, available immediately after it's collected.
  <Frame>
    <img alt="Purchase Options" />
  </Frame>
* Data distribution  - 544M records available spanning from Apr 12 2021, to Feb 27 2024
* Specific time range - Access data from a specific time range.(back from today)

<Frame>
  <img alt="Purchase Options" />
</Frame>

* Available only for pre-collected.
* Select Period
* Collect fresh data for the rest of the records
  * Records outside of the specified time range will be scraped when the request is processed and will incur an additional fee. The refresh time depends on the size of the dataset. You'll get an email when your snapshot is ready.
  * As the data changes, these records may no longer match your filters and may be excluded from your dataset. If these records later do not meet your filters, they will be removed, but you will still be charged for the initial scrape.
* Set record limit - Enter the number of records you would like. Records are selected randomly. Notice that the price will change according to the record count.
* Order
  * Dataset name - “LinkedIn people profile dataset”
  * Total amount of records - 544M records
  * “Records” - cost of total records
  * Number of records - 544M records
  * Cost per record - \$0.0006
  * Subtotal - (before VAT or salestax)
  * Total
* Price adjustment (max snapshot cost)
* Small dataset fee (min snapshot cost)

<Frame>
  <img alt="Purchase Options" />
</Frame>


# Build a scraper with the AI Agent
Source: https://docs.brightdata.com/datasets/scraper-studio/ai-agent

Use Bright Data Scraper Studio's AI Agent to build a custom web scraper from a natural-language prompt in about 10 minutes, no coding required.

Bright Data Scraper Studio's AI Agent builds a custom web scraper from a natural-language description. Give it a target URL and describe the data you want; the agent generates an output schema, writes the scraper code, and hands you a runnable scraper you can trigger by API, manually, or on a schedule. This tutorial walks through the full flow.

**Time to complete:** about 10 minutes

<Tip>
  Prefer the terminal? Use the [Bright Data CLI](/datasets/scraper-studio/build-with-the-cli) to build the same scraper from any shell or coding-agent embedded terminal (Claude Code, Cursor, Codex).
</Tip>

## Prerequisites

* A Bright Data account ([sign up free](https://brightdata.com/?hs_signup=1\&utm_source=docs))
* The URL of the website you want to scrape

## Build your first scraper with the AI Agent

<Steps>
  <Step title="Open Scraper Studio">
    In the Bright Data control panel, click **Scrapers** in the left menu and open **Scraper Studio**.

    <Frame>
      <img alt="Navigate to the Scraper Studio page" />
    </Frame>
  </Step>

  <Step title="Enter the target website URL">
    Paste the URL of the page you want to scrape into the chat input. Along with the URL, add any context that helps the AI build a more accurate scraper on the first try. The more context you provide, the better the generated code.

    <Frame>
      <img alt="Add additional instructions to the AI Agent" />
    </Frame>

    Useful context to include:

    * **Specific fields** you need: "I need price, title, and stock status"
    * **Where the data lives** on the page: "prices are in the product detail panel, not the listing page"
    * **Actions required** to reach the data: "click 'Show more' to load full descriptions"
    * **CSS selectors**, if you know them: `.product-price span.amount`
    * **Page load behavior**, if the site is slow or lazy-loads content: "results load dynamically, give it extra time"

    > **Expected result:** the AI Agent acknowledges the URL and may ask one or two clarifying questions about the data you want.
  </Step>

  <Step title="Answer the AI's questions">
    Respond in plain language.

    > **Expected result:** the AI Agent generates a schema, a structured list of fields with data types that will become your scraper's output.
  </Step>

  <Step title="Review and approve the schema">
    Read through the generated schema. You have four options:

    * **Approve:** click Approve to accept the schema as-is
    * **Decline:** type feedback in the chat (for example, "Remove the image field and add a rating field") and the AI regenerates the schema
    * **Edit inline:** modify the schema directly without going back to the chat
    * **Upload your own schema:** bring your own schema file; download the example file to see the correct format

    Inline editing options:

    * **Edit a field** (pencil icon): change a field's name or data type
    * **Delete a field** (trash icon): remove fields you do not need
    * **Add a field** (plus button): add new fields to the schema

    <Frame>
      <img alt="Approve the generated schema" />
    </Frame>

    Additional controls:

    * **Start from scratch:** clears every field so you can build the schema manually from an empty state
    * **Reset the schema:** discards inline changes and returns to the original AI-generated schema

    Click **Approve** when you are ready.

    > **Expected result:** once approved, the AI Agent starts generating the scraper code.
  </Step>

  <Step title="Wait for code generation">
    The AI writes the full scraper, including extraction logic, navigation handling, data validation, and error handling. This takes a few minutes.

    > **Expected result:** a confirmation popup appears indicating your scraper is ready.

    <Frame>
      <img alt="Collector created successfully confirmation" />
    </Frame>
  </Step>

  <Step title="Run your scraper">
    Click **Try it out** to open the Initiate Manually page. Review the collection settings and click **Start** to begin data collection.

    <Frame>
      <img alt="Start button on the Initiate Manually page" />
    </Frame>

    You can also choose an alternative initiation method:

    * **[Initiate by API](/api-reference/scraper-studio-api/ai-flow/overview):** trigger the scraper programmatically without opening the control panel
    * **Schedule:** run the scraper on a daily, weekly, or custom interval

    > **Expected result:** the scraper collects data. Monitor progress from the Runs dashboard and download results in JSON, NDJSON, CSV, or XLSX once the job completes.
  </Step>
</Steps>

After the scraper is ready, use the [Self-Healing tool](/datasets/scraper-studio/self-healing-tool) to make plain-language changes, or open the code in the Bright Data Scraper Studio IDE to edit it directly.

## What can the AI Agent build?

Reach for the Bright Data Scraper Studio AI Agent when the data you need isn't already in the [Datasets Marketplace](/datasets/marketplace). For sites Bright Data already covers (Amazon, Walmart, LinkedIn, eBay), the marketplace ships pre-built scrapers that are faster and cheaper than building your own. The AI Agent shines on regional ecommerce, B2B catalogs, niche verticals and any site where no marketplace scraper exists.

The AI Agent builds one of five scraper types. Pick the one that matches what you have and what you need.

| Scraper type        | What you provide             | What you get                                      | Page visits per input |
| ------------------- | ---------------------------- | ------------------------------------------------- | --------------------- |
| **PDP**             | List of product URLs         | Full per-product detail                           | 1                     |
| **Discovery**       | Category / listing URL       | Listing-level rows (title, price, rank)           | 1                     |
| **Discovery + PDP** | Category / listing URL       | Full per-product detail for every item            | 1 + N                 |
| **Search**          | Keyword (+ optional country) | Either Discovery or Discovery + PDP shape         | 1 + M                 |
| **Sitemap**         | Domain or `sitemap.xml` URL  | Full per-page detail for every URL in the sitemap | 1 + N                 |

<Warning>
  **Not a crawler.** Don't pass a homepage and ask for "everything." Each scraper is scoped to one data shape.
</Warning>

### When do I use a PDP scraper?

Use a PDP scraper when you have a list of specific product URLs and need full per-product detail. Each input URL produces one row.

**Example:** 100 product URLs from a regional retailer like [dm.de](https://www.dm.de) → 100 rows with title, price, availability, images and any other field you defined in the schema.

Paste this into the AI Agent chat:

```text Prompt theme={null}
Build a PDP scraper for dm.de. For each product URL I provide, extract the product title, price, availability, brand, rating and all product image URLs. Return one row per input URL.
```

### When do I use a Discovery scraper?

Use a Discovery scraper when you need an overview of items on a single listing page and can live without per-product detail. Each input URL produces N rows where N equals the number of items in the listing.

**Example:** A category page like `https://www.dm.de/baby-und-kind` → 30 rows with title, price, rating and listing position. No description, no full image gallery.

Paste this into the AI Agent chat:

```text Prompt theme={null}
Build a Discovery scraper for the dm.de category page https://www.dm.de/baby-und-kind. Return one row per item shown in the listing with title, price, rating and listing position. Do not open the individual product pages.
```

### When do I use a Discovery + PDP scraper?

Use a Discovery + PDP scraper when you need full per-product detail for an entire category. Each input URL produces N rows with the full PDP shape.

This is the most expensive type. One category URL with 200 products costs roughly 200 times a single PDP scrape.

**Example:** A category page on a regional retailer like [decathlon.fr](https://www.decathlon.fr) → full per-product detail for every item in that category.

Paste this into the AI Agent chat:

```text Prompt theme={null}
Build a Discovery + PDP scraper for a category page on decathlon.fr (for example a sport category like running shoes). Find every product in the category, open each product page, and extract full detail: title, price, availability, description, rating and image URLs. Return one row per product.
```

### When do I use a Search scraper?

Use a Search scraper when you do not have specific URLs. Provide a keyword and optionally a country; the AI Agent picks Discovery or Discovery + PDP shape based on whether you asked for listing-level fields or full PDP detail.

**Example:** keyword "brake pads" on a B2B parts site like [autodoc.de](https://www.autodoc.de) → matching product results in either listing-level or full PDP shape.

Paste this into the AI Agent chat:

```text Prompt theme={null}
Build a Search scraper for autodoc.de. For the keyword "brake pads" in Germany, return matching products with title, price, brand and product URL. No need to open each product page.
```

### When do I use a Sitemap scraper?

Use a Sitemap scraper when you need data from many pages on a site and the site publishes those page URLs in an XML sitemap. The sitemap lets the scraper discover URLs directly instead of clicking through category pages, pagination or search results, so it fits large ecommerce sites, marketplaces, catalogs, blogs and documentation sites.

Provide a domain or a sitemap URL. Each sitemap produces N discovered page URLs, and the scraper visits each relevant page to collect the fields you defined in the schema.

**Example:** a domain like [dm.de](https://www.dm.de) or its sitemap at `https://www.dm.de/sitemap.xml` → discover every product URL in the sitemap → visit each product page → collect full product detail.

Paste this into the AI Agent chat:

```text Prompt theme={null}
Build a Sitemap scraper for dm.de. Collect all product URLs from the sitemap, visit each product page, and extract product name, price, SKU, description, image URL and availability. Return one row per product.
```

If you already have the sitemap URL, point the AI Agent straight at it:

```text Prompt theme={null}
Build a scraper using this sitemap: https://www.dm.de/sitemap.xml. Extract all product page URLs, visit each product page, and collect the product detail fields.
```

## Frequently asked questions

<AccordionGroup>
  <Accordion title="Can I edit the code after the AI Agent builds the scraper?">
    Yes. Every scraper the AI Agent generates can be opened in the Bright Data Scraper Studio IDE and edited directly. If you prefer not to write code, use the [Self-Healing tool](/datasets/scraper-studio/self-healing-tool) to request changes in plain language.
  </Accordion>

  <Accordion title="Does the AI Agent build scrapers for login-protected sites?">
    The AI Agent generates scrapers that run on Bright Data's proxy and unblocking infrastructure, which handles most anti-bot defenses. For sites that require a logged-in session, build the scraper in the IDE and use `set_session_cookie()` or the authentication pattern that matches the target site.
  </Accordion>

  <Accordion title="Why didn't the AI generate what I expected?">
    The AI Agent relies on the context you give it. If the output is off, decline the schema and add more specifics about field names, selectors, or the exact page section where the data lives. You can also use the [Self-Healing tool](/datasets/scraper-studio/self-healing-tool) to refine a generated scraper after the fact.
  </Accordion>
</AccordionGroup>

## Related

<CardGroup>
  <Card title="Build with the Bright Data CLI" icon="terminal" href="/datasets/scraper-studio/build-with-the-cli">
    Build the same scraper from the terminal or any coding agent
  </Card>

  <Card title="Develop a scraper with the IDE" icon="code" href="/datasets/scraper-studio/develop-a-scraper">
    Build a scraper by writing JavaScript directly
  </Card>

  <Card title="Self-Healing tool" icon="screwdriver-wrench" href="/datasets/scraper-studio/self-healing-tool">
    Update a generated scraper with plain-language prompts
  </Card>
</CardGroup>


# Web scraping basics in Scraper Studio
Source: https://docs.brightdata.com/datasets/scraper-studio/basics-of-web-scraping

Understand how Scraper Studio IDE scrapers are structured, from inputs and interaction code to parsing, stages, workers, and output records.

Bright Data Scraper Studio IDE scrapers are built from a few core parts: **inputs**, **interaction code**, **parser code**, **stages**, **workers**, and **output records**.

This page explains how those parts work together so you can understand, edit, and debug scraper code with confidence.

For a step-by-step build walkthrough, see [**Develop a scraper with the IDE**](/datasets/scraper-studio/develop-a-scraper).

## Prerequisites

* Basic JavaScript familiarity (variables, functions, async control flow)
* An active [Bright Data account](https://brightdata.com/)

## **Basic scraper flow**

A Scraper Studio IDE scraper usually follows this flow:

1. The scraper receives an **input**, such as a URL, keyword, location, or custom value.
2. **Interaction code** uses that input to open a page, send a request, click, scroll, paginate, or create the next stage.
3. **Parser code** extracts structured data from the loaded page or response.
4. The scraper saves records to the output dataset with `collect()` or `set_lines()`.
5. The final output is delivered according to the scraper’s delivery preferences.

## **Inputs**

Inputs are the values passed into a scraper run.

A scraper might use:

* `url`, for page-based scraping
* `keyword`, for search or discovery flows
* `location`, for location-based searches
* `country`, `date`, `category`, or any other custom field

The available input fields are defined in the scraper’s [**input schema**](/datasets/scraper-studio/input-and-output-schema#what-is-the-input-schema).

Interaction code reads these values from the `input` object:

```js theme={null}
navigate(input.url);
```

For a keyword-based scraper:

```js theme={null}
navigate(`https://example.com/search?q=${input.keyword}`);
```

A scraper does not always need external input. For example, a scraper can use a hardcoded URL if it always collects from the same page.

## **Interaction code**

Interaction code controls how the scraper reaches the data.

It can:

* Navigate to a page
* Send HTTP requests
* Wait for page elements
* Click buttons
* Type into forms
* Scroll through a page
* Handle pagination
* Create additional crawl stages

A simple interaction flow looks like this:

```js theme={null}
navigate(input.url);
wait('.product-title');

const data = parse();
collect(data);
```

In this example:

* `navigate(input.url)` opens the page from the input.
* `wait('.product-title')` waits until the expected page element appears.
* `parse()` runs the parser code.
* `collect(data)` saves the extracted record.

Interaction code is responsible for **getting to the right page or response**. It should not contain most of the extraction logic. That belongs in parser code.

## **Parser code**

Parser code extracts structured fields from the page HTML or response.

Parser code commonly uses Cheerio, a jQuery-like API, to read page elements:

```js theme={null}
return {
  title: $('h1').text_sane(),
  price: $('.price').text_sane(),
  availability: $('.stock-status').text_sane(),
};
```

The parser returns a JavaScript object. That object becomes the structured data your scraper can collect.

For example, a parser can return product data, profile data, listings, article content, or links that the interaction code will use in the next stage.

## `parse() `**and** `collect()`

`parse()` and `collect()` connect interaction code, parser code, and final output.

### `parse()`

`parse()` runs the parser code for the current page or response and returns its result.

Example:

```js theme={null}
let data = parse();
```

### `collect()`

`collect()` appends one record to the output dataset.

Example:

```js theme={null}
collect({
  title: data.title,
  price: data.price,
  url: location.href,
});
```

## **Multi-stage scrapers**

Some scrapers need more than one step to reach the final data.

For example:

1. Start from a search page.
2. Discover result pages.
3. Open each result page.
4. Extract final details.

Scraper Studio supports this pattern with **stages**.

A stage is a separate crawl step. `next_stage()` sends new input values to the next stage.

Example:

```js theme={null}
navigate(`https://example.com/search?q=${input.keyword}`);

const results = parse().results;

for (const result of results) {
  next_stage({ url: result.url });
}
```

Then the next stage can use the new `url` input:

```js theme={null}
navigate(input.url);

const data = parse();
collect(data);
```

Multi-stage scrapers are useful for:

* Search results → detail pages
* Category pages → product pages
* Listing pages → profile pages
* Pagination flows
* Discovery workflows where one page creates many child pages

Scraper Studio can run stages across workers, so this pattern is usually more scalable than processing every page serially in one long script.

## **Parent and child crawls**

When a scraper uses `next_stage()`, it creates a parent-child relationship between crawls.

For example:

* The search page is the **parent** crawl.
* Each result page created from it is a **child** crawl.

This relationship is useful when debugging. In the crawl inspector, you can see which input or page created another page, inspect child pages, and trace where failures happened in a multi-stage flow.

## **Code workers and Browser workers**

Scraper Studio supports two worker types.

### **Code worker**

A **Code worker** uses HTTP requests and raw responses.

Use a Code worker when:

* The data is available in the raw HTML
* The data is available from a public JSON endpoint
* The page does not require browser interaction
* You want faster and more cost-efficient scraping

Code workers cannot click, scroll, type, or run browser-only functions.

### **Browser worker**

A **Browser worker** uses a real headless browser.

Use a Browser worker when:

* The page renders data with JavaScript
* You need to click, scroll, type, or interact with the page
* You need to wait for elements to appear
* You need to capture browser network traffic
* The site requires browser-like behavior

Start with a Code worker when possible. Switch to a Browser worker when the target data is not available in the raw response or when browser interaction is required.

For the complete comparison, see [**Worker types**](/datasets/scraper-studio/worker-types).\\

## How does Scraper Studio handle blocking and CAPTCHAs?

Scraping at scale can trigger site defenses such as:

* IP blocking
* Rate limits
* CAPTCHAs
* Fingerprinting
* Bot detection

Scraper Studio runs on Bright Data’s proxy and unblocking infrastructure, so you do not need to manage proxy rotation, sessions, or retry logic yourself.

Depending on the scraper configuration and worker type, Scraper Studio can:

* Route requests through Bright Data proxy infrastructure
* Retry blocked requests
* Use browser-like fingerprints for Browser workers
* Support CAPTCHA-solving workflows with `solve_captcha()` when applicable

Your scraper code should focus on reaching the right pages and extracting the required data. Bright Data handles the access infrastructure behind the scenes.

## **How schema fits into scraper structure**

The scraper code and schema work together.

### **Input schema**

The input schema defines what values the scraper can receive.

Example input fields:

```js theme={null}
{
  "url": "https://example.com/product/1",
  "country": "US"
}
```

Interaction code reads those values from `input`.

### **Output schema**

The output schema defines what fields the scraper returns.

It is usually generated from the records passed to `collect()`.

Example collected record:

```js theme={null}
collect({
  title: data.title,
  price: data.price,
  availability: data.availability,
});
```

Those fields become part of the output schema.

For more details, see [**Input and output schema**](/datasets/scraper-studio/input-and-output-schema).

## **Common scraper patterns**

### **Single-page scraper**

Use this pattern when each input maps to one final page.

Example:

```js theme={null}
navigate(input.url);
collect(parse());
```

Best for:

* Product pages
* Profile pages
* Article pages
* Detail pages

***

### **Search or discovery scraper**

Use this pattern when an input creates multiple result pages.

Example:

```js theme={null}
navigate(`https://example.com/search?q=${input.keyword}`);

const results = parse().results;

for (const result of results) {
  next_stage({ url: result.url });
}
```

Best for:

* Search pages
* Category pages
* Directory listings
* Marketplace discovery

***

### **Multi-page detail scraper**

Use this pattern when a scraper must move from a list page to many detail pages.

Example flow:

**Input keyword → Search page → Result URLs → Detail pages → Output records**

Best for:

* Product discovery
* Lead generation
* Local business listings
* Review collection
* Job listings

***

## **Debugging mental model**

When a scraper does not return the expected data, check the flow in order:

1. **Input**, Did the scraper receive the expected input values?
2. **Interaction code**, Did it reach the correct page or response?
3. **Parser code**, Did the selectors extract the expected fields?
4. **Stages**, Did `next_stage()` create the expected child pages?
5. **Output records**, Did `collect()` emit the expected structure?
6. **Schema**, Does the output schema include the returned fields?
7. **Worker type**, Does the page require Browser worker behavior?

This flow helps isolate whether the issue is caused by input data, navigation, parsing, staging, schema, or worker configuration.

## Related

<CardGroup>
  <Card title="Worker types" icon="server" href="/datasets/scraper-studio/worker-types">
    Choose between Browser worker and Code worker
  </Card>

  <Card title="Scraper Studio functions" icon="code" href="/datasets/scraper-studio/functions">
    Full reference for interaction and parser commands
  </Card>

  <Card title="Develop a scraper" icon="wrench" href="/datasets/scraper-studio/develop-a-scraper">
    Step-by-step walkthrough of building a scraper in the IDE
  </Card>

  <Card title="Best practices" icon="list-check" href="/datasets/scraper-studio/best-practices">
    Recommended patterns for fast, reliable scrapers
  </Card>
</CardGroup>


# Scraper Studio IDE best practices
Source: https://docs.brightdata.com/datasets/scraper-studio/best-practices

Bright Data Scraper Studio IDE best practices for dead page detection, request batching, pagination, popups, timeouts, retries and parser code in 8 sections.

This guide shows the coding patterns the Bright Data Scraper Studio team recommends for writing fast, reliable scrapers in the IDE. Each section contrasts a common mistake with the preferred pattern and explains the reason.

## How do I detect dead pages reliably?

When using `navigate()`, add a `dead_page()` condition so the scraper does not retry pages that do not exist. Bright Data Scraper Studio automatically marks HTTP 404 responses as dead, but many sites return 200 with a "not found" template, so you must check for that yourself.

Do not wrap `wait()` in a `try/catch` and call `dead_page()` from the `catch` block. A thrown `wait()` only tells you the selector did not appear within the timeout, not that the page is actually dead.

<CodeGroup>
  ```js Bad theme={null}
  try {
    // Waits 30 seconds for 'ok-selector' even if the page is already dead
    wait('ok-selector');
  } catch (e) {
    // You cannot prove the page is dead from a wait timeout alone
    dead_page("Page doesn't exist");
  }
  ```

  ```js Good theme={null}
  wait('ok-selector, 404-selector');
  if (el_exists('404-selector'))
    dead_page();
  ```
</CodeGroup>

## How do I minimize requests to the browser?

Interaction commands like `click`, `type`, `el_exists`, `el_is_visible`, `wait`, and `wait_visible` each send a request to the browser. Combine selectors into a single call instead of chaining several calls.

<CodeGroup>
  ```js Bad theme={null}
  if (!(el_exists('#price1')) || el_exists('#price2')
    || el_exists('#price3') || el_exists('#discount'))
  {
      dead_page('No price found');
  }
  ```

  ```js Good theme={null}
  if (!el_exists('#price1, #price2, #price3, #discount'))
    dead_page('No price found');
  ```
</CodeGroup>

## How do I paginate without blocking parallelization?

When a site has paginated results and you want data from every page, call `rerun_stage()` once from the root page for every page you need. Do not call `rerun_stage()` from inside each page as you walk the pagination: that serializes the work and Bright Data Scraper Studio cannot parallelize the requests.

<CodeGroup>
  ```js Bad theme={null}
  navigate(input.url);
  let $ = load_html(html());
  let next_page_url = $('.next_page').attr('href');
  rerun_stage({url: next_page_url});
  ```

  ```js Good theme={null}
  let url = new URL(input.url);
  if (input.page)
      url.searchParams.set('page', input.page);
  navigate(url);
  // input.page only exists when this stage was re-run for a specific page.
  // On the root page it's undefined, so we fall through to fan out.
  if (input.page)
      return;

  let $ = load_html(html());
  let total_products = +$('.total_pages').text();
  let total_pages = Math.ceil(total_products / 20);
  total_pages = Math.min(total_pages, 50);

  for (let page = 2; page <= total_pages; page++)
      rerun_stage({url: input.url, page});
  ```
</CodeGroup>

Avoid collecting all pages in a single session. Each session has a 16MB result size limit, and that limit counts the total accumulated data in the session, including all collected lines, parsed results, children and parser metadata, not just the size of the rendered page. Calling `rerun_stage({url: input.url, page})` once per page processes one page per session and keeps each session within the limit.

## How do I close popups without waiting for them?

Use `close_popup('popup_selector', 'close_button_selector')` to register a background watcher that closes popups whenever they appear. Do not poll for a popup with `wait_visible()` before each interaction: popups can appear at any time, and explicit waits add latency on every step.

<CodeGroup>
  ```js Bad theme={null}
  navigate('https://example.com');
  try {
    wait_visible('.cky-btn-accept', {timeout: 5000});
    click('.cky-btn-accept');
  } catch (e) {
      console.log('Accept cookies button does not exist, continue');
  }
  ```

  ```js Good theme={null}
  // Runs in the background with no per-step latency.
  // The watcher checks for the popup before every interaction automatically.
  close_popup('.cky-btn-accept', '.cky-btn-accept');
  navigate('https://example.com');
  click('.open-product-full-info');
  ```
</CodeGroup>

## How do I wait for a tagged response before parsing?

When you use `tag_response()` to capture a background API call, follow it with `wait_for_parser_value()` to make sure the request has finished before you read `parser`. Without the wait, the parser may run before the response has arrived and `parser.<field>` will be `undefined`.

<CodeGroup>
  ```js Bad theme={null}
  tag_response('product', /api\/product/);
  navigate('https://example.com');

  // Parser code:
  // The request may not have finished yet; product could be undefined
  let {product} = parser;
  return product.data;
  ```

  ```js Good theme={null}
  tag_response('product', /api\/product/);
  navigate('https://example.com');
  wait_for_parser_value('product');

  // Parser code:
  let {product} = parser;
  return product.data;
  ```

  ```js Good (chained navigation) theme={null}
  tag_response('product', /api\/product/);
  navigate('https://example.com');

  // wait_for_parser_value returns the value so you can use it in interaction code
  let product = wait_for_parser_value('product');
  navigate(product.reviews_url);
  tag_html('reviews_html');

  // Parser code:
  let {product, reviews_html} = parser;
  let $ = load_html(reviews_html);
  let reviews = $('.review').toArray().map(v => $(v).text());
  return {
    ...product.data,
    reviews,
  };
  ```
</CodeGroup>

## Should I throw custom error messages?

No. Let built-in errors from Bright Data Scraper Studio bubble up. They include the selector, the timeout, and the stage, which is more useful than a hand-written "Page not loaded properly". Only throw a custom error when you are checking a domain-specific condition that Bright Data Scraper Studio cannot detect on its own, such as a missing product title.

<CodeGroup>
  ```js Bad theme={null}
  try {
    wait('selector1');
    // some code
    wait('selector2');
    // some code
  } catch (e) {
    throw "Page not loaded properly"
  }
  ```

  ```js Good theme={null}
  // Crawler error: waiting for selector "selector1" failed: timeout 30000ms exceeded
  wait('selector1');
  // some code
  wait('selector2');
  // some code
  ```

  ```js Good (domain-specific check) theme={null}
  if (!el_exists('.product-title'))
      throw new Error('Failed to load product page');
  ```
</CodeGroup>

## How do I handle slow websites without over-extending timeouts?

Keep the default 30-second timeout for most waits. If a specific page is consistently slow, raise it to 45 or 60 seconds. Do not push beyond 60 seconds: a slower peer is usually the cause, and Bright Data Scraper Studio automatically retries with a fresh peer session when a page reports a timeout error.

<CodeGroup>
  ```js Bad theme={null}
  // 120 seconds is too long; the platform cannot recycle a stuck peer
  wait('selector', {timeout: 120000});
  ```

  ```js Good theme={null}
  wait('selector');                       // default 30 seconds
  wait('selector', {timeout: 45000});     // 45 seconds for slightly slow pages
  wait('selector', {timeout: 60000});     // 60 seconds for consistently slow pages
  ```
</CodeGroup>

## Should I build my own retry loop?

No. Bright Data Scraper Studio handles retries at the job level with a new peer session. A custom retry loop inside your scraper reuses the same session, which is the reason the first attempt failed. Report the error and let Bright Data Scraper Studio retry.

<CodeGroup>
  ```js Bad theme={null}
  let counter = input.counter || 5;
  while (counter > 1) {
    try {
      wait('selector', {timeout: 500});
      click('selector');
      type('selector');
      // some code
      break;
    } catch (e) {
      // rerun_stage creates a new session but this pattern spends extra CPM
      return rerun_stage({...input, counter: --counter});
    }
  }
  ```

  ```js Good theme={null}
  navigate('https://example.com');
  wait('h1');
  ```
</CodeGroup>

## Should I wrap parser expressions in try/catch?

No. Use optional chaining (`?.`) and nullish coalescing (`??`) instead. A silent `try/catch` around a property access hides real bugs, and a `try/catch` around a `wait()` wastes browser time.

<CodeGroup>
  ```js Bad theme={null}
  try {
    const example = obj.prop;
  } catch (e) {}
  ```

  ```js Bad theme={null}
  // Wasting browser time for no reason
  try { wait('selector'); } catch (e) {}
  try { wait_network_idle({timeout: 8000}); } catch (e) {}
  try { wait_page_idle(); } catch (e) {}
  ```

  ```js Good theme={null}
  const example = object?.prop;
  const example2 = object.prop ?? undefined;
  const example3 = object.prop ? object.prop : undefined;
  ```
</CodeGroup>

## How do I extract values from a set of elements in parser code?

Use `toArray().map()` instead of `each()`. It is shorter, returns a real array, and reads as a single expression.

<CodeGroup>
  ```js Bad theme={null}
  const links = [];
  $('.card.product-wrapper').each(function (i, el) {
    links.push({url: $(this).find('h4 a').attr('href')});
  })
  return links;
  ```

  ```js Good theme={null}
  const links = $('.card.product-wrapper').toArray().map(v => ({
    url: $(v).find('h4 a').attr('href'),
  }));
  ```
</CodeGroup>

## How do I normalize text in parser code?

Call `$(selector).text_sane()`. Bright Data Scraper Studio adds this custom method to the Cheerio prototype: it collapses every run of whitespace to a single space and trims the result. For numeric extraction, strip non-digits with a regex.

<CodeGroup>
  ```js Bad theme={null}
  $.prototype.clearText = function () {
    return this.text().replace(/\s+/g, ' ').trim();
  }
  ```

  ```js Good theme={null}
  let name = $('a').text_sane();

  // For digits-only extraction:
  let value = +$('a').text().replace(/\D+/g, '');
  ```
</CodeGroup>

## Related

<CardGroup>
  <Card title="Scraper Studio functions" icon="code" href="/datasets/scraper-studio/functions">
    Full reference for Bright Data Scraper Studio interaction and parser commands
  </Card>

  <Card title="Worker types" icon="server" href="/datasets/scraper-studio/worker-types">
    Choose between Browser worker and Code worker for your scraper
  </Card>
</CardGroup>


# Build a scraper with the Bright Data CLI
Source: https://docs.brightdata.com/datasets/scraper-studio/build-with-the-cli

Use the Bright Data CLI to create, run and self-heal a Scraper Studio scraper from your terminal or any coding agent like Claude Code or Cursor.

The Bright Data CLI builds Bright Data Scraper Studio scrapers from your terminal in three commands: log in with `bdata login`, then `bdata scraper create` and `bdata scraper run`. Run it on demand with `npx`, so there is nothing to install. This tutorial walks you through building a Hacker News top-stories scraper end to end. The CLI runs unchanged inside the embedded terminal of any coding agent like Claude Code, Cursor or Codex.

**Time to complete:** about 10 minutes (AI generation runs in the background)

## Prerequisites

* A Bright Data account ([sign up free](https://brightdata.com/?hs_signup=1\&utm_source=docs), no card required)
* A terminal. Any embedded terminal works too: Claude Code, Cursor, Codex, VS Code

## Run the Bright Data CLI with npx

You do not install anything. Run the CLI on demand with `npx`, which fetches the latest version each time:

```bash theme={null}
npx -p @brightdata/cli bdata --version
```

To keep the rest of this tutorial's commands short, alias `bdata` for your shell session. Otherwise, prefix any `bdata` command below with `npx -p @brightdata/cli`:

```bash theme={null}
alias bdata="npx -p @brightdata/cli bdata"
```

The CLI is published as `@brightdata/cli` on npm. The `bdata` and `brightdata` commands are interchangeable. Prefer a permanent command instead of npx? Install it globally with `npm install -g @brightdata/cli`.

## Build your first scraper from the terminal

<Steps>
  <Step title="Log in">
    Run `bdata login`. The CLI opens a browser tab so you can authorize it against your Bright Data account, then stores your API key locally. You do not paste or copy a key.

    ```bash theme={null}
    bdata login
    ```

    > **Expected result:**
    >
    > ```text theme={null}
    > Opening browser for Bright Data authentication...
    > Logged in successfully. Key: 2e75****12bf
    > Checking for required zones...
    > Zone "cli_unlocker" already exists.
    > Zone "cli_browser" already exists.
    > ```

    The two zones (`cli_unlocker` and `cli_browser`) are the Web Unlocker API and Browser API endpoints the CLI uses when running scrapers. Bright Data creates them automatically on first login.
  </Step>

  <Step title="Create the scraper">
    Pass a target URL and one sentence describing the data you want. Bright Data's AI Agent generates the output schema, writes the scraper code and returns a Collector ID.

    ```bash theme={null}
    bdata scraper create https://news.ycombinator.com \
      "Extract top stories: title, url, points, author, comment count"
    ```

    The AI pipeline runs in seven stages, printed live: `user_intent_analyzer`, `planner`, `collector_maintainer`, `output_schema_generator`, `code_generator`, `input_schema_generator`, `preview_runner` and `preview_picker`. Typical wall-clock time is 5 to 15 minutes; complex targets can take up to 25 minutes.

    > **Expected result:**
    >
    > ```text theme={null}
    > Template created: c_mpohus372o5tmid1jk
    > Triggering AI generation...
    > Generating scraper...
    > Step: user_intent_analyzer — polling (attempt 1/600)
    > ...
    > Done in 280 poll attempts.
    > {"status":"done","completed_steps":[...],"step":"preview_picker"}
    > ```

    Save the Collector ID (the `c_*` string). It is the stable handle for every subsequent run, schedule or API call on this scraper.
  </Step>

  <Step title="Run the scraper">
    Pass the Collector ID and a URL. Use `--pretty` to format the JSON output.

    ```bash theme={null}
    bdata scraper run c_mpohus372o5tmid1jk https://news.ycombinator.com --pretty
    ```

    The CLI tries realtime mode first. If the scraper triggers more pages than the realtime limit allows, the CLI silently falls back to batch mode (`POST /dca/trigger` then poll `GET /dca/dataset`) and continues. No flag needed.

    > **Expected result:** a JSON array, one row per result.
    >
    > ```json theme={null}
    > [
    >   {
    >     "title": "Last.fm is now independent",
    >     "url": "https://support.last.fm/t/last-fm-is-now-independent/118591",
    >     "points": 447,
    >     "author": "twistslider",
    >     "comment_count": 131
    >   },
    >   {
    >     "title": "DuckDuckGo search saw 28% more visits after Google said people love AI mode",
    >     "url": "https://www.pcgamer.com/hardware/duckduckgos-ai-free-search-saw-nearly-28-percent-more-visits-in-the-week-following-googles-insistence-that-people-love-ai-mode/",
    >     "points": 418,
    >     "author": "HelloUsername",
    >     "comment_count": 212
    >   }
    > ]
    > ```
  </Step>
</Steps>

## How do I use this from Claude Code, Cursor or Codex?

The Bright Data CLI runs inside any embedded terminal as-is. The coding agent is not building the scraper itself; the CLI calls Bright Data's AI Agent, and the coding agent calls the CLI on your behalf.

Two integrations make the CLI feel native inside a coding agent:

**Pin the Collector ID in the agent's rules file** so the agent re-uses your scraper across sessions instead of building a fresh one every time:

```text CLAUDE.md / .cursor/rules / CODEX.md theme={null}
SCRAPER_STUDIO_COLLECTOR_ID=c_mpohus372o5tmid1jk
HACKER_NEWS_SCRAPER_USAGE="bdata scraper run $SCRAPER_STUDIO_COLLECTOR_ID <url> --pretty"
```

**Wire Bright Data's MCP server into your agent** with `brightdata add mcp`. The MCP server is separate from the Scraper Studio CLI but gives the agent additional scraping tools (`scrape_as_markdown`, `search_engine` and others) it can call directly:

```bash theme={null}
brightdata add mcp                # interactive: pick Claude Code, Cursor or Codex
```

See the [Bright Data MCP server quickstart](/ai/mcp-server-quickstart) for what the MCP exposes.

## What just happened?

Three CLI commands mapped to four Bright Data Scraper Studio API endpoints. Use this table to translate the CLI flow into raw HTTP calls when you are ready to integrate without the CLI:

| You ran                           | Bright Data API endpoint behind it                                                                     |
| --------------------------------- | ------------------------------------------------------------------------------------------------------ |
| `bdata login`                     | Local credential store. Stores the API key from [Account Settings](https://brightdata.com/cp/setting). |
| `bdata scraper create`            | `POST /dca/collector` then `POST /dca/collectors/{c_*}/automate_template`                              |
| `bdata scraper run` (small input) | `POST /dca/trigger_immediate` then `GET /dca/get_result`                                               |
| `bdata scraper run` (large input) | `POST /dca/trigger` then poll `GET /dca/dataset?id=j_*`                                                |

For a worked example of the underlying API in cURL, Python and Node.js, see the [Bright Data Scraper Studio API quickstart](/datasets/scraper-studio/quickstart). For every endpoint, see the [Scraper Studio API reference](/api-reference/scraper-studio-api/Choose_a_delivery_type_on_request_level).

## How do I fix a scraper when the site changes?

When a target site is redesigned and a scraper starts returning null or missing fields, fix it in place with `bdata scraper heal`. Self-healing keeps the same Collector ID, so every trigger, schedule and integration that references the scraper keeps working. The flow is run, inspect, heal, approve, re-run.

<Steps>
  <Step title="Heal the scraper">
    Pass the Collector ID and a plain-language description of what broke. Keep the prompt under 1,000 characters.

    ```bash theme={null}
    bdata scraper heal c_mpohus372o5tmid1jk \
      "The points and comment_count fields return null since the site redesign. Re-capture them from the new markup." \
      --url https://news.ycombinator.com
    ```

    By default, `heal` stops at an approval gate so you can review the proposed fix before it goes live.

    > **Expected result:** the command returns an envelope with `status: "awaiting_approval"` and a `preview_result` showing sample output from the proposed fix, plus a `next_step` hint with the command to run next.
  </Step>

  <Step title="Approve or reject the fix">
    Review the preview. If it looks right, approve it. The fix commits to the existing scraper and the Collector ID does not change.

    ```bash theme={null}
    bdata scraper approve c_mpohus372o5tmid1jk --url https://news.ycombinator.com
    ```

    To discard the proposed fix and try a sharper prompt instead, reject it:

    ```bash theme={null}
    bdata scraper approve c_mpohus372o5tmid1jk --reject
    ```

    > **Expected result:** on approval, `status` advances to `done`. On reject, the scraper is left unchanged so you can run `heal` again with a clearer prompt.
  </Step>

  <Step title="Re-run to verify">
    Run the healed scraper on the same URL and confirm the previously broken fields are populated.

    ```bash theme={null}
    bdata scraper run c_mpohus372o5tmid1jk https://news.ycombinator.com --pretty
    ```
  </Step>
</Steps>

<Tip>
  For unattended workflows, add `--auto-approve` to the `heal` command. It approves the fix automatically and polls through to `done` in one step. Use it only when you trust the heal without a manual review.
</Tip>

## Frequently asked questions

<AccordionGroup>
  <Accordion title="Why did `bdata scraper create` take longer than 10 minutes?">
    AI generation timing depends on target complexity. Simple single-page scrapers finish in 5 to 10 minutes. Pages with lazy-load, pagination or anti-bot challenges can take 15 to 25 minutes. The CLI polls Bright Data's AI Flow API every five seconds and prints the current stage, so you can leave it running and check back. No action is needed while you wait.
  </Accordion>

  <Accordion title="Why did the CLI switch from realtime to batch mode mid-run?">
    Realtime mode caps the number of page loads per request. When a scraper triggers more pages than the realtime limit allows, the CLI prints `Realtime page limit exceeded, switching to batch mode...`, submits the same inputs to `POST /dca/trigger`, and polls `GET /dca/dataset?id=j_*` until the snapshot is ready. The switch is automatic and the final JSON shape is identical. See [Scraper Studio specifications](/datasets/scraper-studio/specifications) for the page-load limits.
  </Accordion>

  <Accordion title="Why are some rows missing fields like `points` or `comment_count`?">
    The AI Agent's generated schema is per-row best-effort, not strict. Jobs posts, "Show HN" entries and very new submissions on Hacker News do not always have a points or comment count yet, so the scraper returns the row with those fields omitted rather than inventing a value. Treat missing fields as `null` in your own code. To enforce a stricter schema, open the scraper in [Scraper Studio](/datasets/scraper-studio/ai-agent) or rewrite the schema with the [Self-Healing tool](/datasets/scraper-studio/self-healing-tool).
  </Accordion>

  <Accordion title="Can I trigger this scraper from my own code instead of the CLI?">
    Yes. The Collector ID returned by `bdata scraper create` (the `c_*` string) is the same handle the Bright Data Scraper Studio API uses. Pass it to `POST /dca/trigger` from any HTTP client. See the [Bright Data Scraper Studio API quickstart](/datasets/scraper-studio/quickstart) for cURL, Python and Node.js examples.
  </Accordion>

  <Accordion title="How do I fix the scraper when the target site changes?">
    Fix it in place with `bdata scraper heal`, which keeps the same Collector ID. See [How do I fix a scraper when the site changes?](#how-do-i-fix-a-scraper-when-the-site-changes) above for the full run, heal, approve, re-run flow. Two alternatives:

    * **Control panel:** use the [Self-Healing tool](/datasets/scraper-studio/self-healing-tool) to describe the fix in plain language.
    * **Direct API:** the `heal` and `approve` commands wrap a three-call loop. `POST /dca/collectors/{c_*}/refactor_template` with the prompt, poll `GET .../refactor_template/progress` until `status` is `pending_answer`, then `POST .../resume_automation_job` to approve or reject. See [Trigger Self-Healing](/api-reference/scraper-studio-api/ai-flow/trigger-self-healing) and [Resume Self-Healing Job](/api-reference/scraper-studio-api/ai-flow/resume-self-healing-job). For a Node.js implementation, see the [Scraper Studio Self-Healing demo](https://github.com/anil-bd/scraper-studio-self-healing-demo).
  </Accordion>

  <Accordion title="Does `bdata login` work without a browser, for example in CI?">
    The `bdata login` command requires a browser callback. For headless environments, export your API key as `BRIGHTDATA_API_KEY` and the CLI uses it directly without a login step:

    ```bash theme={null}
    export BRIGHTDATA_API_KEY="your_api_key_here"
    bdata scraper run c_mpohus372o5tmid1jk https://news.ycombinator.com
    ```

    Copy the key from [Account Settings](https://brightdata.com/cp/setting).
  </Accordion>
</AccordionGroup>

## Related

<CardGroup>
  <Card title="Build with the AI Agent" icon="wand-magic-sparkles" href="/datasets/scraper-studio/ai-agent">
    Build the same scraper from the Bright Data control panel instead of the terminal
  </Card>

  <Card title="Scraper Studio API quickstart" icon="code" href="/datasets/scraper-studio/quickstart">
    Trigger an existing scraper from cURL, Python or Node.js
  </Card>

  <Card title="Self-Healing tool" icon="screwdriver-wrench" href="/datasets/scraper-studio/self-healing-tool">
    Fix a scraper with a plain-language prompt when a target site changes
  </Card>

  <Card title="Bright Data CLI overview" icon="terminal" href="/cli/overview">
    Every `bdata` command, with examples
  </Card>
</CardGroup>


# Scraper Studio coding agent prompts
Source: https://docs.brightdata.com/datasets/scraper-studio/coding-agent-prompts

Copy-pasteable Claude Code, Cursor and Codex prompts to build a Bright Data Scraper Studio scraper: a simple build-and-run prompt plus a full self-heal loop.

Use these copy-pasteable prompts to build a Bright Data Scraper Studio scraper through Claude Code, Cursor or Codex. Start with the one-prompt build-and-run if you just want a scraper fast: swap in your URL and the fields you want, paste, done. The longer flows below add the full build, run, heal, approve, re-run loop for when you need to extend a scraper's schema in place.

## Prerequisites

* A Bright Data account ([sign up free](https://brightdata.com/?hs_signup=1\&utm_source=docs), no card required).
* A coding agent with terminal access: Claude Code, Cursor or Codex.

You do not install the Bright Data CLI ahead of time. The prompts below run it through `npx`, which fetches the latest version on demand, so there is no global dependency to maintain.

## Build a scraper in one prompt

If you just want a scraper fast, paste this prompt and replace the two values in angle brackets: the target URL and the fields you want. The agent runs the Bright Data CLI through `npx`, builds the scraper and runs it once. No self-healing.

```text Prompt theme={null}
Build and run a Bright Data scraper. Run every Bright Data CLI command through `npx -p @brightdata/cli` so nothing is installed globally. Replace <TARGET_URL> and <FIELDS TO EXTRACT>, then do each step in order and stop if a step fails:

1. Authenticate by running `npx -p @brightdata/cli bdata login`. npx fetches the CLI on demand, so there is nothing to install.
2. Create a Bright Data scraper for <TARGET_URL> that extracts: <FIELDS TO EXTRACT>. Report the Collector ID.
3. Run that scraper on the same URL and pretty-print the result.
```

For example, to scrape a product page, the filled-in second step reads:

```text Prompt theme={null}
2. Create a Bright Data scraper for https://shopalto.xyz/product/aurora-wireless-headphones that extracts: product name, price, description and rating. Report the Collector ID.
```

> **Expected result:** the agent reports a Collector ID like `c_mpohus372o5tmid1jk`, then prints a JSON array with one row containing the fields you asked for.

<Tip>
  Save the Collector ID. Reuse it to run the scraper on new URLs, or to extend its schema later with the self-heal flow below.
</Tip>

## Build, run and self-heal in one prompt

To run the full build, run, heal, approve, re-run loop in action, paste this single prompt and let the agent work through every step. The pattern is deliberate: build a minimal scraper first, then heal it to extend the schema, so the heal envelope's `preview_result` is easier to verify against a known-good baseline. The agent runs every Bright Data CLI command through `npx`, so nothing is installed globally.

```text Prompt theme={null}
Build, run, heal and verify a Bright Data scraper end to end. Run every Bright Data CLI command through `npx -p @brightdata/cli` so nothing is installed globally. Do every step in order and stop if a step fails:

1. Authenticate by running `npx -p @brightdata/cli bdata login`. npx fetches the CLI on demand, so there is nothing to install.
2. Create a Bright Data scraper for https://shopalto.xyz/product/aurora-wireless-headphones that extracts two fields: product name and price. Report the Collector ID.
3. Run that scraper on the same URL and pretty-print the result. Expect one row with name and price.
4. Heal the scraper in place to also capture description, image url and rating alongside the existing name and price. Keep the same Collector ID, anchor the heal on the same URL and show the approval envelope.
5. When the preview shows all five fields, approve the fix anchored on the same URL.
6. Run the scraper on the same URL again and confirm all five fields come back: name, price, description, image_url and rating.
```

> **Expected result:** the agent ends with a JSON row containing `name`, `price`, `description`, `image_url` and `rating`, and the Collector ID is unchanged from step 2.

## Run the flow step by step

Work through the prompts below one at a time when you want to inspect each Collector ID, run result and heal envelope before moving on.

<Steps>
  <Step title="Prompt the agent to authenticate the CLI">
    ```text Prompt theme={null}
    Run every Bright Data CLI command through `npx -p @brightdata/cli` so nothing is installed globally. Authenticate by running `npx -p @brightdata/cli bdata login`, then confirm the version with `npx -p @brightdata/cli bdata --version` before continuing.
    ```

    > **Expected result:** the agent prints a `bdata` version and confirms it is authenticated. npx fetches the CLI on demand, so nothing is installed globally.
  </Step>

  <Step title="Prompt the agent to build a minimal scraper">
    ```text Prompt theme={null}
    Create a Bright Data scraper for https://shopalto.xyz/product/aurora-wireless-headphones that extracts just two fields: product name and price. Show me the Collector ID when it is done.
    ```

    > **Expected result:** the agent reports a Collector ID like `c_mpohus372o5tmid1jk`. Hold onto it; the rest of the prompts reuse the same ID.
  </Step>

  <Step title="Prompt the agent to run it">
    ```text Prompt theme={null}
    Run that scraper on https://shopalto.xyz/product/aurora-wireless-headphones and pretty-print the result.
    ```

    > **Expected result:** a JSON array with one row, populated with `name` and `price` only.
  </Step>

  <Step title="Prompt the agent to heal and add more fields">
    ```text Prompt theme={null}
    Extend the scraper in place. Heal it to also capture description, image url and rating alongside the existing name and price. Keep the same Collector ID. Anchor the heal on https://shopalto.xyz/product/aurora-wireless-headphones and show me the approval envelope when it is ready.
    ```

    > **Expected result:** the agent reports `status: "awaiting_approval"` with a `preview_result` row that now shows five fields.
  </Step>

  <Step title="Prompt the agent to approve the fix">
    ```text Prompt theme={null}
    The preview looks good. Approve the fix, anchored on https://shopalto.xyz/product/aurora-wireless-headphones.
    ```

    > **Expected result:** `status` advances to `done`. The Collector ID is unchanged.
  </Step>

  <Step title="Prompt the agent to verify the expanded schema">
    ```text Prompt theme={null}
    Run the scraper on https://shopalto.xyz/product/aurora-wireless-headphones again and confirm all five fields now come back: name, price, description, image_url and rating.
    ```

    > **Expected result:** the same JSON shape as the earlier run, now with three additional fields per row.
  </Step>
</Steps>

<Tip>
  For an unattended variant, ask the agent to add `--auto-approve` to the heal call. The agent skips the approval gate and polls through to `done` in one step. Use it only when you trust the heal without a manual review.
</Tip>

## Related

<CardGroup>
  <Card title="Build with the Bright Data CLI" icon="terminal" href="/datasets/scraper-studio/build-with-the-cli">
    The canonical CLI tutorial: install, log in, create, run, heal
  </Card>

  <Card title="Self-Healing tool" icon="screwdriver-wrench" href="/datasets/scraper-studio/self-healing-tool">
    Fix a scraper from the Bright Data control panel
  </Card>

  <Card title="Scraper Studio API quickstart" icon="code" href="/datasets/scraper-studio/quickstart">
    Trigger an existing scraper from cURL, Python or Node.js
  </Card>

  <Card title="Bright Data CLI commands" icon="book" href="/cli/commands">
    Flag reference for scraper create, heal and approve
  </Card>
</CardGroup>


# Complete Scraper Studio IDE examples
Source: https://docs.brightdata.com/datasets/scraper-studio/complete-examples

Browse 6 end-to-end Bright Data Scraper Studio IDE examples covering interaction code, parser code, multi-result handling and advanced site navigation.

<Warning>
  This article applies only to the IDE Normal V2 version, which is for internal use and not available to customers.
</Warning>

## Introduction

The collect and parse commands have been removed. The data will be returned from parser code as an object or array, and it will be automatically saved to the output:

<CodeGroup>
  ```js Interaction code theme={null}
  // Old code
  navigate("https://example.com");
  collect(parse());

  // New code
  navigate("https://example.com");

  // New code alternative
  navigate("https://example.com");
  tag_html("html_key");
  ```

  ```js Parser code theme={null}
  // Old code
  return {
      title: $('h1').text(),
  };

  // New code
  return {
      title: $('h1').text(),
  };

  // or
  let $ = load_html(parser.html_key);
  return {
      title: $('h1').text(),
  };
  ```
</CodeGroup>

New commands have been added to provide access to the data from the interaction code: `tag_html`, `tag_request`, `tag_graphql`

In addition, some existing commands have been updated: `tag_response`, `tag_sitemap`, `tag_all_responses`. See [IDE documentation](/datasets/scraper-studio/develop-a-scraper) for more details.

When using any tag commands, you can provide a custom name. You can then access the data using this name in the parser code under parser.`YOUR_KEY`.

For `tag_html`, current browser location URL will be saved under parser.`YOUR_KEY_url`.

For simple cases when only a single `tag_html` is needed, it can be skipped, and it will be automatically saved under parser.page.

<CodeGroup>
  ```js Interaction code theme={null}
  navigate("https://example.com/1");
  tag_html("page1");
  navigate("https://example.com/2");
  tag_html("page2");
  navigate("https://example.com/3");
  tag_html("page3");
  ```

  ```js Parser code theme={null}
  {page1, page1_url, page2, page2_url, page3, page3_url} = parser;
  let $ = load_html(page2);
  return {
    title2: $('h1').text(),
  };
  ```
</CodeGroup>

Sometimes, it's necessary to get parsed data within the interaction code and use it to make request. See examples how to do it:

<CodeGroup>
  ```js Interaction code theme={null}
  navigate("https://example.com/1");
  tag_html("page1");
  let page_html = html();
  let page_html2 = wait_for_parser_value("page1"); // the same
  let $ = load_html(page_html);
  let req_id = $('.product-id').text();
  tag_request("product_json", {url: "https://example.com/product/"+req_id});
  ```

  ```js Parser code theme={null}
  {product_json} = parser;
  return product_json;
  ```
</CodeGroup>

## How to return multiple results

To collect multiple results, array can be returned from the parser code.

<CodeGroup>
  ```js Interaction code theme={null}
  navigate("https://example.com/products");
  ```

  ```js Parser code theme={null}
  let items = $(".product").toArray().map(v=>$(v)).map(v=>({
    title: v.find(".title").text(),
    price: v.find(".price").text(),
    url: new URL(v.find("a").attr("href")),
  }));
  return items;
  ```
</CodeGroup>

## How to reparse collected data

Reparse is a new feature that allows to reparse the data that was already collected. It can be useful when you want to change the parser code without rerunning the entire interaction code:

<img alt="Scraper Studio IDE with the 'Run only parser code' button highlighted between the Interaction code and Parser code panels" />

## `next_stage` and `rerun_stage`

When scraper has more than one step, the parser code is only available in the last step. All other steps can only have `next_stage` calls. To parse something from the page, `load_html` should be used:

<CodeGroup>
  ```js Interaction code step 1 theme={null}

  navigate(input.domain_url);
  tag_html('html');
  const $ = load_html(wait_for_parser_value('html'));
  $('a.layout-categories-category__link').toArray()
    .map(v => new URL($(v).attr('href'), location.href))
    .filter(x => !x?.href.includes('home')).forEach(i => {
    next_stage({url: i})
  });
  ```

  ```js Interaction code step 2 theme={null}
  block(['*.ico', '*.png', '*.jpg', '/images/', '*gif']);
  navigate(input.url);
  wait('.view-option-selector-button, .product-groups_empty-list');
  if(el_exists('.product-groups_empty-list'))
    dead_page('There are no products in this category')
  wait('[aria-describedby="onetrust-policy-text"]');
  click('button#onetrust-reject-all-handler');
  wait_hidden('[aria-describedby="onetrust-policy-text"]');
  $('.view-option-selector-button').eq(2).click();
  wait_page_idle(2000);
  scroll_to('bottom');
  wait_page_idle(2000);
  ```

  ```js Parser code theme={null}
  return $('a[data-qa-action="product-click"]').toArray()
    .map(v => ({url: new URL($(v).attr('href'))}));
  ```
</CodeGroup>

## Basic PDP scraper

<CodeGroup>
  ```js Interaction code theme={null}
  let url = new URL(input.url.replace('https://www.slintel.com','https://6sense.com'));
  url = new URL(url.pathname, 'https://6sense.com');
  navigate(url);
  if (location.href === 'https://6sense.com/company')
    dead_page(`Page not found`);
  tag_html('html');
  ```

  ```js Parser Code theme={null}
  const $ = load_html(parser.html)
  const nextData = JSON.parse($('#__NEXT_DATA__').html());
  const pageProps = nextData.props.pageProps;
  const companyInfo = pageProps.company_data.companyInfo;

  const linkedin = companyInfo.linkedin ?
    (companyInfo.linkedin.includes('http') ? companyInfo.linkedin :
      'https://'+companyInfo.linkedin) : null;
  const techCategories = pageProps.company_data?.technologies_mapper_view?.categories
    ? Object.values(pageProps.company_data.technologies_mapper_view.categories).map(v => Object.keys(v)).flat()
    : null;
  const pageData = {
      "name": companyInfo.name,
      "about": companyInfo.company_description,
      "num_employees": companyInfo.employee_range,
      "type": companyInfo.company_type,
      "industries": companyInfo.industry_v2_ranked.filter(v=>v),
      "techstack_arr": techCategories,
      "country_code": companyInfo.country,
      "website": companyInfo.display_domain
        ? new URL(companyInfo.display_domain.includes('http')
            ? companyInfo.display_domain
            : 'https://'+companyInfo.display_domain)
        : null,
      "social_media_urls": linkedin,
      "company_news": pageProps.company_data.company_news.map(v=>({
        title: "company_news_data",
        date: "",
        link: "",
      })),
      "last_updated": new Date(companyInfo.last_updated_at*1e3),
      "url": new URL(parser.html_url),
      "logo": companyInfo.logo,
      "location": companyInfo.location,
      "region": [companyInfo.country, companyInfo.state].filter(v=>v).join(', '),
      "id": nextData.query.companyid,
      "slintel_resources": companyInfo.recommended_companies.map(v=>({
        link: v.display_domain ? new URL(v.display_domain.includes('http') ? v.display_domain : 'https://'+v.display_domain) : null,
        title: v.name,
        type: v.company_type,
      })),
      "stock_symbol": companyInfo.stock_symbol,
  };
  return pageData;
  ```
</CodeGroup>

## Multiple navigates example

<CodeGroup>
  ```js Interaction code theme={null}
  const tabs = [
    'topactivity',
    'answers',
    'questions',
    'tags',
    'articles',
    'badges',
    'bookmarks',
    'bounties'
  ];
  function loadTab(url, name) {
    return new Promise(async (resolve, reject)=>{
      try {
          const tabUrl = new URL(url);
          tabUrl.searchParams.set('tab', name);
          navigate(tabUrl, { allow_status: [404] });
          const html_ = html();
          tag_html(name);
          resolve(html_);
      } catch(e) { reject(e); }
    });
  }
  const userIdFromUrl = (input.url && input.url.includes('https://stackoverflow.com/users/'))
      ? input.url.replace('https://stackoverflow.com/users/', '').split('/').shift()
      : null;
  const userId = input.user_id || userIdFromUrl || 1;
  const userUrl = `https://stackoverflow.com/users/${userId}`;
  navigate(userUrl, { allow_status: [404] });
  tag_html('user');
  Promise.all(tabs.map( async tabName => loadTab(userUrl, tabName)));
  ```

  ```js Parser code theme={null}
  const steps = [
    'user',
    'topactivity',
    'answers',
    'questions',
    'tags',
    'articles',
    'badges',
    'bookmarks',
    'bounties',
    'finally'
  ];
  const parse = Handlers();
  let missed_parser_data = Object.keys(parse)
    .filter(handler_key=>!steps.find(sk=> sk == handler_key));
  if (missed_parser_data.length)
      throw new Error('missed parser data')

  return steps.reduce((acc, step) => {
      console.log('handling: '+step)
      if (step=='finally')
          return parse.finally(acc);
      let page_source = parser[step];
      console.log(parser[step]);
      console.log('parser[step]');
      if (!page_source)
        throw('unexpected empty data, data not saved')
      const $ = load_html(page_source);
      const data_chunk = parse[step]($);
      acc = { ...acc, ...data_chunk };
      return acc;
  }, {});

  function Handlers() {
    return {
      'finally': (res) =>{
        res.url = new URL(res.url);
        res.answers.map(v => v.tags = res.tags);
        res.answers.map(v => v.url = new URL(v.url));
        res.questions.map(v => v.url = new URL(v.url));
        res.top_posts.map(v => v.date = new Date(v.date));
        res.active_from = new Date(res.active_from)
        return res;
      },
      'user': ($)=>{
        const grid = $('#main-content .d-grid > .grid--item')
          .toArray().map(v=>$(v));
        let collectives = grid.find(v=>v.find('> div').text()
          .includes('Collectives'));
        if (collectives?.length) {
            collectives = collectives.find('.fl1').toArray()
            .map(v=>({
                name: $(v).find('.fs-body2').text_sane() || null,
                text: $(v).find('.fs-caption').text_sane() || null,
            }));
        }
        else
          collectives = [];
        let communities = grid.find(v=>v.find('> div').text()
          .includes('Communities'));
        if (communities?.length) {
            communities = communities.find('li.flex--item')
              .toArray().map(v=>({
                name: $(v).find('.fl-grow1').text_sane() || null,
                score: $(v).find('.fl-shrink0').text_sane()
                  .replace(/,/gm, '') || null,
              }));
        }
        else
          communities = [];
        let badges = $('.flex__fl-equal > .flex--item').toArray()
          .map(v=>{
            let $v = $(v);
            return {
                badge_type: $v.find('.mr12 .fc-gold').length
                  ? 'gold'
                  : $v.find('.mr12 .fc-silver').length
                      ? 'silver'
                      : $v.find('.mr12 .fc-bronze').length
                          ? 'bronze'
                          : 'unknown',
                badge_name: $v.find('.fs-caption').text_sane()
                  .replace(' badges', '') || null,
                number_of_badges: $v.find('.fs-title').text()
                  .replace(/,/gm, '') || null,
                badges: $v.find('a.badge').toArray().map(b=>({
                    name: $(b).text_sane() || null,
                    description: $(b).attr('title') || null
                }))
            };
        });
        return {
          url: new URL(parser.user_url),
          id: parser.user_url.split('/').pop(),
          'id#': (input.url && input.url
              .includes('https://stackoverflow.com/users/'))
              ? input.url?.match(/https:\/\/stackoverflow.com/users/(d{1,15}).*/)?.[1]/gm)
              : input.user_id
            || 1,
          user_id: +$('[property="og:url"]').attr('content')
            .match(/https:\/\/stackoverflow.com/users/(d{1,15}).*/)?.[1]/)/gm
              || +input.url?.match(/https:\/\/stackoverflow.com/users/(d{1,15}).*/)?.[1]/gm)
              || +input.user_id
              || null,
          name: $('.fs-headline2').text_sane() || null,
          type: $('#mainbar-full > div:first-child .s-badge')
            .text_sane() || null,
          title: $('#mainbar-full > div:first-child .fs-title')
            .text_sane() || null,
          active_from: new Date(
            $('#mainbar-full > div:first-child .list-reset span[title]').attr('title')),
          last_seen: $('#mainbar-full > div:first-child .fs-title + ul li:last-child')
            .text_sane() || null,
          linkes: $('#mainbar-full > div:first-child ul.list-reset:last-child a')
            .toArray().map(v => $(v).attr('href')),
          location: $('#mainbar-full > div:first-child ul.list-reset:last-child li:last-child div[title]')
            .attr('title') || null,
          stats: $('#stats .flex--item').toArray()
            .map(v => $(v).text_sane()).filter(v => v),
          about: $('#main-content .s-prose p').toArray()
            .map(v => $(v).text_sane()) || null, //.join('\r'),
          collectives,
          communities,
          badges,
          top_tags: $('#top-tags .p12').toArray().map(v=>({
              name: $(v).find('.s-tag').text_sane() || null,
              score: $(v).find('.d-flex > .d-flex:nth-child(1)')
                .text_sane().replace(' Score', '')
                .replace(/,/gm, '') || null,
              posts: $(v).find('.d-flex > .d-flex:nth-child(2)')
                .text_sane().replace(' Posts', '')
                .replace(/,/gm, '') || null,
              posts_percent: $(v).find('.d-flex > .d-flex:nth-child(3)')
                .text_sane().replace(' Posts %', '').replace(/,/gm, ''),
          })),
          top_posts: $('#js-top-posts .p12 .d-flex').toArray().map(v=>({
              type: $(v).find('.iconQuestion').length ? 'question'
                : ($(v).find('.iconAnswer').length ? 'answer' : 'none'),
              score: $(v).find('.s-badge').text_sane()
                .replace(/,/gm, '') || null,
              text: $(v).find('a.d-table')
                .text_sane() || null,
              date: new Date($(v).find('.relativetime')
                .attr('title')),
          })),
          top_meta_posts: $('#js-top-posts + div .p12 .d-flex')
            .toArray().map(v=>({
              score: $(v).find('.s-badge').text_sane()
                .replace(/,/gm, '') || null,
              text: $(v).find('a.d-table').text_sane() || null,
          })),
          top_network_posts: $('#js-top-posts + div + div .p12 .d-flex')
            .toArray().map(v=>({
              score: $(v).find('.s-badge').text_sane()
                .replace(/,/gm, '') || null,
              text: $(v).find('a.d-table').text_sane() || null,
          }))
        };
      },
      'topactivity': ($) => {
          let summary_graph_data;
          try {
              summary_graph_data = JSON.parse(
                /graphDatas[^[]+([[^]]+])/gm.exec(
                  $('*').first().html())?.[1]);
          } catch(e) {
              console.log('graphData not found')
          }
          let [summary_people_reached, summary_posts_edited,
            summary_helpful_flags, summary_votes_cast] =
            $('div:not(.js-highlight-box-reputation) > h1.flex--item + div .flex--item .fs-body3')
              .toArray().map(v=>$(v).text_sane().replace(/,/gm, '') || null);
          return {
              summary_reputation: +$('#top-cards h4.fs-headline1')
                .text().replace(/D+/gm, ''),
              summary_top_overall: $('a[href*="alltime"]')
                .first().text_sane() || null,
              summary_next_tag_badge: $('#rep-card-next-tag-badge a')
                .text_sane() || null,
              summary_graph_data,
              summary_next_tag_score:
                $('div.fl-shrink1 + div.fl-grow1 .fs-fine')
                  .first().text_sane().replace(/,/gm, '') || null,
              summary_next_tag_answers:
                $('div.fl-shrink1 + div.fl-grow1 .fs-fine')
                  .last().text_sane().replace(/,/gm, '') || null,
              summary_badges: $('h3 +div .s-badge').toArray()
                .map(v => $(v).attr('title')).join(', '),
              summary_last_badge: $('#badge-card-last').text_sane() || null,
              summary_next_badge: {
                  name: $('#js-badge-card-next').text_sane() || null,
                  progress: $('h4.flex--item.ws-nowrap + span')
                    .text_sane() || null
              },
              summary_people_reached,
              summary_posts_edited,
              summary_helpful_flags,
              summary_votes_cast,
          };
      },
      'answers': ($) => {
          return {
              answers: $('#js-post-summaries .s-post-summary')
                .toArray().map(p=>{
                  let $p = $(p);
                  return {
                      id: $p.attr('data-post-id') || null,
                      votes: $p.find('.s-post-summary--stats-item-number')
                        .text().replace(/,/gm, '') || null,
                      accepted: !!$p.find('svg.iconCheckmarkSm').length,
                      url: new URL($p.find('.answer-hyperlink')
                        .attr('href'), location.href),
                      text: $p.find('.answer-hyperlink').text_sane() || null,
                      tags: $p.find('.post-tag').toArray()
                        .map(v => $(v).text_sane() || null ).map(name=>({name}))
                  };
              }),
          }
      },
      'questions': ($) => {
          return {
              questions: $('#js-post-summaries .s-post-summary')
                .toArray().map(p=>{
                  let $p = $(p);
                  return {
                      id: $p.attr('data-post-id') || null,
                      votes: $p.find('.s-post-summary--stats-item-number')
                        .text().replace(/,/gm, '') || null,
                      accepted: !!$p.find('svg.iconCheckmarkSm').length,
                      answer_count:
                        $p.find('.s-post-summary--stats-item:nth-child(2) .s-post-summary--stats-item-number')
                        .text_sane().replace(/,/gm, '') || null,
                      url: new URL($p.find('.s-link').attr('href'),
                        location.href),
                      text: $p.find('.s-link').text_sane() || null,
                      tags: $p.find('.post-tag').toArray()
                        .map(v => $(v).text_sane() || null)
                  };
              }),
          };
      },
      'tags': ($) => {
          return {
              tags: $('#user-tab-tags .ba .p12').toArray()
                .map(v=>$(v)).map(v=>({
                  name: v.find('.post-tag').text_sane() || null,
                  badge: v.find('.badge-tag').attr('title') || null,
                  description: v.attr('title') || null,
                  score: v.find('.flex--item:first-child > .fs-body3')
                    .text_sane().replace(/,/gm, '') || null,
                  posts: v.find('.flex--item:last-child > .fs-body3')
                    .text_sane().replace(/,/gm, '') || null,
              })),
          };
      },
      'articles': ($) => {
          return {
              articles_count: $('h2.fs-title').text()
                .replace(/D+/gm, '') || null
          };
      },
      'badges': ($) => {
          return {
              badges: $('#user-tab-badges .grid--item').toArray()
                .map(v => ({
                  name: $(v).find('.mbn4').text_sane() || null,
                  count: $(v).find('.ml4').text_sane()
                    .replace(/D+/gm, '') || 0
                })),
          };
      },
      'bookmarks': ($) => {
          return {
              bookmarks: $('#js-post-summaries .s-post-summary')
                .toArray().map(p=>{
                  let $p = $(p);
                  return {
                      id: $p.attr('data-post-id'),
                      votes:
                        $p.find('.s-post-summary--stats-item__emphasized .s-post-summary--stats-item-number')
                          .text_sane().replace(/,/gm, '') || null,
                      views: $p.find('.is-supernova .s-post-summary--stats-item-number')
                        .text_sane().replace(/,/gm, '') || null,
                      accepted: !!$p.find('svg.iconCheckmarkSm').length,
                      answer_count: $p.find('.s-post-summary--stats-item:nth-child(2) .s-post-summary--stats-item-number')
                        .text_sane().replace(/,/gm, '') || null,
                      url: new URL($p.find('.s-link').attr('href'),
                        location.href).href,
                      text: $p.find('.s-link').text_sane() || null,
                      tags: $p.find('.post-tag').toArray()
                        .map(v => $(v).text_sane() || null)
                  };
              })
          };
      },
      'bounties': ($) => {
          return {
              bounties_count: $('h2.fs-title').text()
                .replace(/D+/gm, '') || null
          };
      },
    }
  }
  ```
</CodeGroup>

## Multiple `tag_response`

<CodeGroup>
  ```js Interaction code theme={null}
  close_popup('._1piuevz', '._1piuevz');
  tag_response('stay', /\/StaysPdpSections/);
  tag_response('calendar', /\/PdpAvailabilityCalendar/);
  tag_response('reviews', /api\/v3\/StaysPdpReviews/);
  navigate(input.url+'?enable_auto_translate=false#availability-calendar');
  if (el_exists('img[src*="error_pages/404"]'))
    return dead_page('Page not found');
  const room_id = /\/(\d+)(?:\?|$)/.exec(input.url)?.[1];
  if (el_exists('._wgmchy ._1qx9l5ba'))
    click('._wgmchy ._1qx9l5ba');
  wait('#data-state, #data-deferred-state',{timeout: 6e4});
  wait_for_parser_value('stay');
  wait_for_parser_value('calendar');
  wait_for_parser_value('reviews');
  tag_html('html');
  ```

  ```js Parser code theme={null}
  let room_id = /([0-9]+)(?:\?|$)/.exec(input.url)?.[1];
  const $ = load_html(parser.html);
  let price = +$('[data-section-id="BOOK_IT_SIDEBAR"] ._14y1gc ._tyxjp1')
    .first().text().replace(/[^[0-9].,]+/gm,'')
  let currency = $('._tyxjp1').last().text().replace(/[0-9,]/g, '').trim()
  let data = JSON.parse($('#data-state, #data-deferred-state').html())
  price = price ? new Money(price, currency) : null
  let avatar = $('._9ofhsl').attr('src')
  let name = $('.tehcqxo h2.hnwb2pb').text().split('by')?.[1]?.trim()
    || $('._cv5qq4 ._14i3z6h').text().split('by')?.[1]?.trim()
  let { stay, calendar, reviews} = parser;
  let cd = data.niobeMinimalClientData.find(f=>f.find(f2=>
    f2?.data?.presentation?.stayProductDetailPage))?.find(f2=>
    f2?.data?.presentation?.stayProductDetailPage)
    .data?.presentation?.stayProductDetailPage?.sections;
  let sections = stay.data.presentation.stayProductDetailPage.sections
    .sections || [];
  sections = sections.concat(cd?.sections);
  function get_section(name) {
    return sections.find(v=>v.sectionId == name).section;
  }

  let metadata = stay.data.presentation.stayProductDetailPage.sections
    .metadata || cd?.metadata;
  let category_rating = [];
  sections.find(v=>v?.sectionId == "REVIEWS_DEFAULT")?.section
    ?.ratings?.forEach(r=>{
      category_rating.push({
      name: r.label,
      value: r.localizedRating,
    });
  });
  let sec_sheet = get_section("BOOK_IT_CALENDAR_SHEET");
  let sec_book_it = get_section("BOOK_IT_SIDEBAR");
  price = sec_book_it.structuredDisplayPrice.price
    ?.replace(/[^[0-9].]/,'') || price;
  currency = data.userAttributes?.curr || currency;
  let available_dates = [];
  calendar.data.merlin.pdpAvailabilityCalendar.calendarMonths.forEach(m=>{
    m.days.forEach(d=>{
      if (d.available) available_dates.push(d.calendarDate);
    });
  });
  let image = metadata.sharingConfig.imageUrl ||
    sections.find(v=>v.sectionId == "PHOTO_TOUR_SCROLLABLE_MODAL")
      .section.mediaItems[0].baseUrl;
  if (image) image = new Image(image);
  avatar = sections.find(v=>v?.sectionId == "HOST_PROFILE_DEFAULT")
    ?.section?.hostAvatar?.avatarImage?.baseUrl || avatar;
  if (avatar) avatar = new Image(avatar);
  return {
    name: metadata.sharingConfig.title,
    price,
    image,
    description: sections.find(v=>v?.sectionId == "DESCRIPTION_MODAL")
      ?.section?.items?.map(v=>((v?.title||'')+' '+v?.html?.htmlText).trim()
    )?.join(', '),
    category: metadata.seoFeatures.breadcrumbDetails[1].linkText,
    availability: sec_sheet.available.toString(),
    reviews: reviews.data.presentation.stayProductDetailPage.reviews
      .reviews.map(r=>r.localizedReview?.comments || r.comments),
    ratings: metadata.sharingConfig.starRating,
    seller_info: {
        name: sections.find(v=>v?.sectionId == "HOST_PROFILE_DEFAULT")
          ?.section?.title || name,
      url: new URL(`https://www.airbnb.ru/contact_host/${room_id}/send_message`),
        avatar,
        features: sections.find(v=>v?.sectionId == "HOST_PROFILE_DEFAULT")
          ?.section?.hostFeatures?.map(f=>({
            name: f.title,
            value: f.subtitle
          }))
      },
    breadcrumbs: sections.find(v=>v?.sectionId == "LOCATION_DEFAULT")
      ?.section?.previewLocationDetails?.[0]?.title,
    location: sections.find(v=>v?.sectionId == "LOCATION_DEFAULT")
      ?.section?.previewLocationDetails?.[0]?.title,
    lat: metadata.loggingContext.eventDataLogging.listingLat ||
      sections.find(v=>v?.sectionId == "LOCATION_DEFAULT")?.section?.lat,
    long: metadata.loggingContext.eventDataLogging.listingLng ||
      sections.find(v=>v?.sectionId == "LOCATION_DEFAULT")?.section?.long,
    guests: sec_book_it.maxGuestCapacity || sections
      .find(v=>v?.sectionId == "AVAILABILITY_CALENDAR_DEFAULT")
        ?.section?.maxGuestCapacity,
    pets_allowed: sec_book_it.petsAllowed,
    description_items: sections.find(v=>
        v?.sectionId == "AVAILABILITY_CALENDAR_DEFAULT")?.section
          ?.descriptionItems.map(v=>v.title),
    category_rating,
    house_rules: sections.find(v=>v?.sectionId == "POLICIES_DEFAULT")
      ?.section?.houseRules?.map(r=>r?.title),
    details: sections.find(v=>v?.sectionId == "OVERVIEW_DEFAULT")
      ?.section?.detailItems?.map(f=>f?.title),
    highlights: sections.find(v=>v?.sectionId == "HIGHLIGHTS_DEFAULT")
      ?.section?.highlights?.map(f=>({
        name: f.title,
        value: f.subtitle
      })),
    arrangement_details: sections.find(v=>
        v?.sectionId == "SLEEPING_ARRANGEMENT_DEFAULT")?.section
          ?.arrangementDetails?.map(f=>({
            name: f.title,
            value: f.subtitle
          })),
    amenities:  sections.find(v=>v?.sectionId == "AMENITIES_DEFAULT")
      ?.section?.seeAllAmenitiesGroups?.map(g=>({
        group_name: g.title,
        items: g.amenities.filter(f=>f.available).map(f=>({
          name: f.title,
          value: f.subtitle
        }))
    })),
    images: sections.find(v=>v?.sectionId == "HERO_DEFAULT")
      ?.section?.previewImages?.map(v=>new Image(v?.baseUrl)),
    available_dates,
    url: new URL(input.url),
    final_url: new URL(location.href),
  };
  ```
</CodeGroup>


# Develop a scraper with the IDE
Source: https://docs.brightdata.com/datasets/scraper-studio/develop-a-scraper

Build a custom web scraper in the Bright Data Scraper Studio IDE: write interaction and parser code, preview results, debug runs, and ship to production.

This guide walks through building a custom web scraper in the Bright Data Scraper Studio IDE from scratch. You will write interaction code that navigates the target site, parser code that extracts structured fields, and then save the scraper to production and configure delivery. By the end, you will have a runnable scraper you can trigger by API, manually, or on a schedule.

## Prerequisites

* An active [Bright Data account](https://brightdata.com/?hs_signup=1\&utm_source=docs) with access to Scraper Studio
* Basic JavaScript familiarity (variables, functions, control flow)
* A target URL you want to scrape

<Tip>
  If you prefer describing the scraper in plain language instead of writing code, use the [Scraper Studio AI Agent](/datasets/scraper-studio/ai-agent). The agent generates the same kind of scraper the IDE would produce.
</Tip>

## How do I build a scraper in the IDE?

<Steps>
  <Step title="Open the Scraper Studio IDE">
    Go to [brightdata.com/cp/scrapers](https://brightdata.com/cp/scrapers), click **Scraper Studio**, then click **Develop a web scraper (IDE)** to open an empty scraper.
  </Step>

  <Step title="Start from scratch or pick a template">
    You can start from a blank scraper or use a template.

    Templates are pre-built scraper starters for common patterns and sites. Use a template when your target site or scraping pattern is similar to one of the available options.

    Use a blank scraper when you want full control over the scraping flow from the beginning.
  </Step>

  <Step title="Write interaction code">
    Interaction code navigates the target site and captures the data you need into the parser. Select **Interaction code** from the left sidebar and write the code in the main editor.

    A minimal interaction script:

    ```js theme={null}
    navigate(input.url);
    wait('.product-title');

    let data = parse();
    collect(data);
    ```

    In this example:

    * `navigate(input.url)` opens the page provided in the input.
    * `wait('.product-title')` waits for the expected element.
    * `parse()` runs the parser code.
    * `collect(data)` adds the parsed record to the output dataset.

    For a multi-page scrape, fan out with `next_stage()`:

    ```js theme={null}
    navigate(input.url);
    wait('.listing');
    let listings = parse().listings;
    for (let url of listings)
      next_stage({url});
    ```

    See [Scraper Studio functions](/datasets/scraper-studio/functions) for the full list of interaction commands.
  </Step>

  <Step title="Write parser code">
    Parser code reads the HTML or response loaded by interaction code and returns a structured JavaScript object.

    Select **Parser code** from the left sidebar and define the fields you want to extract.

    Parser code commonly uses Cheerio’s jQuery-like `$` selector:

    ```js theme={null}
    return {
      title: $('h1').text_sane(),
      price: new Money(+$('.price').text().replace(/\D+/g, ''), 'USD'),
      image: new Image($('img.product').attr('src')),
      listings: $('.listing a').toArray().map(el => $(el).attr('href')),
    };
    ```

    The object returned by parser code is available wherever interaction code calls `parse()`. See [Scraper Studio functions](/datasets/scraper-studio/functions#parser-functions) for the parser helpers Bright Data Scraper Studio provides.
  </Step>

  <Step title="Choose a worker type">
    In the **Settings** panel, pick the worker type:

    * **Code worker** (faster): for static HTML pages and public JSON endpoints
    * **Browser worker**: for JavaScript-rendered pages, clicks, scrolling, popups, or captured background traffic

    Start with **Code worker** when possible. Switch to **Browser worker** if the data you need is not available in the raw response or if you need [browser-only](/datasets/scraper-studio/functions#browser-only-functions) functions.

    See [**Worker types**](/datasets/scraper-studio/worker-types) for the full comparison.
  </Step>

  <Step title="Run a preview">
    Use **Preview** to test the scraper before making it active for production use.

    Preview runs the scraper code against the input selected in the **Input** tab at the bottom-left of the IDE. Use it to test interaction logic, parser logic, output structure, and errors before running the scraper on a larger input set.

    The results appear in the **Output** tab. Use the **Run log** and **Browser network** tabs to debug failed runs.

    > **Expected result:** the Output tab shows a structured record with the fields defined in your parser code.
  </Step>

  <Step title="Save to production">
    When the preview returns the expected output, click **Finish editing** in the top-right corner For an existing production scraper, click **Save to production** to apply your changes.

    The scraper appears under **My Scrapers** in the control panel and can be triggered by API, manually, or on a schedule.
  </Step>

  <Step title="Configure delivery">
    Open the scraper from **My Scrapers** and configure **Delivery preferences**. Choose a delivery destination, such as API download, webhook, Amazon S3, GCS, Azure, SFTP, or email and a file format (JSON, NDJSON, CSV, XLSX). See [Initiate collection and delivery](/datasets/scraper-studio/initiate-collection-and-delivery-options) for all available options.
  </Step>

  <Step title="Initiate the scraper">
    After the scraper is active and delivery is configured, start a production run. Choose the initiation method that matches your workflow:

    * [Initiate by API](/datasets/scraper-studio/initiate-collection-and-delivery-options#how-do-i-trigger-a-scraper-run) - start a run from your application or automation workflow.
    * [Initiate manually](/datasets/scraper-studio/initiate-collection-and-delivery-options#how-do-i-trigger-a-scraper-run) - start a run from the control panel by entering inputs or uploading a file.
    * [Schedule a scraper](/datasets/scraper-studio/initiate-collection-and-delivery-options#how-do-i-trigger-a-scraper-run) - run the scraper automatically on a recurring schedule.
  </Step>
</Steps>

## Frequently asked questions

<AccordionGroup>
  <Accordion title="How do I debug a scraper that fails on a specific input?">
    Open the scraper in the Bright Data Scraper Studio IDE and check the **Last errors** tab. Every failed input is stored with its exact error message and error code (up to the most recent 1,000 failures). Re-run the failing input from the IDE to reproduce the problem locally, fix the interaction or parser code, and save a new production version.
  </Accordion>

  <Accordion title="Can I edit a scraper that was generated by the AI Agent?">
    Yes. Every scraper in Bright Data Scraper Studio, regardless of how it was created, can be opened and edited in the IDE. You can change extraction logic, tweak selectors, add or remove output fields, and change the worker type.
  </Accordion>

  <Accordion title="How do I add fields to the output schema?">
    Click **Edit Schema** in the IDE's output schema panel and add the new fields, or return them from parser code and Bright Data Scraper Studio prompts you to update the schema when you save to production.
  </Accordion>

  <Accordion title="What's the difference between collect() and set_lines()?">
    Use `collect()` to append one record at a time; it is the default way to emit data. Use `set_lines()` when you are collecting records progressively and want the most recent snapshot delivered even if a later step throws an error. Every call to `set_lines()` overrides the previous one. See [collect](/datasets/scraper-studio/functions#collect-append-a-record-to-the-dataset) and [set\_lines](/datasets/scraper-studio/functions#set-lines-set-output-lines-overriding-previous-calls).
  </Accordion>
</AccordionGroup>

## Related

<CardGroup>
  <Card title="Scraper Studio functions" icon="code" href="/datasets/scraper-studio/functions">
    Full reference for interaction and parser commands
  </Card>

  <Card title="Best practices" icon="list-check" href="/datasets/scraper-studio/best-practices">
    Recommended patterns for fast, reliable scrapers
  </Card>

  <Card title="Scraper Studio IDE interface" icon="display-code" href="/datasets/scraper-studio/scraper-studio-ide-interface">
    Reference for every panel and control in the IDE
  </Card>

  <Card title="Self-Healing tool" icon="wand-magic-sparkles" href="/datasets/scraper-studio/self-healing-tool">
    Fix broken scrapers and add fields with plain-language prompts
  </Card>
</CardGroup>


# Scraper Studio error codes
Source: https://docs.brightdata.com/datasets/scraper-studio/error-codes

Look up Bright Data Scraper Studio error codes, status codes and warnings, with the meaning and suggested fix for each collection failure.

This reference lists the error codes Bright Data Scraper Studio returns when a crawl, parser, request, validation or delivery step fails during a collection run, and the suggested action for each one.

Read the `error_code`, `status_code` and raw `error` message together to understand what failed and what to do next.

<Note>
  These are Scraper Studio collection errors, not API authentication or API request errors. For proxy-layer HTTP errors returned outside Scraper Studio, see the [Error catalog](/proxy-networks/errorCatalog).
</Note>

## How do I read a Scraper Studio error?

Scraper Studio uses five system fields to describe the status of each record.

| Field          | Type                        | What it tells you                                                                                                                                                              |
| -------------- | --------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| `error_code`   | Machine-readable identifier | Why the crawl failed, for example `dead_page`, `bad_input`, `blocked`, `crawl_error`, `parse_error` or `load_sitemap`. Use this field for filtering, automation or retry logic |
| `error`        | Human-readable message      | The detailed failure reason, for example `Crawler error: Cannot find product title`                                                                                            |
| `status_code`  | HTTP-like number            | A summary of the crawl result. Optional, see the status code table below                                                                                                       |
| `warning`      | Human-readable message      | A non-fatal issue on a record that was still delivered                                                                                                                         |
| `warning_code` | Machine-readable identifier | The machine-readable version of `warning`, for example `dead_page` or `validation`                                                                                             |

Branch on `error_code` rather than on the raw `error` string, because the message text changes as scrapers are updated:

```js theme={null}
if (line.error_code === 'dead_page') {
  // Handle expired or removed URL
}
```

### What do the Scraper Studio status codes mean?

`status_code` summarizes the crawl result as an HTTP-like numeric value.

| Status code | Meaning                                                                                |
| ----------- | -------------------------------------------------------------------------------------- |
| 400         | Bad request or invalid page response                                                   |
| 403         | Access blocked or denied by the target site                                            |
| 404         | Page not found, removed or invalid URL                                                 |
| 407         | Account is suspended or access is restricted                                           |
| 408         | Request timed out. The target site did not respond in time                             |
| 421         | Request was routed to the wrong server                                                 |
| 429         | Too many requests. Rate limit reached                                                  |
| 500         | Crawl, proxy or navigation failed before Scraper Studio received a valid page response |
| 503         | Target site or service is temporarily unavailable, overloaded or timed out             |

<Warning>
  `status_code` is sometimes missing or `undefined`, because some error paths do not assign a numeric status code. Treat `status_code` as optional and do not assume it is always present.
</Warning>

## How do errors and warnings differ?

An error means the record failed. A warning means the record was delivered but something should be reviewed.

* **Error:** the record failed and should be treated as unsuccessful. A failed record usually includes `error`, `error_code` and `status_code`
* **Warning:** the record was delivered, but something should be reviewed. A delivered record with a non-fatal issue usually includes `warning`, `warning_code` and `status_code`
* **Successful record:** none of `error`, `error_code`, `warning` or `warning_code` is populated

Warnings occur when a partial crawl returned data but also hit an issue, when a normally failing condition was configured as a non-error, or when output validation found an issue but the record was still kept.

When a `dead_page` error is downgraded to a warning, the output includes:

```text theme={null}
warning_code = dead_page
warning = Dead page detected
```

Schema validation warnings usually use:

```text theme={null}
warning_code = validation
```

The same underlying issue can appear either as an error or as a warning, depending on the scraper logic, validation rules and output schema settings.

## Where do Scraper Studio errors come from?

Scraper Studio errors come from one of three layers.

### What causes scraper errors?

Scraper errors come from the scraper's interaction code, parser code or input handling. Examples include invalid input, `wait_element_timeout`, `parse_error`, `click_timeout`, `dead_page`, `bad_input` and `blocked`.

Fix these by updating the scraper logic, parser selectors, validation rules or input data.

### What causes proxy and unblocker errors?

Proxy and unblocker errors come from Bright Data's proxy, routing or unblocking layer. Examples include proxy connection issues, target website blocking, geo or zone configuration issues, no available peers and rate limiting.

Fix these by retrying, reducing the request rate, changing country or geo settings, or contacting Bright Data support if the issue persists.

### What causes platform and infrastructure errors?

Platform and infrastructure errors come from the Scraper Studio platform, browser worker, parser sandbox, storage layer or internal infrastructure. Examples include worker timeout, browser disconnected, parser memory limit exceeded, upload failure and WebSocket connection issues.

These are often transient and are frequently resolved by retrying. If the issue persists, open a support ticket with the scraper ID, job ID, failed input and raw error message.

## Common scraper error codes

These error codes indicate scraper execution issues. The request may have failed because of invalid input, a missing or changed page element, target blocking, parsing problems, rate limits, CAPTCHA handling or scraper logic that needs to be updated.

| Error code                     | Meaning                                                                                                                                                                                             | Suggested action                                                                                                                                                                                                  |
| ------------------------------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `dead_page`                    | The scraper detected that the page does not exist or is no longer relevant.                                                                                                                         | Check whether the page still opens manually. Remove expired URLs or fix discovery logic that produces stale links.                                                                                                |
| `bad_input`                    | The scraper marked the input as invalid and skipped retries. This happens when required input fields are missing, the URL is invalid or the page is not the expected type.                          | Validate inputs before triggering the scraper. Remove invalid URLs or update discovery logic to avoid unsupported page types.                                                                                     |
| `blocked`                      | The `blocked()` function was used in the scraper code, or the target website refused access to the page.                                                                                            | Retry later, reduce the request rate, or review country, session, CAPTCHA and block-handling logic.                                                                                                               |
| `crawl_error`                  | A general crawl execution error occurred. This happens when the page did not load correctly, required page data was missing, the browser session closed or scraper code tried to read missing data. | Open Debug crawl or Crawl inspector for the failed input. Check page loading, add null checks and rerun failed pages.                                                                                             |
| `wait_element_timeout`         | The scraper waited for an element that did not appear in time.                                                                                                                                      | Confirm the selector still exists and is stable. Increase the timeout or handle alternate page layouts if the page loads slowly.                                                                                  |
| `ajax_request_error`           | A background request failed or timed out during page execution.                                                                                                                                     | Review network requests in preview or debug mode. If the request is optional, relax validation or add fallback logic.                                                                                             |
| `collector_request_validation` | A custom request validation rule rejected an AJAX or network response, usually from `verify_requests()` logic.                                                                                      | Review the validation callback and confirm the rejected response is required. Relax the rule if the request is optional.                                                                                          |
| `captcha_timeout`              | CAPTCHA solving did not complete within the expected time.                                                                                                                                          | Retry the crawl and check whether the target repeatedly shows CAPTCHA. Review CAPTCHA handling and job deadline settings.                                                                                         |
| `close_popup_fail`             | Scraper Studio failed to close a popup, such as a consent manager or modal.                                                                                                                         | Check whether the popup selector changed or appears conditionally. Update popup handling or make the scraper tolerate the popup if it does not block extraction.                                                  |
| `click_timeout`                | A click action did not complete within the timeout. The element may be missing, hidden, disabled or not clickable.                                                                                  | Confirm the selector matches a visible, clickable element. Add `wait(selector)` before clicking or update the click logic.                                                                                        |
| `tag_response`                 | A tagged response callback failed, or the tagged response returned an unexpected status or format.                                                                                                  | Review the tagged response callback and confirm the expected response exists. Check the browser network tab in the IDE to verify that the response loads correctly, and add checks before reading fields from it. |
| `load_sitemap`                 | Scraper Studio failed to load or parse a sitemap. Causes include fetch failure, request timeout or invalid sitemap format.                                                                          | Open the sitemap URL manually and confirm it is reachable and valid.                                                                                                                                              |
| `load_more_timeout`            | The scraper waited for more items to load, but no new items appeared before the timeout.                                                                                                            | Confirm the "load more" selector and list container still exist. Add a stop condition when no more results are available.                                                                                         |
| `child_input_size_validation`  | A child input created by `next_stage()` exceeded the allowed input size.                                                                                                                            | Reduce the data passed to `next_stage()`. Pass only fields needed by the next stage, such as URL, ID or small metadata values.                                                                                    |
| `detect_block`                 | Scraper Studio detected block-page content, such as "Access Denied", sign-in walls or other known blocking patterns.                                                                                | Open the failed page manually and confirm whether it shows a block page. If many inputs fail, reduce the request rate or review location and session behavior.                                                    |
| `ERR_INVALID_URL`              | A URL value is invalid or not in a supported format.                                                                                                                                                | Validate input URLs before triggering the scraper. Make sure URLs include `http://` or `https://` and do not contain malformed characters.                                                                        |
| `not_supported_cmd`            | The scraper used a function that is not supported by the selected worker type.                                                                                                                      | Change the worker type or replace the function. Use a Browser worker for browser-only actions such as click, scroll, type and wait. See [Worker types](/datasets/scraper-studio/worker-types).                    |
| `detached_element`             | The scraper referenced an element that was removed or re-rendered before the action completed.                                                                                                      | Re-select the element immediately before interacting with it. Add waits after page updates and avoid storing element handles across DOM changes.                                                                  |
| `timeout`                      | The scraper timed out while waiting for an element, request, response or page action to complete.                                                                                                   | Confirm that the expected element or response exists. Increase the timeout only when needed and add fallback logic for optional or slow-loading content.                                                          |

### How do `block` and `blocked` differ?

`block` and `blocked` are different error codes. `blocked` is raised by scraper logic, while `block` is raised by the layer that fetched the page.

`blocked` is usually raised by scraper logic. The scraper calls `blocked()` when it detects a blocked page, login wall, CAPTCHA page or other condition that should mark the crawl as blocked:

```js theme={null}
blocked('Login page was shown');
```

`block` usually comes from navigation, request rejection, target-site blocking or proxy-level response handling. It may include the real HTTP status returned by the target site or upstream layer. Observed status codes for `block` are:

```text theme={null}
400, 401, 403, 404, 405, 409, 410, 418, 429, 500, 503
```

In short:

* `blocked` is collector-level block detection, usually raised by scraper logic
* `block` is target, proxy or navigation-level rejection, often with an HTTP status

## Navigation and browser error codes

These error codes indicate navigation or browser loading issues. The scraper may have failed because the page did not load in time, the browser could not reach the URL, the target kept network requests open, or the connection timed out or closed before completion.

| Error code                       | Meaning                                                                                                                                                                                             | Suggested action                                                                                                                                          |
| -------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `bad_navigate`                   | The browser failed to navigate to the requested URL.                                                                                                                                                | Open the URL manually and check whether it redirects or blocks access. Retry the crawl if the failure is temporary.                                       |
| `navigation_timeout`             | The page did not finish navigation within the allowed time.                                                                                                                                         | Increase the navigation timeout only if needed. Prefer `wait(selector)` or a different `wait_until` strategy instead of waiting for full page load.       |
| `domcontentloaded_event_timeout` | The browser timed out while waiting for the `DOMContentLoaded` event. The page did not reach the expected load state in time.                                                                       | If full page load is not required, use `navigate(input.url, { wait_until: 'navigate' })` and then `wait(selector)` for the element you need.              |
| `networkidle_event_timeout`      | The browser timed out while waiting for network activity to become idle. Some pages never reach network idle because they keep background requests open.                                            | Avoid relying on full network idle for pages with continuous background traffic. Use `wait_until: 'navigate'` and wait for a specific selector instead.   |
| `load_event_timeout`             | The page did not fire the full `load` event in time.                                                                                                                                                | Avoid waiting for full page load if it is not required. Use selector-based waits for the content needed by the parser.                                    |
| `document_load_failed`           | The browser started navigation, but the main document failed to load. Causes include an HTTP failure, SSL/TLS issue, empty response, missing credentials, redirect issue or proxy and peer problem. | Retry and verify the target URL opens in a browser. If the failure persists, try a different geo or open a support ticket with the job ID and full error. |
| `net_err_timed_out`              | The network request timed out.                                                                                                                                                                      | Retry and check target stability. Reduce concurrency if the timeout affects many inputs.                                                                  |
| `net_err_closed`                 | The target site closed the connection unexpectedly.                                                                                                                                                 | Check whether the site is available and retry. If it happens frequently, review blocking or rate behavior.                                                |
| `net_err_cert_date_invalid`      | The SSL/TLS certificate presented by the server is not valid for the current date.                                                                                                                  | Verify that the target URL opens correctly in a browser and that the site certificate is valid.                                                           |
| `net_err_http2_protocol_error`   | The browser encountered an HTTP/2 protocol error while loading the target page or resource.                                                                                                         | Retry the request. If it persists, confirm whether the target site loads normally in a browser.                                                           |
| `net_err_cert_authority_invalid` | The target site's SSL/TLS certificate is signed by an untrusted or unknown certificate authority.                                                                                                   | Verify that the target URL opens correctly in a browser and that the certificate is trusted.                                                              |

### Browser and infrastructure lifecycle errors

These error codes indicate that the browser session, runner or browser-control connection was interrupted during the crawl. They are usually transient platform or browser lifecycle errors.

Common lifecycle error codes are `runner_disconnected`, `network_error`, `cdp_conn_err`, `cdp_cmd_timeout`, `cdp_disconnect`, `bad_browser`, `browser_disconnected` and `ipc_timeout`.

**Suggested action:** retry the job. If the error persists, open a support ticket with the job ID, response IDs, failed input and raw error message.

### Rate limit variants

`global_rate_limit` and `bucket_rate_limit` mean that requests to the target domain are being rate limited. This usually happens when the target site is sensitive to high request volume or too many requests are sent in parallel.

**Suggested action:** retry after a short delay. If the issue repeats, reduce concurrency and queue jobs instead of running many jobs in parallel.

## Job lifecycle error codes

These error codes indicate that the collection did not complete because of runtime, deadline, cancellation or page-volume limits.

| Error code         | Meaning                                                                                                                     | Suggested action                                                                                                                                   |
| ------------------ | --------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------- |
| `job_run_timeout`  | The collection or crawl exceeded the allowed runtime. This happens during long waits, slow page actions or CAPTCHA solving. | Optimize scraper logic and check for loops, long waits or repeated CAPTCHA solving. Reduce work per request or increase the deadline if available. |
| `crawl_timeout`    | The crawler did not return a result within the internal timeout.                                                            | Retry the crawl. Simplify the crawl logic or reduce page complexity if it repeats.                                                                 |
| `deadline_timeout` | The job reached its configured deadline.                                                                                    | Increase the deadline or reduce work per request. For large workloads, split the job into smaller runs.                                            |
| `too_many_pages`   | The job created too many child pages.                                                                                       | Reduce the number of child pages generated per input. Use batch collection for high fan-out jobs.                                                  |
| `uncrawled_page`   | The page result was requested before the page was crawled, usually because the job deadline was reached.                    | Increase the deadline or reduce the number of pages created by the scraper.                                                                        |
| `aborted_page`     | The crawl was aborted because the job was canceled.                                                                         | No action is required if the job was intentionally canceled. Otherwise, rerun the affected inputs.                                                 |

## Infrastructure and storage error codes

These error codes indicate platform, worker, storage or delivery issues. The collection may have failed because an internal service was unavailable, a worker was overloaded, the result was too large or delivery to an external destination failed.

| Error code             | Meaning                                                               | Suggested action                                                                                                                               |
| ---------------------- | --------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------- |
| `infra_error`          | An internal infrastructure error occurred.                            | Retry the request. If the issue persists, contact support with the job or response ID.                                                         |
| `page_too_big`         | The loaded page exceeded the Scraper Studio page size limit of 16 MB. | Collect less data per page. Avoid storing large HTML blobs or unnecessary fields.                                                              |
| `crawl_request_failed` | The crawl runner could not connect to a crawler worker after retries. | Retry the job. Escalate to support if the issue persists.                                                                                      |
| `worker_too_busy`      | The crawler worker was overloaded.                                    | Retry later and reduce concurrency.                                                                                                            |
| `external_upload_fail` | Uploading a result or media file to an external destination failed.   | Verify delivery destination configuration, credentials, permissions and path settings.                                                         |
| `failed_media_upload`  | Scraper Studio failed to save a media file.                           | Retry the failed page and confirm the media URL is reachable. If the failure persists, check delivery and storage settings or contact support. |

## Proxy and unblocker error codes

These error codes indicate a routing or connection issue between Scraper Studio and the underlying proxy network. They usually happen when the proxy network cannot establish or maintain a stable connection to the target site.

| Error code       | Meaning                                                                                                                                                                            | Suggested action                                                                                                                             |
| ---------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------- |
| `proxy`          | A proxy-layer failure occurred during navigation or request. Possible causes include no peer availability, DNS failure, SSL issues, target rejection, timeout or protection pages. | Retry, switch country if needed and verify the target is accessible. If the failure persists, contact support with the job ID and raw error. |
| `proxy_error`    | The proxy layer could not connect to the target website or received an unexpected upstream response.                                                                               | Retry and verify the target URL. If the issue repeats, try another country or escalate with the job ID and error details.                    |
| `net_err_tunnel` | The browser could not establish a tunnel connection through the proxy.                                                                                                             | Check whether the website is available and retry. Escalate if the issue persists across many inputs.                                         |
| `no_peers`       | Scraper Studio failed to establish a connection with a peer.                                                                                                                       | Retry later or remove restrictive peer settings such as country, location or session constraints.                                            |

## Parser and payload error codes

These error codes indicate parser execution or payload-size issues. The scraper may have failed because parser code encountered invalid or missing data, the payload sent to the parser was too large, or parser execution exceeded memory or CPU limits.

| Error code                    | Meaning                                                                                                                                                                                                  | Suggested action                                                                                                                |
| ----------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------- |
| `parse_error`                 | Parser code failed while extracting or processing data. Common causes include syntax errors, blocked or invalid content, missing fields, invalid URLs, or reading properties from `null` or `undefined`. | Run a preview with the failing input and inspect the parser code. Add defensive checks and validate selectors.                  |
| `parse_request_payload_large` | The payload sent to the parser exceeded the size limit.                                                                                                                                                  | Reduce the amount of data sent to the parser. Extract only the required HTML section or response fields.                        |
| `parse_mem_limit_exceeded`    | Parser execution exceeded the memory limit, often because of very large HTML, JSON, arrays or embedded data.                                                                                             | Reduce the parser payload and avoid storing large objects in memory. Extract only the required fields.                          |
| `parse_cpu_limit_exceeded`    | Parser execution exceeded the CPU limit, often because of heavy loops, regex or transformations.                                                                                                         | Simplify parser logic and reduce loops over large datasets. Move unnecessary processing out of the parser.                      |
| `parse_req_error`             | The parser request payload exceeded the allowed field size.                                                                                                                                              | Reduce the size of the request or parsed payload. Avoid sending very large fields, files or HTML blocks into parser processing. |

## Access and permissions error codes

These error codes indicate an access or compliance issue. The request was stopped because the target is restricted by Bright Data's compliance safeguards or because account permissions need review.

| Error code | Meaning                                             | Suggested action                                                                                            |
| ---------- | --------------------------------------------------- | ----------------------------------------------------------------------------------------------------------- |
| `brul`     | The target is restricted by Bright Data compliance. | If access is required, contact `compliance@brightdata.com` and request permission for the blocked resource. |

## How to troubleshoot a failed Scraper Studio collection

Work through these steps in order when a collection run returns errors.

1. Check the `error_code`.
2. Check the `status_code`, if present.
3. Read the raw `error` message.
4. Open the failed URL manually to confirm whether the page exists and is accessible.
5. Use Debug crawl or Crawl inspector to inspect the failed input, crawl stage, children, files, warnings and output records.
6. If the error is parser-related, run a preview and inspect HTML, Output and Last errors.
7. If many inputs fail with the same error, check the request rate, concurrency, blocking, worker type and recent target-site changes.
8. If the issue persists, open a support ticket with the scraper ID, job or response ID, failed input and raw error message.

## FAQs

### Why is `status_code` missing from my failed record?

Some Scraper Studio error paths do not assign a numeric status code, so `status_code` is sometimes missing or `undefined`. Treat the field as optional and branch on `error_code` instead.

### Does a warning mean the record was lost?

No. A warning means the record was delivered but something should be reviewed, such as a partial crawl, a condition configured as a non-error or an output validation issue. Only records with `error` and `error_code` are unsuccessful.

### Which errors should I retry automatically?

Retry transient platform, browser lifecycle, proxy and rate limit errors, such as `infra_error`, `runner_disconnected`, `browser_disconnected`, `worker_too_busy`, `proxy_error`, `global_rate_limit` and `bucket_rate_limit`. Do not retry `bad_input`, `ERR_INVALID_URL` or `dead_page`, because those need an input or discovery-logic fix.


# Scraper Studio FAQs
Source: https://docs.brightdata.com/datasets/scraper-studio/faqs

FAQs about Bright Data Scraper Studio: 2 scraper types, inputs and outputs, billing, limits, snapshots and reporting issues for custom scraper builds.

This page answers the questions the Bright Data support team hears most often about Scraper Studio. If you need a walkthrough instead of a quick answer, start with [Understanding Scraper Studio](/datasets/scraper-studio/introduction).

## Frequently asked general questions

<AccordionGroup>
  <Accordion title="What is a Bright Data web scraper?">
    A Bright Data web scraper is an automated script that collects public web data at scale through Bright Data's proxy and unblocking infrastructure. It returns the collected data in a structured format (JSON, NDJSON, CSV, XLSX) and can deliver it to an API endpoint, webhook, cloud storage, or SFTP. Bright Data maintains hundreds of pre-built scrapers for popular sites in the [Scrapers Library](https://brightdata.com/products/web-scraper).
  </Accordion>

  <Accordion title="What is Bright Data Scraper Studio?">
    Bright Data Scraper Studio is a cloud-hosted environment for building custom scrapers. It offers two modes: an AI Agent that generates a scraper from a natural-language description, and an IDE where you write JavaScript directly. Both modes run on the same Bright Data proxy and unblocking infrastructure. See [Understanding Scraper Studio](/datasets/scraper-studio/introduction).
  </Accordion>

  <Accordion title="What is the difference between Scraper Studio and the Scrapers Library?">
    The [Scrapers Library](https://brightdata.com/products/web-scraper) contains pre-built scrapers Bright Data maintains for popular sites such as Amazon, LinkedIn, and Instagram. Bright Data Scraper Studio is the environment you use to build custom scrapers when the site you need is not in the library.
  </Accordion>

  <Accordion title="Can one scraper collect data from multiple websites?">
    Yes. A single scraper can navigate to any URL you pass in as input. If you need different extraction logic per site, use multiple stages (`next_stage()`) or build one scraper per site.
  </Accordion>

  <Accordion title="Can Scraper Studio discover URLs, or only scrape URLs I provide?">
    You do not have to provide every URL. The Bright Data Scraper Studio AI Agent builds four scraper types, three of which find items for you:

    * **PDP**: give a list of product URLs you already have; get one row per URL.
    * **Discovery**: give a category or listing URL; get one row per item on that listing.
    * **Discovery + PDP**: give a category or listing URL; get full per-product detail for every item.
    * **Search**: give a keyword and optional country when you have no URLs at all.

    Each scraper is scoped to one data shape, so the AI Agent is not a general crawler; do not pass a homepage and ask for "everything." For deeper link discovery across a site, build a multi-stage scraper in the Bright Data Scraper Studio IDE with `next_stage()`, `rerun_stage()` and `load_sitemap()`. See [What can the AI Agent build?](/datasets/scraper-studio/ai-agent#what-can-the-ai-agent-build) and [Functions](/datasets/scraper-studio/functions).
  </Accordion>

  <Accordion title="Can Scraper Studio scrape mobile apps?">
    Bright Data Scraper Studio scrapes the web, not native mobile apps. For mobile layouts, the Browser worker can emulate a mobile device with `emulate_device('iPhone X')` so the target site serves its mobile web pages. Native iOS or Android app data is out of scope. See [Functions](/datasets/scraper-studio/functions).
  </Accordion>
</AccordionGroup>

## Inputs, outputs, and schemas

<AccordionGroup>
  <Accordion title="What is a scraper input?">
    An input is the parameter set Bright Data Scraper Studio passes into the scraper for a single run. Typical inputs are a URL, a search keyword, a product ID or ASIN, a profile handle, or a date range. Multiple inputs can be passed in one job via CSV upload or the API.
  </Accordion>

  <Accordion title="What is a scraper output?">
    The output is the structured data the scraper returns for an input. Bright Data Scraper Studio delivers output in JSON, NDJSON, CSV, XLSX, or Parquet based on the scraper's delivery preferences.
  </Accordion>

  <Accordion title="Why did I receive more records than inputs?">
    One input can generate multiple records. For example, if you submit 5 product listing URLs and each listing page contains 20 products, the scraper returns 100 records from 5 inputs. The statistics page counts records, not inputs.
  </Accordion>

  <Accordion title="What is a search scraper?">
    A search scraper takes a keyword as input instead of a URL. Bright Data Scraper Studio runs a search on the target site and extracts data from the result pages. Use a search scraper when you do not have specific URLs to scrape.
  </Accordion>

  <Accordion title="What is a discovery scraper?">
    A discovery scraper collects data from listing pages such as search results, category pages, or directories. It extracts fields that appear directly on the listing (titles, prices, ratings) and can also collect product URLs or IDs for a follow-up product-page scrape.
  </Accordion>

  <Accordion title="What do I do if I updated the schema of a managed scraper while Bright Data is still working on it?">
    When the input or output schema changes, the scraper must be updated to match. If you trigger the scraper before Bright Data has updated it, you will see an `input(output)_schema_incompatible` error.

    To trigger the scraper anyway and ignore the schema mismatch, click **Trigger anyway** in the UI or add a parameter to your API request:

    * Output schema incompatible: `override_incompatible_schema=1`
    * Input schema incompatible: `override_incompatible_input_schema=1`

    ```bash theme={null}
    curl "https://api.brightdata.com/dca/trigger?scraper=ID_COLLECTOR&queue_next=1&override_incompatible_schema=1" \
      -H "Content-Type: application/json" \
      -H "Authorization: Bearer API_KEY" \
      -d '[{"url":"https://targetwebsite.com/product_id/"}]'
    ```
  </Accordion>
</AccordionGroup>

## Building and editing scrapers

<AccordionGroup>
  <Accordion title="How do I start building a scraper?">
    You have three options in Bright Data Scraper Studio:

    * **Build with the AI Agent**: describe the data you want in plain language. See [Scraper Studio AI Agent](/datasets/scraper-studio/ai-agent).
    * **Build in the IDE**: write JavaScript directly. See [Develop a scraper with the IDE](/datasets/scraper-studio/develop-a-scraper).
    * **Request a managed scraper**: Bright Data's data team builds and maintains the scraper for you.
  </Accordion>

  <Accordion title="Can I edit the code in the IDE after the AI Agent builds a scraper?">
    Yes. Every scraper, including ones the AI Agent generated, can be opened and edited in the Bright Data Scraper Studio IDE. You can change extraction logic, modify selectors, add or remove output fields, and tune performance. If you prefer not to write code, use the [Self-Healing tool](/datasets/scraper-studio/self-healing-tool) to request changes in plain language.
  </Accordion>

  <Accordion title="How does the AI Agent build a scraper?">
    Pass the AI Agent a target URL and an optional description of the data you want. The agent asks clarifying questions, generates an output schema for your review, and writes the full scraper code once you approve the schema. You can then run the scraper immediately or schedule recurring runs. See [Scraper Studio AI Agent](/datasets/scraper-studio/ai-agent) for a full walkthrough.
  </Accordion>

  <Accordion title="Do I own the scraper code, and can I export it?">
    Yes. You own every line of the scraper, including code the AI Agent generates, and you can read and edit it in the Bright Data Scraper Studio IDE. Scrapers are plain JavaScript, so you can copy the code out and keep it in your own repository. To run a scraper outside Bright Data you would need to supply your own proxy and unblocking infrastructure.
  </Accordion>

  <Accordion title="Does Scraper Studio work on JavaScript-heavy or dynamic pages?">
    Yes. Choose the Browser worker for sites that render content with JavaScript; it runs a full headless browser so you can wait for elements, click, scroll and capture background network calls. Choose the Code worker for static HTML and HTTP responses, which is faster and cheaper. See [Worker types](/datasets/scraper-studio/worker-types).
  </Accordion>
</AccordionGroup>

## Self-Healing

<AccordionGroup>
  <Accordion title="Is Self-Healing automatic, or do I trigger it?">
    You trigger Self-Healing; it does not fire automatically when a target site's DOM changes. You can trigger it three ways:

    * **Control panel**: open the scraper in the Bright Data Scraper Studio IDE, describe the fix in plain language and accept the AI-generated diff. See [Self-Healing tool](/datasets/scraper-studio/self-healing-tool).
    * **Bright Data CLI**: run `bdata scraper heal <collector_id>` then `bdata scraper approve`. Add `--auto-approve` for unattended workflows. See [Build a scraper with the Bright Data CLI](/datasets/scraper-studio/build-with-the-cli#how-do-i-fix-a-scraper-when-the-site-changes).
    * **Bright Data API**: call `POST /dca/collectors/{collector_id}/refactor_template`. See [Trigger Self-Healing](/api-reference/scraper-studio-api/ai-flow/trigger-self-healing).

    Each path repairs the code you own and keeps the same Collector ID. The refactor runs on Bright Data infrastructure, not on your machines, and can take up to 15 minutes; Bright Data emails you when the diff is ready.
  </Accordion>
</AccordionGroup>

## Running and triggering scrapers

<AccordionGroup>
  <Accordion title="What are the options for triggering a scraper run?">
    Bright Data Scraper Studio supports three trigger methods:

    * **By API**: regular request, queue request, or replace request
    * **Manually**: from the control panel
    * **On a schedule**: hourly, daily, weekly, or custom

    See [Initiate collection and delivery](/datasets/scraper-studio/initiate-collection-and-delivery-options).
  </Accordion>

  <Accordion title="What is a queued API request?">
    A queued request tells Bright Data Scraper Studio to wait until the previous request for the same scraper finishes before starting the next one. Use it when you want serial execution instead of running multiple jobs in parallel.
  </Accordion>

  <Accordion title="What is the parallel job limit?">
    Bright Data Scraper Studio runs up to **100 batch jobs in parallel** per scraper. Additional jobs queue automatically and start as capacity frees up. See [Scraper Studio specifications](/datasets/scraper-studio/specifications) for full limits.
  </Accordion>

  <Accordion title="How do I debug a real-time scraper?">
    In the Bright Data Scraper Studio dashboard, click the **Bug** icon under **Failed crawls** to open the scraper in the IDE. Failed inputs appear in the **Last errors** tab with the exact error message and error code. Bright Data stores the last 1,000 errors per virtual job so you can re-run failed inputs and diagnose the issue.
  </Accordion>
</AccordionGroup>

## Blocking and unblocking

<AccordionGroup>
  <Accordion title="How does Scraper Studio handle blocking and CAPTCHAs?">
    Bright Data Scraper Studio runs every scraper on Bright Data's proxy and unblocking network, with automatic retries and real-user fingerprinting built in. The IDE provides `solve_captcha()` to solve CAPTCHAs, `detect_block()` and `blocked()` to detect and report blocks, and `country()` to route a request through a specific country when a site is geo-restricted. See [Functions](/datasets/scraper-studio/functions).
  </Accordion>
</AccordionGroup>

## Billing and limits

<AccordionGroup>
  <Accordion title="What is a CPM in Scraper Studio billing?">
    CPM stands for "cost per mille", meaning 1,000 page loads. Bright Data Scraper Studio bills page loads in CPM units. Current rates are on the [pricing page](https://brightdata.com/pricing/web-scraper/custom).
  </Accordion>

  <Accordion title="Which operations count as a billable event?">
    A billable event is any function that causes Bright Data Scraper Studio to load a page or perform a network request:

    * `navigate()`
    * `request()`
    * `load_more()`
    * Media file download (billed per GB, separate from CPM)
  </Accordion>

  <Accordion title="Does Scraper Studio have its own free trial allotment?">
    Scraper Studio does not have a separate page-load or record allotment, but it is covered by the account-level free tier. Every new account gets 5,000 free credits per month, a single shared pool usable across the Web Unlocker API, SERP API, Web Scraper API and Scraper Studio. In the free tier, Scraper Studio consumes one credit per page load drawn from that pool; records are not billed by default. New accounts also get a one-time onboarding bonus credit usable on any Bright Data product. See the [free tier](/general/account/billing-and-pricing/free-tier) and [billing](/general/account/billing-and-pricing/billing) pages.
  </Accordion>
</AccordionGroup>

## Snapshots and data retention

<AccordionGroup>
  <Accordion title="How long are snapshots available after a collection?">
    Snapshot retention depends on the collection type:

    * **Batch collections**: 16 days
    * **Real-time collections**: 7 days

    After that, snapshots are permanently deleted. Bright Data does not recover expired data. Download or export your data before the retention window closes, or configure the scraper to deliver results automatically via webhook, API download, or cloud storage.
  </Accordion>
</AccordionGroup>

## How to report issues

<AccordionGroup>
  <Accordion title="How do I report an issue with a scraper?">
    Open the scraper in the Bright Data Scraper Studio control panel and select **Report an issue** from the three-dots menu. Bright Data routes the ticket to a different team based on the issue type:

    * **Data** (missing fields, missing records, parsing errors): routed to the scraper engineer. Available only for managed scrapers.
    * **Collection and delivery** (incomplete delivery, slow scraper): routed to the support team.
    * **Other** (UI issue, product question): routed to the account manager.

    Include the affected job ID, a description of the problem, and a screenshot or file if it helps show the issue.
  </Accordion>

  <Accordion title="What information should I include in a bug report?">
    Include:

    * The issue category (wrong data, missing records, delivery problem, IDE issue, other)
    * A description of the exact problem
    * The affected job ID
    * A screenshot or file that shows the issue, if possible

    Bright Data opens a ticket automatically and the R\&D team handles it.
  </Accordion>

  <Accordion title="How do I know Bright Data is working on a managed-scraper request?">
    You receive an email when a Bright Data engineer starts building the scraper and another email when it is ready. You can also track the status on the Scrapers dashboard.
  </Accordion>
</AccordionGroup>

## Related

<CardGroup>
  <Card title="Understanding Scraper Studio" icon="book-open" href="/datasets/scraper-studio/introduction">
    How Bright Data Scraper Studio works and when to use it
  </Card>

  <Card title="Specifications" icon="file-lines" href="/datasets/scraper-studio/specifications">
    Infrastructure limits, billing, and data retention
  </Card>
</CardGroup>


# Scraper Studio dashboard features
Source: https://docs.brightdata.com/datasets/scraper-studio/features

Reference for the Bright Data Scraper Studio dashboard: scraper types, statuses, run statistics columns and how to download collected data.

The Bright Data Scraper Studio dashboard is where every scraper lives. Use it to inspect scraper properties, trigger runs, configure delivery, manage versions and review collection statistics. This page is a reference for every control you see on the **My Scrapers** page and the statistics drill-down.

## The Scrapers dashboard

Every scraper you use, whether generated by the AI Agent, built in the Bright Data Scraper Studio IDE, or built by Bright Data teams, appears under **My Scrapers** on the Scrapers dashboard.

<Note>
  The **My Scrapers** page lists every scraper type, not only Scraper Studio scrapers.
</Note>

### Which scraper types appear on the dashboard?

The **My Scrapers** page lists three scraper types, distinguished by who builds and maintains each scraper.

| Type                       | Description                                                  |
| -------------------------- | ------------------------------------------------------------ |
| **Scraper API**            | 700+ pre-built scrapers, built and maintained by Bright Data |
| **Scraper Studio**         | Scrapers built and maintained by customers or AI             |
| **Scraper Studio Managed** | Scrapers built and maintained by the Bright Data team        |

### What does each scraper status mean?

Each scraper and run carries a status that shows where it is in the build and collection lifecycle.

| Status       | Description                                                                              |
| ------------ | ---------------------------------------------------------------------------------------- |
| **Ready**    | The run has been completed                                                               |
| **Canceled** | The run was canceled by the customer or system                                           |
| **Active**   | The scraper is saved to production and ready to initiate, but has not been triggered yet |
| **Draft**    | The scraper is still being built and is not yet saved to production                      |
| **Running**  | The collection is running                                                                |

To open a specific scraper's dashboard, click the scraper.

## What does the collection statistics page show?

The statistics page shows per-collection metrics for every run of a scraper.

<img alt="Statistics action menu" />

<img alt="Collector runs" />

| Column                  | Description                                                                                                          |
| ----------------------- | -------------------------------------------------------------------------------------------------------------------- |
| **ID**                  | Unique identifier for the collection job                                                                             |
| **Trigger**             | Who triggered the job and how (API, UI, or schedule)                                                                 |
| **Template**            | Template version number                                                                                              |
| **Inputs**              | Number of inputs submitted to the collection                                                                         |
| **Records**             | Number of records the scraper returned                                                                               |
| **Failed crawls**       | Number of pages that failed to crawl                                                                                 |
| **Fulfillment**         | Total number of unique pages discovered during scraping, including pages that were found but not necessarily scraped |
| **Success rate**        | Percentage of inputs that produced successful records                                                                |
| **Queued at**           | Timestamp when the job entered the queue                                                                             |
| **Started at**          | Timestamp when the scraper started collecting                                                                        |
| **Finished at**         | Timestamp when the scraper finished collecting                                                                       |
| **Job time**            | Total job duration                                                                                                   |
| **Estimated time left** | Time remaining for an in-progress job                                                                                |
| **Queue**               | Name of the queue the job is running in (from the trigger's queue name)                                              |
| **Page Loads**          | Total page loads consumed by the job                                                                                 |
| **Spent**               | Total amount spent on this collection run                                                                            |

## Collection run actions

The three-dot **Actions** menu includes the following options. Available actions may vary depending on the run status and delivery configuration.

<img alt="Three dots menu on a job row" />

### **Redeliver results**

Use **Redeliver results** to send collected results again to the configured delivery destination.

You can choose:

* **Dataset only**, redelivers only the structured output data.
* **Dataset + media**, redelivers the structured output data together with collected media files, such as images, videos, PDFs, or documents.

Use this when the original delivery failed, the destination was unavailable, or you updated the destination and want to send the same results again.

### **Rerun or cancel a collection**

Use **Rerun job** to start a new run from an existing collection.

You can choose:

* **Rerun all from beginning**, starts a new run using all original input values.
* **Rerun failed pages**, starts a new run only for pages that failed in the selected collection.

Use **Cancel collection** to stop an active collection before it finishes. Data already collected may still be available, depending on the run status and delivery settings.

### **Inspect results and errors**

Use **Quick view** to preview up to 100 collection records in JSON format directly in the control panel.

Use **Errors** to review failed inputs and error details.

Use **Activity** to monitor a collection run over time. The page shows run status, start and finish times, success rate, crawl count, and performance charts. You can change the visible time range, such as **5 min**, **1 h**, **1 d**, or **all**.

The Activity page includes:

* **Run rate** - shows how many pages were crawled, failed, or retried at each point in time, along with the success rate.
* **Pages** - shows discovered pages, open pages, retriable pages, and pages currently being crawled.
* **Inputs** - shows how many input rows were submitted and prepared for crawling.
* **Crawl rate** - shows the system-calculated maximum number of allowed workers and the actual number of workers assigned to the run.
* **Crawl time per page** -  shows the average time spent crawling each page.

Use **Activity** to investigate slow runs, error spikes, retries, or changes in crawl performance.

### **Debug crawl**

Use **Debug crawl** to investigate failed or unexpected scraper behavior.

## How do I download the data from the dashboard?

Click the **Download file options** button, select a file format, and the download starts immediately.

<Note>
  Real-time job outputs are stored on Bright Data's side but cannot be downloaded from the dashboard. To retrieve them, use the Scraper Studio API or send them to one of the delivery destinations configured in your delivery options.
</Note>

## How do I trigger a scraper and get results?

To trigger a scraper, use the three initiation options documented on [Initiate collection and delivery](/datasets/scraper-studio/initiate-collection-and-delivery-options):

* [Initiate by API](/datasets/scraper-studio/initiate-collection-and-delivery-options#how-do-i-trigger-a-scraper-run)
* [Initiate manually](/datasets/scraper-studio/initiate-collection-and-delivery-options#how-do-i-trigger-a-scraper-run)
* [Schedule a scraper](/datasets/scraper-studio/initiate-collection-and-delivery-options#how-do-i-trigger-a-scraper-run)

To retrieve results, click the three-dot icon on a scraper row and select **Statistics** to open the collection statistics page, where you can download the data.

## Related

<CardGroup>
  <Card title="Initiate collection and delivery" icon="truck" href="/datasets/scraper-studio/initiate-collection-and-delivery-options">
    Configure trigger methods, file formats and delivery destinations
  </Card>

  <Card title="Scraper Studio IDE interface" icon="display-code" href="/datasets/scraper-studio/scraper-studio-ide-interface">
    Reference for every panel and control in the IDE
  </Card>
</CardGroup>


# Scraper Studio functions reference
Source: https://docs.brightdata.com/datasets/scraper-studio/functions

Reference for Bright Data Scraper Studio interaction and parser functions: navigation, waits, selectors and parser helpers with parameters and 30+ examples.

This reference documents every function available in Bright Data Scraper Studio's IDE: the interaction code that controls a browser session, and the parser code that turns HTML into structured records. Each function lists its parameters, return value, and a runnable example.

<Note>
  Functions marked with **⭐** work only with the Browser worker and throw an error when called from a Code worker. See [Browser-only functions](#browser-only-functions) for the full list.
</Note>

## How is Scraper Studio code organized?

A Bright Data Scraper Studio scraper uses two code types:

| Code type        | Role                                                                                            | Language and libraries                    |
| ---------------- | ----------------------------------------------------------------------------------------------- | ----------------------------------------- |
| Interaction code | Navigates the target site: URL requests, clicks, scrolls, waits, and background traffic capture | JavaScript + Bright Data browser commands |
| Parser code      | Extracts and structures data from the HTML returned by interaction code                         | JavaScript + Cheerio (`$`)                |

You move data from one to the other with `parse()` (which runs the parser) and `collect()` (which appends a record to the final dataset).

## Interaction functions

Interaction functions run in the scraper's main JavaScript context and drive the browser or HTTP client. Use them to navigate, wait for elements, interact with the page, capture network traffic, and hand off data to the parser.

### Global objects

| Name       | Type   | Description                                                                                                                |
| ---------- | ------ | -------------------------------------------------------------------------------------------------------------------------- |
| `input`    | object | Input for the current stage, set by the trigger or by a previous `next_stage()`/`run_stage()`/`rerun_stage()` call.        |
| `job`      | object | Metadata about the current job (for example `job.created`, the job start timestamp).                                       |
| `location` | object | Info about the current browser location. Field: `href`.                                                                    |
| `parser`   | object | Values captured by `tag_response`, `tag_script`, and related tagging functions, available after `wait_for_parser_value()`. |

```js theme={null}
navigate(input.url);
let {created} = job;
console.log('current url', location.href);
```

### Navigation

#### `navigate`, Load a URL in the browser

Navigates the browser to a URL. A 404 status throws a `dead_page` error by default; override with `allow_status`.

**Parameters**

| Parameter          | Type          | Required | Default | Description                                                                                                               |
| ------------------ | ------------- | -------- | ------- | ------------------------------------------------------------------------------------------------------------------------- |
| `url`              | string or URL | Yes      | ,       | Target URL                                                                                                                |
| `opt.wait_until`   | string        | No       | `load`  | `load`, `domcontentloaded`, `networkidle0`, or `networkidle2`                                                             |
| `opt.timeout`      | number        | No       | `30000` | Navigation timeout in milliseconds                                                                                        |
| `opt.referer`      | string        | No       | ,       | `Referer` header to send                                                                                                  |
| `opt.allow_status` | number\[]     | No       | `[]`    | HTTP status codes to accept without throwing                                                                              |
| `opt.fingerprint`  | object        | No       | ,       | Override browser fingerprint (`screen.width`, `screen.height`)                                                            |
| `opt.sniff_mime`   | boolean       | No       | `false` | Detect the MIME type and store it as `sniffed_mime`. On code workers, only `text/html` and `application/pdf` are detected |

```js theme={null}
navigate(input.url);
navigate('https://example.com');
navigate('https://example.com', {wait_until: 'domcontentloaded'});
navigate('https://example.com', {referer: 'https://google.com'});
navigate('https://example.com', {timeout: 45000});
navigate('https://example.com', {allow_status: [404]});
navigate('https://example.com', {
  fingerprint: {screen: {width: 400, height: 400}},
});
navigate('https://example.com', {sniff_mime: true});
```

#### `request`, Make a direct HTTP request

Sends an HTTP request without using a browser. Use on Code worker, or on Browser worker when you want to bypass the browser.

**Parameters**

| Parameter          | Type             | Required | Description                                                      |
| ------------------ | ---------------- | -------- | ---------------------------------------------------------------- |
| `url` \| `options` | string or object | Yes      | URL string, or an object with `url`, `method`, `headers`, `body` |

```js theme={null}
let res = request('https://www.example.com');
let res = request({
  url: 'https://www.example.com',
  method: 'POST',
  headers: {'Content-type': 'application/json'},
  body: {hello: 'world'},
});
```

#### `next_stage`, Queue input for the next stage

Runs the next stage of the scraper in a new browser session with the given input.

**Parameters**

| Parameter | Type   | Required | Description                           |
| --------- | ------ | -------- | ------------------------------------- |
| `input`   | object | Yes      | Input object passed to the next stage |

```js theme={null}
next_stage({url: 'https://example.com', page: 1});
```

#### `run_stage`, Run a specific stage

Runs a named stage of the scraper in a new browser session.

**Parameters**

| Parameter | Type   | Required | Description                       |
| --------- | ------ | -------- | --------------------------------- |
| `stage`   | number | Yes      | Stage index (starts at 1)         |
| `input`   | object | Yes      | Input object passed to that stage |

```js theme={null}
run_stage(2, {url: 'https://example.com', page: 1});
```

#### `rerun_stage`, Re-run the current stage with new input

Runs this stage again with a new input. Use it to fan out work (for example, one re-run per page in a pagination).

```js theme={null}
rerun_stage({url: 'https://example.com/other-page'});
```

#### `load_sitemap`, Read URLs from an XML sitemap

Loads a sitemap XML file and returns the URL list. Supports sitemap indexes and gzip-compressed sitemaps.

**Parameters**

| Parameter     | Type   | Required | Description |
| ------------- | ------ | -------- | ----------- |
| `options.url` | string | Yes      | Sitemap URL |

```js theme={null}
let {pages} = load_sitemap({url: 'https://example.com/sitemap.xml.gz'});
let {children} = load_sitemap({url: 'https://example.com/sitemap-index.xml'});
```

#### `resolve_url`, Follow a URL through redirects

Returns the final URL that the given URL argument leads to.

**Parameters**

| Parameter | Type          | Required | Description    |
| --------- | ------------- | -------- | -------------- |
| `url`     | string or URL | Yes      | URL to resolve |

```js theme={null}
let {href} = parse().anchor_elem_data;
collect({final_url: resolve_url(href)});
```

#### `redirect_history`, Get the redirect chain

Returns the history of URL redirects since the last `navigate()` call.

```js theme={null}
navigate('http://google.com');
let redirects = redirect_history();
// ['http://google.com', 'http://www.google.com', 'https://www.google.com/']
```

#### `response_headers`, Read the last response headers

Returns the response headers from the last page load.

```js theme={null}
let headers = response_headers();
console.log('content-type', headers['content-type']);
```

#### `status_code`, Read the last response status

Returns the HTTP status code of the last page load.

```js theme={null}
collect({status_code: status_code()});
```

### Waiting on the page ⭐

All wait functions are Browser worker only.

#### ⭐ `wait`, Wait for an element to appear

**Parameters**

| Parameter     | Type    | Required | Default | Description                                          |
| ------------- | ------- | -------- | ------- | ---------------------------------------------------- |
| `selector`    | string  | Yes      | ,       | CSS selector to wait for                             |
| `opt.timeout` | number  | No       | `30000` | Timeout in milliseconds                              |
| `opt.hidden`  | boolean | No       | `false` | Wait for the element to be hidden instead of visible |
| `opt.inside`  | string  | No       | ,       | Selector of an iframe to look inside                 |

```js theme={null}
wait('#welcome-splash');
wait('.search-results .product');
wait('[href^="/product"]');
wait('#welcome-splash', {timeout: 5000});
wait('#welcome-splash', {hidden: true});
wait('#welcome-splash', {inside: '#iframe_id'});
```

#### ⭐ `wait_any`, Wait for any of several conditions

Waits for any matching condition to succeed. Returns when the first selector resolves.

```js theme={null}
wait_any(['#title', '#notfound']);
```

#### ⭐ `wait_visible`, Wait for an element to be visible

**Parameters**

| Parameter     | Type   | Required | Default | Description             |
| ------------- | ------ | -------- | ------- | ----------------------- |
| `selector`    | string | Yes      | ,       | CSS selector            |
| `opt.timeout` | number | No       | `30000` | Timeout in milliseconds |

```js theme={null}
wait_visible('#welcome-splash');
wait_visible('#welcome-splash', {timeout: 5000});
```

#### ⭐ `wait_hidden`, Wait for an element to disappear

**Parameters**

| Parameter     | Type   | Required | Default | Description             |
| ------------- | ------ | -------- | ------- | ----------------------- |
| `selector`    | string | Yes      | ,       | CSS selector            |
| `opt.timeout` | number | No       | `30000` | Timeout in milliseconds |

```js theme={null}
wait_hidden('#welcome-splash');
wait_hidden('#welcome-splash', {timeout: 5000});
```

#### ⭐ `wait_for_text`, Wait for text content

Waits for an element on the page to contain the given text.

**Parameters**

| Parameter  | Type   | Required | Description      |
| ---------- | ------ | -------- | ---------------- |
| `selector` | string | Yes      | CSS selector     |
| `text`     | string | Yes      | Text to wait for |

```js theme={null}
wait_for_text('.location', 'New York');
```

#### `wait_for_parser_value`, Wait for a parser field to be populated

Use after `tag_response()` or `tag_script()` to wait until the captured data is available.

**Parameters**

| Parameter     | Type     | Required | Description                                                |
| ------------- | -------- | -------- | ---------------------------------------------------------- |
| `field`       | string   | Yes      | Parser field path to wait on                               |
| `validate_fn` | function | No       | Optional callback returning `true` when the value is valid |
| `opt.timeout` | number   | No       | Timeout in milliseconds                                    |

```js theme={null}
wait_for_parser_value('profile');
wait_for_parser_value('listings.0.price', v => parseInt(v) > 0, {timeout: 5000});
```

#### ⭐ `wait_network_idle`, Wait until the browser network settles

Waits until the browser network has been idle for a given period.

**Parameters**

| Parameter     | Type   | Required | Default | Description                                         |
| ------------- | ------ | -------- | ------- | --------------------------------------------------- |
| `opt.timeout` | number | No       | `500`   | Milliseconds of idleness required                   |
| `opt.ignore`  | array  | No       | `[]`    | Patterns (string or RegExp) for requests to exclude |

```js theme={null}
wait_network_idle();
wait_network_idle({
  timeout: 1e3,
  ignore: [/long_request/, 'https://example.com'],
});
```

#### ⭐ `wait_page_idle`, Wait until DOM mutations stop

Waits until no changes are made to the DOM tree for a given period.

**Parameters**

| Parameter          | Type   | Required | Description                                   |
| ------------------ | ------ | -------- | --------------------------------------------- |
| `opt.idle_timeout` | number | No       | Milliseconds of stability required            |
| `opt.ignore`       | array  | No       | Selectors to exclude from mutation monitoring |

```js theme={null}
wait_page_idle();
wait_page_idle({
  ignore: ['.live-clock', '.carousel'],
  idle_timeout: 1000,
});
```

### Element interaction ⭐

All interaction functions require Browser worker.

#### ⭐ `click`, Click an element

Clicks an element, waiting for it to appear first.

**Parameters**

| Parameter         | Type            | Required | Description                                       |
| ----------------- | --------------- | -------- | ------------------------------------------------- |
| `selector`        | string or array | Yes      | CSS selector or Shadow DOM selector path          |
| `opt.coordinates` | `{x, y}`        | No       | Click the closest match to given page coordinates |

```js theme={null}
click('#show-more');
$('#show-more').click();

// Click the map pin closest to the center of a map
let box = bounding_box('#map');
let center = {x: (box.left + box.right) / 2, y: (box.top + box.bottom) / 2};
click('.map-pin', {coordinates: center});
```

#### ⭐ `right_click`, Right-click an element

Same as `click` but uses the right mouse button.

```js theme={null}
right_click('#item');
```

#### ⭐ `hover`, Hover over an element

Moves the cursor over an element, waiting for it to appear first.

```js theme={null}
hover('#item');
```

#### ⭐ `mouse_to`, Move the cursor to a coordinate

**Parameters**

| Parameter | Type   | Required | Description       |
| --------- | ------ | -------- | ----------------- |
| `x`       | number | Yes      | Target X position |
| `y`       | number | Yes      | Target Y position |

```js theme={null}
mouse_to(0, 0);
```

#### ⭐ `type`, Enter text into an input

Waits for the input to appear, then types the given text.

**Parameters**

| Parameter     | Type            | Required | Description                                           |
| ------------- | --------------- | -------- | ----------------------------------------------------- |
| `selector`    | string          | Yes      | CSS selector                                          |
| `text`        | string or array | Yes      | Text to type, or an array of strings and special keys |
| `opt.replace` | boolean         | No       | Clear existing text before typing                     |

```js theme={null}
type('#location', 'New York');
type('#location', 'New York', {replace: true});
type('[id$=input-box]', 'search term');
type('#search', ['Some text', 'Enter']);
type('#search', ['Backspace']);
```

#### ⭐ `press_key`, Press a special key

Types special keys like Enter or Backspace in the currently focused input.

```js theme={null}
press_key('Enter');
press_key('Backspace');
```

#### ⭐ `select`, Pick a value from a select element

**Parameters**

| Parameter  | Type   | Required | Description                          |
| ---------- | ------ | -------- | ------------------------------------ |
| `selector` | string | Yes      | CSS selector of a `<select>` element |
| `value`    | string | Yes      | Option value or visible text         |

```js theme={null}
select('#country', 'Canada');
```

#### ⭐ `scroll_to`, Scroll an element into view

Scrolls the page so a target element is visible. Defaults to natural scrolling; pass `immediate: true` to jump.

```js theme={null}
scroll_to('.author-profile');
scroll_to('top');
scroll_to('bottom');
scroll_to('top', {immediate: true});
```

#### ⭐ `scroll_to_all`, Scroll through every matching element

```js theme={null}
scroll_to_all('.author-profiles');
```

#### ⭐ `load_more`, Trigger lazy-loaded content

Scrolls to the bottom of a list to trigger infinite-scroll loading.

**Parameters**

| Parameter              | Type   | Required | Description                                     |
| ---------------------- | ------ | -------- | ----------------------------------------------- |
| `selector`             | string | Yes      | Container element holding the lazy-loaded items |
| `opt.children`         | string | No       | Selector for the individual items               |
| `opt.trigger_selector` | string | No       | Selector for an explicit "load more" button     |
| `opt.timeout`          | number | No       | Timeout in milliseconds                         |

```js theme={null}
load_more('.search-results');
load_more('.search-results', {
  children: '.result-item',
  trigger_selector: '.btn-load-more',
  timeout: 10000,
});
```

#### ⭐ `close_popup`, Auto-close popups in the background

Registers a background watcher that closes a popup whenever it appears. See [Best practices](/datasets/scraper-studio/best-practices) for the recommended pattern.

**Parameters**

| Parameter          | Type   | Required | Description                                                     |
| ------------------ | ------ | -------- | --------------------------------------------------------------- |
| `popup_selector`   | string | Yes      | Selector for the popup container                                |
| `close_selector`   | string | Yes      | Selector for the element that closes it                         |
| `opt.click_inside` | string | No       | Parent iframe selector, if the close button is inside an iframe |

```js theme={null}
close_popup('.popup', '.popup_close');
close_popup('iframe.with-popup', '.popup_close', {click_inside: 'iframe.with-popup'});
```

#### ⭐ `solve_captcha`, Solve CAPTCHAs on the page

```js theme={null}
solve_captcha();
solve_captcha({type: 'simple', selector: '#image', input: '#input'});
```

#### ⭐ `bounding_box`, Get an element's page coordinates

Returns the page-relative bounding box of the first matched element.

**Parameters**

| Parameter  | Type   | Required | Description  |
| ---------- | ------ | -------- | ------------ |
| `selector` | string | Yes      | CSS selector |

```js theme={null}
let box = bounding_box('.product-list');
// box == {top, right, bottom, left, x, y, width, height}
```

#### `el_exists`, Check if an element is on the page

**Parameters**

| Parameter  | Type   | Required | Default | Description                               |
| ---------- | ------ | -------- | ------- | ----------------------------------------- |
| `selector` | string | Yes      | ,       | CSS selector                              |
| `timeout`  | number | No       | `0`     | Wait up to N milliseconds for the element |

```js theme={null}
el_exists('#example');            // true
el_exists('.does_not_exist');     // false
el_exists('.does_not_exist', 5e3); // false after 5 seconds
```

#### `el_is_visible`, Check if an element is visible

**Parameters**

| Parameter  | Type   | Required | Default | Description                              |
| ---------- | ------ | -------- | ------- | ---------------------------------------- |
| `selector` | string | Yes      | ,       | CSS selector                             |
| `timeout`  | number | No       | `0`     | Wait up to N milliseconds for visibility |

```js theme={null}
el_is_visible('#example');
el_is_visible('.is_not_visible', 5e3);
```

#### ⭐ `track_event_listeners`, Start tracking browser event listeners

Must be called before `disable_event_listeners()`.

```js theme={null}
track_event_listeners();
```

#### ⭐ `disable_event_listeners`, Disable event listeners

Stops all event listeners from running on the page.

**Parameters**

| Parameter     | Type      | Required | Description                     |
| ------------- | --------- | -------- | ------------------------------- |
| `event_types` | string\[] | No       | Specific event types to disable |

```js theme={null}
disable_event_listeners();
disable_event_listeners(['hover', 'click']);
```

#### ⭐ `freeze_page`, Stop further page changes

Forces the page to stop changing, so HTML snapshots reflect exactly what the scraper saw. Experimental.

```js theme={null}
freeze_page();
```

### Network and response tagging ⭐

Tagging captures background network traffic and exposes it to the parser. All `tag_*` functions are Browser worker only.

#### ⭐ `tag_response`, Save one matching response

Saves the response data from a matching browser request.

**Parameters**

| Parameter         | Type               | Required | Description                                               |
| ----------------- | ------------------ | -------- | --------------------------------------------------------- |
| `field`           | string             | Yes      | Name of the parser field to populate                      |
| `pattern`         | RegExp or function | Yes      | URL pattern or match function                             |
| `opt.jsonp`       | boolean            | No       | Parse JSONP response bodies (auto-detected when possible) |
| `opt.allow_error` | boolean            | No       | Capture responses with non-2xx status codes               |

```js theme={null}
tag_response('resp', /url/, {jsonp: true});
tag_response('resp', /url/, {allow_error: true});

tag_response('resp', (req, res) => {
  if (req.url.includes('/api/')) {
    return {
      request_body: req.body,
      request_headers: req.headers,
      response_body: res.body,
      response_headers: res.headers,
    };
  }
});

tag_response('teams', /\/api\/teams/);
navigate('https://example.com/sports');
let teams = parse().teams;
for (let team of teams)
  collect(team);
```

#### ⭐ `tag_all_responses`, Save every matching response

Saves the response data from every matching request as an array.

```js theme={null}
tag_all_responses('profiles', /\/api\/profile/);
navigate('https://example.com/sports');
let profiles = parse().profiles;
for (let profile of profiles)
  collect(profile);
```

#### ⭐ `tag_script`, Extract JSON embedded in a `<script>` tag

**Parameters**

| Parameter  | Type   | Required | Description         |
| ---------- | ------ | -------- | ------------------- |
| `field`    | string | Yes      | Parser field name   |
| `selector` | string | Yes      | Script tag selector |

```js theme={null}
tag_script('ssr_state', '#__SSR_DATA__');
navigate('https://example.com/');
collect(parse().ssr_state);
```

#### ⭐ `tag_window_field`, Tag a value on the browser `window`

**Parameters**

| Parameter | Type   | Required | Description               |
| --------- | ------ | -------- | ------------------------- |
| `field`   | string | Yes      | Parser field name         |
| `key`     | string | Yes      | `window` property to read |

```js theme={null}
tag_window_field('initData', '__INIT_DATA__');
```

#### ⭐ `tag_image`, Capture an image URL from a DOM element

```js theme={null}
tag_image('image', '#product-image');
```

#### ⭐ `tag_video`, Capture a video URL from a DOM element

**Parameters**

| Parameter      | Type    | Required | Description             |
| -------------- | ------- | -------- | ----------------------- |
| `field`        | string  | Yes      | Parser field name       |
| `selector`     | string  | Yes      | Element selector        |
| `opt.download` | boolean | No       | Download the video file |

```js theme={null}
tag_video('video', '#product-video', {download: true});
```

#### ⭐ `tag_screenshot`, Save a screenshot of the page

**Parameters**

| Parameter       | Type    | Required | Description        |
| --------------- | ------- | -------- | ------------------ |
| `field`         | string  | Yes      | Parser field name  |
| `opt.filename`  | string  | No       | Output filename    |
| `opt.full_page` | boolean | No       | Defaults to `true` |

```js theme={null}
tag_screenshot('html_screenshot', {filename: 'screen'});
tag_screenshot('view', {full_page: false});
```

#### ⭐ `tag_download`, Capture files downloaded by the browser

**Parameters**

| Parameter | Type             | Required | Description                        |
| --------- | ---------------- | -------- | ---------------------------------- |
| `url`     | string or RegExp | Yes      | Pattern to match download requests |

```js theme={null}
let SEC = 1000;
let download = tag_download(/example.com\/foo\/bar/);
click('button#download');
let file1 = download.next_file({timeout: 10 * SEC});
let file2 = download.next_file({timeout: 20 * SEC});
collect({file1, file2});
```

#### ⭐ `tag_serp`, Parse the page as a search engine result page

**Parameters**

| Parameter | Type   | Required | Description                         |
| --------- | ------ | -------- | ----------------------------------- |
| `field`   | string | Yes      | Parser field name                   |
| `type`    | string | Yes      | Parser type: `google`, `bing`, etc. |

```js theme={null}
tag_serp('serp_bing_results', 'bing');
tag_serp('serp_google_results', 'google');
```

#### ⭐ `capture_graphql`, Capture and replay GraphQL queries

Captures a GraphQL request so you can replay it with different variables.

**Parameters**

| Parameter         | Type   | Required | Description                                                    |
| ----------------- | ------ | -------- | -------------------------------------------------------------- |
| `options.payload` | object | Yes      | Key-value pairs that match the target request payload          |
| `options.url`     | RegExp | No       | URL pattern for the GraphQL endpoint (defaults to `/graphql/`) |

```js theme={null}
let q = capture_graphql({
  payload: {id: 'ProfileQuery'},
});
navigate('https://example.com');

let [first_query, first_response] = q.wait_captured();
collect(first_response.data.profile);

let second = q.replay({
  variables: {other_id: 2},
});
collect(second.data.profile);
```

### Data collection

#### `parse`, Run the parser code

Runs the parser code and returns the structured result.

```js theme={null}
let page_data = parse();
collect({
  title: page_data.title,
  price: page_data.price,
});
```

#### `collect`, Append a record to the dataset

Adds one record to the scraper's output.

**Parameters**

| Parameter     | Type     | Required | Description                          |
| ------------- | -------- | -------- | ------------------------------------ |
| `data_line`   | object   | Yes      | Fields to collect                    |
| `validate_fn` | function | No       | Callback that throws on invalid data |

```js theme={null}
collect({price: data.price});
collect(product, p => {
  if (!p.title)
    throw new Error('Product is missing a title');
});
```

#### `set_lines`, Set output lines, overriding previous calls

Each call to `set_lines()` overrides the previous one. Useful when the scraper collects partial data and you want the last known state delivered if a later step throws.

**Parameters**

| Parameter     | Type      | Required | Description                            |
| ------------- | --------- | -------- | -------------------------------------- |
| `lines`       | object\[] | Yes      | Array of records                       |
| `validate_fn` | function  | No       | Validation callback, run once per line |

```js theme={null}
set_lines(products_so_far);
set_lines(products_so_far, p => {
  if (!p.price)
    throw new Error('Missing price');
});
```

#### `load_html`, Load an HTML string into Cheerio

**Parameters**

| Parameter | Type   | Required | Description   |
| --------- | ------ | -------- | ------------- |
| `html`    | string | Yes      | HTML to parse |

```js theme={null}
let $$ = load_html('<p id="p1">p1</p><p id="p2">p2</p>');
collect({data: $$('#p2').text()});
```

### Marking a crawl as a failure

#### `bad_input`, Mark the input as invalid

Prevents any retries and reports `error_code=bad_input`.

```js theme={null}
bad_input();
bad_input('Missing search term');
```

#### `blocked`, Mark the page as blocked

Reports that the site refused access. `error_code=blocked`.

```js theme={null}
blocked();
blocked('Login page was shown');
```

#### `dead_page`, Mark a URL as a dead link

Flags the page so it can be filtered from future collections. `error_code=dead_page`.

```js theme={null}
dead_page();
dead_page('Product was removed');
```

#### ⭐ `detect_block`, Detect blocking conditions on the page

**Parameters**

| Parameter            | Type             | Required | Description                                |
| -------------------- | ---------------- | -------- | ------------------------------------------ |
| `resource.selector`  | string           | Yes      | Element to check                           |
| `condition.exists`   | boolean          | No       | Fail if the element exists                 |
| `condition.has_text` | string or RegExp | No       | Fail if the element contains matching text |

```js theme={null}
detect_block({selector: '.foo'}, {exists: true});
detect_block({selector: '.bar'}, {has_text: 'text'});
detect_block({selector: '.baz'}, {has_text: /regex_pattern/});
```

### Session and routing

#### `country`, Route through a specific country

**Parameters**

| Parameter | Type   | Required | Description                    |
| --------- | ------ | -------- | ------------------------------ |
| `code`    | string | Yes      | Two-character ISO country code |

```js theme={null}
country('us');
```

#### ⭐ `proxy_location`, Fine-grained proxy location

Prefer `country()` unless you need precise geographic control.

**Parameters**

| Parameter               | Type   | Required | Description                    |
| ----------------------- | ------ | -------- | ------------------------------ |
| `configuration.country` | string | No       | Two-character ISO country code |
| `configuration.lat`     | number | No       | Latitude, range `[-85, 85]`    |
| `configuration.long`    | number | No       | Longitude, range `[-180, 180]` |
| `configuration.radius`  | number | No       | Radius in kilometers           |

```js theme={null}
proxy_location({country: 'us'});
proxy_location({lat: 37.7749, long: 122.4194});
proxy_location({lat: 37.7749, long: 122.4194, country: 'US', radius: 100});
```

#### `preserve_proxy_session`, Reuse the proxy session across child stages

```js theme={null}
preserve_proxy_session();
```

#### `set_session_cookie`, Set a cookie for the current session

**Parameters**

| Parameter | Type   | Required | Description   |
| --------- | ------ | -------- | ------------- |
| `domain`  | string | Yes      | Cookie domain |
| `name`    | string | Yes      | Cookie name   |
| `value`   | string | Yes      | Cookie value  |

```js theme={null}
set_session_cookie('example.com', 'session_id', 'abc123');
```

#### `set_session_headers`, Set extra HTTP headers

**Parameters**

| Parameter | Type   | Required | Description            |
| --------- | ------ | -------- | ---------------------- |
| `headers` | object | Yes      | Header key-value pairs |

```js theme={null}
set_session_headers({'X-Custom-Header': 'value'});
```

### Browser configuration ⭐

Browser worker only.

#### ⭐ `browser_size`, Get the current browser window size

Returns `{width, height}` in pixels.

```js theme={null}
let size = browser_size();
console.log(size.width, size.height);
```

#### ⭐ `emulate_device`, Emulate a mobile device

Switches the user agent, screen resolution, and device pixel ratio to match a named device.

**Parameters**

| Parameter | Type   | Required | Description                             |
| --------- | ------ | -------- | --------------------------------------- |
| `device`  | string | Yes      | Device name, e.g. `iPhone X`, `Pixel 2` |

```js theme={null}
emulate_device('iPhone X');
emulate_device('Pixel 2');
```

<Accordion title="Full list of supported device names">
  * Blackberry PlayBook / landscape
  * BlackBerry Z30 / landscape
  * Galaxy Note 3 / landscape
  * Galaxy Note II / landscape
  * Galaxy S III / S5 / S8 / S9+ (each with landscape)
  * Galaxy Tab S4 / landscape
  * iPad / iPad Mini / iPad Pro / iPad Pro 11 / iPad (gen 6) / iPad (gen 7) (each with landscape)
  * iPhone 4, 5, 6, 6 Plus, 7, 7 Plus, 8, 8 Plus, SE, X, XR, 11, 11 Pro, 11 Pro Max, 12 / 12 Mini / 12 Pro / 12 Pro Max, 13 / 13 Mini / 13 Pro / 13 Pro Max (each with landscape)
  * JioPhone 2 / landscape
  * Kindle Fire HDX / landscape
  * LG Optimus L70 / landscape
  * Microsoft Lumia 550, 950 (950 with landscape)
  * Nexus 4, 5, 5X, 6, 6P, 7, 10 (each with landscape)
  * Nokia Lumia 520 / landscape, Nokia N9 / landscape
  * Pixel 2, 2 XL, 3, 4, 4a (5G), 5 (each with landscape)
  * Moto G4 / landscape
</Accordion>

#### ⭐ `font_exists`, Check browser font support

Asserts that the browser can render the given font family.

```js theme={null}
font_exists('Liberation Mono');
```

#### ⭐ `html_capture_options`, Configure HTML capture

Controls how the HTML snapshot is captured.

**Parameters**

| Parameter                       | Type    | Required | Description                             |
| ------------------------------- | ------- | -------- | --------------------------------------- |
| `options.coordinate_attributes` | boolean | No       | Embed element coordinates as attributes |

```js theme={null}
html_capture_options({
  coordinate_attributes: true,
});
```

#### `embed_html_comment`, Inject a comment into the page HTML

Embeds metadata inside HTML snapshots.

```js theme={null}
embed_html_comment('trace-id: asdf123');
```

### Debugging and observability

#### `console`, Log from interaction code

```js theme={null}
console.log(1, 'brightdata', [1, 2], {key: 'value'});
console.error('something went wrong');
```

#### ⭐ `verify_requests`, Monitor failed browser requests

Fires a callback on every failed browser request.

**Parameters**

| Parameter  | Type     | Required | Description                                                        |
| ---------- | -------- | -------- | ------------------------------------------------------------------ |
| `callback` | function | Yes      | Called with `{url, error, type, response}` for each failed request |

```js theme={null}
verify_requests(({url, error, type, response}) => {
  if (response.status != 404 && type == 'Font')
    throw new Error('Font failed to load');
});
```

### Value constructors

Bright Data Scraper Studio provides typed constructors for structured output fields.

#### `Image`, `Video`, `Pdf`,  `Doc`, `Money`

| Constructor              | Arguments                             | Use                     |
| ------------------------ | ------------------------------------- | ----------------------- |
| `Image(src)`             | `src`: image URL or data URI          | Collect image data      |
| `Video(src)`             | `src`: video URL                      | Collect video data      |
| `Pdf(src)`               | `src`: PDF URL                        | Collect Pdf files       |
| `Doc(src)`               | `src`: document file URL              | Collect document files  |
| `Money(value, currency)` | `value`: number, `currency`: ISO code | Collect monetary values |

## **Supported downloaded file types**

Scraper Studio supports downloading files through media and document field constructors.

Use:

* `new Image()` for image files
* `new Video()` for video files
* `new Pdf()` for PDF files
* `new Doc()` for supported document, text, audio, video, and structured file types

### **Supported** `new Doc() `**content types**

`new Doc()` supports the following content types:

```text theme={null}
application/json
application/pdf
application/rtf
application/vnd.openxmlformats-officedocument.wordprocessingml.document
application/vnd.openxmlformats-officedocument.spreadsheetml.sheet
application/vnd.ms-excel
application/xml
application/vnd.oasis.opendocument.spreadsheet
audio/mp3
audio/mp4
audio/webm
text/csv
text/html
text/plain
text/vtt
text/xml
video/iso.segment
video/MP2T
video/mp2t
video/mp4
video/webm
```

example:

```js theme={null}
let img = new Image('https://example.com/image.png');
let vid = new Video('https://example.com/video.mp4');
let pdf = new Pdf('https://example.com/document.pdf');
let doc = new Doc('https://example.com/file.csv');
let price = new Money(10, 'USD');

collect({
image: img, 
video: vid, 
pdf, 
document: doc, 
product_price: price
});
```

#### `URL`

Standard Node.js `URL` class.

```js theme={null}
let u = new URL('https://example.com');
```

## Parser functions

Parser code runs after interaction code calls `parse()`. It receives the captured HTML and any tagged data, and returns a single record (or array of records) to the interaction code. Parser code uses Cheerio, a jQuery-compatible HTML parser.

### Globals available in parser code

| Name       | Type             | Description                                                                       |
| ---------- | ---------------- | --------------------------------------------------------------------------------- |
| `$`        | Cheerio instance | Loaded with the page HTML                                                         |
| `input`    | object           | Current stage input                                                               |
| `location` | object           | Current browser location; field: `href`                                           |
| `parser`   | object           | Values tagged during interaction (from `tag_response`, `tag_script`, and related) |

```js theme={null}
let url = input.url;
let current_url = location.href;
$('#example').text();
```

### Cheerio helpers

Bright Data Scraper Studio adds custom Cheerio methods on top of the standard API.

#### `$(selector).text_sane()`, Normalize whitespace

Returns `text()` with all whitespace runs collapsed to a single space and trimmed.

```js theme={null}
let name = $('a').text_sane();                   // "foo bar baz"
let raw  = $('a').text();                        // "foo   bar\n\n\t baz"
```

#### `$(selector).filter_includes(text)`, Filter elements by text content

Filters a selection to elements whose text includes the given substring. Chainable with the rest of the Cheerio API.

```js theme={null}
$('.selector').filter_includes('text').click();
```

### Parser value constructors

`Image`, `Video`, `PDF` and `Money` are also available in parser code and work the same way.

```js theme={null}
let img = new Image('https://example.com/image.png');
let price = new Money(10, 'USD');
let p = new Pdf('https://example.com/document.pdf')
collect({image: img, product_price: price});
```

## **Validate downloaded media type**

Use `validate_type` to check that the downloaded file content matches the expected media type. This option is supported by `new Pdf()`, `new Image()`, and `new Video()`.

When `validate_type` is enabled, Scraper Studio validates the downloaded file after fetching it. If the file content does not match the expected type, the field returns an error instead of a valid downloaded file.

Example:

```javascript theme={null}
return {
  pdf: new Pdf('https://example.com/pdf', { validate_type: true }),
  image: new Image('https://example.com/image', { validate_type: true }),
  video: new Video('https://example.com/video', { validate_type: true }),
};
```

Validation failure example:

```json theme={null}
{
  "pdf": {
    "remote_url": "https://example.com/pdf",
    "error": "downloaded file type \"image\" does not match the expected \"pdf\" type",
    "validated_type": "image",
    "error_code": "wrong_file_type"
  }
}
```

<Tip>
  For full Cheerio API documentation, see the [Cheerio website](https://cheerio.js.org/).
</Tip>

## Shadow DOM support

Interaction commands that accept a selector also accept an **array** of selectors, letting you reach into Shadow DOM trees. Use this with `click`, `wait`, `type`, and other interaction functions.

When you pass an array:

* One selector must target the shadow host element
* Every selector after it is resolved inside that shadow root

```js theme={null}
click(['body', 'my-shadow-host', 'button.submit']);
```

In that example, `my-shadow-host` is the element with the shadow root attached, and `button.submit` is resolved inside that shadow root.

## Browser-only functions

The following functions require Browser worker and throw `not_supported_in_code_worker` when called from a Code worker. Use this list to decide which worker your scraper needs.

| Category       | Functions                                                                                                                                                        |
| -------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Waits          | `wait`, `wait_any`, `wait_for_text`, `wait_visible`, `wait_hidden`, `wait_network_idle`, `wait_page_idle`                                                        |
| Interaction    | `click`, `right_click`, `hover`, `mouse_to`, `type`, `press_key`, `select`, `scroll_to`, `scroll_to_all`, `load_more`, `close_popup`, `solve_captcha`            |
| Tagging        | `tag_response`, `tag_all_responses`, `tag_script`, `tag_window_field`, `tag_image`, `tag_video`, `tag_screenshot`, `tag_download`, `tag_serp`, `capture_graphql` |
| Browser config | `browser_size`, `emulate_device`, `font_exists`, `html_capture_options`, `freeze_page`, `track_event_listeners`, `disable_event_listeners`                       |

See [Worker types](/datasets/scraper-studio/worker-types) to choose between Browser worker and Code worker.

## Related

<CardGroup>
  <Card title="Best practices" icon="list-check" href="/datasets/scraper-studio/best-practices">
    Recommended patterns for writing fast, reliable scrapers
  </Card>

  <Card title="Worker types" icon="server" href="/datasets/scraper-studio/worker-types">
    When to use Browser worker vs Code worker
  </Card>

  <Card title="Basics of web scraping" icon="graduation-cap" href="/datasets/scraper-studio/basics-of-web-scraping">
    Core concepts: interaction, parsing, stages, and scale
  </Card>

  <Card title="Develop a scraper" icon="wrench" href="/datasets/scraper-studio/develop-a-scraper">
    Step-by-step walkthrough of building a scraper in the IDE
  </Card>
</CardGroup>


# Initiate collection and delivery
Source: https://docs.brightdata.com/datasets/scraper-studio/initiate-collection-and-delivery-options

Trigger a Bright Data Scraper Studio collection by API, manually or on a schedule, then deliver to webhook, S3, Google Cloud, Azure, SFTP, email or API.

After you save a scraper to production in Bright Data Scraper Studio, you can start collection runs manually, by API, or on a schedule. You can also configure how results are delivered, which file format is used, what data is included, and when notifications are sent.

This page explains how to initiate Scraper Studio runs and configure delivery preferences.

## Prerequisites

* A scraper saved to production in the [Bright Data Scraper Studio](https://brightdata.com/cp/scrapers)
* An API key if you want to initiate runs or download results by API ([create one](https://brightdata.com/cp/setting))
* Destination credentials if you want to deliver results to webhook, cloud storage, SFTP or email

## How do I save a scraper to production?

While you edit code in the Bright Data Scraper Studio IDE, the system auto-saves your work as a development draft. To make the scraper runnable outside the IDE, click **Save to Production** in the top-right corner of the IDE.

Production scrapers appear under **My Scrapers** with an **Active** or **Ready** status. Unsaved scrapers remain in **Draft** status and cannot be initiated outside the IDE.

<Frame>
  <img alt="My Scrapers dashboard showing saved scrapers" />
</Frame>

## How do I trigger a scraper run?

Bright Data Scraper Studio supports three ways to start a collection run.

<Tabs>
  <Tab title="Initiate by API">
    Use **Initiate by API** to start a collection from your application or automation workflow. Before using the API, create an API key. Go to [Dashboard > Account settings > API key](https://brightdata.com/cp/setting).

    For a full API walkthrough, see **[Getting started with the API](/datasets/scraper-studio/quickstart).**

    <Frame>
      <img alt="Initiate scraper by API" />
    </Frame>

    The API-trigger panel provides:

    1. **Inputs:** provide input values manually or through the API request body
    2. **Trigger behavior:** Run several requests in parallel by assigning them a queue name or queue additional jobs to run after earlier ones finish
    3. **API request preview:** A ready-to-run request example, including the endpoint and request body. Select the **Linux Bash** viewer for `curl`. The API response includes a `collection_id`. Use this ID to fetch results later when delivery is configured as API download.

    <Note>
      When delivery is set to **API download**, you must call the "Receive data" API endpoint to retrieve results. When delivery is configured as **webhook** or **cloud storage**, Bright Data sends the results to the configured destination automatically.
    </Note>
  </Tab>

  <Tab title="Initiate manually">
    Use **Initiate manually** to start a collection from the Bright Data control panel without writing a code.

    ## Open the Initiate manually page

    1. Go to **My scrapers**
    2. Select the scraper you want to run
    3. Open the **Initiate manually** tab

    The page shows the input fields required for that scraper. These fields come from the scraper’s input schema. For example, one scraper may require a `url`, while another may require `keyword` and `location`.

    ## Configure trigger behavior

    Use **Trigger behavior** to control how this run is grouped or queued.

    | Option            | Description                                                 |
    | ----------------- | ----------------------------------------------------------- |
    | Custom queue name | Optional name used to group related jobs in the same queue. |

    Run requests in parallel, or queue jobs so they start after earlier jobs finish. Use a queue name to group related jobs.

    If you do not need custom queue behavior, leave this field empty.

    ## Add inputs manually

    Type the values for this run, such as URLs, keywords, locations, or other required fields. Required fields vary by scraper.

    Each input row represents one item the scraper will process.

    To add another input row, click **Add another input**

    ## **Upload an input file**

    For larger input sets, upload a file instead of entering values one by one.

    Use **Attach a CSV file** to upload multiple inputs at once in CSV, TXT or JSON format (max 1GB). Empty rows are ignored.

    You can click **Download our example** to download a template for the current scraper. Use the example file to confirm:

    * Which columns are required
    * How input field names should be written
    * What format the uploaded file should use

    The uploaded file must match the scraper’s input schema. For example, if the scraper requires `search` and `location`, the file should include matching columns.

    ## **Set a deadline**

    Use **Deadline** to set the maximum amount of time the collection can run.

    If the collection is still running when the deadline is reached, Bright Data stops the collection and delivers the data collected so far.

    Supported values include durations or a future timestamp.

    Examples:

    | Format    | Example                    |
    | --------- | -------------------------- |
    | Hours     | `1h`                       |
    | Minutes   | `25m` or `30min`           |
    | Seconds   | `10s`                      |
    | Timestamp | `2026-06-09T19:14:12.056Z` |

    Use a deadline when you want to limit run time or receive partial results by a specific time.

    ## **Skip delivery**

    Enable **Skip delivery** if you want to run the scraper without sending results to the configured delivery destination.

    If **Skip delivery** is disabled, the run uses the scraper’s configured delivery preferences.

    ## **Start the run**

    After entering inputs or uploading a file:

    1. Review the input values.
    2. Configure optional settings, such as queue name, deadline, or skip delivery.
    3. Click **Start**.

    The collection starts and appears in the scraper’s **Runs** tab.
  </Tab>

  <Tab title="Schedule a scraper">
    Use scheduled runs to collect data automatically on a recurring basis.

    Scheduling is useful when you need fresh data hourly, daily, weekly, or on a custom schedule.

    **Step 1, configure the schedule:**

    1. Pick a start date and time
    2. Choose a frequency: hourly, daily, weekly, or custom
    3. Set a deadline for the scraper to finish
    4. Review your configuration before saving

    <Frame>
      <img alt="Schedule configuration screen" />
    </Frame>

    **Step 2, set inputs:**

    1. Upload a CSV file with a large input set (for example, a list of URLs). Download the CSV template to match the expected format
    2. Enter input values manually in the form

    <Frame>
      <img alt="Enter input values for a scheduled run" />
    </Frame>
  </Tab>
</Tabs>

## What are the rate limits and concurrency limits?

Bright Data Scraper Studio enforces concurrency limits per scraper, based on whether the request is batch or real-time.

| Collection type | Concurrency limit                         |
| --------------- | ----------------------------------------- |
| Batch           | Up to 100 concurrent requests per scraper |
| Real-time       | 50K requests/min per customer             |

When the batch limit is exceeded, Bright Data returns this error: `Maximum limit of 100 jobs per scraper has been exceeded. Please reduce the number of parallel jobs.`

## Batch vs real-time collection

Scraper Studio supports batch and real-time collection. Each method is optimized for a different use case.

|                   | Batch collection                               | Real-time collection                     |
| ----------------- | ---------------------------------------------- | ---------------------------------------- |
| Input size        | Many inputs per job (list of URLs or keywords) | One input per request                    |
| Response timing   | Results are returned after the job completes.  | Response is returned in real time.       |
| Retention         | 16 days                                        | 7 days                                   |
| Concurrency limit | up to 100 concurrent jobs per scraper          | 50K requests/min per customer            |
| Use when          | You are building a dataset and can wait        | You need an answer inside a live request |

Use batch collection for larger jobs and scheduled datasets. Use real-time collection for low-latency workflows that need a response for one input.

## How do I configure delivery?

Open **My Scrapers**, click a scraper row, and choose **Delivery preferences** to set where and how Bright Data Scraper Studio delivers results.

<AccordionGroup>
  <Accordion title="When should I receive the data?">
    * **On job Completion (batch):** Delivers results after the full collection run finishes. Use when you are collecting multiple inputs and can wait until the run completes.
      * **Split delivery to small batches:** Delivers partial result batches as they become available. Enter the number of data lines each batch should contain. Entering `10000` means each delivered file or payload contains up to 10,000 result lines.
    * **Real-time (single request):** Returns data for a single request in real time.
      * **Skip retries:** do not retry on error (speeds up collection at the cost of completeness)
  </Accordion>

  <Accordion title="Which file formats are supported?">
    * JSON
    * NDJSON
    * CSV
    * XLSX
  </Accordion>

  <Accordion title="Which delivery destinations are supported?">
    * Email
    * API download (pull via REST API)
    * Webhook (push via HTTPS POST)
    * Cloud storage: Amazon S3, Google Cloud Storage, Azure Blob Storage, Alibaba Cloud OSS
    * SFTP / FTP

    <Note>
      Media files cannot be delivered via Email or API download. Use cloud storage, SFTP, or webhook when collecting images, videos, or other binary content.
    </Note>
  </Accordion>

  <Accordion title="How can I control what goes in the batch output?">
    Use **Data preferences** to decide which records are included in delivery.

    * Results and errors in separate files
    * Results and errors in one combined file
    * Only successful results
    * Only errors
  </Accordion>

  <Accordion title="Which notifications can I enable?">
    Use **Notifications** to receive updates about completed runs, low success rates, or delivery problems.

    Notifications can be configured separately for production and development.

    * **Completion notifications** (Email, Webhook, None) - use **When finished, notify me by** to choose whether Scraper Studio sends a notification after a run completes.
    * **Low success rate notifications** - use **Notify me about low success rates** to receive alerts when scraper success rates drop.
    * **Delivery problem notifications** - use **Notify me about problems with delivery** to receive alerts when Scraper Studio cannot deliver results to the configured destination.
  </Accordion>

  <Accordion title="What is Development delivery settings?">
    The **Development** setting controls whether development runs use the same delivery settings as production. Use separate development settings when testing a new destination, webhook, or file format before applying it to production runs.
  </Accordion>
</AccordionGroup>

## Related

<CardGroup>
  <Card title="Scraper Studio specifications" icon="file-lines" href="/datasets/scraper-studio/specifications">
    Infrastructure limits, billing, and data retention
  </Card>

  <Card title="WARC snapshots" icon="file-zipper" href="/datasets/scraper-studio/warc-ide">
    Archive raw HTTP responses alongside collected data
  </Card>
</CardGroup>


# Input and output schema
Source: https://docs.brightdata.com/datasets/scraper-studio/input-and-output-schema

Define a Bright Data Scraper Studio IDE collector's input fields and structured output schema, across 18 output field types with validation and PII flags.

The input and output schema defines the data contract for a Bright Data Scraper Studio IDE collector: which fields a collection run accepts and which structured fields the collector returns.

* **Input schema** defines the fields a collection run accepts, such as `url`, `keyword`, `country`, `date`, or any custom field your interaction code reads from `input`.
* **Output schema** defines the structured fields the scraper returns, based on the data emitted by `collect()`.

Both schemas are configured in the Bright Data Scraper Studio IDE. Schema changes are applied to the production collector when you click **Save to Production**.

## What is the input schema?

The input schema defines the values your scraper can receive at runtime.

A scraper often uses a `url` input, but inputs are not limited to URLs. Depending on the collector logic, inputs can be keywords, locations, dates, IDs, countries, or any custom parameter.

Your interaction code reads input values through the `input` object:

```js theme={null}
navigate(input.url);
wait('.product-title');

const data = parse();
collect(data);
```

For a keyword-based scraper:

```js theme={null}
navigate(`https://example.com/search?q=${input.keyword}`);
wait('.search-results');

collect(parse());
```

A scraper can also run without user-provided input if the target URL or collection logic is hardcoded in the scraper code.

## Define input parameters

To define the input schema in the Bright Data Scraper Studio IDE:

1. Open your collector in the **Scraper Studio IDE**.
2. Go to the **Code** tab.
3. Click **Add input parameter**.
4. Enter a field name, for example `url`, `keyword`, `country`, or `date`.
5. Add an optional description.
6. Select the field type.
7. Mark the field as **Required** if the collector cannot run without it.
8. Click **Save**.
9. Click **Save to Production** when the collector is ready.

After a collector has already been saved, click **Edit schema** in the IDE to update its input schema.

### What are the input parameter settings?

| Setting               | Description                                                                            |
| --------------------- | -------------------------------------------------------------------------------------- |
| **Field name**        | The key used in code as `input.<field_name>`.                                          |
| **Description**       | Optional explanation of what value the user should provide.                            |
| **Type**              | The expected value type, such as text/string, boolean, date, or country.               |
| **Required**          | If enabled, each collection input must include this field.                             |
| **Predefined values** | Optional fixed choices, when supported by the selected type. Example: `country` type.  |
| **Case-insensitive**  | Treats matching values as case-insensitive, when supported by the field configuration. |

## What do collection inputs look like?

A URL-based collector can accept one or more URLs:

```json theme={null}
[
  { "url": "https://example.com/product/1" },
  { "url": "https://example.com/product/2" }
]
```

A collector can also accept multiple input fields:

```json theme={null}
[
  {
    "url": "https://example.com/search",
    "keyword": "standing desk",
    "country": "US"
  },
  {
    "url": "https://example.com/search",
    "keyword": "monitor arm",
    "country": "GB"
  }
]
```

Only fields marked as **Required** must be provided for every input object. Optional fields can be omitted.

## What is the output schema?

The output schema defines the data point structure and how the data is organized.

In the Bright Data Scraper Studio IDE, the output schema is usually generated from the object passed to `collect()`.

```js theme={null}
collect({
  title: $('.product-title').text_sane(),
  price: new Money(+$('.price').text().replace(/\D+/g, ''), 'USD'),
  availability: $('.stock-status').text_sane(),
});
```

This produces output fields such as:

```json theme={null}
{
  "title": "ErgoDesk Pro",
  "price": {
    "value": 349.99,
    "currency": "USD"
  },
  "availability": "In stock"
}
```

When the scraper is saved, Scraper Studio detects the collected data structure and creates or updates the output schema.

## Update the output schema

There are two ways to update the output schema: automatically from parser code or manually in the schema editor.

### Update the schema automatically

1. Add or change fields in your parser code.
2. Run a preview to confirm that required fields return as expected.
3. Click **Save to Production**.
4. If Scraper Studio detects schema changes, click **Update schema**.
5. Click **Save to Production** again.

### Update the schema manually

1. Click **Edit schema** in the IDE.
2. Add or edit fields by name and type.
3. Configure required flags, default values, formatting, validation, or PII settings.
4. Save the schema.
5. Click **Save to Production**.

## What is the Output Schema Editor?

The Output Schema Editor defines exactly which fields your collector returns and how each field is validated, formatted and delivered.

The editor has two views:

| View           | Description                                                 |
| -------------- | ----------------------------------------------------------- |
| **Table view** | Visual list of fields with toggles and field configuration. |
| **JSON view**  | Direct JSON editing for the schema object.                  |

Clicking a field row opens the configuration side panel for that field.

## How is an output schema structured?

An output schema is a JSON object with a top-level `type` and a `fields` object:

```json theme={null}
{
  "type": "object",
  "fields": {
    "title": {
      "type": "text",
      "active": true
    },
    "price": {
      "type": "price",
      "active": true
    }
  }
}
```

## What properties can output fields have?

These properties apply to user-defined output fields.

| Property            | Type    | Description                                                              |
| ------------------- | ------- | ------------------------------------------------------------------------ |
| `type`              | string  | Field type, such as `text`, `number`, `price`, `image`, or `object`.     |
| `active`            | boolean | Whether the field is included in the output. Default: `true`.            |
| `required`          | boolean | If `true`, rows with no valid value for this field are marked as errors. |
| `default_value`     | string  | Value used when the field cannot be populated.                           |
| `description`       | string  | Human-readable explanation of the field.                                 |
| `pii`               | boolean | Marks the field as containing personally identifiable information.       |
| `custom_formatting` | object  | Custom JavaScript formatter for advanced output shaping.                 |
| `custom_validation` | object  | Define validation rules that run on every collected record.              |

## Configure a field in the side panel

The side panel contains field-specific settings.

| Setting                   | Description                                                         |
| ------------------------- | ------------------------------------------------------------------- |
| **Field name**            | The key used in the output JSON. Available for user-defined fields. |
| **Display name**          | Optional UI label, separate from the output key.                    |
| **Data type**             | The field type. Changing the type resets type-specific settings.    |
| **Active**                | Includes or excludes the field from output.                         |
| **Required**              | Marks rows as errors when this field is missing or invalid.         |
| **Default value**         | Fallback value when the field cannot be populated.                  |
| **Description**           | Optional human-readable description of the field.                   |
| **Contains PII**          | Marks the field as containing personally identifiable information.  |
| **Format**                | Type-specific output formatting. Example: price/money type.         |
| **Download**              | For media/file fields, downloads the file to configured storage.    |
| **Array values**          | Defines the item type for `array` fields.                           |
| **Subfields**             | Defines nested fields for `object` fields.                          |
| **Normalize**             | Controls empty array behavior.                                      |
| **Set as quick filter**   | Exposes the field as a filter in the dataset viewer.                |
| **Quick filter operator** | Defines the comparison operator used by the quick filter.           |

## What default values are available?

Available default values depend on the field type.

| Option      | Output behavior                   | Available for     |
| ----------- | --------------------------------- | ----------------- |
| `undefined` | Field is omitted from the output. | All types         |
| `null`      | Field is returned as `null`.      | All types         |
| `""`        | Empty string.                     | `text`            |
| `false`     | Boolean false.                    | `boolean`         |
| `0`         | Numeric zero.                     | `number`, `price` |
| `[]`        | Empty array.                      | `array`           |

## What output field types are available?

Scraper Studio supports the following user-defined output field types.

### `text`

Free-form text.

```json theme={null}
{
  "type": "text",
  "active": true,
  "required": false,
  "default_value": "null"
}
```

Example value:

```json theme={null}
"Laptop 15-inch Pro"
```

### `number`

Integer or decimal number. Numeric strings can be converted to numbers.

```json theme={null}
{
  "type": "number",
  "active": true,
  "format": {
    "decimal_places": 2
  },
  "default_value": "zero"
}
```

Example value:

```json theme={null}
11.23
```

### `url`

A URL string. Only `http://` and `https://` URLs are accepted.

```json theme={null}
{
  "type": "url",
  "active": true,
  "required": true
}
```

Example value:

```json theme={null}
"https://example.com/product/123"
```

### `price`

A monetary value represented as a numeric value and currency code.

```json theme={null}
{
  "type": "price",
  "active": true,
  "format": {
    "preset": "us_style"
  }
}
```

Example value:

```json theme={null}
{
  "value": 99.99,
  "currency": "USD"
}
```

Price format presets:

| Preset     | Description                                               | Example                                   |
| ---------- | --------------------------------------------------------- | ----------------------------------------- |
| `us_style` | US-style formatting.                                      | `$1,234.56`                               |
| `locale`   | Locale-aware formatting. Requires locale.                 | `1.234,56 €`                              |
| `number`   | Numeric value only.                                       | `1234.56`                                 |
| `raw`      | Raw object.                                               | `{ "value": 1234.56, "currency": "USD" }` |
| `custom`   | Template using `{[symbol]}`, `{[value]}`, `{[currency]}`. | `USD 1234.56`                             |

### `boolean`

A true/false value.

```json theme={null}
{
  "type": "boolean",
  "active": true,
  "default_value": "false"
}
```

Example value:

```json theme={null}
true
```

### `date`

Date or timestamp value.

```json theme={null}
{
  "type": "date",
  "active": true,
  "format": {
    "preset": "iso"
  }
}
```

Date format presets:

| Preset      | Description                     | Example                             |
| ----------- | ------------------------------- | ----------------------------------- |
| `iso`       | ISO 8601 string.                | `2024-03-15T10:30:00.000Z`          |
| `timestamp` | Unix timestamp in milliseconds. | `1710494400000`                     |
| `locale`    | Locale-aware readable date.     | `March 15, 2024 at 10:30:00 AM UTC` |

Locale formatting can include:

* Locale, for example `en-US`, `fr-FR`, `ru-RU`
* Date style: `long`, `medium`, `short`
* Time style: `long`, `medium`, `short`

### `country`

A two-letter ISO 3166-1 alpha-2 country code.

```json theme={null}
{
  "type": "country",
  "active": true
}
```

Example value:

```json theme={null}
"US"
```

### `phone`

A phone number parsed into structured components.

```json theme={null}
{
  "type": "phone",
  "active": true
}
```

Example value:

```json theme={null}
{
  "area_code": 1,
  "number": 5555555555,
  "extension": "1234"
}
```

### `image`

A downloaded or referenced image.

```json theme={null}
{
  "type": "image",
  "active": true,
  "download": true,
  "format": {
    "behavior": "object",
    "content_type": true
  }
}
```

When **Download** is enabled, the file is stored in the configured delivery destination. File downloads are billed separately from page loads where applicable.

### `video`, `pdf` and `doc`

These file types use the same download and behavior settings as `image`.

```json theme={null}
{
  "type": "video",
  "active": true,
  "download": true
}
```

Supported file field types:

| Type    | Description                             |
| ------- | --------------------------------------- |
| `video` | Downloaded or referenced video file.    |
| `pdf`   | Downloaded or referenced PDF file.      |
| `doc`   | Downloaded or referenced document file. |

## **File field output options**

For downloaded file fields, such as `image`, `video`, `pdf`, and `doc`, the output schema editor lets you control how file metadata is returned.

These settings appear when the field behavior is set to **Object**.

### **Behavior**

Use **Behavior** to choose how the file field is returned.

* **Simple**: returns only the downloaded file path or the original remote URL.
* **Object**: returns an object with file metadata, such as `file_path`, `remote_url`, `content_type`, `file_size`, and `response_headers`, depending on which options are enabled.

Use **Object** when you need more than the file path, for example when validating file type, checking file size, or debugging download headers.

### **Include content type**

Enable **Include content type** to include the file MIME type in the output.

Example:

```json theme={null}
{
  "content_type": "image/jpeg"
}
```

Use this to confirm whether the downloaded file is an image, PDF, video, or another media type.

### **Include file size**

Enable **Include file size** to include the downloaded file size in bytes.

Example:

```json theme={null}
{
  "file_size": 123456
}
```

Use this to validate file size, detect empty or unexpectedly large downloads, or troubleshoot failed media processing.

### **Include response headers**

Enable **Include response headers** to include the HTTP response headers received when Scraper Studio downloads the file.

Example:

```json theme={null}
{
  "response_headers": {
    "accept-ranges": "bytes",
    "age": "21753",
    "cache-control": "public, max-age=31557600",
    "content-type": "image/jpeg",
    "date": "Sun, 05 Jul 2026 12:43:07 GMT",
    "last-modified": "Sun, 05 Jul 2026 06:40:34 GMT",
    "source-length": "2088714",
    "source-type": "image/jpeg",
    "vary": "Accept"
  }
}
```

Response headers can help you debug file downloads, verify content type, inspect cache behavior, and troubleshoot unexpected media responses.

### **Example output**

When **Behavior** is set to **Object** and all metadata options are enabled, the output can look like this:

```json theme={null}
{
  "image": {
    "file_path": "image.jpg",
    "remote_url": "https://example.com/image",
    "content_type": "image/jpeg",
    "file_size": 123456,
    "response_headers": {
      "accept-ranges": "bytes",
      "age": "21753",
      "cache-control": "public, max-age=31557600",
      "content-type": "image/jpeg",
      "date": "Sun, 05 Jul 2026 12:43:07 GMT",
      "last-modified": "Sun, 05 Jul 2026 06:40:34 GMT",
      "source-length": "2088714",
      "source-type": "image/jpeg",
      "vary": "Accept"
    }
  }
}
```

### `array`

An ordered list of values. The element type is defined with `items`.

```json theme={null}
{
  "type": "array",
  "active": true,
  "normalize": {
    "empty": "keep"
  },
  "default_value": "empty_array",
  "items": {
    "type": "text"
  }
}
```

Empty array behavior:

| Option | Description                                             |
| ------ | ------------------------------------------------------- |
| `keep` | Keep empty arrays as `[]`.                              |
| `drop` | Replace empty arrays with the configured default value. |

Array of nested objects:

```json theme={null}
{
  "type": "array",
  "active": true,
  "items": {
    "type": "object",
    "fields": {
      "name": {
        "type": "text",
        "active": true
      },
      "price": {
        "type": "price",
        "active": true
      }
    }
  }
}
```

### `object`

A nested object with its own subfields.

```json theme={null}
{
  "type": "object",
  "active": true,
  "fields": {
    "title": {
      "type": "text",
      "active": true
    },
    "price": {
      "type": "price",
      "active": true
    },
    "in_stock": {
      "type": "boolean",
      "active": true
    }
  }
}
```

### What HTML conversion field types are available?

| Type            | Description                                         | Example value                               |
| --------------- | --------------------------------------------------- | ------------------------------------------- |
| `html2text`     | HTML converted to readable text.                    | `Product title\nDescription text`           |
| `html2markdown` | HTML converted to Markdown.                         | `## Product title`                          |
| `html2html`     | Raw HTML content.                                   | `<div class="product"><h1>Title</h1></div>` |
| `html2ldjson`   | Structured data from `application/ld+json` scripts. | `{"@type":"Product","name":"Widget"}`       |

Example:

```json theme={null}
{
  "type": "html2markdown",
  "active": true
}
```

## How do I validate field values?

Custom validation lets you define JavaScript rules that run on every collected value for a field.

Throw an error to mark the value as invalid:

```js theme={null}
function validate(v) {
  if (!v)
    throw new Error('Value is required');

  return true;
}
```

Rows that fail validation are treated as error rows when validation is configured for required output quality.

## How do I format field values?

Custom formatting lets you transform a field value before output delivery.

```js theme={null}
function process(value) {
  return value;
}
```

Use custom formatting when built-in formatting options do not match the required output shape.

## When do I use collect() vs set\_lines()?

The way records are emitted affects the output dataset.

| Function          | Behavior                                                 | Use when                                                              |
| ----------------- | -------------------------------------------------------- | --------------------------------------------------------------------- |
| `collect(data)`   | Appends one record to the dataset.                       | Most scrapers.                                                        |
| `set_lines(data)` | Replaces previously emitted records with the latest set. | Progressive collection where the latest snapshot should be preserved. |

Example with `collect()`:

```js theme={null}
collect({
  title,
  price,
  availability,
});
```

Example with `set_lines()`:

```js theme={null}
set_lines(products);
```

## What system fields can I add?

System fields are generated by Scraper Studio. Their names and types are fixed. You can toggle them on or off in the output schema configuration under **Additional data**.

| Field                 | Type            | Default | Description                                                   |
| --------------------- | --------------- | ------- | ------------------------------------------------------------- |
| `input`               | string / object | On      | The input value or object that triggered the crawl.           |
| `prime_input`         | string / object | Off     | The original root input when discovery or pagination is used. |
| `error`               | string          | On      | Explanation of why collection failed for the row.             |
| `error_code`          | string          | On      | Structured error code, such as `validation` or `timeout`.     |
| `warning`             | string          | On      | System-level warning for the row.                             |
| `warning_code`        | string          | On      | Structured warning code.                                      |
| `status_code`         | number          | Off     | HTTP-like crawl result code, such as `200` or `404`.          |
| `timestamp`           | date            | Off     | Date and time the page was collected.                         |
| `requested_timestamp` | date            | Off     | Date and time the job was triggered.                          |
| `page_id`             | string          | Off     | Unique identifier for the page crawl.                         |
| `job_id`              | string          | Off     | ID of the job that produced the row.                          |
| `collector_id`        | string          | Off     | ID of the collector.                                          |
| `collector_queue`     | string          | Off     | Queue the job was submitted to.                               |
| `crawl_type`          | string          | Off     | Crawl or parser type used for the row.                        |
| `screenshot`          | file            | Off     | Screenshot of the browser page at collection time.            |
| `html`                | file            | Off     | Full HTML snapshot of the page.                               |
| `warc`                | file            | Off     | WARC archive of the page.                                     |

When `screenshot`, `html`, or `warc` are active, the files are downloaded to the configured storage destination.

## How do I add a screenshot watermark?

When the `screenshot` system field is enabled, a watermark can be added to the screenshot. Each watermark item has a label and a data source.

| Source      | Description                                                        |
| ----------- | ------------------------------------------------------------------ |
| Browser URL | URL the browser was on when the screenshot was taken.              |
| Timestamp   | Timestamp of the screenshot capture.                               |
| Input value | Value from the collector input, such as `url` or `config.country`. |

## What does a full output schema look like?

```json theme={null}
{
  "type": "object",
  "fields": {
    "url": {
      "type": "url",
      "active": true,
      "required": true
    },
    "title": {
      "type": "text",
      "active": true
    },
    "price": {
      "type": "price",
      "active": true,
      "format": {
        "preset": "us_style"
      },
      "default_value": "zero"
    },
    "rating": {
      "type": "number",
      "active": true,
      "format": {
        "decimal_places": 1
      }
    },
    "in_stock": {
      "type": "boolean",
      "active": true,
      "default_value": "false"
    },
    "listed_date": {
      "type": "date",
      "active": true,
      "format": {
        "preset": "iso"
      }
    },
    "country": {
      "type": "country",
      "active": true
    },
    "images": {
      "type": "array",
      "active": true,
      "normalize": {
        "empty": "keep"
      },
      "default_value": "empty_array",
      "items": {
        "type": "image",
        "download": true
      }
    },
    "seller": {
      "type": "object",
      "active": true,
      "fields": {
        "name": {
          "type": "text",
          "active": true
        },
        "phone": {
          "type": "phone",
          "active": true
        }
      }
    }
  }
}
```

## Related

<CardGroup>
  <Card title="Develop a scraper" icon="wrench" href="/datasets/scraper-studio/develop-a-scraper">
    Step-by-step walkthrough of building a scraper in the IDE
  </Card>

  <Card title="Functions reference" icon="code" href="/datasets/scraper-studio/functions">
    Interaction and parser functions with parameters and examples
  </Card>

  <Card title="Initiate collection and delivery" icon="paper-plane" href="/datasets/scraper-studio/initiate-collection-and-delivery-options">
    Trigger collection and deliver output to your destination
  </Card>

  <Card title="Trigger a scraper (API)" icon="bolt" href="/api-reference/scraper-studio-api/Trigger_a_scraper_for_batch_collection_method">
    Run a published collector for batch collection by API
  </Card>
</CardGroup>


# When to use Scraper Studio
Source: https://docs.brightdata.com/datasets/scraper-studio/introduction

Decide when Bright Data Scraper Studio fits your use case and whether to build with the AI Agent or the JavaScript IDE, with a side-by-side comparison.

Bright Data Scraper Studio is a cloud-hosted environment for building, running, and managing custom web scrapers, running entirely on Bright Data's proxy and unblocking infrastructure. This page explains when to choose Scraper Studio over other Bright Data products and which build mode fits your use case.

For a visual overview, runnable example and the full list of build paths, see the [Scraper Studio overview](/datasets/scraper-studio/overview).

## Which development mode to use

Bright Data Scraper Studio offers two ways to build scrapers:

| Mode     | How it works                                                                                                | Best for                         |
| -------- | ----------------------------------------------------------------------------------------------------------- | -------------------------------- |
| AI Agent | Describe the data you want in plain language. Bright Data AI generates a schema and writes the scraper code | No-code users, fast prototyping  |
| IDE      | Write and test JavaScript directly in a browser-based code editor with debugging tools                      | Developers who need full control |

Both modes produce the same type of scraper: meaning you're never locked into one approach. A scraper built by AI Agent can be opened and edited in the IDE at any time, and any scraper can be updated using the [Self-healing tool](/datasets/scraper-studio/self-healing-tool).

## When to use Scraper Studio vs. other Bright Data products

Use Scraper Studio when the data you need isn't in the [Datasets Marketplace](/datasets/marketplace), you want ownership of the scraper logic, and you don't want to manage proxies or infrastructure yourself.

| Scenario                                                                        | Recommended product                                     |
| ------------------------------------------------------------------------------- | ------------------------------------------------------- |
| Need data from a popular site with zero setup                                   | [Datasets Marketplace](/datasets/marketplace)           |
| Need a scraper built and maintained by Bright Data                              | [Managed Services](/datasets/scrapers/managed-services) |
| Need to build a custom scraper using AI or code on Bright Data's infrastructure | Scraper Studio                                          |

## AI Agent vs. IDE: Key trade-offs

|               | AI Agent                                   | IDE                                 |
| ------------- | ------------------------------------------ | ----------------------------------- |
| Setup time    | Minutes, describe and run                  | Longer, write, test, debug          |
| Code control  | AI writes the code                         | You own every line                  |
| Customization | Via Self-healing tool prompts              | Direct JavaScript editing           |
| Best for      | Fast scraper creation, non-technical users | Complex logic, multi-stage scrapers |

## Frequently asked questions

<AccordionGroup>
  <Accordion title="Should I use AI Agent or IDE mode?">
    Use AI Agent if you want to get started fast or you're not a developer. Use Bright Data IDE mode if you need full control over scraper logic or are building complex, multi-stage scrapers.
  </Accordion>

  <Accordion title="Can I switch between AI Agent and IDE?">
    Yes. Any scraper created in AI Agent mode can be opened and edited in the IDE. You can also use the [Self-Healing Tool](/datasets/scraper-studio/self-healing-tool) to update scrapers using plain language prompts.
  </Accordion>

  <Accordion title="What's the difference between Scraper Studio and Scrapers Library?">
    [Scrapers Library](https://brightdata.com/products/web-scraper) contains pre-built scrapers for popular sites. Bright Data Scraper Studio is for building custom scrapers from scratch when your target site isn't in the library.
  </Accordion>

  <Accordion title="Do I need to manage proxies or servers?">
    No. Bright Data Scraper Studio handles all proxy management and infrastructure automatically.
  </Accordion>
</AccordionGroup>

## Next steps

<CardGroup>
  <Card title="Build with AI Agent" icon="robot" href="/datasets/scraper-studio/ai-agent">
    Build your first scraper using plain language prompts
  </Card>

  <Card title="Explore the IDE" icon="code" href="/datasets/scraper-studio/scraper-studio-ide-interface">
    Get to know the browser-based code editor
  </Card>

  <Card title="Worker types" icon="server" href="/datasets/scraper-studio/worker-types">
    Understand how Scraper Studio runs your jobs
  </Card>
</CardGroup>

## Where to learn more

<CardGroup>
  <Card title="Scraper Studio Specifications" icon="file-lines" href="/datasets/scraper-studio/specifications">
    View infrastructure limits, billing model, and data retention rules
  </Card>
</CardGroup>


# Scraper Studio
Source: https://docs.brightdata.com/datasets/scraper-studio/overview

Build custom web scrapers with Bright Data Scraper Studio: AI Agent, JavaScript IDE or CLI, running on Bright Data's proxy and unblocking infrastructure.

<div>
  <div>
    <div>
      <div>
        <span>Scraper Studio</span>

        <h1>Build a custom scraper for any website</h1>

        <p>
          No pre-built scraper for your target site? Describe the data you want and build one on Bright Data's proxy and unblocking infrastructure. No servers, proxy rotation or retry logic to manage.
        </p>

        <div>
          <a href="/datasets/scraper-studio/quickstart">Start building</a>
        </div>
      </div>

      <div>
        <img alt="Bright Data Scraper Studio hero illustration" />
      </div>
    </div>

    <div>
      <span>💡</span>
      <span>Prefer no code? Describe your target in plain language and let the <a href="/datasets/scraper-studio/ai-agent">AI Agent</a> generate the scraper from your dashboard.</span>
    </div>

    ## Create a scraper from your terminal

    Install the Bright Data CLI, log in, then pass a target URL and one sentence describing the data you want. Bright Data's AI Agent generates the output schema, writes the scraper code and returns a Collector ID.

    ```bash theme={null}
    npm install -g @brightdata/cli
    bdata login
    bdata scraper create https://news.ycombinator.com \
      "Extract top stories: title, url, points, author, comment count"
    ```

    The same scraper opens in the AI Agent or the IDE for edits, and runs unchanged inside the embedded terminal of any coding agent like Claude Code, Cursor or Codex. See the full walkthrough in [Build a scraper with the Bright Data CLI](/datasets/scraper-studio/build-with-the-cli).

    ## Which way to build

    <CardGroup>
      <Card title="AI Agent" icon="robot" href="/datasets/scraper-studio/ai-agent">
        Describe the data in plain language. Bright Data AI generates the schema and writes the scraper code. No-code, fastest to a working scraper.
      </Card>

      <Card title="IDE" icon="code" href="/datasets/scraper-studio/scraper-studio-ide-interface">
        Write and debug JavaScript in a browser-based editor. Full control over interaction and parsing logic.
      </Card>

      <Card title="Bright Data CLI" icon="terminal" href="/datasets/scraper-studio/build-with-the-cli">
        Create, run and self-heal scrapers from your terminal or any coding agent. **New.**
      </Card>
    </CardGroup>

    Every scraper produces the same output regardless of how you build it. A scraper started in the AI Agent can be opened and edited in the IDE at any time, so you are never locked into one approach.

    ## How it works

    Every Bright Data Scraper Studio scraper performs two core operations, then keeps itself running as the target site changes.

    <CardGroup>
      <Card title="Interaction" icon="arrow-pointer">
        Navigate to a target URL, handle pagination, click elements or send HTTP requests.
      </Card>

      <Card title="Parsing" icon="brackets-curly">
        Read the page HTML and extract structured fields into a defined schema: JSON, CSV, NDJSON or XLSX.
      </Card>

      <Card title="Self-healing" icon="wand-magic-sparkles" href="/datasets/scraper-studio/self-healing-tool">
        When a site layout changes and a scraper breaks, update it with a plain-language prompt instead of rewriting selectors.
      </Card>
    </CardGroup>

    <iframe title="Scrape ANY website - Scraper Studio by Bright Data" />

    ## When to use Scraper Studio

    Use Bright Data Scraper Studio when the data you need is not in the [Scraper library](https://brightdata.com/cp/scrapers/browse), you want ownership of the scraper logic and you do not want to manage proxies or infrastructure yourself. For the full comparison and the AI Agent vs IDE trade-offs, see [Understanding Scraper Studio](/datasets/scraper-studio/introduction).

    <CardGroup>
      <Card title="Pre-built scrapers" icon="layer-group" href="/datasets/scrapers/overview">
        Need a popular site with zero setup? Use the 1000+ pre-built scrapers in the Web Scraper API library instead.
      </Card>

      <Card title="Managed services" icon="screwdriver-wrench" href="/datasets/scrapers/managed-services">
        Want a scraper built and operated for you? Bright Data's team builds custom scrapers for your targets. **No code required.**
      </Card>

      <Card title="Datasets marketplace" icon="store" href="/datasets/marketplace">
        Skip scraping entirely. Buy ready-made datasets refreshed on a schedule. **No code required.**
      </Card>
    </CardGroup>

    ## What you can build

    <CardGroup>
      <Card title="Niche site scraping" icon="globe" href="/datasets/scraper-studio/quickstart">
        Extract structured data from any site without a pre-built scraper, from regional marketplaces to industry directories.
      </Card>

      <Card title="Price monitoring" icon="tag" href="/datasets/scraper-studio/ai-agent">
        Track prices, stock and listings on sites the standard scraper library does not cover.
      </Card>

      <Card title="AI and RAG ingestion" icon="robot" href="/datasets/scraper-studio/build-with-the-cli">
        Turn target pages into clean JSON or NDJSON to feed model training and retrieval pipelines.
      </Card>

      <Card title="Lead generation" icon="user-magnifying-glass" href="/datasets/scraper-studio/ai-agent">
        Pull contacts and company data from directories and listings into your sales pipeline.
      </Card>

      <Card title="Content aggregation" icon="newspaper" href="/datasets/scraper-studio/develop-a-scraper">
        Collect articles, listings or reviews from many sources into one structured feed.
      </Card>

      <Card title="Market research" icon="chart-line" href="/datasets/scraper-studio/complete-examples">
        Aggregate competitor activity, catalog data and trends from sites that change often.
      </Card>
    </CardGroup>

    ## Where to learn more

    <CardGroup>
      <Card title="Get started" icon="rocket">
        [Quickstart](/datasets/scraper-studio/quickstart)

        [Build with AI Agent](/datasets/scraper-studio/ai-agent)

        [Build with the CLI](/datasets/scraper-studio/build-with-the-cli)
      </Card>

      <Card title="IDE" icon="code">
        [IDE interface](/datasets/scraper-studio/scraper-studio-ide-interface)

        [Develop a scraper](/datasets/scraper-studio/develop-a-scraper)

        [Functions reference](/datasets/scraper-studio/functions)
      </Card>

      <Card title="Operations" icon="gauge-high">
        [Specifications](/datasets/scraper-studio/specifications)

        [Delivery options](/datasets/scraper-studio/initiate-collection-and-delivery-options)

        [Best practices](/datasets/scraper-studio/best-practices)
      </Card>

      <Card title="API basics" icon="code-branch">
        [Scraper Studio API](/api-reference/scraper-studio-api/Trigger_a_scraper_for_batch_collection_method)

        [Worker types](/datasets/scraper-studio/worker-types)

        [FAQs](/datasets/scraper-studio/faqs)
      </Card>
    </CardGroup>
  </div>
</div>


# Bright Data Scraper Studio API quickstart
Source: https://docs.brightdata.com/datasets/scraper-studio/quickstart

Trigger a published Bright Data Scraper Studio collector and download structured JSON in three steps. Copy-paste examples in cURL, Node.js and Python.

This guide sends your first request to the Bright Data Scraper Studio API: trigger a published collector from your own code and get structured JSON back.

<Note>
  **No collector yet?** A collector is the published scraper you trigger here. Build one in minutes, then come back with its Collector ID (`c_...`):

  * **Fastest, from your terminal or coding agent:** [Build a scraper with the Bright Data CLI](/datasets/scraper-studio/build-with-the-cli). Three commands; the AI Agent writes the scraper. Runs as-is inside Claude Code, Cursor or Codex.
  * **No code, in the control panel:** [Build a scraper with the AI Agent](/datasets/scraper-studio/ai-agent).
  * **Full control:** [Build a scraper in the IDE](/datasets/scraper-studio/develop-a-scraper).

  This quickstart picks up once you have a Collector ID.
</Note>

The Bright Data Scraper Studio API is built around two HTTP calls:

1. `POST /dca/trigger`, which queues one or more inputs and returns a snapshot ID.
2. `GET /dca/dataset?id=<snapshot_id>`, which serves the snapshot once it is ready.

<Tip>
  Typical time to first record is about three minutes for a collector with one to ten inputs.
</Tip>

## Prerequisites

* An active [Bright Data account](https://brightdata.com/?hs_signup=1\&utm_source=docs) with a payment method on file
* An **API token** from [Account Settings → API Tokens](https://brightdata.com/cp/setting)
* A **Collector ID** from a scraper you built with the [CLI](/datasets/scraper-studio/build-with-the-cli), [AI Agent](/datasets/scraper-studio/ai-agent) or [IDE](/datasets/scraper-studio/develop-a-scraper); the ID starts with `c_`

Set both values as environment variables once and reuse them across every snippet below:

```bash theme={null}
export BRIGHT_DATA_API_TOKEN="your_api_token_here"
export BRIGHT_DATA_COLLECTOR_ID="c_xxxxxxxxxxxxxxxx"
```

## Make your first request

<Steps>
  <Step title="Authenticate every call">
    Every Bright Data Scraper Studio API call uses bearer-token authentication. Add this header to every request:

    ```http theme={null}
    Authorization: Bearer YOUR_BRIGHT_DATA_API_TOKEN
    ```

    A missing or invalid token returns `401 Unauthorized`.
  </Step>

  <Step title="Trigger your collector">
    Send the inputs you want the collector to process as a JSON array in the request body. Each object in the array must match the input schema you defined when you built the collector. The default schema is a single `url` field.

    <CodeGroup>
      ```bash cURL theme={null}
      curl -X POST \
        "https://api.brightdata.com/dca/trigger?collector=$BRIGHT_DATA_COLLECTOR_ID&queue_next=1" \
        -H "Authorization: Bearer $BRIGHT_DATA_API_TOKEN" \
        -H "Content-Type: application/json" \
        -d '[
          {"url": "https://ecommerce-shop-brd.vercel.app/product/echo-portable-speaker"},
          {"url": "https://ecommerce-shop-brd.vercel.app/product/nimbus-cloud-storage"}
        ]'
      ```

      ```python Python theme={null}
      import os
      import requests

      API_TOKEN    = os.environ["BRIGHT_DATA_API_TOKEN"]
      COLLECTOR_ID = os.environ["BRIGHT_DATA_COLLECTOR_ID"]

      response = requests.post(
          f"https://api.brightdata.com/dca/trigger?collector={COLLECTOR_ID}&queue_next=1",
          headers={
              "Authorization": f"Bearer {API_TOKEN}",
              "Content-Type": "application/json",
          },
          json=[
              {"url": "https://ecommerce-shop-brd.vercel.app/product/echo-portable-speaker"},
              {"url": "https://ecommerce-shop-brd.vercel.app/product/nimbus-cloud-storage"},
          ],
      )
      response.raise_for_status()
      snapshot_id = response.json()["collection_id"]
      print(snapshot_id)  # j_abc123def456
      ```

      ```js Node.js theme={null}
      const triggerUrl =
        `https://api.brightdata.com/dca/trigger` +
        `?collector=${process.env.BRIGHT_DATA_COLLECTOR_ID}&queue_next=1`;

      const response = await fetch(triggerUrl, {
        method: "POST",
        headers: {
          Authorization: `Bearer ${process.env.BRIGHT_DATA_API_TOKEN}`,
          "Content-Type": "application/json",
        },
        body: JSON.stringify([
          { url: "https://ecommerce-shop-brd.vercel.app/product/echo-portable-speaker" },
          { url: "https://ecommerce-shop-brd.vercel.app/product/nimbus-cloud-storage" },
        ]),
      });

      const { collection_id: snapshotId } = await response.json();
      console.log(snapshotId); // j_abc123def456
      ```
    </CodeGroup>

    The Bright Data Scraper Studio API responds with a single snapshot ID:

    ```json theme={null}
    {
      "collection_id": "j_abc123def456"
    }
    ```

    Keep this ID. You will use it as the `snapshot_id` in step 3.

    <Note>
      `queue_next=1` runs your inputs immediately. Omit it (or set `0`) to enqueue them behind any in-flight work for the same collector.
    </Note>
  </Step>

  <Step title="Poll until ready, then download">
    The same `/dca/dataset` endpoint serves both the in-progress and ready responses. Poll it every five seconds until the response is a JSON array.

    <CodeGroup>
      ```bash cURL theme={null}
      # Poll every 5 seconds until the response is a JSON array (not an object).
      while :; do
        response=$(curl -s \
          "https://api.brightdata.com/dca/dataset?id=$SNAPSHOT_ID" \
          -H "Authorization: Bearer $BRIGHT_DATA_API_TOKEN")
        if [[ "${response:0:1}" == "[" ]]; then
          echo "$response" > results.json
          break
        fi
        sleep 5
      done
      ```

      ```python Python theme={null}
      import json
      import time

      while True:
          response = requests.get(
              f"https://api.brightdata.com/dca/dataset?id={snapshot_id}",
              headers={"Authorization": f"Bearer {API_TOKEN}"},
          )
          response.raise_for_status()
          body = response.json()
          if isinstance(body, list) and body:
              with open("results.json", "w") as f:
                  json.dump(body, f, indent=2)
              break
          time.sleep(5)
      ```

      ```js Node.js theme={null}
      const datasetUrl =
        `https://api.brightdata.com/dca/dataset?id=${snapshotId}`;

      while (true) {
        const response = await fetch(datasetUrl, {
          headers: { Authorization: `Bearer ${process.env.BRIGHT_DATA_API_TOKEN}` },
        });
        const body = await response.json();
        if (Array.isArray(body) && body.length > 0) {
          await fs.writeFile("results.json", JSON.stringify(body, null, 2));
          break;
        }
        await new Promise((r) => setTimeout(r, 5000));
      }
      ```
    </CodeGroup>

    While the snapshot is building, the response is a status object:

    ```json theme={null}
    { "status": "building" }
    ```

    When the snapshot is ready, the response is a JSON array. One row per successful input by default:

    ```json theme={null}
    [
      {
        "url": "https://ecommerce-shop-brd.vercel.app/product/echo-portable-speaker",
        "title": "Echo Portable Speaker",
        "price": 49.99,
        "availability": "in stock",
        "input": { "url": "https://ecommerce-shop-brd.vercel.app/product/echo-portable-speaker" }
      },
      {
        "url": "https://ecommerce-shop-brd.vercel.app/product/nimbus-cloud-storage",
        "title": "Nimbus Cloud Storage",
        "price": 12.99,
        "availability": "in stock",
        "input": { "url": "https://ecommerce-shop-brd.vercel.app/product/nimbus-cloud-storage" }
      }
    ]
    ```

    The exact field set depends on the output schema you defined when you built the collector.
  </Step>
</Steps>

## How long does this take?

The first record usually arrives within a minute, but total time depends on the collector and the target site. Measured against a typical e-commerce product page collector:

| Input count    | Typical wall-clock time                                                                                                        |
| -------------- | ------------------------------------------------------------------------------------------------------------------------------ |
| 1 to 10 URLs   | 30 to 90 seconds                                                                                                               |
| 11 to 100 URLs | 2 to 5 minutes                                                                                                                 |
| 100+ URLs      | 5+ minutes. Use [push delivery](/api-reference/scraper-studio-api/Choose_a_delivery_type_on_request_level) instead of polling. |

For long-running jobs, swap polling for a [push delivery destination](/api-reference/scraper-studio-api/Choose_a_delivery_type_on_request_level) (webhook, S3, GCS, Azure, SFTP or email) so Bright Data calls you when the snapshot is ready.

## What do the IDs mean?

Three identifiers appear in Bright Data Scraper Studio. They are easy to confuse because the trigger response uses one name for a value that another endpoint reads under a different name.

| Term                                            | Looks like           | What it identifies                                                                                                                                                     |
| ----------------------------------------------- | -------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Collector ID**                                | `c_xxxxxxxxxxxxxxxx` | The published scraper definition. Stable. You pass it as the `collector` query parameter on `/dca/trigger`.                                                            |
| **Collection ID** (returned as `collection_id`) | `j_xxxxxxxxxxxxxxxx` | One run of the collector. The trigger response field is `collection_id`, but every other endpoint refers to the same value as `snapshot_id`. They are the same string. |
| **Dataset**                                     | a JSON array         | The result rows produced by one run. The `/dca/dataset` endpoint returns this when the run is finished.                                                                |

<Tip>
  Treat `collection_id` from the trigger response as your `snapshot_id` everywhere else. They are the same value under two names.
</Tip>

## What errors might I see?

| Status                     | Meaning                                                                    | Fix                                                                                                                                 |
| -------------------------- | -------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------- |
| `401 Unauthorized`         | Token missing, malformed or revoked                                        | Re-copy from [Account Settings → API Tokens](https://brightdata.com/cp/setting)                                                     |
| `404 Not Found`            | Collector ID does not exist or your account does not have access           | Open the collector in [Scraper Studio](https://brightdata.com/cp/scrapers) and re-copy the ID                                       |
| `422 Unprocessable Entity` | The objects in your request body do not match the collector's input schema | Confirm field names against the **Inputs** tab of your collector                                                                    |
| `5xx`                      | Transient Bright Data API error                                            | Retry with exponential backoff, for example 1s, 2s, 4s                                                                              |
| `[]` (empty array)         | Snapshot has no rows, or the snapshot expired                              | Batch results are retained for 16 days, real-time results for 7 days. See [Specifications](/datasets/scraper-studio/specifications) |

## Use a production-grade starter template

These open-source repositories are exactly the calls above, hardened with environment-variable config, retry/backoff for transient failures, library helpers and a complete `README`. Fork either and you have a runnable client in 30 seconds.

<CardGroup>
  <Card title="Node.js starter" icon="node-js" href="https://github.com/brightdata/bright-data-scraper-studio-nodejs-project">
    Node 18+, ES modules, dotenv, retry/backoff, \~150 LOC
  </Card>

  <Card title="Python starter" icon="python" href="https://github.com/brightdata/bright-data-scraper-studio-python-project">
    Python 3.8+, `requests`, `python-dotenv`, retry/backoff, \~150 LOC
  </Card>
</CardGroup>

Both repositories ship with a CodeSandbox devcontainer so you can fork and run in your browser without any local setup.

## Next steps

<CardGroup>
  <Card title="Choose a delivery type" icon="paper-plane" href="/api-reference/scraper-studio-api/Choose_a_delivery_type_on_request_level">
    Skip polling. Have Bright Data push results to a webhook, S3, GCS or email when the snapshot is ready.
  </Card>

  <Card title="Trigger a batch collection" icon="layer-group" href="/api-reference/scraper-studio-api/Trigger_a_scraper_for_batch_collection_method">
    Send hundreds or thousands of inputs in a single request and receive results in batches.
  </Card>

  <Card title="Run a synchronous real-time job" icon="bolt" href="/api-reference/scraper-studio-api/initiate-a-realtime-job/sync-realtime-job">
    For low-input, latency-sensitive workloads. Trigger and receive results in a single HTTP call.
  </Card>

  <Card title="Build a new collector" icon="screwdriver-wrench" href="/datasets/scraper-studio/build-with-the-cli">
    Need a collector that does not exist yet? Build one with the CLI, the AI Agent or the IDE.
  </Card>
</CardGroup>

## Frequently asked questions

<AccordionGroup>
  <Accordion title="How do I create the collector in the first place?">
    Build a Scraper Studio scraper with any of three paths, then use the Collector ID (`c_...`) it returns here:

    * **[Bright Data CLI](/datasets/scraper-studio/build-with-the-cli)** is the fastest. Run `bdata scraper create <url> "<what to extract>"` and the AI Agent writes the scraper. The CLI runs as-is inside Claude Code, Cursor or Codex.
    * **[AI Agent](/datasets/scraper-studio/ai-agent)** builds the scraper from a natural-language prompt in the control panel, no code required.
    * **[IDE](/datasets/scraper-studio/develop-a-scraper)** gives you full control over the scraper code.
  </Accordion>

  <Accordion title="What is the difference between the Collection API and the AI Flow API?">
    The **Collection API** (`/dca/*`, this page) runs an existing collector to **get data**.
    The **[AI Flow API](/api-reference/scraper-studio-api/ai-flow/overview)** runs the AI Agent to **create or self-heal** a collector.
    Most developers integrating Bright Data Scraper Studio into a product use the Collection API.
  </Accordion>

  <Accordion title="Can I send different input shapes in the same request?">
    Yes, as long as every object in the array conforms to the collector's input schema. If your collector accepts both `url` and `keyword` as input fields, you can mix them in one request. Fields you do not include are treated as `null`.
  </Accordion>

  <Accordion title="How do I retry failed inputs without re-running the successful ones?">
    Open the snapshot in [My Scrapers](https://brightdata.com/cp/scrapers) and click **Last errors** to see which inputs failed and why. Re-trigger just those inputs in a new `POST /dca/trigger` call.
  </Accordion>

  <Accordion title="Is there a rate limit?">
    Yes. Per-account concurrency limits apply per collector. See [Specifications](/datasets/scraper-studio/specifications) for current limits. The starter templates linked above already implement exponential backoff for transient `5xx` responses.
  </Accordion>
</AccordionGroup>


# Scraper Studio IDE interface reference
Source: https://docs.brightdata.com/datasets/scraper-studio/scraper-studio-ide-interface

Reference for the Bright Data Scraper Studio JavaScript IDE: templates, stages, debug tabs, input controls, 2 worker settings and the Self-Healing tool.

The Bright Data Scraper Studio IDE is the browser-based JavaScript editor where you write, test, and debug custom scrapers. This page is a reference for every panel, control, and dashboard action you see in the IDE, with links to the guides that show each feature in use.

## What the IDE panel contains

The IDE panel is where you write and test your scraper code. Each labeled component below corresponds to a section of the IDE interface.

<Frame>
  <img alt="Light mode interface" />

  <img alt="Light mode interface" />
</Frame>

### A - Templates

A library of pre-built scraper code created by Bright Data's engineers, covering common websites and scraping patterns. Templates are starting points and may require adjustments if a target website's structure has changed.

### B - Stages

Stages allow a scraper to operate across multiple steps in sequence. Each stage receives input from the previous one via next\_stage() or run\_stage(). Use stages when scraping requires navigating across multiple page types - for example, collecting URLs from a listing page, then extracting details from each URL.

> See [Scraper Studio functions](/datasets/scraper-studio/functions) for the full command reference.

### C - Functions reference

An in-IDE reference panel listing all available scraping functions with descriptions and usage examples.

> See [Interaction functions](/datasets/scraper-studio/functions#interaction-functions) and [Parser functions](/datasets/scraper-studio/functions#parser-functions).

### D - Debugging tabs

| Tab                 | Description                                                                                                                                                            |
| ------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Input**           | Define input parameters and select an input set to run a preview test                                                                                                  |
| **Output**          | Structured data returned by the scraper after a preview run                                                                                                            |
| **Children**        | Input sets passed to the next stage in a multi-stage scraper                                                                                                           |
| **Run log**         | Full code execution log for the most recent preview                                                                                                                    |
| **Browser network** | Browser-level network activity log (equivalent to DevTools > Network tab)                                                                                              |
| **Last errors**     | The most recent error messages, including error codes and affected inputs (last 1,000 stored)                                                                          |
| **Crawl inspector** | All pages crawled during a batch job, including successes and failures. For multi-stage scrapers, use **Search for children** to view pages generated from each parent |
| **Output schema**   | Field names and data types for the scraper's output. Click **Edit Schema** to modify input or output schema                                                            |

### Preview output modes

When you run a preview, the Output tab can show results in two modes:

**Raw output** - shows the records exactly as they were collected by the scraper code, before schema formatting or processing is applied.

**Formatted output** - shows the records after they are processed according to the output schema, including field types, formatting rules, default values, validation, and other schema settings.

Use Raw output when debugging parser code or checking what collect() returned.

Use Formatted output when verifying the final structure that will be delivered in production runs.

For example, a price field may appear as raw text in Raw output, but as a structured price object or formatted value in Formatted output, depending on the output schema configuration.

### E - Input

| Control                 | Description                                   |
| ----------------------- | --------------------------------------------- |
| **Add input parameter** | Define a new input parameter by name and type |
| **New input**           | Add a value to an input set for testing       |
| **Preview**             | Run the scraper against a selected input set  |

### F - Settings

| Setting              | Description                                                                                    |
| -------------------- | ---------------------------------------------------------------------------------------------- |
| **Worker**           | Select Browser Worker or Code Worker for this scraper                                          |
| **Error mode**       | Define scraper behavior when an error occurs                                                   |
| **Take screenshot**  | Capture screenshots of loaded pages during preview runs                                        |
| **Worker per stage** | Assign a different worker type to each stage instead of using one worker for the whole scraper |

> See [Worker types](/datasets/scraper-studio/worker-types) for guidance on choosing between Browser worker and Code worker.

### G - Self-Healing Tool

AI-powered code refactor. Accepts plain-language prompts to fix errors or modify input/output fields without manual code editing.

> See [Self-Healing tool](/datasets/scraper-studio/self-healing-tool).

### H - Preview

**Preview** runs the scraper code against the input selected in the **Input** tab at the bottom-left of the IDE. Use it to test your interaction and parser logic before saving the scraper to production. Preview results appear in the **Output** debugging tab.

Scraper Studio provides two preview modes:

* **Preview (browser)**, runs the scraper in an interactive browser view. Use this mode to inspect page behavior, clicks, scrolling, JavaScript rendering, and browser-only interactions.
* **HTML**, shows the loaded page HTML or response content used by the parser. Use this mode to debug selectors, parser logic, and extracted fields.

## Scraper Dashboard Menu

The Dashboard lists all your scrapers under **My Scrapers**. Each scraper has an action menu with the following options:

| Action                   | Description                                                                                                                                                |
| ------------------------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Initiate manually**    | Start a collection run directly from the UI. See [Initiate manually](/datasets/scraper-studio/initiate-collection-and-delivery-options#initiate-manually). |
| **Initiate by API**      | Trigger a collection programmatically via API. See [Initiate via API](/api-reference/scraper-studio-api/Trigger_a_scraper_for_batch_collection_method)     |
| **Run on schedule**      | Configure a recurring collection - daily, weekly, or at a custom interval                                                                                  |
| **Delivery preferences** | Set the output format and delivery destination for completed jobs                                                                                          |
| **Code**                 | Open and edit the scraper in the IDE                                                                                                                       |
| **Report an issue**      | Submit a report for platform, scraper, or data quality issues                                                                                              |


# Fix scrapers with the Self-Healing tool
Source: https://docs.brightdata.com/datasets/scraper-studio/self-healing-tool

Use the Bright Data Scraper Studio Self-Healing tool to fix broken scrapers and add or remove output fields from plain-language prompts in 1 click.

The Self-Healing tool is an AI-powered code refactor assistant in Bright Data Scraper Studio that rewrites parts of a scraper from a plain-language prompt. Use it when a target site changes and your scraper stops returning the expected data, or when you need to add or remove output fields without editing the JavaScript by hand.

<Tip>
  **When to use it:** the scraper stops returning expected data, the price or title field returns `undefined`, or you need to add new fields (`price`, `image`, `rating`) without writing code.
</Tip>

## Prerequisites

* An active [Bright Data account](https://brightdata.com/)
* An existing scraper in Bright Data Scraper Studio (saved in development mode)
* Access to the Scraper Studio IDE

## How do I fix a scraper with the Self-Healing tool?

<Steps>
  <Step title="Open the Self-Healing tool">
    In the Bright Data Scraper Studio IDE, open the scraper you want to fix and locate the Self-Healing tool panel.

    <Frame>
      <img alt="Self-Healing tool location in the Scraper Studio IDE" />
    </Frame>

    > **Expected result:** a text input field appears, ready to accept your instruction.

    <Frame>
      <img alt="Refactor collector panel" />
    </Frame>
  </Step>

  <Step title="Describe the fix or change you need">
    Type your request in plain language. Be specific about what is broken and which fields are affected.

    ```txt Example prompts theme={null}
    Add 'price' and 'image' fields to the output

    The 'price' value is returning 'undefined', please fix

    The 'price' field is returning incorrect data from HTML, switch to using tag_response() to capture '/api/price' instead
    ```

    > **Expected result:** the AI processes your prompt and produces a code diff in the editor.

    <Note>
      Refactoring can take up to 15 minutes. You do not need to stay on the page: Bright Data sends an email when the diff is ready, and you can review it at your convenience.

      <Frame>
        <img alt="Email notification when refactoring is complete" />
      </Frame>
    </Note>
  </Step>

  <Step title="Review the proposed changes">
    Examine the AI-generated diff in the code template. Verify it matches your intent before accepting.

    * **Accept:** saves the changes to a draft
    * **Decline:** discards the suggestion; your original code remains unchanged

    > **Expected result:** if accepted, the editor shows the updated code and saves it to the draft.
  </Step>

  <Step title="Run a preview">
    After accepting, run a preview to confirm the scraper returns the expected data.

    <Frame>
      <img alt="Run a preview button in the IDE" />
    </Frame>

    > **Expected result:** the output file contains the new or fixed fields with valid, non-undefined values.

    <Frame>
      <img alt="View and download preview results" />
    </Frame>
  </Step>

  <Step title="Save to production">
    Once the preview looks correct, save the scraper to production.

    <Frame>
      <img alt="Save to production button" />
    </Frame>

    <Note>
      If you added or renamed fields, Bright Data Scraper Studio prompts you to update the output schema. Click **Update Schema**, then **Save to Production**.

      <Frame>
        <img alt="Update schema prompt" />
      </Frame>
    </Note>

    > **Expected result:** the refactored scraper is live and collecting data with the new configuration.
  </Step>
</Steps>

## Troubleshooting

| Problem                                    | Likely cause                   | Resolution                                                                             |
| ------------------------------------------ | ------------------------------ | -------------------------------------------------------------------------------------- |
| AI-generated code does not fix the issue   | Prompt was too vague           | Re-prompt with specific field names and an example error message                       |
| Preview still returns undefined values     | Target site structure changed  | Inspect the live page and include the expected HTML element or selector in your prompt |
| Changes do not appear after accepting      | Browser cache issue            | Refresh the IDE and re-check the development mode draft                                |
| The refactor runs for more than 15 minutes | Complex change or heavy prompt | Break the request into smaller prompts (one field at a time)                           |

## Frequently asked questions

<AccordionGroup>
  <Accordion title="Does the Self-Healing tool work on every scraper?">
    Yes. The Self-Healing tool works on any scraper saved in development mode in Bright Data Scraper Studio, regardless of whether the scraper was built by the AI Agent, from a template, or written from scratch in the IDE.
  </Accordion>

  <Accordion title="Can I undo a Self-Healing change?">
    Yes. Accepted changes go to a draft first; they only affect production after you click **Save to Production**. If you already saved to production, open the **Versions** menu on the scraper dashboard to roll back to an earlier version.
  </Accordion>

  <Accordion title="What happens if I change the output schema?">
    The Self-Healing tool can add or remove fields, but you must confirm the schema change before saving to production. Bright Data Scraper Studio prompts you with **Update Schema** when the new output no longer matches the current schema.
  </Accordion>
</AccordionGroup>

## Related

<CardGroup>
  <Card title="Scraper Studio AI Agent" icon="robot" href="/datasets/scraper-studio/ai-agent">
    Build a new scraper from natural-language prompts
  </Card>

  <Card title="Develop a scraper" icon="wrench" href="/datasets/scraper-studio/develop-a-scraper">
    Build and edit scrapers directly in the IDE
  </Card>
</CardGroup>


# Scraper Studio specifications
Source: https://docs.brightdata.com/datasets/scraper-studio/specifications

Bright Data Scraper Studio infrastructure limits, billing model (CPM + per-GB downloads) and data retention windows for batch and real-time snapshots in 2024.

This reference covers Bright Data Scraper Studio's infrastructure limits, billing model, and data retention rules for batch and real-time collections.

## Billing

Bright Data Scraper Studio billing is based on page loads and file downloads.

| Item           | Unit                   | Rate                                                                  |
| -------------- | ---------------------- | --------------------------------------------------------------------- |
| Page loads     | CPM (1,000 page loads) | See [Pricing page](https://brightdata.com/pricing/web-scraper/custom) |
| File downloads | Per GB                 | Billed separately from page loads                                     |

**What counts as a page load:** One URL request processed by Bright Data Scraper Studio infrastructure, regardless of response size.

<Note>
  File downloads are billed at a separate per-GB rate and do not count toward CPM. Check your [Billing dashboard](https://brightdata.com/cp/billing/overview) for current rates.
</Note>

## Infrastructure limits

| Item                                               | Limit                         | Behavior when exceeded                                          |
| -------------------------------------------------- | ----------------------------- | --------------------------------------------------------------- |
| Parallel batch jobs                                | 100 simultaneous              | Additional jobs queue automatically                             |
| Job queue size                                     | Unlimited                     | Jobs run as capacity becomes available                          |
| `/trigger_immediate` real-time collection requests | 50K requests/min per customer | Requests above the limit return a `429 Too Many Requests` error |

## Data retention

| Data type                | Retention period | Behavior after expiry |
| ------------------------ | ---------------- | --------------------- |
| Batch collection results | 16 days          | Permanently deleted   |
| Real-time results        | 7 days           | Permanently deleted   |

<Warning>
  Export your data before the retention period expires. Bright Data does not recover expired data.
</Warning>

## Frequently asked questions

<AccordionGroup>
  <Accordion title="What happens when I exceed 100 parallel jobs?">
    Additional jobs queue automatically. No jobs are dropped or cancelled. Jobs run in the order they were submitted as capacity becomes available.
  </Accordion>

  <Accordion title="What happens to my data after the retention period?">
    Data is permanently deleted after 16 days (batch) or 7 days (real-time). Bright Data does not recover expired data. Export your results before expiry.
  </Accordion>

  <Accordion title="Are file downloads included in my CPM billing?">
    No. File downloads are billed separately at a per-GB rate. CPM covers page loads only. Both charges appear in your [Billing dashboard](https://brightdata.com/cp/billing/overview).
  </Accordion>

  <Accordion title="What counts as a page load?">
    One page load equals one URL request processed by Bright Data Scraper Studio infrastructure, regardless of page size or response content.
  </Accordion>

  <Accordion title="What is the difference between page loads and records?">
    A page load is a URL request processed by Bright Data infrastructure. In Scraper Studio, actions such as `navigate()`, `request()`, or `load_more()` can generate page loads. Page loads are used for usage and billing calculations, and are billed in CPM units, meaning per 1,000 page loads.

    A record is a structured data item extracted from the loaded page or request response. For example, if one product listing page is loaded and the scraper extracts 20 products from it, that counts as 1 page load and 20 records.

    Page loads and records are not always the same. One page load can produce zero, one, or many records, depending on the website structure and scraper logic. In Scraper Studio, billing is based on page loads by default, while records represent the amount of data returned.
  </Accordion>
</AccordionGroup>

## Related

<CardGroup>
  <Card title="Understanding Scraper Studio" icon="book-open" href="/datasets/scraper-studio/introduction">
    Understand how Scraper Studio works and when to use it
  </Card>

  <Card title="Pricing & Billing" icon="credit-card" href="https://brightdata.com/cp/billing/overview">
    Full billing details for all Bright Data products
  </Card>
</CardGroup>


# Scraper Studio video tutorials
Source: https://docs.brightdata.com/datasets/scraper-studio/videos

Watch 8 Bright Data Scraper Studio video tutorials: building search scrapers, handling pagination, using templates, debugging and scraping dynamic sites.

This page is an index of video tutorials for Bright Data Scraper Studio. Each video pairs with a written guide in the docs. Pick the topic that matches what you are building and jump straight in.

## How to get started

### Introduction to Bright Data Scraper Studio

A guided tour of the Bright Data Scraper Studio IDE: templates, proxy networks, and how to build multiple scrapers in one flow. Start here if you have never built a scraper on Bright Data before.

<iframe title="Introduction to Bright Data Web Scraper IDE" />

**Pair with:** [Understanding Scraper Studio](/datasets/scraper-studio/introduction)

### Platform overview: project setup, proxies, and automation

A walkthrough of essential Bright Data Scraper Studio features: project setup, proxy creation and management, and scheduling automated collection runs.

<iframe title="Industrial-scale web scraping with AI and proxy networks" />

**Pair with:** [Scraper Studio IDE interface](/datasets/scraper-studio/scraper-studio-ide-interface)

## How to build scrapers

### Scrape data from Amazon search results

How to scrape Amazon search results, build a scraper that walks paginated results, and rely on the Bright Data proxy network to avoid blocks.

<iframe title="Scrape Amazon search results" />

**Pair with:** [Develop a scraper](/datasets/scraper-studio/develop-a-scraper)

### Walk search results with `for` loops

How to use a `for` loop to navigate hundreds of result pages, extract links to each listing, and collect data with `parse()` and `collect()`. Covers proxy manager setup, basic templates, input targeting, running and testing code, and reading logs.

<iframe title="Walk search results with for loops" />

**Pair with:** [Web scraping basics](/datasets/scraper-studio/basics-of-web-scraping)

### Use templates and deploy multiple scrapers

How to start from an IDE template, build a Walmart scraper, deploy it to the proxy network, and collect the data into a single API response.

<iframe title="Use IDE templates and proxy networks" />

**Pair with:** [Scraper Studio functions](/datasets/scraper-studio/functions)

### Build a Python scraper end-to-end

Building a Python project that uses Bright Data Scraper Studio templates, modifies the code, previews results, configures delivery, and retrieves data via API.

<iframe title="Build a Python scraper end-to-end" />

**Pair with:** [Initiate collection and delivery](/datasets/scraper-studio/initiate-collection-and-delivery-options)

## Handling challenging sites

### Scrape dynamic sites with utility functions

How to scrape a heavily dynamic site with Bright Data's browser helpers: waiting for grids to render, looping over grid cells, and using `next_stage()` to fan out detail collection.

<iframe title="Scrape dynamic sites with utility functions" />

**Pair with:** [Best practices](/datasets/scraper-studio/best-practices)

### Automate Airbnb with a Python scraper

How to customize a Bright Data Scraper Studio template to scrape Airbnb, plus the API flow for triggering the scraper and retrieving results.

<iframe title="Automate Airbnb with Python" />

**Pair with:** [Scraper Studio AI Agent](/datasets/scraper-studio/ai-agent)

## Debugging and delivery

### Debug a scraper and configure delivery

How to debug a scraper in the IDE, read the run log and errors, and choose a delivery method (API endpoint or Amazon S3).

<iframe title="Debug a scraper and configure delivery" />

**Pair with:** [Scraper Studio IDE interface](/datasets/scraper-studio/scraper-studio-ide-interface)

### End-to-end data engineering with Tableau

A longer walkthrough: proxy manager, API integrations, building a scraper from a template, using input for products or categories, running code, and reading logs for debugging.

<iframe title="End-to-end data engineering project" />

**Pair with:** [Features reference](/datasets/scraper-studio/features)

## Related

<CardGroup>
  <Card title="Understanding Scraper Studio" icon="book-open" href="/datasets/scraper-studio/introduction">
    How Bright Data Scraper Studio works and when to use it
  </Card>

  <Card title="Develop a scraper" icon="wrench" href="/datasets/scraper-studio/develop-a-scraper">
    Step-by-step walkthrough of building a scraper in the IDE
  </Card>
</CardGroup>


# WARC snapshots in Scraper Studio
Source: https://docs.brightdata.com/datasets/scraper-studio/warc-ide

Enable WARC file output in Bright Data Scraper Studio to archive the full HTTP response captured during a browser-worker scrape, ISO 28500 compliant.

Bright Data Scraper Studio can return a WARC (Web ARChive) file alongside every scraped page, capturing the exact HTTP responses the browser received during the crawl. Use this for digital preservation, audit trails, research reproducibility, or any workflow that requires byte-level evidence of what the site served.

## What is a WARC file?

WARC is an ISO-standard file format (ISO 28500) for storing web crawls and HTTP interactions. A single WARC file contains the raw request and response pairs, headers, timestamps, and payload bytes from every browser-side fetch during page load, HTML, CSS, JavaScript, images, and XHR requests.

<Note>
  WARC snapshots are available only on Browser worker scrapers. Code worker scrapers do not run a browser, so there is no browser-level network traffic to archive.
</Note>

## How do I enable WARC output on a scraper?

<Steps>
  <Step title="Open the scraper in the Bright Data Scraper Studio IDE">
    Go to [brightdata.com/cp](https://brightdata.com/cp/scrapers), select the scraper you want to archive, and click **Edit code** to open it in the IDE.
  </Step>

  <Step title="Enable the warc_snapshot field">
    In the **Output Schema** panel, find the `additional_data` section and click the eye icon next to `warc_snapshot` to turn it on.

    <img alt="WARC snapshot toggle in the output schema panel" />
  </Step>

  <Step title="Save and run a job">
    Save the scraper to production and trigger a run. The WARC file is produced for every page the scraper collects.
  </Step>

  <Step title="Retrieve the WARC files">
    Bright Data delivers the WARC files using whatever delivery method you configured for the scraper: API download, webhook, S3, Google Cloud Storage, Azure, SFTP, or email.

    See [Initiate collection and delivery](/datasets/scraper-studio/initiate-collection-and-delivery-options) for delivery options.
  </Step>
</Steps>

## How do I maximize what the WARC captures?

WARC capture records every request the browser makes during page load, but only while the browser is actively loading the page. To capture more, give the browser time to finish loading before the scraper moves on:

* Call `wait_network_idle()` near the end of the interaction code so the browser drains in-flight XHR and fetch requests before Bright Data Scraper Studio finalizes the WARC file.
* Prefer Browser worker over Code worker. Only browser-worker network traffic is recorded; raw `request()` calls in code-worker scrapers are not.
* If the page lazy-loads media via scroll, call `scroll_to('bottom')` or `load_more()` before `wait_network_idle()` so the browser actually fetches those resources.

## Frequently asked questions

<AccordionGroup>
  <Accordion title="What is recorded inside a Bright Data Scraper Studio WARC file?">
    Every browser-side request and response captured during page load: HTML documents, CSS, JavaScript, images, fonts, XHR, and fetch calls. Each entry includes the request line, headers, and response payload as the browser received them.
  </Accordion>

  <Accordion title="Does WARC output work with Code worker scrapers?">
    No. WARC snapshots require Browser worker because the capture runs at the browser network layer. Code worker scrapers issue raw HTTP requests directly, with no browser to record traffic from.
  </Accordion>

  <Accordion title="How are WARC files delivered and how much do they cost?">
    WARC files are delivered through the scraper's configured delivery method (API download, webhook, cloud storage, SFTP, or email). File downloads are billed per GB, separately from CPM page loads. See [Scraper Studio specifications](/datasets/scraper-studio/specifications) for current rates.
  </Accordion>

  <Accordion title="How long does Bright Data keep WARC snapshots?">
    WARC snapshots follow the scraper's snapshot retention: 16 days for batch collections and 7 days for real-time collections. Export or download the files before the retention window closes. Bright Data does not recover expired data.
  </Accordion>
</AccordionGroup>

## Related

<CardGroup>
  <Card title="Scraper Studio specifications" icon="file-lines" href="/datasets/scraper-studio/specifications">
    Billing model, retention periods and infrastructure limits
  </Card>

  <Card title="Initiate collection and delivery" icon="truck" href="/datasets/scraper-studio/initiate-collection-and-delivery-options">
    Set the delivery destination for WARC files and collected data
  </Card>
</CardGroup>


# Scraper Studio worker types
Source: https://docs.brightdata.com/datasets/scraper-studio/worker-types

Choose between 2 worker types in Bright Data Scraper Studio (Browser worker or Code worker) based on whether your site needs UI interaction or HTTP requests.

Bright Data Scraper Studio runs every scraper on one of two worker types: Browser worker (a real headless browser) or Code worker (raw HTTP requests). Pick the one that matches the minimum level of interaction your target site needs, Code worker is faster and cheaper, so start there and switch only if Code worker cannot reach the data.

## Browser worker vs Code worker

|                             | Browser worker                                                     | Code worker                                          |
| --------------------------- | ------------------------------------------------------------------ | ---------------------------------------------------- |
| Execution model             | Headless browser session                                           | Direct HTTP requests (like `curl` or `requests.get`) |
| Runs JavaScript             | Yes                                                                | No                                                   |
| Clicks, scrolls, form input | Yes                                                                | No                                                   |
| Best for                    | Dynamic pages, SPAs, login flows, infinite scroll, GraphQL capture | Static HTML, sitemap crawls, public JSON APIs        |
| Speed                       | Slower (browser startup, full page load)                           | Faster (single HTTP round trip)                      |
| Cost per page load          | Higher                                                             | Lower                                                |

## Should I assign workers per scraper or per stage?

By default, Bright Data Scraper Studio scrapers run in Worker per scraper mode, where every stage shares one worker type. Worker per stage is available to all users and lets you assign a different worker type to each stage.

### When should I use Worker per scraper?

Use Worker per scraper when every stage needs the same worker type:

* **All stages need a Browser worker.** For example, Stage 1 navigates a search page where clicking or typing triggers the results, and Stage 2 scrolls through a dynamic product listing.
* **All stages need a Code worker.** For example, Stage 1 fetches all available URLs and Stage 2 loads each product page directly over HTTP.

### When should I use Worker per stage?

Use Worker per stage when stages have different interaction requirements:

* **Stage 1 needs a Code worker.** For example, fetching a list of product URLs from a category page.
* **Stage 2 needs a Browser worker.** For example, loading each product page that renders its price and reviews client-side with JavaScript.

Assigning the right worker to each stage avoids starting a full browser session where it is not needed, which reduces runtime.

### How do I configure Worker per stage?

1. Open your scraper in the Bright Data Scraper Studio IDE.
2. In the **Settings** dropdown, turn on **Worker per stage**.
3. For each stage, set the **Worker** to **Browser worker** or **Code worker**.
4. Save your scraper.

If you assign a Code worker to a stage that calls browser-only functions such as `wait`, `click` or `scroll_to`, Bright Data Scraper Studio throws an `Incompatible worker` error:

```text theme={null}
Click function is not supported for worker type = Code. To use it you should change the code settings to worker type = Browser.
```

For the full list of browser-only functions, see [Which functions are Browser worker only?](/datasets/scraper-studio/worker-types#which-functions-are-browser-worker-only)

## When should I use Browser worker?

Use Browser worker when any of the following is true:

* The target data is rendered client-side by JavaScript and is not present in the raw HTML response
* You need to click, scroll, hover, or type to reach or reveal the data
* You need to solve a cookie banner or dismiss a popup before the content renders
* You need to capture network traffic with `tag_response`, `tag_script`, or `capture_graphql`
* You need to log in, hold a session, or interact with a form

## When should I use Code worker?

Use Code worker when all of the following are true:

* The full target data is present in the raw HTML response or in a public JSON endpoint
* No JavaScript execution is required to render the data
* No click, scroll, or type interaction is required
* You are crawling sitemaps, RSS feeds, or API endpoints

<Tip>
  Start with Code worker. If the data you need is not in the raw response, switch to Browser worker. You can change worker type on the same scraper at any time.
</Tip>

## Which functions are Browser worker only?

Bright Data Scraper Studio functions that depend on a live browser session throw an error when called from a Code worker. Choose Browser worker if your scraper needs any of these:

| Category                 | Functions                                                                                                                                                        |
| ------------------------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Waiting on the DOM       | `wait`, `wait_any`, `wait_for_text`, `wait_hidden`, `wait_visible`, `wait_network_idle`, `wait_page_idle`                                                        |
| Scrolling                | `scroll_to`, `scroll_to_all`, `load_more`                                                                                                                        |
| Traffic tagging          | `tag_response`, `tag_all_responses`, `tag_script`, `tag_image`, `tag_video`, `tag_screenshot`, `tag_download`, `tag_window_field`, `tag_serp`, `capture_graphql` |
| Keyboard and mouse input | `click`, `right_click`, `hover`, `mouse_to`, `press_key`, `type`                                                                                                 |
| Browser configuration    | `browser_size`, `emulate_device`, `freeze_page`, `emulate_geolocation`                                                                                           |
| Anti-bot                 | `solve_captcha`, `close_popup`                                                                                                                                   |

## Frequently asked questions

<AccordionGroup>
  <Accordion title="Can I switch worker type after building the scraper?">
    Yes. Open the scraper in the Bright Data Scraper Studio IDE and change the worker type in the **Settings** panel. If you switch from Browser worker to Code worker, remove any calls to the browser-only functions listed above or the scraper will throw an error on the next run.
  </Accordion>

  <Accordion title="Is Code worker really faster than Browser worker?">
    Yes. Code worker issues a single HTTP request with no browser boot and no page render, so the round trip completes in a fraction of the time a browser-worker run takes. The exact speedup depends on the target site, but Code worker jobs typically finish in seconds.
  </Accordion>

  <Accordion title="Does Browser worker support capturing background API calls?">
    Yes. Use `tag_response` or `tag_all_responses` to capture any XHR or fetch the page makes, and `capture_graphql` to capture and replay GraphQL queries. See [Scraper Studio functions](/datasets/scraper-studio/functions) for the full reference.
  </Accordion>
</AccordionGroup>

## Related

<CardGroup>
  <Card title="Scraper Studio functions" icon="code" href="/datasets/scraper-studio/functions">
    Full reference for interaction and parser commands
  </Card>

  <Card title="Best practices" icon="list-check" href="/datasets/scraper-studio/best-practices">
    Recommended patterns for writing efficient scrapers
  </Card>
</CardGroup>


# Query fan-out and web search control
Source: https://docs.brightdata.com/datasets/scrapers/concepts/query-fan-out

Use the web_search input to control whether LLM scrapers run a web search and read web_search_triggered (1 = a search ran for the request) to confirm.

Query fan-out is the mechanism Bright Data LLM Scrapers use to control and report external web search activity during a run. Use the `web_search` input to decide whether a web search is allowed, and read the `web_search_triggered` output field to know whether a web search actually occurred.

<Note>
  `web_search` is a **permission**. `web_search_triggered` is the **actual behavior**. They are not the same, set `web_search: true` and the model may still decide not to search; set `web_search: false` and `web_search_triggered` will always return `false`.
</Note>

## Which scrapers support query fan-out

| LLM Scraper                                        | Query fan-out support |
| :------------------------------------------------- | :-------------------- |
| [ChatGPT](/datasets/scrapers/chatgpt/introduction) | Available             |
| Grok                                               | Available             |

Gemini does not currently expose a `web_search` control. The decision to search the web is made internally by Gemini and cannot be forced or disabled from the scraper input.

## Input: `web_search`

| Field        | Type    | Required | Default | Meaning                                               |
| :----------- | :------ | :------- | :------ | :---------------------------------------------------- |
| `web_search` | boolean | No       | `true`  | Controls whether web search is allowed during the run |

**Values**

* `true` or omitted: web search is allowed. The scraper enables the Web Search button in the LLM UI and the model may choose to use it.
* `false`: web search is disabled. The scraper does not enable the Web Search button, and the model will not trigger a search.

## Output: `web_search_triggered`

| Field                  | Type    | Always returned | Meaning                                                                                                       |
| :--------------------- | :------ | :-------------- | :------------------------------------------------------------------------------------------------------------ |
| `web_search`           | boolean | No              | Echoes the input value (defaults to `true` if omitted). Does not indicate whether a search actually happened. |
| `web_search_triggered` | boolean | Yes             | `true` only if the model actually triggered a web search during the run; `false` otherwise.                   |

Use `web_search_triggered` when you need to confirm whether the model's answer was grounded in live web results.

## Example: disable web search

The request below passes `web_search: false` to force an offline answer.

```bash theme={null}
curl -X POST "https://api.brightdata.com/datasets/v3/scrape?dataset_id=gd_m7aof0k82r803d5bjm&notify=false&include_errors=true" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "input": [
      {
        "url": "https://chatgpt.com/",
        "prompt": "Top hotels in New York",
        "country": "",
        "web_search": false,
        "additional_prompt": ""
      }
    ]
  }'
```

**What to expect**

* The response includes `web_search: false`.
* The response includes `web_search_triggered: false` because searching was not allowed.

## How to interpret results

### When `web_search_triggered` is `true`

A response with `web_search_triggered: true` means the model actually ran an external web search during the run. If the response also includes prompt-derived structured fields (for example `is_map: true` with a populated map payload, or `citations`), those fields were produced from live search results.

### Why `map` can be `null` even when search happened

Even if `web_search_triggered: true`, fields like `map` or `citations` can still be empty or `null`. The reason:

* `web_search_triggered` only tells you whether web search **ran**.
* Fields like `map`, `shopping_visible`, and `citations` reflect what the model **chose to output**, which depends on the prompt and the model's final answer format.

Do not use output fields like `map` as proof that web search happened. Use `web_search_triggered` for that.

## Summary

* Set `web_search` on the input to control whether web search is **allowed**.
* Read `web_search_triggered` on the output to know whether web search **actually occurred**.
* Do not rely on prompt-derived output fields (`map`, `citations`, `shopping_visible`) as a signal that a web search ran. Those fields depend on the prompt and the model's response format, not on search activity.

## See also

* [ChatGPT Scraper API introduction](/datasets/scrapers/chatgpt/introduction)
* [Send your first ChatGPT search request](/datasets/scrapers/chatgpt/send-first-request)
* [ChatGPT Search by prompt API reference](/api-reference/scrapers/ai-search-apis/chatgpt-search-by-prompt)
* [AI Scrapers overview](/datasets/scrapers/scrapers-library/ai-scrapers)


# Web Scraper API vs DIY scraping
Source: https://docs.brightdata.com/datasets/scrapers/concepts/web-scraper-api-vs-diy

Compare Bright Data Web Scraper API (1000+ pre-built scrapers) with DIY scraping (proxies + custom code) to decide which approach fits your use case.

Every scraping project starts the same way: write a parser, add proxy rotation, deploy. It works until the target site changes its DOM, adds a CAPTCHA, or starts fingerprinting headless browsers. Then you're maintaining scrapers instead of using the data.

This guide compares the DIY approach (proxies + custom code) with Bright Data Web Scraper API (1000+ pre-built, maintained scrapers), so you can decide which fits your use case.

## What is DIY scraping?

DIY scraping means you build and maintain the entire pipeline yourself:

* A scraper (BeautifulSoup, Playwright, Puppeteer, Scrapy)
* A proxy layer for IP rotation
* Retry and error-handling logic
* A scheduler to run jobs on a recurring basis

This gives you full control. You choose your selectors and handle edge cases your way.

The tradeoff is maintenance. Every target site becomes a separate codebase that breaks independently when the site changes its DOM, adds anti-bot measures, or starts fingerprinting headless browsers.

## What is Bright Data Web Scraper API?

Bright Data Web Scraper API is a collection of [1000+ pre-built scrapers](https://brightdata.com/cp/scrapers/browse) maintained by Bright Data's engineering team, covering top sites including LinkedIn, Amazon, Instagram, YouTube, TikTok, Google Maps, and many more. You send a URL, you get structured JSON back, no parsing, no selectors, no proxy configuration.

Each scraper returns an [average of 220+ data fields](https://aimultiple.com/serp-scraper-api), covering granular details like rich snippets, map coordinates, ad extensions, and structured metadata that most DIY scrapers miss.

If your target site isn't covered, you can build a custom scraper in minutes using [Bright Data Scraper Studio](/datasets/scraper-studio/introduction): just pass a URL and a plain-language description of the data you need. When a site changes its frontend and breaks your scraper, the [Self-healing tool](/datasets/scraper-studio/self-healing-tool) rewrites the affected code based on a prompt, so you don't need to dig into the script manually.

## The same scrape, two ways

Here's what scraping an Amazon product page looks like with each approach.

**DIY with Playwright**: you write and maintain every selector:

```python Python theme={null}
from playwright.sync_api import sync_playwright

def scrape_amazon_product(url: str, proxy: str) -> dict:
    with sync_playwright() as p:
        browser = p.chromium.launch(proxy={"server": proxy})
        page = browser.new_page()
        page.goto(url, wait_until="domcontentloaded")

        title = page.query_selector("#productTitle").inner_text().strip()
        price = page.query_selector(".a-price .a-offscreen").inner_text()
        rating = page.query_selector("#acrPopover span").inner_text()

        browser.close()
        return {"title": title, "price": price, "rating": rating}
```

<Warning>
  Those CSS selectors (`#productTitle`, `.a-price .a-offscreen`) break whenever Amazon updates their frontend. When that happens, your scraper silently returns wrong data or crashes.
</Warning>

**Web Scraper API**: one API call, structured output:

```bash cURL theme={null}
curl "https://api.brightdata.com/datasets/v3/scrape?dataset_id=gd_l7q7dkf244hwjntr0&format=json" \
  -H "Authorization: Bearer API_KEY" \
  -H "Content-Type: application/json" \
  -d '[{"url": "https://www.amazon.com/dp/B0EXAMPLE"}]'
```

```json Response theme={null}
{
  "title": "Wireless Bluetooth Headphones",
  "price": 49.99,
  "currency": "USD",
  "rating": 4.5,
  "reviews_count": 12847,
  "seller": "TechBrand Official",
  "availability": "In Stock"
}
```

<Tip>
  Find the `dataset_id` for your target site in the [Scrapers Library](/datasets/scrapers/scrapers-library/overview). Each site has its own ID.
</Tip>

## How DIY and Web Scraper API compare

|                          | DIY (proxies + custom code)                       | Web Scraper API                                                                         |
| ------------------------ | ------------------------------------------------- | --------------------------------------------------------------------------------------- |
| **Scraping logic**       | You write and maintain selectors                  | Pre-built for each site                                                                 |
| **Anti-bot handling**    | You manage CAPTCHAs, fingerprinting, stealth      | Automatic                                                                               |
| **When sites change**    | You debug and redeploy                            | Bright Data updates the scraper                                                         |
| **Output format**        | Raw HTML you parse into structured data           | Structured JSON/CSV with named fields                                                   |
| **Data fields**          | Only what you code selectors for                  | [220+ fields on average per scraper](https://aimultiple.com/serp-scraper-api)           |
| **Time to first result** | Hours to days                                     | Minutes                                                                                 |
| **Ongoing maintenance**  | You, indefinitely                                 | Bright Data's scraper team                                                              |
| **Success rate**         | Typically 60–85% depending on anti-bot investment | [98.44% average](https://brightdata.com/blog/web-data/best-web-scraping-apis)           |
| **Supported sites**      | Any site you can write a parser for               | [1000+ pre-built](https://brightdata.com/cp/scrapers/browse); custom via Scraper Studio |

## Which sites are supported

The [Scrapers Library](/datasets/scrapers/scrapers-library/overview) includes ready-made scrapers across categories:

| Category           | Example sites                            |
| ------------------ | ---------------------------------------- |
| **E-commerce**     | Amazon, Walmart, eBay, Shopify           |
| **Social media**   | LinkedIn, Instagram, TikTok, X, Facebook |
| **Search engines** | Google, Bing, Yahoo, DuckDuckGo          |
| **Real estate**    | Zillow, Realtor, Redfin                  |
| **Travel**         | Booking.com, Tripadvisor, Airbnb         |
| **Jobs & B2B**     | Indeed, Glassdoor, Crunchbase            |

If your target isn't in the library, [Bright Data Scraper Studio](/datasets/scraper-studio/ai-agent) can generate a custom scraper from a URL and a natural language description of the data you need.

## Sync vs async collection

Web Scraper API supports two collection modes:

| Mode             | Endpoint   | Best for                                         | Concurrency limit                    |
| ---------------- | ---------- | ------------------------------------------------ | ------------------------------------ |
| **Synchronous**  | `/scrape`  | Single-URL lookups, price checks, CRM enrichment | 5,000 concurrent requests            |
| **Asynchronous** | `/trigger` | Batch jobs with hundreds or thousands of URLs    | 100 concurrent jobs, 1 GB input each |

Sync returns results in the same HTTP response. Async returns a `snapshot_id`: you poll for progress or receive results via webhook. Delivery options include webhooks (JSON, NDJSON, CSV), S3, Google Cloud, and Snowflake.

<Note>
  Sync requests have a 1-minute timeout. If the scrape takes longer, it auto-converts to async and returns a `snapshot_id`.
</Note>

For endpoint examples and request/response formats, see the [Quickstart guide](/datasets/scrapers/scrapers-library/quickstart).

## When to use what

| If you need...                          | Use                                                                               | You write code?            | You maintain scrapers? |
| --------------------------------------- | --------------------------------------------------------------------------------- | -------------------------- | ---------------------- |
| Structured data from popular sites      | **Web Scraper API**                                                               | API calls only             | No                     |
| Raw HTML from any site (custom parsing) | **[Web Unlocker](/scraping-automation/web-unlocker/bestpractices)**               | Yes                        | Yes                    |
| JS-heavy pages (clicks, scrolls, forms) | **[Bright Data Browser API](/scraping-automation/scraping-browser/introduction)** | Yes (Playwright/Puppeteer) | Yes                    |
| Full control over your existing stack   | **[Proxies](/proxy-networks/introduction)**                                       | Yes (everything)           | Yes                    |

## Limitations and tradeoffs

**Predefined data fields.** Each pre-built scraper returns an average of 220+ structured fields, which covers most use cases. If you need a field that isn't included, you can use [Bright Data Scraper Studio](/datasets/scraper-studio/ai-agent) to customize the scraper's output or fall back to [Web Unlocker](/scraping-automation/web-unlocker/bestpractices) for raw HTML.

**Latency.** Sync scrapes typically return in seconds, but complex sites may take longer and auto-convert to async. If you need sub-second responses, you may want to cache results or use pre-scraped [Datasets](https://brightdata.com/products/datasets).

## FAQs

<AccordionGroup>
  <Accordion title="How much does Web Scraper API cost?">
    Pricing starts at \$1 per 1,000 records for standard domains and \$2.50 per 1,000 for premium targets. New accounts get 5,000 free credits per month (no credit card required), plus a matched deposit of up to \$500. See the [pricing page](https://brightdata.com/pricing/web-scraper) and [free tier](/general/account/billing-and-pricing/free-tier) for full details.
  </Accordion>

  <Accordion title="Can I use Web Scraper API with Python, Node.js, or other languages?">
    Yes. Web Scraper API is a standard REST API, so any language that can make HTTP requests works. Bright Data also provides an official [Python SDK](/sdk-quickstart) and a [CLI tool](/cli/overview) for terminal-based workflows. See the [Quickstart guide](/datasets/scrapers/scrapers-library/quickstart) for examples.
  </Accordion>

  <Accordion title="What output formats does Web Scraper API support?">
    JSON, NDJSON (newline-delimited JSON), JSON Lines, and CSV. Results can be delivered via webhook (up to 1 GB), API download (up to 5 GB), or pushed to external storage (S3, Google Cloud, Snowflake).
  </Accordion>

  <Accordion title="Should I use Web Scraper API or Web Unlocker?">
    Use **Web Scraper API** when you want structured data from a supported site with zero scraper maintenance. Use **[Web Unlocker](/scraping-automation/web-unlocker/bestpractices)** when you need raw HTML from any site and want to write your own custom parsing logic. Web Unlocker handles anti-bot bypass but returns HTML, not structured fields.
  </Accordion>

  <Accordion title="Does Web Scraper API work for AI and LLM training pipelines?">
    Yes. The structured JSON output is directly ingestable by AI pipelines without HTML cleaning or parsing. Bright Data also offers integration with MCP servers, LlamaIndex, Google ADK, Dify, and many more.
  </Accordion>

  <Accordion title="Is web scraping with Bright Data compliant and ethical?">
    Bright Data operates under strict compliance standards. All scrapers collect only publicly available data. See the [Trust Center](https://brightdata.com/trustcenter) for their ethical web data collection policies, KYC process, and compliance framework.
  </Accordion>
</AccordionGroup>


# Managed services
Source: https://docs.brightdata.com/datasets/scrapers/managed-services

Bright Data Managed Services delivers end-to-end custom web data extraction across 250+ domains with dedicated project management and scraper development.

Managed Services is a fully-managed data collection solution for organizations that require custom web data extraction. If you can't find a pre-built scraper in the Scraper Library that meets your specific requirements, or if you need a tailored data collection workflow for your unique use case, Managed Services provides end-to-end support. The Bright Data Managed Services team handles scraper development, data collection, quality assurance, and delivery, allowing you to obtain the exact data you need without building or maintaining the infrastructure yourself.

## What are Managed Services?

Managed Services is Bright Data's premium offering for organizations that need reliable, large-scale data collection without dedicating internal resources to web scraping operations. This fully managed solution combines our cutting-edge technology, extensive proxy network, and expert team to deliver clean, structured, and validated data at any scale.

Unlike self-service tools or DIY scraping solutions, Managed Services provides:

* Dedicated project management from experienced data professionals
* Custom scraper development tailored to your exact requirements
* Complete infrastructure management including proxies, anti-bot handling, and performance optimization
* Quality assurance and validation to ensure data accuracy and completeness
* Ongoing maintenance and support to adapt to website changes and evolving needs
* Flexible control options - go fully hands-off or trigger collections on-demand via API

## Get Started with Managed Services

Ready to run large-scale data collection without the operational burden? Requesting a Managed Services scraper is simple and takes just a few minutes.

### How to Request a Fully Managed Scraper

<Steps>
  <Step title="Access Your Control Panel">
    Log in to your Bright Data account and navigate to the My Scrapers section from the left sidebar menu.
  </Step>

  <Step title="Request a Fully Managed Scraper">
    Click the "New" button in the top right corner, then select "Request a fully managed scraper" from the dropdown menu.

    <Frame>
      <img alt="New Button" />
    </Frame>
  </Step>

  <Step title="Provide Your Requirements">
    In the request form, enter your target website URL and provide detailed information about your data collection needs. The more details you share, the faster the Bright Data Managed Services team can assist you.

    Include information such as:

    * Target website(s)
    * Specific data fields you need
    * Delivery frequency and format
    * Any special requirements or challenges

    <Frame>
      <img alt="Managed Services Request Form" />
    </Frame>
  </Step>

  <Step title="Submit and Connect with the Bright Data Team">
    Click "Submit" to send your request. Our Managed Services team will review your requirements and contact you within 24 hours to discuss your project and provide a custom proposal.
  </Step>
</Steps>

Start your Managed Services journey today and let our experts handle the complexity while you focus on the insights that drive your business forward.

## Pricing Information

Prices start as low as \$2.5K/month;  \$1.5K with a Solution Partner \
[https://brightdata.com/pricing/managed-services](https://brightdata.com/pricing/managed-services)


# Overview
Source: https://docs.brightdata.com/integrations/ai-integrations

Connect Bright Data (1000+ pre-built scrapers) to AI and ML workflows for RAG pipelines, agent search and structured data collection via the MCP server.

<Card title="Building an AI startup?" href="https://brightdata.com/ai/ai-startups-program" icon="rocket-launch">
  You might be eligible for our Startup Program. Get fully funded access to the infrastructure you're reading about right now (up to \$20K value).
</Card>

## Which AI integrations are supported

<CardGroup>
  <Card title="LangChain" icon="https://mintcdn.com/brightdata/jeaQWxFKde5jgPN8/images/integrations/ai-integrations/langchain.png?fit=max&auto=format&n=jeaQWxFKde5jgPN8&q=85&s=c73d66ffa0b6a9f411e7c369d732ac47" href="/integrations/langchain">
    Connect LLMs with external data and agents using LangChain.
  </Card>

  <Card title="OpenClaw" icon="https://mintcdn.com/brightdata/jeaQWxFKde5jgPN8/images/integrations/ai-integrations/openclaw.png?fit=max&auto=format&n=jeaQWxFKde5jgPN8&q=85&s=504ea1dc94bc5e061df293d0bfdd174a" href="/integrations/openclaw">
    Give your OpenClaw AI agent web search, scraping, browser automation, and 50+ structured data tools.
  </Card>

  <Card title="OpenClaw on Railway" icon="https://mintcdn.com/brightdata/jeaQWxFKde5jgPN8/images/integrations/ai-integrations/openclaw.png?fit=max&auto=format&n=jeaQWxFKde5jgPN8&q=85&s=504ea1dc94bc5e061df293d0bfdd174a" href="/integrations/openclaw-railway">
    Deploy an OpenClaw agent with 66 Bright Data tools on Railway in one click.
  </Card>

  <Card title="Crew AI" icon="https://mintcdn.com/brightdata/jeaQWxFKde5jgPN8/images/integrations/ai-integrations/crew-ai.png?fit=max&auto=format&n=jeaQWxFKde5jgPN8&q=85&s=4bf84f44575e2469cea09fb8d9b70399" href="/integrations/crew-ai">
    Build and scale AI workflows with Crew AI.
  </Card>

  <Card title="Vercel AI SDK" icon="https://assets.vercel.com/image/upload/q_auto/front/favicon/vercel/favicon.ico" href="/integrations/vercel-ai-sdk">
    Build production-ready AI apps with Vercel AI SDK.
  </Card>

  <Card title="Yutori" icon="https://yutori.com/logo-dark.svg" href="/integrations/yutori">
    Browse the web autonomously with Yutori's n1 reasoning model and Bright Data's Scraping Browser
  </Card>

  <Card title="Haystack" icon="https://mintcdn.com/brightdata/jeaQWxFKde5jgPN8/images/integrations/ai-integrations/haystack.jpg?fit=max&auto=format&n=jeaQWxFKde5jgPN8&q=85&s=440249b2f8cef9244e60697eedf0243b" href="/integrations/haystack">
    Enhances your RAG pipelines and AI applications with Haystack.
  </Card>

  <Card title="Mastra" icon="https://mintcdn.com/brightdata/jeaQWxFKde5jgPN8/images/integrations/ai-integrations/mastra.png?fit=max&auto=format&n=jeaQWxFKde5jgPN8&q=85&s=fc987035364e7df036d203618a8f1258" href="/integrations/mastra">
    Build intelligent AI agents with web scraping, search, and data extraction capabilities.
  </Card>

  <Card title="Dify" icon="https://mintcdn.com/brightdata/jeaQWxFKde5jgPN8/images/integrations/ai-integrations/dify.png?fit=max&auto=format&n=jeaQWxFKde5jgPN8&q=85&s=f8d0159f3a7b28da23619aa8184a1dc6" href="/integrations/dify">
    Access real-time web data in Dify with Bright Data
  </Card>

  <Card title="Lindy.ai" icon="https://mintcdn.com/brightdata/jeaQWxFKde5jgPN8/images/integrations/ai-integrations/lindy-ai.webp?fit=max&auto=format&n=jeaQWxFKde5jgPN8&q=85&s=2665cf234bbeccb9f3762ab9759cdf24" href="/integrations/lindy-ai">
    Enhance your AI applications with Lindy.ai's powerful features.
  </Card>

  <Card title="LlamaIndex" icon="https://mintlify.s3.us-west-1.amazonaws.com/brightdata/images/integrations/ai-integrations/llamaindex.png" href="/integrations/llama-index">
    Simplify data retrieval and management for LLMs with LlamaIndex.
  </Card>

  <Card title="make.com" icon="https://mintcdn.com/brightdata/jeaQWxFKde5jgPN8/images/integrations/ai-integrations/make.com.png?fit=max&auto=format&n=jeaQWxFKde5jgPN8&q=85&s=e67579fa07705baa5bf3e807a50b8d73" href="/integrations/make">
    Automate workflows and connect apps with make.com.
  </Card>

  <Card title="n8n" icon="https://mintcdn.com/brightdata/jeaQWxFKde5jgPN8/images/integrations/ai-integrations/n8n.png?fit=max&auto=format&n=jeaQWxFKde5jgPN8&q=85&s=539f7a69b60084c42bd68b869940bdd0" href="/integrations/n8n">
    Create and automate workflows with n8n's powerful features.
  </Card>

  <Card title="Pica" icon="https://mintcdn.com/brightdata/jeaQWxFKde5jgPN8/images/integrations/ai-integrations/picaos.jpeg?fit=max&auto=format&n=jeaQWxFKde5jgPN8&q=85&s=844eb2e91d3ce126c69a589b446aa1a7" href="/integrations/pica">
    Build and scale AI workflows with Pica.
  </Card>

  <Card title="Strands" icon="https://mintcdn.com/brightdata/jeaQWxFKde5jgPN8/images/integrations/ai-integrations/strands.png?fit=max&auto=format&n=jeaQWxFKde5jgPN8&q=85&s=ea1bd38e74438e0b750e4af155a342d5" href="/integrations/strands">
    Orchestrate and manage multi-agent AI workflows with Strands.
  </Card>

  <Card title="xpander.ai" icon="https://mintcdn.com/brightdata/jeaQWxFKde5jgPN8/images/integrations/ai-integrations/xpander-ai.jpeg?fit=max&auto=format&n=jeaQWxFKde5jgPN8&q=85&s=3962687624e26fe3e80ddf3df5281278" href="/integrations/xpander-ai">
    Enhance your AI applications with xpander.ai's powerful features.
  </Card>

  <Card title="Agno" icon="https://mintcdn.com/brightdata/jeaQWxFKde5jgPN8/images/integrations/ai-integrations/agno.png?fit=max&auto=format&n=jeaQWxFKde5jgPN8&q=85&s=7852e6e5c458f92a633fed5f7dcc92fb" href="/integrations/agno">
    Build memory-powered, multimodal AI agents with Agno
  </Card>
</CardGroup>

***

<Card title="MCP Clients" icon="server" href="/ai/mcp-server/integrations">
  <p>Connect to our MCP clients for seamless integration.</p>
</Card>


# Get browser session
Source: https://docs.brightdata.com/api-reference/browser-api/get-session

GET /browser_sessions/{session_id}
Use the Bright Data Browser API to get a Browser Session. GET /browser_sessions/{session_id} returns 200 OK with session metadata as JSON.



# List browser session
Source: https://docs.brightdata.com/api-reference/browser-api/get-sessions

GET /browser_sessions
Use the Bright Data Browser API to list Browser Sessions. GET /browser_sessions returns 200 OK with active or historical session metadata as JSON.

<Accordion title="Example Usage URLs">
  ```txt Default: last 50 sessions sorted by timestamp desc theme={null}
  https://api.brightdata.com/browser_sessions
  ```

  ```txt Get first 25 finished sessions wrap theme={null}
  https://api.brightdata.com/browser_sessions?limit=25&status=finished
  ```

  ```txt Get all running sessions wrap theme={null}
  https://api.brightdata.com/browser_sessions?status=running
  ```

  ```txt Get all failed sessions wrap theme={null}
  https://api.brightdata.com/browser_sessions?status=failed
  ```

  ```txt Get sessions from a specific API zone wrap theme={null}
  https://api.brightdata.com/browser_sessions?api_name=scraping_browser1
  ```

  ```txt Sessions from a specific date range wrap theme={null}
  https://api.brightdata.com/browser_sessions?start_date=2025-12-01T00:00:00Z&end_date=2025-12-16T23:59:59Z
  ```

  ```txt Sessions for a specific target URL sorted by bandwidth wrap theme={null}
  https://api.brightdata.com/browser_sessions?target_url=example.com&sort=bandwidth&order=desc
  ```

  ```txt All sessions for a specific target URL wrap theme={null}
  https://api.brightdata.com/browser_sessions?target_url=amazon.com
  ```

  ```txt Failed sessions for a specific target URL wrap theme={null}
  https://api.brightdata.com/browser_sessions?target_url=linkedin.com&status=failed
  ```

  ```txt Sessions sorted by highest bandwidth wrap theme={null}
  https://api.brightdata.com/browser_sessions?sort=bandwidth&order=desc
  ```

  ```txt Sessions sorted by longest duration wrap theme={null}
  https://api.brightdata.com/browser_sessions?sort=duration&order=desc
  ```

  ```txt First page (100 sessions) wrap theme={null}
  https://api.brightdata.com/browser_sessions?limit=100&offset=0
  ```

  ```txt Second page (next 100 sessions) wrap theme={null}
  https://api.brightdata.com/browser_sessions?limit=100&offset=100
  ```
</Accordion>


# Discover API
Source: https://docs.brightdata.com/api-reference/discover/overview

POST https://api.brightdata.com/discover
The Bright Data Discover API retrieves search results and automatically evaluates their relevance based on an AI-driven intent parameter. Covers 31 languages.

## Introduction to Discover API

> Collect search results at scale for you, instead of wasting time and effort on filtering or processing irrelevant results

## Body Parameters

<ParamField type="string">
  The search query.

  > **Maximum length**: 1,500 characters.
</ParamField>

<ParamField type="string">
  Describes the specific goal of the search to help the AI evaluate and rank result relevance. If not provided, the `query` string is used as the intent.

  > **Maximum length:** 3,000 characters.

  For best results, use the following formula:

  ```json theme={null}
  [PERSONA/CONTEXT]: I am [persona] looking for [use case].
  [INCLUDE]: Prioritize [document type 1], [document type 2],
             and [source authority] published [recency if relevant].
  [DEPTH]: Focus on [technical level / document section].
  [EXCLUDE]: Strictly exclude [noise type 1], [noise type 2],
             and [source type to avoid].
  ```

  <Expandable title="Intent examples">
    **B2B Financial Research (Investment RAG)**

    * Query: `"Impact of generative AI on SaaS revenue models"`
    * Intent:

    ```text theme={null}
    I am building an AI investment analyst tool for venture capitalists.
    Prioritize institutional research reports, earnings call transcripts,
    and B2B SaaS industry analyses published in the last 12 months.
    Focus on financial metrics, pricing strategies, and market adoption rates.
    Strictly exclude consumer software reviews, generic tech news,
    and vendor promotional pages.
    ```

    **Advanced Engineering Troubleshooting (Developer RAG)**

    * Query: `"Optimize Postgres database query performance"`
    * Intent:

    ```text theme={null}
    I am building an internal knowledge base for senior backend engineers.
    Prioritize official documentation, peer-reviewed engineering blogs,
    and advanced performance benchmarks.
    Focus on configuration settings, advanced indexing strategies,
    and code-level tuning.
    Strictly exclude beginner SQL tutorials, basic installation guides,
    and database vendor marketing material.
    ```
  </Expandable>
</ParamField>

<ParamField type="string">
  Controls the search depth and ranking behavior of the request.

  * `standard` - Provides standard search depth and AI ranking. Best for general use cases where a balance of relevance and speed is needed.
  * `zeroRanking` - Bypasses AI ranking to maximize the raw volume of results returned. Best when you want to collect as much broad data as possible without relevance filtering.
    <Note>In `zeroRanking` mode, the `num_results` parameter has no effect on the number of results returned. Additionally, `include_content` is not supported in this mode.</Note>
  * `deep` - Performs a more exhaustive, broader search. Best when you need comprehensive coverage of a topic and prioritize thoroughness over speed.
  * `fast` - Optimizes the request for quicker response times. Best for time-sensitive tasks where getting immediate results is the top priority.
</ParamField>

<ParamField type="array of strings">
  A list of exact keywords that must appear in the search results. The API automatically applies `intext:` operators to guarantee keyword inclusion.

  *Example: `["Product Manager", "Roadmap"]`*
</ParamField>

<ParamField type="string">
  The response format.

  Available options: `json`, `md`

  > When set to `md` and `include_content` is true, the content field returns parsed Markdown instead of raw HTML.
</ParamField>

<ParamField type="boolean">
  If true, the response will include the page content in markdown format.

  **PDF support:** When a search result links to a PDF file, the API will automatically extract and parse the PDF content. Limitations:

  * Maximum PDF file size: 50 MB
  * Maximum PDF parsing time: 30 seconds
  * If either limit is exceeded, the content field returns empty.
</ParamField>

<ParamField type="boolean">
  If true, the response will extract and include an array of images.
</ParamField>

<ParamField type="string">
  The language to search in and return data for.

  Supported across 31 languages to align with Voyage AI and SERP capabilities, including but not limited to:
  `en` (English), `es` (Spanish), `fr` (French), `de` (German), `zh` (Chinese), `ja` (Japanese), `ar` (Arabic), `he` (Hebrew), `ko` (Korean), `hi` (Hindi), `pt` (Portuguese), and `ru` (Russian).
</ParamField>

<ParamField type="integer">
  The exact number of search results to return in the response.
</ParamField>

<ParamField type="boolean">
  If true, duplicate results will be removed from the response.
</ParamField>

<ParamField type="string">
  Search only for content updated from the date specified (format: YYYY-MM-DD).
</ParamField>

<ParamField type="string">
  Search only for content updated until the date specified (format: YYYY-MM-DD).
</ParamField>

<ParamField type="string">
  Get search results from a specific country. This accepts all standard 2-letter ISO country codes (e.g., `US`, `GB`, `DE`, `IL`, `FR`, `JP`). This will prioritize content from the selected country in the search results.
</ParamField>

<ParamField type="string">
  Get search results localized to a specific city using SERP `uule` encoding (e.g., `"New York"`, `"Berlin"`, `"Tel Aviv"`). For best results, use this in conjunction with the corresponding `country` parameter.
</ParamField>

<RequestExample>
  ```bash cURL: json theme={null}
  curl "https://api.brightdata.com/discover" \
    -H "Content-Type: application/json" \
    -H "Authorization: Bearer <token>" \
    -d '{
      "query": "artificial intelligence trends",
      "filter_keywords": ["Product Manager", "Roadmap"],
      "num_results": 10,
      "format": "json",
      "intent": "latest AI technology developments",
      "include_images": true
    }'
  ```

  ```sh cURL: md theme={null}
  curl "https://api.brightdata.com/discover" \
    -H "Content-Type: application/json" \
    -H "Authorization: Bearer <token>" \
    -d '{
      "query": "artificial intelligence trends",
      "format": "md",
      "include_content": true,
      "num_results": 5
    }'
  ```

  ```python Python theme={null}
  import requests

  url = "https://api.brightdata.com/discover"
  headers = {
      "Content-Type": "application/json",
      "Authorization": "Bearer YOUR_API_KEY"
  }
  payload = {
      "query": "artificial intelligence trends",
      "filter_keywords": ["Product Manager", "Roadmap"],
      "num_results": 10,
      "city": "New York",
      "country": "US",
      "language": "en",
      "intent": "latest AI technology developments",
      "include_images": True
  }

  # Trigger the discovery task
  response = requests.post(url, json=payload, headers=headers)
  print(response.json())
  ```

  ```javascript Node.js theme={null}
  const response = await fetch("https://api.brightdata.com/discover", {
    method: "POST",
    headers: {
      "Content-Type": "application/json",
      "Authorization": "Bearer YOUR_API_KEY"
    },
    body: JSON.stringify({
      query: "artificial intelligence trends",
      filter_keywords: ["Product Manager", "Roadmap"],
      num_results: 10,
      city: "New York",
      country: "US",
      language: "en",
      intent: "latest AI technology developments",
      include_images: true
    })
  });

  const data = await response.json();
  console.log(data);
  ```

  ```py Python SDK theme={null}
  # Install: pip install brightdata-sdk
  import asyncio
  from brightdata import BrightDataClient

  async def main():
      async with BrightDataClient(api_key="YOUR_API_KEY") as client:
          result = await client.discover(
              query="AI trends 2026",
              intent="latest technology developments",
          )
          # result.data -> [{ title, link, description, relevance_score }]
          print(result.data)

  asyncio.run(main())
  ```

  ```js JavaScript SDK theme={null}
  // Install: npm install @brightdata/sdk
  import { bdclient } from '@brightdata/sdk';

  const client = new bdclient({ apiKey: 'YOUR_API_KEY' });

  const result = await client.discover('AI trends 2026', {
    intent: 'latest technology developments',
  });
  // result.data -> [{ title, link, description, relevance_score }]

  await client.close();
  ```
</RequestExample>

<ResponseExample>
  ```json theme={null}
  {
    "status": "ok",
    "task_id": "bde85a92-3232-4f26-98f6-5ed0328b8288"
  }
  ```
</ResponseExample>

## Errors

| Status | Error Message                                                            | Trigger                                                                                                     | Resolution                                                                         |
| :----- | :----------------------------------------------------------------------- | :---------------------------------------------------------------------------------------------------------- | :--------------------------------------------------------------------------------- |
| 400    | `{"error":"Missing query"}`                                              | query is missing, empty, or null                                                                            | Provide a non-empty string in the query field.                                     |
| 400    | `{"error":"Invalid query. Max length is 1500 chars"}`                    | query exceeds 1,500 characters, or is a non-string type (number, array)                                     | Provide a string of 1,500 characters or fewer.                                     |
| 400    | `{"error":"Invalid intent. Max length is 3000 chars"}`                   | intent exceeds 3,000 characters, or is a non-string type                                                    | Provide a string of 3,000 characters or fewer, or omit to use query as the intent. |
| 400    | `{"error":"Unsupported format. Only \"md\" and \"json\" are supported"}` | format is not "json" or "md" (e.g. "markdown", "xml", "csv", empty string, or non-string type)              | Set format to "json" or "md".                                                      |
| 400    | `{"error":"Invalid num_results. Must be a number between 1 and 20"}`     | num\_results is 0, negative, greater than 20, or a non-number type                                          | Provide an integer between 1 and 20.                                               |
| 400    | `{"error":"Invalid filter_keywords. Must be an array of strings"}`       | filter\_keywords is not an array (e.g. a string)                                                            | Provide an array of strings, e.g. \["keyword1", "keyword2"].                       |
| 400    | `{"error":"Invalid start_date"}`                                         | start\_date is not in YYYY-MM-DD format, is a non-string type, is in the future, or start\_date > end\_date | Provide a valid past or present date in YYYY-MM-DD format.                         |
| 400    | `{"error":"Invalid end_date"}`                                           | end\_date is not in YYYY-MM-DD format or is a non-string type                                               | Provide a valid date in YYYY-MM-DD format.                                         |
| 400    | `{"error":"Unsupported country"}`                                        | country is a string but not a valid ISO 3166-1 alpha-2 code                                                 | Use a valid 2-letter country code (e.g. "US", "IL", "DE").                         |
| 400    | `{"error":"Unexpected fields: <field_names>"}`                           | Request body contains unrecognized field names                                                              | Remove unexpected fields. Only use documented parameters.                          |
| 401    | Credentials are missing                                                  | No Authorization header provided                                                                            | Add `Authorization: Bearer <token>` header.                                        |
| 401    | Invalid credentials                                                      | Token in Authorization header is invalid                                                                    | Provide a valid API token.                                                         |
| 401    | Auth method is not supported                                             | Authorization header is missing the Bearer prefix                                                           | Use the format `Authorization: Bearer <token>`.                                    |
| 403    | Forbidden                                                                | Discover API is not enabled for your account                                                                | Contact your account manager to enable the Discover API.                           |
| 404    | `{"error":"Task not found"}`                                             | GET request with a `task_id` that doesn't exist                                                             | Verify the `task_id` returned from the POST request.                               |
| 429    | Too Many Requests                                                        | Rate or concurrency limit exceeded                                                                          | Slow down requests or upgrade your plan.                                           |
| 500    | Internal Server Error                                                    | Server-side issue                                                                                           | Retry after a few seconds.                                                         |

## FAQs

<AccordionGroup>
  <Accordion title={<>What is the difference between <code>query</code> and <code>intent</code>?</>}>
    `query` is the exact string submitted to Google's search engine. `intent` is the instruction given to the Bright Data AI to evaluate and rank the relevance of those results before returning them to you.

    Think of `query` as what you type into Google, and `intent` as the brief you give to a research analyst explaining what you actually need and what to ignore. The more specific the intent, the more relevant your results.
  </Accordion>

  <Accordion title={<>Why am I getting a <code>403 Forbidden</code> error?</>}>
    Access to the Bright Data Discover API is restricted. It must be manually enabled for your account by your account manager.
  </Accordion>
</AccordionGroup>


# Retrieve results
Source: https://docs.brightdata.com/api-reference/discover/retrieve-results

GET https://api.brightdata.com/discover?task_id=<task_id>
Fetch ranked search results from the Bright Data Discover API (31 languages) using a task_id. Each result includes URL, title, snippet and relevance score.

<ResponseField name="status" type="string">
  The status of the request: `processing` or `done`
</ResponseField>

<ResponseField name="duration_seconds" type="integer">
  The time taken to process the request in seconds.
</ResponseField>

<ResponseField name="results" type="object[]">
  A list of sorted search results.

  <Expandable title="Item Properties">
    <ResponseField name="link" type="string">
      URL of the search result.
    </ResponseField>

    <ResponseField name="title" type="string">
      Title of the search result.
    </ResponseField>

    <ResponseField name="description" type="string">
      Most query-related content snippet.
    </ResponseField>

    <ResponseField name="relevance_score" type="float">
      Relevance score.
    </ResponseField>

    <ResponseField name="content" type="string">
      Parsed content (only present if `include_content` is set to true).

      **For web pages:** returns page content. For PDF URLs: returns extracted PDF text. Format depends on the format parameter - when format is `md`, content is returned as Markdown; when format is `json`, content is returned as plain text. Returns empty/null if PDF exceeds 50 MB or parsing exceeds 30 seconds.
    </ResponseField>
  </Expandable>
</ResponseField>

<RequestExample>
  ```bash Retrieve Results theme={null}
  curl "https://api.brightdata.com/discover?task_id=<task_id>" \
    -H "Authorization: Bearer <token>"
  ```
</RequestExample>

<ResponseExample>
  ```json 200 OK theme={null}
  {
    "status": "done",
    "duration_seconds": 10,
    "results": [
      {
        "link": "https://www.trigyn.com/insights/ai-trends-2026-new-era-ai-advancements-and-breakthroughs",
        "title": "AI Trends in 2026: Advancements and Breakthroughs Ahead",
        "description": "5 days ago — Explore top AI trends for 2026, from enterprise adoption to autonomous systems and breakthrough business innovations.",
        "relevance_score": 0.98184747,
        "content": null
      },
      {
        "link": "https://sisuadigital.com/blog/artificial-intelligence-trends-2026-sisua-digital/",
        "title": "10 Artificial Intelligence (AI) Trends That Will Define 2026",
        "description": "Dec 26, 2025 — Discover the 10 Artificial Intelligence (AI) Trends That Will Define 2026: governance, human collaboration, continuous learning, and more.",
        "relevance_score": 0.97948,
        "content": null
      }
    ]
  }
  ```
</ResponseExample>

## Errors

| Status | Error Message                  | Trigger                                       | Resolution                                                   |
| :----- | :----------------------------- | :-------------------------------------------- | :----------------------------------------------------------- |
| 400    | `{"error": "Missing task_id"}` | `task_id` query parameter is missing or empty | Provide the `task_id` returned from the POST request.        |
| 401    | Credentials are missing        | No Authorization header                       | Add `Authorization: Bearer <token>` header                   |
| 404    | `{"error": "Task not found"}`  | `task_id` does not match any existing task    | Verify the `task_id` value. Tasks may expire after a period. |


# Discover API synchronous request
Source: https://docs.brightdata.com/api-reference/discover/sync

POST https://api.brightdata.com/discover/sync
Use the Bright Data Discover API synchronous endpoint to get ranked search results in a single request with no polling, within a 60-second timeout.

The Bright Data Discover API synchronous endpoint returns ranked search results in the same HTTP response, so you do not create a task or poll for results. Use the synchronous endpoint when a search completes inside the 60-second timeout budget and you need results inline, for example in an AI agent, a RAG pipeline or a chat backend.

The synchronous endpoint accepts the same request body as the asynchronous [Discover API](/api-reference/discover/overview) endpoint. Only the response differs: the synchronous endpoint returns the final results payload instead of a `task_id`.

## Body Parameters

<ParamField type="string">
  The search query.

  > **Maximum length**: 1,500 characters.
</ParamField>

<ParamField type="string">
  Describes the specific goal of the search to help the AI evaluate and rank result relevance. If not provided, the `query` string is used as the intent.

  > **Maximum length:** 3,000 characters.

  For best results, use the following formula:

  ```json theme={null}
  [PERSONA/CONTEXT]: I am [persona] looking for [use case].
  [INCLUDE]: Prioritize [document type 1], [document type 2],
             and [source authority] published [recency if relevant].
  [DEPTH]: Focus on [technical level / document section].
  [EXCLUDE]: Strictly exclude [noise type 1], [noise type 2],
             and [source type to avoid].
  ```

  <Expandable title="Intent examples">
    **B2B Financial Research (Investment RAG)**

    * Query: `"Impact of generative AI on SaaS revenue models"`
    * Intent:

    ```text theme={null}
    I am building an AI investment analyst tool for venture capitalists.
    Prioritize institutional research reports, earnings call transcripts,
    and B2B SaaS industry analyses published in the last 12 months.
    Focus on financial metrics, pricing strategies, and market adoption rates.
    Strictly exclude consumer software reviews, generic tech news,
    and vendor promotional pages.
    ```

    **Advanced Engineering Troubleshooting (Developer RAG)**

    * Query: `"Optimize Postgres database query performance"`
    * Intent:

    ```text theme={null}
    I am building an internal knowledge base for senior backend engineers.
    Prioritize official documentation, peer-reviewed engineering blogs,
    and advanced performance benchmarks.
    Focus on configuration settings, advanced indexing strategies,
    and code-level tuning.
    Strictly exclude beginner SQL tutorials, basic installation guides,
    and database vendor marketing material.
    ```
  </Expandable>
</ParamField>

<ParamField type="string">
  Controls the search depth and ranking behavior of the request.

  * `standard` - Provides standard search depth and AI ranking. Best for general use cases where a balance of relevance and speed is needed.
  * `zeroRanking` - Bypasses AI ranking to maximize the raw volume of results returned. Best when you want to collect as much broad data as possible without relevance filtering.
    <Note>In `zeroRanking` mode, the `num_results` parameter has no effect on the number of results returned. Additionally, `include_content` is not supported in this mode.</Note>
  * `deep` - Performs a more exhaustive, broader search. Best when you need comprehensive coverage of a topic and prioritize thoroughness over speed.
  * `fast` - Optimizes the request for quicker response times. Best for time-sensitive tasks where getting immediate results is the top priority.
</ParamField>

<ParamField type="array of strings">
  A list of exact keywords that must appear in the search results. The API automatically applies `intext:` operators to guarantee keyword inclusion.

  *Example: `["Product Manager", "Roadmap"]`*
</ParamField>

<ParamField type="string">
  The response format.

  Available options: `json`, `md`

  > When set to `md` and `include_content` is true, the content field returns parsed Markdown instead of raw HTML.
</ParamField>

<ParamField type="boolean">
  If true, the response will include the page content in markdown format.

  **PDF support:** When a search result links to a PDF file, the API will automatically extract and parse the PDF content. Limitations:

  * Maximum PDF file size: 50 MB
  * Maximum PDF parsing time: 30 seconds
  * If either limit is exceeded, the content field returns empty.
</ParamField>

<ParamField type="boolean">
  If true, the response will extract and include an array of images.
</ParamField>

<ParamField type="string">
  The language to search in and return data for.

  Supported across 31 languages to align with Voyage AI and SERP capabilities, including but not limited to:
  `en` (English), `es` (Spanish), `fr` (French), `de` (German), `zh` (Chinese), `ja` (Japanese), `ar` (Arabic), `he` (Hebrew), `ko` (Korean), `hi` (Hindi), `pt` (Portuguese), and `ru` (Russian).
</ParamField>

<ParamField type="integer">
  The exact number of search results to return in the response.
</ParamField>

<ParamField type="boolean">
  If true, duplicate results will be removed from the response.
</ParamField>

<ParamField type="string">
  Search only for content updated from the date specified (format: YYYY-MM-DD).
</ParamField>

<ParamField type="string">
  Search only for content updated until the date specified (format: YYYY-MM-DD).
</ParamField>

<ParamField type="string">
  Get search results from a specific country. This accepts all standard 2-letter ISO country codes (e.g., `US`, `GB`, `DE`, `IL`, `FR`, `JP`). This will prioritize content from the selected country in the search results.
</ParamField>

<ParamField type="string">
  Get search results localized to a specific city using SERP `uule` encoding (e.g., `"New York"`, `"Berlin"`, `"Tel Aviv"`). For best results, use this in conjunction with the corresponding `country` parameter.
</ParamField>

## Synchronous vs. Asynchronous

The synchronous and asynchronous Discover API endpoints take identical request bodies. They differ only in how you receive results.

|                | Synchronous (`POST /discover/sync`)                                 | Asynchronous (`POST /discover`)                                                            |
| :------------- | :------------------------------------------------------------------ | :----------------------------------------------------------------------------------------- |
| Response       | Final ranked results in the same HTTP response                      | A `task_id` to fetch later                                                                 |
| Polling        | None                                                                | Poll [Retrieve Results](/api-reference/discover/retrieve-results) until `status` is `done` |
| Round trips    | 1                                                                   | 2 or more                                                                                  |
| Timeout budget | 60 seconds per request                                              | Not bound to a single request                                                              |
| Best for       | AI agents, RAG pipelines and chat backends that need results inline | Large or slow searches, batch jobs and background collection                               |

Use the synchronous endpoint when the result feeds directly into an AI integration. An agent, a retrieval-augmented generation (RAG) pipeline or a chat backend can send one request and use the ranked results in the same turn, with no task tracking and no polling loop to build or maintain.

Use the asynchronous endpoint when a search may exceed the 60-second synchronous timeout, or when you collect results in the background and fetch them later with [Retrieve Results](/api-reference/discover/retrieve-results).

<RequestExample>
  ```bash cURL: json theme={null}
  curl "https://api.brightdata.com/discover/sync" \
    -H "Content-Type: application/json" \
    -H "Authorization: Bearer <token>" \
    -d '{
      "query": "artificial intelligence trends",
      "filter_keywords": ["Product Manager", "Roadmap"],
      "num_results": 10,
      "format": "json",
      "intent": "latest AI technology developments",
      "include_images": true
    }'
  ```

  ```sh cURL: md theme={null}
  curl "https://api.brightdata.com/discover/sync" \
    -H "Content-Type: application/json" \
    -H "Authorization: Bearer <token>" \
    -d '{
      "query": "artificial intelligence trends",
      "format": "md",
      "include_content": true,
      "num_results": 5
    }'
  ```

  ```python Python theme={null}
  import requests

  url = "https://api.brightdata.com/discover/sync"
  headers = {
      "Content-Type": "application/json",
      "Authorization": "Bearer YOUR_API_KEY"
  }
  payload = {
      "query": "artificial intelligence trends",
      "filter_keywords": ["Product Manager", "Roadmap"],
      "num_results": 10,
      "city": "New York",
      "country": "US",
      "language": "en",
      "intent": "latest AI technology developments",
      "include_images": True
  }

  # Returns the ranked results in the same response, no polling
  response = requests.post(url, json=payload, headers=headers)
  print(response.json())
  ```

  ```javascript Node.js theme={null}
  const response = await fetch("https://api.brightdata.com/discover/sync", {
    method: "POST",
    headers: {
      "Content-Type": "application/json",
      "Authorization": "Bearer YOUR_API_KEY"
    },
    body: JSON.stringify({
      query: "artificial intelligence trends",
      filter_keywords: ["Product Manager", "Roadmap"],
      num_results: 10,
      city: "New York",
      country: "US",
      language: "en",
      intent: "latest AI technology developments",
      include_images: true
    })
  });

  const data = await response.json();
  console.log(data);
  ```
</RequestExample>

<ResponseExample>
  ```json 200 OK theme={null}
  {
    "status": "done",
    "duration_seconds": 10,
    "results": [
      {
        "link": "https://www.trigyn.com/insights/ai-trends-2026-new-era-ai-advancements-and-breakthroughs",
        "title": "AI Trends in 2026: Advancements and Breakthroughs Ahead",
        "description": "5 days ago — Explore top AI trends for 2026, from enterprise adoption to autonomous systems and breakthrough business innovations.",
        "relevance_score": 0.98184747,
        "content": null
      },
      {
        "link": "https://sisuadigital.com/blog/artificial-intelligence-trends-2026-sisua-digital/",
        "title": "10 Artificial Intelligence (AI) Trends That Will Define 2026",
        "description": "Dec 26, 2025 — Discover the 10 Artificial Intelligence (AI) Trends That Will Define 2026: governance, human collaboration, continuous learning, and more.",
        "relevance_score": 0.97948,
        "content": null
      }
    ]
  }
  ```
</ResponseExample>

The synchronous response uses the same schema as [Retrieve Results](/api-reference/discover/retrieve-results). The `status` field is always `done` because the results are final when the response returns.

<ResponseField name="status" type="string">
  The status of the request. For the synchronous endpoint this is always `done`.
</ResponseField>

<ResponseField name="duration_seconds" type="integer">
  The time taken to process the request in seconds.
</ResponseField>

<ResponseField name="results" type="object[]">
  A list of sorted search results.

  <Expandable title="Item Properties">
    <ResponseField name="link" type="string">
      URL of the search result.
    </ResponseField>

    <ResponseField name="title" type="string">
      Title of the search result.
    </ResponseField>

    <ResponseField name="description" type="string">
      Most query-related content snippet.
    </ResponseField>

    <ResponseField name="relevance_score" type="float">
      Relevance score.
    </ResponseField>

    <ResponseField name="content" type="string">
      Parsed content (only present if `include_content` is set to true).

      **For web pages:** returns page content. For PDF URLs: returns extracted PDF text. Format depends on the format parameter - when format is `md`, content is returned as Markdown; when format is `json`, content is returned as plain text. Returns empty/null if PDF exceeds 50 MB or parsing exceeds 30 seconds.
    </ResponseField>
  </Expandable>
</ResponseField>

## Errors

The synchronous endpoint carries over the validation and authentication errors from the asynchronous [Discover API](/api-reference/discover/overview) endpoint, and adds a `504` error when a search does not finish within the 60-second timeout budget.

| Status | Error Message                                                            | Trigger                                                                                                     | Resolution                                                                                                                                                                                       |
| :----- | :----------------------------------------------------------------------- | :---------------------------------------------------------------------------------------------------------- | :----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| 400    | `{"error":"Missing query"}`                                              | query is missing, empty, or null                                                                            | Provide a non-empty string in the query field.                                                                                                                                                   |
| 400    | `{"error":"Invalid query. Max length is 1500 chars"}`                    | query exceeds 1,500 characters, or is a non-string type (number, array)                                     | Provide a string of 1,500 characters or fewer.                                                                                                                                                   |
| 400    | `{"error":"Invalid intent. Max length is 3000 chars"}`                   | intent exceeds 3,000 characters, or is a non-string type                                                    | Provide a string of 3,000 characters or fewer, or omit to use query as the intent.                                                                                                               |
| 400    | `{"error":"Unsupported format. Only \"md\" and \"json\" are supported"}` | format is not "json" or "md" (e.g. "markdown", "xml", "csv", empty string, or non-string type)              | Set format to "json" or "md".                                                                                                                                                                    |
| 400    | `{"error":"Invalid num_results. Must be a number between 1 and 20"}`     | num\_results is 0, negative, greater than 20, or a non-number type                                          | Provide an integer between 1 and 20.                                                                                                                                                             |
| 400    | `{"error":"Invalid filter_keywords. Must be an array of strings"}`       | filter\_keywords is not an array (e.g. a string)                                                            | Provide an array of strings, e.g. \["keyword1", "keyword2"].                                                                                                                                     |
| 400    | `{"error":"Invalid start_date"}`                                         | start\_date is not in YYYY-MM-DD format, is a non-string type, is in the future, or start\_date > end\_date | Provide a valid past or present date in YYYY-MM-DD format.                                                                                                                                       |
| 400    | `{"error":"Invalid end_date"}`                                           | end\_date is not in YYYY-MM-DD format or is a non-string type                                               | Provide a valid date in YYYY-MM-DD format.                                                                                                                                                       |
| 400    | `{"error":"Unsupported country"}`                                        | country is a string but not a valid ISO 3166-1 alpha-2 code                                                 | Use a valid 2-letter country code (e.g. "US", "IL", "DE").                                                                                                                                       |
| 400    | `{"error":"Unexpected fields: <field_names>"}`                           | Request body contains unrecognized field names                                                              | Remove unexpected fields. Only use documented parameters.                                                                                                                                        |
| 401    | Credentials are missing                                                  | No Authorization header provided                                                                            | Add `Authorization: Bearer <token>` header.                                                                                                                                                      |
| 401    | Invalid credentials                                                      | Token in Authorization header is invalid                                                                    | Provide a valid API token.                                                                                                                                                                       |
| 401    | Auth method is not supported                                             | Authorization header is missing the Bearer prefix                                                           | Use the format `Authorization: Bearer <token>`.                                                                                                                                                  |
| 403    | Forbidden                                                                | Discover API is not enabled for your account                                                                | Contact your account manager to enable the Discover API.                                                                                                                                         |
| 429    | Too Many Requests                                                        | Rate or concurrency limit exceeded                                                                          | Slow down requests or upgrade your plan.                                                                                                                                                         |
| 500    | Internal Server Error                                                    | Server-side issue                                                                                           | Retry after a few seconds.                                                                                                                                                                       |
| 504    | `{"error":"Request timed out"}`                                          | The search did not complete within the 60-second synchronous timeout budget                                 | Narrow the query, reduce `num_results`, or use the asynchronous [Discover API](/api-reference/discover/overview) endpoint and poll [Retrieve Results](/api-reference/discover/retrieve-results). |

## FAQs

<AccordionGroup>
  <Accordion title="What happens when a synchronous request times out?">
    When a search does not complete within the 60-second timeout budget, the synchronous endpoint returns a `504` error and no results. Retry with a narrower query or a smaller `num_results`, or send the same request body to the asynchronous [Discover API](/api-reference/discover/overview) endpoint and fetch the results later with [Retrieve Results](/api-reference/discover/retrieve-results).
  </Accordion>

  <Accordion title="Does a timeout return partial results?">
    No. The synchronous endpoint does not return partial results. A request either returns the complete ranked results with a `200` status, or it returns a `504` error with no results.
  </Accordion>

  <Accordion title="Is the synchronous response schema the same as Retrieve Results?">
    Yes. The synchronous endpoint returns the same payload schema as [Retrieve Results](/api-reference/discover/retrieve-results): a `status` field, a `duration_seconds` field and a `results` array. The only difference is that `status` is always `done`, because the results are final when the response returns.
  </Accordion>

  <Accordion title="When should I use the synchronous endpoint instead of the asynchronous one?">
    Use the synchronous endpoint when the result feeds directly into an AI integration such as an agent, a RAG pipeline or a chat backend, and the search completes within 60 seconds. Use the asynchronous endpoint for large or slow searches, batch jobs and background collection.
  </Accordion>

  <Accordion title={<>Why am I getting a <code>403 Forbidden</code> error?</>}>
    Access to the Bright Data Discover API is restricted. It must be manually enabled for your account by your account manager.
  </Accordion>
</AccordionGroup>


# Bulk update view delivery settings
Source: https://docs.brightdata.com/api-reference/marketplace-dataset-api/bulk-update-view-delivery-settings

api-reference/dca-api PUT /datasets/views/delivery_settings/bulk
Apply one delivery configuration to multiple Bright Data dataset views in a single request. Spans 250+ domains in the Bright Data marketplace.

Updates the delivery configuration for every view in the `views` array. All listed views receive the same `deliver`, `filename`, `tar`, `compress` and `batch_size` values, so use this endpoint when you want several views to deliver to the same destination with identical packaging rules.

<Note>
  To update a single view, use [Update view delivery settings](/api-reference/marketplace-dataset-api/update-view-delivery-settings) instead.
</Note>

The `deliver` object must match the schema returned by [Get destination type schema](/api-reference/marketplace-dataset-api/get-destination-type-schema) for the destination you select. The response returns `view_ids`, the full list of views that were updated.


# Deliver snapshot
Source: https://docs.brightdata.com/api-reference/marketplace-dataset-api/deliver-snapshot

api-reference/dca-api POST /datasets/snapshots/{id}/deliver
Use the Bright Data Marketplace Dataset API to deliver a Snapshot. POST /datasets/snapshots/{id}/deliver returns 200 OK with metadata as JSON.

<AccordionGroup>
  <Accordion title="Before you begin" icon="circle-info">
    You need a **Snapshot ID** to use this endpoint. A Snapshot ID (e.g., `snap_m2bxug4e2o352v1jv1`) is a unique identifier created each time a data collection is triggered or a dataset is filtered.

    ### Where do Snapshot IDs come from?

    | Source                                                                                      | Endpoint                       | What it returns                              |
    | :------------------------------------------------------------------------------------------ | :----------------------------- | :------------------------------------------- |
    | [Filter Dataset](/api-reference/marketplace-dataset-api/filter-dataset-with-csv-json-files) | `POST` `/datasets/filter`      | `snapshot_id` in the response body           |
    | [Trigger Collection](/api-reference/rest-api/scraper/asynchronous-requests)                 | `POST` `/datasets/v3/trigger`  | `snapshot_id` in the response body           |
    | Dataset Subscription                                                                        | Automatic delivery schedule    | Snapshot IDs are generated per scheduled run |
    | [Snapshot List](/api-reference/scrapers/management-apis/get-snapshots)                      | `GET` `/datasets/v3/snapshots` | List of all snapshots with their IDs         |

    <Tip>
      If you don't have a Snapshot ID yet, start by filtering a dataset [Filter Dataset](/api-reference/marketplace-dataset-api/filter-dataset) or [triggering a collection](/api-reference/rest-api/scraper/asynchronous-requests) first. The response will include the `snapshot_id` you need.
    </Tip>

    You can check snapshot status before delivering:

    ```sh theme={null}
    curl "https://api.brightdata.com/datasets/snapshots/snap_m2bxug4e2o352v1jv1" \
      -H "Authorization: Bearer YOUR_API_KEY"
    ```

    The snapshot must be in `ready` status before delivery.

    > See [Get Snapshot Metadata](/api-reference/marketplace-dataset-api/get-snapshot-meta) for full documentation.
  </Accordion>

  <Accordion title="Tracking delivery status" icon="clock">
    The `id` returned in the response is a **delivery job ID**. Use it to monitor whether your delivery has completed, failed, or been canceled.

    <CodeGroup>
      ```sh Endpoint theme={null}
      GET https://api.brightdata.com/datasets/v3/delivery/{delivery_id}
      ```

      ```sh Example theme={null}
      curl "https://api.brightdata.com/datasets/v3/delivery/del_abc123xyz" \
        -H "Authorization: Bearer YOUR_API_KEY"
      ```

      ```json Response theme={null}
      {
        "id": "del_abc123xyz",
        "status": "done",
        "delivery_files": [
          {
            "filename": "my-data.json",
            "delivery_ts": 1709000000
          }
        ]
      }
      ```
    </CodeGroup>

    | Field            | Type   | Description                                                  |
    | ---------------- | ------ | ------------------------------------------------------------ |
    | `id`             | string | The delivery job ID                                          |
    | `status`         | string | Delivery status: done, canceled, or failed                   |
    | `delivery_files` | array  | List of delivered files with filename and delivery timestamp |

    <Tip>
      Poll this endpoint until status is "done". For large snapshots with `batch_size` set, `delivery_files` will contain multiple entries, one per batch file.
    </Tip>

    > See [Monitor Delivery](/api-reference/scrapers/management-apis/monitor-delivery) for full documentation.
  </Accordion>

  <Accordion title="End-to-end workflow" icon="arrows-left-right">
    Here's the complete flow from triggering a collection to receiving your data:

    <Steps>
      <Step title="Trigger a collection or filter a dataset">
        This creates a snapshot and returns a `snapshot_id`.

        <CodeGroup>
          ```sh Request theme={null}
          curl -X POST "https://api.brightdata.com/datasets/v3/trigger?dataset_id=gd_l1viktl72bvl7bjuj0" \
            -H "Authorization: Bearer YOUR_API_KEY" \
            -H "Content-Type: application/json" \
            -d '[{"url": "https://example.com/product/123"}]'
          ```

          ```Response theme={null}
          {"snapshot_id": "snap_m2bxug4e2o352v1jv1"}
          ```
        </CodeGroup>
      </Step>

      <Step title="Wait for the snapshot to be ready">
        Poll the snapshot metadata endpoint until status is "ready".

        <CodeGroup>
          ```sh Request theme={null}
          curl "https://api.brightdata.com/datasets/snapshots/snap_m2bxug4e2o352v1jv1" \
            -H "Authorization: Bearer YOUR_API_KEY"
          ```

          ```json Response theme={null}
          {
            "status": "ready",
            "dataset_size": 50000,
            "file_size": 250000000
          }
          ```
        </CodeGroup>
      </Step>

      <Step title="Deliver the snapshot">
        Call this endpoint with the snapshot ID and your delivery configuration.

        <CodeGroup>
          ```sh Request theme={null}
          curl -X POST "https://api.brightdata.com/datasets/snapshots/snap_m2bxug4e2o352v1jv1/deliver" \
            -H "Authorization: Bearer YOUR_API_KEY" \
            -H "Content-Type: application/json" \
            -d '{
                "deliver": {
                  "type": "webhook",
                  "filename": {"template": "my-data", "extension": "json"},
                  "endpoint": "https://example.com/webhook"
                }
            }'
          ```

          ```json Response theme={null}
          {
            "id": "del_abc123xyz"
          }
          ```
        </CodeGroup>
      </Step>

      <Step title="Track the delivery">
        Use the delivery job ID to monitor progress.

        <CodeGroup>
          ```sh Request theme={null}
          curl "https://api.brightdata.com/datasets/v3/delivery/del_abc123xyz" \
            -H "Authorization: Bearer YOUR_API_KEY"
          ```

          ```json Response theme={null}
          {
            "id": "del_abc123xyz",
            "status": "done",
            "delivery_files": [...]
          }
          ```
        </CodeGroup>
      </Step>
    </Steps>
  </Accordion>
</AccordionGroup>


# Snapshot content
Source: https://docs.brightdata.com/api-reference/marketplace-dataset-api/download-the-file-by-snapshot_id

api-reference/dca-api GET /datasets/snapshots/{id}/download
Use the Bright Data Marketplace Dataset API to download Snapshot Content. GET /datasets/snapshots/{id}/download returns 200 OK with metadata as JSON.



# Filter dataset (BETA)
Source: https://docs.brightdata.com/api-reference/marketplace-dataset-api/filter-dataset

api-reference/dca-api POST /datasets/filter
Run async filter jobs on 250+ Bright Data Marketplace datasets. Returns a snapshot_id to download, with CSV/JSON uploads up to 200 MiB.

The Filter endpoint of the Bright Data Marketplace Dataset API runs a large or file-based filter job against any of 250+ Marketplace datasets and returns a `snapshot_id` you can download once the job completes.

<Tip>
  Paste your API key into the authorization field. To get an API key, [create an account](https://brightdata.com/?hs_signup=1\&utm_source=docs\&utm_campaign=playground) and learn [how to generate an API key](/api-reference/authentication#how-do-i-generate-a-new-api-key%3F).
</Tip>

## When should I use Filter?

Use Filter for bulk or file-driven jobs where asynchronous processing is acceptable:

* Bulk exports of more than 1,000 records.
* Filtering against large value lists from CSV or JSON files, such as excluding 100k+ company IDs.
* Datasets not yet supported by Search.
* Scheduled or background pipelines where async is fine.

For sub-second real-time lookups on supported datasets, use [Search](/api-reference/marketplace-dataset-api/search-dataset) instead.

## How does Filter work?

* A call to the Filter endpoint starts an async job and creates a snapshot of the filtered data in your account.
* The maximum job time is 5 minutes. Jobs that run longer are cancelled.
* Charges apply per record in the snapshot, at the standard Marketplace rate of \$2.5 CPM.
* Filter works on all 250+ Marketplace datasets.
* Filter groups support a maximum nesting depth of 3 levels.

## How do I authenticate?

Filter uses Bearer token authentication. Pass your API key in the `Authorization` header:

```bash theme={null}
Authorization: Bearer YOUR_API_KEY
```

Get your key from [account settings](/api-reference/authentication#how-do-i-generate-a-new-api-key%3F).

## Limits

| Limit                     | Value             | Description                                                                                                 |
| ------------------------- | ----------------- | ----------------------------------------------------------------------------------------------------------- |
| **Max rows per file**     | 10,000            | Each uploaded CSV/JSON file can contain up to 10,000 data rows. The header row is not counted.              |
| **Max files per request** | No limit          | Attach as many files as needed in one multipart request, as long as the total stays within the 200 MiB cap. |
| **Max request size**      | 200 MiB           | Total size of all uploaded files and form data combined. Requests over 200 MiB are rejected.                |
| **Job timeout**           | 5 minutes         | If filtering does not complete within 5 minutes the job is cancelled.                                       |
| **Filter nesting depth**  | 3 levels          | Maximum depth for nested filter groups using `and`/`or`.                                                    |
| **Max parallel jobs**     | 100 per dataset   | Up to 100 Filter jobs can run at once per dataset.                                                          |
| **Rate limit**            | 120 requests/hour | Maximum number of Filter API calls per hour.                                                                |

## How do I call Filter?

Filter has two modes: JSON for plain filters and multipart for file uploads.

### JSON mode (no file uploads)

Send all parameters (`dataset_id`, `records_limit` and `filter`) in the JSON body. Set `Content-Type` to `application/json`:

```bash theme={null}
curl -X POST "https://api.brightdata.com/datasets/filter" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "dataset_id": "gd_l1viktl72bvl7bjuj0",
    "records_limit": 100,
    "filter": {
      "name": "name",
      "operator": "=",
      "value": "John"
    }
  }'
```

Filter returns a `snapshot_id`:

```json theme={null}
{ "snapshot_id": "s_abc123..." }
```

### Multipart mode (file uploads)

Send `dataset_id` and `records_limit` as query parameters, and send `filter` and the uploaded files in the form-data body. Set `Content-Type` to `multipart/form-data`:

```bash theme={null}
curl -X POST "https://api.brightdata.com/datasets/filter?dataset_id=gd_l1vijqt9jfj7olije&records_limit=100" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: multipart/form-data" \
  -F 'filter={"operator":"and","filters":[{"name":"industries:value","operator":"includes","value":"industries.csv"}]}' \
  -F 'files[]=@/path/to/industries.csv'
```

To exclude 100k+ values, split them into files of up to 10,000 rows each and attach them all in a single request:

```bash theme={null}
curl -X POST "https://api.brightdata.com/datasets/filter?dataset_id=gd_l1vijqt9jfj7olije&records_limit=5000" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: multipart/form-data" \
  -F 'filter={"operator":"and","filters":[{"name":"company_id","operator":"not_in","value":"exclude1.csv"},{"name":"company_id","operator":"not_in","value":"exclude2.csv"},{"name":"company_id","operator":"not_in","value":"exclude3.csv"}]}' \
  -F 'files[]=@exclude1.csv' \
  -F 'files[]=@exclude2.csv' \
  -F 'files[]=@exclude3.csv'
```

For CSV and JSON file format rules, file references and upload troubleshooting, see [Filter dataset with CSV/JSON files](/api-reference/marketplace-dataset-api/filter-dataset-with-csv-json-files).

## What does Filter return?

Filter returns a `snapshot_id`. Use it to download the filtered records via the snapshot API once the job completes:

* [Get snapshot metadata](/api-reference/marketplace-dataset-api/get-snapshot-meta)
* [Download the file by snapshot\_id](/api-reference/marketplace-dataset-api/download-the-file-by-snapshot_id)

## How much does Filter cost?

Filter costs \$2.5 CPM (per 1,000 records returned), the same rate as the Marketplace. There is no charge when the filter returns 0 records.

## What errors can Filter return?

| Status | Meaning                                                                            | What to do                                                                                                  |
| ------ | ---------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------- |
| `400`  | Bad filter or params                                                               | Check field names with [Get dataset metadata](/api-reference/marketplace-dataset-api/get-dataset-metadata). |
| `401`  | Bad or missing API key                                                             | Check your Bearer token.                                                                                    |
| `402`  | Not enough funds                                                                   | Top up your balance or reduce `records_limit`.                                                              |
| `404`  | Unknown `dataset_id`                                                               | Confirm the dataset ID.                                                                                     |
| `422`  | Filter matched 0 records                                                           | Loosen your filter or check field values.                                                                   |
| `429`  | Too many parallel jobs (max 100 per dataset) or rate limit hit (120 requests/hour) | Back off and retry.                                                                                         |

## Filter syntax

The `filter` object, its operators, filter groups and nesting rules are shared with the [Search endpoint](/api-reference/marketplace-dataset-api/search-dataset) and documented in one place. See the [filter syntax reference](/api-reference/marketplace-dataset-api/filter-syntax) for the full operator list, filter groups, up to three levels of nesting and CSV/JSON file references.

## Related

* [Dataset API overview](/api-reference/marketplace-dataset-api/overview)
* [Search dataset (sync)](/api-reference/marketplace-dataset-api/search-dataset)
* [Filter syntax reference](/api-reference/marketplace-dataset-api/filter-syntax)
* [Filter dataset with CSV/JSON files](/api-reference/marketplace-dataset-api/filter-dataset-with-csv-json-files)
* [Get dataset metadata](/api-reference/marketplace-dataset-api/get-dataset-metadata)


# Filter dataset (JSON or file uploads)
Source: https://docs.brightdata.com/api-reference/marketplace-dataset-api/filter-dataset-with-csv-json-files

api-reference/filter-csv-json POST /datasets/filter
Use the Bright Data Marketplace Dataset API to filter Dataset (JSON or File Uploads). Spans 250+ domains in the Bright Data marketplace.

The Filter endpoint of the Bright Data Marketplace Dataset API can filter a dataset against thousands of values stored in a CSV or JSON file. Upload one or more files in multipart mode and reference each filename in your filter.

<Tip>
  Paste your API key into the authorization field. To get an API key, [Create an account](https://brightdata.com/?hs_signup=1\&utm_source=docs\&utm_campaign=playground) and learn [how to generate an API key](/api-reference/authentication#how-do-i-generate-a-new-api-key%3F).
</Tip>

## How does file-based filtering work?

Use file uploads when you need to filter against large value lists, such as including or excluding 100k+ company IDs:

* Upload CSV or JSON files in `multipart/form-data` mode and reference each filename in your filter.
* Each file holds up to 10,000 data rows, and the whole request can be up to 200 MiB.
* The Filter job runs asynchronously and returns a `snapshot_id` to download once it completes.

For the async job flow, limits, pricing and error codes, see [Filter dataset (async)](/api-reference/marketplace-dataset-api/filter-dataset).

## How do I format the CSV or JSON file?

<Tabs>
  <Tab title="CSV">
    * First line must be a header matching the field name in your filter.
    * Each following line contains a single value.

    ```csv Example: industries.csv theme={null}
    industries:value
    Accounting
    Ad Network
    Advertising
    ```
  </Tab>

  <Tab title="JSON">
    * Must be an array of objects, each with a key matching the field name in your filter.

    ```json Example industries.json theme={null}
    [
      {"industries:value": "Accounting"},
      {"industries:value": "Ad Network"},
      {"industries:value": "Advertising"}
    ]
    ```
  </Tab>
</Tabs>

***

## How do I reference a file in the filter?

When using file uploads, set the filter's `value` field to the filename:

```json Example theme={null}
{
  "operator": "and",
  "filters": [
    {
      "name": "industries:value",
      "operator": "includes",
      "value": "industries.csv"
    }
  ]
}
```

File references work only with the operators `in`, `not_in`, `includes`, `not_includes`, `array_includes` and `not_array_includes`. For the full operator table and field types, see the [filter syntax reference](/api-reference/marketplace-dataset-api/filter-syntax#which-operators-read-csv-or-json-files%3F).

***

## Filter with multiple files

```bash theme={null}
curl \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: multipart/form-data" \
  -F "files[]=@/path/to/industries.csv" \
  -F "files[]=@/path/to/regions.csv" \
  -F "filter={\"operator\":\"and\",\"filters\":[{\"name\":\"industries:value\",\"operator\":\"includes\",\"value\":\"industries.csv\"},{\"name\":\"region\",\"operator\":\"in\",\"value\":\"regions.csv\"}]}" \
  "https://api.brightdata.com/datasets/filter?dataset_id=gd_l1vijqt9jfj7olije"
```

## Troubleshoot file uploads

| Issue                     | Possible Solution                                                                                                        |
| :------------------------ | :----------------------------------------------------------------------------------------------------------------------- |
| **"File not found"**      | Make sure the filename in your filter exactly matches the uploaded file name.                                            |
| **"Invalid file format"** | Check CSV header matches the filter field name, or ensure JSON is an array of objects.                                   |
| **"Field not found"**     | Verify field exists in dataset. Use [Get Dataset Metadata](/api-reference/marketplace-dataset-api/get-dataset-metadata). |

## Related

* [Dataset API overview](/api-reference/marketplace-dataset-api/overview)
* [Filter dataset (async)](/api-reference/marketplace-dataset-api/filter-dataset)
* [Filter syntax reference](/api-reference/marketplace-dataset-api/filter-syntax)
* [Get Dataset List](/api-reference/marketplace-dataset-api/get-dataset-list)
* [Get Dataset Metadata](/api-reference/marketplace-dataset-api/get-dataset-metadata)


# Dataset API filter syntax
Source: https://docs.brightdata.com/api-reference/marketplace-dataset-api/filter-syntax

Reference for the Bright Data Dataset API filter object: operators, filter groups, up to 3 levels of nesting and CSV/JSON file references.

The `filter` object is shared by both the Search and Filter endpoints of the Bright Data Marketplace Dataset API: the same schema, the same operators and the same nesting rules.

<Tip>
  Use [Get dataset metadata](/api-reference/marketplace-dataset-api/get-dataset-metadata) to confirm field names and types before building a filter.
</Tip>

## What are the three filter shapes?

A filter is one of three shapes: a single field filter, a filter group that combines several filters, or a null check.

### Single field filter

Match one field against one value with an operator:

```json theme={null}
{ "name": "name", "operator": "=", "value": "John" }
```

### Filter group

Combine multiple filters with `and` or `or`. Filter groups support a maximum nesting depth of 3 levels:

```json theme={null}
{
  "operator": "and",
  "filters": [
    { "name": "reviews_count", "operator": ">", "value": 200 },
    { "name": "rating", "operator": ">", "value": 4.5 }
  ]
}
```

### Null check

Use `is_null` or `is_not_null` to match on the presence of a value. These operators take no `value`:

```json theme={null}
{ "name": "reviews_count", "operator": "is_not_null" }
```

## Which operators are available?

The following operators can be used in a field filter.

| Operator             | Field types  | What it does                                                                                                                                           |
| -------------------- | ------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------ |
| `=`                  | Any          | Equal to.                                                                                                                                              |
| `!=`                 | Any          | Not equal to.                                                                                                                                          |
| `\<`                 | Number, Date | Lower than.                                                                                                                                            |
| `\<=`                | Number, Date | Lower than or equal.                                                                                                                                   |
| `>`                  | Number, Date | Greater than.                                                                                                                                          |
| `>=`                 | Number, Date | Greater than or equal.                                                                                                                                 |
| `in`                 | Any          | Field value equals any value in the provided list.                                                                                                     |
| `not_in`             | Any          | Field value does not equal any value in the list.                                                                                                      |
| `includes`           | Array, Text  | Field value contains the filter value. If the filter value is an array, it matches records where the field contains at least one value from the array. |
| `not_includes`       | Array, Text  | Field value does not contain the filter value(s).                                                                                                      |
| `array_includes`     | Array        | Exact match exists in the array.                                                                                                                       |
| `not_array_includes` | Array        | Exact match does not exist in the array.                                                                                                               |
| `is_null`            | Any          | Field value is null. No value needed.                                                                                                                  |
| `is_not_null`        | Any          | Field value is not null. No value needed.                                                                                                              |

## Which operators read CSV or JSON files?

These file-reference operators work only on the [Filter endpoint](/api-reference/marketplace-dataset-api/filter-dataset) in multipart mode. Pass a filename as the value to filter against thousands of values stored in a CSV or JSON file.

| Operator             | Field types | Description                                         |
| -------------------- | ----------- | --------------------------------------------------- |
| `in`                 | Any         | Field value equals any value in the file.           |
| `not_in`             | Any         | Field value does not equal any value in the file.   |
| `includes`           | Array, Text | Field value contains any value in the file.         |
| `not_includes`       | Array, Text | Field value does not contain any value in the file. |
| `array_includes`     | Array       | Any value in the file exists in the field value.    |
| `not_array_includes` | Array       | No values in the file exist in the field value.     |

File references are not supported by the Search endpoint. Elasticsearch cannot read external files at query time.

## How do I match within a single nested object?

For datasets where a field is an array of objects, set `combine_nested_fields: true` on a filter group so that all filters in the group must match within a single object, not across different objects in the array:

```json theme={null}
{
  "operator": "and",
  "combine_nested_fields": true,
  "filters": [
    { "name": "experience.title", "operator": "includes", "value": "engineer" },
    { "name": "experience.company", "operator": "=", "value": "Bright Data" }
  ]
}
```

Without `combine_nested_fields`, the two conditions could match in different objects inside the `experience` array.

## Tips

* Use [Get dataset metadata](/api-reference/marketplace-dataset-api/get-dataset-metadata) to confirm field names and types before building a filter.
* Keep nesting shallow when possible. The maximum depth is 3 levels.
* On the Search endpoint, prefer `includes` over `=` on free-text fields, because Elasticsearch tokenizes them.
* On the Filter endpoint, file references work only with the operators listed above.

## Related

* [Dataset API overview](/api-reference/marketplace-dataset-api/overview)
* [Search dataset (sync)](/api-reference/marketplace-dataset-api/search-dataset)
* [Filter dataset (async, file uploads)](/api-reference/marketplace-dataset-api/filter-dataset)
* [Get dataset metadata](/api-reference/marketplace-dataset-api/get-dataset-metadata)


# Dataset list
Source: https://docs.brightdata.com/api-reference/marketplace-dataset-api/get-dataset-list

api-reference/dca-api GET /datasets/list
List every Bright Data dataset ID for all Web Scraper APIs available on your account. Spans 250+ domains in the Bright Data marketplace.

<a href="https://www.postman.com/bright-data-api/bright-data-api/request/1o6iob0/dataset-list">
  <img alt="Run in Postman" />
</a>


# Get dataset metadata
Source: https://docs.brightdata.com/api-reference/marketplace-dataset-api/get-dataset-metadata

api-reference/dca-api GET /datasets/{dataset_id}/metadata
Use the Bright Data Marketplace Dataset API to get Dataset Metadata. GET /datasets/{dataset_id}/metadata returns 200 OK with snapshot metadata as JSON.

<Tip>
  Paste your API key to the authorization field. To get an API key, [Create an account](https://brightdata.com/?hs_signup=1\&utm_source=docs\&utm_campaign=playground) and learn [how to generate an API key](/api-reference/authentication#how-do-i-generate-a-new-api-key%3F).
</Tip>

## General Description

* This endpoint retrieves detailed metadata for a specific dataset.
* Metadata includes available fields, data types, and descriptions.
* Use this endpoint to understand the structure of a dataset before querying or downloading it.

## Request

### **Endpoint**

```http theme={null}
GET https://api.brightdata.com/datasets/{dataset_id}/metadata
```

### **Path Parameters**

| Parameter    | Type     | Description                          |
| ------------ | -------- | ------------------------------------ |
| `dataset_id` | `string` | The unique identifier of the dataset |

### **Headers**

| Header          | Type   | Description                     |
| --------------- | ------ | ------------------------------- |
| `Authorization` | string | Your API key for authentication |

## Response

### **Response Example**

```json theme={null}
{
    "id": "gd_l1vijqt9jfj7olije",
    "fields": {
        "name": {
            "type": "text",
            "active": true,
            "description": "The name of the company"
        },
        "url": {
            "type": "url",
            "required": true,
            "description": "The URL or web address associated with the company"
        },
        "cb_rank": {
            "type": "number",
            "description": "Crunchbase rank assigned to the company"
        }
    }
}
```

### **Response Fields**

| Field    | Type     | Description                                       |
| -------- | -------- | ------------------------------------------------- |
| `id`     | `string` | Unique identifier for the dataset                 |
| `fields` | `object` | Contains metadata about each field in the dataset |

### **Field Metadata**

Each field in the `fields` object contains the following attributes:

| Attribute     | Type      | Description                                            |
| ------------- | --------- | ------------------------------------------------------ |
| `type`        | `string`  | Data type of the field (e.g., `text`, `number`, `url`) |
| `active`      | `boolean` | Indicates if the field is currently active             |
| `required`    | `boolean` | Indicates if the field is mandatory (if applicable)    |
| `description` | `string`  | Brief description of the field                         |

## Example Use Case

### **Fetching Dataset Metadata**

To retrieve metadata for the "Crunchbase companies information" dataset:

#### **Request**

```http theme={null}
GET https://api.brightdata.com/datasets/gd_l1vijqt9jfj7olije/metadata
```

#### **Response**

```json theme={null}
{
    "id": "gd_l1vijqt9jfj7olije",
    "fields": {
        "name": {
            "type": "text",
            "active": true,
            "description": "The name of the company"
        },
        "url": {
            "type": "url",
            "required": true,
            "description": "The URL or web address associated with the company"
        },
        "cb_rank": {
            "type": "number",
            "description": "Crunchbase rank assigned to the company"
        }
    }
}
```

## Troubleshooting & FAQs

### **Issue: "Unauthorized" response**

**Solution**: Ensure you have included a valid API key in the request header.

### **Issue: "Dataset not found"**

**Solution**: Verify that the `dataset_id` is correct and exists in the dataset list.

### **Issue: "Field missing in metadata"**

**Solution**: Some fields may be inactive or unavailable for certain datasets.

## Related Documentation

* [Get Dataset List](/api-reference/marketplace-dataset-api/get-dataset-list)
* [Dataset Filtering API](/api-reference/marketplace-dataset-api/filter-dataset-with-csv-json-files)


# Get dataset views
Source: https://docs.brightdata.com/api-reference/marketplace-dataset-api/get-dataset-views

api-reference/dca-api GET /datasets/views
List your dataset views with IDs, names and underlying dataset across 250+ domains so you can configure or update delivery settings for each subscription.

A dataset view is a saved, filtered subscription to a Bright Data marketplace dataset that delivers fresh records to your destination on a recurring schedule. Each view has a unique `id` (for example `v_id1`) which you pass to the view delivery settings endpoints.

Use the `id` returned here with:

* [Get view delivery settings](/api-reference/marketplace-dataset-api/get-view-delivery-settings) to inspect the current configuration.
* [Update view delivery settings](/api-reference/marketplace-dataset-api/update-view-delivery-settings) to change it.
* [Bulk update view delivery settings](/api-reference/marketplace-dataset-api/bulk-update-view-delivery-settings) to apply one configuration to many views at once.


# Get delivery options
Source: https://docs.brightdata.com/api-reference/marketplace-dataset-api/get-delivery-options

api-reference/dca-api GET /datasets/delivery_settings/options
List the supported delivery destinations, filename templates and batch settings you can use when configuring delivery for a dataset view. Covers 250+ domains.

Use this endpoint before configuring a dataset view delivery to discover which destination types are supported and which fields the filename and batch parameters accept. The response is the canonical source of truth. Supported destinations currently include `api_pull`, `webhook`, `email`, `gcs`, `gcp_pubsub`, `s3`, `snowflake`, `ali_oss`, `sftp` and `azure`.

Call [Get destination type schema](/api-reference/marketplace-dataset-api/get-destination-type-schema) next to retrieve the required fields for the specific destination you want to use.


# Get destination type schema
Source: https://docs.brightdata.com/api-reference/marketplace-dataset-api/get-destination-type-schema

api-reference/dca-api GET /datasets/delivery_settings/{destination_type}/schema
Retrieve the exact fields and credentials required to configure a specific delivery destination type such as s3, sftp, gcs or webhook.

Each delivery destination supported by Bright Data has its own field set. For example, `s3` requires a `bucket` and either an access key/secret pair or an IAM role ARN plus external ID, while `sftp` requires host and credential fields. Call this endpoint with the destination type you plan to use, then supply the returned fields in the `deliver` object when you call [Update view delivery settings](/api-reference/marketplace-dataset-api/update-view-delivery-settings).

<Tip>
  Use [Get delivery options](/api-reference/marketplace-dataset-api/get-delivery-options) first to list the valid values you can pass as `destination_type`.
</Tip>

## Example credential payloads and permissions

The values shown below are sample values. Replace them with your real credentials before sending a request.

Use [Get delivery options](/api-reference/marketplace-dataset-api/get-delivery-options) to list the supported `destination_type` values. Then call this endpoint with the selected `destination_type` and pass the required fields in the `deliver` object.

For cloud storage destinations, Bright Data may validate that delivered files are readable after upload. Make sure the credentials include the provider-specific upload and read permissions listed below. If read permission is missing, delivery upload may succeed, but read-after-upload validation can fail.

### Amazon S3

```json theme={null}
{
  "bucket": "customer-bucket",
  "region": "us-east-1",
  "credentials": {
    "access_key_id": "<AWS_ACCESS_KEY_ID>",
    "secret_access_key": "<AWS_SECRET_ACCESS_KEY>"
  }
}
```

Required permissions:

* `s3:PutObject`
* `s3:GetObject`

For restrictive multipart upload policies, multipart-related permissions may also be required, such as `s3:AbortMultipartUpload` and `s3:ListMultipartUploadParts`.

### Amazon S3 with IAM role

```json theme={null}
{
  "bucket": "customer-bucket",
  "region": "us-east-1",
  "use_dca_delivery_role": true,
  "assume_role": {
    "role_arn": "arn:aws:iam::<account-id>:role/<role-name>",
    "external_id": "<external-id>"
  }
}
```

Required permissions:

* `s3:PutObject`
* `s3:GetObject`

For restrictive multipart upload policies, multipart-related permissions may also be required, such as `s3:AbortMultipartUpload` and `s3:ListMultipartUploadParts`.

The IAM role trust policy must allow Bright Data’s delivery role to assume the customer role using the provided external ID.

### Azure Blob Storage

```json theme={null}
{
  "container": "customer-container",
  "credentials": {
    "account": "<storage-account-name>",
    "key": "<storage-account-key>"
  }
}
```

Required permissions:

* blob create/write permission for upload
* blob read permission for read-after-upload validation

### Azure Blob Storage with SAS token

```json theme={null}
{
  "container": "customer-container",
  "credentials": {
    "account": "<storage-account-name>",
    "sas_token": "<sas-token>"
  }
}
```

Required SAS permissions:

* `r`, read, required for read-after-upload validation
* `c`, create, required for creating new blobs
* `w`, write, required for uploading blob content

### Google Cloud Storage

```json theme={null}
{
  "bucket": "customer-bucket",
  "credentials": {
    "type": "service_account",
    "project_id": "<gcp-project-id>",
    "private_key_id": "<private-key-id>",
    "private_key": "-----BEGIN PRIVATE KEY-----\\n...\\n-----END PRIVATE KEY-----\\n",
    "client_email": "<service-account>@<project>.iam.gserviceaccount.com",
    "client_id": "<client-id>"
  }
}
```

Required permissions:

* `storage.objects.create`
* `storage.objects.get`

### Ali OSS

```json theme={null}
{
  "bucket": "customer-bucket",
  "region": "oss-eu-central-1",
  "endpoint": "oss-eu-central-1.aliyuncs.com",
  "credentials": {
    "access-key": "<ALI_ACCESS_KEY_ID>",
    "secret-key": "<ALI_SECRET_ACCESS_KEY>"
  }
}
```

Required permissions:

* `oss:PutObject`
* `oss:GetObject`

For restrictive multipart upload policies, multipart-related permissions may also be required.

### Webhook

```json theme={null}
{
  "url": "https://customer.example.com/delivery",
  "auth": "Bearer <token>",
  "compress": "gzip"
}
```

Requirements:

* the endpoint must accept `POST` requests
* the endpoint must return a `2xx` response after receiving the payload
* for webhook payloads larger than `10 MB`, use cloud storage delivery instead of webhook


# Get snapshot metadata
Source: https://docs.brightdata.com/api-reference/marketplace-dataset-api/get-snapshot-meta

api-reference/dca-api GET /datasets/snapshots/{id}
Use the Bright Data Marketplace Dataset API to get Snapshot Metadata. Spans 250+ domains in the Bright Data marketplace.



# Get snapshot parts
Source: https://docs.brightdata.com/api-reference/marketplace-dataset-api/get-snapshot-parts

api-reference/dca-api GET /datasets/snapshots/{id}/parts
Use the Bright Data Marketplace Dataset API to get Snapshot Parts. GET /datasets/snapshots/{id}/parts returns 200 OK with snapshot metadata as JSON.



# Get view delivery settings
Source: https://docs.brightdata.com/api-reference/marketplace-dataset-api/get-view-delivery-settings

api-reference/dca-api GET /datasets/views/{view_id}/delivery_settings
Retrieve the current delivery configuration for a Bright Data dataset view (250+ domains): destination, credentials, filename, compression and batch size.

Returns the full delivery configuration stored for the given dataset view. The `deliver` object contains the destination-specific fields (for example `bucket`, `credentials`, `region` for an S3 destination), and the top-level `tar`, `compress`, `batch_size` and `filename` fields describe how the output files are packaged.

<Tip>
  Find the `view_id` by calling [Get dataset views](/api-reference/marketplace-dataset-api/get-dataset-views).
</Tip>


# Dataset API: search and filter
Source: https://docs.brightdata.com/api-reference/marketplace-dataset-api/overview

Query Bright Data Marketplace datasets with two endpoints: Search for sub-second lookups and Filter for bulk async jobs. Shared filter syntax, $2.5 CPM.

The Bright Data Marketplace Dataset API gives you two endpoints to pull records from 250+ Marketplace datasets: **Search** for real-time lookups and **Filter** for bulk asynchronous jobs. Both endpoints share one filter schema, one authentication method and the same \$2.5 CPM pricing.

<Tip>
  Paste your API key into the authorization field. To get an API key, [create an account](https://brightdata.com/?hs_signup=1\&utm_source=docs\&utm_campaign=playground) and learn [how to generate an API key](/api-reference/authentication#how-do-i-generate-a-new-api-key%3F).
</Tip>

## What are the two Dataset API endpoints?

The Marketplace Dataset API exposes two ways to pull records, depending on the job:

* **Search (sync)** is Elasticsearch-powered and returns records inline in sub-second responses. Use Search for real-time lookups, lead enrichment and sampling.
* **Filter (async)** is snapshot-based and supports CSV/JSON file uploads and large payloads. Use Filter for bulk exports and value-list filtering.

<CardGroup>
  <Card title="Search dataset (sync)" href="/api-reference/marketplace-dataset-api/search-dataset" icon="bolt">
    Elasticsearch query, results inline, sub-second latency. Up to 1,000 records per call.
  </Card>

  <Card title="Filter dataset (async)" href="/api-reference/marketplace-dataset-api/filter-dataset" icon="layer-group">
    Snapshot-based job, CSV/JSON uploads, payloads up to 200 MiB. All 250+ datasets.
  </Card>
</CardGroup>

## Which endpoint should I use?

Use Search for low-latency, single-call lookups and Filter for bulk or file-driven jobs.

| Need                                                      | Use                            |
| --------------------------------------------------------- | ------------------------------ |
| Real-time lookup, up to 1,000 records, sub-second latency | Search                         |
| Lead enrichment on a single record                        | Search                         |
| Quick sample of a dataset before buying                   | Search with `"sort": "random"` |
| Bulk export or large pulls                                | Filter                         |
| Filter by a list of 100k+ values from CSV/JSON            | Filter                         |
| Dataset not yet supported by Search                       | Filter                         |

## How do the two endpoints compare?

The Search and Filter endpoints accept the same filter object but differ in engine, latency and dataset coverage.

|                         | Search                              | Filter                              |
| ----------------------- | ----------------------------------- | ----------------------------------- |
| Path                    | `POST /datasets/search/:dataset_id` | `POST /datasets/filter`             |
| Engine                  | Elasticsearch                       | Snapshot-based                      |
| Mode                    | Sync (results inline)               | Async (returns `snapshot_id`)       |
| Latency                 | Sub-second                          | Up to 5 minutes per job             |
| Datasets                | 3 LinkedIn datasets (alpha)         | All 250+ Marketplace datasets       |
| Max payload             | Single request body                 | Up to 200 MiB (multipart)           |
| File uploads (CSV/JSON) | Not supported                       | Supported                           |
| Pagination              | `search_after` cursor               | `records_limit` on snapshot         |
| Returns                 | `hits`, `total_hits`, `took`        | `snapshot_id` (download separately) |
| Pricing                 | \$2.5 CPM                           | \$2.5 CPM                           |

Results between the two engines can differ. Elasticsearch tokenizes text differently from the snapshot engine.

## How do I authenticate?

Both endpoints use Bearer token authentication. Pass your API key in the `Authorization` header:

```bash theme={null}
Authorization: Bearer YOUR_API_KEY
```

Get your key from [account settings](/api-reference/authentication#how-do-i-generate-a-new-api-key%3F).

## How much does the Dataset API cost?

Both endpoints cost \$2.5 CPM (per 1,000 records returned), the same rate as the Marketplace. There is no premium for real-time Search, and there is no charge when a filter returns 0 records.

| Item               | Price                                              |
| ------------------ | -------------------------------------------------- |
| Search and Filter  | \$2.5 CPM (per 1,000 records returned)             |
| Zero-match queries | Free (no charge when the filter returns 0 records) |
| Subscriptions      | Monthly commit, lower effective CPM on overage     |
| Enterprise         | Custom SLAs, dedicated capacity                    |

## Where is the filter syntax documented?

Both endpoints accept the same `filter` object, with the same operators and nesting rules. The [filter syntax reference](/api-reference/marketplace-dataset-api/filter-syntax) documents the operator list, filter groups, up to three levels of nesting and CSV/JSON file references.

## Related

* [Search dataset (sync)](/api-reference/marketplace-dataset-api/search-dataset)
* [Filter dataset (async, file uploads)](/api-reference/marketplace-dataset-api/filter-dataset)
* [Filter syntax reference](/api-reference/marketplace-dataset-api/filter-syntax)
* [Get dataset metadata](/api-reference/marketplace-dataset-api/get-dataset-metadata)
* [Get dataset list](/api-reference/marketplace-dataset-api/get-dataset-list)
* To build or refresh a dataset before querying, see [Request a collection](/api-reference/marketplace-api/request-a-collection).


# Search dataset (sync, Elasticsearch)
Source: https://docs.brightdata.com/api-reference/marketplace-dataset-api/search-dataset

Run a real-time, Elasticsearch-powered query against a Bright Data Marketplace dataset. Sub-second responses, up to 1,000 records per call.

The Search endpoint of the Bright Data Marketplace Dataset API runs a real-time, Elasticsearch-powered query against a Marketplace dataset: send a filter, get records back in the response with sub-second latency.

<Tip>
  Paste your API key into the authorization field. To get an API key, [create an account](https://brightdata.com/?hs_signup=1\&utm_source=docs\&utm_campaign=playground) and learn [how to generate an API key](/api-reference/authentication#how-do-i-generate-a-new-api-key%3F).
</Tip>

## When should I use Search?

Use Search when you need a small number of records back in a single, low-latency call:

* Real-time lookups, such as enriching a lead the moment it hits the CRM.
* Feeding live records into AI agents or LLM apps.
* Sales prospecting by name, title, company or location.
* Sampling a dataset before buying, with `"sort": "random"`.
* Any workload that needs up to 1,000 records back in one call.

If you need file uploads, bulk exports or a dataset that is not in the supported list, use [Filter](/api-reference/marketplace-dataset-api/filter-dataset) instead.

## Run your first Search query

Send a `POST` request to `/datasets/search/:dataset_id` with a `filter` object. The example below searches the LinkedIn people profiles dataset for records whose `name` includes `Egor`:

```bash theme={null}
curl -X POST "https://api.brightdata.com/datasets/search/gd_l1viktl72bvl7bjuj0" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "size": 10,
    "filter": {
      "name": "name",
      "operator": "includes",
      "value": "Egor"
    }
  }'
```

Search returns the records inline. There is no polling and no snapshot IDs:

```json theme={null}
{
  "hits": [ /* records */ ],
  "total_hits": 579859,
  "took": 142
}
```

## Which datasets does Search support?

Search is in alpha and currently supports three LinkedIn datasets. For any other dataset, use [Filter](/api-reference/marketplace-dataset-api/filter-dataset).

| Dataset                                    | `dataset_id`            |
| ------------------------------------------ | ----------------------- |
| LinkedIn people profiles                   | `gd_l1viktl72bvl7bjuj0` |
| LinkedIn people profiles, contact-enriched | `gd_me5ppxjr2ge6icjuh0` |
| LinkedIn company information               | `gd_l1vikfnt1wgvvqz95w` |

<Note>
  Amazon datasets are next. More datasets are rolling out toward general availability in Q3 2026. Passing an unsupported `dataset_id` to Search returns a `404`.
</Note>

## How do I authenticate?

Search uses Bearer token authentication. Pass your API key in the `Authorization` header:

```bash theme={null}
Authorization: Bearer YOUR_API_KEY
```

Get your key from [account settings](/api-reference/authentication#how-do-i-generate-a-new-api-key%3F).

## What parameters does Search accept?

| Name           | Type            | Default | Required | Description                                                                                                                  |
| -------------- | --------------- | ------- | -------- | ---------------------------------------------------------------------------------------------------------------------------- |
| `filter`       | object          | -       | yes      | Filter expression. Cannot be empty. See the [filter syntax reference](/api-reference/marketplace-dataset-api/filter-syntax). |
| `size`         | number          | 100     | no       | Number of records to return. Search is best for up to 1,000 records per call.                                                |
| `sort`         | string or array | -       | no       | `default`, `random`, or a custom sort such as `[{"timestamp":"asc"}]`.                                                       |
| `search_after` | array           | -       | no       | Pagination cursor. Pass the `search_after` value from the previous response.                                                 |

## What does Search return?

| Name           | Type   | Description                                                 |
| -------------- | ------ | ----------------------------------------------------------- |
| `hits`         | array  | The matched records.                                        |
| `total_hits`   | number | Total records matching your filter.                         |
| `took`         | number | Server time in milliseconds.                                |
| `search_after` | array  | Cursor for the next page. Returned only when `sort` is set. |

## How do I sort and paginate?

Set `sort` to control ordering, and use the returned `search_after` cursor to page through results.

### Sample a dataset with random sort

Use `"sort": "random"` to pull a representative sample, for example before buying a dataset:

```bash theme={null}
curl -X POST "https://api.brightdata.com/datasets/search/gd_l1viktl72bvl7bjuj0" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "size": 10,
    "sort": "random",
    "filter": { "name": "name", "operator": "includes", "value": "Egor" }
  }'
```

### Page through results with search\_after

Set `"sort": "default"` to get a `search_after` cursor in the response. Request the first page:

```json theme={null}
{
  "size": 10,
  "sort": "default",
  "filter": { "name": "name", "operator": "includes", "value": "Egor" }
}
```

Pass the returned `search_after` array back to fetch the next page:

```json theme={null}
{
  "size": 10,
  "sort": "default",
  "search_after": [ /* value from previous response */ ],
  "filter": { "name": "name", "operator": "includes", "value": "Egor" }
}
```

### Sort by a custom field

Pass an array of field-to-direction objects to sort by a specific field:

```json theme={null}
{ "sort": [{ "timestamp": "asc" }] }
```

## How much does Search cost?

Search costs \$2.5 CPM (per 1,000 records returned), the same rate as the Marketplace. There is no charge when the filter returns 0 records.

## What errors can Search return?

| Status | Meaning                  | What to do                                                                                                  |
| ------ | ------------------------ | ----------------------------------------------------------------------------------------------------------- |
| `400`  | Bad filter or params     | Check field names with [Get dataset metadata](/api-reference/marketplace-dataset-api/get-dataset-metadata). |
| `401`  | Bad or missing API key   | Check your Bearer token.                                                                                    |
| `402`  | Not enough funds         | Top up your balance or reduce `size`.                                                                       |
| `404`  | Unknown `dataset_id`     | Confirm the dataset is in the supported list above.                                                         |
| `422`  | Filter matched 0 records | Loosen your filter or check field values.                                                                   |
| `429`  | Rate limit hit           | Back off and retry.                                                                                         |

## FAQ

### Does Search support CSV or JSON file uploads?

No. Elasticsearch cannot read external files at query time. To filter against thousands of values in a CSV or JSON file, use the [Filter endpoint](/api-reference/marketplace-dataset-api/filter-dataset).

### How many records can Search return in one call?

Search is best for up to 1,000 records per call. For larger pulls, use [Filter](/api-reference/marketplace-dataset-api/filter-dataset), which is snapshot-based and supports bulk exports.

### Why do Search and Filter return slightly different results?

The two endpoints use different engines. Elasticsearch tokenizes text differently from the snapshot engine, so free-text matches can differ. On free-text fields, prefer the `includes` operator over `=`.

## Related

* [Dataset API overview](/api-reference/marketplace-dataset-api/overview)
* [Filter syntax reference](/api-reference/marketplace-dataset-api/filter-syntax)
* [Filter dataset (async, file uploads)](/api-reference/marketplace-dataset-api/filter-dataset)
* [Get dataset metadata](/api-reference/marketplace-dataset-api/get-dataset-metadata)


# Troubleshooting
Source: https://docs.brightdata.com/api-reference/marketplace-dataset-api/troubleshooting

Troubleshoot 4xx and 5xx errors from the Bright Data Web Unlocker API, SERP API, Web Scraper API, Marketplace Dataset API and Web Scraper IDE with fixes.

## Proxy networks troubleshooting

Error codes and description for proxy networks can be found [here](/proxy-networks/errorCatalog)

## Datasets API errors

### 200 ok (with error/status messages)

While technically a successful HTTP status, these responses carry messages indicating an ongoing process or a specific failure within the operation, requiring developer attention.

| Message                                                                      | Associated endpoints                     | Cause                                                                             | Suggested action                                                                                                                                                        |
| :--------------------------------------------------------------------------- | :--------------------------------------- | :-------------------------------------------------------------------------------- | :---------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `{status: "STATUS", message: "Snapshot is not ready yet, try again in 10s"}` | `GET /datasets/v3/snapshot/:snapshot_id` | The snapshot is still being built or processed.                                   | This is an interim status. Poll the endpoint again after the suggested delay (e.g., `10s`).                                                                             |
| `{status: "building", message: "Snapshot is building, try again in 10s"}`    | `GET /datasets/v3/snapshot/:snapshot_id` | The snapshot is actively being built.                                             | Poll the endpoint again after the suggested delay.                                                                                                                      |
| `{status: "failed", error_message: "ERROR_MESSAGE"}`                         | `GET /datasets/v3/progress/:snapshot_id` | A collection or snapshot operation has failed.                                    | Check the specific `ERROR_MESSAGE` for details. Review your collection setup and inputs.                                                                                |
| `Something went wrong. Bright Data is looking into it.`                      | `GET /datasets/v3/progress/:snapshot_id` | An internal system error occurred during monitoring.                              | This indicates a problem on Bright Data's end. No immediate action is required from your side, but you can contact support if it persists.                              |
| `Account is suspended`                                                       | `GET /datasets/v3/progress/:snapshot_id` | Your Bright Data account has been suspended, often due to a negative balance.     | Top up your account balance. If suspension extends beyond 24 hours, previously allocated static IPs may be released. Go to your Bright Data Zones page for updated IPs. |
| `Account is new, please activate it in account settings. URL`                | `GET /datasets/v3/progress/:snapshot_id` | Your newly created account requires activation.                                   | Log in to your Bright Data account settings and complete the activation process.                                                                                        |
| `No data found in discovery`                                                 | `GET /datasets/v3/progress/:snapshot_id` | The discovery phase of your collection did not yield any data.                    | Review your discovery configuration and target settings.                                                                                                                |
| `Snapshot is empty`                                                          | `GET /datasets/v3/progress/:snapshot_id` | The completed snapshot contains no data.                                          | Check your collection process and dataset configuration to ensure data is being collected.                                                                              |
| `Failed to deliver snapshot`                                                 | `GET /datasets/v3/progress/:snapshot_id` | An error occurred during the process of delivering the collected data to storage. | Review your delivery options and try again. If the issue persists, contact support.                                                                                     |
| `Failed to download response`                                                | `GET /datasets/v3/progress/:snapshot_id` | An error occurred while attempting to download the response.                      | This could be a transient network issue or a problem on Bright Data's side. Retry the request.                                                                          |
| `Failed to trigger collector`                                                | `GET /datasets/v3/progress/:snapshot_id` | An internal error prevented the collection from being triggered.                  | Retry the request. If the issue persists, contact support.                                                                                                              |
| `Internal server error`                                                      | `GET /datasets/v3/progress/:snapshot_id` | A general internal server error.                                                  | Retry the request. If the issue persists, contact support.                                                                                                              |
| `Input validation failed: DETAILS`                                           | `GET /datasets/v3/progress/:snapshot_id` | There was an internal validation error with the input.                            | Review your input against the API documentation. If it appears correct, contact support.                                                                                |

### 202 accepted

**Cause:** The request has been accepted for processing, but the operation is not yet complete. This is typically an interim status indicating that a resource is being prepared or built.

| Message                                                                      | Associated Endpoint(s)                   | Cause                                           | Suggested Action                                                                            |
| :--------------------------------------------------------------------------- | :--------------------------------------- | :---------------------------------------------- | :------------------------------------------------------------------------------------------ |
| `{status: "STATUS", message: "Snapshot is not ready yet, try again in 10s"}` | `GET /datasets/v3/snapshot/:snapshot_id` | The snapshot is still being built or processed. | This is an interim status. Poll the endpoint again after the suggested delay (e.g., `10s`). |
| `{status: "building", message: "Snapshot is building, try again in 10s"}`    | `GET /datasets/v3/snapshot/:snapshot_id` | The snapshot is actively being built.           | Poll the endpoint again after the suggested delay.                                          |

### 400 bad request

**Cause:** Your request was invalid, malformed, or contained incorrect parameters. This is a common client-side error, indicating an issue with how the request was constructed.

| Message                                                                                                                                | Associated Endpoint(s)                                                                   | Cause                                                                                          | Suggested Action                                                                                              |
| :------------------------------------------------------------------------------------------------------------------------------------- | :--------------------------------------------------------------------------------------- | :--------------------------------------------------------------------------------------------- | :------------------------------------------------------------------------------------------------------------ |
| `{validation_errors: [ERRORS]}`                                                                                                        | Many Scrapers Library endpoints, `GET /datasets/v3/snapshots`, Marketplace Dataset API   | General validation failure for request inputs; the ERRORS array will provide specific details. | Check the ERRORS array for specific validation issues and correct your request payload.                       |
| `dataset missing`                                                                                                                      | `POST /datasets/v3/trigger`                                                              | The required dataset ID or name is missing from the request.                                   | Ensure the dataset identifier is included in your request.                                                    |
| `Invalid attachments`                                                                                                                  | `POST /datasets/v3/trigger`                                                              | The attachments provided are not valid.                                                        | Verify the format and content of your attachments.                                                            |
| `This dataset is not allowed for API`                                                                                                  | `POST /datasets/v3/trigger`                                                              | The specified dataset cannot be triggered via API.                                             | Confirm that the dataset is configured for API access.                                                        |
| `This dataset is not ready yet`                                                                                                        | `POST /datasets/v3/trigger`                                                              | The dataset is still being prepared or is not in an active state.                              | Wait for the dataset to become ready before attempting to trigger a collection.                               |
| `No data to trigger`                                                                                                                   | `POST /datasets/v3/trigger`                                                              | The dataset has no inputs or configuration to initiate a collection.                           | Ensure your dataset has valid inputs defined.                                                                 |
| `Should be at least LIMIT inputs`                                                                                                      | `POST /datasets/v3/trigger`                                                              | The request does not meet the minimum number of required inputs.                               | Provide at least the specified `LIMIT` number of inputs.                                                      |
| `Snapshot is expired`                                                                                                                  | `GET /datasets/v3/snapshot/:snapshot_id`, `POST /datasets/v3/deliver/:snapshot_id`       | The snapshot you are trying to access has passed its validity period.                          | Trigger a new collection to generate a fresh snapshot.                                                        |
| `Snapshot is empty`                                                                                                                    | `GET /datasets/v3/snapshot/:snapshot_id`, `POST /datasets/v3/deliver/:snapshot_id`       | The collected snapshot contains no data.                                                       | Check your collection process and dataset configuration to ensure data is being collected.                    |
| `Snapshot is not ready`                                                                                                                | `GET /datasets/v3/snapshot/:snapshot_id/parts`, `POST /datasets/v3/deliver/:snapshot_id` | The snapshot is still being processed or is not in a state to be downloaded or delivered.      | Wait for the snapshot to complete processing. You can monitor its status via the "Monitor progress" endpoint. |
| `Snapshot input does not exist`                                                                                                        | `GET /datasets/v3/snapshot/:snapshot_id/input`                                           | The input file associated with the snapshot could not be found.                                | Verify the `snapshot_id` and ensure the input file was successfully generated.                                |
| `Snapshot is not running`                                                                                                              | `POST /datasets/v3/snapshot/:snapshot_id/cancel`                                         | You attempted to cancel a collection that is not currently active.                             | Check the status of the collection before attempting to cancel it.                                            |
| `Deliver options are missing`                                                                                                          | `POST /datasets/v3/deliver/:snapshot_id`                                                 | Required delivery configuration (e.g., destination details) was not provided.                  | Ensure all necessary delivery options are included in your request.                                           |
| `Snapshot is too big for single file delivery`                                                                                         | `POST /datasets/v3/deliver/:snapshot_id`                                                 | The collected data exceeds the limit for a single file delivery.                               | Consider delivering the snapshot in multiple parts or adjusting your collection scope.                        |
| `Batch size should be at least MIN_BATCH_SIZE`                                                                                         | `POST /datasets/v3/deliver/:snapshot_id`                                                 | The specified batch size for delivery is below the minimum allowed.                            | Increase the `batch_size` to at least `MIN_BATCH_SIZE`.                                                       |
| `Type <span class="math-inline">\{init\_types\.compr\_update is no longer supported\. Use '</span>{init_types.discover_all}' instead.` | Marketplace Dataset API                                                                  | The requested operation type is deprecated.                                                    | Update your request to use the recommended operation type, `${init_types.discover_all}`.                      |
| `Type ${init_types.update_existing} is no longer supported.`                                                                           | Marketplace Dataset API                                                                  | The requested operation type is no longer supported.                                           | Use a supported operation type.                                                                               |
| `Type ${init_types.discover_new} is no longer supported.`                                                                              | Marketplace Dataset API                                                                  | The requested operation type is no longer supported.                                           | Use a supported operation type.                                                                               |
| `Initiation reason is required.`                                                                                                       | Marketplace Dataset API                                                                  | The request is missing the required initiation reason.                                         | Include the `initiation reason` in your request.                                                              |
| `This feature is not available.`                                                                                                       | Marketplace Dataset API                                                                  | The requested feature is not supported for the dataset.                                        | Check the dataset's capabilities and adjust your request accordingly.                                         |
| `This dataset was rejected.`                                                                                                           | Marketplace Dataset API                                                                  | The dataset was rejected and cannot be processed.                                              | This dataset cannot be used. Contact Bright Data support for more information.                                |
| `This dataset is not ready.`                                                                                                           | Marketplace Dataset API                                                                  | The dataset is not in a state where it can be processed.                                       | Wait for the dataset to become ready.                                                                         |
| `This dataset does not support discovery. Supported types: ['${init_types.url_collection}']`                                           | Marketplace Dataset API                                                                  | The dataset does not support the requested discovery type.                                     | Use a supported discovery type, such as `url_collection`.                                                     |
| `Incorrect discovery collector id.`                                                                                                    | Marketplace Dataset API                                                                  | The discovery collector ID provided in the request is invalid.                                 | Verify the discovery collector ID.                                                                            |
| `View not found.`                                                                                                                      | Marketplace Dataset API                                                                  | The requested view is not available.                                                           | Check for correct view names and available views for the dataset.                                             |
| `This dataset does not support collection.`                                                                                            | Marketplace Dataset API                                                                  | The dataset does not support the requested collection operation.                               | Use an operation supported by the dataset.                                                                    |
| `Batch size must be at least 1000.`                                                                                                    | Marketplace Dataset API                                                                  | The batch size specified in the request is below the minimum allowed value.                    | Increase the `batch_size` to at least 1000.                                                                   |
| `{error: 'Snapshot failed'}`                                                                                                           | Marketplace Dataset API                                                                  | The snapshot operation failed.                                                                 | Review the collection process for underlying issues.                                                          |
| `{error: 'Invalid snapshot type'}`                                                                                                     | Marketplace Dataset API                                                                  | The snapshot type provided in the request is invalid.                                          | Use a valid snapshot type.                                                                                    |

### 401 unauthorized

**Cause:** Your request lacks valid authentication credentials for the API.

| Message        | Associated Endpoint(s)  | Cause                                                                      | Suggested Action                                                                                     |
| :------------- | :---------------------- | :------------------------------------------------------------------------- | :--------------------------------------------------------------------------------------------------- |
| `Unauthorized` | Marketplace Dataset API | The API key or authentication credentials provided are invalid or missing. | Ensure your API key and authentication credentials are correct and properly included in the request. |

### 402 payment required

**Cause:** Your account balance is insufficient to process the requested API operation.

| Message                                                                                                                                                                           | Associated Endpoint(s)  | Cause                                                              | Suggested Action                                                                            |
| :-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | :---------------------- | :----------------------------------------------------------------- | :------------------------------------------------------------------------------------------ |
| `{error: 'Your current balance is insufficient to process this data collection request. Please add funds to your account or adjust your request to continue. ($220 is missing)'}` | Marketplace Dataset API | The user's account balance is insufficient to process the request. | Add funds to your Bright Data account or adjust your request parameters to reduce its cost. |

### 403 forbidden

**Cause:** You do not have permission to access the requested API resource, or your request is being blocked by a Bright Data policy.

| Message                | Associated Endpoint(s)  | Cause                                                                    | Suggested Action                                                                     |
| :--------------------- | :---------------------- | :----------------------------------------------------------------------- | :----------------------------------------------------------------------------------- |
| `Access denied.`       | Marketplace Dataset API | The user does not have the necessary permissions to access the resource. | Check your account permissions and ensure you have access to the requested resource. |
| `Cannot skip billing.` | Marketplace Dataset API | The user attempted to skip billing, which is not allowed.                | Billing                                                                              |

### 404 not found

**Cause:** The specific API resource you're trying to access does not exist in the system. You may encounter this error when trying to access a dataset, snapshot, delivery, or a general request that isn't found.

| Message                   | Associated Endpoint(s)                                                                      | Cause                                                                                                        | Suggested Action                                                           |
| :------------------------ | :------------------------------------------------------------------------------------------ | :----------------------------------------------------------------------------------------------------------- | :------------------------------------------------------------------------- |
| `dataset does not exist`  | POST /datasets/v3/trigger, Marketplace Dataset API                                          | The specified dataset ID or name could not be found.                                                         | Double-check the dataset identifier in your request.                       |
| `Snapshot does not exist` | Many scrapers endpoints, Marketplace Dataset API                                            | The snapshot\_id provided does not correspond to an existing snapshot.                                       | Verify the snapshot\_id. It might be incorrect, expired, or never existed. |
| `Delivery does not exist` | GET /datasets/v3/delivery/:delivery\_id                                                     | The delivery\_id provided could not be found.                                                                | Confirm the delivery\_id is correct.                                       |
| `Request not found`       | Scraper Studio API, Marketplace Dataset API                                                 | The specified request ID or other request details were not found in the Bright Data Marketplace Dataset API. | Verify your request details and ensure they are valid.                     |
| `Page not found`          | Invalid URL, which suggests the URL might be broken or dead (specific to Web Unlocker API). | Verify the URL is correct and active.                                                                        |                                                                            |

### 422 unprocessable entity

**Cause:** The API request was well-formed but could not be processed due to semantic errors in the data provided.

| Message                                                | Associated Endpoint(s)  | Cause                                                                        | Suggested Action                                                      |
| :----------------------------------------------------- | :---------------------- | :--------------------------------------------------------------------------- | :-------------------------------------------------------------------- |
| `{error: 'Provided filter did not match any records'}` | Marketplace Dataset API | The filter provided in the request did not match any records in the dataset. | Adjust your filter criteria to match existing records in the dataset. |

### 429 too many requests

**Cause:** You have exceeded a rate limit or the maximum number of parallel jobs allowed for your account or dataset when using the API.

| Message                                                                               | Associated Endpoint(s)                                                                                         | Cause                                                                                          | Suggested Action                                                                                                                                       |
| :------------------------------------------------------------------------------------ | :------------------------------------------------------------------------------------------------------------- | :--------------------------------------------------------------------------------------------- | :----------------------------------------------------------------------------------------------------------------------------------------------------- |
| `You have too many running jobs for this dataset.`                                    | `POST /datasets/v3/trigger`                                                                                    | You’ve hit the concurrency limit for collection jobs on this dataset.                          | Wait for some active jobs to complete. For large workloads, consider combining multiple inputs into a single collection request to reduce concurrency. |
| `{error: 'Maximum limit of ${max_parallel_jobs} jobs per dataset has been exceeded'}` | Marketplace Dataset API                                                                                        | You have exceeded the maximum allowed number of parallel jobs for the dataset.                 | Reduce the number of concurrent jobs, or wait for existing jobs to complete before initiating new ones.                                                |
|                                                                                       | This error code implies a rate limit (rare) and auto-throttling by Bright Data (specific to Web Unlocker API). | Open a ticket or email [support@brightdata.com](mailto:support@brightdata.com) for assistance. | Confirm the delivery\_id is correct.                                                                                                                   |

### 500 internal server error

**Cause:** An unexpected error occurred on the Bright Data API server. These are server-side issues that are typically outside of your direct control.

| Message                 | Associated Endpoint(s)                                                                 | Cause                                            | Suggested Action                                                                                                                                                                   |
| :---------------------- | :------------------------------------------------------------------------------------- | :----------------------------------------------- | :--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `Internal server error` | Many Scrapers Library endpoints, `GET /datasets/v3/snapshots`, Marketplace Dataset API | A general, unhandled server-side error occurred. | This is typically a temporary issue. Retry your request after a short delay. If the problem persists, contact Bright Data support with the request details and any error messages. |
| `Internal error.`       | Marketplace Dataset API                                                                | An unexpected error occurred on the server.      | This is a server-side issue. Retry the request. If the problem persists, contact Bright Data support.                                                                              |

### 502 bad gateway

**Cause:** The Bright Data API server received an invalid response from an upstream server.

| Message                                                                                      | Associated Endpoint(s)  | Cause                                                                    | Suggested Action                                                                                     |
| :------------------------------------------------------------------------------------------- | :---------------------- | :----------------------------------------------------------------------- | :--------------------------------------------------------------------------------------------------- |
| `Unexpected error. The server encountered an unexpected error while processing the request.` | Marketplace Dataset API | The server encountered an unexpected error while processing the request. | This is typically a temporary server-side issue. Retry the request. If it persists, contact support. |

### 503 service unavailable

| Message               | Associated Endpoint(s)       | Cause                                                   | Suggested Action                                                                                                                    |
| :-------------------- | :--------------------------- | :------------------------------------------------------ | :---------------------------------------------------------------------------------------------------------------------------------- |
| `Service Unavailable` | Specific to Web Unlocker API | Browser check failed or browser check wasn't completed. | This indicates a temporary service unavailability or a browser rendering issue. Retry the request. If it persists, contact support. |

## Dataset API errors

### 400 - Bad Request

Indicates that the request was invalid or cannot be processed.

| Error Message                                                                                       | Cause                                                                              |
| :-------------------------------------------------------------------------------------------------- | :--------------------------------------------------------------------------------- |
| `{validation_errors: ["filter.name is required"]}`                                                  | The request is missing a required filter parameter (e.g., `filter.name`).          |
| `{validation_errors: ["Invalid input provided"]}`                                                   | The input provided in the request is not valid.                                    |
| `Type ${init_types.compr_update} is no longer supported. Use '${init_types.discover_all}' instead.` | The requested operation type is deprecated.                                        |
| `Type ${init_types.update_existing} is no longer supported.`                                        | The requested operation type is no longer supported.                               |
| `Type ${init_types.discover_new} is no longer supported.`                                           | The requested operation type is no longer supported.                               |
| `Initiation reason is required.`                                                                    | The request is missing the required initiation reason.                             |
| `This feature is not available.`                                                                    | The requested feature is not supported for the dataset.                            |
| `This dataset was rejected.`                                                                        | The dataset was rejected and cannot be processed.                                  |
| `This dataset is not ready.`                                                                        | The dataset is not in a state where it can be processed.                           |
| `This dataset does not support discovery. Supported types: ['${init_types.url_collection}']`        | The dataset does not support the requested discovery type.                         |
| `Incorrect discovery collector id.`                                                                 | The discovery collector ID provided in the request is invalid.                     |
| `View not found.`                                                                                   | The requested view is not available.                                               |
| `This dataset does not support collection.`                                                         | The dataset does not support the requested collection operation.                   |
| `Batch size must be at least 1000.`                                                                 | The batch size specified in the request is below the minimum allowed value.        |
| `{error: 'Snapshot failed'}`                                                                        | The snapshot operation failed.                                                     |
| `{error: 'Snapshot not ready'}`                                                                     | The snapshot is not ready for processing.                                          |
| `{error: 'Invalid snapshot type'}`                                                                  | The snapshot type provided in the request is invalid.                              |
| `{validation_errors: [e.message]}`                                                                  | A validation error occurred, and the specific message is included in the response. |

***

### 401 - Unauthorized

Indicates that the user is not authorized to access the requested resource.

| Error Message  | Cause                                                                      |
| :------------- | :------------------------------------------------------------------------- |
| `Unauthorized` | The API key or authentication credentials provided are invalid or missing. |

***

### 402 - Payment Required

Indicates that the user does not have sufficient funds to process the request.

| Error Message                                                                                                                                                                     | Cause                                                              |
| :-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | :----------------------------------------------------------------- |
| `{error: 'Your current balance is insufficient to process this data collection request. Please add funds to your account or adjust your request to continue. ($220 is missing)'}` | The user's account balance is insufficient to process the request. |

***

### 403 - Forbidden

Indicates that the user does not have permission to access the requested resource.

| Error Message          | Cause                                                                    |
| :--------------------- | :----------------------------------------------------------------------- |
| `Access denied.`       | The user does not have the necessary permissions to access the resource. |
| `Cannot skip billing.` | The user attempted to skip billing, which is not allowed.                |

***

### 404 - Not Found

Indicates that the requested resource could not be found.

| Error Message                   | Cause                                                 |
| :------------------------------ | :---------------------------------------------------- |
| `{error: 'Dataset not found'}`  | The specified dataset ID does not exist.              |
| `{error: 'Snapshot not found'}` | The specified snapshot ID does not exist.             |
| `Dataset does not exist.`       | The dataset referenced in the request does not exist. |
| `Request not found.`            | The specified request ID does not exist.              |

***

### 422 - Unprocessable Entity

Indicates that the request was well-formed but could not be processed due to semantic errors.

| Error Message                                          | Cause                                                                        |
| :----------------------------------------------------- | :--------------------------------------------------------------------------- |
| `{error: 'Provided filter did not match any records'}` | The filter provided in the request did not match any records in the dataset. |

***

### 429 - Too Many Requests

Indicates that the user has exceeded the rate limit or the maximum number of parallel jobs.

| Error Message                                                                         | Cause                                                                              |
| :------------------------------------------------------------------------------------ | :--------------------------------------------------------------------------------- |
| `{error: 'Maximum limit of ${max_parallel_jobs} jobs per dataset has been exceeded'}` | The user has exceeded the maximum allowed number of parallel jobs for the dataset. |

***

### 500 - Internal Server Error

Indicates that an unexpected error occurred on the server.

| Error Message     | Cause                                       |
| :---------------- | :------------------------------------------ |
| `Internal error.` | An unexpected error occurred on the server. |

***

### 502 - Bad Gateway

Indicates that the server received an invalid response from an upstream server.

| Error Message     | Cause                                                                    |
| :---------------- | :----------------------------------------------------------------------- |
| Unexpected error. | The server encountered an unexpected error while processing the request. |


# Update view delivery settings
Source: https://docs.brightdata.com/api-reference/marketplace-dataset-api/update-view-delivery-settings

api-reference/dca-api PUT /datasets/views/{view_id}/delivery_settings
Set the delivery destination, credentials, filename template and batch options for a single dataset view. Returns the updated view id. Covers 250+ domains.

Replaces the delivery configuration for a dataset view. The `deliver.type` field selects the destination and the remaining fields inside `deliver` must match the schema returned by [Get destination type schema](/api-reference/marketplace-dataset-api/get-destination-type-schema) for that destination.

## How to update a view

1. Call [Get delivery options](/api-reference/marketplace-dataset-api/get-delivery-options) to confirm the destination type is supported.
2. Call [Get destination type schema](/api-reference/marketplace-dataset-api/get-destination-type-schema) with that destination type to get the required fields.
3. Send the `PUT` request documented on this page with the `deliver` object populated.

<Note>
  Setting `tar: true` bundles all output files into a single TAR archive. Setting `compress: true` gzips each delivered file. Both can be combined.
</Note>

<Note>
  `batch_size` is the maximum number of records per output file. Use it to split large deliveries into smaller files. The maximum per-batch size is 5 GB.
</Note>

To apply the same configuration to many views at once, use [Bulk update view delivery settings](/api-reference/marketplace-dataset-api/bulk-update-view-delivery-settings) instead.


# Scraper async requests
Source: https://docs.brightdata.com/api-reference/rest-api/scraper/asynchronous-requests

api-reference/rest-api/scraper/scraper-rest-api.json POST /datasets/v3/trigger
Trigger a Bright Data Web Scraper API async collection (1000+ scrapers). Returns a snapshot ID you use to monitor progress and download results when ready.

Related guide: [Scrapers Introduction](/datasets/scrapers/scrapers-library/overview)

<a href="https://www.postman.com/bright-data-api/bright-data-api/request/1z189u8/trigger-chatgpt-search-scraping">
  <img alt="Run in Postman" />
</a>


# Crawl API
Source: https://docs.brightdata.com/api-reference/rest-api/scraper/crawl-api

api-reference/rest-api/scraper/crawl-rest-api.json POST /datasets/v3/trigger
Trigger a Bright Data Crawl API collection that maps and extracts content across an entire domain. Returns a snapshot ID across 1000+ Bright Data scrapers.

Related guide: [Crawl API Introduction](/scraping-automation/crawl-api/overview)


# SERP async response
Source: https://docs.brightdata.com/api-reference/rest-api/serp/get-results

async-api-reference GET /serp/get_result
Use the Bright Data SERP API async endpoint (31 languages). GET /serp/get_result submits or retrieves a queued SERP request and returns 200 OK as JSON.

<Tip>
  The sample 200 response has been abbreviated for brevity.
</Tip>


# Deliver snapshot to storage or webhook
Source: https://docs.brightdata.com/api-reference/scrapers/delivery-apis/deliver-snapshot

api-reference/dca-api POST /datasets/v3/deliver/{snapshot_id}
Deliver a Bright Data Web Scraper API snapshot to webhook, S3, GCS, Azure, or Snowflake. Specify the snapshot ID and target in the request body.



# Download snapshot
Source: https://docs.brightdata.com/api-reference/scrapers/delivery-apis/download-snapshot

api-reference/dca-api GET /datasets/v3/snapshot/{snapshot_id}
Download results from a completed Bright Data Web Scraper API async job by snapshot ID. Pull-based delivery with a 5 GB per-request size limit.

Use this endpoint to pull scraped data directly from the Bright Data API once an async collection job finishes. This is the simplest delivery method: you trigger a job, poll until the snapshot is `ready`, then download the results on demand.

## When to use API download

API download is the right choice when:

* You want a pull-based workflow instead of pushing data to your own infrastructure.
* You don't need results delivered to a specific storage bucket or webhook endpoint.
* Your result set fits within the 5 GB per-request size limit.
* You are prototyping or running ad-hoc jobs and don't want to configure a delivery destination.

If you need automatic delivery or larger result sets, see the other [delivery options](/datasets/scrapers/scrapers-library/delivery-options) (webhooks, Amazon S3, Google Cloud Storage, Azure, Snowflake).

## How it works

1. Trigger an async collection with [`POST /datasets/v3/trigger`](/api-reference/rest-api/scraper/asynchronous-requests). The response contains a `snapshot_id`.
2. Poll [`GET /datasets/v3/progress/{snapshot_id}`](/api-reference/scrapers/management-apis/monitor-progress) until `status` is `ready`.
3. Call this endpoint with the `snapshot_id` to download the data.

<Note>
  Results are retained for 16 days after collection. Download within that window, or configure a [delivery option](/datasets/scrapers/scrapers-library/delivery-options) to have data pushed to your storage automatically.
</Note>

## Quick example

```bash cURL theme={null}
curl "https://api.brightdata.com/datasets/v3/snapshot/s_m4x7enmven8djfqak?format=json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -o results.json
```

The response is the raw dataset in the format you request. JSON returns an array of records, NDJSON and JSON Lines return one record per line, and CSV returns a header row followed by rows.

## Downloading large snapshots in parts

For snapshots larger than a few hundred megabytes, split the download into parts to avoid timeouts and memory pressure on your client:

1. Request the first batch with a `batch_size` (minimum 1000 records) and `part=1`.
2. Call [`GET /datasets/v3/snapshot/{snapshot_id}/parts`](/api-reference/scrapers/management-apis/get-snapshot-delivery-parts) to see how many parts exist.
3. Request each remaining part by incrementing the `part` parameter.

Keep `batch_size`, `format` and `compress` identical across all part requests, otherwise the API returns an error.

## Limits

| Limit                         | Value                            |
| :---------------------------- | :------------------------------- |
| Max download size per request | 5 GB                             |
| Result retention              | 16 days                          |
| Minimum `batch_size`          | 1000 records                     |
| Supported formats             | `json`, `ndjson`, `jsonl`, `csv` |

## Endpoint


# Get all scrapers
Source: https://docs.brightdata.com/api-reference/scrapers/management-apis/get-scrapers

api-reference/dca-api get /datasets/v3/scrapers
Use the Bright Data Web Scraper API to list every scraper on your account. GET /datasets/v3/scrapers returns each scraper's dataset ID and name as JSON.



# Get snapshots
Source: https://docs.brightdata.com/api-reference/scrapers/management-apis/get-snapshots

api-reference/dca-api get /datasets/v3/snapshots
Use Bright Data Web Scraper API management endpoints to get Snapshots. GET /datasets/v3/snapshots returns snapshot or job status as JSON.



# Monitor progress
Source: https://docs.brightdata.com/api-reference/scrapers/management-apis/monitor-progress

api-reference/dca-api get /datasets/v3/progress/{snapshot_id}
Use Bright Data Web Scraper API management endpoints to monitor Progress. GET /datasets/v3/progress/{id} returns snapshot or job status as JSON.

* [**Asynchronous Usage**](/api-reference/rest-api/scraper/asynchronous-requests)**:** Trigger a data collection job via the async endpoint (`/trigger`), receive a `snapshot_id`, and poll the Monitor Progress API until the status is ready, then download the results.
* [**Synchronous Usage**](/api-reference/scrapers/synchronous-requests)**:** If a sync request (`/scrape`) exceeds the 1-minute timeout, receive a `snapshot_id` to poll the Monitor Progress API and download the results once they are ready.

The Monitor Progress API provides flexibility and stability, allowing efficient handling of large data volumes by differentiating between immediate and delayed result retrievals.

<Tip>
  If the request takes too long, we recommend sending an Asynchronous request.
</Tip>


# Synchronous requests
Source: https://docs.brightdata.com/api-reference/scrapers/synchronous-requests

api-reference/dca-api POST /datasets/v3/scrape
Use the Bright Data Web Scraper API to synchronous Requests. POST /datasets/v3/scrape returns scraped data synchronously in a single response.

## How It Works

This synchronous API endpoint allows users to send a scraping request and receive the results in real-time directly in the response, at the point of request - such as a terminal or application - without the need for external storage or manual downloads. This approach streamlines the data collection process by eliminating additional steps for retrieving results.

You can specify the desired output format using the format parameter. If no format is provided, the response will default to JSON.

## Timeout Limit

Please note that this synchronous request is subject to a 1 minute timeout limit. If the data retrieval process exceeds this limit, the API will return an HTTP 202 response, indicating that the request is still being processed. In such cases, you will receive a snapshot ID to monitor and retrieve the results asynchronously via the Monitor Snapshot and Download Snapshot endpoints.

Example response on timeout:

```JSON 202 theme={null}
{
  "snapshot_id": "s_xxx",
  "message": "Your request is still in progress and cannot be retrieved in this call. Use the provided Snapshot ID to track progress via the Monitor Snapshot endpoint and download it once ready via the Download Snapshot endpoint."
}
```


# Google Flights async request
Source: https://docs.brightdata.com/api-reference/serp/google-flights/async

Use the Bright Data Google Flights async endpoint (31 languages). Submit a request, poll the job ID and retrieve results as JSON with 200 OK on success.

```txt wrap theme={null}
https://www.google.com/travel/flights/search?tfs=CBwQAhonEgoyMDI2LTAzLTE2agsIAhIHL20vMGszcHIMCAISCC9tLzA0anBsGicSCjIwMjYtMDMtMjRqDAgCEggvbS8wNGpwbHILCAISBy9tLzBrM3BAAUgBcAGCAQsI____________AZgBAQ
```

<ParamField type="boolean">
  Set `async=true` in the request URL to enable asynchronous requests.

  ```txt wrap theme={null}
  https://api.brightdata.com/request?async=true
  ```
</ParamField>

## Parameters

<ParamField type="string">
  String representing flight search parameters

  ```txt wrap theme={null}
  https://www.google.com/travel/flights/search?tfs=CBwQAhonEgoyMDI2LTAzLTE2agsIAhIHL20vMGszcHIMCAISCC9tLzA0anBsGicSCjIwMjYtMDMtMjRqDAgCEggvbS8wNGpwbHILCAISBy9tLzBrM3BAAUgBcAGCAQsI____________AZgBAQ
  ```
</ParamField>

<RequestExample>
  ```shell cURL highlight={1} theme={null}
    curl -X POST https://api.brightdata.com/request?async=true \
    --header "Content-Type: application/json" \
    --header "Authorization: Bearer API_KEY" \
    --data '{
      "zone": "serp_api1",
      "url": "https://www.google.com/travel/flights/search?tfs=CBwQAhonEgoyMDI2LTAzLTE2agsIAhIHL20vMGszcHIMCAISCC9tLzA0anBsGicSCjIwMjYtMDMtMjRqDAgCEggvbS8wNGpwbHILCAISBy9tLzBrM3BAAUgBcAGCAQsI____________AZgBAQ",
      "format": "json"
    }'
  ```

  ```shell Native proxy highlight={4} theme={null}
  curl -i --silent --compressed \
    -H "Content-Type: application/json"
    -H "Authorization: Bearer API_KEY" \
    -d $'{"country":"us","query":{"q":"pizza"}}'
    "https://api.brightdata.com/serp/req?customer=CUSTOMER_USERNAME&zone=ZONE_NAME"
  ```

  ```js Node.js highlight={2} theme={null}
  (async () => {
    const response = await fetch('https://api.brightdata.com/request?async=true', {
      method: 'POST',
      headers: {
        'Content-Type': 'application/json',
        'Authorization': 'Bearer API_KEY'
      },
      body: JSON.stringify({
        zone: 'serp_api1',
        url: 'https://www.google.com/travel/flights/search?tfs=CBwQAhonEgoyMDI2LTAzLTE2agsIAhIHL20vMGszcHIMCAISCC9tLzA0anBsGicSCjIwMjYtMDMtMjRqDAgCEggvbS8wNGpwbHILCAISBy9tLzBrM3BAAUgBcAGCAQsI____________AZgBAQ',
        format: 'json'
      })
    });
    
    const data = await response.text();
    console.log(data);
  })();
  ```

  ```python Python highlight={17} theme={null}
  import requests

  # API Configuration
  headers = {
      'Content-Type': 'application/json',
      'Authorization': 'Bearer API_KEY',
  }

  payload = {
      'zone': 'serp_api1',
      'url': 'https://www.google.com/travel/flights/search?tfs=CBwQAhonEgoyMDI2LTAzLTE2agsIAhIHL20vMGszcHIMCAISCC9tLzA0anBsGicSCjIwMjYtMDMtMjRqDAgCEggvbS8wNGpwbHILCAISBy9tLzBrM3BAAUgBcAGCAQsI____________AZgBAQ',
      'format': 'json'
  }

  # Make the request
  response = requests.post(
      'https://api.brightdata.com/request?async=true', 
      json=payload, 
      headers=headers
  )

  print(response.text)
  ```
</RequestExample>

<ResponseExample>
  ```json 200 highlight={27} theme={null}
  {
    "status_code": 200,
    "headers": {
      "accept-ch": "Sec-CH-UA-Arch, Sec-CH-UA-Bitness, Sec-CH-UA-Full-Version, Sec-CH-UA-Full-Version-List, Sec-CH-UA-Model, Sec-CH-UA-WoW64, Sec-CH-UA-Form-Factors, Sec-CH-UA-Platform, Sec-CH-UA-Platform-Version",
      "alt-svc": "h3=\":443\"; ma=2592000,h3-29=\":443\"; ma=2592000",
      "cache-control": "no-cache, no-store, max-age=0, must-revalidate",
      "content-security-policy": "script-src 'report-sample' 'nonce-rG9xWwDHOfDPrr2gBY9D3w' 'unsafe-inline';object-src 'none';base-uri 'self';report-uri /_/FlightsFrontendUi/cspreport;worker-src 'self' blob:, script-src 'unsafe-inline' 'unsafe-eval' blob: data: 'self' https://apis.google.com https://ssl.gstatic.com https://www.google.com https://www.googletagmanager.com https://www.gstatic.com https://www.google-analytics.com https://maps.googleapis.com https://maps.googleapis.com/maps/ https://maps.googleapis.com/maps-api-v3/ https://adservice.google.com/ https://www.googleadservices.com/pagead/conversion_async.js https://www.googleadservices.com https://www.google.com/tools/feedback/ https://www.gstatic.com/feedback/js/ https://www.gstatic.com/inproduct_help/ https://www.gstatic.com/support/content/ https://www.gstatic.com/uservoice/feedback/client/web/live/ https://www.gstatic.com/uservoice/surveys/resources/prod/js/survey/ https://support.google.com/inapp/;report-uri /_/FlightsFrontendUi/cspreport/allowlist;worker-src blob: 'self', require-trusted-types-for 'script';report-uri /_/FlightsFrontendUi/cspreport",
      "content-security-policy-report-only": "script-src 'unsafe-inline' 'unsafe-eval' blob: data: https://www.gstatic.com/external_hosted/d3/v5/d3.min.js https://translate.google.com/translate_a/element.js https://www.gstatic.com/_/mss/boq-one-google/_/ https://www.gstatic.com/og/_/js/ https://apis.google.com/js/api.js https://apis.google.com/js/client.js https://maps.googleapis.com/maps/api/js https://www.google.com/tools/feedback/chat_load.js https://www.google.com/tools/feedback/help_api.js https://www.google.com/tools/feedback/load.js https://www.google.com/tools/feedback/open.js https://www.google.com/tools/feedback/open_to_help_guide_lazy.js https://www.gstatic.com/feedback/js/ https://www.gstatic.com/feedback/js/help/prod/service/lazy.min.js https://www.gstatic.com/inproduct_help/api/main.min.js https://www.gstatic.com/inproduct_help/chatsupport/chatsupport_button_v2.js https://www.gstatic.com/inproduct_help/service/lazy.min.js https://www.gstatic.com/uservoice/feedback/client/web/live/ https://www.gstatic.com/uservoice/surveys/resources/prod/js/survey/ https://www.googletagmanager.com/gtag/js https://www.google-analytics.com/analytics.js https://www.googletagmanager.com/gtag/destination https://www.gstatic.com/_/mss/boq-travel/_/js/k=boq-travel.FlightsFrontendUi_desktop_ms.en.2AgMd3uDtdI.2021.O/ https://apis.google.com/_/scs/abc-static/_/js/ https://maps.googleapis.com/maps-api-v3/api/js/ https://maps.googleapis.com/maps/vt https://maps.googleapis.com/maps/api/js/ https://maps.googleapis.com/maps/api/place/js/ https://translate.googleapis.com/_/translate_http/_/js/;report-uri /_/FlightsFrontendUi/cspreport/fine-allowlist",
      "content-type": "text/html; charset=utf-8",
      "cross-origin-opener-policy": "same-origin-allow-popups",
      "cross-origin-resource-policy": "same-site",
      "date": "Fri, 27 Feb 2026 00:16:08 GMT",
      "expires": "Mon, 01 Jan 1990 00:00:00 GMT",
      "p3p": "CP=\"This is not a P3P policy! See g.co/p3phelp for more info.\"",
      "permissions-policy": "ch-ua-arch=*, ch-ua-bitness=*, ch-ua-full-version=*, ch-ua-full-version-list=*, ch-ua-model=*, ch-ua-wow64=*, ch-ua-form-factors=*, ch-ua-platform=*, ch-ua-platform-version=*",
      "pragma": "no-cache",
      "reporting-endpoints": "default=\"/_/FlightsFrontendUi/web-reports?context=eJwVz3tUVVUeB_CrfM_dqLhEExFtRoulCArCVUCNuwlf0xQgcOGee87ZO0SRxBDioQ5oYstoShQCRyZLyEiMh4KQNZZpIY9EYFS0wtGZ0hTS1IAaVhDS_OaPz9q_vdfvtcc3T_LycDL5kGCy5P_x-Bmm8HkzTD8GzTUFBs81FZA9PWGmzDnLTQt2PmuyuIebmGe4Kd473BQwaQ16lCjcSIhCxo4ovHo_Ct9lRyO-MBprSfTFaPg8ikYQueQdg8leNmRH2DAvwYaunTZ8n0txiQ0jx2yoa7chzDkWK8hKcoDAPxYiMhbPk7ZtsWgnHSTllViEusfhqkccBubGob8zDqFj7LjraceMMDv-EmXHi3F2PNhox-QMO35-2Y6j79ixqtyO-k47dvTYUTpqx0pXFU1uKnI8VbzpreKejwoRpmI92RShwhStYnaKio5sFUauiuE8FTcLVDRUqzhfq-LTOhWDZ1SEnFMR3KTiiSsqFtxWMf6-ii9JQ7-KoOkO-Hg4kO_lwPilDuxc7kBvkgOluxx4qdiB_UccmF7hQMhRB3qIrcGBRR86cKmF8rscKPqJaoYceGashqZxGspcNHxBkqdoWDxVg2WahlyycI4GvwUaxvlpOE5qSUGghm-Xaqh_WsPKKA1RqoalGzTEvqihbbOGdakaXNI1HMzScKVIw6PDGn74gN6rNCSSjeTXGg2bP9Mw7XMNvU0aQjo19FyhmHR9peHafzTc66M-f9CR_qSOZZ46niK1wTp8Y3TMNnR8uVnH6m06VFKWq-O7fB25JTqeqNBR1apj_nkd7e06Okhqhw7tho6QmzrcBnXcG9Lh52RAJc-TookGtJkG4r0N3CUJAQZaLAbeWGbgQIiBEvLBKgOBqw0kRhrwtBnYl2RgwmYD1aQxzcA5MivLwMQtBqa-YSBurwGnQgPr6gwUnqaeZwwYZw08aKU5nQairxmY02dg3O8G6pjAQy-BPuKxUKAjQKB7kUD1CoEacpycIp-Q0-QMOUum_FlgSbjAUrKMhBAvh0CUIZAYL2B-QWDFJoFDWwWOZgt45wj4klRSniew9a8Cg2SYNBYLtJI7hwSGSgVGDgt0vSeQ_r7A-gqBSVUCe2sFbtQJ9H4k4PKxwMEvBErJ9kYBrUmgv1ngwQWK2wV-I-UXaS7BZYH3vhK4_bVA5TcC07sF6kg9ufwvgeLrNPeGQNtNgbg7Av_oFVh-X6C2T8C5X2DbLwKTBwVGRwTyRwUeGyOxBhLVzhLHyE-kZYLEqItEzFSJhJkSWY9LPPqjxJJZEiFkO1nrKZFMhskn8yXsC6mWpAdIHCT9Fgn_pyQGSA2XqCP7QyXywyRiV0qcDqecGIkLmsQOXeIkcRMSf18vUZ8oMZQkMbhR4nKyRHCaxL50iZEM2otUZUl05kik5knMel3iHBF7JB4rkKgslviUnCXHSiV-I43vSpyokjhSI_HzqbeUb3PLlE27ypQDr5UpBe-XKUNtZcrE3jIl79o_lf1kS_lFZTfZQ94iAbO7lFCSMf2qsovcqryq1M3-RhnI6VZct3crscuvK7OmjTVnEq_Hx5q_bnIy3yH9ZJj8TkzNTubBzAgzsiLMt_8WaR4gc1uizIvJw_xoc3y7lflctLLTt6zscxL7vZWF91pZxA9W5nbXyjxI6I9W9hzx67Oyol-trIS0mTj7UOHsJGkmLaRuEmcfuXL2MTlFzhHnqZzpMznbSWLmcea-gLNpizhrDeTsnSDOSsnMYM7crJzNI3tDOdtHGldw5rqKs19Wc9b2J86ukKJnOKsn18neZzkrJC6RnE1Yw1kwWUNqiLuNs2LytMZZiUH1CZwpiZx1pNDsNM6yt3A2sJWzbdmcfUYu5NCeOzgbRyYQN-JOPMgMUkDuvsJZ9W7OGkh3Hme9ZJiMEtNr1PN1zl4muWRkH2eZhZz5vsnZ26SMjCnibO3bnP23lP7wLuUfoX0rOHuumrNIsq6Gsw0k8xhnh05wVt7AWSWpItEn6d7C2RGyuJWzh-c5O9xGJ1ncQf_qpLxLnNWSFjL_35xV3OJsiovz-ebdnWbXE5XHW8c-6bsuLT0-KyNh64YU36SMtNSsDamJvkkpyS9szMr03ZIcb_G3BPlbLIF-_pb4l_z_BxaAqwI\"",
      "server": "ESF",
      "vary": "Sec-Fetch-Dest, Sec-Fetch-Mode, Sec-Fetch-Site",
      "x-content-type-options": "nosniff",
      "x-frame-options": "SAMEORIGIN",
      "x-ua-compatible": "IE=edge",
      "x-xss-protection": "0",
      "connection": "close",
      "transfer-encoding": "chunked"
    },
    "body": "<!doctype html><html lang=\"en\" dir=\"ltr\"><head><base href=\"https://www.google.com.tw/\"><link rel=\"preconnect\" href=\"//www.gstatic.com\"><meta name=\"referrer\" content=\"strict-origin-when-cross-origin\"><meta name=\"viewport\" content=\"width=device-width,initial-scale=1.0,minimum-scale=1.0,maximum-scale=1.0,user-scalable=no,interactive-widget=resizes-content\"><meta http-equiv=\"Content-Type\" content=\"text/html; charset=UTF-8\"><meta name=\"color-scheme\" content=\"light dark\"><meta name=\"google-site-verification\" content=\"sxp7zFOFUzk09RdlFhuH2SoCn5nOkXgomiLeLIQ48p0\"><meta name=\"google-site-verification\" content=\"uceYfkdbu7tdKGywiwSr1p0cIbqdYOwMDkNq5jVFwMA\"><meta name=\"google-site-verification\" content=\"O5G3B9VUIil1GEVlPw3BfdeYn_kZeNd_6rsDolHah5w\"><meta name=\"google-site-verification\" content=\"hU5-JhTB7DyiEACObYa4GcZxXOTY5FykMqegq9lCAqA\"><meta name=\"application-name\" content=\"Google Flights\"><meta name=\"apple-mobile-web-app-title\" content=\"Google Flights\"><meta name=\"apple-mobile-web-app-status-ba..."
  }
  ```
</ResponseExample>


# Complex search
Source: https://docs.brightdata.com/api-reference/serp/google-flights/complex-search

Configure the Bright Data Google Flights Complex Search parameter to refine queries and return matching results as JSON or HTML. On port 44445.

```txt wrap theme={null}
https://www.google.com/travel/flights/search?tfs=CBwQAhoxEgoyMDI2LTAzLTEwKAAyAkJBagsIAhIHL20vMGszcHIMCAISCC9tLzA0anBsmgEBAUABSAFg-ApqBBABGABwAYIBCwj___________8BmAEC&tfu=EgYIABAAGAA
```

## Parameters

<ParamField type="string">
  String representing flight search parameters

  <Tip>
    You can perform a Complex search by adding filters (bags, stops, times, prices) on [Google Flights](https://www.google.com/travel/flights) and the `tfs` string will automatically update. You can then copy this updated `tfs` to reproduce the filtered search programmatically.
  </Tip>

  ```txt wrap theme={null}
  https://www.google.com/travel/flights/search?tfs=CBwQAhoxEgoyMDI2LTAzLTEwKAAyAkJBagsIAhIHL20vMGszcHIMCAISCC9tLzA0anBsmgEBAUABSAFg-ApqBBABGABwAYIBCwj___________8BmAEC&tfu=EgYIABAAGAA
  ```
</ParamField>

<RequestExample>
  ```shell cURL highlight={6} theme={null}
    curl -X POST https://api.brightdata.com/request \
    --header "Content-Type: application/json" \
    --header "Authorization: Bearer API_KEY" \
    --data '{
      "zone": "serp_api1",
      "url": "https://www.google.com/travel/flights/search?tfs=CBwQAhoxEgoyMDI2LTAzLTEwKAAyAkJBagsIAhIHL20vMGszcHIMCAISCC9tLzA0anBsmgEBAUABSAFg-ApqBBABGABwAYIBCwj___________8BmAEC&tfu=EgYIABAAGAA",
      "format": "raw"
    }'
  ```

  ```shell Native proxy highlight={4} theme={null}
  curl --proxy brd.superproxy.io:44445 \
    --proxy-user CUSTOMER_USERNAME:CUSTOMER_PASSWORD \
    --ssl-no-revoke \
    "https://www.google.com/travel/flights/search?tfs=CBwQAhoxEgoyMDI2LTAzLTEwKAAyAkJBagsIAhIHL20vMGszcHIMCAISCC9tLzA0anBsmgEBAUABSAFg-ApqBBABGABwAYIBCwj___________8BmAEC&tfu=EgYIABAAGAA"
  ```

  ```js Node.js highlight={10} theme={null}
  (async () => {
    const response = await fetch('https://api.brightdata.com/request', {
      method: 'POST',
      headers: {
        'Content-Type': 'application/json',
        'Authorization': 'Bearer API_KEY'
      },
      body: JSON.stringify({
        zone: 'serp_api1',
        url: 'https://www.google.com/travel/flights/search?tfs=CBwQAhoxEgoyMDI2LTAzLTEwKAAyAkJBagsIAhIHL20vMGszcHIMCAISCC9tLzA0anBsmgEBAUABSAFg-ApqBBABGABwAYIBCwj___________8BmAEC&tfu=EgYIABAAGAA',
        format: 'raw'
      })
    });
    
    const data = await response.text();
    console.log(data);
  })();
  ```

  ```python Python highlight={11} theme={null}
  import requests

  # API Configuration
  headers = {
      'Content-Type': 'application/json',
      'Authorization': 'Bearer API_KEY',
  }

  payload = {
      'zone': 'serp_api1',
      'url': 'https://www.google.com/travel/flights/search?tfs=CBwQAhoxEgoyMDI2LTAzLTEwKAAyAkJBagsIAhIHL20vMGszcHIMCAISCC9tLzA0anBsmgEBAUABSAFg-ApqBBABGABwAYIBCwj___________8BmAEC&tfu=EgYIABAAGAA',
      'format': 'raw'
  }

  # Make the request
  response = requests.post(
      'https://api.brightdata.com/request', 
      json=payload, 
      headers=headers
  )

  print(response.text)
  ```
</RequestExample>

<ResponseExample>
  ```json 200 highlight={27} theme={null}
  {
    "status_code": 200,
    "headers": {
      "accept-ch": "Sec-CH-UA-Arch, Sec-CH-UA-Bitness, Sec-CH-UA-Full-Version, Sec-CH-UA-Full-Version-List, Sec-CH-UA-Model, Sec-CH-UA-WoW64, Sec-CH-UA-Form-Factors, Sec-CH-UA-Platform, Sec-CH-UA-Platform-Version",
      "alt-svc": "h3=\":443\"; ma=2592000,h3-29=\":443\"; ma=2592000",
      "cache-control": "no-cache, no-store, max-age=0, must-revalidate",
      "content-security-policy": "script-src 'report-sample' 'nonce-uGMnXxsGvj8gSKK09fkpOQ' 'unsafe-inline';object-src 'none';base-uri 'self';report-uri /_/FlightsFrontendUi/cspreport;worker-src 'self' blob:, script-src 'unsafe-inline' 'unsafe-eval' blob: data: 'self' https://apis.google.com https://ssl.gstatic.com https://www.google.com https://www.googletagmanager.com https://www.gstatic.com https://www.google-analytics.com https://maps.googleapis.com https://maps.googleapis.com/maps/ https://maps.googleapis.com/maps-api-v3/ https://adservice.google.com/ https://www.googleadservices.com/pagead/conversion_async.js https://www.googleadservices.com https://www.google.com/tools/feedback/ https://www.gstatic.com/feedback/js/ https://www.gstatic.com/inproduct_help/ https://www.gstatic.com/support/content/ https://www.gstatic.com/uservoice/feedback/client/web/live/ https://www.gstatic.com/uservoice/surveys/resources/prod/js/survey/ https://support.google.com/inapp/;report-uri /_/FlightsFrontendUi/cspreport/allowlist;worker-src blob: 'self', require-trusted-types-for 'script';report-uri /_/FlightsFrontendUi/cspreport",
      "content-security-policy-report-only": "script-src 'unsafe-inline' 'unsafe-eval' blob: data: https://www.gstatic.com/external_hosted/d3/v5/d3.min.js https://translate.google.com/translate_a/element.js https://www.gstatic.com/_/mss/boq-one-google/_/ https://www.gstatic.com/og/_/js/ https://apis.google.com/js/api.js https://apis.google.com/js/client.js https://maps.googleapis.com/maps/api/js https://www.google.com/tools/feedback/chat_load.js https://www.google.com/tools/feedback/help_api.js https://www.google.com/tools/feedback/load.js https://www.google.com/tools/feedback/open.js https://www.google.com/tools/feedback/open_to_help_guide_lazy.js https://www.gstatic.com/feedback/js/ https://www.gstatic.com/feedback/js/help/prod/service/lazy.min.js https://www.gstatic.com/inproduct_help/api/main.min.js https://www.gstatic.com/inproduct_help/chatsupport/chatsupport_button_v2.js https://www.gstatic.com/inproduct_help/service/lazy.min.js https://www.gstatic.com/uservoice/feedback/client/web/live/ https://www.gstatic.com/uservoice/surveys/resources/prod/js/survey/ https://www.googletagmanager.com/gtag/js https://www.google-analytics.com/analytics.js https://www.googletagmanager.com/gtag/destination https://www.gstatic.com/_/mss/boq-travel/_/js/k=boq-travel.FlightsFrontendUi_desktop_ms.en.2AgMd3uDtdI.2021.O/ https://apis.google.com/_/scs/abc-static/_/js/ https://maps.googleapis.com/maps-api-v3/api/js/ https://maps.googleapis.com/maps/vt https://maps.googleapis.com/maps/api/js/ https://maps.googleapis.com/maps/api/place/js/ https://translate.googleapis.com/_/translate_http/_/js/;report-uri /_/FlightsFrontendUi/cspreport/fine-allowlist",
      "content-type": "text/html; charset=utf-8",
      "cross-origin-opener-policy": "same-origin-allow-popups",
      "cross-origin-resource-policy": "same-site",
      "date": "Fri, 27 Feb 2026 00:40:12 GMT",
      "expires": "Mon, 01 Jan 1990 00:00:00 GMT",
      "p3p": "CP=\"This is not a P3P policy! See g.co/p3phelp for more info.\"",
      "permissions-policy": "ch-ua-arch=*, ch-ua-bitness=*, ch-ua-full-version=*, ch-ua-full-version-list=*, ch-ua-model=*, ch-ua-wow64=*, ch-ua-form-factors=*, ch-ua-platform=*, ch-ua-platform-version=*",
      "pragma": "no-cache",
      "reporting-endpoints": "default=\"/_/FlightsFrontendUi/web-reports?context=eJwVzntYVVUaBvCjvOcsLzRe8oY2o8aTiIniUSSMs5Q0pwsqcODss_deKySV1BAEUUMN7HFovJM0mjbCGHlFg7DLWKaphIbAoGim5eQ1CNNCanjSUOftj9_zfXt9a73f7rKyW0hQgGMYRf5Ru_R3TB7a3_Hj2CGOiMghjvVU2zzBsboxxjE89zmHu2-sQwTHOpJDYx2juk1DozMOF1PikLUsDn-7GYfLOfFILojHdPLWx2PYvXiMpVOhCegR4kXOFC-GpnjRkOvFtTz2m7xo3-dFeY0XlymmUyIm0iTaSAhPhJqaiBeoenEiaqiW0l5LxPi-STgblITWIUm4XZeE8R18aA72oX-MD6_E-fBykg-3ZvvQI8uHX171Yec_fXi6xIeKOh-WNfpQdN-HSd0NVPY2sCTYwBuhBm4MM6BiDMyguVMMOOINDEozUJtjwM4zcDffwJX1BvaXGviyzMCn5QbaDhmIPmYgstLA4DMGhl830OWmgRM0tp8fw4L8WBPiR5coP3Kf8qMp1Y-i5X7ML_Tjze1-9NvhR_ROPxrJu9-P0R_4caqK9xt4_44fz3Q0UdnZRHGgiSM0p6eJMb1MuPuYyKMRw010HmHiPSqj9REmLkWZqJhgYlKciTjDRNQsE4kvm6ieZ-LFdBOBmSa2ZJs4s8HEvW0mftjF8z0mZtJs-m2viXmfmejzuYmmShPRdSYaz7Cnhq9MXPjOxI0W5vzZQuajFsYFW3iSyiIthCVYGGRbODHPwuTFFgwqzrNweY2FvE0WBu-wsOe4hce_tFBTY6GW0mstmBctRF-x0LvNwo07FkYE2DDoBdrwkA1zgI3kUBvNlDLKRpXbxqpxNjZG29hEu562ETHZxsypNoK9Ntal2ug6z0YpHc2wcYwGZtt4aKGNXqtsJK21EVBgo-Ag8w7ZsA_buHWcO-psxF-w8ViLjc4PbJQLhZ9CFFooaKTC-dEKpRMV9tJ7dIA-oYN0iA5Tz2cVnohViKJxFE3zkxRC_ApxtsLyZAXXSwoT5ypsXaSwM0chdIlCGKVTSb7Cor8rtNFdOlqocJy-36pwp0ihfZtCwzsKme8qzNih0G2PwsVyhaaPFAI_VthyRKGIlh5VMCsVbn-hcOsk-xqF36mknjsJpxXe-Urh-jmF3V8r9DuvUE4VdPobhcJvufOiQvUVhX83KTx1U6GsRaHTbYXFvyr0aFO4366w5r7Cwx00noXGNCrtpLGPfqaqrhoPAjUSemmkDNB45RGNe3_ReGKgRjQtpajBGtODNe7SJ49r-EbyLWWO0thCt90a4U9qtNJeqVFOb43XWBOjcTCW8wSNk6bGh5ZGb8XZDI2KmRp3UjXaZmucnqMRmaHRTOsyNdqzNO7TnmyNuiUa6fkaA1dqHCO1WuPh9Rq7CzU-pcO0s0jjdzr6L43tezW-fV_jO7pErQc2Oy_lFTvnLi92rn-32Jl_4T_ON2lhSb1zBa2mzTRqUINzPGX1O-tcTld3n3WWD_ra2brkvLP70vPOtD4dXSGPdHSdqwxwfU8tdJfuU9uCKS5kT3Fd_8dUVysNqYpzjaGf18S7cjfGu5JrPGJYvUd0uOIRu-jgVY_4nBKueURsE-sPHtG72SOCSP7oEc_TiBaP2PCbR2yiaocUXzilqKLyblJ81F2Kj-kAHaPA_lL8ibpTD7IGSJFLCUOl6DtcitVuKT6gPqOZESFFb48Ua8dLsY6OTJTi18lS1P1VirO04RkpKugbWvucFAXUdZoUkTSN9lKQV4pCmmBK8ZZNyVK8Pp3_mCKFc6YUtWnclSFFzkIpWhex5kjxGZ1cwu-lUvxC_6MH1GGZFAEEKqDm16QoXSHFfmrKZ87rfL9SilcpjzJWSdG-jmcFUoS9IcXbVExXC6W4RtPfZnYR59ulWLBPisZyKba-L8X2_VLEfyhFSRV7GnNcip-qWWulGHlKinBy02jaQ2V0gob-V4odV6XoGdjpZv2KOlf35ec2b-v4aNiLGZnJ2Vkpi2alhaVmZaRnz0qfGZaaNuel2dkLwhbOSXaHu8eGu90RI8LdyfPD_w9O0pwX\"",
      "server": "ESF",
      "vary": "Sec-Fetch-Dest, Sec-Fetch-Mode, Sec-Fetch-Site",
      "x-content-type-options": "nosniff",
      "x-frame-options": "SAMEORIGIN",
      "x-ua-compatible": "IE=edge",
      "x-xss-protection": "0",
      "connection": "close",
      "transfer-encoding": "chunked"
    },
    "body": "<!doctype html><html lang=\"en\" dir=\"ltr\"><head><base href=\"https://www.google.com.au/\"><link rel=\"preconnect\" href=\"//www.gstatic.com\"><meta name=\"referrer\" content=\"strict-origin-when-cross-origin\"><meta name=\"viewport\" content=\"width=device-width,initial-scale=1.0,minimum-scale=1.0,maximum-scale=1.0,user-scalable=no,interactive-widget=resizes-content\"><meta http-equiv=\"Content-Type\" content=\"text/html; charset=UTF-8\"><meta name=\"color-scheme\" content=\"light dark\"><meta name=\"google-site-verification\" content=\"sxp7zFOFUzk09RdlFhuH2SoCn5nOkXgomiLeLIQ48p0\"><meta name=\"google-site-verification\" content=\"uceYfkdbu7tdKGywiwSr1p0cIbqdYOwMDkNq5jVFwMA\"><meta name=\"google-site-verification\" content=\"O5G3B9VUIil1GEVlPw3BfdeYn_kZeNd_6rsDolHah5w\"><meta name=\"google-site-verification\" content=\"hU5-JhTB7DyiEACObYa4GcZxXOTY5FykMqegq9lCAqA\"><meta name=\"application-name\" content=\"Google Flights\"><meta name=\"apple-mobile-web-app-title\" content=\"Google Flights\"><meta name=\"apple-mobile-web-app-status-ba..."
  }
  ```
</ResponseExample>


# Google Flights currency
Source: https://docs.brightdata.com/api-reference/serp/google-flights/currency

Configure the Bright Data Google Flights Google Flights currency parameter to refine queries and return matching results as JSON or HTML. On port 44445.

```txt wrap theme={null}
https://www.google.com/travel/flights/search?tfs=CBwQAhonEgoyMDI2LTAzLTE2agsIAhIHL20vMGszcHIMCAISCC9tLzA0anBsGicSCjIwMjYtMDMtMjRqDAgCEggvbS8wNGpwbHILCAISBy9tLzBrM3BAAUgBcAGCAQsI____________AZgBAQ&curr=USD
```

## Parameters

<ParamField type="string">
  String representing flight search parameters
</ParamField>

<ParamField type="string">
  Defines the currency of returned prices

  ```txt wrap theme={null}
  https://www.google.com/travel/flights/search?tfs=CBwQAhonEgoyMDI2LTAzLTE2agsIAhIHL20vMGszcHIMCAISCC9tLzA0anBsGicSCjIwMjYtMDMtMjRqDAgCEggvbS8wNGpwbHILCAISBy9tLzBrM3BAAUgBcAGCAQsI____________AZgBAQ&curr=USD
  ```
</ParamField>

<RequestExample>
  ```shell cURL highlight={6} theme={null}
    curl -X POST https://api.brightdata.com/request \
    --header "Content-Type: application/json" \
    --header "Authorization: Bearer API_KEY" \
    --data '{
      "zone": "serp_api1",
      "url": "https://www.google.com/travel/flights/search?tfs=CBwQAhonEgoyMDI2LTAzLTE2agsIAhIHL20vMGszcHIMCAISCC9tLzA0anBsGicSCjIwMjYtMDMtMjRqDAgCEggvbS8wNGpwbHILCAISBy9tLzBrM3BAAUgBcAGCAQsI____________AZgBAQ&curr=USD",
      "format": "json"
    }'
  ```

  ```shell Native proxy highlight={4} theme={null}
  curl --proxy brd.superproxy.io:44445 \
    --proxy-user CUSTOMER_USERNAME:CUSTOMER_PASSWORD \
    --ssl-no-revoke \
    "https://www.google.com/travel/flights/search?tfs=CBwQAhonEgoyMDI2LTAzLTE2agsIAhIHL20vMGszcHIMCAISCC9tLzA0anBsGicSCjIwMjYtMDMtMjRqDAgCEggvbS8wNGpwbHILCAISBy9tLzBrM3BAAUgBcAGCAQsI____________AZgBAQ&curr=USD"
  ```

  ```js Node.js highlight={10} theme={null}
  (async () => {
    const response = await fetch('https://api.brightdata.com/request', {
      method: 'POST',
      headers: {
        'Content-Type': 'application/json',
        'Authorization': 'Bearer API_KEY'
      },
      body: JSON.stringify({
        zone: 'serp_api1',
        url: 'https://www.google.com/travel/flights/search?tfs=CBwQAhonEgoyMDI2LTAzLTE2agsIAhIHL20vMGszcHIMCAISCC9tLzA0anBsGicSCjIwMjYtMDMtMjRqDAgCEggvbS8wNGpwbHILCAISBy9tLzBrM3BAAUgBcAGCAQsI____________AZgBAQ&curr=USD',
        format: 'json'
      })
    });
    
    const data = await response.text();
    console.log(data);
  })();
  ```

  ```python Python highlight={11} theme={null}
  import requests

  # API Configuration
  headers = {
      'Content-Type': 'application/json',
      'Authorization': 'Bearer API_KEY',
  }

  payload = {
      'zone': 'serp_api1',
      'url': 'https://www.google.com/travel/flights/search?tfs=CBwQAhonEgoyMDI2LTAzLTE2agsIAhIHL20vMGszcHIMCAISCC9tLzA0anBsGicSCjIwMjYtMDMtMjRqDAgCEggvbS8wNGpwbHILCAISBy9tLzBrM3BAAUgBcAGCAQsI____________AZgBAQ&curr=USD',
      'format': 'json'
  }

  # Make the request
  response = requests.post(
      'https://api.brightdata.com/request', 
      json=payload, 
      headers=headers
  )

  print(response.text)
  ```
</RequestExample>

<ResponseExample>
  ```json 200 highlight={27} theme={null}
  {
    "status_code": 200,
    "headers": {
      "accept-ch": "Sec-CH-UA-Arch, Sec-CH-UA-Bitness, Sec-CH-UA-Full-Version, Sec-CH-UA-Full-Version-List, Sec-CH-UA-Model, Sec-CH-UA-WoW64, Sec-CH-UA-Form-Factors, Sec-CH-UA-Platform, Sec-CH-UA-Platform-Version",
      "alt-svc": "h3=\":443\"; ma=2592000,h3-29=\":443\"; ma=2592000",
      "cache-control": "no-cache, no-store, max-age=0, must-revalidate",
      "content-security-policy": "require-trusted-types-for 'script';report-uri /_/FlightsFrontendUi/cspreport, script-src 'report-sample' 'nonce-1mGlhJJcMK5-5ZqCNTUFvw' 'unsafe-inline';object-src 'none';base-uri 'self';report-uri /_/FlightsFrontendUi/cspreport;worker-src 'self' blob:, script-src 'unsafe-inline' 'unsafe-eval' blob: data: 'self' https://apis.google.com https://ssl.gstatic.com https://www.google.com https://www.googletagmanager.com https://www.gstatic.com https://www.google-analytics.com https://maps.googleapis.com https://maps.googleapis.com/maps/ https://maps.googleapis.com/maps-api-v3/ https://adservice.google.com/ https://www.googleadservices.com/pagead/conversion_async.js https://www.googleadservices.com https://www.google.com/tools/feedback/ https://www.gstatic.com/feedback/js/ https://www.gstatic.com/inproduct_help/ https://www.gstatic.com/support/content/ https://www.gstatic.com/uservoice/feedback/client/web/live/ https://www.gstatic.com/uservoice/surveys/resources/prod/js/survey/ https://support.google.com/inapp/;report-uri /_/FlightsFrontendUi/cspreport/allowlist;worker-src blob: 'self'",
      "content-security-policy-report-only": "script-src 'unsafe-inline' 'unsafe-eval' blob: data: https://www.gstatic.com/external_hosted/d3/v5/d3.min.js https://translate.google.com/translate_a/element.js https://www.gstatic.com/_/mss/boq-one-google/_/ https://www.gstatic.com/og/_/js/ https://apis.google.com/js/api.js https://apis.google.com/js/client.js https://maps.googleapis.com/maps/api/js https://www.google.com/tools/feedback/chat_load.js https://www.google.com/tools/feedback/help_api.js https://www.google.com/tools/feedback/load.js https://www.google.com/tools/feedback/open.js https://www.google.com/tools/feedback/open_to_help_guide_lazy.js https://www.gstatic.com/feedback/js/ https://www.gstatic.com/feedback/js/help/prod/service/lazy.min.js https://www.gstatic.com/inproduct_help/api/main.min.js https://www.gstatic.com/inproduct_help/chatsupport/chatsupport_button_v2.js https://www.gstatic.com/inproduct_help/service/lazy.min.js https://www.gstatic.com/uservoice/feedback/client/web/live/ https://www.gstatic.com/uservoice/surveys/resources/prod/js/survey/ https://www.googletagmanager.com/gtag/js https://www.google-analytics.com/analytics.js https://www.googletagmanager.com/gtag/destination https://www.gstatic.com/_/mss/boq-travel/_/js/k=boq-travel.FlightsFrontendUi_desktop_ms.en.2AgMd3uDtdI.2021.O/ https://apis.google.com/_/scs/abc-static/_/js/ https://maps.googleapis.com/maps-api-v3/api/js/ https://maps.googleapis.com/maps/vt https://maps.googleapis.com/maps/api/js/ https://maps.googleapis.com/maps/api/place/js/ https://translate.googleapis.com/_/translate_http/_/js/;report-uri /_/FlightsFrontendUi/cspreport/fine-allowlist",
      "content-type": "text/html; charset=utf-8",
      "cross-origin-opener-policy": "same-origin-allow-popups",
      "cross-origin-resource-policy": "same-site",
      "date": "Fri, 27 Feb 2026 00:45:15 GMT",
      "expires": "Mon, 01 Jan 1990 00:00:00 GMT",
      "p3p": "CP=\"This is not a P3P policy! See g.co/p3phelp for more info.\"",
      "permissions-policy": "ch-ua-arch=*, ch-ua-bitness=*, ch-ua-full-version=*, ch-ua-full-version-list=*, ch-ua-model=*, ch-ua-wow64=*, ch-ua-form-factors=*, ch-ua-platform=*, ch-ua-platform-version=*",
      "pragma": "no-cache",
      "reporting-endpoints": "default=\"/_/FlightsFrontendUi/web-reports?context=eJwV0XtUVlUaBvBPfb5vI9rykqhgpclShIQABcJgk9exBpXrd75zzj4iigQGGIgX1MTGYY2GgmBhVjBlolwKwm4maSqBEZCKVFpOZqmkyQzSDCtNmXnmj99az3r3e9797nXcq0b4eA6x-VEYhf8_u3vZ5k_zsv0aOtUWEjbVVkRrpsyxTd_yjC14XLRNeEfbknyjbUEjluC6PQaXkmOQszkGf70Vgx_zYpFUHItl5DwTC7_7sQils75xGOUTj7xF8ZiWHI_OLfH4OZ-5LB733olHfVs8ZrslYC7No1cIgQlQixOwlFrXJ6CN2injxQREjUtEl2ci-qYm4nZHIqIGOXHD2wmv2U5siHHiuUQnetKcGJXjxG8vOHHwdSfm73eiocOJzdedKB9wYt5IDU0eGjZ6a9jtq-Gmn4YVszWsWqTBFqthUoaG9jwNZr6GuwUarhRpOFyj4Ys6DUfrNfQf0xBxSkNYk4ZHz2uYflWD-y0Npyl0vAt-ni4U-rjgHu7CljkudKe6UL7VhedLXdhzwIXxlS5EHHThOsUfdmHG-y6cbWZ_J_vvuLBwsI6moToqhus4QemjdcwcoyN4rI58CpiuY2iAjnepjopCdFwO19HwlI55MTpiNB3hK3UkPKejNVPH8iwdw7N17MvVcb5Ex_03dfxyiPVqHSmURr_X6sj8VMfYz3R0N-mI6NBx_TwzdX6t4-IPOm72cs7DBrInG5jlbeBJqgsz4B9nYJJp4HSmgQXrDWhUkW_gx0ID-WUGHq00UN1i4LEvDLS1GWinrHYD-iUDEVcMePQbuHnHQMAQExotpZIHTOgTTCT5mrhByUEmmoNN7Jhl4pUIE2V0aL6JkAUmUhab8I43sSvVxLBMEzV0crWJUzQx18QDa02M2WEicaeJIcUmihs575gJ87iJnhbe0WEi9qKJKb0mhv7XRL1Q-KePQi95Pq5wOUjhwgyFmrkKtfQuHaFPqJGO0XEa_bTCE9EK4TSLIsjHpRBjKqQkKTieVZi7SuGNdQoH8xR8Nyr4UxbtL1BY9zeFfrpLJ0sVWuhOucK9NxU631LIflthRaXCiGqFS_UK3R8qDP9IYd8JhXLadFJBb1K4_blCz5fMbQp_0P4zvI9wTuGtrxWufqNQ9a3C-AsK9dRA575TKP1e4dolhdYrCh93K8y5pVDXq-B2W2H9vxVG9SsM3FMoHFB4cJCFp2FhCdW4WXiH_kXNwyzEjbGQPMHChocs3H_EwhMTLUTQJlrmbSGd7tInj1nQHud3lB1kYR_NC7awkG5T4JMW-mhvlIXC2RYao1mPs9CqW9hsWPiAPBTPV1hoSLFwJ9VCf5qFc-kWwlZb6KZd2Rbu5VgYoOpcCx0bLWQVWJi43cIpUi9ZeLDIQlWphaN0nP4ot3Dy7xYO1Fr47cir9sv5FfZVWyvsRW9X2OOuVtjt3RX2gotf2fdQ7v4z9r_QS_QqBU3qtEdRzvgu-1b6uarLXjfpW3vfxgv2kZsu2CeOHeyY8tBgx_tNQxzf0DW6SwPUv2aRA7mLHFdfXuzoo6nNMY6Z1FMY60huixR-ZyJF40-R4jOK7o4Ucb9ECo8bkcKT0kj-Gin-TAG9kaLk90hRRq02KY7apWikNmqn-hFSfDhSio_oCJ0iu5cUgoaSOxkTpIibJsW46VKMnSFFS4gU10KleDhMCo9IKXZGSbGLTsyVouNPUnRRyUIpGuh72vmMFMU0bIkUYbSEaskzXopScuhSPEV7TSm2L5Pi82TWUrhfhhTOTCl61kjRRwtypchby7xOiuD1UmzIk-JTctvMXWkYedA48iQvKqIbL0pRs02Kw9RdwBnbpXiB8ilrB99XKIVJFi2lZbScVtC9XewvlsJ_txSvUQUNKmHPa1L8p5w7HJBicq0Ub7wnxYHDUlRRNcV-IMUjx3hGDU1SVDZLcYhmtkix57QUL1MZ7aX7rVLkfCnFjHYpPu7gPzjLvbqk2EfT_iFF6A9ShFPlT1KMHu72eue2DsfI3e9tqx402X_56uyk3JzkdSsz_FNzVmflrsxK8U_NSH82LXeN_9r0pODA4NDA4OCQgMDgpOcD_wfAZJtV\"",
      "server": "ESF",
      "vary": "Sec-Fetch-Dest, Sec-Fetch-Mode, Sec-Fetch-Site",
      "x-content-type-options": "nosniff",
      "x-frame-options": "SAMEORIGIN",
      "x-ua-compatible": "IE=edge",
      "x-xss-protection": "0",
      "connection": "close",
      "transfer-encoding": "chunked"
    },
    "body": "<!doctype html><html lang=\"en\" dir=\"ltr\"><head><base href=\"https://www.google.com.sa/\"><link rel=\"preconnect\" href=\"//www.gstatic.com\"><meta name=\"referrer\" content=\"strict-origin-when-cross-origin\"><meta name=\"viewport\" content=\"width=device-width,initial-scale=1.0,minimum-scale=1.0,maximum-scale=1.0,user-scalable=no,interactive-widget=resizes-content\"><meta http-equiv=\"Content-Type\" content=\"text/html; charset=UTF-8\"><meta name=\"color-scheme\" content=\"light dark\"><meta name=\"google-site-verification\" content=\"sxp7zFOFUzk09RdlFhuH2SoCn5nOkXgomiLeLIQ48p0\"><meta name=\"google-site-verification\" content=\"uceYfkdbu7tdKGywiwSr1p0cIbqdYOwMDkNq5jVFwMA\"><meta name=\"google-site-verification\" content=\"O5G3B9VUIil1GEVlPw3BfdeYn_kZeNd_6rsDolHah5w\"><meta name=\"google-site-verification\" content=\"hU5-JhTB7DyiEACObYa4GcZxXOTY5FykMqegq9lCAqA\"><meta name=\"application-name\" content=\"Google Flights\"><meta name=\"apple-mobile-web-app-title\" content=\"Google Flights\"><meta name=\"apple-mobile-web-app-status-ba..."
  }
  ```
</ResponseExample>


# Google Flights localization
Source: https://docs.brightdata.com/api-reference/serp/google-flights/localization

Configure the Bright Data Google Flights Google Flights localization parameter to refine queries and return matching results as JSON or HTML. On port 44445.

```txt wrap theme={null}
https://www.google.com/travel/flights/search?tfs=CBwQAhonEgoyMDI2LTAzLTE2agsIAhIHL20vMGszcHIMCAISCC9tLzA0anBsGicSCjIwMjYtMDMtMjRqDAgCEggvbS8wNGpwbHILCAISBy9tLzBrM3BAAUgBcAGCAQsI____________AZgBAQ&gl=us&hl=en
```

## Parameters

<ParamField type="string">
  String representing flight search parameters
</ParamField>

<ParamField type="string">
  Two-letter country code used to define the country of search

  ```txt wrap theme={null}
  https://www.google.com/travel/flights/search?tfs=CBwQAhonEgoyMDI2LTAzLTE2agsIAhIHL20vMGszcHIMCAISCC9tLzA0anBsGicSCjIwMjYtMDMtMjRqDAgCEggvbS8wNGpwbHILCAISBy9tLzBrM3BAAUgBcAGCAQsI____________AZgBAQ&gl=us
  ```
</ParamField>

<ParamField type="string">
  Two-letter language code used to define the page language

  ```txt wrap theme={null}
  https://www.google.com/travel/flights/search?tfs=CBwQAhonEgoyMDI2LTAzLTE2agsIAhIHL20vMGszcHIMCAISCC9tLzA0anBsGicSCjIwMjYtMDMtMjRqDAgCEggvbS8wNGpwbHILCAISBy9tLzBrM3BAAUgBcAGCAQsI____________AZgBAQ&hl=en
  ```
</ParamField>

<RequestExample>
  ```shell cURL highlight={6} theme={null}
    curl -X POST https://api.brightdata.com/request \
    --header "Content-Type: application/json" \
    --header "Authorization: Bearer API_KEY" \
    --data '{
      "zone": "serp_api1",
      "url": "https://www.google.com/travel/flights/search?tfs=CBwQAhonEgoyMDI2LTAzLTE2agsIAhIHL20vMGszcHIMCAISCC9tLzA0anBsGicSCjIwMjYtMDMtMjRqDAgCEggvbS8wNGpwbHILCAISBy9tLzBrM3BAAUgBcAGCAQsI____________AZgBAQ&gl=us&hl=en",
      "format": "json"
    }'
  ```

  ```shell Native proxy highlight={4} theme={null}
  curl --proxy brd.superproxy.io:44445 \
    --proxy-user CUSTOMER_USERNAME:CUSTOMER_PASSWORD \
    --ssl-no-revoke \
    "https://www.google.com/travel/flights/search?tfs=CBwQAhonEgoyMDI2LTAzLTE2agsIAhIHL20vMGszcHIMCAISCC9tLzA0anBsGicSCjIwMjYtMDMtMjRqDAgCEggvbS8wNGpwbHILCAISBy9tLzBrM3BAAUgBcAGCAQsI____________AZgBAQ&gl=us&hl=en"
  ```

  ```js Node.js highlight={10} theme={null}
  (async () => {
    const response = await fetch('https://api.brightdata.com/request', {
      method: 'POST',
      headers: {
        'Content-Type': 'application/json',
        'Authorization': 'Bearer API_KEY'
      },
      body: JSON.stringify({
        zone: 'serp_api1',
        url: 'https://www.google.com/travel/flights/search?tfs=CBwQAhonEgoyMDI2LTAzLTE2agsIAhIHL20vMGszcHIMCAISCC9tLzA0anBsGicSCjIwMjYtMDMtMjRqDAgCEggvbS8wNGpwbHILCAISBy9tLzBrM3BAAUgBcAGCAQsI____________AZgBAQ&gl=us&hl=en',
        format: 'json'
      })
    });
    
    const data = await response.text();
    console.log(data);
  })();
  ```

  ```python Python highlight={11} theme={null}
  import requests

  # API Configuration
  headers = {
      'Content-Type': 'application/json',
      'Authorization': 'Bearer API_KEY',
  }

  payload = {
      'zone': 'serp_api1',
      'url': 'https://www.google.com/travel/flights/search?tfs=CBwQAhonEgoyMDI2LTAzLTE2agsIAhIHL20vMGszcHIMCAISCC9tLzA0anBsGicSCjIwMjYtMDMtMjRqDAgCEggvbS8wNGpwbHILCAISBy9tLzBrM3BAAUgBcAGCAQsI____________AZgBAQ&gl=us&hl=en',
      'format': 'json'
  }

  # Make the request
  response = requests.post(
      'https://api.brightdata.com/request', 
      json=payload, 
      headers=headers
  )

  print(response.text)
  ```
</RequestExample>

<ResponseExample>
  ```json 200 highlight={27} theme={null}
  {
    "status_code": 200,
    "headers": {
      "accept-ch": "Sec-CH-UA-Arch, Sec-CH-UA-Bitness, Sec-CH-UA-Full-Version, Sec-CH-UA-Full-Version-List, Sec-CH-UA-Model, Sec-CH-UA-WoW64, Sec-CH-UA-Form-Factors, Sec-CH-UA-Platform, Sec-CH-UA-Platform-Version",
      "alt-svc": "h3=\":443\"; ma=2592000,h3-29=\":443\"; ma=2592000",
      "cache-control": "no-cache, no-store, max-age=0, must-revalidate",
      "content-security-policy": "require-trusted-types-for 'script';report-uri /_/FlightsFrontendUi/cspreport, script-src 'report-sample' 'nonce-oXtL4fMYR0uYTvsCGxZ-rQ' 'unsafe-inline';object-src 'none';base-uri 'self';report-uri /_/FlightsFrontendUi/cspreport;worker-src 'self' blob:, script-src 'unsafe-inline' 'unsafe-eval' blob: data: 'self' https://apis.google.com https://ssl.gstatic.com https://www.google.com https://www.googletagmanager.com https://www.gstatic.com https://www.google-analytics.com https://maps.googleapis.com https://maps.googleapis.com/maps/ https://maps.googleapis.com/maps-api-v3/ https://adservice.google.com/ https://www.googleadservices.com/pagead/conversion_async.js https://www.googleadservices.com https://www.google.com/tools/feedback/ https://www.gstatic.com/feedback/js/ https://www.gstatic.com/inproduct_help/ https://www.gstatic.com/support/content/ https://www.gstatic.com/uservoice/feedback/client/web/live/ https://www.gstatic.com/uservoice/surveys/resources/prod/js/survey/ https://support.google.com/inapp/;report-uri /_/FlightsFrontendUi/cspreport/allowlist;worker-src blob: 'self'",
      "content-security-policy-report-only": "script-src 'unsafe-inline' 'unsafe-eval' blob: data: https://www.gstatic.com/external_hosted/d3/v5/d3.min.js https://translate.google.com/translate_a/element.js https://www.gstatic.com/_/mss/boq-one-google/_/ https://www.gstatic.com/og/_/js/ https://apis.google.com/js/api.js https://apis.google.com/js/client.js https://maps.googleapis.com/maps/api/js https://www.google.com/tools/feedback/chat_load.js https://www.google.com/tools/feedback/help_api.js https://www.google.com/tools/feedback/load.js https://www.google.com/tools/feedback/open.js https://www.google.com/tools/feedback/open_to_help_guide_lazy.js https://www.gstatic.com/feedback/js/ https://www.gstatic.com/feedback/js/help/prod/service/lazy.min.js https://www.gstatic.com/inproduct_help/api/main.min.js https://www.gstatic.com/inproduct_help/chatsupport/chatsupport_button_v2.js https://www.gstatic.com/inproduct_help/service/lazy.min.js https://www.gstatic.com/uservoice/feedback/client/web/live/ https://www.gstatic.com/uservoice/surveys/resources/prod/js/survey/ https://www.googletagmanager.com/gtag/js https://www.google-analytics.com/analytics.js https://www.googletagmanager.com/gtag/destination https://www.gstatic.com/_/mss/boq-travel/_/js/k=boq-travel.FlightsFrontendUi_desktop_ms.en.2AgMd3uDtdI.2021.O/ https://apis.google.com/_/scs/abc-static/_/js/ https://maps.googleapis.com/maps-api-v3/api/js/ https://maps.googleapis.com/maps/vt https://maps.googleapis.com/maps/api/js/ https://maps.googleapis.com/maps/api/place/js/ https://translate.googleapis.com/_/translate_http/_/js/;report-uri /_/FlightsFrontendUi/cspreport/fine-allowlist",
      "content-type": "text/html; charset=utf-8",
      "cross-origin-opener-policy": "same-origin-allow-popups",
      "cross-origin-resource-policy": "same-site",
      "date": "Fri, 27 Feb 2026 00:24:51 GMT",
      "expires": "Mon, 01 Jan 1990 00:00:00 GMT",
      "p3p": "CP=\"This is not a P3P policy! See g.co/p3phelp for more info.\"",
      "permissions-policy": "ch-ua-arch=*, ch-ua-bitness=*, ch-ua-full-version=*, ch-ua-full-version-list=*, ch-ua-model=*, ch-ua-wow64=*, ch-ua-form-factors=*, ch-ua-platform=*, ch-ua-platform-version=*",
      "pragma": "no-cache",
      "reporting-endpoints": "default=\"/_/FlightsFrontendUi/web-reports?context=eJwV0HtUVVUeB_CrfO_dgrZ8JCrajBYrERTloZLG3YiaUw0qcOGee87ZRwSR1BCU8AGa2DJWPiFxYrIGJknN10g41TSZD0BIBAYBn-WkpoKaFuIMK0xpvvPHZ-3f-e29v7-zts-p_gF-XrYgivj_6jPcFjdmuO3HyaNtkyJG2wqo8c402-a2aNu4da_awobG2IR_jC0pMMYW2n8u2uyxuJIci6y1sXj7Xiyu5cQhqTAO88nVFIegJ3GYTGcD4zEwwIWc2S6MSXahZZ0LN_JYF7vw-JAL5fUuRPdJwAyaSe8RQhKg5iRgHtWtSkA9NVD6WwmIGpqIc36J6BydiAeNiYjq5cYdfzeGR7uxOtaN1xPduL_IjYFZbjx80429H7rxUpkbFY1urG1zo6THjZkDNFT7asj11_BuoIa7QRqCwzUsiNawZLYGW5yGUekaGnI0mHkaHuVruF6g4cgBDacPa_iqXEPXMQ2RVRoiqjU826ph3E0NPvc0fEOTh3kQ5OfBlgAPfKZ4sG66B-1pHpSs92BZkQc7dnswbI8HkXs9aCPXEQ_C_-7B2Rqeb-H5bg9e7q2j2ltHaT8dJ2nxIB0TB-sIG6Ijj8aP0-E9Xsff6DAVTNJxdYqOimk6ZsbqiNV0TFmoI-F1HXVLdaRk6Oi3XMfObB2t23U8-UjH7U_Y368jlRbRLwd1LP1ax5ATOtqrdUQ26mhrZU0t53Vc_l7H3Q7m_M7A8ucMTPU38CIdjjAQHG9glGngm6UGZq0yoFFpnoFrWwzkFRt4do-B_bUGxp42UF9voIEyGgzoVwxEXjfg22XgbreB8V4mNJpH258yoY8wkRRo4g4lh5qoCTOxaaqJ9yJNFNMnL5mYNMtE6hwT_i4T29JM9F1q4gBVZpqoopHZJp5aYWLwJhOJW014FZpIKTdReJSZx0yYx03cr-WcRhNxl00832HC-zcT5ULhpwCFDvKboHA1VOFSuELVDIVqqqGz1EytdJ4u0KBXFF6IUZhCUymSAjwKsabC-iQFx2sKM5Yo_GWlwt4chcBchWDKoLJ8hZXvKHTRI6osUqil7hKFxx8ptOxSWP6xwoI9Cv33K1wpV2j_XKHfFwo7TyqU0JpKBb1a4cEphftnWNcr_EplTZxHaFbYdV7h5gWFfRcVhl1SKKcKav5Woeg7hVtXFOquK7huKfyjXWH6PYXDHQp9Hiis-o_CwC6FnscKW3oUnu5lYS4sHOhj4RD9TDV9LcQPtpA8wsLqZyw8-b2FF0ZaiKQ1NN_fQiY9on-OteCewHu0LNTCTnoQZiHkRQudtCPKwpZoC0djLJyM5x7V6RbWGhY-I19l4c8LLBSkWqig7jQLXYssNC-2EJFpYdtyC4-zLPTQ_mwLjbkWMvItjNxooYrUZgtPF1jYV2ThKzpOv5ZYqPyrhd0HLXz3qYXv6So9_PJ9-9W8UvuS9aX2go9L7fvqSu09baX2_Mv_su-gFWVN9g20md6n0FEt9ijKGnbOvp5u7DtnLx910d6Ze8k-YM0le61vb8fzz_R2XKj2ctyiDnpEPdTrlJej643ZDmTPdtz80xxHJ42uiXVMpKR6pwhqcoqjPzjFCUq44RSvtDtF_G2n8L3jFH6USvJHp_gjje9wiu2_OEUx1dmkOGaX4jhVUhWdpjoq7y_F5wOk-IK-pCryHiyFfbgUgrzJh4wRUsSPkaKZho6T4hoNCZeidpIUkRFS-DqlCKCtUVJso_vTOWuGFD_PkqLxD1Kco-0vS1FBF2nrq1IUUr85UjjmShFBc-kgJcZJ4SYP6WSSRfPIzyVFETl0KaZRsSnFxvlSnEqW4p0U9lOlOJrO_8mUYla2FDkrpOhcKcWh1VKszpHiazqTy94aKR7Sf-k36rVWCi8CFdKdt6Q4sEGKI9Sez5yNUrxJeZSxSYrH29grlCL4XSk-oFLaVSTF_A-YWcK93VJ07ZUi5aAUC-lmuRQffirF7iNSxH3Gtz4hRVkNv2lirRQ_1Ukx-YwU4Q1STGiSIpSqzvL-RWZ_K8XYf0ux5wcpBvXt03p6Q6NjwO3K7iXPBadkLk_KzkpeuTA9OC0rMyN7YUZqcFr64tcWZb8RvGJxUlhI2OSQsLBJ40PCkpaF_A9iZKs7\"",
      "server": "ESF",
      "vary": "Sec-Fetch-Dest, Sec-Fetch-Mode, Sec-Fetch-Site",
      "x-content-type-options": "nosniff",
      "x-frame-options": "SAMEORIGIN",
      "x-ua-compatible": "IE=edge",
      "x-xss-protection": "0",
      "connection": "close",
      "transfer-encoding": "chunked"
    },
    "body": "<!doctype html><html lang=\"en\" dir=\"ltr\"><head><base href=\"https://www.google.es/\"><link rel=\"preconnect\" href=\"//www.gstatic.com\"><meta name=\"referrer\" content=\"strict-origin-when-cross-origin\"><meta name=\"viewport\" content=\"width=device-width,initial-scale=1.0,minimum-scale=1.0,maximum-scale=1.0,user-scalable=no,interactive-widget=resizes-content\"><meta http-equiv=\"Content-Type\" content=\"text/html; charset=UTF-8\"><meta name=\"color-scheme\" content=\"light dark\"><meta name=\"google-site-verification\" content=\"sxp7zFOFUzk09RdlFhuH2SoCn5nOkXgomiLeLIQ48p0\"><meta name=\"google-site-verification\" content=\"uceYfkdbu7tdKGywiwSr1p0cIbqdYOwMDkNq5jVFwMA\"><meta name=\"google-site-verification\" content=\"O5G3B9VUIil1GEVlPw3BfdeYn_kZeNd_6rsDolHah5w\"><meta name=\"google-site-verification\" content=\"hU5-JhTB7DyiEACObYa4GcZxXOTY5FykMqegq9lCAqA\"><meta name=\"application-name\" content=\"Google Flights\"><meta name=\"apple-mobile-web-app-title\" content=\"Google Flights\"><meta name=\"apple-mobile-web-app-status-bar-st..."
  }
  ```
</ResponseExample>


# Google Flights text search
Source: https://docs.brightdata.com/api-reference/serp/google-flights/text-search

Configure the Bright Data Google Flights Google Flights text search parameter to refine queries and return matching results as JSON or HTML. On port 44445.

```txt wrap theme={null}
https://www.google.com/travel/flights/search?tfs=CBwQAhonEgoyMDI2LTAzLTE2agsIAhIHL20vMGszcHIMCAISCC9tLzA0anBsGicSCjIwMjYtMDMtMjRqDAgCEggvbS8wNGpwbHILCAISBy9tLzBrM3BAAUgBcAGCAQsI____________AZgBAQ
```

## Parameters

<ParamField type="string">
  String representing flight search parameters

  ```txt wrap theme={null}
  https://www.google.com/travel/flights/search?tfs=CBwQAhonEgoyMDI2LTAzLTE2agsIAhIHL20vMGszcHIMCAISCC9tLzA0anBsGicSCjIwMjYtMDMtMjRqDAgCEggvbS8wNGpwbHILCAISBy9tLzBrM3BAAUgBcAGCAQsI____________AZgBAQ
  ```
</ParamField>

<RequestExample>
  ```shell cURL highlight={6} theme={null}
    curl -X POST https://api.brightdata.com/request \
    --header "Content-Type: application/json" \
    --header "Authorization: Bearer API_KEY" \
    --data '{
      "zone": "serp_api1",
      "url": "https://www.google.com/travel/flights/search?tfs=CBwQAhonEgoyMDI2LTAzLTE2agsIAhIHL20vMGszcHIMCAISCC9tLzA0anBsGicSCjIwMjYtMDMtMjRqDAgCEggvbS8wNGpwbHILCAISBy9tLzBrM3BAAUgBcAGCAQsI____________AZgBAQ",
      "format": "json"
    }'
  ```

  ```shell Native proxy highlight={4} theme={null}
  curl --proxy brd.superproxy.io:44445 \
    --proxy-user CUSTOMER_USERNAME:CUSTOMER_PASSWORD \
    --ssl-no-revoke \
    "https://www.google.com/travel/flights/search?tfs=CBwQAhonEgoyMDI2LTAzLTE2agsIAhIHL20vMGszcHIMCAISCC9tLzA0anBsGicSCjIwMjYtMDMtMjRqDAgCEggvbS8wNGpwbHILCAISBy9tLzBrM3BAAUgBcAGCAQsI____________AZgBAQ"
  ```

  ```js Node.js highlight={10} theme={null}
  (async () => {
    const response = await fetch('https://api.brightdata.com/request', {
      method: 'POST',
      headers: {
        'Content-Type': 'application/json',
        'Authorization': 'Bearer API_KEY'
      },
      body: JSON.stringify({
        zone: 'serp_api1',
        url: 'https://www.google.com/travel/flights/search?tfs=CBwQAhonEgoyMDI2LTAzLTE2agsIAhIHL20vMGszcHIMCAISCC9tLzA0anBsGicSCjIwMjYtMDMtMjRqDAgCEggvbS8wNGpwbHILCAISBy9tLzBrM3BAAUgBcAGCAQsI____________AZgBAQ',
        format: 'json'
      })
    });
    
    const data = await response.text();
    console.log(data);
  })();
  ```

  ```python Python highlight={11} theme={null}
  import requests

  # API Configuration
  headers = {
      'Content-Type': 'application/json',
      'Authorization': 'Bearer API_KEY',
  }

  payload = {
      'zone': 'serp_api1',
      'url': 'https://www.google.com/travel/flights/search?tfs=CBwQAhonEgoyMDI2LTAzLTE2agsIAhIHL20vMGszcHIMCAISCC9tLzA0anBsGicSCjIwMjYtMDMtMjRqDAgCEggvbS8wNGpwbHILCAISBy9tLzBrM3BAAUgBcAGCAQsI____________AZgBAQ',
      'format': 'json'
  }

  # Make the request
  response = requests.post(
      'https://api.brightdata.com/request', 
      json=payload, 
      headers=headers
  )

  print(response.text)
  ```
</RequestExample>

<ResponseExample>
  ```json 200 highlight={27} theme={null}
  {
    "status_code": 200,
    "headers": {
      "accept-ch": "Sec-CH-UA-Arch, Sec-CH-UA-Bitness, Sec-CH-UA-Full-Version, Sec-CH-UA-Full-Version-List, Sec-CH-UA-Model, Sec-CH-UA-WoW64, Sec-CH-UA-Form-Factors, Sec-CH-UA-Platform, Sec-CH-UA-Platform-Version",
      "alt-svc": "h3=\":443\"; ma=2592000,h3-29=\":443\"; ma=2592000",
      "cache-control": "no-cache, no-store, max-age=0, must-revalidate",
      "content-security-policy": "script-src 'report-sample' 'nonce-rG9xWwDHOfDPrr2gBY9D3w' 'unsafe-inline';object-src 'none';base-uri 'self';report-uri /_/FlightsFrontendUi/cspreport;worker-src 'self' blob:, script-src 'unsafe-inline' 'unsafe-eval' blob: data: 'self' https://apis.google.com https://ssl.gstatic.com https://www.google.com https://www.googletagmanager.com https://www.gstatic.com https://www.google-analytics.com https://maps.googleapis.com https://maps.googleapis.com/maps/ https://maps.googleapis.com/maps-api-v3/ https://adservice.google.com/ https://www.googleadservices.com/pagead/conversion_async.js https://www.googleadservices.com https://www.google.com/tools/feedback/ https://www.gstatic.com/feedback/js/ https://www.gstatic.com/inproduct_help/ https://www.gstatic.com/support/content/ https://www.gstatic.com/uservoice/feedback/client/web/live/ https://www.gstatic.com/uservoice/surveys/resources/prod/js/survey/ https://support.google.com/inapp/;report-uri /_/FlightsFrontendUi/cspreport/allowlist;worker-src blob: 'self', require-trusted-types-for 'script';report-uri /_/FlightsFrontendUi/cspreport",
      "content-security-policy-report-only": "script-src 'unsafe-inline' 'unsafe-eval' blob: data: https://www.gstatic.com/external_hosted/d3/v5/d3.min.js https://translate.google.com/translate_a/element.js https://www.gstatic.com/_/mss/boq-one-google/_/ https://www.gstatic.com/og/_/js/ https://apis.google.com/js/api.js https://apis.google.com/js/client.js https://maps.googleapis.com/maps/api/js https://www.google.com/tools/feedback/chat_load.js https://www.google.com/tools/feedback/help_api.js https://www.google.com/tools/feedback/load.js https://www.google.com/tools/feedback/open.js https://www.google.com/tools/feedback/open_to_help_guide_lazy.js https://www.gstatic.com/feedback/js/ https://www.gstatic.com/feedback/js/help/prod/service/lazy.min.js https://www.gstatic.com/inproduct_help/api/main.min.js https://www.gstatic.com/inproduct_help/chatsupport/chatsupport_button_v2.js https://www.gstatic.com/inproduct_help/service/lazy.min.js https://www.gstatic.com/uservoice/feedback/client/web/live/ https://www.gstatic.com/uservoice/surveys/resources/prod/js/survey/ https://www.googletagmanager.com/gtag/js https://www.google-analytics.com/analytics.js https://www.googletagmanager.com/gtag/destination https://www.gstatic.com/_/mss/boq-travel/_/js/k=boq-travel.FlightsFrontendUi_desktop_ms.en.2AgMd3uDtdI.2021.O/ https://apis.google.com/_/scs/abc-static/_/js/ https://maps.googleapis.com/maps-api-v3/api/js/ https://maps.googleapis.com/maps/vt https://maps.googleapis.com/maps/api/js/ https://maps.googleapis.com/maps/api/place/js/ https://translate.googleapis.com/_/translate_http/_/js/;report-uri /_/FlightsFrontendUi/cspreport/fine-allowlist",
      "content-type": "text/html; charset=utf-8",
      "cross-origin-opener-policy": "same-origin-allow-popups",
      "cross-origin-resource-policy": "same-site",
      "date": "Fri, 27 Feb 2026 00:16:08 GMT",
      "expires": "Mon, 01 Jan 1990 00:00:00 GMT",
      "p3p": "CP=\"This is not a P3P policy! See g.co/p3phelp for more info.\"",
      "permissions-policy": "ch-ua-arch=*, ch-ua-bitness=*, ch-ua-full-version=*, ch-ua-full-version-list=*, ch-ua-model=*, ch-ua-wow64=*, ch-ua-form-factors=*, ch-ua-platform=*, ch-ua-platform-version=*",
      "pragma": "no-cache",
      "reporting-endpoints": "default=\"/_/FlightsFrontendUi/web-reports?context=eJwVz3tUVVUeB_CrfM_dqLhEExFtRoulCArCVUCNuwlf0xQgcOGee87ZO0SRxBDioQ5oYstoShQCRyZLyEiMh4KQNZZpIY9EYFS0wtGZ0hTS1IAaVhDS_OaPz9q_vdfvtcc3T_LycDL5kGCy5P_x-Bmm8HkzTD8GzTUFBs81FZA9PWGmzDnLTQt2PmuyuIebmGe4Kd473BQwaQ16lCjcSIhCxo4ovHo_Ct9lRyO-MBprSfTFaPg8ikYQueQdg8leNmRH2DAvwYaunTZ8n0txiQ0jx2yoa7chzDkWK8hKcoDAPxYiMhbPk7ZtsWgnHSTllViEusfhqkccBubGob8zDqFj7LjraceMMDv-EmXHi3F2PNhox-QMO35-2Y6j79ixqtyO-k47dvTYUTpqx0pXFU1uKnI8VbzpreKejwoRpmI92RShwhStYnaKio5sFUauiuE8FTcLVDRUqzhfq-LTOhWDZ1SEnFMR3KTiiSsqFtxWMf6-ii9JQ7-KoOkO-Hg4kO_lwPilDuxc7kBvkgOluxx4qdiB_UccmF7hQMhRB3qIrcGBRR86cKmF8rscKPqJaoYceGashqZxGspcNHxBkqdoWDxVg2WahlyycI4GvwUaxvlpOE5qSUGghm-Xaqh_WsPKKA1RqoalGzTEvqihbbOGdakaXNI1HMzScKVIw6PDGn74gN6rNCSSjeTXGg2bP9Mw7XMNvU0aQjo19FyhmHR9peHafzTc66M-f9CR_qSOZZ46niK1wTp8Y3TMNnR8uVnH6m06VFKWq-O7fB25JTqeqNBR1apj_nkd7e06Okhqhw7tho6QmzrcBnXcG9Lh52RAJc-TookGtJkG4r0N3CUJAQZaLAbeWGbgQIiBEvLBKgOBqw0kRhrwtBnYl2RgwmYD1aQxzcA5MivLwMQtBqa-YSBurwGnQgPr6gwUnqaeZwwYZw08aKU5nQairxmY02dg3O8G6pjAQy-BPuKxUKAjQKB7kUD1CoEacpycIp-Q0-QMOUum_FlgSbjAUrKMhBAvh0CUIZAYL2B-QWDFJoFDWwWOZgt45wj4klRSniew9a8Cg2SYNBYLtJI7hwSGSgVGDgt0vSeQ_r7A-gqBSVUCe2sFbtQJ9H4k4PKxwMEvBErJ9kYBrUmgv1ngwQWK2wV-I-UXaS7BZYH3vhK4_bVA5TcC07sF6kg9ufwvgeLrNPeGQNtNgbg7Av_oFVh-X6C2T8C5X2DbLwKTBwVGRwTyRwUeGyOxBhLVzhLHyE-kZYLEqItEzFSJhJkSWY9LPPqjxJJZEiFkO1nrKZFMhskn8yXsC6mWpAdIHCT9Fgn_pyQGSA2XqCP7QyXywyRiV0qcDqecGIkLmsQOXeIkcRMSf18vUZ8oMZQkMbhR4nKyRHCaxL50iZEM2otUZUl05kik5knMel3iHBF7JB4rkKgslviUnCXHSiV-I43vSpyokjhSI_HzqbeUb3PLlE27ypQDr5UpBe-XKUNtZcrE3jIl79o_lf1kS_lFZTfZQ94iAbO7lFCSMf2qsovcqryq1M3-RhnI6VZct3crscuvK7OmjTVnEq_Hx5q_bnIy3yH9ZJj8TkzNTubBzAgzsiLMt_8WaR4gc1uizIvJw_xoc3y7lflctLLTt6zscxL7vZWF91pZxA9W5nbXyjxI6I9W9hzx67Oyol-trIS0mTj7UOHsJGkmLaRuEmcfuXL2MTlFzhHnqZzpMznbSWLmcea-gLNpizhrDeTsnSDOSsnMYM7crJzNI3tDOdtHGldw5rqKs19Wc9b2J86ukKJnOKsn18neZzkrJC6RnE1Yw1kwWUNqiLuNs2LytMZZiUH1CZwpiZx1pNDsNM6yt3A2sJWzbdmcfUYu5NCeOzgbRyYQN-JOPMgMUkDuvsJZ9W7OGkh3Hme9ZJiMEtNr1PN1zl4muWRkH2eZhZz5vsnZ26SMjCnibO3bnP23lP7wLuUfoX0rOHuumrNIsq6Gsw0k8xhnh05wVt7AWSWpItEn6d7C2RGyuJWzh-c5O9xGJ1ncQf_qpLxLnNWSFjL_35xV3OJsiovz-ebdnWbXE5XHW8c-6bsuLT0-KyNh64YU36SMtNSsDamJvkkpyS9szMr03ZIcb_G3BPlbLIF-_pb4l_z_BxaAqwI\"",
      "server": "ESF",
      "vary": "Sec-Fetch-Dest, Sec-Fetch-Mode, Sec-Fetch-Site",
      "x-content-type-options": "nosniff",
      "x-frame-options": "SAMEORIGIN",
      "x-ua-compatible": "IE=edge",
      "x-xss-protection": "0",
      "connection": "close",
      "transfer-encoding": "chunked"
    },
    "body": "<!doctype html><html lang=\"en\" dir=\"ltr\"><head><base href=\"https://www.google.com.tw/\"><link rel=\"preconnect\" href=\"//www.gstatic.com\"><meta name=\"referrer\" content=\"strict-origin-when-cross-origin\"><meta name=\"viewport\" content=\"width=device-width,initial-scale=1.0,minimum-scale=1.0,maximum-scale=1.0,user-scalable=no,interactive-widget=resizes-content\"><meta http-equiv=\"Content-Type\" content=\"text/html; charset=UTF-8\"><meta name=\"color-scheme\" content=\"light dark\"><meta name=\"google-site-verification\" content=\"sxp7zFOFUzk09RdlFhuH2SoCn5nOkXgomiLeLIQ48p0\"><meta name=\"google-site-verification\" content=\"uceYfkdbu7tdKGywiwSr1p0cIbqdYOwMDkNq5jVFwMA\"><meta name=\"google-site-verification\" content=\"O5G3B9VUIil1GEVlPw3BfdeYn_kZeNd_6rsDolHah5w\"><meta name=\"google-site-verification\" content=\"hU5-JhTB7DyiEACObYa4GcZxXOTY5FykMqegq9lCAqA\"><meta name=\"application-name\" content=\"Google Flights\"><meta name=\"apple-mobile-web-app-title\" content=\"Google Flights\"><meta name=\"apple-mobile-web-app-status-ba..."
  }
  ```
</ResponseExample>


# Accommodation type
Source: https://docs.brightdata.com/api-reference/serp/google-hotels/accommodation-type

Configure the Bright Data Google Hotels Accommodation Type parameter to refine queries and return matching results as JSON or HTML. On port 44445.

```txt wrap theme={null}
https://www.google.com/travel/hotels?q=four+seasons+hotel+new+york+downtown&brd_accommodation_type=vacation_rentals
```

## Parameters

<ParamField type="string">
  The search query parameter. Specifies the keyword or phrase you want to search for on Google.
</ParamField>

<ParamField type="string">
  Accommodation type: Hotels or Vacation Rentals.

  ```txt wrap theme={null}
  https://www.google.com/travel/hotels?q=four+seasons+hotel+new+york+downtown&brd_accommodation_type=vacation_rentals
  ```

  | Parameter                                 | Description                 |
  | ----------------------------------------- | --------------------------- |
  | `brd_accommodation_type=hotels`           | search for Hotels           |
  | `brd_accommodation_type=vacation_rentals` | search for Vacation Rentals |
</ParamField>

<RequestExample>
  ```shell cURL highlight={6} theme={null}
    curl -X POST https://api.brightdata.com/request \
    --header "Content-Type: application/json" \
    --header "Authorization: Bearer API_KEY" \
    --data '{
      "zone": "serp_api1",
      "url": "https://www.google.com/travel/hotels?q=four+seasons+hotel+new+york+downtown&brd_accommodation_type=vacation_rentals",
      "format": "raw"
    }'
  ```

  ```shell Native proxy highlight={4} theme={null}
  curl --proxy brd.superproxy.io:44445 \
    --proxy-user CUSTOMER_USERNAME:CUSTOMER_PASSWORD \
    --ssl-no-revoke \
    "https://www.google.com/travel/hotels?q=four+seasons+hotel+new+york+downtown&brd_accommodation_type=vacation_rentals"
  ```

  ```js Node.js highlight={10} theme={null}
  (async () => {
    const response = await fetch('https://api.brightdata.com/request', {
      method: 'POST',
      headers: {
        'Content-Type': 'application/json',
        'Authorization': 'Bearer API_KEY'
      },
      body: JSON.stringify({
        zone: 'serp_api1',
        url: 'https://www.google.com/travel/hotels?q=four+seasons+hotel+new+york+downtown&brd_accommodation_type=vacation_rentals',
        format: 'raw'
      })
    });
    
    const data = await response.text();
    console.log(data);
  })();
  ```

  ```python Python highlight={11} theme={null}
  import requests

  # API Configuration
  headers = {
      'Content-Type': 'application/json',
      'Authorization': 'Bearer API_KEY',
  }

  payload = {
      'zone': 'serp_api1',
      'url': 'https://www.google.com/travel/hotels?q=four+seasons+hotel+new+york+downtown&brd_accommodation_type=vacation_rentals',
      'format': 'raw'
  }

  # Make the request
  response = requests.post(
      'https://api.brightdata.com/request', 
      json=payload, 
      headers=headers
  )

  print(response.text)
  ```
</RequestExample>

<ResponseExample>
  ```json 200 theme={null}
  {
    "overview": {
      "type": "hotels",
      "title": "Four Seasons Hotel New York Downtown",
      "requested": {
        "start_date": "2026-02-27",
        "end_date": "2026-02-28",
        "occupancy": 2,
        "number_of_adults": 2
      },
      "available": true,
      "currency": "USD",
      "coordinates": {
        "latitude": 40.712633,
        "longitude": -74.0092141
      },
      "address": "27 Barclay St, New York, NY 10007",
      "phone": "(646) 880-1999",
      "fid": "0x89c25a18e3553f8b:0x1337dae5edaabaa2"
    },
    "prices": [
      {
        "title": "Expedia.com",
        "logo": "https://www.gstatic.com/travel-hotels/branding/ac238c97-1652-4830-8da8-bb8d8883af88.png",
        "link": "https://www.expedia.com/Hotel-Search?selected=15438428&startDate=2026-02-27&endDate=2026-02-28&MDPCID=US.META.HPA.HOTEL-ORGANIC-desktop.HOTEL&MDPDTL=HTL.15438428.20260227.20260228.DDF.1.CID..AUDID..RRID.bex_us_desktop&mctc=10&ct=hotel&mpg=USD&mpf=1260.01&mpj=165.01&mpr=0.00&mpl=USD&exp_pg=google&langid=en&ad=2&tp=&utm_source=google&utm_medium=cpc&utm_term=15438428&utm_content=localuniversal&utm_campaign=HotelAds&langid=1033&adults=2&children=&rateplanid=208165426&mpm=24&mpn=201555590&mpo=EC&mpp=1",
        "price": {
          "value": 1095,
          "currency": "USD"
        },
        "cost": {
          "value": 1095,
          "currency": "USD"
        },
        "price_with_tax": {
          "value": 1260,
          "currency": "USD"
        },
        "cost_with_tax": {
          "value": 1260,
          "currency": "USD"
        }
      },
      {
        "title": "LateRooms.com",
        "logo": "https://www.gstatic.com/travel-hotels/branding/10344278261224262221.png",
        "link": "https://www.laterooms.com/en-us/hotel/1137278/?ppc=true&isHotel=true&checkin=2026-02-27&checkout=2026-02-28&nights=1&rooms=%5B%7B%22adults%22:2,%22children%22:%5B%5D,%22kidsAge%22:%5B%5D%7D%5D&utm_source=GoogleHC&utm_medium=paid&utm_campaign=&utm_content=localuniversal&utm_term=1137278&pv=1772145112009&sourceToken=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJzdWIiOiJib29raW5nX2NvbSIsImV4cCI6MTc3MjIzMTUxMiwiaWF0IjoxNzcyMTQ1MTEyfQ.pVyEg6L6lCxv6cPRFyjNpfB0TUyXhF3nMKxMFpl5Fi4",
        "price": {
          "value": 1091,
          "currency": "USD"
        },
        "cost": {
          "value": 1091,
          "currency": "USD"
        },
        "price_with_tax": {
          "value": 1255,
          "currency": "USD"
        },
        "cost_with_tax": {
          "value": 1255,
          "currency": "USD"
        }
      },
      {
        "title": "trivago DEALS",
        "logo": "https://www.gstatic.com/travel-hotels/branding/8670591202796644526.png",
        "link": "https://www.trivago.deals/hotels/united-states_ny_new-york/555839_four-seasons-hotel-new-york-downtown?checkIn=2026-02-27&checkOut=2026-02-28&placeId=H555839&campaignName=TrivagoDeals_Google_US&currencyCode=USD&dealKey=CAIQjQYiDAiHlIPNBhCwn6r6AipMDQBgn0QVAKCURCWkcCNDLQAAYEAwATiBA0UAYJ9ESgwI_5ODzQYQvN3ZmwFiClN0YW5kYXJkIEtoAoIBAI0BpFifRKABp7sPqAHIBjCNBji_9iFAg_EPSAFSCMmhSmr8dVChWMgG&countryCode=US&languageCode=en&rule=Google_US&site=localuniversal&ads=&origin=31&priceDisplayedTotal=1275.00&priceDisplayedTax=166.94&device=desktop&adults=2&children=0",
        "price": {
          "value": 1108,
          "currency": "USD"
        },
        "cost": {
          "value": 1108,
          "currency": "USD"
        },
        "price_with_tax": {
          "value": 1275,
          "currency": "USD"
        },
        "cost_with_tax": {
          "value": 1275,
          "currency": "USD"
        }
      },
      {
        "title": "Priceline",
        "logo": "https://www.gstatic.com/travel-hotels/branding/icon_220.png",
        "link": "https://www.priceline.com/r/?channel=meta&product=hotel&theme=ghalistings&refid=PLGOOGLEMSS&refclickid=US_HP%7C35500803_localuniversal_1%7C20260227%7Cdesktop%7Cuserdate|public|||1%7C2%7C0|0|EN&hotelid=35500803&checkin=20260227&checkout=20260228&rooms=1&currency=USD&displayedCurr=USD&POSCountryCode=US&taxDisplayMode=BP&cityID=3000016152&adults=2&land=L&metaid=d2XxBXAt9Q75gh58g80rgqUAp7eGbPmm2lOGeL-B98Cv9eZIJL71vRkCXUhToMuWAq02eP_0wolJcn74idh9EMoMIWERkOcRirTP5N-25r3ng__yZHMGbcm8uGrcCO4rPomRx4Z8cAUu28Fm_xUCfKHpSj8kHnrkYafIS6jaKpASCgi_93tPRnCurgskNwx-KGXwRa9wFWj9UK5rKrGL-6GSRrTGxJ8QJfvC0c6_eXAx8ncHeGDHyVDixNXfc_s2O1nJn3VV5qz-nsmBeP7NYnHYgrLgnvZsvnDE3qQSvyANAjC0wjOue-ukzYsCOxsknyyZS4FBSxlxvTedFkWTGNhXiR1XwE2VGKAessLp0nRGlGlF57PIXmXHPdtwxkuMbPSNG2Fj2tsTJPU2IFDyAu5dJq0w8PzZDKqo_zz2aXQ&dblcnt=true&user_num_adults=2&hc=1&pdtax=165.01&pdf=0.00&pdt=1260.01&locale=en-us&ad-src=&numChild=0",
        "price": {
          "value": 1095,
          "currency": "USD"
        },
        "cost": {
          "value": 1095,
          "currency": "USD"
        },
        "price_with_tax": {
          "value": 1260,
          "currency": "USD"
        },
        "cost_with_tax": {
          "value": 1260,
          "currency": "USD"
        }
      },
      {
        "title": "Booking.com",
        "logo": "https://www.gstatic.com/travel-hotels/branding/icon_184.png",
        "link": "https://www.booking.com/searchresults.en.html?dest_id=599535&highlighted_hotels=599535&dest_type=hotel&checkin=2026-02-27&checkout=2026-02-28&group_adults=2&req_adults=2&show_room=59953503_336303630_2_0_0&lang=en&selected_currency=USD&exrt=1.00000000&ext_price_total=1260.01&ext_price_tax=165.01&xfc=USD&hca=m&group_children=0&req_children=0&&no_rooms=1&ts=1772147439&edgtid=HLaytVu3Rg63ysJnMVZ89w&efpc=EJWwChJgsBov&utm_source=metagha&utm_medium=localuniversal&utm_campaign=US&utm_term=hotel-599535&utm_content=dev-desktop_los-1_bw-1_dow-Friday_defdate-0_room-0_gstadt-2_rateid-public_aud-0_gacid-_mcid-10_ppa-0_clrid-0_ad-0_gstkid-0_checkin-20260227_ppt-&aid=2127486&label=metagha-link-LUUS-hotel-599535_dev-desktop_los-1_bw-1_dow-Friday_defdate-0_room-0_gstadt-2_rateid-public_aud-0_gacid-_mcid-10_ppa-0_clrid-0_ad-0_gstkid-0_checkin-20260227_ppt-",
        "price": {
          "value": 1095,
          "currency": "USD"
        },
        "cost": {
          "value": 1095,
          "currency": "USD"
        },
        "price_with_tax": {
          "value": 1260,
          "currency": "USD"
        },
        "cost_with_tax": {
          "value": 1260,
          "currency": "USD"
        }
      },
      {
        "title": "KAYAK.com",
        "logo": "https://www.gstatic.com/travel-hotels/branding/6417d44c-c676-4b16-8ae9-f3bbeaa51899.png",
        "link": "https://www.kayak.com/semi/ha/hotel_ads/2600131/en.html?utm_source=google&utm_medium=cpc&utm_term=2600131&adType=0&utm_content=localuniversal&utm_campaign=HotelAds&ci=2026-02-27&co=2026-02-28&gs=localuniversal&l=1&pc=USD&rid=&pdtax=165.01&pdtotal=1260.01&rpid=&uc=US&ucuc=USD&d=desktop&lc=en&v=false&rrid=kayak-us&k_pc=~UFJJQ0VMSU5FQ09SRQ&k_rt=&k_sid=xfCEJfSxh5&k_kct=1772134021&k_gct=1772138420&g=2&r=1&ac=2&k_cc=us&dt=selected&cmpid=&cmptrack=",
        "price": {
          "value": 1095,
          "currency": "USD"
        },
        "cost": {
          "value": 1095,
          "currency": "USD"
        },
        "price_with_tax": {
          "value": 1260,
          "currency": "USD"
        },
        "cost_with_tax": {
          "value": 1260,
          "currency": "USD"
        }
      },
      {
        "title": "Hotels.com",
        "logo": "https://www.gstatic.com/travel-hotels/branding/f358dd45-ebd1-4af8-988d-d53154b73975.png",
        "link": "https://www.hotels.com/Hotel-Search?selected=15438428&startDate=2026-02-27&endDate=2026-02-28&mdpcid=HCOM-US.META.HPA.HOTEL-ORGANIC-desktop.HOTEL&MDPDTL=HTL.15438428.20260227.20260228.DDF.1.CID..AUDID.&adults=2&children=&mctc=10&mpf=1260.01&mpg=USD&mpl=USD&mpj=165.01&mpr=0.00&rffrid=sem.hcom.US.156.024.localuniversal.02.desktop-1.kwrd=GGMETA.15438428USen-20260227-N-ABW=1-camp=-aud=-N&rateplanid=208165427&mpm=24&mpn=201555591&mpo=EC&mpp=1&locale=en_US&siteid=300000001",
        "price": {
          "value": 1095,
          "currency": "USD"
        },
        "cost": {
          "value": 1095,
          "currency": "USD"
        },
        "price_with_tax": {
          "value": 1260,
          "currency": "USD"
        },
        "cost_with_tax": {
          "value": 1260,
          "currency": "USD"
        }
      },
      {
        "title": "Tripadvisor.com",
        "logo": "https://www.gstatic.com/travel-hotels/branding/7993073966338005995.png",
        "link": "https://www.tripadvisor.com/HotelHighlight?detail=10330604&m=66081&staydates=2026_02_27_2026_02_28&uguests=1_2_&supdv=desktop&supbl=localuniversal&supkl=selected&supuc=US&supul=en&supia=0&supip=0&supmb=6aNrQeoh_veGDR9dX-f0aOEdsUcZj5Q31Gw5clDcK_Fu4zF1GeGsOnOVJa9e7MR_KnfX3rKGSDeQQsmT6Fu24cI9HaGubkQHqyQ0E5ehxrVFNKk63aAjbUoCsSiqKx6927xbPPtjoyb17qFU0y7ZxcLIQ_DpkCq7fiwPuBC2ZCnZQGdlf9Q_0IvFHiZiWy&supmc=QxYxCBdEk5a3XPSaGFmqSaju7Qf6jOvQob64PgAfaVyE13Gv5RVlpLlVDuFBbHA&supts=&supey=m|108054|PL_GL_query&supcd=&suptp=XprnE0vplRKDYp2kABEBIznuo2xyToGgGWYdsvwlhP4Smi0WuliuoLoThxTL3JqLtbSyQJxLA1QMxUUTBEch6GHC8ZqA-6dtv2-0Ub-jrkdYi5y3MyZjBa2fp-IguJyBi3oewy-9R6Z0QXZlRw3BPYs4hJ-LOpTRGSB8haN2V8S4n4MCnSKxUYA50BFGm9&supas=",
        "price": {
          "value": 1095,
          "currency": "USD"
        },
        "cost": {
          "value": 1095,
          "currency": "USD"
        },
        "price_with_tax": {
          "value": 1260,
          "currency": "USD"
        },
        "cost_with_tax": {
          "value": 1260,
          "currency": "USD"
        }
      },
      {
        "title": "Best Hotel Deals",
        "logo": "https://www.gstatic.com/travel-hotels/branding/49083cad-a022-48f3-965c-36ee20bf8352.png",
        "link": "https://besthoteldealsglobal.com/property/417372?rooms=1&currency=USD&withTaxes=&startDate=27-02-2026&endDate=28-02-2026&occupancies=[]&utm_source=google&utm_medium=HAC&utm_content=27_02_2026_1_localuniversal_417372_US_desktop_selected___2&tp=1260.01&tt=165.01&sup=36&flow=%2B4WN5O7WD7WSgzbceYIoHHX0MI7VpgxqzhbmS%2BUBYlr3dUCPq366Mn0XfkpUkrMGy6LtvIVnpJcu4oBD0QX3pQ179e1tOfEWy%2FY2hFcpGs2YITpjv2TJ8AWVYwdU72H6CHcpzR%2BsP7shBgVtu7N%2BkniytT2WXwtJfej30gGk9LdTWyBml2lBBvgxR%2BNbXllBO%2B8etQNuhz5oCCOikyFkG3EIj7FXCjYGVo3xyy5GM%2BcLvNYiW2U1ypi7jaG4%2FDky&room=M72TrTcF-z0",
        "price": {
          "value": 1095,
          "currency": "USD"
        },
        "cost": {
          "value": 1095,
          "currency": "USD"
        },
        "price_with_tax": {
          "value": 1260,
          "currency": "USD"
        },
        "cost_with_tax": {
          "value": 1260,
          "currency": "USD"
        }
      },
      {
        "title": "Brek",
        "logo": "https://www.gstatic.com/travel-hotels/branding/5560284514445840289.png",
        "link": "https://www.brek.com/search?lat=40.713038&lng=-74.008777&checkin=2026-02-27&checkout=2026-02-28&pinned=6473b44aa1d24283bbe42fcf&utm_source=gha&ep=7f51dcbc8ed03f8df50a8a49eb0402650a92a1a8ba5dbe12a0f87c1c4f5501fd4419ca8e2e4156d66771f793703a654de6447d9afa684dd9aaf23720365ab52b&user_currency=USD&user_country=US&user_language=en&user_displayed_total=1260.01&user_displayed_tax=165.01",
        "price": {
          "value": 1095,
          "currency": "USD"
        },
        "cost": {
          "value": 1095,
          "currency": "USD"
        },
        "price_with_tax": {
          "value": 1260,
          "currency": "USD"
        },
        "cost_with_tax": {
          "value": 1260,
          "currency": "USD"
        }
      },
      {
        "title": "My Luxury Hotel",
        "logo": "https://www.gstatic.com/travel-hotels/branding/11153979922261788882.png",
        "link": "https://www.myluxuryhotel.com/en-us/hotel/1137278/?ppc=true&isHotel=true&checkin=2026-02-27&checkout=2026-02-28&nights=1&rooms=%5B%7B%22adults%22:2,%22children%22:%5B%5D,%22kidsAge%22:%5B%5D%7D%5D&utm_source=GoogleHC&utm_medium=paid&utm_campaign=&utm_content=localuniversal&utm_term=1137278&pv=1772145095008&sourceToken=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJzdWIiOiJib29raW5nX2NvbSIsImV4cCI6MTc3MjIzMTQ5NSwiaWF0IjoxNzcyMTQ1MDk1fQ.eaf9u-R2X_MoqA1wS2497dtIF5aENREAaAwjbyctIe0",
        "price": {
          "value": 1091,
          "currency": "USD"
        },
        "cost": {
          "value": 1091,
          "currency": "USD"
        },
        "price_with_tax": {
          "value": 1255,
          "currency": "USD"
        },
        "cost_with_tax": {
          "value": 1255,
          "currency": "USD"
        }
      },
      {
        "title": "dealbase.com",
        "logo": "https://www.gstatic.com/travel-hotels/branding/1776272071000195501.png",
        "link": "https://deals.dealbase.com/?sig=d24b78db5ff27b2a7633c125e8c1eb65fcdd29bfbe8d2468da3702f8e475011131373338383435313339&turl=https%3A%2F%2Fwww.dealbase.com%2FHotel%2FSearch%3FcheckIn%3D2026-02-27%26checkOut%3D2026-02-28%26currency%3DUSD%26forceCurrencyChange%3D1%26lang%3Den%26forceLanguageChange%3D1%26rooms%3D2%3A%26utm_source%3Dgha%26utm_medium%3Dcpc%26hotelId%3D3021724%26userCountry%3DUS%26profile%3Dr2d2m73kn8%26preferredRate%3D1260.01%26label%3Dsrc%253Dgha%2526cltype%253Dhotel%2526datype%253Dselected%2526gsite%253Dlocaluniversal%2526vf%253D0%2526ucountry%253DUS%2526udevice%253Ddesktop%2526hotel%253D3021724%2526day%253D27%2526month%253D02%2526year%253D2026%2526los%253D1%2526price%253D1260.01%2526currency%253DUSD%2526cid%253D%2526listid%253D%2526rateid%253DUS_D%2526closerateid%253D%2526promo%253D0%2526isPrivateRate%253D0%2526isAudienceUser%253D0%2526isPaidClick%253D0%2526%26cp%3DyUWhQl3bpMkCgtkZC13ZklnMDRMZximlIPNBiACOLm-9_EKQhgIhtD7-c7_5MGzARC81wYg9YABKgNVU0Q",
        "price": {
          "value": 1095,
          "currency": "USD"
        },
        "cost": {
          "value": 1095,
          "currency": "USD"
        },
        "price_with_tax": {
          "value": 1260,
          "currency": "USD"
        },
        "cost_with_tax": {
          "value": 1260,
          "currency": "USD"
        }
      },
      {
        "title": "Travelocity.com",
        "logo": "https://www.gstatic.com/travel-hotels/branding/icon_185.png",
        "link": "https://www.travelocity.com/Hotel-Search?selected=15438428&startDate=2026-02-27&endDate=2026-02-28&adults=2&children=&MDPCID=travelocity-US.META.HPA.ORGANIC.HOTEL&MDPDTL=HTL.15438428.20260227.20260228.DDF.1.CID..AUDID..localuniversal&exp_curr=USD&exp_dp=1260.01&exp_tx=165.01&mctc=10&rateplanid=208165426&mpm=24&mpn=201555590&mpo=EC&mpp=1",
        "price": {
          "value": 1095,
          "currency": "USD"
        },
        "cost": {
          "value": 1095,
          "currency": "USD"
        },
        "price_with_tax": {
          "value": 1260,
          "currency": "USD"
        },
        "cost_with_tax": {
          "value": 1260,
          "currency": "USD"
        }
      },
      {
        "title": "Clicktrip.com",
        "logo": "https://www.gstatic.com/travel-hotels/branding/3461ae67-c427-4ecf-a48f-524b530be084.png",
        "link": "https://clicktrip.com/hotels/details/eKzWHKZDZDDlDDnIV9pF8qNnAbhMcxfrOmM00LuP-WamvbZ1-jtu49IoKCbxw3Y8vVFyXMqWN5K9IYDBKxI2Jw82Ggv8qorO0tVTqMNJXoPqay9LOI44T3WIx6C5hvreAqaPxrm-U0O_6uD9w-WmOQ2?locale=en&currency=USD&pos=US&date_type=selected&taf=4VuIiZxdMhc_k7eO7eQG044Ux2a0jvNQY-a16ZfgBOwo9Q-yTXiyQYIDPE2yG5xO0&verification=false&clk_src=",
        "price": {
          "value": 1093,
          "currency": "USD"
        },
        "cost": {
          "value": 1093,
          "currency": "USD"
        },
        "price_with_tax": {
          "value": 1258,
          "currency": "USD"
        },
        "cost_with_tax": {
          "value": 1258,
          "currency": "USD"
        }
      },
      {
        "title": "Bookhotel.direct",
        "logo": "https://www.gstatic.com/travel-hotels/branding/15717022029370921658.png",
        "link": "https://always.bookhotel.direct/119578/?checkin=2026-02-27&checkout=2026-02-28&nb_adult=2&nb_child=0&campaign=localuniversal&tracker_id=&device=desktop&currency_code=USD",
        "price": {
          "value": 1095,
          "currency": "USD"
        },
        "cost": {
          "value": 1095,
          "currency": "USD"
        },
        "price_with_tax": {
          "value": 1260,
          "currency": "USD"
        },
        "cost_with_tax": {
          "value": 1260,
          "currency": "USD"
        }
      },
      {
        "title": "Hotwire.com",
        "logo": "https://www.gstatic.com/travel-hotels/branding/icon_112.png",
        "link": "http://www.hotwire.com/hotel/details/direct-retail-details?startDate=02/27/2026&endDate=02/28/2026&selectedExpediaHotelId=15438428&numAdults=2&numChildren=0&sid=S537&bid=B381549&rpid=RPE15438428&mctc=10",
        "price": {
          "value": 1095,
          "currency": "USD"
        },
        "cost": {
          "value": 1095,
          "currency": "USD"
        },
        "price_with_tax": {
          "value": 1260,
          "currency": "USD"
        },
        "cost_with_tax": {
          "value": 1260,
          "currency": "USD"
        }
      },
      {
        "title": "Halalbooking",
        "logo": "https://www.gstatic.com/travel-hotels/branding/12381662496648659742.png",
        "link": "https://halalbooking.com/en-us/p/83701?checkin=2026-02-27&checkout=2026-02-28&groups%5B%5D=2&currency=USD&US&localuniversal&&adType=0",
        "price": {
          "value": 1260,
          "currency": "USD"
        },
        "cost": {
          "value": 1260,
          "currency": "USD"
        },
        "price_with_tax": {
          "value": 1260,
          "currency": "USD"
        },
        "cost_with_tax": {
          "value": 1260,
          "currency": "USD"
        }
      },
      {
        "title": "Orbitz.com",
        "logo": "https://www.gstatic.com/travel-hotels/branding/icon_100640403.png",
        "link": "https://www.orbitz.com/Hotel-Search?selected=15438428&startDate=2026-02-27&endDate=2026-02-28&adults=2&children=&MDPCID=ORBITZ-US.META.HPA.ORGANIC-desktop.HOTEL&MDPDTL=htl.15438428.20260227.20260228.DDF.1.CID..AUDID..localuniversal&exp_curr=USD&exp_dp=1260.01&exp_tx=165.01&mpr=0.00&mctc=10&rateplanid=208165426&mpm=24&mpn=201555590&mpo=EC&mpp=1",
        "price": {
          "value": 1095,
          "currency": "USD"
        },
        "cost": {
          "value": 1095,
          "currency": "USD"
        },
        "price_with_tax": {
          "value": 1260,
          "currency": "USD"
        },
        "cost_with_tax": {
          "value": 1260,
          "currency": "USD"
        }
      },
      {
        "title": "Hotelscombined.com",
        "logo": "https://www.gstatic.com/travel-hotels/branding/b73f8d82-aa66-4ac5-861d-52bce84c9ae5.png",
        "link": "https://www.hotelscombined.com/semi/ha/hotel_ads/2600131/en.html?utm_source=google&utm_medium=cpc&utm_term=2600131&adType=0&utm_content=localuniversal&utm_campaign=HotelAds&ci=2026-02-27&co=2026-02-28&gs=localuniversal&l=1&pc=USD&rid=&pdtax=165.01&pdtotal=1260.01&rpid=&uc=US&ucuc=USD&d=desktop&lc=en&v=false&rrid=kayak-us&k_pc=~UFJJQ0VMSU5FQ09SRQ&k_rt=&k_sid=xfAER-M11F&k_kct=1772134021&k_gct=1772138413&g=2&r=1&ac=2&k_cc=us&dt=selected&cmpid=&cmptrack=",
        "price": {
          "value": 1095,
          "currency": "USD"
        },
        "cost": {
          "value": 1095,
          "currency": "USD"
        },
        "price_with_tax": {
          "value": 1260,
          "currency": "USD"
        },
        "cost_with_tax": {
          "value": 1260,
          "currency": "USD"
        }
      },
      {
        "title": "Bluepillow.com",
        "logo": "https://www.gstatic.com/travel-hotels/branding/c770e909-af04-45dd-8ad7-335bc5055826.png",
        "link": "https://www.bluepillow.com/search/594397817c00cb0e643c3237?begin=2026-02-27&end=2026-02-28&block_id=-b,8Uf4rkAjzDRsZGMlbZ2L3P6MncHRCisqAlmPM2fDVh-MWFeydaDGybaxsDOk5RRq,-bkng-Hotel&adults=2&childs=0&infants=0&childrens=0&country=US&currency=USD&language=en&source=localuniversal&utm_campaign=hotel&prid=",
        "price": {
          "value": 1260,
          "currency": "USD"
        },
        "cost": {
          "value": 1260,
          "currency": "USD"
        },
        "price_with_tax": {
          "value": 1260,
          "currency": "USD"
        },
        "cost_with_tax": {
          "value": 1260,
          "currency": "USD"
        }
      },
      {
        "title": "müv AI",
        "logo": "https://www.gstatic.com/travel-hotels/branding/2710211444546704077.png",
        "link": "https://muvtravel.com/xp-hotel?hotelID=116119126&checkinDay=27&checkinMonth=02&checkinYear=2026&nights=1&num-guests=2&checkoutDay=28&checkoutMonth=02&checkoutYear=2026&PROMO-CODE=98010",
        "price": {
          "value": 1095,
          "currency": "USD"
        },
        "cost": {
          "value": 1095,
          "currency": "USD"
        },
        "price_with_tax": {
          "value": 1260,
          "currency": "USD"
        },
        "cost_with_tax": {
          "value": 1260,
          "currency": "USD"
        }
      },
      {
        "title": "Agoda",
        "logo": "https://www.gstatic.com/travel-hotels/branding/b13642de-d476-41bd-8254-3edc2e567aa6.png",
        "link": "https://www.agoda.com/partners/partnersearch.aspx?site_id=1917614&CkInDay=27&CkInMonth=02&CkInYear=2026&CkOutDay=28&campaignid=&CkOutMonth=02&CkOutYear=2026&SearchDateType=selected&NumberOfAdults=2&LT=1&NumberOfChildren=0&childages=&NumberOfRooms=1&gsite=localuniversal&los=1&PartnerCurrency=USD&hid=206039&RoomID=11135628&masterRoomId=8697863&PriceTax=165.01&PriceTotal=1260.01&RatePlan=11c82d85-6e23-a66f-2295-8189e6e0d078&UserCountry=US&Currency=USD&UserDevice=desktop&Verif=false&rr=row_desktop&audience_list=&mcid=3038&booking_source=cpc&adType=0&mpt=RW00d0FIT1Q4ZnUzUGxyZWszcEUwZGNrOGsvL0hjN1BDK3hPT0owUXpDdndMdHM4dzZqOSt4Mis5emNGcisvOHo2SHl5QW5zQ0xkVQ&original_rr=",
        "price": {
          "value": 1095,
          "currency": "USD"
        },
        "cost": {
          "value": 1095,
          "currency": "USD"
        },
        "price_with_tax": {
          "value": 1260,
          "currency": "USD"
        },
        "cost_with_tax": {
          "value": 1260,
          "currency": "USD"
        }
      },
      {
        "title": "Closest Hotel",
        "logo": "https://www.gstatic.com/travel-hotels/branding/15292798194442829381.png",
        "link": "https://closesthotel.com/googleRedirMainSearch.php?checkInYear=2026&checkInMonth=02&checkInDay=27&checkOutYear=2026&checkOutMonth=02&checkOutDay=28&numberOfNights=1&numberOfAdults=2&numberOfChildren=0&numberOfGuests=2&hotelID=15438428&roomID=201555590&currency=USD&deviceType=desktop",
        "price": {
          "value": 1095,
          "currency": "USD"
        },
        "cost": {
          "value": 1095,
          "currency": "USD"
        },
        "price_with_tax": {
          "value": 1260,
          "currency": "USD"
        },
        "cost_with_tax": {
          "value": 1260,
          "currency": "USD"
        }
      },
      {
        "title": "AsiaYo",
        "logo": "https://www.gstatic.com/travel-hotels/branding/42906b93-548c-4f41-b994-b55cb3ff88e8.png",
        "link": "https://asiayo.com/en-US/v/80171/?check_in_date=2026-02-27&check_out_date=2026-02-28&adult=2&currency=TWD&aff_id=269&utm_source=google_hotelads&utm_medium=cpc&utm_campaign=&click_source=freelinks",
        "price": {
          "value": 1096,
          "currency": "USD"
        },
        "cost": {
          "value": 1096,
          "currency": "USD"
        },
        "price_with_tax": {
          "value": 1261,
          "currency": "USD"
        },
        "cost_with_tax": {
          "value": 1261,
          "currency": "USD"
        }
      },
      {
        "title": "BusinessHotels.com",
        "logo": "https://www.gstatic.com/travel-hotels/branding/7e9b18f5-dcd9-46e2-8bed-33a004b33995.png",
        "link": "https://www.businesshotels.com/reservation.php?hotel-id=701383248&checkin-date=2026-02-27&checkout-date=2026-02-28&language=en&USER-CURRENCY=USD&USER-COUNTRY=US&NUM-ADULTS=2&NUM-CHILDREN=0&prid=",
        "price": {
          "value": 1099,
          "currency": "USD"
        },
        "cost": {
          "value": 1099,
          "currency": "USD"
        },
        "price_with_tax": {
          "value": 1260,
          "currency": "USD"
        },
        "cost_with_tax": {
          "value": 1260,
          "currency": "USD"
        }
      },
      {
        "title": "CheapTickets.com",
        "logo": "https://www.gstatic.com/travel-hotels/branding/736aa480-c3ae-4b4d-ac2a-1c658f70d17a_%5BUngrouped%5D.png",
        "link": "https://www.cheaptickets.com/Hotel-Search?selected=15438428&startDate=2026-02-27&endDate=2026-02-28&MDPCID=CHEAPTICKETS-US.META.HPA.ORGANIC-desktop.HOTEL&langid=1033&adults=2&children=&MDPDTL=htl.15438428.20260227.20260228.DDF.1.CID..AUDID..localuniversal&exp_curr=USD&exp_dp=1260.01&exp_tx=165.01&mctc=10&rateplanid=208165426&rateplanid=208165426&mpm=24&mpn=201555590&mpo=EC&mpp=1",
        "price": {
          "value": 1095,
          "currency": "USD"
        },
        "cost": {
          "value": 1095,
          "currency": "USD"
        },
        "price_with_tax": {
          "value": 1260,
          "currency": "USD"
        },
        "cost_with_tax": {
          "value": 1260,
          "currency": "USD"
        }
      },
      {
        "title": "ZenHotels.com",
        "logo": "https://www.gstatic.com/travel-hotels/branding/4183134106872331441.png",
        "link": "https://www.zenhotels.com/go/rooms/8022177/?dates=27.02.2026-28.02.2026&cur=USD&lang=en&utm_source=google_hotelads&utm_medium=cpc-metasearch&partner_slug=google&guests=2&from=four_seasons_new_york_downtown.1260.USD.sr-019c9be3-1284-70eb-84e0-ed0617379557&utm_campaign=en-US&price=one&scroll=prices&partner_data=2Vk7OQ5B-Ei-a0Sd2W9UqkGcmNL7gxYoYqOF-VyfRlt7SiWA6WgSgo2l02c-potPklIapUCMvDPqPKn04VtVXU2pz-Kq0Is3J7XukRTz7QLYS1iT-EV2B5JW5SX2DCD3h7uYOw7h_OVPZnnGubJP74tO3AsP-RZJpv80eX6KeNWALHMf&utm_content=GoogleCPC&utm_term=gacid_.bw_1.los_1.dow_Friday.dtype_selected.hid_8022177.rid_109.aud_.d_desktop.ad_0.ctype_hotel.promo_0.apireqtype_deals=disabled&showed_price=1260.01&showed_taxes=0.00&member_deals=true",
        "price": {
          "value": 1260,
          "currency": "USD"
        },
        "cost": {
          "value": 1260,
          "currency": "USD"
        },
        "price_with_tax": {
          "value": 1260,
          "currency": "USD"
        },
        "cost_with_tax": {
          "value": 1260,
          "currency": "USD"
        }
      },
      {
        "title": "eDreams",
        "logo": "https://www.gstatic.com/travel-hotels/branding/05208793-cd83-4e8b-b76c-7ff346e093e3.png",
        "link": "https://accommodation.edreams.net/Hotel-Search?selected=15438428&startDate=2026-02-27&endDate=2026-02-28&adults=2&children=&mpf=1260.01&cur=USD&mpj=165.01&wapb3=|c.506950|l.en_US|t.meta|s.ghs&MDPCID=eDreams-US.DPS.Edreams.MetaSearch-GHA.HOTEL&mpl=USD&numberOfRooms=1&locale=en_US&rffrid=h4p.hcom.US.ghaodigeo.000.000.kwrd=&pos=EDREAMS_US&rateplanid=208165427&mctc=10&utm_medium=metasearch&utm_campaign=495029696&utm_term=hotel&utm_source=FREEBOOKING",
        "price": {
          "value": 1095,
          "currency": "USD"
        },
        "cost": {
          "value": 1095,
          "currency": "USD"
        },
        "price_with_tax": {
          "value": 1260,
          "currency": "USD"
        },
        "cost_with_tax": {
          "value": 1260,
          "currency": "USD"
        }
      },
      {
        "title": "Amimir.com",
        "logo": "https://www.gstatic.com/travel-hotels/branding/11504568723871247728.png",
        "link": "https://www.amimir.com/en/book/?start=27%2F02%2F2026&end=28%2F02%2F2026&hotelId=84085&highlightHotel=true&hab1=2&ehab1=&metasearch&utm_content=84085&checkV=false&totalPrice=1258.07&userCountry=US&utm_source=googleMetasearch&utm_medium=organic&currency=USD",
        "price": {
          "value": 1093,
          "currency": "USD"
        },
        "cost": {
          "value": 1093,
          "currency": "USD"
        },
        "price_with_tax": {
          "value": 1258,
          "currency": "USD"
        },
        "cost_with_tax": {
          "value": 1258,
          "currency": "USD"
        }
      },
      {
        "title": "momondo.com",
        "logo": "https://www.gstatic.com/travel-hotels/branding/icon_970163321.png",
        "link": "https://www.momondo.com/semi/ha/hotel_ads/2600131/en.html?utm_source=google&utm_medium=cpc&utm_term=2600131&adType=0&utm_content=localuniversal&utm_campaign=HotelAds&ci=2026-02-27&co=2026-02-28&gs=localuniversal&l=1&pc=USD&rid=&pdtax=165.01&pdtotal=1260.01&rpid=&uc=US&ucuc=USD&d=desktop&lc=en&v=false&rrid=kayak-us&k_pc=~UFJJQ0VMSU5FQ09SRQ&k_rt=&k_sid=xfCEA4qdZ8&k_kct=1772134021&k_gct=1772138449&g=2&r=1&ac=2&k_cc=us&dt=selected&cmpid=&cmptrack=",
        "price": {
          "value": 1095,
          "currency": "USD"
        },
        "cost": {
          "value": 1095,
          "currency": "USD"
        },
        "price_with_tax": {
          "value": 1260,
          "currency": "USD"
        },
        "cost_with_tax": {
          "value": 1260,
          "currency": "USD"
        }
      },
      {
        "title": "Despegar",
        "logo": "https://www.gstatic.com/travel-hotels/branding/dab7f37a-3d20-4722-9e39-5eaf50330388.png",
        "link": "https://www.trackeame.com/sem-tracker-web/track?kw=2099025_201555590_localuniversal_US_en_USD_1.00000000_2026_02_27_1_1260.01_false&clt_c=HPA-US&clt_n=gh&d=c&cm=HPA_US&pr=H&campaignid=&targetid=aud-&hpa_dd=selected&hpa_ppa=0&clk_src=&u=https%3A%2F%2Fwww.us.despegar.com%2Faccommodations%2Fresults%2FCIT_5227%2F2026-02-27%2F2026-02-28%2F2%3Fchosen_accommodation%3D2099025&google_site=localuniversal&displayed_price=1260.01&country=US&lang=en&crawler=false&partner=4&hotprv=cHc6RVhQ&utm_source=HPA&utm_medium=referral&utm_term=2099025_201555590_localuniversal_US_en_USD_1.00000000_2026_02_27_1_1260.01_165.01_false&utm_content=US&utm_campaign=&cc=US&key=UT81AK9JAFEGJ4D69OVO6J673E&selected_room_pack=321060990",
        "price": {
          "value": 1095,
          "currency": "USD"
        },
        "cost": {
          "value": 1095,
          "currency": "USD"
        },
        "price_with_tax": {
          "value": 1260,
          "currency": "USD"
        },
        "cost_with_tax": {
          "value": 1260,
          "currency": "USD"
        }
      },
      {
        "title": "Traveloka.com",
        "logo": "https://www.gstatic.com/travel-hotels/branding/cc46874d-c374-4a99-83c7-b6f79d0b19d3.png",
        "link": "https://www.traveloka.com/en-en/hotel/search?spec=27-02-2026.28-02-2026.1.1.HOTEL_GEO.4005128638.New%20York%20State.2&hotelId=1000000601517&contexts=%7B%22accessCode%22:%2290975GHAD1305desktop%22%2C%22metasearchRequestId%22%3A%22cb5f2e56-846c-4e98-ada0-3a1b1aa861ff%22%2C%22plc%22%3A%22Uz%2F51aey53IgPjFiTs8zCqt%2FEzVSVv3B37GI8CihLxgZQ4P2RnJ4vXuEz6mydh0QWSafPGCMr%2FG%2FGO8e%2BT5i%2Fg%3D%3D%22%7D&metasearchId=GoogleHotelAdsUser&metasearchRateId=desktop&metasearchRatekey=sgyUU2M0LrnnpXh1LPwoI&priceDisplay=TOTAL&metasearchRefid=12345678910abcdefghijk@-&adType=0&PPA=0&hotelCampaign=1&cur=USD",
        "price": {
          "value": 1264,
          "currency": "USD"
        },
        "cost": {
          "value": 1264,
          "currency": "USD"
        },
        "price_with_tax": {
          "value": 1264,
          "currency": "USD"
        },
        "cost_with_tax": {
          "value": 1264,
          "currency": "USD"
        }
      },
      {
        "title": "Traveluro",
        "logo": "https://www.gstatic.com/travel-hotels/branding/aa5293d0-1acc-4289-ab28-fe6381cfbe5a.png",
        "link": "https://www.traveluro.com/hotels/united-states_ny_new-york/555839_four-seasons-hotel-new-york-downtown?checkIn=2026-02-27&checkOut=2026-02-28&placeId=H555839&campaignName=Google_US&currencyCode=USD&dealKey=CAIQqwEiDAj3k4PNBhD48pvoAipMDQBguEQVAKCURCVmJj1DLQAAYEAwATiBA0UAYLhESgwI8JODzQYQpL-FiQJiClN0YW5kYXJkIEtoAoIBAI0BmlG4RKABp7sPqAHIBjCrATi_9iFAg_EPSAFSCJRlQNrVaJT-WMgG&countryCode=US&languageCode=en&rule=Google_US&site=localuniversal&origin=31&ads=&priceDisplayedTotal=1475.00&priceDisplayedTax=192.65&device=desktop&adults=2&children=0",
        "price": {
          "value": 1282,
          "currency": "USD"
        },
        "cost": {
          "value": 1282,
          "currency": "USD"
        },
        "price_with_tax": {
          "value": 1475,
          "currency": "USD"
        },
        "cost_with_tax": {
          "value": 1475,
          "currency": "USD"
        }
      },
      {
        "title": "luxuryescapes",
        "logo": "https://www.gstatic.com/travel-hotels/branding/7619586669298897040.png",
        "link": "https://luxuryescapes.com/us/metasearch/dce147fd-8580-435a-a8ad-dffadf3194e1?utm_bp=3&source=metasearch&checkIn=2026-02-27&checkOut=2026-02-28&propertyName=Four%20Seasons%20Hotel%20New%20York%20Downtown&propertyId=bedbank%3Adce147fd-8580-435a-a8ad-dffadf3194e1&roomTypeId=387f93e3-4179-4bab-bbc3-53c89c496ac3&roomRateId=387f93e3-4179-4bab-bbc3-53c89c496ac3_1_pkg&adults=2&children=none&utm_source=google&utm_medium=organic&utm_content=gha-lpp&currency=USD&priceTotal=2937.36&ruleId=B2C&userCountry=US",
        "price": {
          "value": 2555,
          "currency": "USD"
        },
        "cost": {
          "value": 2555,
          "currency": "USD"
        },
        "price_with_tax": {
          "value": 2937,
          "currency": "USD"
        },
        "cost_with_tax": {
          "value": 2937,
          "currency": "USD"
        }
      }
    ],
    "reviews": {
      "rating": 4.7,
      "reviews_cnt": 1280,
      "reviews_by_stars": {
        "5 star": "1%"
      }
    }
  }
  ```
</ResponseExample>


# Google Hotels async request
Source: https://docs.brightdata.com/api-reference/serp/google-hotels/async

Use the Bright Data Google Hotels async endpoint (31 languages). Submit a request, poll the job ID and retrieve results as JSON with 200 OK on success.

```txt wrap theme={null}
https://www.google.com/travel/hotels?q=four+seasons+hotel+new+york+downtown
```

<ParamField type="boolean">
  Set `async=true` in the request URL to enable asynchronous requests.

  ```txt wrap theme={null}
  https://api.brightdata.com/request?async=true
  ```
</ParamField>

## Parameters

<ParamField type="string">
  The search query parameter. Specifies the keyword or phrase you want to search for on Google.

  ```txt wrap theme={null}
  https://www.google.com/travel/hotels?q=four+seasons+hotel+new+york+downtown
  ```
</ParamField>

<RequestExample>
  ```shell cURL highlight={1} theme={null}
    curl -X POST https://api.brightdata.com/request?async=true \
    --header "Content-Type: application/json" \
    --header "Authorization: Bearer API_KEY" \
    --data '{
      "zone": "serp_api1",
      "url": "https://www.google.com/travel/hotels?q=four+seasons+hotel+new+york+downtown",
      "format": "raw"
    }'
  ```

  ```shell Native proxy highlight={4} theme={null}
  curl -i --silent --compressed \
    -H "Content-Type: application/json"
    -H "Authorization: Bearer API_KEY" \
    -d $'{"country":"us","query":{"q":"pizza"}}'
    "https://api.brightdata.com/serp/req?customer=CUSTOMER_USERNAME&zone=ZONE_NAME"
  ```

  ```js Node.js highlight={2} theme={null}
  (async () => {
    const response = await fetch('https://api.brightdata.com/request?async=true', {
      method: 'POST',
      headers: {
        'Content-Type': 'application/json',
        'Authorization': 'Bearer API_KEY'
      },
      body: JSON.stringify({
        zone: 'serp_api1',
        url: 'https://www.google.com/travel/hotels?q=four+seasons+hotel+new+york+downtown',
        format: 'raw'
      })
    });
    
    const data = await response.text();
    console.log(data);
  })();
  ```

  ```python Python highlight={17} theme={null}
  import requests

  # API Configuration
  headers = {
      'Content-Type': 'application/json',
      'Authorization': 'Bearer API_KEY',
  }

  payload = {
      'zone': 'serp_api1',
      'url': 'https://www.google.com/travel/hotels?q=four+seasons+hotel+new+york+downtown',
      'format': 'raw'
  }

  # Make the request
  response = requests.post(
      'https://api.brightdata.com/request?async=true', 
      json=payload, 
      headers=headers
  )

  print(response.text)
  ```
</RequestExample>

<ResponseExample>
  ```json 200 theme={null}
  {
    "overview": {
      "type": "hotels",
      "title": "Four Seasons Hotel New York Downtown",
      "requested": {
        "start_date": "2026-03-06",
        "end_date": "2026-03-07",
        "occupancy": 2,
        "number_of_adults": 2
      },
      "available": true,
      "currency": "USD",
      "coordinates": {
        "latitude": 40.712633,
        "longitude": -74.0092141
      },
      "address": "27 Barclay St, New York, NY 10007",
      "phone": "(646) 880-1999",
      "fid": "0x89c25a18e3553f8b:0x1337dae5edaabaa2"
    },
    "prices": [
      {
        "title": "Booking.com",
        "logo": "https://www.gstatic.com/travel-hotels/branding/icon_184.png",
        "link": "https://www.google.com/aclk?sa=l&ai=DChsSEwi93-zwnPiSAxXyBwYAHWE7FUMYACICCAEQGRoCd3M&co=1&ase=2&gclid=EAIaIQobChMIvd_s8Jz4kgMV8gcGAB1hOxVDEAoYASABEgKkQPD_BwE&cid=CAASuwHkaL1egiUkcaDPYynZOvPq_V1EjqjtDp-9Z46FQkOyBpyfhHc-NUCl9yq3u7QyCAXmMfG7WgM0eJL-m6ffngDwqurgSL9-kC6NPHZDup2xReT7bDxa38ybswFsaU4B_G16xz9HcBlehtT01ctyXGnH2nDuDzIOE0RQGHNLuEE8c-jZ7vZkqreNfIZPxM-8E2BBF9MBAV42LwdqX2MhImKoMRZiXJ2W1Kk1zYceNVQugE8uJgtuFPUBLOmW&category=acrcp_v1_48&sig=AOD64_3WZxVwX7M7SdQk8bv9GVdk2wUCRA&adurl=",
        "price": {
          "value": 935,
          "currency": "USD"
        },
        "cost": {
          "value": 1076,
          "currency": "USD"
        },
        "price_with_tax": {
          "value": 1076,
          "currency": "USD"
        },
        "rooms": [
          {
            "title": "Manhattan Room with Double Beds",
            "pictures": [
              "https://lh3.googleusercontent.com/hrppk/ANjXD_xnOTripjyZxILxkGgM1cYmQNCrIY1AgC49RisFNimj2Fshwx2QGIQcEqMKtGUPMMgiTEEzO4iBsB7TbE47tH61of_7vI_YBVxRVepXz1HrN4BiNtYi4Ah55Rj-ClCQiYnxdsj2Tpfv5eCDvZZSbZZLfUosmTOb06MxTGypuYoqum1sM7IVOBEd69gXyVDP61aNCFq1_pfxvUA6hH4zIOqsaudDn5pkTw"
            ],
            "link": "https://www.google.com/aclk?sa=l&ai=DChsSEwi93-zwnPiSAxXyBwYAHWE7FUMYACICCAEQHBoCd3M&co=1&ase=2&gclid=EAIaIQobChMIvd_s8Jz4kgMV8gcGAB1hOxVDEAoYASAEEgLuCvD_BwE&cid=CAASuwHkaL1egiUkcaDPYynZOvPq_V1EjqjtDp-9Z46FQkOyBpyfhHc-NUCl9yq3u7QyCAXmMfG7WgM0eJL-m6ffngDwqurgSL9-kC6NPHZDup2xReT7bDxa38ybswFsaU4B_G16xz9HcBlehtT01ctyXGnH2nDuDzIOE0RQGHNLuEE8c-jZ7vZkqreNfIZPxM-8E2BBF9MBAV42LwdqX2MhImKoMRZiXJ2W1Kk1zYceNVQugE8uJgtuFPUBLOmW&category=acrcp_v1_48&sig=AOD64_0cXRg9LtSvb94BUoXNgy8J04C5QQ&adurl=",
            "extensions": [
              "2 double beds Free cancellation until Feb 27"
            ],
            "price": {
              "value": 935,
              "currency": "USD"
            },
            "cost": {
              "value": 1076,
              "currency": "USD"
            },
            "price_with_tax": {
              "value": 1076,
              "currency": "USD"
            }
          },
          {
            "title": "Liberty Suite",
            "pictures": [
              "https://lh3.googleusercontent.com/hrppk/ANjXD_zWFS0CdMRk4l9ZyD2WEhENua_lhcl151tKXdiyVEd3df2rCS_OT9oNo1z9ucWUFbu9qUa-2e94u9qYlLAEhP2kfhc2eC1XuqvQIkVleTmhE-GpsCtZ8W7Z6F9iEH-ksjoYLDTXJpWop7XJncxvLfeaoL8HQBbNlYfm9MGirHA9P__hgBbv44tBBEX614hpQmQ4vIL1OrS_55SiEINCqyNKvzxnZ4mSkSo"
            ],
            "link": "https://www.google.com/aclk?sa=l&ai=DChsSEwi93-zwnPiSAxXyBwYAHWE7FUMYACICCAEQHRoCd3M&co=1&ase=2&gclid=EAIaIQobChMIvd_s8Jz4kgMV8gcGAB1hOxVDEAoYASAFEgLqhPD_BwE&cid=CAASuwHkaL1egiUkcaDPYynZOvPq_V1EjqjtDp-9Z46FQkOyBpyfhHc-NUCl9yq3u7QyCAXmMfG7WgM0eJL-m6ffngDwqurgSL9-kC6NPHZDup2xReT7bDxa38ybswFsaU4B_G16xz9HcBlehtT01ctyXGnH2nDuDzIOE0RQGHNLuEE8c-jZ7vZkqreNfIZPxM-8E2BBF9MBAV42LwdqX2MhImKoMRZiXJ2W1Kk1zYceNVQugE8uJgtuFPUBLOmW&category=acrcp_v1_48&sig=AOD64_1ar70DInUs8eU0WRh2f8RzL1QKww&adurl=",
            "extensions": [
              "Suite 3 guests Free cancellation until Feb 27 Suite"
            ],
            "price": {
              "value": 2440,
              "currency": "USD"
            },
            "cost": {
              "value": 2805,
              "currency": "USD"
            },
            "price_with_tax": {
              "value": 2805,
              "currency": "USD"
            }
          },
          {
            "title": "Liberty Suite",
            "pictures": [
              "https://lh3.googleusercontent.com/hrppk/ANjXD_zWFS0CdMRk4l9ZyD2WEhENua_lhcl151tKXdiyVEd3df2rCS_OT9oNo1z9ucWUFbu9qUa-2e94u9qYlLAEhP2kfhc2eC1XuqvQIkVleTmhE-GpsCtZ8W7Z6F9iEH-ksjoYLDTXJpWop7XJncxvLfeaoL8HQBbNlYfm9MGirHA9P__hgBbv44tBBEX614hpQmQ4vIL1OrS_55SiEINCqyNKvzxnZ4mSkSo"
            ],
            "link": "https://www.google.com/aclk?sa=l&ai=DChsSEwi93-zwnPiSAxXyBwYAHWE7FUMYACICCAEQHhoCd3M&co=1&ase=2&gclid=EAIaIQobChMIvd_s8Jz4kgMV8gcGAB1hOxVDEAoYASAGEgKKYfD_BwE&cid=CAASuwHkaL1egiUkcaDPYynZOvPq_V1EjqjtDp-9Z46FQkOyBpyfhHc-NUCl9yq3u7QyCAXmMfG7WgM0eJL-m6ffngDwqurgSL9-kC6NPHZDup2xReT7bDxa38ybswFsaU4B_G16xz9HcBlehtT01ctyXGnH2nDuDzIOE0RQGHNLuEE8c-jZ7vZkqreNfIZPxM-8E2BBF9MBAV42LwdqX2MhImKoMRZiXJ2W1Kk1zYceNVQugE8uJgtuFPUBLOmW&category=acrcp_v1_48&sig=AOD64_3Tw83cHkve-fjPnlHEu96gRaGYag&adurl=",
            "extensions": [
              "Suite 4 guests Free cancellation until Feb 27 Suite"
            ],
            "price": {
              "value": 2540,
              "currency": "USD"
            },
            "cost": {
              "value": 2920,
              "currency": "USD"
            },
            "price_with_tax": {
              "value": 2920,
              "currency": "USD"
            }
          }
        ]
      },
      {
        "title": "Hotels.com",
        "logo": "https://www.gstatic.com/travel-hotels/branding/f358dd45-ebd1-4af8-988d-d53154b73975.png",
        "link": "https://www.google.com/aclk?sa=l&ai=DChsSEwi93-zwnPiSAxXyBwYAHWE7FUMYACICCAEQIBoCd3M&co=1&ase=2&gclid=EAIaIQobChMIvd_s8Jz4kgMV8gcGAB1hOxVDEAoYAiABEgLFyPD_BwE&cid=CAASuwHkaL1egiUkcaDPYynZOvPq_V1EjqjtDp-9Z46FQkOyBpyfhHc-NUCl9yq3u7QyCAXmMfG7WgM0eJL-m6ffngDwqurgSL9-kC6NPHZDup2xReT7bDxa38ybswFsaU4B_G16xz9HcBlehtT01ctyXGnH2nDuDzIOE0RQGHNLuEE8c-jZ7vZkqreNfIZPxM-8E2BBF9MBAV42LwdqX2MhImKoMRZiXJ2W1Kk1zYceNVQugE8uJgtuFPUBLOmW&category=acrcp_v1_48&sig=AOD64_0Uc0x_tn6Dpzw1hNIA3bvO-V8XeQ&adurl=",
        "price": {
          "value": 935,
          "currency": "USD"
        },
        "cost": {
          "value": 1076,
          "currency": "USD"
        },
        "price_with_tax": {
          "value": 1076,
          "currency": "USD"
        },
        "rooms": [
          {
            "title": "Accessible Manhattan Room with King Bed",
            "pictures": [
              "https://lh3.googleusercontent.com/hrppk/ANjXD_zirGqnNUV3bUkVZ6Yq4QzaxzMTFw8S7BL88YG2xqf5qarRKkr50s-PfillUJkRvSl7KQqXwV9-bVLeYtBRigMpPPejfmFNDLX3qXcjydhC3sIHQL6X9_KcnnQtD_1b8kFPT_gkxt3Bjoif3Alols11Pq0yWqW6dkvZ"
            ],
            "link": "https://www.google.com/aclk?sa=l&ai=DChsSEwi93-zwnPiSAxXyBwYAHWE7FUMYACICCAEQIRoCd3M&co=1&ase=2&gclid=EAIaIQobChMIvd_s8Jz4kgMV8gcGAB1hOxVDEAoYAiACEgLJMfD_BwE&cid=CAASuwHkaL1egiUkcaDPYynZOvPq_V1EjqjtDp-9Z46FQkOyBpyfhHc-NUCl9yq3u7QyCAXmMfG7WgM0eJL-m6ffngDwqurgSL9-kC6NPHZDup2xReT7bDxa38ybswFsaU4B_G16xz9HcBlehtT01ctyXGnH2nDuDzIOE0RQGHNLuEE8c-jZ7vZkqreNfIZPxM-8E2BBF9MBAV42LwdqX2MhImKoMRZiXJ2W1Kk1zYceNVQugE8uJgtuFPUBLOmW&category=acrcp_v1_48&sig=AOD64_1-IaI3Wc2iZiz04F2g0iO4omJcxw&adurl=",
            "extensions": [
              "1 king bed Free cancellation until Feb 28"
            ],
            "price": {
              "value": 935,
              "currency": "USD"
            },
            "cost": {
              "value": 1076,
              "currency": "USD"
            },
            "price_with_tax": {
              "value": 1076,
              "currency": "USD"
            }
          },
          {
            "title": "Manhattan Room with Double Beds",
            "pictures": [
              "https://lh3.googleusercontent.com/hrppk/ANjXD_zBdES1oKIM8aMTINPz_t2xtu2KC-uSe_oOKzsl9YklwJYFM1GwO-qFi8swCpTQ_KV9p47-tkiSad2to48uKImdUBLBvt6mhp6Hs8Q18Gxe3ss20foBlRPuXa_2vk47r8GRUWFd23wok1KV0TIGM9U2NVIgJ0V74PeZ"
            ],
            "link": "https://www.google.com/aclk?sa=l&ai=DChsSEwi93-zwnPiSAxXyBwYAHWE7FUMYACICCAEQIhoCd3M&co=1&ase=2&gclid=EAIaIQobChMIvd_s8Jz4kgMV8gcGAB1hOxVDEAoYAiADEgJLvPD_BwE&cid=CAASuwHkaL1egiUkcaDPYynZOvPq_V1EjqjtDp-9Z46FQkOyBpyfhHc-NUCl9yq3u7QyCAXmMfG7WgM0eJL-m6ffngDwqurgSL9-kC6NPHZDup2xReT7bDxa38ybswFsaU4B_G16xz9HcBlehtT01ctyXGnH2nDuDzIOE0RQGHNLuEE8c-jZ7vZkqreNfIZPxM-8E2BBF9MBAV42LwdqX2MhImKoMRZiXJ2W1Kk1zYceNVQugE8uJgtuFPUBLOmW&category=acrcp_v1_48&sig=AOD64_1l9E4tRWWXqZXljR31RIHW1CjIRg&adurl=",
            "extensions": [
              "2 double beds Free cancellation until Feb 28"
            ],
            "price": {
              "value": 935,
              "currency": "USD"
            },
            "cost": {
              "value": 1076,
              "currency": "USD"
            },
            "price_with_tax": {
              "value": 1076,
              "currency": "USD"
            }
          },
          {
            "title": "Manhattan Room with king bed",
            "pictures": [
              "https://lh3.googleusercontent.com/hrppk/ANjXD_zirGqnNUV3bUkVZ6Yq4QzaxzMTFw8S7BL88YG2xqf5qarRKkr50s-PfillUJkRvSl7KQqXwV9-bVLeYtBRigMpPPejfmFNDLX3qXcjydhC3sIHQL6X9_KcnnQtD_1b8kFPT_gkxt3Bjoif3Alols11Pq0yWqW6dkvZ"
            ],
            "link": "https://www.google.com/aclk?sa=l&ai=DChsSEwi93-zwnPiSAxXyBwYAHWE7FUMYACICCAEQIxoCd3M&co=1&ase=2&gclid=EAIaIQobChMIvd_s8Jz4kgMV8gcGAB1hOxVDEAoYAiAEEgL_UvD_BwE&cid=CAASuwHkaL1egiUkcaDPYynZOvPq_V1EjqjtDp-9Z46FQkOyBpyfhHc-NUCl9yq3u7QyCAXmMfG7WgM0eJL-m6ffngDwqurgSL9-kC6NPHZDup2xReT7bDxa38ybswFsaU4B_G16xz9HcBlehtT01ctyXGnH2nDuDzIOE0RQGHNLuEE8c-jZ7vZkqreNfIZPxM-8E2BBF9MBAV42LwdqX2MhImKoMRZiXJ2W1Kk1zYceNVQugE8uJgtuFPUBLOmW&category=acrcp_v1_48&sig=AOD64_2kR-kPDdNnb1lcBUNkpM5s-Q_yLw&adurl=",
            "extensions": [
              "1 king bed Free cancellation until Feb 28"
            ],
            "price": {
              "value": 935,
              "currency": "USD"
            },
            "cost": {
              "value": 1076,
              "currency": "USD"
            },
            "price_with_tax": {
              "value": 1076,
              "currency": "USD"
            }
          },
          {
            "title": "Accessible SoHo Premier King",
            "pictures": [
              "https://lh3.googleusercontent.com/hrppk/ANjXD_xfIleTKUi_ePsxGkSstGASzo99qNFBpB94rAAtcEI1C-ZLD4XATuPdh4hGG4RUio3DvonDRyOo7dGZScl55LMBJ7ZEgdijCjGdglXAmtBG3qRZGZdrm-Uggx1OjUAheXtRIDPT0atuWFPccAbkfddjQ7vp6ud3UM4"
            ],
            "link": "https://www.google.com/aclk?sa=l&ai=DChsSEwi93-zwnPiSAxXyBwYAHWE7FUMYACICCAEQJBoCd3M&co=1&ase=2&gclid=EAIaIQobChMIvd_s8Jz4kgMV8gcGAB1hOxVDEAoYAiAFEgKVwPD_BwE&cid=CAASuwHkaL1egiUkcaDPYynZOvPq_V1EjqjtDp-9Z46FQkOyBpyfhHc-NUCl9yq3u7QyCAXmMfG7WgM0eJL-m6ffngDwqurgSL9-kC6NPHZDup2xReT7bDxa38ybswFsaU4B_G16xz9HcBlehtT01ctyXGnH2nDuDzIOE0RQGHNLuEE8c-jZ7vZkqreNfIZPxM-8E2BBF9MBAV42LwdqX2MhImKoMRZiXJ2W1Kk1zYceNVQugE8uJgtuFPUBLOmW&category=acrcp_v1_48&sig=AOD64_0ZrJRz7IXgFt5CcI54GIb2V_aOEA&adurl=",
            "extensions": [
              "1 king bed Free cancellation until Feb 28"
            ],
            "price": {
              "value": 1035,
              "currency": "USD"
            },
            "cost": {
              "value": 1191,
              "currency": "USD"
            },
            "price_with_tax": {
              "value": 1191,
              "currency": "USD"
            }
          },
          {
            "title": "SoHo Premier King",
            "pictures": [
              "https://lh3.googleusercontent.com/hrppk/ANjXD_wuMW97qyG0dgi5Gj5Nob9SzWQ170RVssqu5Fios_swsegU93lsHLoiTo_9hPSttkpklB0QBmU3t8wNPCQgylOL-NJIgsqbtdxI9d0gUE0XKG75M-LzpdyK3M_cTzH8nIl8lL0Sg42N7pxz2ygDzoP-qsR7LH3Hj-q4"
            ],
            "link": "https://www.google.com/aclk?sa=l&ai=DChsSEwi93-zwnPiSAxXyBwYAHWE7FUMYACICCAEQJRoCd3M&co=1&ase=2&gclid=EAIaIQobChMIvd_s8Jz4kgMV8gcGAB1hOxVDEAoYAiAGEgLyS_D_BwE&cid=CAASuwHkaL1egiUkcaDPYynZOvPq_V1EjqjtDp-9Z46FQkOyBpyfhHc-NUCl9yq3u7QyCAXmMfG7WgM0eJL-m6ffngDwqurgSL9-kC6NPHZDup2xReT7bDxa38ybswFsaU4B_G16xz9HcBlehtT01ctyXGnH2nDuDzIOE0RQGHNLuEE8c-jZ7vZkqreNfIZPxM-8E2BBF9MBAV42LwdqX2MhImKoMRZiXJ2W1Kk1zYceNVQugE8uJgtuFPUBLOmW&category=acrcp_v1_48&sig=AOD64_0iD3vQeRSxwkBcCu0F0NEdbpHPBQ&adurl=",
            "extensions": [
              "1 king bed Free cancellation until Feb 28"
            ],
            "price": {
              "value": 1035,
              "currency": "USD"
            },
            "cost": {
              "value": 1191,
              "currency": "USD"
            },
            "price_with_tax": {
              "value": 1191,
              "currency": "USD"
            }
          },
          {
            "title": "SoHo Premier Double",
            "pictures": [
              "https://lh3.googleusercontent.com/hrppk/ANjXD_yWbtP4vz4gyFOxx-uO3-5Qz-n7oPrXCYz5CjsOYpGwfd4vSy9B9DmddpQ72H1LjiPhk20d5mt6c1lijronkH7FfBq_eJpzEc5CHGZ7teq5zP3sV-Qv2c7VwXXrPvClVawgmkgAWf80sXLQrVzreBLAZ8lA7k1Ud8YY"
            ],
            "link": "https://www.google.com/aclk?sa=l&ai=DChsSEwi93-zwnPiSAxXyBwYAHWE7FUMYACICCAEQJhoCd3M&co=1&ase=2&gclid=EAIaIQobChMIvd_s8Jz4kgMV8gcGAB1hOxVDEAoYAiAHEgJD9_D_BwE&cid=CAASuwHkaL1egiUkcaDPYynZOvPq_V1EjqjtDp-9Z46FQkOyBpyfhHc-NUCl9yq3u7QyCAXmMfG7WgM0eJL-m6ffngDwqurgSL9-kC6NPHZDup2xReT7bDxa38ybswFsaU4B_G16xz9HcBlehtT01ctyXGnH2nDuDzIOE0RQGHNLuEE8c-jZ7vZkqreNfIZPxM-8E2BBF9MBAV42LwdqX2MhImKoMRZiXJ2W1Kk1zYceNVQugE8uJgtuFPUBLOmW&category=acrcp_v1_48&sig=AOD64_1-qvLSoH3qtZl1Jzkpvr6iRQtDug&adurl=",
            "extensions": [
              "1 double bed Free cancellation until Feb 28"
            ],
            "price": {
              "value": 1070,
              "currency": "USD"
            },
            "cost": {
              "value": 1231,
              "currency": "USD"
            },
            "price_with_tax": {
              "value": 1231,
              "currency": "USD"
            }
          },
          {
            "title": "Hudson Corner King",
            "pictures": [
              "https://lh3.googleusercontent.com/hrppk/ANjXD_xh7ZruI7-cODN5bzF1IWAG3PEIQADDGgw0sWtDDRk-TbV4EPtEVYDEJewJgMRtl6Zejine24V66DGiU5FlqCq-EMgShWDmqhjLyVs9FERHWG0QxGnFxW7LN7-HGl4UrF7-s8XcAj7YDUQ5xjlaAX-v836WgUq0svU"
            ],
            "link": "https://www.google.com/aclk?sa=l&ai=DChsSEwi93-zwnPiSAxXyBwYAHWE7FUMYACICCAEQJxoCd3M&co=1&ase=2&gclid=EAIaIQobChMIvd_s8Jz4kgMV8gcGAB1hOxVDEAoYAiAIEgK2a_D_BwE&cid=CAASuwHkaL1egiUkcaDPYynZOvPq_V1EjqjtDp-9Z46FQkOyBpyfhHc-NUCl9yq3u7QyCAXmMfG7WgM0eJL-m6ffngDwqurgSL9-kC6NPHZDup2xReT7bDxa38ybswFsaU4B_G16xz9HcBlehtT01ctyXGnH2nDuDzIOE0RQGHNLuEE8c-jZ7vZkqreNfIZPxM-8E2BBF9MBAV42LwdqX2MhImKoMRZiXJ2W1Kk1zYceNVQugE8uJgtuFPUBLOmW&category=acrcp_v1_48&sig=AOD64_1zUSId1nUwCQq7yh4XLKuB1Ohivg&adurl=",
            "extensions": [
              "1 king bed Free cancellation until Feb 28"
            ],
            "price": {
              "value": 1135,
              "currency": "USD"
            },
            "cost": {
              "value": 1306,
              "currency": "USD"
            },
            "price_with_tax": {
              "value": 1306,
              "currency": "USD"
            }
          },
          {
            "title": "Hudson Corner Double",
            "pictures": [
              "https://lh3.googleusercontent.com/hrppk/ANjXD_zBdES1oKIM8aMTINPz_t2xtu2KC-uSe_oOKzsl9YklwJYFM1GwO-qFi8swCpTQ_KV9p47-tkiSad2to48uKImdUBLBvt6mhp6Hs8Q18Gxe3ss20foBlRPuXa_2vk47r8GRUWFd23wok1KV0TIGM9U2NVIgJ0V74PeZ"
            ],
            "link": "https://www.google.com/aclk?sa=l&ai=DChsSEwi93-zwnPiSAxXyBwYAHWE7FUMYACICCAEQKBoCd3M&co=1&ase=2&gclid=EAIaIQobChMIvd_s8Jz4kgMV8gcGAB1hOxVDEAoYAiAJEgJde_D_BwE&cid=CAASuwHkaL1egiUkcaDPYynZOvPq_V1EjqjtDp-9Z46FQkOyBpyfhHc-NUCl9yq3u7QyCAXmMfG7WgM0eJL-m6ffngDwqurgSL9-kC6NPHZDup2xReT7bDxa38ybswFsaU4B_G16xz9HcBlehtT01ctyXGnH2nDuDzIOE0RQGHNLuEE8c-jZ7vZkqreNfIZPxM-8E2BBF9MBAV42LwdqX2MhImKoMRZiXJ2W1Kk1zYceNVQugE8uJgtuFPUBLOmW&category=acrcp_v1_48&sig=AOD64_22y9VcsfNpoGEERdBgj2VqhrAopg&adurl=",
            "extensions": [
              "1 double bed Free cancellation until Feb 28"
            ],
            "price": {
              "value": 1170,
              "currency": "USD"
            },
            "cost": {
              "value": 1346,
              "currency": "USD"
            },
            "price_with_tax": {
              "value": 1346,
              "currency": "USD"
            }
          },
          {
            "title": "Accessible Liberty Suite",
            "pictures": [
              "https://lh3.googleusercontent.com/hrppk/ANjXD_ww5DsjCN4YmZZyFdZwwPcaACASJul2NHBc33CJI6PmL57ABgizbEjzHfF-mdnm5fxu6htw4H8-uYg1_Hp4qVlRby0MErfZfndCcURjMKhkg1-H-L9fnoCjiJ7eBmFoggT1Yxbr1qxMmBTH5lSeBZGEPtjpj86vT0g"
            ],
            "link": "https://www.google.com/aclk?sa=l&ai=DChsSEwi93-zwnPiSAxXyBwYAHWE7FUMYACICCAEQKRoCd3M&co=1&ase=2&gclid=EAIaIQobChMIvd_s8Jz4kgMV8gcGAB1hOxVDEAoYAiAKEgJvsfD_BwE&cid=CAASuwHkaL1egiUkcaDPYynZOvPq_V1EjqjtDp-9Z46FQkOyBpyfhHc-NUCl9yq3u7QyCAXmMfG7WgM0eJL-m6ffngDwqurgSL9-kC6NPHZDup2xReT7bDxa38ybswFsaU4B_G16xz9HcBlehtT01ctyXGnH2nDuDzIOE0RQGHNLuEE8c-jZ7vZkqreNfIZPxM-8E2BBF9MBAV42LwdqX2MhImKoMRZiXJ2W1Kk1zYceNVQugE8uJgtuFPUBLOmW&category=acrcp_v1_48&sig=AOD64_2U0x0rvKUK5FsuuDInhoRPaeosTQ&adurl=",
            "extensions": [
              "Suite Free cancellation until Feb 28 Suite"
            ],
            "price": {
              "value": 2340,
              "currency": "USD"
            },
            "cost": {
              "value": 2691,
              "currency": "USD"
            },
            "price_with_tax": {
              "value": 2691,
              "currency": "USD"
            }
          },
          {
            "title": "Liberty Suite",
            "pictures": [
              "https://lh3.googleusercontent.com/hrppk/ANjXD_wzZm0OmUCedgu3fTY7PUUPLbLCV5zcQfVDJeHlIBCvk_avmplnbY5FYHLBDZKrSL5xDNRYIn5kBNf-pTzMl2LYIG88MTku07E2_2upUCMIEmY5ZBgeEaPLdgYIcJi5ZTmfLknhkRwQxfF_ZBA8n0mDClKJ3zKe-XUZ"
            ],
            "link": "https://www.google.com/aclk?sa=l&ai=DChsSEwi93-zwnPiSAxXyBwYAHWE7FUMYACICCAEQKhoCd3M&co=1&ase=2&gclid=EAIaIQobChMIvd_s8Jz4kgMV8gcGAB1hOxVDEAoYAiALEgIye_D_BwE&cid=CAASuwHkaL1egiUkcaDPYynZOvPq_V1EjqjtDp-9Z46FQkOyBpyfhHc-NUCl9yq3u7QyCAXmMfG7WgM0eJL-m6ffngDwqurgSL9-kC6NPHZDup2xReT7bDxa38ybswFsaU4B_G16xz9HcBlehtT01ctyXGnH2nDuDzIOE0RQGHNLuEE8c-jZ7vZkqreNfIZPxM-8E2BBF9MBAV42LwdqX2MhImKoMRZiXJ2W1Kk1zYceNVQugE8uJgtuFPUBLOmW&category=acrcp_v1_48&sig=AOD64_34I7FZ_rEBXGJThi3NhYqDuWYI3A&adurl=",
            "extensions": [
              "Suite Free cancellation until Feb 28 Suite"
            ],
            "price": {
              "value": 2340,
              "currency": "USD"
            },
            "cost": {
              "value": 2691,
              "currency": "USD"
            },
            "price_with_tax": {
              "value": 2691,
              "currency": "USD"
            }
          },
          {
            "title": "Accessible Oculus Suite",
            "link": "https://www.google.com/aclk?sa=l&ai=DChsSEwi93-zwnPiSAxXyBwYAHWE7FUMYACICCAEQKxoCd3M&co=1&ase=2&gclid=EAIaIQobChMIvd_s8Jz4kgMV8gcGAB1hOxVDEAoYAiAMEgIFE_D_BwE&cid=CAASuwHkaL1egiUkcaDPYynZOvPq_V1EjqjtDp-9Z46FQkOyBpyfhHc-NUCl9yq3u7QyCAXmMfG7WgM0eJL-m6ffngDwqurgSL9-kC6NPHZDup2xReT7bDxa38ybswFsaU4B_G16xz9HcBlehtT01ctyXGnH2nDuDzIOE0RQGHNLuEE8c-jZ7vZkqreNfIZPxM-8E2BBF9MBAV42LwdqX2MhImKoMRZiXJ2W1Kk1zYceNVQugE8uJgtuFPUBLOmW&category=acrcp_v1_48&sig=AOD64_3ti3aEDih8ZhM7xCfbWZFN0AcKQg&adurl=",
            "extensions": [
              "Suite Free cancellation until Feb 28 Suite"
            ],
            "price": {
              "value": 3370,
              "currency": "USD"
            },
            "cost": {
              "value": 3873,
              "currency": "USD"
            },
            "price_with_tax": {
              "value": 3873,
              "currency": "USD"
            }
          },
          {
            "title": "Oculus Suite",
            "pictures": [
              "https://lh3.googleusercontent.com/hrppk/ANjXD_y4BiOX0ESx2hQ7R1AbK80n3kIom2QrPE77qx5wQvFyLUGAipd0VVxl3bzztdN3u3e0coud9niym1jM0s4UhuNUWRzj21SpdUKFbMiimNpy6v_iUqVvWpe-e3YUNId8uEmwiUehwTzNU9zmegcaboD_rrmY0mNts-tK"
            ],
            "link": "https://www.google.com/aclk?sa=l&ai=DChsSEwi93-zwnPiSAxXyBwYAHWE7FUMYACICCAEQLBoCd3M&co=1&ase=2&gclid=EAIaIQobChMIvd_s8Jz4kgMV8gcGAB1hOxVDEAoYAiANEgLNU_D_BwE&cid=CAASuwHkaL1egiUkcaDPYynZOvPq_V1EjqjtDp-9Z46FQkOyBpyfhHc-NUCl9yq3u7QyCAXmMfG7WgM0eJL-m6ffngDwqurgSL9-kC6NPHZDup2xReT7bDxa38ybswFsaU4B_G16xz9HcBlehtT01ctyXGnH2nDuDzIOE0RQGHNLuEE8c-jZ7vZkqreNfIZPxM-8E2BBF9MBAV42LwdqX2MhImKoMRZiXJ2W1Kk1zYceNVQugE8uJgtuFPUBLOmW&category=acrcp_v1_48&sig=AOD64_0LHnRl4WLtqnzsap0aQqFfKg1BbQ&adurl=",
            "extensions": [
              "Suite Free cancellation until Feb 28 Suite"
            ],
            "price": {
              "value": 3370,
              "currency": "USD"
            },
            "cost": {
              "value": 3873,
              "currency": "USD"
            },
            "price_with_tax": {
              "value": 3873,
              "currency": "USD"
            }
          },
          {
            "title": "Suite, 1 King Bed, Non Smoking (Gotham)",
            "pictures": [
              "https://lh3.googleusercontent.com/hrppk/ANjXD_wa3n-lr_eOJ0aPzXtn0Ebx66AFv4U7oXLWeRazx5Mx2o6WFFtgTe3EqZEunp1KCnoJm_wvXijwQ2Myh3MWvnXHxGeOfrUrPAcH16zjLtwHUkWaD5QHJID78QeK4jwRmpjx-VH9LUNu1xj7yJce1r__ZvucnvWD0Zc"
            ],
            "link": "https://www.google.com/aclk?sa=l&ai=DChsSEwi93-zwnPiSAxXyBwYAHWE7FUMYACICCAEQLRoCd3M&co=1&ase=2&gclid=EAIaIQobChMIvd_s8Jz4kgMV8gcGAB1hOxVDEAoYAiAOEgJKvvD_BwE&cid=CAASuwHkaL1egiUkcaDPYynZOvPq_V1EjqjtDp-9Z46FQkOyBpyfhHc-NUCl9yq3u7QyCAXmMfG7WgM0eJL-m6ffngDwqurgSL9-kC6NPHZDup2xReT7bDxa38ybswFsaU4B_G16xz9HcBlehtT01ctyXGnH2nDuDzIOE0RQGHNLuEE8c-jZ7vZkqreNfIZPxM-8E2BBF9MBAV42LwdqX2MhImKoMRZiXJ2W1Kk1zYceNVQugE8uJgtuFPUBLOmW&category=acrcp_v1_48&sig=AOD64_2S_jbXgWlzoU8K7yog2CEpOluqOg&adurl=",
            "extensions": [
              "1 king bed Free cancellation until Feb 28 Suite"
            ],
            "price": {
              "value": 3870,
              "currency": "USD"
            },
            "cost": {
              "value": 4446,
              "currency": "USD"
            },
            "price_with_tax": {
              "value": 4446,
              "currency": "USD"
            }
          },
          {
            "title": "Suite, 1 King Bed, Non Smoking, Terrace (Gotham)",
            "pictures": [
              "https://lh3.googleusercontent.com/hrppk/ANjXD_wa3n-lr_eOJ0aPzXtn0Ebx66AFv4U7oXLWeRazx5Mx2o6WFFtgTe3EqZEunp1KCnoJm_wvXijwQ2Myh3MWvnXHxGeOfrUrPAcH16zjLtwHUkWaD5QHJID78QeK4jwRmpjx-VH9LUNu1xj7yJce1r__ZvucnvWD0Zc"
            ],
            "link": "https://www.google.com/aclk?sa=l&ai=DChsSEwi93-zwnPiSAxXyBwYAHWE7FUMYACICCAEQLhoCd3M&co=1&ase=2&gclid=EAIaIQobChMIvd_s8Jz4kgMV8gcGAB1hOxVDEAoYAiAPEgKOW_D_BwE&cid=CAASuwHkaL1egiUkcaDPYynZOvPq_V1EjqjtDp-9Z46FQkOyBpyfhHc-NUCl9yq3u7QyCAXmMfG7WgM0eJL-m6ffngDwqurgSL9-kC6NPHZDup2xReT7bDxa38ybswFsaU4B_G16xz9HcBlehtT01ctyXGnH2nDuDzIOE0RQGHNLuEE8c-jZ7vZkqreNfIZPxM-8E2BBF9MBAV42LwdqX2MhImKoMRZiXJ2W1Kk1zYceNVQugE8uJgtuFPUBLOmW&category=acrcp_v1_48&sig=AOD64_2C1L5MfDLw9PVpTdVQNSYIu3EKvA&adurl=",
            "extensions": [
              "1 king bed Free cancellation until Feb 28 Suite"
            ],
            "price": {
              "value": 4070,
              "currency": "USD"
            },
            "cost": {
              "value": 4676,
              "currency": "USD"
            },
            "price_with_tax": {
              "value": 4676,
              "currency": "USD"
            }
          }
        ]
      }
    ],
    "reviews": {
      "rating": 4.7,
      "reviews_cnt": 1280,
      "reviews_by_stars": {
        "5 star": "1%"
      }
    }
  }
  ```
</ResponseExample>


# Google Hotels currency
Source: https://docs.brightdata.com/api-reference/serp/google-hotels/currency

Configure the Bright Data Google Hotels Google Hotels currency parameter to refine queries and return matching results as JSON or HTML. On port 44445.

```txt wrap theme={null}
https://www.google.com/travel/hotels?q=four+seasons+hotel+new+york+downtown&brd_currency=EUR
```

## Parameters

<ParamField type="string">
  The search query parameter. Specifies the keyword or phrase you want to search for on Google.
</ParamField>

<ParamField type="string">
  Currency to show prices at (3-letter code).

  ```txt wrap theme={null}
  https://www.google.com/travel/hotels?q=four+seasons+hotel+new+york+downtown&brd_currency=EUR
  ```

  | Parameter          | Description           |
  | ------------------ | --------------------- |
  | `brd_currency=USD` | United States Dollars |
  | `brd_currency=EUR` | Euro                  |
  | `brd_currency=INR` | Indian Rupees         |
</ParamField>

<RequestExample>
  ```shell cURL highlight={6} theme={null}
    curl -X POST https://api.brightdata.com/request \
    --header "Content-Type: application/json" \
    --header "Authorization: Bearer API_KEY" \
    --data '{
      "zone": "serp_api1",
      "url": "https://www.google.com/travel/hotels?q=four+seasons+hotel+new+york+downtown&brd_currency=EUR",
      "format": "raw"
    }'
  ```

  ```shell Native proxy highlight={4} theme={null}
  curl --proxy brd.superproxy.io:44445 \
    --proxy-user CUSTOMER_USERNAME:CUSTOMER_PASSWORD \
    --ssl-no-revoke \
    "https://www.google.com/travel/hotels?q=four+seasons+hotel+new+york+downtown&brd_currency=EUR"
  ```

  ```js Node.js highlight={10} theme={null}
  (async () => {
    const response = await fetch('https://api.brightdata.com/request', {
      method: 'POST',
      headers: {
        'Content-Type': 'application/json',
        'Authorization': 'Bearer API_KEY'
      },
      body: JSON.stringify({
        zone: 'serp_api1',
        url: 'https://www.google.com/travel/hotels?q=four+seasons+hotel+new+york+downtown&brd_currency=EUR',
        format: 'raw'
      })
    });
    
    const data = await response.text();
    console.log(data);
  })();
  ```

  ```python Python highlight={11} theme={null}
  import requests

  # API Configuration
  headers = {
      'Content-Type': 'application/json',
      'Authorization': 'Bearer API_KEY',
  }

  payload = {
      'zone': 'serp_api1',
      'url': 'https://www.google.com/travel/hotels?q=four+seasons+hotel+new+york+downtown&brd_currency=EUR',
      'format': 'raw'
  }

  # Make the request
  response = requests.post(
      'https://api.brightdata.com/request', 
      json=payload, 
      headers=headers
  )

  print(response.text)
  ```
</RequestExample>

<ResponseExample>
  ```json 200 highlight={12} theme={null}
  {
    "overview": {
      "type": "hotels",
      "title": "Four Seasons Hotel New York Downtown",
      "requested": {
        "start_date": "2026-02-27",
        "end_date": "2026-02-28",
        "occupancy": 2,
        "number_of_adults": 2
      },
      "available": true,
      "currency": "EUR",
      "coordinates": {
        "latitude": 40.712633,
        "longitude": -74.0092141
      },
      "address": "27 Barclay St, New York, NY 10007, United States",
      "phone": "+1 646-880-1999",
      "fid": "0x89c25a18e3553f8b:0x1337dae5edaabaa2"
    },
    "prices": [
      {
        "title": "trivago.de",
        "logo": "https://www.gstatic.com/travel-hotels/branding/1922649917165881388.png",
        "link": "https://www.google.com/aclk?sa=l&ai=DChsSEwi_sZGVpviSAxVnmFAGHYDeBe8YACICCAEQAxoCZGc&co=1&ase=2&gclid=EAIaIQobChMIv7GRlab4kgMVZ5hQBh2A3gXvEAoYASABEgIMmPD_BwE&category=acrcp_v1_48&sig=AOD64_0a1P9Yt88LhcGZJx58EjOh4fTiVQ&adurl=",
        "price": {
          "value": 1066,
          "currency": "EUR"
        },
        "cost": {
          "value": 1066,
          "currency": "EUR"
        },
        "price_with_tax": {
          "value": 1066,
          "currency": "EUR"
        }
      },
      {
        "title": "Tripadvisor.com",
        "logo": "https://www.gstatic.com/travel-hotels/branding/7993073966338005995.png",
        "link": "https://www.google.com/aclk?sa=l&ai=DChsSEwi_sZGVpviSAxVnmFAGHYDeBe8YACICCAEQDhoCZGc&co=1&ase=2&gclid=EAIaIQobChMIv7GRlab4kgMVZ5hQBh2A3gXvEAoYAiABEgJjdvD_BwE&category=acrcp_v1_48&sig=AOD64_2x9Ta0FB6YBsRCvcIyd_qLExGNhg&adurl=",
        "price": {
          "value": 1068,
          "currency": "EUR"
        },
        "cost": {
          "value": 1068,
          "currency": "EUR"
        },
        "price_with_tax": {
          "value": 1068,
          "currency": "EUR"
        }
      },
      {
        "title": "Bluepillow.de",
        "logo": "https://www.gstatic.com/travel-hotels/branding/c770e909-af04-45dd-8ad7-335bc5055826.png",
        "link": "https://www.google.com/aclk?sa=l&ai=DChsSEwi_sZGVpviSAxVnmFAGHYDeBe8YACICCAEQARoCZGc&co=1&ase=2&gclid=EAIaIQobChMIv7GRlab4kgMVZ5hQBh2A3gXvEAoYAyABEgLOGfD_BwE&category=acrcp_v1_48&sig=AOD64_215l665ommkn4MPu9h1G6vz_UrQg&adurl=",
        "price": {
          "value": 1068,
          "currency": "EUR"
        },
        "cost": {
          "value": 1068,
          "currency": "EUR"
        },
        "price_with_tax": {
          "value": 1068,
          "currency": "EUR"
        }
      },
      {
        "title": "Booking.com",
        "logo": "https://www.gstatic.com/travel-hotels/branding/icon_184.png",
        "link": "https://www.google.com/aclk?sa=l&ai=DChsSEwi_sZGVpviSAxVnmFAGHYDeBe8YACICCAEQBRoCZGc&co=1&ase=2&gclid=EAIaIQobChMIv7GRlab4kgMVZ5hQBh2A3gXvEAoYBCABEgL5ovD_BwE&category=acrcp_v1_48&sig=AOD64_2-wbT67uRZ3dpG-n84czp3pFidvw&adurl=",
        "price": {
          "value": 1068,
          "currency": "EUR"
        },
        "cost": {
          "value": 1068,
          "currency": "EUR"
        },
        "price_with_tax": {
          "value": 1068,
          "currency": "EUR"
        },
        "rooms": [
          {
            "title": "Accessible Manhattan Room with King Bed",
            "pictures": [
              "https://lh3.googleusercontent.com/hrppk/ANjXD_ySiIEbCWYVgsWXAcT9P6GEaGc7OIZTLS03_DwOCK8IfvGbD_qIjGfPO3Eqe2ujdp686Jxaub2fQPluNbPelOp1hXNH1wTqhWRTw5yvK3qB_eDVgGDDZjnm-Y8JdMbrXO8mvoFY9XldhKGW0xzs8vHzPlebVX5jVqIXrZZrBft7bw1oadabdwy0BcKwTI-5__z5UG9mhDZhf8RBL3tbtlCP7ltZNmSUmDI"
            ],
            "link": "https://www.google.com/aclk?sa=l&ai=DChsSEwi_sZGVpviSAxVnmFAGHYDeBe8YACICCAEQBhoCZGc&co=1&ase=2&gclid=EAIaIQobChMIv7GRlab4kgMVZ5hQBh2A3gXvEAoYBCACEgI7h_D_BwE&category=acrcp_v1_48&sig=AOD64_0rd_VmXo7-De_CV-0ExmLlkshY3w&adurl=",
            "extensions": [
              "1 king bed Suite"
            ],
            "price": {
              "value": 1068,
              "currency": "EUR"
            },
            "cost": {
              "value": 1068,
              "currency": "EUR"
            },
            "price_with_tax": {
              "value": 1068,
              "currency": "EUR"
            }
          },
          {
            "title": "Manhattan Room with king bed",
            "pictures": [
              "https://lh3.googleusercontent.com/hrppk/ANjXD_zWFS0CdMRk4l9ZyD2WEhENua_lhcl151tKXdiyVEd3df2rCS_OT9oNo1z9ucWUFbu9qUa-2e94u9qYlLAEhP2kfhc2eC1XuqvQIkVleTmhE-GpsCtZ8W7Z6F9iEH-ksjoYLDTXJpWop7XJncxvLfeaoL8HQBbNlYfm9MGirHA9P__hgBbv44tBBEX614hpQmQ4vIL1OrS_55SiEINCqyNKvzxnZ4mSkSo"
            ],
            "link": "https://www.google.com/aclk?sa=l&ai=DChsSEwi_sZGVpviSAxVnmFAGHYDeBe8YACICCAEQBxoCZGc&co=1&ase=2&gclid=EAIaIQobChMIv7GRlab4kgMVZ5hQBh2A3gXvEAoYBCADEgJQuvD_BwE&category=acrcp_v1_48&sig=AOD64_06FeYrVdQVj2GCjqiw5cSL3W2EqA&adurl=",
            "extensions": [
              "1 king bed"
            ],
            "price": {
              "value": 1068,
              "currency": "EUR"
            },
            "cost": {
              "value": 1068,
              "currency": "EUR"
            },
            "price_with_tax": {
              "value": 1068,
              "currency": "EUR"
            }
          },
          {
            "title": "Manhattan Room with Double Beds",
            "pictures": [
              "https://lh3.googleusercontent.com/hrppk/ANjXD_x0k4J54-9hPcjZD7dI7EPSPf0jTgUSjiBzg_tByN6hA54CETEg-NP6EA5YePboKLIbBc9zfFEJI8qMPNEkn_Dg4x6PZmLFAguh18RWhPqnEe7F0MXgyquSdIau9nfZMj1Jp6XO7lXEbcdWhWTf4fBGzfHV-xO01KiviU2RG-oP3o4kVsl08GcV8X6JTEI3qBUCHdelt_CbLOIdsouRqf00MT5QTTiDYw"
            ],
            "link": "https://www.google.com/aclk?sa=l&ai=DChsSEwi_sZGVpviSAxVnmFAGHYDeBe8YACICCAEQCBoCZGc&co=1&ase=2&gclid=EAIaIQobChMIv7GRlab4kgMVZ5hQBh2A3gXvEAoYBCAEEgJFAfD_BwE&category=acrcp_v1_48&sig=AOD64_3lylte3x_RmGQW44vvQhE6qAvZtg&adurl=",
            "extensions": [
              "2 double beds"
            ],
            "price": {
              "value": 1136,
              "currency": "EUR"
            },
            "cost": {
              "value": 1136,
              "currency": "EUR"
            },
            "price_with_tax": {
              "value": 1136,
              "currency": "EUR"
            }
          },
          {
            "title": "Liberty Suite",
            "pictures": [
              "https://lh3.googleusercontent.com/hrppk/ANjXD_zWFS0CdMRk4l9ZyD2WEhENua_lhcl151tKXdiyVEd3df2rCS_OT9oNo1z9ucWUFbu9qUa-2e94u9qYlLAEhP2kfhc2eC1XuqvQIkVleTmhE-GpsCtZ8W7Z6F9iEH-ksjoYLDTXJpWop7XJncxvLfeaoL8HQBbNlYfm9MGirHA9P__hgBbv44tBBEX614hpQmQ4vIL1OrS_55SiEINCqyNKvzxnZ4mSkSo"
            ],
            "link": "https://www.google.com/aclk?sa=l&ai=DChsSEwi_sZGVpviSAxVnmFAGHYDeBe8YACICCAEQCRoCZGc&co=1&ase=2&gclid=EAIaIQobChMIv7GRlab4kgMVZ5hQBh2A3gXvEAoYBCAFEgL_o_D_BwE&category=acrcp_v1_48&sig=AOD64_3df6i4XI55YVbJvdWR__d5rEYfCg&adurl=",
            "extensions": [
              "Suite 3 guests Suite"
            ],
            "price": {
              "value": 2587,
              "currency": "EUR"
            },
            "cost": {
              "value": 2587,
              "currency": "EUR"
            },
            "price_with_tax": {
              "value": 2587,
              "currency": "EUR"
            }
          },
          {
            "title": "Liberty Suite",
            "pictures": [
              "https://lh3.googleusercontent.com/hrppk/ANjXD_zWFS0CdMRk4l9ZyD2WEhENua_lhcl151tKXdiyVEd3df2rCS_OT9oNo1z9ucWUFbu9qUa-2e94u9qYlLAEhP2kfhc2eC1XuqvQIkVleTmhE-GpsCtZ8W7Z6F9iEH-ksjoYLDTXJpWop7XJncxvLfeaoL8HQBbNlYfm9MGirHA9P__hgBbv44tBBEX614hpQmQ4vIL1OrS_55SiEINCqyNKvzxnZ4mSkSo"
            ],
            "link": "https://www.google.com/aclk?sa=l&ai=DChsSEwi_sZGVpviSAxVnmFAGHYDeBe8YACICCAEQChoCZGc&co=1&ase=2&gclid=EAIaIQobChMIv7GRlab4kgMVZ5hQBh2A3gXvEAoYBCAGEgLXVPD_BwE&category=acrcp_v1_48&sig=AOD64_0dw_Q6x9sTC-35v0n_kmxtedJHvg&adurl=",
            "extensions": [
              "Suite 4 guests Suite"
            ],
            "price": {
              "value": 2685,
              "currency": "EUR"
            },
            "cost": {
              "value": 2685,
              "currency": "EUR"
            },
            "price_with_tax": {
              "value": 2685,
              "currency": "EUR"
            }
          },
          {
            "title": "Oculus Suite",
            "pictures": [
              "https://lh3.googleusercontent.com/hrppk/ANjXD_xLdqHwg-K7pMN18a6KDqVtRcOabuwWmRDA9Ri89kjhhMaoUIFccHAFXxdPlbGIrmAFrFEwTYVNMlTko89AmvqhuKF6AzR_Zm2bR3SKvfMn0z3CW6TofCz--cn3CxsVtGwx3SBS_v65LF2ZmOok40URqrq4dSUDR5Am6tvGc80Q_36-CwXtqCle7Spq_JTdhla34xp125Rh6E1uUredhS0dwj-hO6-8yfU"
            ],
            "link": "https://www.google.com/aclk?sa=l&ai=DChsSEwi_sZGVpviSAxVnmFAGHYDeBe8YACICCAEQCxoCZGc&co=1&ase=2&gclid=EAIaIQobChMIv7GRlab4kgMVZ5hQBh2A3gXvEAoYBCAHEgJIjfD_BwE&category=acrcp_v1_48&sig=AOD64_1nBZEah-EtAFDiTpoMosV0xSc5cg&adurl=",
            "extensions": [
              "Suite 3 guests Suite"
            ],
            "price": {
              "value": 3312,
              "currency": "EUR"
            },
            "cost": {
              "value": 3312,
              "currency": "EUR"
            },
            "price_with_tax": {
              "value": 3312,
              "currency": "EUR"
            }
          },
          {
            "title": "Oculus Suite",
            "pictures": [
              "https://lh3.googleusercontent.com/hrppk/ANjXD_xLdqHwg-K7pMN18a6KDqVtRcOabuwWmRDA9Ri89kjhhMaoUIFccHAFXxdPlbGIrmAFrFEwTYVNMlTko89AmvqhuKF6AzR_Zm2bR3SKvfMn0z3CW6TofCz--cn3CxsVtGwx3SBS_v65LF2ZmOok40URqrq4dSUDR5Am6tvGc80Q_36-CwXtqCle7Spq_JTdhla34xp125Rh6E1uUredhS0dwj-hO6-8yfU"
            ],
            "link": "https://www.google.com/aclk?sa=l&ai=DChsSEwi_sZGVpviSAxVnmFAGHYDeBe8YACICCAEQDBoCZGc&co=1&ase=2&gclid=EAIaIQobChMIv7GRlab4kgMVZ5hQBh2A3gXvEAoYBCAIEgLL8vD_BwE&category=acrcp_v1_48&sig=AOD64_3zx3DbaGC1ciFl6mLJhqLWgWQJQw&adurl=",
            "extensions": [
              "Suite 4 guests Suite"
            ],
            "price": {
              "value": 3409,
              "currency": "EUR"
            },
            "cost": {
              "value": 3409,
              "currency": "EUR"
            },
            "price_with_tax": {
              "value": 3409,
              "currency": "EUR"
            }
          }
        ]
      },
      {
        "title": "Super.com",
        "logo": "https://www.gstatic.com/travel-hotels/branding/cfa60c4a-13cd-46d3-9354-ec90c89ec855.png",
        "link": "https://www.super.com/travel/transition/?data=price=1017.4%26total_price=1170.89%26request_id=956ec49d-d194-4af5-b758-2a58b74df765%26ps=2178426524%26pp=MgpT26Ar_fcoyoSJr1OvFQ%26pb=J7O9V0FK0H7qVJjJTsKzWF5_O0c5XWr3ek5m89szLIEMFJC5Zxe8VDWcig3FYaBJx82ChZgnnEaEKIED4H1cTPfPJ24SjAKYEXQkaH-YIcnnjpAh23C7mZfjHcN7sssiZPdvWay6qRjU27cO8gpEQVdcujXFJsXAsQsmspk_MWUMq1NtVdg6hHJC6SWR302ZUzvKG4tCBXKzrkXNELop4dLQfw2gxlPp1aF42o5m9tU8pS0LG3dORQDmpQjlUU3vDVda4nVQax6lTNBAULvH-aGSfRQcIcp0ghvVAuCCILpIO4b3lrtg6obiJ9Ukj2r-2JPCoi52ZR0MZWq-wluUI6-p4MpbUEP4XxV5oP4407O-p_XSpzHYPZ0YM2tcjdbpRAvcW6QNh7LdFnKjr7UHnw%253D%253D%26gha_pull_request=True%26rtp=SdTUqdR7wIew8aRS9esAtw%253D%253D%26risk_lk_1=true%26alwd_risk=false%26alwd_rand=false%26gt=1772146882%26sg=1vDpD%26sid=GHA_MD7%26cmab_id=11%26ttl_bkt=none%26all_inclusive=false&utm_source=gha&utm_content=localuniversal&currency=USD&user_country=DE&verification=false&rate_rule_ids=&date_type=selected&rate_rule_id=signedout_desktop&display_currency=EUR&display_all_inclusive_price=992.56&checkin_at=2026-02-27&checkout_at=2026-02-28&provider_hotel_id=10007072903&provider=ean&num_adults=2&children=[]&hotel_campaign=&utm_campaign=&user_locale=en-DE&user_list_id=&utm_medium=organic&utm_id=gha_organic",
        "price": {
          "value": 993,
          "currency": "EUR"
        },
        "cost": {
          "value": 993,
          "currency": "EUR"
        },
        "price_with_tax": {
          "value": 993,
          "currency": "EUR"
        },
        "cost_with_tax": {
          "value": 993,
          "currency": "EUR"
        }
      },
      {
        "title": "Expedia.de",
        "logo": "https://www.gstatic.com/travel-hotels/branding/ac238c97-1652-4830-8da8-bb8d8883af88.png",
        "link": "https://www.expedia.de/Hotel-Search?selected=15438428&startDate=2026-02-27&endDate=2026-02-28&MDPCID=DE.META.HPA.HOTEL-ORGANIC-desktop.HOTEL&MDPDTL=HTL.15438428.20260227.20260228.DDF.1.CID..AUDID..RRID.bex_eu_desktop&adults=2&children=&mctc=10&ct=hotel&mpg=EUR&mpf=1066.47&mpj=139.66&mpr=0.00&mpl=EUR&exp_pg=google&langid=2057&ad=2&tp=&utm_source=google&utm_medium=cpc&utm_term=15438428&utm_content=localuniversal&utm_campaign=HotelAds&rateplanid=208165427&mpm=24&mpn=201555591&mpo=EC&mpp=1",
        "price": {
          "value": 1066,
          "currency": "EUR"
        },
        "cost": {
          "value": 1066,
          "currency": "EUR"
        },
        "price_with_tax": {
          "value": 1066,
          "currency": "EUR"
        },
        "cost_with_tax": {
          "value": 1066,
          "currency": "EUR"
        }
      },
      {
        "title": "Tripadvisor.com",
        "logo": "https://www.gstatic.com/travel-hotels/branding/7993073966338005995.png",
        "link": "https://www.tripadvisor.com/HotelHighlight?detail=10330604&m=66081&staydates=2026_02_27_2026_02_28&uguests=1_2_&supdv=desktop&supbl=localuniversal&supkl=selected&supuc=DE&supul=en&supia=0&supip=0&supmb=LawyZOnHWGTi5JureKez05Ux_4uzRfucwiwJO0Ur-EOZAGR2VATUEkIrCrQmFAl6hKCwChiBRN0oO91ccMkG_5Xt3rg_8uf1vJvHQcDHTGAGj6_NTAPi53B-zGoLJ5jYqfI-EEMFqC5i2g8cKPdPK-RErau2lMGv8CDvCDdShYpeP-VlWp3KAopc1dhACy&supmc=nQ4PpqcyHrfWrlYWf-P2yA5Xf3Hy9me7nAbFI2-lfjQWuqBigm4pDvLJVQzDnk3btwQ&supts=&supey=m|110581|PL_PCE_query&supcd=&suptp=5n6zb51uz_KcZX6CABEBIznuo2xyToGgGWYdsvwlhBJQAQy77vvUy3X-i-Eq_4YDS6M7mCE36on5ok897M9AgVDe4FIBYuYhfwBLNsxEfgBPBfBdZd0gDtIPUCyQUdXqBXYdjaelpCzNDb92k-_tAy2dyFs9LQsl7W1iPhYjSz6Bq1KLu6gfsm1AaND5hw&supas=",
        "price": {
          "value": 1068,
          "currency": "EUR"
        },
        "cost": {
          "value": 1068,
          "currency": "EUR"
        },
        "price_with_tax": {
          "value": 1068,
          "currency": "EUR"
        },
        "cost_with_tax": {
          "value": 1068,
          "currency": "EUR"
        }
      },
      {
        "title": "trivago DEALS",
        "logo": "https://www.gstatic.com/travel-hotels/branding/8670591202796644526.png",
        "link": "https://www.trivago.deals/hotels/united-states_ny_new-york/555839_four-seasons-hotel-new-york-downtown?checkIn=2026-02-27&checkOut=2026-02-28&placeId=H555839&campaignName=TrivagoDeals_Google_DE&currencyCode=EUR&dealKey=CAIQtwYiDAjToIPNBhDgh_r8AipJDQCAgkQVAMCURCVczwVDLXsUPkAwATiBA0UAgIJESgwIzqCDzQYQyNKakgJiClN0YW5kYXJkIEtoAo0B4YKCRKABp7sPqAHIBjDHBji_9iFAg_EPSAFSCCC2jaeiJp5SWNIH&countryCode=DE&languageCode=en&rule=Google_DE&site=localuniversal&ads=&origin=31&priceDisplayedTotal=1044.00&priceDisplayedTax=136.78&device=desktop&adults=2&children=0",
        "price": {
          "value": 1044,
          "currency": "EUR"
        },
        "cost": {
          "value": 1044,
          "currency": "EUR"
        },
        "price_with_tax": {
          "value": 1044,
          "currency": "EUR"
        },
        "cost_with_tax": {
          "value": 1044,
          "currency": "EUR"
        }
      },
      {
        "title": "Priceline",
        "logo": "https://www.gstatic.com/travel-hotels/branding/icon_220.png",
        "link": "https://www.priceline.com/r/?channel=meta&product=hotel&theme=ghalistings&refid=PLGOOGLEMSS&refclickid=DE_HP%7C35500803_localuniversal_1%7C20260227%7Cdesktop%7Cuserdate|public|||1%7C2%7C0|0|EN&hotelid=35500803&checkin=20260227&checkout=20260228&rooms=1&currency=USD&displayedCurr=EUR&POSCountryCode=DE&taxDisplayMode=BP&cityID=3000016152&adults=2&land=L&metaid=d2XxBXAt9Q75gh58g80rgqUAp7eGbPmm2lOGeL-B98Cv9eZIJL71vRkCXUhToMuWAq02eP_0wolJcn74idh9EMoMIWERkOcRirTP5N-25r3ng__yZHMGbcm8uGrcCO4rPomRx4Z8cAUu28Fm_xUCfKHpSj8kHnrkYafIS6jaKpASCgi_93tPRnCurgskNwx-KGXwRa9wFWj9UK5rKrGL-6GSRrTGxJ8QJfvC0c6_eXAx8ncHeGDHyVDixNXfc_s2O1nJn3VV5qz-nsmBeP7NYnHYgrLgnvZsvnDE3qQSvyANAjC0wjOue-ukzYsCOxsknyyZS4FBSxlxvTedFkWTGNhXiR1XwE2VGKAessLp0nRGlGlF57PIXmXHPdtwxkuMbPSNG2Fj2tsTJPU2IFDyAu5dJq0w8PzZDKqo_zz2aXQ&dblcnt=true&user_num_adults=2&hc=1&pdtax=139.88&pdf=0.00&pdt=1068.11&locale=en-us&ad-src=&numChild=0",
        "price": {
          "value": 1068,
          "currency": "EUR"
        },
        "cost": {
          "value": 1068,
          "currency": "EUR"
        },
        "price_with_tax": {
          "value": 1068,
          "currency": "EUR"
        },
        "cost_with_tax": {
          "value": 1068,
          "currency": "EUR"
        }
      },
      {
        "title": "Booking.com",
        "logo": "https://www.gstatic.com/travel-hotels/branding/icon_184.png",
        "link": "https://www.booking.com/searchresults.en.html?dest_id=599535&highlighted_hotels=599535&dest_type=hotel&checkin=2026-02-27&checkout=2026-02-28&group_adults=2&req_adults=2&show_room=59953503_336303630_2_0_0&lang=en&selected_currency=EUR&exrt=0.84770000&ext_price_total=1068.11&ext_price_tax=139.88&xfc=USD&hca=m&group_children=0&req_children=0&&no_rooms=1&ts=1772146193&edgtid=fdRhqzYPRM2f0oYH7k-AUA&efpc=EJWwChJgsBov&utm_source=metagha&utm_medium=localuniversal&utm_campaign=DE&utm_term=hotel-599535&utm_content=dev-desktop_los-1_bw-1_dow-Friday_defdate-0_room-0_gstadt-2_rateid-public_aud-0_gacid-_mcid-10_ppa-0_clrid-0_ad-0_gstkid-0_checkin-20260227_ppt-&aid=2127499&label=metagha-link-LUDE-hotel-599535_dev-desktop_los-1_bw-1_dow-Friday_defdate-0_room-0_gstadt-2_rateid-public_aud-0_gacid-_mcid-10_ppa-0_clrid-0_ad-0_gstkid-0_checkin-20260227_ppt-",
        "price": {
          "value": 1068,
          "currency": "EUR"
        },
        "cost": {
          "value": 1068,
          "currency": "EUR"
        },
        "price_with_tax": {
          "value": 1068,
          "currency": "EUR"
        },
        "cost_with_tax": {
          "value": 1068,
          "currency": "EUR"
        }
      },
      {
        "title": "Agoda",
        "logo": "https://www.gstatic.com/travel-hotels/branding/b13642de-d476-41bd-8254-3edc2e567aa6.png",
        "link": "https://www.agoda.com/partners/partnersearch.aspx?site_id=1917614&CkInDay=27&CkInMonth=02&CkInYear=2026&CkOutDay=28&campaignid=&CkOutMonth=02&CkOutYear=2026&SearchDateType=selected&NumberOfAdults=2&LT=1&NumberOfChildren=0&childages=&NumberOfRooms=1&gsite=localuniversal&los=1&PartnerCurrency=USD&hid=206039&RoomID=11135628&masterRoomId=8697863&PriceTax=139.88&PriceTotal=1068.11&RatePlan=11c82d85-6e23-a66f-2295-8189e6e0d078&UserCountry=DE&Currency=EUR&UserDevice=desktop&Verif=false&rr=row_desktop&audience_list=&mcid=3038&booking_source=cpc&adType=0&mpt=TE9pb2F1RGhrNWtaeFZrU2c1M1NzQ2gxZzR0NnZkTnB0VlQ5TVNlWGVzQ25tR0NpY1VFa1dwRzhoOGRJeWFPcGwvWEVvVlZ4dGZSQQ&original_rr=",
        "price": {
          "value": 1068,
          "currency": "EUR"
        },
        "cost": {
          "value": 1068,
          "currency": "EUR"
        },
        "price_with_tax": {
          "value": 1068,
          "currency": "EUR"
        },
        "cost_with_tax": {
          "value": 1068,
          "currency": "EUR"
        }
      },
      {
        "title": "Hotels.com",
        "logo": "https://www.gstatic.com/travel-hotels/branding/f358dd45-ebd1-4af8-988d-d53154b73975.png",
        "link": "https://de.hotels.com/Hotel-Search?selected=15438428&startDate=2026-02-27&endDate=2026-02-28&mdpcid=HCOM-DE.META.HPA.HOTEL-ORGANIC-desktop.HOTEL&MDPDTL=HTL.15438428.20260227.20260228.DDF.1.CID..AUDID.&adults=2&children=&mctc=10&mpf=1066.47&mpg=EUR&mpl=EUR&mpj=139.66&mpr=0.00&rffrid=sem.hcom.DE.156.024.localuniversal.02.desktop-1.kwrd=GGMETA.15438428DEen-20260227-N-ABW=1-camp=-aud=-N&rateplanid=208165426&mpm=24&mpn=201555590&mpo=EC&mpp=1&rateplanid=208165426&mpm=24&mpn=201555590&mpo=EC&mpp=1",
        "price": {
          "value": 1066,
          "currency": "EUR"
        },
        "cost": {
          "value": 1066,
          "currency": "EUR"
        },
        "price_with_tax": {
          "value": 1066,
          "currency": "EUR"
        },
        "cost_with_tax": {
          "value": 1066,
          "currency": "EUR"
        }
      },
      {
        "title": "HolidayCheck.de",
        "logo": "https://www.gstatic.com/travel-hotels/branding/def67e1e-fba6-4e51-96c0-40a281bca824.png",
        "link": "https://www.holidaycheck.de/ho/angebote-/7767066c-094e-47fe-afc1-439d930a6a84/hotelonly?_offer=adults:2,departureDate:2026-02-27,duration:1,returnDate:2026-02-28,tourOperator:~eec21a06-f64e-3130-9dba-d57216c6e98e,travelkind:hotelonly&utm_source=google_hotel_ads&utm_medium=metasearch&utm_campaign=gha_&utm_content=-&utm_term=uuid_7767066c-094e-47fe-afc1-439d930a6a84_en_DE&trv_dp=1066.00",
        "price": {
          "value": 1066,
          "currency": "EUR"
        },
        "cost": {
          "value": 1066,
          "currency": "EUR"
        },
        "price_with_tax": {
          "value": 1066,
          "currency": "EUR"
        },
        "cost_with_tax": {
          "value": 1066,
          "currency": "EUR"
        }
      },
      {
        "title": "Bookhotel.direct",
        "logo": "https://www.gstatic.com/travel-hotels/branding/15717022029370921658.png",
        "link": "https://always.bookhotel.direct/119578/?checkin=2026-02-27&checkout=2026-02-28&nb_adult=2&nb_child=0&campaign=localuniversal&tracker_id=&device=desktop&currency_code=EUR",
        "price": {
          "value": 1068,
          "currency": "EUR"
        },
        "cost": {
          "value": 1068,
          "currency": "EUR"
        },
        "price_with_tax": {
          "value": 1068,
          "currency": "EUR"
        },
        "cost_with_tax": {
          "value": 1068,
          "currency": "EUR"
        }
      },
      {
        "title": "Hotwire.com",
        "logo": "https://www.gstatic.com/travel-hotels/branding/icon_112.png",
        "link": "http://www.hotwire.com/hotel/details/direct-retail-details?startDate=02/27/2026&endDate=02/28/2026&selectedExpediaHotelId=15438428&numAdults=2&numChildren=0&sid=S537&bid=B381549&rpid=RPE15438428&mctc=10",
        "price": {
          "value": 1066,
          "currency": "EUR"
        },
        "cost": {
          "value": 1066,
          "currency": "EUR"
        },
        "price_with_tax": {
          "value": 1066,
          "currency": "EUR"
        },
        "cost_with_tax": {
          "value": 1066,
          "currency": "EUR"
        }
      },
      {
        "title": "My Luxury Hotel",
        "logo": "https://www.gstatic.com/travel-hotels/branding/11153979922261788882.png",
        "link": "https://www.myluxuryhotel.com/hotel/1137278/?ppc=true&isHotel=true&checkin=2026-02-27&checkout=2026-02-28&nights=1&rooms=%5B%7B%22adults%22:2,%22children%22:%5B%5D,%22kidsAge%22:%5B%5D%7D%5D&utm_source=GoogleHC&utm_medium=paid&utm_campaign=&utm_content=localuniversal&utm_term=1137278&pv=1772146086550&sourceToken=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJzdWIiOiJib29raW5nX2NvbSIsImV4cCI6MTc3MjIzMjQ4NiwiaWF0IjoxNzcyMTQ2MDg2fQ.dhzFWTAvfp_DtzfgUmMtG8ice2_BZN0gYKpIYb4QzTU",
        "price": {
          "value": 1064,
          "currency": "EUR"
        },
        "cost": {
          "value": 1064,
          "currency": "EUR"
        },
        "price_with_tax": {
          "value": 1064,
          "currency": "EUR"
        },
        "cost_with_tax": {
          "value": 1064,
          "currency": "EUR"
        }
      },
      {
        "title": "LateRooms.com",
        "logo": "https://www.gstatic.com/travel-hotels/branding/10344278261224262221.png",
        "link": "https://www.laterooms.com/hotel/1137278/?ppc=true&isHotel=true&checkin=2026-02-27&checkout=2026-02-28&nights=1&rooms=%5B%7B%22adults%22:2,%22children%22:%5B%5D,%22kidsAge%22:%5B%5D%7D%5D&utm_source=GoogleHC&utm_medium=paid&utm_campaign=&utm_content=localuniversal&utm_term=1137278&pv=1772146675006&sourceToken=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJzdWIiOiJib29raW5nX2NvbSIsImV4cCI6MTc3MjIzMzA3NSwiaWF0IjoxNzcyMTQ2Njc1fQ.5tkEiOILQzpUsLdU3JOYYb9XbD8lzYIapq2unhu_S-Q",
        "price": {
          "value": 1064,
          "currency": "EUR"
        },
        "cost": {
          "value": 1064,
          "currency": "EUR"
        },
        "price_with_tax": {
          "value": 1064,
          "currency": "EUR"
        },
        "cost_with_tax": {
          "value": 1064,
          "currency": "EUR"
        }
      },
      {
        "title": "BusinessHotels.com",
        "logo": "https://www.gstatic.com/travel-hotels/branding/7e9b18f5-dcd9-46e2-8bed-33a004b33995.png",
        "link": "https://www.businesshotels.com/reservation.php?hotel-id=701383248&checkin-date=2026-02-27&checkout-date=2026-02-28&language=en&USER-CURRENCY=EUR&USER-COUNTRY=DE&NUM-ADULTS=2&NUM-CHILDREN=0&prid=",
        "price": {
          "value": 1068,
          "currency": "EUR"
        },
        "cost": {
          "value": 1068,
          "currency": "EUR"
        },
        "price_with_tax": {
          "value": 1068,
          "currency": "EUR"
        },
        "cost_with_tax": {
          "value": 1068,
          "currency": "EUR"
        }
      },
      {
        "title": "Bluepillow.de",
        "logo": "https://www.gstatic.com/travel-hotels/branding/c770e909-af04-45dd-8ad7-335bc5055826.png",
        "link": "https://www.bluepillow.de/search/594397817c00cb0e643c3237?begin=2026-02-27&end=2026-02-28&block_id=-b,8Uf4rkAjzDRsZGMlbZ2L3P6MncHRCisqAlmPM2fDVh-MWFeydaDGybaxsDOk5RRq,-bkng-Hotel&adults=2&childs=0&infants=0&childrens=0&country=DE&currency=EUR&language=en&source=localuniversal&utm_campaign=hotel&prid=",
        "price": {
          "value": 1068,
          "currency": "EUR"
        },
        "cost": {
          "value": 1068,
          "currency": "EUR"
        },
        "price_with_tax": {
          "value": 1068,
          "currency": "EUR"
        },
        "cost_with_tax": {
          "value": 1068,
          "currency": "EUR"
        }
      },
      {
        "title": "AsiaYo",
        "logo": "https://www.gstatic.com/travel-hotels/branding/42906b93-548c-4f41-b994-b55cb3ff88e8.png",
        "link": "https://asiayo.com/en-DE/v/80171/?check_in_date=2026-02-27&check_out_date=2026-02-28&adult=2&currency=TWD&aff_id=269&utm_source=google_hotelads&utm_medium=cpc&utm_campaign=&click_source=freelinks",
        "price": {
          "value": 1069,
          "currency": "EUR"
        },
        "cost": {
          "value": 1069,
          "currency": "EUR"
        },
        "price_with_tax": {
          "value": 1069,
          "currency": "EUR"
        },
        "cost_with_tax": {
          "value": 1069,
          "currency": "EUR"
        }
      },
      {
        "title": "Brek",
        "logo": "https://www.gstatic.com/travel-hotels/branding/5560284514445840289.png",
        "link": "https://www.brek.com/search?lat=40.713038&lng=-74.008777&checkin=2026-02-27&checkout=2026-02-28&pinned=6473b44aa1d24283bbe42fcf&utm_source=gha&ep=7f51dcbc8ed03f8df50a8a49eb0402650a92a1a8ba5dbe12a0f87c1c4f5501fd4419ca8e2e4156d66771f793703a654de6447d9afa684dd9aaf23720365ab52b&user_currency=EUR&user_country=DE&user_language=en&user_displayed_total=1068.11&user_displayed_tax=139.88",
        "price": {
          "value": 1068,
          "currency": "EUR"
        },
        "cost": {
          "value": 1068,
          "currency": "EUR"
        },
        "price_with_tax": {
          "value": 1068,
          "currency": "EUR"
        },
        "cost_with_tax": {
          "value": 1068,
          "currency": "EUR"
        }
      },
      {
        "title": "ZenHotels.com",
        "logo": "https://www.gstatic.com/travel-hotels/branding/4183134106872331441.png",
        "link": "https://www.zenhotels.com/go/rooms/8022177/?dates=27.02.2026-28.02.2026&cur=EUR&lang=en&utm_source=google_hotelads&utm_medium=cpc-metasearch&partner_slug=google&guests=2&from=four_seasons_new_york_downtown.1067.EUR.sr-019c9c2b-d68d-7c78-a6af-a6a06163fcdd&utm_campaign=en-DE&price=one&scroll=prices&partner_data=nZGSckkwDkOfgcLWqWv2vcv-UTDCi5daH71o5pjK7W-OzZMzCZLp3aLSboujat6T5cu61-6i62Ah2ooiUUoZpf65pHtjki-p9YAD_GjgK_nRtZ1HzDTdS08OoMnk7rlBgK9jjkI6KA4aB_pKCqXwzVI2vJ2Kp-nvQyoR1uUIWv7Ymeozew==&utm_content=GoogleCPC&utm_term=gacid_.bw_1.los_1.dow_Friday.dtype_selected.hid_8022177.rid_37368388.aud_.d_desktop.ad_0.ctype_hotel.promo_0.apireqtype_deals=disabled&showed_price=1067.00&showed_taxes=0.00&member_deals=true",
        "price": {
          "value": 1067,
          "currency": "EUR"
        },
        "cost": {
          "value": 1067,
          "currency": "EUR"
        },
        "price_with_tax": {
          "value": 1067,
          "currency": "EUR"
        },
        "cost_with_tax": {
          "value": 1067,
          "currency": "EUR"
        }
      },
      {
        "title": "Clicktrip.com",
        "logo": "https://www.gstatic.com/travel-hotels/branding/3461ae67-c427-4ecf-a48f-524b530be084.png",
        "link": "https://clicktrip.com/hotels/details/eKzWHKZDZDDlDDnIV9pF8qNnAbhMcxfrOmM00LuP-WZM-OlC0YiY6C3Plhnh2GOzrDGz7YA8Ka7_uXd3G7xRkW1AOKukELWkE81NmUW9dkVer-LVrgdZ43GtxvmQKGMW5svx0yisY_dCqx09i4Xz7g2?locale=en&currency=EUR&pos=DE&date_type=selected&taf=4VuIiZxdMhc_k7eO7eQG044Ux2a0jvNQY-a16ZfgBOwo9Q-yTXiyQYIDPE2yG5xO0&verification=false&clk_src=",
        "price": {
          "value": 1066,
          "currency": "EUR"
        },
        "cost": {
          "value": 1066,
          "currency": "EUR"
        },
        "price_with_tax": {
          "value": 1066,
          "currency": "EUR"
        },
        "cost_with_tax": {
          "value": 1066,
          "currency": "EUR"
        }
      },
      {
        "title": "Opodo",
        "logo": "https://www.gstatic.com/travel-hotels/branding/05208793-cd83-4e8b-b76c-7ff346e093e3.png",
        "link": "https://accommodation.opodo.de/Hotel-Search?selected=15438428&startDate=2026-02-27&endDate=2026-02-28&adults=2&children=&mpf=1066.47&cur=EUR&mpj=139.66&wapb3=|c.506940|l.de_DE|t.meta|s.ghs&MDPCID=Opodo-DE.DPS.Opodo.MetaSearch-GHA.HOTEL&mpl=EUR&numberOfRooms=1&locale=de_DE&rffrid=h4p.hcom.DE.ghaodigeo.000.000.kwrd=&pos=OPODO_DE&rateplanid=208165427&mctc=10&utm_medium=metasearch&utm_campaign=495029696&utm_term=hotel&utm_source=FREEBOOKING",
        "price": {
          "value": 1066,
          "currency": "EUR"
        },
        "cost": {
          "value": 1066,
          "currency": "EUR"
        },
        "price_with_tax": {
          "value": 1066,
          "currency": "EUR"
        },
        "cost_with_tax": {
          "value": 1066,
          "currency": "EUR"
        }
      },
      {
        "title": "Hotelscombined.de",
        "logo": "https://www.gstatic.com/travel-hotels/branding/b73f8d82-aa66-4ac5-861d-52bce84c9ae5.png",
        "link": "https://www.hotelscombined.de/semi/ha/hotel_ads/2600131/en.html?utm_source=google&utm_medium=cpc&utm_term=2600131&adType=0&utm_content=localuniversal&utm_campaign=HotelAds&ci=2026-02-27&co=2026-02-28&gs=localuniversal&l=1&pc=USD&rid=&pdtax=139.88&pdtotal=1068.11&rpid=&uc=DE&ucuc=EUR&d=desktop&lc=en&v=false&rrid=&k_pc=~QUdPREFIUEE&k_rt=&k_sid=xfAER-M11F&k_kct=1772137603&k_gct=1772138413&g=2&r=1&ac=2&k_cc=de&dt=selected&cmpid=&cmptrack=",
        "price": {
          "value": 1068,
          "currency": "EUR"
        },
        "cost": {
          "value": 1068,
          "currency": "EUR"
        },
        "price_with_tax": {
          "value": 1068,
          "currency": "EUR"
        },
        "cost_with_tax": {
          "value": 1068,
          "currency": "EUR"
        }
      },
      {
        "title": "momondo.de",
        "logo": "https://www.gstatic.com/travel-hotels/branding/icon_970163321.png",
        "link": "https://www.momondo.de/semi/ha/hotel_ads/2600131/de.html?utm_source=google&utm_medium=cpc&utm_term=2600131&adType=0&utm_content=localuniversal&utm_campaign=HotelAds&ci=2026-02-27&co=2026-02-28&gs=localuniversal&l=1&pc=USD&rid=&pdtax=139.88&pdtotal=1068.11&rpid=&uc=DE&ucuc=EUR&d=desktop&lc=en&v=false&rrid=&k_pc=~QUdPREFIUEE&k_rt=&k_sid=xfCEA4qdZ8&k_kct=1772137603&k_gct=1772138449&g=2&r=1&ac=2&k_cc=de&dt=selected&cmpid=&cmptrack=",
        "price": {
          "value": 1068,
          "currency": "EUR"
        },
        "cost": {
          "value": 1068,
          "currency": "EUR"
        },
        "price_with_tax": {
          "value": 1068,
          "currency": "EUR"
        },
        "cost_with_tax": {
          "value": 1068,
          "currency": "EUR"
        }
      },
      {
        "title": "müv AI",
        "logo": "https://www.gstatic.com/travel-hotels/branding/2710211444546704077.png",
        "link": "https://muvtravel.com/xp-hotel?hotelID=116119126&checkinDay=27&checkinMonth=02&checkinYear=2026&nights=1&num-guests=2&checkoutDay=28&checkoutMonth=02&checkoutYear=2026&PROMO-CODE=98010",
        "price": {
          "value": 1068,
          "currency": "EUR"
        },
        "cost": {
          "value": 1068,
          "currency": "EUR"
        },
        "price_with_tax": {
          "value": 1068,
          "currency": "EUR"
        },
        "cost_with_tax": {
          "value": 1068,
          "currency": "EUR"
        }
      },
      {
        "title": "Closest Hotel",
        "logo": "https://www.gstatic.com/travel-hotels/branding/15292798194442829381.png",
        "link": "https://closesthotel.com/googleRedirMainSearch.php?checkInYear=2026&checkInMonth=02&checkInDay=27&checkOutYear=2026&checkOutMonth=02&checkOutDay=28&numberOfNights=1&numberOfAdults=2&numberOfChildren=0&numberOfGuests=2&hotelID=15438428&roomID=201555590&currency=EUR&deviceType=desktop",
        "price": {
          "value": 1068,
          "currency": "EUR"
        },
        "cost": {
          "value": 1068,
          "currency": "EUR"
        },
        "price_with_tax": {
          "value": 1068,
          "currency": "EUR"
        },
        "cost_with_tax": {
          "value": 1068,
          "currency": "EUR"
        }
      },
      {
        "title": "Traveloka.com",
        "logo": "https://www.gstatic.com/travel-hotels/branding/cc46874d-c374-4a99-83c7-b6f79d0b19d3.png",
        "link": "https://www.traveloka.com/en-en/hotel/search?spec=27-02-2026.28-02-2026.1.1.HOTEL_GEO.4005128638.New%20York%20State.2&hotelId=1000000601517&contexts=%7B%22accessCode%22:%2290975GHAD1305desktop%22%2C%22metasearchRequestId%22%3A%22cb5f2e56-846c-4e98-ada0-3a1b1aa861ff%22%2C%22plc%22%3A%22Uz%2F51aey53IgPjFiTs8zCqt%2FEzVSVv3B37GI8CihLxgZQ4P2RnJ4vXuEz6mydh0QWSafPGCMr%2FG%2FGO8e%2BT5i%2Fg%3D%3D%22%7D&metasearchId=GoogleHotelAdsUser&metasearchRateId=desktop&metasearchRatekey=sgyUU2M0LrnnpXh1LPwoI&priceDisplay=TOTAL&metasearchRefid=12345678910abcdefghijk@-&adType=0&PPA=0&hotelCampaign=1&cur=EUR",
        "price": {
          "value": 1071,
          "currency": "EUR"
        },
        "cost": {
          "value": 1071,
          "currency": "EUR"
        },
        "price_with_tax": {
          "value": 1071,
          "currency": "EUR"
        },
        "cost_with_tax": {
          "value": 1071,
          "currency": "EUR"
        }
      }
    ],
    "reviews": {
      "rating": 4.7,
      "reviews_cnt": 1280,
      "reviews_by_stars": {
        "5 star": "1%"
      }
    }
  }
  ```
</ResponseExample>


# Dates
Source: https://docs.brightdata.com/api-reference/serp/google-hotels/dates

Reference for the Bright Data Google Hotels Dates parameter. Refines queries and returns matching results as JSON or HTML. On port 44445.

```txt wrap theme={null}
https://www.google.com/travel/hotels?q=four+seasons+hotel+new+york+downtown&brd_dates=2026-04-03%2C2026-04-10
```

## Parameters

<ParamField type="string">
  The search query parameter. Specifies the keyword or phrase you want to search for on Google.
</ParamField>

<ParamField type="string">
  Check-in date and check-out date, separated by comma.

  > **Format**: `YYYY-MM-DD,YYYY-MM-DD`\
  > **Example**: `2026-04-03,2026-04-10`

  ```txt wrap theme={null}
  https://www.google.com/travel/hotels?q=four+seasons+hotel+new+york+downtown&brd_dates=2026-04-03%2C2026-04-10
  ```
</ParamField>

<RequestExample>
  ```shell cURL highlight={6} theme={null}
    curl -X POST https://api.brightdata.com/request \
    --header "Content-Type: application/json" \
    --header "Authorization: Bearer API_KEY" \
    --data '{
      "zone": "serp_api1",
      "url": "https://www.google.com/travel/hotels?q=four+seasons+hotel+new+york+downtown&brd_dates=2026-04-03%2C2026-04-10",
      "format": "raw"
    }'
  ```

  ```shell Native proxy highlight={4} theme={null}
  curl --proxy brd.superproxy.io:44445 \
    --proxy-user CUSTOMER_USERNAME:CUSTOMER_PASSWORD \
    --ssl-no-revoke \
    "https://www.google.com/travel/hotels?q=four+seasons+hotel+new+york+downtown&brd_dates=2026-04-03%2C2026-04-10"
  ```

  ```js Node.js highlight={10} theme={null}
  (async () => {
    const response = await fetch('https://api.brightdata.com/request', {
      method: 'POST',
      headers: {
        'Content-Type': 'application/json',
        'Authorization': 'Bearer API_KEY'
      },
      body: JSON.stringify({
        zone: 'serp_api1',
        url: 'https://www.google.com/travel/hotels?q=four+seasons+hotel+new+york+downtown&brd_dates=2026-04-03%2C2026-04-10',
        format: 'raw'
      })
    });
    
    const data = await response.text();
    console.log(data);
  })();
  ```

  ```python Python highlight={11} theme={null}
  import requests

  # API Configuration
  headers = {
      'Content-Type': 'application/json',
      'Authorization': 'Bearer API_KEY',
  }

  payload = {
      'zone': 'serp_api1',
      'url': 'https://www.google.com/travel/hotels?q=four+seasons+hotel+new+york+downtown&brd_dates=2026-04-03%2C2026-04-10',
      'format': 'raw'
  }

  # Make the request
  response = requests.post(
      'https://api.brightdata.com/request', 
      json=payload, 
      headers=headers
  )

  print(response.text)
  ```
</RequestExample>

<ResponseExample>
  ```json 200 highlight={6, 7} theme={null}
  {
    "overview": {
      "type": "hotels",
      "title": "Four Seasons Hotel New York Downtown",
      "requested": {
        "start_date": "2026-04-03",
        "end_date": "2026-04-10",
        "occupancy": 2,
        "number_of_adults": 2
      },
      "available": true,
      "currency": "USD",
      "coordinates": {
        "latitude": 40.712633,
        "longitude": -74.0092141
      },
      "address": "27 Barclay St, New York, NY 10007",
      "phone": "(646) 880-1999",
      "fid": "0x89c25a18e3553f8b:0x1337dae5edaabaa2"
    },
    "prices": [
      {
        "title": "trivago.com",
        "logo": "https://www.gstatic.com/travel-hotels/branding/1922649917165881388.png",
        "link": "https://www.google.com/aclk?sa=l&ai=DChsSEwjCoPbrn_iSAxVGUn8AHdd8DsoYACICCAEQYhoCb2E&co=1&ase=2&gclid=EAIaIQobChMIwqD265_4kgMVRlJ_AB3XfA7KEAoYASABEgKs-_D_BwE&cid=CAASuwHkaOl2NLS5wDy6GKMRdyxNZjSVEWrmSsf6RKRBnUgVhiZOlox1MbkBncfXuNV2KEaH7m6BCeu7UtSPKhdBVddQpQLWDK60Lm_9zP48inYjhuoy8cCjJRO0fIwJZvWIIwnTsJ5b7XsSgxO1mgLBH1XvNaB5VuZZa-54QO3_3b1xl8jw76lYwiPs0-tRaCQoyvY36jEZOV2oU43o72VaW1uLuKFnrNu4xj1-08RFzgDhK_G9-OqBlzR54CHk&category=acrcp_v1_48&sig=AOD64_3jDDsBoF49LIv8h7JRGXfK4c5Uww&adurl=",
        "price": {
          "value": 1124,
          "currency": "USD"
        },
        "cost": {
          "value": 1293,
          "currency": "USD"
        },
        "price_with_tax": {
          "value": 9050,
          "currency": "USD"
        }
      },
      {
        "title": "Expedia.com",
        "logo": "https://www.gstatic.com/travel-hotels/branding/ac238c97-1652-4830-8da8-bb8d8883af88.png",
        "link": "https://www.google.com/aclk?sa=l&ai=DChsSEwjCoPbrn_iSAxVGUn8AHdd8DsoYACICCAEQJxoCb2E&co=1&ase=2&gclid=EAIaIQobChMIwqD265_4kgMVRlJ_AB3XfA7KEAoYAiABEgLxsfD_BwE&cid=CAASuwHkaOl2NLS5wDy6GKMRdyxNZjSVEWrmSsf6RKRBnUgVhiZOlox1MbkBncfXuNV2KEaH7m6BCeu7UtSPKhdBVddQpQLWDK60Lm_9zP48inYjhuoy8cCjJRO0fIwJZvWIIwnTsJ5b7XsSgxO1mgLBH1XvNaB5VuZZa-54QO3_3b1xl8jw76lYwiPs0-tRaCQoyvY36jEZOV2oU43o72VaW1uLuKFnrNu4xj1-08RFzgDhK_G9-OqBlzR54CHk&category=acrcp_v1_48&sig=AOD64_2RzSq4ZRGsbtHfccg0CuwNIFISNA&adurl=",
        "price": {
          "value": 1124,
          "currency": "USD"
        },
        "cost": {
          "value": 1293,
          "currency": "USD"
        },
        "price_with_tax": {
          "value": 9050,
          "currency": "USD"
        },
        "rooms": [
          {
            "title": "Manhattan Room with king bed",
            "pictures": [
              "https://lh3.googleusercontent.com/hrppk/ANjXD_zirGqnNUV3bUkVZ6Yq4QzaxzMTFw8S7BL88YG2xqf5qarRKkr50s-PfillUJkRvSl7KQqXwV9-bVLeYtBRigMpPPejfmFNDLX3qXcjydhC3sIHQL6X9_KcnnQtD_1b8kFPT_gkxt3Bjoif3Alols11Pq0yWqW6dkvZ"
            ],
            "link": "https://www.google.com/aclk?sa=l&ai=DChsSEwjCoPbrn_iSAxVGUn8AHdd8DsoYACICCAEQKBoCb2E&co=1&ase=2&gclid=EAIaIQobChMIwqD265_4kgMVRlJ_AB3XfA7KEAoYAiACEgIOq_D_BwE&cid=CAASuwHkaOl2NLS5wDy6GKMRdyxNZjSVEWrmSsf6RKRBnUgVhiZOlox1MbkBncfXuNV2KEaH7m6BCeu7UtSPKhdBVddQpQLWDK60Lm_9zP48inYjhuoy8cCjJRO0fIwJZvWIIwnTsJ5b7XsSgxO1mgLBH1XvNaB5VuZZa-54QO3_3b1xl8jw76lYwiPs0-tRaCQoyvY36jEZOV2oU43o72VaW1uLuKFnrNu4xj1-08RFzgDhK_G9-OqBlzR54CHk&category=acrcp_v1_48&sig=AOD64_2rCy4EYmKS2PUI9JAQ9iBIiHXP_Q&adurl=",
            "extensions": [
              "1 king bed"
            ],
            "price": {
              "value": 1124,
              "currency": "USD"
            },
            "cost": {
              "value": 1293,
              "currency": "USD"
            },
            "price_with_tax": {
              "value": 9050,
              "currency": "USD"
            }
          },
          {
            "title": "Manhattan Room with king bed",
            "pictures": [
              "https://lh3.googleusercontent.com/hrppk/ANjXD_zirGqnNUV3bUkVZ6Yq4QzaxzMTFw8S7BL88YG2xqf5qarRKkr50s-PfillUJkRvSl7KQqXwV9-bVLeYtBRigMpPPejfmFNDLX3qXcjydhC3sIHQL6X9_KcnnQtD_1b8kFPT_gkxt3Bjoif3Alols11Pq0yWqW6dkvZ"
            ],
            "link": "https://www.google.com/aclk?sa=l&ai=DChsSEwjCoPbrn_iSAxVGUn8AHdd8DsoYACICCAEQKRoCb2E&co=1&ase=2&gclid=EAIaIQobChMIwqD265_4kgMVRlJ_AB3XfA7KEAoYAiADEgLQIvD_BwE&cid=CAASuwHkaOl2NLS5wDy6GKMRdyxNZjSVEWrmSsf6RKRBnUgVhiZOlox1MbkBncfXuNV2KEaH7m6BCeu7UtSPKhdBVddQpQLWDK60Lm_9zP48inYjhuoy8cCjJRO0fIwJZvWIIwnTsJ5b7XsSgxO1mgLBH1XvNaB5VuZZa-54QO3_3b1xl8jw76lYwiPs0-tRaCQoyvY36jEZOV2oU43o72VaW1uLuKFnrNu4xj1-08RFzgDhK_G9-OqBlzR54CHk&category=acrcp_v1_48&sig=AOD64_386Mob3v3Ipa3e9j021h28EfMVYQ&adurl=",
            "extensions": [
              "1 king bed Free cancellation until Apr 1"
            ],
            "price": {
              "value": 1249,
              "currency": "USD"
            },
            "cost": {
              "value": 1437,
              "currency": "USD"
            },
            "price_with_tax": {
              "value": 10059,
              "currency": "USD"
            }
          },
          {
            "title": "Accessible Manhattan Room with King Bed",
            "pictures": [
              "https://lh3.googleusercontent.com/hrppk/ANjXD_zirGqnNUV3bUkVZ6Yq4QzaxzMTFw8S7BL88YG2xqf5qarRKkr50s-PfillUJkRvSl7KQqXwV9-bVLeYtBRigMpPPejfmFNDLX3qXcjydhC3sIHQL6X9_KcnnQtD_1b8kFPT_gkxt3Bjoif3Alols11Pq0yWqW6dkvZ"
            ],
            "link": "https://www.google.com/aclk?sa=l&ai=DChsSEwjCoPbrn_iSAxVGUn8AHdd8DsoYACICCAEQKhoCb2E&co=1&ase=2&gclid=EAIaIQobChMIwqD265_4kgMVRlJ_AB3XfA7KEAoYAiAEEgJnmvD_BwE&cid=CAASuwHkaOl2NLS5wDy6GKMRdyxNZjSVEWrmSsf6RKRBnUgVhiZOlox1MbkBncfXuNV2KEaH7m6BCeu7UtSPKhdBVddQpQLWDK60Lm_9zP48inYjhuoy8cCjJRO0fIwJZvWIIwnTsJ5b7XsSgxO1mgLBH1XvNaB5VuZZa-54QO3_3b1xl8jw76lYwiPs0-tRaCQoyvY36jEZOV2oU43o72VaW1uLuKFnrNu4xj1-08RFzgDhK_G9-OqBlzR54CHk&category=acrcp_v1_48&sig=AOD64_0X-AFfOUFcldJAaKV13FPIALqrPQ&adurl=",
            "extensions": [
              "1 king bed"
            ],
            "price": {
              "value": 1125,
              "currency": "USD"
            },
            "cost": {
              "value": 1294,
              "currency": "USD"
            },
            "price_with_tax": {
              "value": 9061,
              "currency": "USD"
            }
          },
          {
            "title": "Accessible Manhattan Room with King Bed",
            "pictures": [
              "https://lh3.googleusercontent.com/hrppk/ANjXD_zirGqnNUV3bUkVZ6Yq4QzaxzMTFw8S7BL88YG2xqf5qarRKkr50s-PfillUJkRvSl7KQqXwV9-bVLeYtBRigMpPPejfmFNDLX3qXcjydhC3sIHQL6X9_KcnnQtD_1b8kFPT_gkxt3Bjoif3Alols11Pq0yWqW6dkvZ"
            ],
            "link": "https://www.google.com/aclk?sa=l&ai=DChsSEwjCoPbrn_iSAxVGUn8AHdd8DsoYACICCAEQKxoCb2E&co=1&ase=2&gclid=EAIaIQobChMIwqD265_4kgMVRlJ_AB3XfA7KEAoYAiAFEgKdmvD_BwE&cid=CAASuwHkaOl2NLS5wDy6GKMRdyxNZjSVEWrmSsf6RKRBnUgVhiZOlox1MbkBncfXuNV2KEaH7m6BCeu7UtSPKhdBVddQpQLWDK60Lm_9zP48inYjhuoy8cCjJRO0fIwJZvWIIwnTsJ5b7XsSgxO1mgLBH1XvNaB5VuZZa-54QO3_3b1xl8jw76lYwiPs0-tRaCQoyvY36jEZOV2oU43o72VaW1uLuKFnrNu4xj1-08RFzgDhK_G9-OqBlzR54CHk&category=acrcp_v1_48&sig=AOD64_2wpGSEisyf_IWUsUFISzSTkwBUzA&adurl=",
            "extensions": [
              "1 king bed Free cancellation until Apr 1"
            ],
            "price": {
              "value": 1248,
              "currency": "USD"
            },
            "cost": {
              "value": 1435,
              "currency": "USD"
            },
            "price_with_tax": {
              "value": 10048,
              "currency": "USD"
            }
          },
          {
            "title": "Manhattan Room with Double Beds",
            "pictures": [
              "https://lh3.googleusercontent.com/hrppk/ANjXD_yeBfSgeyblSeisek8ZI4YEHLCIbbXrCJxgyCdZUamkH5oV5DdlJoKUakDV53Z7p-BDS0E8rJ62m6QZMrFqObi9meM30tA-IA6SocR49mzpLbxLgLGE-3-aodZ0vOxTfpmcX440cUjJEe1Ngv3iSw2LSIyNpQLwWUtZ"
            ],
            "link": "https://www.google.com/aclk?sa=l&ai=DChsSEwjCoPbrn_iSAxVGUn8AHdd8DsoYACICCAEQLBoCb2E&co=1&ase=2&gclid=EAIaIQobChMIwqD265_4kgMVRlJ_AB3XfA7KEAoYAiAGEgKYYfD_BwE&cid=CAASuwHkaOl2NLS5wDy6GKMRdyxNZjSVEWrmSsf6RKRBnUgVhiZOlox1MbkBncfXuNV2KEaH7m6BCeu7UtSPKhdBVddQpQLWDK60Lm_9zP48inYjhuoy8cCjJRO0fIwJZvWIIwnTsJ5b7XsSgxO1mgLBH1XvNaB5VuZZa-54QO3_3b1xl8jw76lYwiPs0-tRaCQoyvY36jEZOV2oU43o72VaW1uLuKFnrNu4xj1-08RFzgDhK_G9-OqBlzR54CHk&category=acrcp_v1_48&sig=AOD64_0wS0Svfjeq-MnN6F99D_VI7aOw7A&adurl=",
            "extensions": [
              "2 double beds"
            ],
            "price": {
              "value": 1146,
              "currency": "USD"
            },
            "cost": {
              "value": 1318,
              "currency": "USD"
            },
            "price_with_tax": {
              "value": 9227,
              "currency": "USD"
            }
          },
          {
            "title": "Manhattan Room with Double Beds",
            "pictures": [
              "https://lh3.googleusercontent.com/hrppk/ANjXD_yeBfSgeyblSeisek8ZI4YEHLCIbbXrCJxgyCdZUamkH5oV5DdlJoKUakDV53Z7p-BDS0E8rJ62m6QZMrFqObi9meM30tA-IA6SocR49mzpLbxLgLGE-3-aodZ0vOxTfpmcX440cUjJEe1Ngv3iSw2LSIyNpQLwWUtZ"
            ],
            "link": "https://www.google.com/aclk?sa=l&ai=DChsSEwjCoPbrn_iSAxVGUn8AHdd8DsoYACICCAEQLRoCb2E&co=1&ase=2&gclid=EAIaIQobChMIwqD265_4kgMVRlJ_AB3XfA7KEAoYAiAHEgKkBvD_BwE&cid=CAASuwHkaOl2NLS5wDy6GKMRdyxNZjSVEWrmSsf6RKRBnUgVhiZOlox1MbkBncfXuNV2KEaH7m6BCeu7UtSPKhdBVddQpQLWDK60Lm_9zP48inYjhuoy8cCjJRO0fIwJZvWIIwnTsJ5b7XsSgxO1mgLBH1XvNaB5VuZZa-54QO3_3b1xl8jw76lYwiPs0-tRaCQoyvY36jEZOV2oU43o72VaW1uLuKFnrNu4xj1-08RFzgDhK_G9-OqBlzR54CHk&category=acrcp_v1_48&sig=AOD64_1oppsT2mirszsp7yZIW9tl8SuNMA&adurl=",
            "extensions": [
              "2 double beds Free cancellation until Apr 1"
            ],
            "price": {
              "value": 1274,
              "currency": "USD"
            },
            "cost": {
              "value": 1466,
              "currency": "USD"
            },
            "price_with_tax": {
              "value": 10260,
              "currency": "USD"
            }
          },
          {
            "title": "Accessible SoHo Premier King",
            "pictures": [
              "https://lh3.googleusercontent.com/hrppk/ANjXD_xfIleTKUi_ePsxGkSstGASzo99qNFBpB94rAAtcEI1C-ZLD4XATuPdh4hGG4RUio3DvonDRyOo7dGZScl55LMBJ7ZEgdijCjGdglXAmtBG3qRZGZdrm-Uggx1OjUAheXtRIDPT0atuWFPccAbkfddjQ7vp6ud3UM4"
            ],
            "link": "https://www.google.com/aclk?sa=l&ai=DChsSEwjCoPbrn_iSAxVGUn8AHdd8DsoYACICCAEQLhoCb2E&co=1&ase=2&gclid=EAIaIQobChMIwqD265_4kgMVRlJ_AB3XfA7KEAoYAiAIEgKijfD_BwE&cid=CAASuwHkaOl2NLS5wDy6GKMRdyxNZjSVEWrmSsf6RKRBnUgVhiZOlox1MbkBncfXuNV2KEaH7m6BCeu7UtSPKhdBVddQpQLWDK60Lm_9zP48inYjhuoy8cCjJRO0fIwJZvWIIwnTsJ5b7XsSgxO1mgLBH1XvNaB5VuZZa-54QO3_3b1xl8jw76lYwiPs0-tRaCQoyvY36jEZOV2oU43o72VaW1uLuKFnrNu4xj1-08RFzgDhK_G9-OqBlzR54CHk&category=acrcp_v1_48&sig=AOD64_37Lkq_ienAtTYTVCGEIS4cPfurNQ&adurl=",
            "extensions": [
              "1 king bed"
            ],
            "price": {
              "value": 1187,
              "currency": "USD"
            },
            "cost": {
              "value": 1366,
              "currency": "USD"
            },
            "price_with_tax": {
              "value": 9560,
              "currency": "USD"
            }
          },
          {
            "title": "Accessible SoHo Premier King",
            "pictures": [
              "https://lh3.googleusercontent.com/hrppk/ANjXD_xfIleTKUi_ePsxGkSstGASzo99qNFBpB94rAAtcEI1C-ZLD4XATuPdh4hGG4RUio3DvonDRyOo7dGZScl55LMBJ7ZEgdijCjGdglXAmtBG3qRZGZdrm-Uggx1OjUAheXtRIDPT0atuWFPccAbkfddjQ7vp6ud3UM4"
            ],
            "link": "https://www.google.com/aclk?sa=l&ai=DChsSEwjCoPbrn_iSAxVGUn8AHdd8DsoYACICCAEQLxoCb2E&co=1&ase=2&gclid=EAIaIQobChMIwqD265_4kgMVRlJ_AB3XfA7KEAoYAiAJEgISofD_BwE&cid=CAASuwHkaOl2NLS5wDy6GKMRdyxNZjSVEWrmSsf6RKRBnUgVhiZOlox1MbkBncfXuNV2KEaH7m6BCeu7UtSPKhdBVddQpQLWDK60Lm_9zP48inYjhuoy8cCjJRO0fIwJZvWIIwnTsJ5b7XsSgxO1mgLBH1XvNaB5VuZZa-54QO3_3b1xl8jw76lYwiPs0-tRaCQoyvY36jEZOV2oU43o72VaW1uLuKFnrNu4xj1-08RFzgDhK_G9-OqBlzR54CHk&category=acrcp_v1_48&sig=AOD64_1RlcWyNv6LCkw-i5pbb4Ojmfu9cg&adurl=",
            "extensions": [
              "1 king bed Free cancellation until Apr 1"
            ],
            "price": {
              "value": 1348,
              "currency": "USD"
            },
            "cost": {
              "value": 1550,
              "currency": "USD"
            },
            "price_with_tax": {
              "value": 10851,
              "currency": "USD"
            }
          },
          {
            "title": "SoHo Premier King",
            "pictures": [
              "https://lh3.googleusercontent.com/hrppk/ANjXD_x6Z4f55TyGgXgPaK-luUCFyHuULMAS-fnt2cgI_EjYzlVobLpV_HI_PaCiSXVq4GJt7GYYLs7gCr3Wj__EOYfq-W6hB87lXPWt24y5G_yEfds77WaqbxUytFauHjPoQYygsMPkPfJ2uhm751bN0EKKLGimw0u0n8_t"
            ],
            "link": "https://www.google.com/aclk?sa=l&ai=DChsSEwjCoPbrn_iSAxVGUn8AHdd8DsoYACICCAEQMBoCb2E&co=1&ase=2&gclid=EAIaIQobChMIwqD265_4kgMVRlJ_AB3XfA7KEAoYAiAKEgIXxfD_BwE&cid=CAASuwHkaOl2NLS5wDy6GKMRdyxNZjSVEWrmSsf6RKRBnUgVhiZOlox1MbkBncfXuNV2KEaH7m6BCeu7UtSPKhdBVddQpQLWDK60Lm_9zP48inYjhuoy8cCjJRO0fIwJZvWIIwnTsJ5b7XsSgxO1mgLBH1XvNaB5VuZZa-54QO3_3b1xl8jw76lYwiPs0-tRaCQoyvY36jEZOV2oU43o72VaW1uLuKFnrNu4xj1-08RFzgDhK_G9-OqBlzR54CHk&category=acrcp_v1_48&sig=AOD64_3VADlw1bl5GUpQsLgFAPQ2lA_njQ&adurl=",
            "extensions": [
              "1 king bed"
            ],
            "price": {
              "value": 1187,
              "currency": "USD"
            },
            "cost": {
              "value": 1366,
              "currency": "USD"
            },
            "price_with_tax": {
              "value": 9560,
              "currency": "USD"
            }
          },
          {
            "title": "SoHo Premier King",
            "pictures": [
              "https://lh3.googleusercontent.com/hrppk/ANjXD_x6Z4f55TyGgXgPaK-luUCFyHuULMAS-fnt2cgI_EjYzlVobLpV_HI_PaCiSXVq4GJt7GYYLs7gCr3Wj__EOYfq-W6hB87lXPWt24y5G_yEfds77WaqbxUytFauHjPoQYygsMPkPfJ2uhm751bN0EKKLGimw0u0n8_t"
            ],
            "link": "https://www.google.com/aclk?sa=l&ai=DChsSEwjCoPbrn_iSAxVGUn8AHdd8DsoYACICCAEQMRoCb2E&co=1&ase=2&gclid=EAIaIQobChMIwqD265_4kgMVRlJ_AB3XfA7KEAoYAiALEgLmDvD_BwE&cid=CAASuwHkaOl2NLS5wDy6GKMRdyxNZjSVEWrmSsf6RKRBnUgVhiZOlox1MbkBncfXuNV2KEaH7m6BCeu7UtSPKhdBVddQpQLWDK60Lm_9zP48inYjhuoy8cCjJRO0fIwJZvWIIwnTsJ5b7XsSgxO1mgLBH1XvNaB5VuZZa-54QO3_3b1xl8jw76lYwiPs0-tRaCQoyvY36jEZOV2oU43o72VaW1uLuKFnrNu4xj1-08RFzgDhK_G9-OqBlzR54CHk&category=acrcp_v1_48&sig=AOD64_3PVRjIxlUJRDk-AxBe6ZxGBGA-Uw&adurl=",
            "extensions": [
              "1 king bed Free cancellation until Apr 1"
            ],
            "price": {
              "value": 1349,
              "currency": "USD"
            },
            "cost": {
              "value": 1552,
              "currency": "USD"
            },
            "price_with_tax": {
              "value": 10863,
              "currency": "USD"
            }
          },
          {
            "title": "Hudson Corner King",
            "pictures": [
              "https://lh3.googleusercontent.com/hrppk/ANjXD_xh7ZruI7-cODN5bzF1IWAG3PEIQADDGgw0sWtDDRk-TbV4EPtEVYDEJewJgMRtl6Zejine24V66DGiU5FlqCq-EMgShWDmqhjLyVs9FERHWG0QxGnFxW7LN7-HGl4UrF7-s8XcAj7YDUQ5xjlaAX-v836WgUq0svU"
            ],
            "link": "https://www.google.com/aclk?sa=l&ai=DChsSEwjCoPbrn_iSAxVGUn8AHdd8DsoYACICCAEQMhoCb2E&co=1&ase=2&gclid=EAIaIQobChMIwqD265_4kgMVRlJ_AB3XfA7KEAoYAiAMEgJYkfD_BwE&cid=CAASuwHkaOl2NLS5wDy6GKMRdyxNZjSVEWrmSsf6RKRBnUgVhiZOlox1MbkBncfXuNV2KEaH7m6BCeu7UtSPKhdBVddQpQLWDK60Lm_9zP48inYjhuoy8cCjJRO0fIwJZvWIIwnTsJ5b7XsSgxO1mgLBH1XvNaB5VuZZa-54QO3_3b1xl8jw76lYwiPs0-tRaCQoyvY36jEZOV2oU43o72VaW1uLuKFnrNu4xj1-08RFzgDhK_G9-OqBlzR54CHk&category=acrcp_v1_48&sig=AOD64_04kbwDw1x6JmAHL0r4OdUwRUbb8A&adurl=",
            "extensions": [
              "1 king bed"
            ],
            "price": {
              "value": 1261,
              "currency": "USD"
            },
            "cost": {
              "value": 1451,
              "currency": "USD"
            },
            "price_with_tax": {
              "value": 10157,
              "currency": "USD"
            }
          },
          {
            "title": "Hudson Corner King",
            "pictures": [
              "https://lh3.googleusercontent.com/hrppk/ANjXD_xh7ZruI7-cODN5bzF1IWAG3PEIQADDGgw0sWtDDRk-TbV4EPtEVYDEJewJgMRtl6Zejine24V66DGiU5FlqCq-EMgShWDmqhjLyVs9FERHWG0QxGnFxW7LN7-HGl4UrF7-s8XcAj7YDUQ5xjlaAX-v836WgUq0svU"
            ],
            "link": "https://www.google.com/aclk?sa=l&ai=DChsSEwjCoPbrn_iSAxVGUn8AHdd8DsoYACICCAEQMxoCb2E&co=1&ase=2&gclid=EAIaIQobChMIwqD265_4kgMVRlJ_AB3XfA7KEAoYAiANEgIGd_D_BwE&cid=CAASuwHkaOl2NLS5wDy6GKMRdyxNZjSVEWrmSsf6RKRBnUgVhiZOlox1MbkBncfXuNV2KEaH7m6BCeu7UtSPKhdBVddQpQLWDK60Lm_9zP48inYjhuoy8cCjJRO0fIwJZvWIIwnTsJ5b7XsSgxO1mgLBH1XvNaB5VuZZa-54QO3_3b1xl8jw76lYwiPs0-tRaCQoyvY36jEZOV2oU43o72VaW1uLuKFnrNu4xj1-08RFzgDhK_G9-OqBlzR54CHk&category=acrcp_v1_48&sig=AOD64_3GCNlPvXpoYzJ6vAMnK3A5zrL9Vw&adurl=",
            "extensions": [
              "1 king bed Free cancellation until Apr 1"
            ],
            "price": {
              "value": 1449,
              "currency": "USD"
            },
            "cost": {
              "value": 1667,
              "currency": "USD"
            },
            "price_with_tax": {
              "value": 11666,
              "currency": "USD"
            }
          },
          {
            "title": "Hudson Corner Double",
            "pictures": [
              "https://lh3.googleusercontent.com/hrppk/ANjXD_yeBfSgeyblSeisek8ZI4YEHLCIbbXrCJxgyCdZUamkH5oV5DdlJoKUakDV53Z7p-BDS0E8rJ62m6QZMrFqObi9meM30tA-IA6SocR49mzpLbxLgLGE-3-aodZ0vOxTfpmcX440cUjJEe1Ngv3iSw2LSIyNpQLwWUtZ"
            ],
            "link": "https://www.google.com/aclk?sa=l&ai=DChsSEwjCoPbrn_iSAxVGUn8AHdd8DsoYACICCAEQNBoCb2E&co=1&ase=2&gclid=EAIaIQobChMIwqD265_4kgMVRlJ_AB3XfA7KEAoYAiAOEgIWafD_BwE&cid=CAASuwHkaOl2NLS5wDy6GKMRdyxNZjSVEWrmSsf6RKRBnUgVhiZOlox1MbkBncfXuNV2KEaH7m6BCeu7UtSPKhdBVddQpQLWDK60Lm_9zP48inYjhuoy8cCjJRO0fIwJZvWIIwnTsJ5b7XsSgxO1mgLBH1XvNaB5VuZZa-54QO3_3b1xl8jw76lYwiPs0-tRaCQoyvY36jEZOV2oU43o72VaW1uLuKFnrNu4xj1-08RFzgDhK_G9-OqBlzR54CHk&category=acrcp_v1_48&sig=AOD64_0TzRN_pmTs1r0B3wHg2bQnvTsl6g&adurl=",
            "extensions": [
              "1 double bed"
            ],
            "price": {
              "value": 1300,
              "currency": "USD"
            },
            "cost": {
              "value": 1495,
              "currency": "USD"
            },
            "price_with_tax": {
              "value": 10467,
              "currency": "USD"
            }
          },
          {
            "title": "Hudson Corner Double",
            "pictures": [
              "https://lh3.googleusercontent.com/hrppk/ANjXD_yeBfSgeyblSeisek8ZI4YEHLCIbbXrCJxgyCdZUamkH5oV5DdlJoKUakDV53Z7p-BDS0E8rJ62m6QZMrFqObi9meM30tA-IA6SocR49mzpLbxLgLGE-3-aodZ0vOxTfpmcX440cUjJEe1Ngv3iSw2LSIyNpQLwWUtZ"
            ],
            "link": "https://www.google.com/aclk?sa=l&ai=DChsSEwjCoPbrn_iSAxVGUn8AHdd8DsoYACICCAEQNRoCb2E&co=1&ase=2&gclid=EAIaIQobChMIwqD265_4kgMVRlJ_AB3XfA7KEAoYAiAPEgIV3fD_BwE&cid=CAASuwHkaOl2NLS5wDy6GKMRdyxNZjSVEWrmSsf6RKRBnUgVhiZOlox1MbkBncfXuNV2KEaH7m6BCeu7UtSPKhdBVddQpQLWDK60Lm_9zP48inYjhuoy8cCjJRO0fIwJZvWIIwnTsJ5b7XsSgxO1mgLBH1XvNaB5VuZZa-54QO3_3b1xl8jw76lYwiPs0-tRaCQoyvY36jEZOV2oU43o72VaW1uLuKFnrNu4xj1-08RFzgDhK_G9-OqBlzR54CHk&category=acrcp_v1_48&sig=AOD64_1bV54iwzggMCJtCAFW9FlAzXCmtQ&adurl=",
            "extensions": [
              "1 double bed Free cancellation until Apr 1"
            ],
            "price": {
              "value": 1494,
              "currency": "USD"
            },
            "cost": {
              "value": 1718,
              "currency": "USD"
            },
            "price_with_tax": {
              "value": 12027,
              "currency": "USD"
            }
          },
          {
            "title": "Accessible Liberty Suite",
            "pictures": [
              "https://lh3.googleusercontent.com/hrppk/ANjXD_ww5DsjCN4YmZZyFdZwwPcaACASJul2NHBc33CJI6PmL57ABgizbEjzHfF-mdnm5fxu6htw4H8-uYg1_Hp4qVlRby0MErfZfndCcURjMKhkg1-H-L9fnoCjiJ7eBmFoggT1Yxbr1qxMmBTH5lSeBZGEPtjpj86vT0g"
            ],
            "link": "https://www.google.com/aclk?sa=l&ai=DChsSEwjCoPbrn_iSAxVGUn8AHdd8DsoYACICCAEQNhoCb2E&co=1&ase=2&gclid=EAIaIQobChMIwqD265_4kgMVRlJ_AB3XfA7KEAoYAiAQEgKVfPD_BwE&cid=CAASuwHkaOl2NLS5wDy6GKMRdyxNZjSVEWrmSsf6RKRBnUgVhiZOlox1MbkBncfXuNV2KEaH7m6BCeu7UtSPKhdBVddQpQLWDK60Lm_9zP48inYjhuoy8cCjJRO0fIwJZvWIIwnTsJ5b7XsSgxO1mgLBH1XvNaB5VuZZa-54QO3_3b1xl8jw76lYwiPs0-tRaCQoyvY36jEZOV2oU43o72VaW1uLuKFnrNu4xj1-08RFzgDhK_G9-OqBlzR54CHk&category=acrcp_v1_48&sig=AOD64_3PWv0VrClvPzIw_0iDkVeb4Nlp9w&adurl=",
            "extensions": [
              "Suite Suite"
            ],
            "price": {
              "value": 2479,
              "currency": "USD"
            },
            "cost": {
              "value": 2850,
              "currency": "USD"
            },
            "price_with_tax": {
              "value": 19948,
              "currency": "USD"
            }
          },
          {
            "title": "Accessible Liberty Suite",
            "pictures": [
              "https://lh3.googleusercontent.com/hrppk/ANjXD_ww5DsjCN4YmZZyFdZwwPcaACASJul2NHBc33CJI6PmL57ABgizbEjzHfF-mdnm5fxu6htw4H8-uYg1_Hp4qVlRby0MErfZfndCcURjMKhkg1-H-L9fnoCjiJ7eBmFoggT1Yxbr1qxMmBTH5lSeBZGEPtjpj86vT0g"
            ],
            "link": "https://www.google.com/aclk?sa=l&ai=DChsSEwjCoPbrn_iSAxVGUn8AHdd8DsoYACICCAEQNxoCb2E&co=1&ase=2&gclid=EAIaIQobChMIwqD265_4kgMVRlJ_AB3XfA7KEAoYAiAREgKUgfD_BwE&cid=CAASuwHkaOl2NLS5wDy6GKMRdyxNZjSVEWrmSsf6RKRBnUgVhiZOlox1MbkBncfXuNV2KEaH7m6BCeu7UtSPKhdBVddQpQLWDK60Lm_9zP48inYjhuoy8cCjJRO0fIwJZvWIIwnTsJ5b7XsSgxO1mgLBH1XvNaB5VuZZa-54QO3_3b1xl8jw76lYwiPs0-tRaCQoyvY36jEZOV2oU43o72VaW1uLuKFnrNu4xj1-08RFzgDhK_G9-OqBlzR54CHk&category=acrcp_v1_48&sig=AOD64_2Rv3GNQFgW0x0r4ahWOX682F_zJw&adurl=",
            "extensions": [
              "Suite Free cancellation until Apr 1 Suite"
            ],
            "price": {
              "value": 2849,
              "currency": "USD"
            },
            "cost": {
              "value": 3274,
              "currency": "USD"
            },
            "price_with_tax": {
              "value": 22920,
              "currency": "USD"
            }
          },
          {
            "title": "Accessible Oculus Suite",
            "link": "https://www.google.com/aclk?sa=l&ai=DChsSEwjCoPbrn_iSAxVGUn8AHdd8DsoYACICCAEQOBoCb2E&co=1&ase=2&gclid=EAIaIQobChMIwqD265_4kgMVRlJ_AB3XfA7KEAoYAiASEgLh3vD_BwE&cid=CAASuwHkaOl2NLS5wDy6GKMRdyxNZjSVEWrmSsf6RKRBnUgVhiZOlox1MbkBncfXuNV2KEaH7m6BCeu7UtSPKhdBVddQpQLWDK60Lm_9zP48inYjhuoy8cCjJRO0fIwJZvWIIwnTsJ5b7XsSgxO1mgLBH1XvNaB5VuZZa-54QO3_3b1xl8jw76lYwiPs0-tRaCQoyvY36jEZOV2oU43o72VaW1uLuKFnrNu4xj1-08RFzgDhK_G9-OqBlzR54CHk&category=acrcp_v1_48&sig=AOD64_2qKm4LfiTTnR-nRv3y-iZqfa1cdg&adurl=",
            "extensions": [
              "Suite Suite"
            ],
            "price": {
              "value": 3101,
              "currency": "USD"
            },
            "cost": {
              "value": 3564,
              "currency": "USD"
            },
            "price_with_tax": {
              "value": 24945,
              "currency": "USD"
            }
          },
          {
            "title": "Accessible Oculus Suite",
            "link": "https://www.google.com/aclk?sa=l&ai=DChsSEwjCoPbrn_iSAxVGUn8AHdd8DsoYACICCAEQORoCb2E&co=1&ase=2&gclid=EAIaIQobChMIwqD265_4kgMVRlJ_AB3XfA7KEAoYAiATEgJN-_D_BwE&cid=CAASuwHkaOl2NLS5wDy6GKMRdyxNZjSVEWrmSsf6RKRBnUgVhiZOlox1MbkBncfXuNV2KEaH7m6BCeu7UtSPKhdBVddQpQLWDK60Lm_9zP48inYjhuoy8cCjJRO0fIwJZvWIIwnTsJ5b7XsSgxO1mgLBH1XvNaB5VuZZa-54QO3_3b1xl8jw76lYwiPs0-tRaCQoyvY36jEZOV2oU43o72VaW1uLuKFnrNu4xj1-08RFzgDhK_G9-OqBlzR54CHk&category=acrcp_v1_48&sig=AOD64_1eRD9Eco_DcVHAhPHY_0QfasH2kw&adurl=",
            "extensions": [
              "Suite Free cancellation until Apr 1 Suite"
            ],
            "price": {
              "value": 3564,
              "currency": "USD"
            },
            "cost": {
              "value": 4095,
              "currency": "USD"
            },
            "price_with_tax": {
              "value": 28663,
              "currency": "USD"
            }
          },
          {
            "title": "Oculus Suite",
            "pictures": [
              "https://lh3.googleusercontent.com/hrppk/ANjXD_wUo6BPQW7nrkfgpTzJi_nQA8xpSw312DpP20wbOYdpEfOmvds9VLU7L_ibu_895NqpjU5kLib0DfsImWRp7v19NjwaSBrUJ6TUGTFABEDUUB7vOgVyyP0W54B-SH86pi457VRBGPvK7ykAT93UU9whEXLD7fMb9jLf"
            ],
            "link": "https://www.google.com/aclk?sa=l&ai=DChsSEwjCoPbrn_iSAxVGUn8AHdd8DsoYACICCAEQOhoCb2E&co=1&ase=2&gclid=EAIaIQobChMIwqD265_4kgMVRlJ_AB3XfA7KEAoYAiAUEgK5ovD_BwE&cid=CAASuwHkaOl2NLS5wDy6GKMRdyxNZjSVEWrmSsf6RKRBnUgVhiZOlox1MbkBncfXuNV2KEaH7m6BCeu7UtSPKhdBVddQpQLWDK60Lm_9zP48inYjhuoy8cCjJRO0fIwJZvWIIwnTsJ5b7XsSgxO1mgLBH1XvNaB5VuZZa-54QO3_3b1xl8jw76lYwiPs0-tRaCQoyvY36jEZOV2oU43o72VaW1uLuKFnrNu4xj1-08RFzgDhK_G9-OqBlzR54CHk&category=acrcp_v1_48&sig=AOD64_0XiU4_Z0oklRKJqzexvctPXFKt-g&adurl=",
            "extensions": [
              "Suite Suite"
            ],
            "price": {
              "value": 3101,
              "currency": "USD"
            },
            "cost": {
              "value": 3564,
              "currency": "USD"
            },
            "price_with_tax": {
              "value": 24945,
              "currency": "USD"
            }
          },
          {
            "title": "Oculus Suite",
            "pictures": [
              "https://lh3.googleusercontent.com/hrppk/ANjXD_wUo6BPQW7nrkfgpTzJi_nQA8xpSw312DpP20wbOYdpEfOmvds9VLU7L_ibu_895NqpjU5kLib0DfsImWRp7v19NjwaSBrUJ6TUGTFABEDUUB7vOgVyyP0W54B-SH86pi457VRBGPvK7ykAT93UU9whEXLD7fMb9jLf"
            ],
            "link": "https://www.google.com/aclk?sa=l&ai=DChsSEwjCoPbrn_iSAxVGUn8AHdd8DsoYACICCAEQOxoCb2E&co=1&ase=2&gclid=EAIaIQobChMIwqD265_4kgMVRlJ_AB3XfA7KEAoYAiAVEgLHXPD_BwE&cid=CAASuwHkaOl2NLS5wDy6GKMRdyxNZjSVEWrmSsf6RKRBnUgVhiZOlox1MbkBncfXuNV2KEaH7m6BCeu7UtSPKhdBVddQpQLWDK60Lm_9zP48inYjhuoy8cCjJRO0fIwJZvWIIwnTsJ5b7XsSgxO1mgLBH1XvNaB5VuZZa-54QO3_3b1xl8jw76lYwiPs0-tRaCQoyvY36jEZOV2oU43o72VaW1uLuKFnrNu4xj1-08RFzgDhK_G9-OqBlzR54CHk&category=acrcp_v1_48&sig=AOD64_3ouuw5q8p31JUMJKilpDV_aSkvRA&adurl=",
            "extensions": [
              "Suite Free cancellation until Apr 1 Suite"
            ],
            "price": {
              "value": 3564,
              "currency": "USD"
            },
            "cost": {
              "value": 4095,
              "currency": "USD"
            },
            "price_with_tax": {
              "value": 28663,
              "currency": "USD"
            }
          },
          {
            "title": "Suite, 1 King Bed, Non Smoking (Gotham)",
            "pictures": [
              "https://lh3.googleusercontent.com/hrppk/ANjXD_wa3n-lr_eOJ0aPzXtn0Ebx66AFv4U7oXLWeRazx5Mx2o6WFFtgTe3EqZEunp1KCnoJm_wvXijwQ2Myh3MWvnXHxGeOfrUrPAcH16zjLtwHUkWaD5QHJID78QeK4jwRmpjx-VH9LUNu1xj7yJce1r__ZvucnvWD0Zc"
            ],
            "link": "https://www.google.com/aclk?sa=l&ai=DChsSEwjCoPbrn_iSAxVGUn8AHdd8DsoYACICCAEQPBoCb2E&co=1&ase=2&gclid=EAIaIQobChMIwqD265_4kgMVRlJ_AB3XfA7KEAoYAiAWEgLvyPD_BwE&cid=CAASuwHkaOl2NLS5wDy6GKMRdyxNZjSVEWrmSsf6RKRBnUgVhiZOlox1MbkBncfXuNV2KEaH7m6BCeu7UtSPKhdBVddQpQLWDK60Lm_9zP48inYjhuoy8cCjJRO0fIwJZvWIIwnTsJ5b7XsSgxO1mgLBH1XvNaB5VuZZa-54QO3_3b1xl8jw76lYwiPs0-tRaCQoyvY36jEZOV2oU43o72VaW1uLuKFnrNu4xj1-08RFzgDhK_G9-OqBlzR54CHk&category=acrcp_v1_48&sig=AOD64_2MHQFYAZKUNaBDWT3pjpYRohDeSQ&adurl=",
            "extensions": [
              "1 king bed Suite"
            ],
            "price": {
              "value": 3536,
              "currency": "USD"
            },
            "cost": {
              "value": 4063,
              "currency": "USD"
            },
            "price_with_tax": {
              "value": 28439,
              "currency": "USD"
            }
          },
          {
            "title": "Suite, 1 King Bed, Non Smoking (Gotham)",
            "pictures": [
              "https://lh3.googleusercontent.com/hrppk/ANjXD_wa3n-lr_eOJ0aPzXtn0Ebx66AFv4U7oXLWeRazx5Mx2o6WFFtgTe3EqZEunp1KCnoJm_wvXijwQ2Myh3MWvnXHxGeOfrUrPAcH16zjLtwHUkWaD5QHJID78QeK4jwRmpjx-VH9LUNu1xj7yJce1r__ZvucnvWD0Zc"
            ],
            "link": "https://www.google.com/aclk?sa=l&ai=DChsSEwjCoPbrn_iSAxVGUn8AHdd8DsoYACICCAEQPRoCb2E&co=1&ase=2&gclid=EAIaIQobChMIwqD265_4kgMVRlJ_AB3XfA7KEAoYAiAXEgIs9vD_BwE&cid=CAASuwHkaOl2NLS5wDy6GKMRdyxNZjSVEWrmSsf6RKRBnUgVhiZOlox1MbkBncfXuNV2KEaH7m6BCeu7UtSPKhdBVddQpQLWDK60Lm_9zP48inYjhuoy8cCjJRO0fIwJZvWIIwnTsJ5b7XsSgxO1mgLBH1XvNaB5VuZZa-54QO3_3b1xl8jw76lYwiPs0-tRaCQoyvY36jEZOV2oU43o72VaW1uLuKFnrNu4xj1-08RFzgDhK_G9-OqBlzR54CHk&category=acrcp_v1_48&sig=AOD64_1FEr5MAu7-2NzDuwUyCyvJ6M8F9A&adurl=",
            "extensions": [
              "1 king bed Free cancellation until Apr 1 Suite"
            ],
            "price": {
              "value": 4064,
              "currency": "USD"
            },
            "cost": {
              "value": 4668,
              "currency": "USD"
            },
            "price_with_tax": {
              "value": 32679,
              "currency": "USD"
            }
          },
          {
            "title": "Suite, 1 King Bed, Non Smoking, Terrace (Gotham)",
            "pictures": [
              "https://lh3.googleusercontent.com/hrppk/ANjXD_wa3n-lr_eOJ0aPzXtn0Ebx66AFv4U7oXLWeRazx5Mx2o6WFFtgTe3EqZEunp1KCnoJm_wvXijwQ2Myh3MWvnXHxGeOfrUrPAcH16zjLtwHUkWaD5QHJID78QeK4jwRmpjx-VH9LUNu1xj7yJce1r__ZvucnvWD0Zc"
            ],
            "link": "https://www.google.com/aclk?sa=l&ai=DChsSEwjCoPbrn_iSAxVGUn8AHdd8DsoYACICCAEQPhoCb2E&co=1&ase=2&gclid=EAIaIQobChMIwqD265_4kgMVRlJ_AB3XfA7KEAoYAiAYEgLa0_D_BwE&cid=CAASuwHkaOl2NLS5wDy6GKMRdyxNZjSVEWrmSsf6RKRBnUgVhiZOlox1MbkBncfXuNV2KEaH7m6BCeu7UtSPKhdBVddQpQLWDK60Lm_9zP48inYjhuoy8cCjJRO0fIwJZvWIIwnTsJ5b7XsSgxO1mgLBH1XvNaB5VuZZa-54QO3_3b1xl8jw76lYwiPs0-tRaCQoyvY36jEZOV2oU43o72VaW1uLuKFnrNu4xj1-08RFzgDhK_G9-OqBlzR54CHk&category=acrcp_v1_48&sig=AOD64_1oXpUWuzpVIRL06jaFs0DqEeZibg&adurl=",
            "extensions": [
              "1 king bed Suite"
            ],
            "price": {
              "value": 3926,
              "currency": "USD"
            },
            "cost": {
              "value": 4511,
              "currency": "USD"
            },
            "price_with_tax": {
              "value": 31578,
              "currency": "USD"
            }
          },
          {
            "title": "Suite, 1 King Bed, Non Smoking, Terrace (Gotham)",
            "pictures": [
              "https://lh3.googleusercontent.com/hrppk/ANjXD_wa3n-lr_eOJ0aPzXtn0Ebx66AFv4U7oXLWeRazx5Mx2o6WFFtgTe3EqZEunp1KCnoJm_wvXijwQ2Myh3MWvnXHxGeOfrUrPAcH16zjLtwHUkWaD5QHJID78QeK4jwRmpjx-VH9LUNu1xj7yJce1r__ZvucnvWD0Zc"
            ],
            "link": "https://www.google.com/aclk?sa=l&ai=DChsSEwjCoPbrn_iSAxVGUn8AHdd8DsoYACICCAEQPxoCb2E&co=1&ase=2&gclid=EAIaIQobChMIwqD265_4kgMVRlJ_AB3XfA7KEAoYAiAZEgIUV_D_BwE&cid=CAASuwHkaOl2NLS5wDy6GKMRdyxNZjSVEWrmSsf6RKRBnUgVhiZOlox1MbkBncfXuNV2KEaH7m6BCeu7UtSPKhdBVddQpQLWDK60Lm_9zP48inYjhuoy8cCjJRO0fIwJZvWIIwnTsJ5b7XsSgxO1mgLBH1XvNaB5VuZZa-54QO3_3b1xl8jw76lYwiPs0-tRaCQoyvY36jEZOV2oU43o72VaW1uLuKFnrNu4xj1-08RFzgDhK_G9-OqBlzR54CHk&category=acrcp_v1_48&sig=AOD64_3qFKdDJlHKmMAX2OieB_S2hOCXCw&adurl=",
            "extensions": [
              "1 king bed Free cancellation until Apr 1 Suite"
            ],
            "price": {
              "value": 4514,
              "currency": "USD"
            },
            "cost": {
              "value": 5185,
              "currency": "USD"
            },
            "price_with_tax": {
              "value": 36294,
              "currency": "USD"
            }
          }
        ]
      },
      {
        "title": "Long Stay Discounts",
        "logo": "https://www.gstatic.com/travel-hotels/branding/6131123071209883889.png",
        "link": "https://www.longstaydiscounts.com/transition/?data=price=8108.07%26total_price=9331.3%26request_id=5de6faf4-bed6-41a0-a5a8-5ebaf17a5be8%26ps=296306%26pp=vxdXzMnczXSybIIfpW80fQ%26pb=SU5vEhldOC6H9K1kZwIQ4d2JfI1zkfnZXwyokA87-W87qcyTm0x9pLysiqwybwIaoISHLs_aO-FLzJI9HWNwc4Az8Kp362gI5poRjGihPDGa6gyLdZv4SGyT0fDxBpTs0gO6FAaspQv93s-Ff827uDIM8eXlEoPVbEzQ43RDO1ZQvMuXOCNR9FE4gD0yvzTRg8wwIWyBaUgTMNt_J1VoXblRWLTWMg90CtvM02z5E8AVnyZHCfvTbgcmmVzBj7v2MAyFceNkLFXpKcBs1K7ThvCCvlYui8YZp8mNotBGRlNuRZ3OxUhwm8-aMbKCkUXB8Bv8zWi8FoV94w40p7CHx0U__fHEIribv5GxVjCcA-4%253D%26gha_lsd_pull_request=True%26rtp=SdTUqdR7wIew8aRS9esAtw%253D%253D%26risk_lk_1=false%26alwd_risk=false%26alwd_rand=false%26gt=1772137197%26sg=YDhbN%26ttl_bkt=none%26all_inclusive=false&utm_source=gha_lsd&utm_content=localuniversal&currency=USD&user_country=US&verification=false&rate_rule_ids=&date_type=selected&rate_rule_id=signedout_desktop&utm_campaign=&display_currency=USD&display_all_inclusive_price=9331.29&checkin_at=2026-04-03&checkout_at=2026-04-10&provider_hotel_id=10007072903&provider=ean&num_adults=2&children=[]&user_locale=en-US&user_list_id=&utm_medium=organic&utm_id=gha_lsd_organic",
        "price": {
          "value": 1158,
          "currency": "USD"
        },
        "cost": {
          "value": 1158,
          "currency": "USD"
        },
        "price_with_tax": {
          "value": 1333,
          "currency": "USD"
        },
        "cost_with_tax": {
          "value": 9331,
          "currency": "USD"
        }
      }
    ],
    "reviews": {
      "rating": 4.7,
      "reviews_cnt": 1280,
      "reviews_by_stars": {
        "5 star": "1%"
      }
    }
  }
  ```
</ResponseExample>


# Device type
Source: https://docs.brightdata.com/api-reference/serp/google-hotels/device-type

Configure the Bright Data Google Hotels Device Type parameter to refine queries and return matching results as JSON or HTML. On port 44445.

```txt wrap theme={null}
https://www.google.com/travel/hotels?q=four+seasons+hotel+new+york+downtown&brd_mobile=1
```

## Parameters

<ParamField type="string">
  The search query parameter. Specifies the keyword or phrase you want to search for on Google.
</ParamField>

<ParamField type="string">
  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.

  ```txt wrap theme={null}
  https://www.google.com/travel/hotels?q=four+seasons+hotel+new+york+downtown&brd_mobile=1
  ```

  **For specific mobile platform provide one of the following values:**

  | Parameter                   | Description                                     |
  | --------------------------- | ----------------------------------------------- |
  | `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                                  |
</ParamField>

<RequestExample>
  ```shell cURL highlight={6} theme={null}
    curl -X POST https://api.brightdata.com/request \
    --header "Content-Type: application/json" \
    --header "Authorization: Bearer API_KEY" \
    --data '{
      "zone": "serp_api1",
      "url": "https://www.google.com/travel/hotels?q=four+seasons+hotel+new+york+downtown&brd_mobile=1",
      "format": "raw"
    }'
  ```

  ```shell Native proxy highlight={4} theme={null}
  curl --proxy brd.superproxy.io:44445 \
    --proxy-user CUSTOMER_USERNAME:CUSTOMER_PASSWORD \
    --ssl-no-revoke \
    "https://www.google.com/travel/hotels?q=four+seasons+hotel+new+york+downtown&brd_mobile=1"
  ```

  ```js Node.js highlight={10} theme={null}
  (async () => {
    const response = await fetch('https://api.brightdata.com/request', {
      method: 'POST',
      headers: {
        'Content-Type': 'application/json',
        'Authorization': 'Bearer API_KEY'
      },
      body: JSON.stringify({
        zone: 'serp_api1',
        url: 'https://www.google.com/travel/hotels?q=four+seasons+hotel+new+york+downtown&brd_mobile=1',
        format: 'raw'
      })
    });
    
    const data = await response.text();
    console.log(data);
  })();
  ```

  ```python Python highlight={11} theme={null}
  import requests

  # API Configuration
  headers = {
      'Content-Type': 'application/json',
      'Authorization': 'Bearer API_KEY',
  }

  payload = {
      'zone': 'serp_api1',
      'url': 'https://www.google.com/travel/hotels?q=four+seasons+hotel+new+york+downtown&brd_mobile=1',
      'format': 'raw'
  }

  # Make the request
  response = requests.post(
      'https://api.brightdata.com/request', 
      json=payload, 
      headers=headers
  )

  print(response.text)
  ```
</RequestExample>

<ResponseExample>
  ```json 200 theme={null}
  {
    "overview": {
      "type": "hotels",
      "title": "four seasons hotel new york downtown - Google Hotel Search",
      "requested": {
        "occupancy": 2,
        "number_of_adults": 2
      },
      "available": "unknown",
      "currency": "USD"
    }
  }
  ```
</ResponseExample>


# Free cancellation
Source: https://docs.brightdata.com/api-reference/serp/google-hotels/free-cancellation

Configure the Bright Data Google Hotels Free Cancellation parameter to refine queries and return matching results as JSON or HTML. On port 44445.

```txt wrap theme={null}
https://www.google.com/travel/hotels?q=four+seasons+hotel+new+york+downtown&brd_free_cancellation=true
```

## Parameters

<ParamField type="string">
  The search query parameter. Specifies the keyword or phrase you want to search for on Google.
</ParamField>

<ParamField type="string">
  Show only offers with free cancellation.

  ```txt wrap theme={null}
  https://www.google.com/travel/hotels?q=four+seasons+hotel+new+york+downtown&brd_free_cancellation=true
  ```

  | Parameter                     | Description            |
  | ----------------------------- | ---------------------- |
  | `brd_free_cancellation=true`  | with free cancellation |
  | `brd_free_cancellation=false` | show any offers        |
</ParamField>

<RequestExample>
  ```shell cURL highlight={6} theme={null}
    curl -X POST https://api.brightdata.com/request \
    --header "Content-Type: application/json" \
    --header "Authorization: Bearer API_KEY" \
    --data '{
      "zone": "serp_api1",
      "url": "https://www.google.com/travel/hotels?q=four+seasons+hotel+new+york+downtown&brd_free_cancellation=true",
      "format": "raw"
    }'
  ```

  ```shell Native proxy highlight={4} theme={null}
  curl --proxy brd.superproxy.io:44445 \
    --proxy-user CUSTOMER_USERNAME:CUSTOMER_PASSWORD \
    --ssl-no-revoke \
    "https://www.google.com/travel/hotels?q=four+seasons+hotel+new+york+downtown&brd_free_cancellation=true"
  ```

  ```js Node.js highlight={10} theme={null}
  (async () => {
    const response = await fetch('https://api.brightdata.com/request', {
      method: 'POST',
      headers: {
        'Content-Type': 'application/json',
        'Authorization': 'Bearer API_KEY'
      },
      body: JSON.stringify({
        zone: 'serp_api1',
        url: 'https://www.google.com/travel/hotels?q=four+seasons+hotel+new+york+downtown&brd_free_cancellation=true',
        format: 'raw'
      })
    });
    
    const data = await response.text();
    console.log(data);
  })();
  ```

  ```python Python highlight={11} theme={null}
  import requests

  # API Configuration
  headers = {
      'Content-Type': 'application/json',
      'Authorization': 'Bearer API_KEY',
  }

  payload = {
      'zone': 'serp_api1',
      'url': 'https://www.google.com/travel/hotels?q=four+seasons+hotel+new+york+downtown&brd_free_cancellation=true',
      'format': 'raw'
  }

  # Make the request
  response = requests.post(
      'https://api.brightdata.com/request', 
      json=payload, 
      headers=headers
  )

  print(response.text)
  ```
</RequestExample>

<ResponseExample>
  ```json 200 theme={null}
  {
    "overview": {
      "type": "hotels",
      "title": "Four Seasons Hotel New York Downtown",
      "requested": {
        "start_date": "2026-02-27",
        "end_date": "2026-02-28",
        "occupancy": 2,
        "number_of_adults": 2
      },
      "available": "unknown",
      "currency": "USD",
      "coordinates": {
        "latitude": 40.712633,
        "longitude": -74.0092141
      },
      "address": "27 Barclay St, New York, NY 10007, United States",
      "phone": "+1 646-880-1999",
      "fid": "0x89c25a18e3553f8b:0x1337dae5edaabaa2"
    },
    "reviews": {
      "rating": 4.7,
      "reviews_cnt": 1280,
      "reviews_by_stars": {
        "5 star": "1%"
      }
    }
  }
  ```
</ResponseExample>


# Google Hotels localization
Source: https://docs.brightdata.com/api-reference/serp/google-hotels/localization

Configure the Bright Data Google Hotels Google Hotels localization parameter to refine queries and return matching results as JSON or HTML. On port 44445.

```txt wrap theme={null}
https://www.google.com/travel/hotels?q=four+seasons+hotel+new+york+downtown&gl=us&hl=en
```

## Parameters

<ParamField type="string">
  The search query parameter. Specifies the keyword or phrase you want to search for on Google.
</ParamField>

<ParamField type="string">
  Two-letter country code used to define the country of search

  ```txt wrap theme={null}
  https://www.google.com/travel/hotels?q=four+seasons+hotel+new+york+downtown&gl=us
  ```
</ParamField>

<ParamField type="string">
  Two-letter language code used to define the page language

  ```txt wrap theme={null}
  https://www.google.com/travel/hotels?q=four+seasons+hotel+new+york+downtown&hl=en
  ```
</ParamField>

<RequestExample>
  ```shell cURL highlight={6} theme={null}
    curl -X POST https://api.brightdata.com/request \
    --header "Content-Type: application/json" \
    --header "Authorization: Bearer API_KEY" \
    --data '{
      "zone": "serp_api1",
      "url": "https://www.google.com/travel/hotels?q=four+seasons+hotel+new+york+downtown&gl=us&hl=en",
      "format": "raw"
    }'
  ```

  ```shell Native proxy highlight={4} theme={null}
  curl --proxy brd.superproxy.io:44445 \
    --proxy-user CUSTOMER_USERNAME:CUSTOMER_PASSWORD \
    --ssl-no-revoke \
    "https://www.google.com/travel/hotels?q=four+seasons+hotel+new+york+downtown&gl=us&hl=en"
  ```

  ```js Node.js highlight={10} theme={null}
  (async () => {
    const response = await fetch('https://api.brightdata.com/request', {
      method: 'POST',
      headers: {
        'Content-Type': 'application/json',
        'Authorization': 'Bearer API_KEY'
      },
      body: JSON.stringify({
        zone: 'serp_api1',
        url: 'https://www.google.com/travel/hotels?q=four+seasons+hotel+new+york+downtown&gl=us&hl=en',
        format: 'raw'
      })
    });
    
    const data = await response.text();
    console.log(data);
  })();
  ```

  ```python Python highlight={11} theme={null}
  import requests

  # API Configuration
  headers = {
      'Content-Type': 'application/json',
      'Authorization': 'Bearer API_KEY',
  }

  payload = {
      'zone': 'serp_api1',
      'url': 'https://www.google.com/travel/hotels?q=four+seasons+hotel+new+york+downtown&gl=us&hl=en',
      'format': 'raw'
  }

  # Make the request
  response = requests.post(
      'https://api.brightdata.com/request', 
      json=payload, 
      headers=headers
  )

  print(response.text)
  ```
</RequestExample>

<ResponseExample>
  ```json 200 theme={null}
  {
    "overview": {
      "type": "hotels",
      "title": "Four Seasons Hotel New York Downtown",
      "requested": {
        "start_date": "2026-03-06",
        "end_date": "2026-03-07",
        "occupancy": 2,
        "number_of_adults": 2
      },
      "available": true,
      "currency": "EUR",
      "coordinates": {
        "latitude": 40.712633,
        "longitude": -74.0092141
      },
      "address": "27 Barclay St, New York, NY 10007, United States",
      "phone": "+1 646-880-1999",
      "fid": "0x89c25a18e3553f8b:0x1337dae5edaabaa2"
    },
    "prices": [
      {
        "title": "Hotels.com",
        "logo": "https://www.gstatic.com/travel-hotels/branding/f358dd45-ebd1-4af8-988d-d53154b73975.png",
        "link": "https://www.google.com/aclk?sa=l&ai=DChsSEwiQlc6wmfiSAxX8j1AGHcmwMM0YACICCAEQJRoCZGc&co=1&gclid=EAIaIQobChMIkJXOsJn4kgMV_I9QBh3JsDDNEAoYASABEgJ0ovD_BwE&sig=AOD64_2xUs_hsdCl_zU3kgXMXw3f79lqbw&adurl=",
        "price": {
          "value": 882,
          "currency": "EUR"
        },
        "cost": {
          "value": 882,
          "currency": "EUR"
        },
        "price_with_tax": {
          "value": 882,
          "currency": "EUR"
        },
        "rooms": [
          {
            "title": "Accessible Manhattan Room with King Bed",
            "pictures": [
              "https://lh3.googleusercontent.com/hrppk/ANjXD_zirGqnNUV3bUkVZ6Yq4QzaxzMTFw8S7BL88YG2xqf5qarRKkr50s-PfillUJkRvSl7KQqXwV9-bVLeYtBRigMpPPejfmFNDLX3qXcjydhC3sIHQL6X9_KcnnQtD_1b8kFPT_gkxt3Bjoif3Alols11Pq0yWqW6dkvZ"
            ],
            "link": "https://www.google.com/aclk?sa=l&ai=DChsSEwiQlc6wmfiSAxX8j1AGHcmwMM0YACICCAEQJxoCZGc&co=1&gclid=EAIaIQobChMIkJXOsJn4kgMV_I9QBh3JsDDNEAoYASADEgJb_PD_BwE&sig=AOD64_0u3wzhI7DSTTRfNJImHIhxC8FYPg&adurl=",
            "extensions": [
              "1 king bed"
            ],
            "price": {
              "value": 882,
              "currency": "EUR"
            },
            "cost": {
              "value": 882,
              "currency": "EUR"
            },
            "price_with_tax": {
              "value": 882,
              "currency": "EUR"
            }
          },
          {
            "title": "Accessible Manhattan Room with King Bed",
            "pictures": [
              "https://lh3.googleusercontent.com/hrppk/ANjXD_zirGqnNUV3bUkVZ6Yq4QzaxzMTFw8S7BL88YG2xqf5qarRKkr50s-PfillUJkRvSl7KQqXwV9-bVLeYtBRigMpPPejfmFNDLX3qXcjydhC3sIHQL6X9_KcnnQtD_1b8kFPT_gkxt3Bjoif3Alols11Pq0yWqW6dkvZ"
            ],
            "link": "https://www.google.com/aclk?sa=l&ai=DChsSEwiQlc6wmfiSAxX8j1AGHcmwMM0YACICCAEQKBoCZGc&co=1&gclid=EAIaIQobChMIkJXOsJn4kgMV_I9QBh3JsDDNEAoYASAEEgIXafD_BwE&sig=AOD64_1z6iOdmqqGcdTUr4_N8XFNisvhww&adurl=",
            "extensions": [
              "1 king bed Free cancellation until Mar 4"
            ],
            "price": {
              "value": 926,
              "currency": "EUR"
            },
            "cost": {
              "value": 926,
              "currency": "EUR"
            },
            "price_with_tax": {
              "value": 926,
              "currency": "EUR"
            }
          },
          {
            "title": "Manhattan Room with king bed",
            "pictures": [
              "https://lh3.googleusercontent.com/hrppk/ANjXD_zirGqnNUV3bUkVZ6Yq4QzaxzMTFw8S7BL88YG2xqf5qarRKkr50s-PfillUJkRvSl7KQqXwV9-bVLeYtBRigMpPPejfmFNDLX3qXcjydhC3sIHQL6X9_KcnnQtD_1b8kFPT_gkxt3Bjoif3Alols11Pq0yWqW6dkvZ"
            ],
            "link": "https://www.google.com/aclk?sa=l&ai=DChsSEwiQlc6wmfiSAxX8j1AGHcmwMM0YACICCAEQKRoCZGc&co=1&gclid=EAIaIQobChMIkJXOsJn4kgMV_I9QBh3JsDDNEAoYASAFEgJxRfD_BwE&sig=AOD64_0UidsBGdOCi_Oa_7eEz6o80GUt1w&adurl=",
            "extensions": [
              "1 king bed"
            ],
            "price": {
              "value": 882,
              "currency": "EUR"
            },
            "cost": {
              "value": 882,
              "currency": "EUR"
            },
            "price_with_tax": {
              "value": 882,
              "currency": "EUR"
            }
          },
          {
            "title": "Manhattan Room with king bed",
            "pictures": [
              "https://lh3.googleusercontent.com/hrppk/ANjXD_zirGqnNUV3bUkVZ6Yq4QzaxzMTFw8S7BL88YG2xqf5qarRKkr50s-PfillUJkRvSl7KQqXwV9-bVLeYtBRigMpPPejfmFNDLX3qXcjydhC3sIHQL6X9_KcnnQtD_1b8kFPT_gkxt3Bjoif3Alols11Pq0yWqW6dkvZ"
            ],
            "link": "https://www.google.com/aclk?sa=l&ai=DChsSEwiQlc6wmfiSAxX8j1AGHcmwMM0YACICCAEQKhoCZGc&co=1&gclid=EAIaIQobChMIkJXOsJn4kgMV_I9QBh3JsDDNEAoYASAGEgJ8APD_BwE&sig=AOD64_20A3O9tWCNcRNrw_BrNXgkH38Nbw&adurl=",
            "extensions": [
              "1 king bed Free cancellation until Mar 4"
            ],
            "price": {
              "value": 926,
              "currency": "EUR"
            },
            "cost": {
              "value": 926,
              "currency": "EUR"
            },
            "price_with_tax": {
              "value": 926,
              "currency": "EUR"
            }
          },
          {
            "title": "Manhattan Room with Double Beds",
            "pictures": [
              "https://lh3.googleusercontent.com/hrppk/ANjXD_zBdES1oKIM8aMTINPz_t2xtu2KC-uSe_oOKzsl9YklwJYFM1GwO-qFi8swCpTQ_KV9p47-tkiSad2to48uKImdUBLBvt6mhp6Hs8Q18Gxe3ss20foBlRPuXa_2vk47r8GRUWFd23wok1KV0TIGM9U2NVIgJ0V74PeZ"
            ],
            "link": "https://www.google.com/aclk?sa=l&ai=DChsSEwiQlc6wmfiSAxX8j1AGHcmwMM0YACICCAEQKxoCZGc&co=1&gclid=EAIaIQobChMIkJXOsJn4kgMV_I9QBh3JsDDNEAoYASAHEgJQpvD_BwE&sig=AOD64_1dTQ4X378diHkUNs9NBwVXjny3ag&adurl=",
            "extensions": [
              "2 double beds"
            ],
            "price": {
              "value": 945,
              "currency": "EUR"
            },
            "cost": {
              "value": 945,
              "currency": "EUR"
            },
            "price_with_tax": {
              "value": 945,
              "currency": "EUR"
            }
          }
        ]
      },
      {
        "title": "Expedia.com",
        "logo": "https://www.gstatic.com/travel-hotels/branding/ac238c97-1652-4830-8da8-bb8d8883af88.png",
        "link": "https://www.google.com/aclk?sa=l&ai=DChsSEwiQlc6wmfiSAxX8j1AGHcmwMM0YACICCAEQCRoCZGc&co=1&gclid=EAIaIQobChMIkJXOsJn4kgMV_I9QBh3JsDDNEAoYAiABEgIgp_D_BwE&sig=AOD64_0QKaGVbKXETl3s7roYBRtGwR6hOQ&adurl=",
        "price": {
          "value": 882,
          "currency": "EUR"
        },
        "cost": {
          "value": 882,
          "currency": "EUR"
        },
        "price_with_tax": {
          "value": 882,
          "currency": "EUR"
        },
        "rooms": [
          {
            "title": "Accessible Manhattan Room with King Bed",
            "pictures": [
              "https://lh3.googleusercontent.com/hrppk/ANjXD_zirGqnNUV3bUkVZ6Yq4QzaxzMTFw8S7BL88YG2xqf5qarRKkr50s-PfillUJkRvSl7KQqXwV9-bVLeYtBRigMpPPejfmFNDLX3qXcjydhC3sIHQL6X9_KcnnQtD_1b8kFPT_gkxt3Bjoif3Alols11Pq0yWqW6dkvZ"
            ],
            "link": "https://www.google.com/aclk?sa=l&ai=DChsSEwiQlc6wmfiSAxX8j1AGHcmwMM0YACICCAEQChoCZGc&co=1&gclid=EAIaIQobChMIkJXOsJn4kgMV_I9QBh3JsDDNEAoYAiACEgKSHfD_BwE&sig=AOD64_0Zi_mSfTuClXGJFuovQHRjOf2edw&adurl=",
            "extensions": [
              "1 king bed"
            ],
            "price": {
              "value": 882,
              "currency": "EUR"
            },
            "cost": {
              "value": 882,
              "currency": "EUR"
            },
            "price_with_tax": {
              "value": 882,
              "currency": "EUR"
            }
          },
          {
            "title": "Accessible Manhattan Room with King Bed",
            "pictures": [
              "https://lh3.googleusercontent.com/hrppk/ANjXD_zirGqnNUV3bUkVZ6Yq4QzaxzMTFw8S7BL88YG2xqf5qarRKkr50s-PfillUJkRvSl7KQqXwV9-bVLeYtBRigMpPPejfmFNDLX3qXcjydhC3sIHQL6X9_KcnnQtD_1b8kFPT_gkxt3Bjoif3Alols11Pq0yWqW6dkvZ"
            ],
            "link": "https://www.google.com/aclk?sa=l&ai=DChsSEwiQlc6wmfiSAxX8j1AGHcmwMM0YACICCAEQCxoCZGc&co=1&gclid=EAIaIQobChMIkJXOsJn4kgMV_I9QBh3JsDDNEAoYAiADEgITtvD_BwE&sig=AOD64_2l_wXdqXc6uv4FMfC3B0_IhD2KBQ&adurl=",
            "extensions": [
              "1 king bed Free cancellation until Mar 4"
            ],
            "price": {
              "value": 926,
              "currency": "EUR"
            },
            "cost": {
              "value": 926,
              "currency": "EUR"
            },
            "price_with_tax": {
              "value": 926,
              "currency": "EUR"
            }
          },
          {
            "title": "Manhattan Room with king bed",
            "pictures": [
              "https://lh3.googleusercontent.com/hrppk/ANjXD_zirGqnNUV3bUkVZ6Yq4QzaxzMTFw8S7BL88YG2xqf5qarRKkr50s-PfillUJkRvSl7KQqXwV9-bVLeYtBRigMpPPejfmFNDLX3qXcjydhC3sIHQL6X9_KcnnQtD_1b8kFPT_gkxt3Bjoif3Alols11Pq0yWqW6dkvZ"
            ],
            "link": "https://www.google.com/aclk?sa=l&ai=DChsSEwiQlc6wmfiSAxX8j1AGHcmwMM0YACICCAEQDBoCZGc&co=1&gclid=EAIaIQobChMIkJXOsJn4kgMV_I9QBh3JsDDNEAoYAiAEEgIm4fD_BwE&sig=AOD64_1eOpLFyXNrye4TPF3McvFl7Vpy8Q&adurl=",
            "extensions": [
              "1 king bed"
            ],
            "price": {
              "value": 882,
              "currency": "EUR"
            },
            "cost": {
              "value": 882,
              "currency": "EUR"
            },
            "price_with_tax": {
              "value": 882,
              "currency": "EUR"
            }
          },
          {
            "title": "Manhattan Room with king bed",
            "pictures": [
              "https://lh3.googleusercontent.com/hrppk/ANjXD_zirGqnNUV3bUkVZ6Yq4QzaxzMTFw8S7BL88YG2xqf5qarRKkr50s-PfillUJkRvSl7KQqXwV9-bVLeYtBRigMpPPejfmFNDLX3qXcjydhC3sIHQL6X9_KcnnQtD_1b8kFPT_gkxt3Bjoif3Alols11Pq0yWqW6dkvZ"
            ],
            "link": "https://www.google.com/aclk?sa=l&ai=DChsSEwiQlc6wmfiSAxX8j1AGHcmwMM0YACICCAEQDRoCZGc&co=1&gclid=EAIaIQobChMIkJXOsJn4kgMV_I9QBh3JsDDNEAoYAiAFEgKBqfD_BwE&sig=AOD64_3VJtgFzXWgbLHeDJPz66MfCv181A&adurl=",
            "extensions": [
              "1 king bed Free cancellation until Mar 4"
            ],
            "price": {
              "value": 926,
              "currency": "EUR"
            },
            "cost": {
              "value": 926,
              "currency": "EUR"
            },
            "price_with_tax": {
              "value": 926,
              "currency": "EUR"
            }
          }
        ]
      }
    ],
    "reviews": {
      "rating": 4.7,
      "reviews_cnt": 1280,
      "reviews_by_stars": {
        "5 star": "1%"
      }
    }
  }
  ```
</ResponseExample>


# Occupancy
Source: https://docs.brightdata.com/api-reference/serp/google-hotels/occupancy

Configure the Bright Data Google Hotels Occupancy parameter to refine queries and return matching results as JSON or HTML. On port 44445.

```txt wrap theme={null}
https://www.google.com/travel/hotels?q=four+seasons+hotel+new+york+downtown&brd_occupancy=4
```

## Parameters

<ParamField type="string">
  The search query parameter. Specifies the keyword or phrase you want to search for on Google.
</ParamField>

<ParamField type="string">
  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` - for 2 persons (`default`)  \
  > `brd_occupancy=3` - for 3 persons, etc.

  ```txt wrap theme={null}
  https://www.google.com/travel/hotels?q=four+seasons+hotel+new+york+downtown&brd_occupancy=4
  ```
</ParamField>

<RequestExample>
  ```shell cURL highlight={6} theme={null}
    curl -X POST https://api.brightdata.com/request \
    --header "Content-Type: application/json" \
    --header "Authorization: Bearer API_KEY" \
    --data '{
      "zone": "serp_api1",
      "url": "https://www.google.com/travel/hotels?q=four+seasons+hotel+new+york+downtown&brd_occupancy=4",
      "format": "raw"
    }'
  ```

  ```shell Native proxy highlight={4} theme={null}
  curl --proxy brd.superproxy.io:44445 \
    --proxy-user CUSTOMER_USERNAME:CUSTOMER_PASSWORD \
    --ssl-no-revoke \
    "https://www.google.com/travel/hotels?q=four+seasons+hotel+new+york+downtown&brd_occupancy=4"
  ```

  ```js Node.js highlight={10} theme={null}
  (async () => {
    const response = await fetch('https://api.brightdata.com/request', {
      method: 'POST',
      headers: {
        'Content-Type': 'application/json',
        'Authorization': 'Bearer API_KEY'
      },
      body: JSON.stringify({
        zone: 'serp_api1',
        url: 'https://www.google.com/travel/hotels?q=four+seasons+hotel+new+york+downtown&brd_occupancy=4',
        format: 'raw'
      })
    });
    
    const data = await response.text();
    console.log(data);
  })();
  ```

  ```python Python highlight={11} theme={null}
  import requests

  # API Configuration
  headers = {
      'Content-Type': 'application/json',
      'Authorization': 'Bearer API_KEY',
  }

  payload = {
      'zone': 'serp_api1',
      'url': 'https://www.google.com/travel/hotels?q=four+seasons+hotel+new+york+downtown&brd_occupancy=4',
      'format': 'raw'
  }

  # Make the request
  response = requests.post(
      'https://api.brightdata.com/request', 
      json=payload, 
      headers=headers
  )

  print(response.text)
  ```
</RequestExample>

<ResponseExample>
  ```json 200 highlight={8} theme={null}
  {
    "overview": {
      "type": "hotels",
      "title": "Four Seasons Hotel New York Downtown",
      "requested": {
        "start_date": "2026-02-27",
        "end_date": "2026-02-28",
        "occupancy": 4,
        "number_of_adults": 4
      },
      "available": true,
      "currency": "USD",
      "coordinates": {
        "latitude": 40.712633,
        "longitude": -74.0092141
      },
      "address": "27 Barclay St, New York, NY 10007",
      "phone": "(646) 880-1999",
      "fid": "0x89c25a18e3553f8b:0x1337dae5edaabaa2"
    },
    "prices": [
      {
        "title": "Booking.com",
        "logo": "https://www.gstatic.com/travel-hotels/branding/icon_184.png",
        "link": "https://www.google.com/aclk?sa=l&ai=DChsSEwijm_uwofiSAxXccn8AHX8pBPEYACICCAEQARoCb2E&co=1&gclid=EAIaIQobChMIo5v7sKH4kgMV3HJ_AB1_KQTxEAoYASABEgKFTfD_BwE&cid=CAASuwHkaHvrNFePLzN1GKdqRyRfUekwmG14uq0FowVTwkztlO6UtkzyhkK67lIMIeWSFk-8obkOW1y125TcPEIQCX25GBIPP7tiKKZwZ88fC0bGYXRdVCqww4zsDwj6wS5sEG-XwaUZHFe7akV-ZmK-hfWe__Kf9UBc_xEKsKP4KmpeaWk_tjrIwl6WMhlqTHsQuHcrvPddIlKTpLv5sbAfVUO2Ggc7tFda9t9cKzpzxT0I3IzVlw7yL1IsND82&sig=AOD64_3BwF5zkVM4yFnjzLkJe3yZ4LIyng&adurl=",
        "price": {
          "value": 2755,
          "currency": "USD"
        },
        "cost": {
          "value": 3167,
          "currency": "USD"
        },
        "price_with_tax": {
          "value": 3167,
          "currency": "USD"
        },
        "rooms": [
          {
            "title": "Liberty Suite",
            "pictures": [
              "https://lh3.googleusercontent.com/hrppk/ANjXD_zWFS0CdMRk4l9ZyD2WEhENua_lhcl151tKXdiyVEd3df2rCS_OT9oNo1z9ucWUFbu9qUa-2e94u9qYlLAEhP2kfhc2eC1XuqvQIkVleTmhE-GpsCtZ8W7Z6F9iEH-ksjoYLDTXJpWop7XJncxvLfeaoL8HQBbNlYfm9MGirHA9P__hgBbv44tBBEX614hpQmQ4vIL1OrS_55SiEINCqyNKvzxnZ4mSkSo"
            ],
            "link": "https://www.google.com/aclk?sa=l&ai=DChsSEwijm_uwofiSAxXccn8AHX8pBPEYACICCAEQAhoCb2E&co=1&gclid=EAIaIQobChMIo5v7sKH4kgMV3HJ_AB1_KQTxEAoYASACEgLW2vD_BwE&cid=CAASuwHkaHvrNFePLzN1GKdqRyRfUekwmG14uq0FowVTwkztlO6UtkzyhkK67lIMIeWSFk-8obkOW1y125TcPEIQCX25GBIPP7tiKKZwZ88fC0bGYXRdVCqww4zsDwj6wS5sEG-XwaUZHFe7akV-ZmK-hfWe__Kf9UBc_xEKsKP4KmpeaWk_tjrIwl6WMhlqTHsQuHcrvPddIlKTpLv5sbAfVUO2Ggc7tFda9t9cKzpzxT0I3IzVlw7yL1IsND82&sig=AOD64_1qIIPYxKKm7b-KBtAnQD0jNESHyg&adurl=",
            "extensions": [
              "Suite 4 guests Suite"
            ],
            "price": {
              "value": 2755,
              "currency": "USD"
            },
            "cost": {
              "value": 3167,
              "currency": "USD"
            },
            "price_with_tax": {
              "value": 3167,
              "currency": "USD"
            }
          }
        ]
      },
      {
        "title": "Priceline",
        "logo": "https://www.gstatic.com/travel-hotels/branding/icon_220.png",
        "link": "https://www.google.com/aclk?sa=l&ai=DChsSEwijm_uwofiSAxXccn8AHX8pBPEYACICCAEQBBoCb2E&co=1&gclid=EAIaIQobChMIo5v7sKH4kgMV3HJ_AB1_KQTxEAoYAiABEgJ5oPD_BwE&cid=CAASuwHkaHvrNFePLzN1GKdqRyRfUekwmG14uq0FowVTwkztlO6UtkzyhkK67lIMIeWSFk-8obkOW1y125TcPEIQCX25GBIPP7tiKKZwZ88fC0bGYXRdVCqww4zsDwj6wS5sEG-XwaUZHFe7akV-ZmK-hfWe__Kf9UBc_xEKsKP4KmpeaWk_tjrIwl6WMhlqTHsQuHcrvPddIlKTpLv5sbAfVUO2Ggc7tFda9t9cKzpzxT0I3IzVlw7yL1IsND82&sig=AOD64_3vAW6Wlrj7Rvy2jGGZZ6pL34wsVQ&adurl=",
        "price": {
          "value": 2755,
          "currency": "USD"
        },
        "cost": {
          "value": 3167,
          "currency": "USD"
        },
        "price_with_tax": {
          "value": 3167,
          "currency": "USD"
        },
        "rooms": [
          {
            "title": "Liberty Suite - Non-Refundable",
            "link": "https://www.google.com/aclk?sa=l&ai=DChsSEwijm_uwofiSAxXccn8AHX8pBPEYACICCAEQBRoCb2E&co=1&gclid=EAIaIQobChMIo5v7sKH4kgMV3HJ_AB1_KQTxEAoYAiACEgKRnvD_BwE&cid=CAASuwHkaHvrNFePLzN1GKdqRyRfUekwmG14uq0FowVTwkztlO6UtkzyhkK67lIMIeWSFk-8obkOW1y125TcPEIQCX25GBIPP7tiKKZwZ88fC0bGYXRdVCqww4zsDwj6wS5sEG-XwaUZHFe7akV-ZmK-hfWe__Kf9UBc_xEKsKP4KmpeaWk_tjrIwl6WMhlqTHsQuHcrvPddIlKTpLv5sbAfVUO2Ggc7tFda9t9cKzpzxT0I3IzVlw7yL1IsND82&sig=AOD64_1XxpKPh0u6KGRVipGp7q3p9amoFg&adurl=",
            "extensions": [
              "Suite 4 guests Suite"
            ],
            "price": {
              "value": 2755,
              "currency": "USD"
            },
            "cost": {
              "value": 3167,
              "currency": "USD"
            },
            "price_with_tax": {
              "value": 3167,
              "currency": "USD"
            }
          }
        ]
      },
      {
        "title": "Vio.com",
        "logo": "https://www.gstatic.com/travel-hotels/branding/297592521974050080.png",
        "link": "https://www.google.com/aclk?sa=l&ai=DChsSEwijm_uwofiSAxXccn8AHX8pBPEYACICCAEQBxoCb2E&co=1&gclid=EAIaIQobChMIo5v7sKH4kgMV3HJ_AB1_KQTxEAoYAyABEgJh9vD_BwE&cid=CAASuwHkaHvrNFePLzN1GKdqRyRfUekwmG14uq0FowVTwkztlO6UtkzyhkK67lIMIeWSFk-8obkOW1y125TcPEIQCX25GBIPP7tiKKZwZ88fC0bGYXRdVCqww4zsDwj6wS5sEG-XwaUZHFe7akV-ZmK-hfWe__Kf9UBc_xEKsKP4KmpeaWk_tjrIwl6WMhlqTHsQuHcrvPddIlKTpLv5sbAfVUO2Ggc7tFda9t9cKzpzxT0I3IzVlw7yL1IsND82&sig=AOD64_2CX8l_iwFjmkflD-t9Z7gieK67mQ&adurl=",
        "price": {
          "value": 2190,
          "currency": "USD"
        },
        "cost": {
          "value": 2520,
          "currency": "USD"
        },
        "price_with_tax": {
          "value": 2520,
          "currency": "USD"
        },
        "rooms": [
          {
            "title": "Standard Room",
            "link": "https://www.google.com/aclk?sa=l&ai=DChsSEwijm_uwofiSAxXccn8AHX8pBPEYACICCAEQCBoCb2E&co=1&gclid=EAIaIQobChMIo5v7sKH4kgMV3HJ_AB1_KQTxEAoYAyACEgIMUPD_BwE&cid=CAASuwHkaHvrNFePLzN1GKdqRyRfUekwmG14uq0FowVTwkztlO6UtkzyhkK67lIMIeWSFk-8obkOW1y125TcPEIQCX25GBIPP7tiKKZwZ88fC0bGYXRdVCqww4zsDwj6wS5sEG-XwaUZHFe7akV-ZmK-hfWe__Kf9UBc_xEKsKP4KmpeaWk_tjrIwl6WMhlqTHsQuHcrvPddIlKTpLv5sbAfVUO2Ggc7tFda9t9cKzpzxT0I3IzVlw7yL1IsND82&sig=AOD64_0nv1YpOB69DWGzx2lByFVSC_ivyg&adurl=",
            "extensions": [
              "4 guests"
            ],
            "price": {
              "value": 2190,
              "currency": "USD"
            },
            "cost": {
              "value": 2520,
              "currency": "USD"
            },
            "price_with_tax": {
              "value": 2520,
              "currency": "USD"
            }
          }
        ]
      },
      {
        "title": "Agoda",
        "logo": "https://www.gstatic.com/travel-hotels/branding/b13642de-d476-41bd-8254-3edc2e567aa6.png",
        "link": "https://www.google.com/aclk?sa=l&ai=DChsSEwijm_uwofiSAxXccn8AHX8pBPEYACICCAEQChoCb2E&co=1&gclid=EAIaIQobChMIo5v7sKH4kgMV3HJ_AB1_KQTxEAoYBCABEgI4tPD_BwE&cid=CAASuwHkaHvrNFePLzN1GKdqRyRfUekwmG14uq0FowVTwkztlO6UtkzyhkK67lIMIeWSFk-8obkOW1y125TcPEIQCX25GBIPP7tiKKZwZ88fC0bGYXRdVCqww4zsDwj6wS5sEG-XwaUZHFe7akV-ZmK-hfWe__Kf9UBc_xEKsKP4KmpeaWk_tjrIwl6WMhlqTHsQuHcrvPddIlKTpLv5sbAfVUO2Ggc7tFda9t9cKzpzxT0I3IzVlw7yL1IsND82&sig=AOD64_3NNqDK7Rkm1NGU2m-irDhU4bHmcA&adurl=",
        "price": {
          "value": 2190,
          "currency": "USD"
        },
        "cost": {
          "value": 2520,
          "currency": "USD"
        },
        "price_with_tax": {
          "value": 2520,
          "currency": "USD"
        },
        "rooms": [
          {
            "title": "Cheapest combo rooms",
            "pictures": [
              "https://lh3.googleusercontent.com/hrppk/ANjXD_zFEWEw3P5LJ7DtpU5VZk-6S6290T43IYWTz_h9ZHdy2WeJ2vEnEa8_Iy3d0ZZkGaxyflvduFfgDrYPFqMBc4-m_i7PhfXt96n6-zCVUW9xJtMm9uVrPup4AiuB04E66RdOrEa3Ve8YGw6858gktvrq927g-DpC2dqXeQ"
            ],
            "link": "https://www.google.com/aclk?sa=l&ai=DChsSEwijm_uwofiSAxXccn8AHX8pBPEYACICCAEQCxoCb2E&co=1&gclid=EAIaIQobChMIo5v7sKH4kgMV3HJ_AB1_KQTxEAoYBCACEgLu5PD_BwE&cid=CAASuwHkaHvrNFePLzN1GKdqRyRfUekwmG14uq0FowVTwkztlO6UtkzyhkK67lIMIeWSFk-8obkOW1y125TcPEIQCX25GBIPP7tiKKZwZ88fC0bGYXRdVCqww4zsDwj6wS5sEG-XwaUZHFe7akV-ZmK-hfWe__Kf9UBc_xEKsKP4KmpeaWk_tjrIwl6WMhlqTHsQuHcrvPddIlKTpLv5sbAfVUO2Ggc7tFda9t9cKzpzxT0I3IzVlw7yL1IsND82&sig=AOD64_0bI6JJitSd-AaPRLu9KNec0ySscg&adurl=",
            "extensions": [
              "Suite 4 guests Suite"
            ],
            "price": {
              "value": 2190,
              "currency": "USD"
            },
            "cost": {
              "value": 2520,
              "currency": "USD"
            },
            "price_with_tax": {
              "value": 2520,
              "currency": "USD"
            }
          }
        ]
      },
      {
        "title": "Priceline",
        "logo": "https://www.gstatic.com/travel-hotels/branding/icon_220.png",
        "link": "https://www.priceline.com/r/?channel=meta&product=hotel&theme=ghalistings&refid=PLGOOGLEMSS&refclickid=US_HP%7C35500803_localuniversal_1%7C20260227%7Cdesktop%7Cuserdate|public|||1%7C4%7C0|0|EN&hotelid=35500803&checkin=20260227&checkout=20260228&rooms=1&currency=USD&displayedCurr=USD&POSCountryCode=US&taxDisplayMode=BP&cityID=3000016152&adults=4&land=L&metaid=TZPY09t6i2r8eviYUv_ZZBhFokmqUcwjlhUz2OZhFpKJ_rcUR08v4V943zEFapC_d6iKdC2tfSjcdj31xM0zJyhOMHSWV-drRvv2NC7o90epTYWMpaY76kUc-CtZXTvPvntFnxKdY1xxaFkVPijMdJOtLubvNu35SROPjECv-OOtf4RMjpRUAs_LFggabmF5pYZaSn24vTxdKcO1T2D0sB53EF1l-Y40Aze_QDOGr57T9Crjb5YfW7ZF2lfuE6WRJ7ZCEdRglTx2nkLKmQXBkbToGwYa5PApnnoctK8mTKN2Cb-ua0kwaHsTQLTqwY8jSfg73Izv1NynJnRvBtfj4jSZSjECfwjffvVSkOQbeofOpqIu1YyBbYuNf9XXdGG_z6UaIjPvCApalSXVl9jYWMj33qOd9LB2LHv1qw0jE60&dblcnt=true&user_num_adults=4&hc=1&pdtax=411.86&pdf=0.00&pdt=3166.86&locale=en-us&ad-src=&numChild=0",
        "extensions": [
          "4 guests"
        ],
        "price": {
          "value": 2755,
          "currency": "USD"
        },
        "cost": {
          "value": 2755,
          "currency": "USD"
        },
        "price_with_tax": {
          "value": 3167,
          "currency": "USD"
        },
        "cost_with_tax": {
          "value": 3167,
          "currency": "USD"
        }
      },
      {
        "title": "Booking.com",
        "logo": "https://www.gstatic.com/travel-hotels/branding/icon_184.png",
        "link": "https://www.booking.com/searchresults.en.html?dest_id=599535&highlighted_hotels=599535&dest_type=hotel&checkin=2026-02-27&checkout=2026-02-28&group_adults=4&req_adults=4&show_room=59953509_336303630_4_0_0&lang=en&selected_currency=USD&exrt=1.00000000&ext_price_total=3166.86&ext_price_tax=411.86&xfc=USD&hca=m&group_children=0&req_children=0&&no_rooms=1&ts=1772143929&&utm_source=metagha&utm_medium=localuniversal&utm_campaign=US&utm_term=hotel-599535&utm_content=dev-desktop_los-1_bw-1_dow-Friday_defdate-0_room-0_gstadt-4_rateid-0_aud-0_gacid-_mcid-10_ppa-0_clrid-0_ad-0_gstkid-0_checkin-20260227_ppt-&aid=2127486&label=metagha-link-LUUS-hotel-599535_dev-desktop_los-1_bw-1_dow-Friday_defdate-0_room-0_gstadt-4_rateid-0_aud-0_gacid-_mcid-10_ppa-0_clrid-0_ad-0_gstkid-0_checkin-20260227_ppt-",
        "extensions": [
          "4 guests"
        ],
        "price": {
          "value": 2755,
          "currency": "USD"
        },
        "cost": {
          "value": 2755,
          "currency": "USD"
        },
        "price_with_tax": {
          "value": 3167,
          "currency": "USD"
        },
        "cost_with_tax": {
          "value": 3167,
          "currency": "USD"
        }
      }
    ],
    "reviews": {
      "rating": 4.7,
      "reviews_cnt": 1280,
      "reviews_by_stars": {
        "5 star": "1%"
      }
    }
  }
  ```
</ResponseExample>


# Occupancy (children)
Source: https://docs.brightdata.com/api-reference/serp/google-hotels/occupancy-children

Configure the Bright Data Google Hotels Occupancy (children) parameter to refine queries and return matching results as JSON or HTML. On port 44445.

```txt wrap theme={null}
https://www.google.com/travel/hotels?q=four+seasons+hotel+new+york+downtown&brd_occupancy=2,1,3
```

## Parameters

<ParamField type="string">
  The search query parameter. Specifies the keyword or phrase you want to search for on Google.
</ParamField>

<ParamField type="string">
  Number of guests to book a room for (maximum 6 guests)

  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)

  ```txt wrap theme={null}
  https://www.google.com/travel/hotels?q=four+seasons+hotel+new+york+downtown&brd_occupancy=2,1,3
  ```
</ParamField>

<RequestExample>
  ```shell cURL highlight={6} theme={null}
    curl -X POST https://api.brightdata.com/request \
    --header "Content-Type: application/json" \
    --header "Authorization: Bearer API_KEY" \
    --data '{
      "zone": "serp_api1",
      "url": "https://www.google.com/travel/hotels?q=four+seasons+hotel+new+york+downtown&brd_occupancy=2,1,3",
      "format": "raw"
    }'
  ```

  ```shell Native proxy highlight={4} theme={null}
  curl --proxy brd.superproxy.io:44445 \
    --proxy-user CUSTOMER_USERNAME:CUSTOMER_PASSWORD \
    --ssl-no-revoke \
    "https://www.google.com/travel/hotels?q=four+seasons+hotel+new+york+downtown&brd_occupancy=2,1,3"
  ```

  ```js Node.js highlight={10} theme={null}
  (async () => {
    const response = await fetch('https://api.brightdata.com/request', {
      method: 'POST',
      headers: {
        'Content-Type': 'application/json',
        'Authorization': 'Bearer API_KEY'
      },
      body: JSON.stringify({
        zone: 'serp_api1',
        url: 'https://www.google.com/travel/hotels?q=four+seasons+hotel+new+york+downtown&brd_occupancy=2,1,3',
        format: 'raw'
      })
    });
    
    const data = await response.text();
    console.log(data);
  })();
  ```

  ```python Python highlight={11} theme={null}
  import requests

  # API Configuration
  headers = {
      'Content-Type': 'application/json',
      'Authorization': 'Bearer API_KEY',
  }

  payload = {
      'zone': 'serp_api1',
      'url': 'https://www.google.com/travel/hotels?q=four+seasons+hotel+new+york+downtown&brd_occupancy=2,1,3',
      'format': 'raw'
  }

  # Make the request
  response = requests.post(
      'https://api.brightdata.com/request', 
      json=payload, 
      headers=headers
  )

  print(response.text)
  ```
</RequestExample>

<ResponseExample>
  ```json 200 highlight={8-14} theme={null}
  {
    "overview": {
      "type": "hotels",
      "title": "Four Seasons Hotel New York Downtown",
      "requested": {
        "start_date": "2026-02-27",
        "end_date": "2026-02-28",
        "occupancy": 4,
        "number_of_adults": 2,
        "children_ages": [
          [1],
          [3]
        ]
      },
      "available": true,
      "currency": "NOK",
      "coordinates": {
        "latitude": 40.712633,
        "longitude": -74.0092141
      },
      "address": "27 Barclay St, New York, NY 10007, United States",
      "phone": "+1 646-880-1999",
      "fid": "0x89c25a18e3553f8b:0x1337dae5edaabaa2"
    },
    "prices": [
      {
        "title": "Booking.com",
        "logo": "https://www.gstatic.com/travel-hotels/branding/icon_184.png",
        "link": "https://www.google.com/aclk?sa=l&ai=DChsSEwiU2KzSoviSAxWcEKIDHSotINgYACICCAEQBhoCbGU&co=1&ase=2&gclid=EAIaIQobChMIlNis0qL4kgMVnBCiAx0qLSDYEAoYASABEgIHBvD_BwE&category=acrcp_v1_48&sig=AOD64_2OB6sX_jfTYCYLnlSGgBhU8g-6Hw&adurl=",
        "price": {
          "value": 30258,
          "currency": "NOK"
        },
        "cost": {
          "value": 30258,
          "currency": "NOK"
        },
        "price_with_tax": {
          "value": 30258,
          "currency": "NOK"
        },
        "rooms": [
          {
            "title": "Liberty Suite",
            "pictures": [
              "https://lh3.googleusercontent.com/hrppk/ANjXD_zWFS0CdMRk4l9ZyD2WEhENua_lhcl151tKXdiyVEd3df2rCS_OT9oNo1z9ucWUFbu9qUa-2e94u9qYlLAEhP2kfhc2eC1XuqvQIkVleTmhE-GpsCtZ8W7Z6F9iEH-ksjoYLDTXJpWop7XJncxvLfeaoL8HQBbNlYfm9MGirHA9P__hgBbv44tBBEX614hpQmQ4vIL1OrS_55SiEINCqyNKvzxnZ4mSkSo"
            ],
            "link": "https://www.google.com/aclk?sa=l&ai=DChsSEwiU2KzSoviSAxWcEKIDHSotINgYACICCAEQBxoCbGU&co=1&ase=2&gclid=EAIaIQobChMIlNis0qL4kgMVnBCiAx0qLSDYEAoYASACEgIMKfD_BwE&category=acrcp_v1_48&sig=AOD64_2F6JXEmahBZuiRR9EpMxhKpGEH7Q&adurl=",
            "extensions": [
              "Suite 4 guests Suite"
            ],
            "price": {
              "value": 30258,
              "currency": "NOK"
            },
            "cost": {
              "value": 30258,
              "currency": "NOK"
            },
            "price_with_tax": {
              "value": 30258,
              "currency": "NOK"
            }
          }
        ]
      },
      {
        "title": "Agoda",
        "logo": "https://www.gstatic.com/travel-hotels/branding/b13642de-d476-41bd-8254-3edc2e567aa6.png",
        "link": "https://www.google.com/aclk?sa=l&ai=DChsSEwiU2KzSoviSAxWcEKIDHSotINgYACICCAEQARoCbGU&co=1&ase=2&gclid=EAIaIQobChMIlNis0qL4kgMVnBCiAx0qLSDYEAoYAiABEgKpjfD_BwE&category=acrcp_v1_48&sig=AOD64_2r-7jD4nxhXD_rMhMHuUypocs3CQ&adurl=",
        "price": {
          "value": 24078,
          "currency": "NOK"
        },
        "cost": {
          "value": 24078,
          "currency": "NOK"
        },
        "price_with_tax": {
          "value": 24078,
          "currency": "NOK"
        },
        "rooms": [
          {
            "title": "Cheapest combo rooms",
            "pictures": [
              "https://lh3.googleusercontent.com/hrppk/ANjXD_zFEWEw3P5LJ7DtpU5VZk-6S6290T43IYWTz_h9ZHdy2WeJ2vEnEa8_Iy3d0ZZkGaxyflvduFfgDrYPFqMBc4-m_i7PhfXt96n6-zCVUW9xJtMm9uVrPup4AiuB04E66RdOrEa3Ve8YGw6858gktvrq927g-DpC2dqXeQ"
            ],
            "link": "https://www.google.com/aclk?sa=l&ai=DChsSEwiU2KzSoviSAxWcEKIDHSotINgYACICCAEQAhoCbGU&co=1&ase=2&gclid=EAIaIQobChMIlNis0qL4kgMVnBCiAx0qLSDYEAoYAiACEgIE0fD_BwE&category=acrcp_v1_48&sig=AOD64_2MHXW3CYo5b3mUtWJvns6jar4Ytg&adurl=",
            "extensions": [
              "Suite 4 guests Suite"
            ],
            "price": {
              "value": 24078,
              "currency": "NOK"
            },
            "cost": {
              "value": 24078,
              "currency": "NOK"
            },
            "price_with_tax": {
              "value": 24078,
              "currency": "NOK"
            }
          }
        ]
      },
      {
        "title": "Bluepillow.com",
        "logo": "https://www.gstatic.com/travel-hotels/branding/c770e909-af04-45dd-8ad7-335bc5055826.png",
        "link": "https://www.google.com/aclk?sa=l&ai=DChsSEwiU2KzSoviSAxWcEKIDHSotINgYACICCAEQBBoCbGU&co=1&ase=2&gclid=EAIaIQobChMIlNis0qL4kgMVnBCiAx0qLSDYEAoYAyABEgK6BvD_BwE&category=acrcp_v1_48&sig=AOD64_3VR2PGCT6ktb9oob8TiCSCYOczrg&adurl=",
        "price": {
          "value": 30258,
          "currency": "NOK"
        },
        "cost": {
          "value": 30258,
          "currency": "NOK"
        },
        "price_with_tax": {
          "value": 30258,
          "currency": "NOK"
        }
      },
      {
        "title": "Booking.com",
        "logo": "https://www.gstatic.com/travel-hotels/branding/icon_184.png",
        "link": "https://www.booking.com/searchresults.en.html?dest_id=599535&highlighted_hotels=599535&dest_type=hotel&checkin=2026-02-27&checkout=2026-02-28&group_adults=2&req_adults=2&show_room=59953509_336303630_4_0_0&lang=en&selected_currency=NOK&exrt=9.55452061&ext_price_total=30257.85&ext_price_tax=3935.15&xfc=USD&hca=m&group_children=2&req_children=2&&age=1&req_age=1&age=3&req_age=3&no_rooms=1&ts=1772145314&edgtid=CWkbcNRxSWWiPwBRRdWNjA&efpc=J1WwCjFmuGov&utm_source=metagha&utm_medium=localuniversal&utm_campaign=NO&utm_term=hotel-599535&utm_content=dev-desktop_los-1_bw-1_dow-Friday_defdate-0_room-0_gstadt-2_rateid-public_aud-0_gacid-_mcid-10_ppa-0_clrid-0_ad-0_gstkid-2_checkin-20260227_ppt-&aid=2127633&label=metagha-link-LUNO-hotel-599535_dev-desktop_los-1_bw-1_dow-Friday_defdate-0_room-0_gstadt-2_rateid-public_aud-0_gacid-_mcid-10_ppa-0_clrid-0_ad-0_gstkid-2_checkin-20260227_ppt-",
        "extensions": [
          "4 guests"
        ],
        "price": {
          "value": 30258,
          "currency": "NOK"
        },
        "cost": {
          "value": 30258,
          "currency": "NOK"
        },
        "price_with_tax": {
          "value": 30258,
          "currency": "NOK"
        },
        "cost_with_tax": {
          "value": 30258,
          "currency": "NOK"
        }
      }
    ],
    "reviews": {
      "rating": 4.7,
      "reviews_cnt": 1280,
      "reviews_by_stars": {
        "5 star": "1%"
      }
    }
  }
  ```
</ResponseExample>


# Google Hotels parsed JSON
Source: https://docs.brightdata.com/api-reference/serp/google-hotels/parsed-json

Configure the Bright Data Google Hotels Google Hotels parsed JSON parameter to refine queries and return matching results as JSON or HTML. On port 44445.

```txt wrap theme={null}
https://www.google.com/travel/hotels?q=four+seasons+hotel+new+york+downtown&brd_json=json
```

## Parameters

<ParamField type="string">
  The search query parameter. Specifies the keyword or phrase you want to search for on Google.
</ParamField>

<ParamField type="string">
  Set the `brd_json` parameter to `json` to get the results in JSON format.

  ```txt wrap theme={null}
  https://www.google.com/maps/search/hotels+new+york/?brd_json=json
  ```

  | value            | description                                                                                                         |
  | ---------------- | ------------------------------------------------------------------------------------------------------------------- |
  | `html` (default) | Returns the standard HTML response from Google Maps.                                                                |
  | `json`           | Returns the search results in a structured JSON format, making it easier to parse and extract specific data points. |
</ParamField>

<RequestExample>
  ```shell cURL highlight={6} theme={null}
    curl -X POST https://api.brightdata.com/request \
    --header "Content-Type: application/json" \
    --header "Authorization: Bearer API_KEY" \
    --data '{
      "zone": "serp_api1",
      "url": "https://www.google.com/travel/hotels?q=four+seasons+hotel+new+york+downtown&brd_json=json",
      "format": "raw"
    }'
  ```

  ```shell Native proxy highlight={4} theme={null}
  curl --proxy brd.superproxy.io:44445 \
    --proxy-user CUSTOMER_USERNAME:CUSTOMER_PASSWORD \
    --ssl-no-revoke \
    "https://www.google.com/travel/hotels?q=four+seasons+hotel+new+york+downtown&brd_json=json"
  ```

  ```js Node.js highlight={10} theme={null}
  (async () => {
    const response = await fetch('https://api.brightdata.com/request', {
      method: 'POST',
      headers: {
        'Content-Type': 'application/json',
        'Authorization': 'Bearer API_KEY'
      },
      body: JSON.stringify({
        zone: 'serp_api1',
        url: 'https://www.google.com/travel/hotels?q=four+seasons+hotel+new+york+downtown&brd_json=json',
        format: 'raw'
      })
    });
    
    const data = await response.text();
    console.log(data);
  })();
  ```

  ```python Python highlight={11} theme={null}
  import requests

  # API Configuration
  headers = {
      'Content-Type': 'application/json',
      'Authorization': 'Bearer API_KEY',
  }

  payload = {
      'zone': 'serp_api1',
      'url': 'https://www.google.com/travel/hotels?q=four+seasons+hotel+new+york+downtown&brd_json=json',
      'format': 'raw'
  }

  # Make the request
  response = requests.post(
      'https://api.brightdata.com/request', 
      json=payload, 
      headers=headers
  )

  print(response.text)
  ```
</RequestExample>

<ResponseExample>
  ```json 200 theme={null}
  {
    "overview": {
      "type": "hotels",
      "title": "Four Seasons Hotel New York Downtown",
      "requested": {
        "start_date": "2026-03-06",
        "end_date": "2026-03-07",
        "occupancy": 2,
        "number_of_adults": 2
      },
      "available": true,
      "currency": "EUR",
      "coordinates": {
        "latitude": 40.712633,
        "longitude": -74.0092141
      },
      "address": "27 Barclay St, New York, NY 10007, United States",
      "phone": "+1 646-880-1999",
      "fid": "0x89c25a18e3553f8b:0x1337dae5edaabaa2"
    },
    "prices": [
      {
        "title": "Booking.com",
        "logo": "https://www.gstatic.com/travel-hotels/branding/icon_184.png",
        "link": "https://www.google.com/aclk?sa=l&ai=DChsSEwjk_sbYqPiSAxWECAYAHQhZFt4YACICCAEQExoCd3M&co=1&gclid=EAIaIQobChMI5P7G2Kj4kgMVhAgGAB0IWRbeEAoYASABEgLsBvD_BwE&sig=AOD64_0M7LSslBABYjrcuHz7043HM6Gk0A&adurl=",
        "price": {
          "value": 912,
          "currency": "EUR"
        },
        "cost": {
          "value": 912,
          "currency": "EUR"
        },
        "price_with_tax": {
          "value": 912,
          "currency": "EUR"
        },
        "rooms": [
          {
            "title": "Accessible Manhattan Room with King Bed",
            "pictures": [
              "https://lh3.googleusercontent.com/hrppk/ANjXD_ySiIEbCWYVgsWXAcT9P6GEaGc7OIZTLS03_DwOCK8IfvGbD_qIjGfPO3Eqe2ujdp686Jxaub2fQPluNbPelOp1hXNH1wTqhWRTw5yvK3qB_eDVgGDDZjnm-Y8JdMbrXO8mvoFY9XldhKGW0xzs8vHzPlebVX5jVqIXrZZrBft7bw1oadabdwy0BcKwTI-5__z5UG9mhDZhf8RBL3tbtlCP7ltZNmSUmDI"
            ],
            "link": "https://www.google.com/aclk?sa=l&ai=DChsSEwjk_sbYqPiSAxWECAYAHQhZFt4YACICCAEQFxoCd3M&co=1&gclid=EAIaIQobChMI5P7G2Kj4kgMVhAgGAB0IWRbeEAoYASAFEgJzD_D_BwE&sig=AOD64_2e1w7gdEW072SImBtdJlNKkhT9mg&adurl=",
            "extensions": [
              "1 king bed Free cancellation until Feb 27 Suite"
            ],
            "price": {
              "value": 912,
              "currency": "EUR"
            },
            "cost": {
              "value": 912,
              "currency": "EUR"
            },
            "price_with_tax": {
              "value": 912,
              "currency": "EUR"
            }
          },
          {
            "title": "Liberty Suite",
            "pictures": [
              "https://lh3.googleusercontent.com/hrppk/ANjXD_y-KJSTcZEDdQDB_yrI3W9M4YdQouODBZz7TiHG3QmpZ0OqLVH1OJBAZE0HVvZijUgVuHuZMs_mfmpjomUOTS8lqsUND0wquBfjTjHcaUg8n5X_8L3vRdpu48DbpVXIbsL1KelRaLGYW4onvYiIoxH7fOQHdwDF7ZAM0UYPuH2HW1iFj-WaCvMkKc3Depo1fg5GQ5a_BRyAo1kCPl3-XxL8vmd8KJT1xBg"
            ],
            "link": "https://www.google.com/aclk?sa=l&ai=DChsSEwjk_sbYqPiSAxWECAYAHQhZFt4YACICCAEQGBoCd3M&co=1&gclid=EAIaIQobChMI5P7G2Kj4kgMVhAgGAB0IWRbeEAoYASAGEgKPq_D_BwE&sig=AOD64_0J2K_vmz2GLmSU03WXOCMRhoBlHQ&adurl=",
            "extensions": [
              "Suite 3 guests Free cancellation until Feb 27 Suite"
            ],
            "price": {
              "value": 2378,
              "currency": "EUR"
            },
            "cost": {
              "value": 2378,
              "currency": "EUR"
            },
            "price_with_tax": {
              "value": 2378,
              "currency": "EUR"
            }
          },
          {
            "title": "Liberty Suite",
            "pictures": [
              "https://lh3.googleusercontent.com/hrppk/ANjXD_y-KJSTcZEDdQDB_yrI3W9M4YdQouODBZz7TiHG3QmpZ0OqLVH1OJBAZE0HVvZijUgVuHuZMs_mfmpjomUOTS8lqsUND0wquBfjTjHcaUg8n5X_8L3vRdpu48DbpVXIbsL1KelRaLGYW4onvYiIoxH7fOQHdwDF7ZAM0UYPuH2HW1iFj-WaCvMkKc3Depo1fg5GQ5a_BRyAo1kCPl3-XxL8vmd8KJT1xBg"
            ],
            "link": "https://www.google.com/aclk?sa=l&ai=DChsSEwjk_sbYqPiSAxWECAYAHQhZFt4YACICCAEQGRoCd3M&co=1&gclid=EAIaIQobChMI5P7G2Kj4kgMVhAgGAB0IWRbeEAoYASAHEgLD0vD_BwE&sig=AOD64_3S34MlYvIksxmVX7QUZTbYSlmV-g&adurl=",
            "extensions": [
              "Suite 4 guests Free cancellation until Feb 27 Suite"
            ],
            "price": {
              "value": 2475,
              "currency": "EUR"
            },
            "cost": {
              "value": 2475,
              "currency": "EUR"
            },
            "price_with_tax": {
              "value": 2475,
              "currency": "EUR"
            }
          }
        ]
      },
      {
        "title": "Expedia.de",
        "logo": "https://www.gstatic.com/travel-hotels/branding/ac238c97-1652-4830-8da8-bb8d8883af88.png",
        "link": "https://www.google.com/aclk?sa=l&ai=DChsSEwjk_sbYqPiSAxWECAYAHQhZFt4YACICCAEQARoCd3M&co=1&gclid=EAIaIQobChMI5P7G2Kj4kgMVhAgGAB0IWRbeEAoYAiABEgJB9_D_BwE&sig=AOD64_1kUnuX6YdD_AOE7R0KHjsKNHzHtA&adurl=",
        "price": {
          "value": 911,
          "currency": "EUR"
        },
        "cost": {
          "value": 911,
          "currency": "EUR"
        },
        "price_with_tax": {
          "value": 911,
          "currency": "EUR"
        },
        "rooms": [
          {
            "title": "Accessible Manhattan Room with King Bed",
            "pictures": [
              "https://lh3.googleusercontent.com/hrppk/ANjXD_zYFNVKMsbaLNMZ-gh_Vbck_EkR8kV2OMjj3OtbYpSHjv2_txZgd66NC_oCCHrpeS9cogHDn_k13nqZzaZFFSkCGm0EHjsEAI0GI55NP4BBX0xBq3_Uji01c2RQdjeRwUWYKQw8avPS9WzOhaV1-bo2nq-ut_Yev3lE"
            ],
            "link": "https://www.google.com/aclk?sa=l&ai=DChsSEwjk_sbYqPiSAxWECAYAHQhZFt4YACICCAEQAhoCd3M&co=1&gclid=EAIaIQobChMI5P7G2Kj4kgMVhAgGAB0IWRbeEAoYAiACEgIYZPD_BwE&sig=AOD64_31Yv_SBh0jcVaEnpTo_sphgYd8zQ&adurl=",
            "extensions": [
              "1 king bed Free cancellation until Feb 28"
            ],
            "price": {
              "value": 911,
              "currency": "EUR"
            },
            "cost": {
              "value": 911,
              "currency": "EUR"
            },
            "price_with_tax": {
              "value": 911,
              "currency": "EUR"
            }
          },
          {
            "title": "Manhattan Room with Double Beds",
            "pictures": [
              "https://lh3.googleusercontent.com/hrppk/ANjXD_yeBfSgeyblSeisek8ZI4YEHLCIbbXrCJxgyCdZUamkH5oV5DdlJoKUakDV53Z7p-BDS0E8rJ62m6QZMrFqObi9meM30tA-IA6SocR49mzpLbxLgLGE-3-aodZ0vOxTfpmcX440cUjJEe1Ngv3iSw2LSIyNpQLwWUtZ"
            ],
            "link": "https://www.google.com/aclk?sa=l&ai=DChsSEwjk_sbYqPiSAxWECAYAHQhZFt4YACICCAEQAxoCd3M&co=1&gclid=EAIaIQobChMI5P7G2Kj4kgMVhAgGAB0IWRbeEAoYAiADEgIyB_D_BwE&sig=AOD64_0aALGynTChUuX8X4JGHzzFv63uEA&adurl=",
            "extensions": [
              "2 double beds Free cancellation until Feb 28"
            ],
            "price": {
              "value": 911,
              "currency": "EUR"
            },
            "cost": {
              "value": 911,
              "currency": "EUR"
            },
            "price_with_tax": {
              "value": 911,
              "currency": "EUR"
            }
          },
          {
            "title": "Manhattan Room with king bed",
            "pictures": [
              "https://lh3.googleusercontent.com/hrppk/ANjXD_zYFNVKMsbaLNMZ-gh_Vbck_EkR8kV2OMjj3OtbYpSHjv2_txZgd66NC_oCCHrpeS9cogHDn_k13nqZzaZFFSkCGm0EHjsEAI0GI55NP4BBX0xBq3_Uji01c2RQdjeRwUWYKQw8avPS9WzOhaV1-bo2nq-ut_Yev3lE"
            ],
            "link": "https://www.google.com/aclk?sa=l&ai=DChsSEwjk_sbYqPiSAxWECAYAHQhZFt4YACICCAEQBBoCd3M&co=1&gclid=EAIaIQobChMI5P7G2Kj4kgMVhAgGAB0IWRbeEAoYAiAEEgIyi_D_BwE&sig=AOD64_1WCiGga8oG95r2jdwkVTbeYeey6w&adurl=",
            "extensions": [
              "1 king bed Free cancellation until Feb 28"
            ],
            "price": {
              "value": 911,
              "currency": "EUR"
            },
            "cost": {
              "value": 911,
              "currency": "EUR"
            },
            "price_with_tax": {
              "value": 911,
              "currency": "EUR"
            }
          },
          {
            "title": "Accessible SoHo Premier King",
            "pictures": [
              "https://lh3.googleusercontent.com/hrppk/ANjXD_wds_0O4X_fvybSRinVrg9UstYEgU4qlouU4v-lNTqXPUsLuEGHK_CkIuB034caQMwQ19oFDkJOXz9wRrpy2gUDf3Egip9BJS2H3OgYoesDW7QwJb_47iLzahGhE99F8YjZI-n30IIO4j4Lbfcx1oSboErOa9DVzJg"
            ],
            "link": "https://www.google.com/aclk?sa=l&ai=DChsSEwjk_sbYqPiSAxWECAYAHQhZFt4YACICCAEQBRoCd3M&co=1&gclid=EAIaIQobChMI5P7G2Kj4kgMVhAgGAB0IWRbeEAoYAiAFEgLrFPD_BwE&sig=AOD64_1QEZ4cu5k9E6lseKW11ciAm-J3Hw&adurl=",
            "extensions": [
              "1 king bed Free cancellation until Feb 28"
            ],
            "price": {
              "value": 1008,
              "currency": "EUR"
            },
            "cost": {
              "value": 1008,
              "currency": "EUR"
            },
            "price_with_tax": {
              "value": 1008,
              "currency": "EUR"
            }
          },
          {
            "title": "SoHo Premier King",
            "pictures": [
              "https://lh3.googleusercontent.com/hrppk/ANjXD_x6Z4f55TyGgXgPaK-luUCFyHuULMAS-fnt2cgI_EjYzlVobLpV_HI_PaCiSXVq4GJt7GYYLs7gCr3Wj__EOYfq-W6hB87lXPWt24y5G_yEfds77WaqbxUytFauHjPoQYygsMPkPfJ2uhm751bN0EKKLGimw0u0n8_t"
            ],
            "link": "https://www.google.com/aclk?sa=l&ai=DChsSEwjk_sbYqPiSAxWECAYAHQhZFt4YACICCAEQBhoCd3M&co=1&gclid=EAIaIQobChMI5P7G2Kj4kgMVhAgGAB0IWRbeEAoYAiAGEgK67vD_BwE&sig=AOD64_3xtc8VbYzfm2iEB2RXKgqK9wikUQ&adurl=",
            "extensions": [
              "1 king bed Free cancellation until Feb 28"
            ],
            "price": {
              "value": 1008,
              "currency": "EUR"
            },
            "cost": {
              "value": 1008,
              "currency": "EUR"
            },
            "price_with_tax": {
              "value": 1008,
              "currency": "EUR"
            }
          },
          {
            "title": "SoHo Premier Double",
            "pictures": [
              "https://lh3.googleusercontent.com/hrppk/ANjXD_yv0AxYLP4aAQwN6J8XDZbtkYY1_0Nvgv2ZYCVK0dBpzNv3fyOhcZ5TokalUILoZ3r3_zQCPCeiwcYq64hCMNh58fXCXCVgKapWEA2_oGjJ0J5SG5BF2ui0ZLXtk7VtHRKqqc3k-WtT17r0KAJGpqnXX6tKm6gHYbRz"
            ],
            "link": "https://www.google.com/aclk?sa=l&ai=DChsSEwjk_sbYqPiSAxWECAYAHQhZFt4YACICCAEQBxoCd3M&co=1&gclid=EAIaIQobChMI5P7G2Kj4kgMVhAgGAB0IWRbeEAoYAiAHEgKDn_D_BwE&sig=AOD64_1iuHdiaZaL4jNVIKcfH6RhD7xnDA&adurl=",
            "extensions": [
              "1 double bed Free cancellation until Feb 28"
            ],
            "price": {
              "value": 1042,
              "currency": "EUR"
            },
            "cost": {
              "value": 1042,
              "currency": "EUR"
            },
            "price_with_tax": {
              "value": 1042,
              "currency": "EUR"
            }
          },
          {
            "title": "Hudson Corner King",
            "pictures": [
              "https://lh3.googleusercontent.com/hrppk/ANjXD_xh7ZruI7-cODN5bzF1IWAG3PEIQADDGgw0sWtDDRk-TbV4EPtEVYDEJewJgMRtl6Zejine24V66DGiU5FlqCq-EMgShWDmqhjLyVs9FERHWG0QxGnFxW7LN7-HGl4UrF7-s8XcAj7YDUQ5xjlaAX-v836WgUq0svU"
            ],
            "link": "https://www.google.com/aclk?sa=l&ai=DChsSEwjk_sbYqPiSAxWECAYAHQhZFt4YACICCAEQCBoCd3M&co=1&gclid=EAIaIQobChMI5P7G2Kj4kgMVhAgGAB0IWRbeEAoYAiAIEgJFSfD_BwE&sig=AOD64_3YXLgnD1EZ2At_PacM0-00UUNKUg&adurl=",
            "extensions": [
              "1 king bed Free cancellation until Feb 28"
            ],
            "price": {
              "value": 1105,
              "currency": "EUR"
            },
            "cost": {
              "value": 1105,
              "currency": "EUR"
            },
            "price_with_tax": {
              "value": 1105,
              "currency": "EUR"
            }
          },
          {
            "title": "Hudson Corner Double",
            "pictures": [
              "https://lh3.googleusercontent.com/hrppk/ANjXD_yeBfSgeyblSeisek8ZI4YEHLCIbbXrCJxgyCdZUamkH5oV5DdlJoKUakDV53Z7p-BDS0E8rJ62m6QZMrFqObi9meM30tA-IA6SocR49mzpLbxLgLGE-3-aodZ0vOxTfpmcX440cUjJEe1Ngv3iSw2LSIyNpQLwWUtZ"
            ],
            "link": "https://www.google.com/aclk?sa=l&ai=DChsSEwjk_sbYqPiSAxWECAYAHQhZFt4YACICCAEQCRoCd3M&co=1&gclid=EAIaIQobChMI5P7G2Kj4kgMVhAgGAB0IWRbeEAoYAiAJEgJfmfD_BwE&sig=AOD64_1DTRq-qsUqhPdcqeYLHg35iQxssg&adurl=",
            "extensions": [
              "1 double bed Free cancellation until Feb 28"
            ],
            "price": {
              "value": 1139,
              "currency": "EUR"
            },
            "cost": {
              "value": 1139,
              "currency": "EUR"
            },
            "price_with_tax": {
              "value": 1139,
              "currency": "EUR"
            }
          },
          {
            "title": "Accessible Liberty Suite",
            "pictures": [
              "https://lh3.googleusercontent.com/hrppk/ANjXD_y1iwF2gynru2fHktFEUS_8KfNtswHyO__zLmmGruUe4Ex1i3-2bce9c4ZsKDg_FUp82xUBdJK6t2v_2LrUVEYneXqLJ_XzfxddpaZh0GK7zS7WDWI2M7HCeVS-wBrT2vpSFn7exa2XIrZ0TfHXz6MHq1IlxpCExlE"
            ],
            "link": "https://www.google.com/aclk?sa=l&ai=DChsSEwjk_sbYqPiSAxWECAYAHQhZFt4YACICCAEQChoCd3M&co=1&gclid=EAIaIQobChMI5P7G2Kj4kgMVhAgGAB0IWRbeEAoYAiAKEgII2_D_BwE&sig=AOD64_17Z2jIYpTclspi0DhcDa9qSX5jxg&adurl=",
            "extensions": [
              "Suite Free cancellation until Feb 28 Suite"
            ],
            "price": {
              "value": 2277,
              "currency": "EUR"
            },
            "cost": {
              "value": 2277,
              "currency": "EUR"
            },
            "price_with_tax": {
              "value": 2277,
              "currency": "EUR"
            }
          },
          {
            "title": "Liberty Suite",
            "pictures": [
              "https://lh3.googleusercontent.com/hrppk/ANjXD_x0PMpt7VzEy6A83OymvL5l9KvaUZ0rKRlPgI6PsNAzDGi6YSr7mFOEw18HHxDv_YswU22MN7u6e33RiFrmuC8vFWme_o-Mx4il9gSTGbOQGiKBhloGENHQHdRJO041_DbIaeWEkvvh4SI7ghnbeMUXrlekMq1DGb16"
            ],
            "link": "https://www.google.com/aclk?sa=l&ai=DChsSEwjk_sbYqPiSAxWECAYAHQhZFt4YACICCAEQCxoCd3M&co=1&gclid=EAIaIQobChMI5P7G2Kj4kgMVhAgGAB0IWRbeEAoYAiALEgKY9_D_BwE&sig=AOD64_3W6o-NofXoJKH-U9PQOfT3GF-QsA&adurl=",
            "extensions": [
              "Suite Free cancellation until Feb 28 Suite"
            ],
            "price": {
              "value": 2277,
              "currency": "EUR"
            },
            "cost": {
              "value": 2277,
              "currency": "EUR"
            },
            "price_with_tax": {
              "value": 2277,
              "currency": "EUR"
            }
          },
          {
            "title": "Accessible Oculus Suite",
            "link": "https://www.google.com/aclk?sa=l&ai=DChsSEwjk_sbYqPiSAxWECAYAHQhZFt4YACICCAEQDBoCd3M&co=1&gclid=EAIaIQobChMI5P7G2Kj4kgMVhAgGAB0IWRbeEAoYAiAMEgJKQPD_BwE&sig=AOD64_1A2Bj9M8g_-exQBUM2i7-TbfOKwg&adurl=",
            "extensions": [
              "Suite Free cancellation until Feb 28 Suite"
            ],
            "price": {
              "value": 3278,
              "currency": "EUR"
            },
            "cost": {
              "value": 3278,
              "currency": "EUR"
            },
            "price_with_tax": {
              "value": 3278,
              "currency": "EUR"
            }
          },
          {
            "title": "Oculus Suite",
            "pictures": [
              "https://lh3.googleusercontent.com/hrppk/ANjXD_wUo6BPQW7nrkfgpTzJi_nQA8xpSw312DpP20wbOYdpEfOmvds9VLU7L_ibu_895NqpjU5kLib0DfsImWRp7v19NjwaSBrUJ6TUGTFABEDUUB7vOgVyyP0W54B-SH86pi457VRBGPvK7ykAT93UU9whEXLD7fMb9jLf"
            ],
            "link": "https://www.google.com/aclk?sa=l&ai=DChsSEwjk_sbYqPiSAxWECAYAHQhZFt4YACICCAEQDRoCd3M&co=1&gclid=EAIaIQobChMI5P7G2Kj4kgMVhAgGAB0IWRbeEAoYAiANEgI97PD_BwE&sig=AOD64_3BbzIs9pAmbIiAOwG-ebVejU-r4A&adurl=",
            "extensions": [
              "Suite Free cancellation until Feb 28 Suite"
            ],
            "price": {
              "value": 3278,
              "currency": "EUR"
            },
            "cost": {
              "value": 3278,
              "currency": "EUR"
            },
            "price_with_tax": {
              "value": 3278,
              "currency": "EUR"
            }
          },
          {
            "title": "Suite, 1 King Bed, Non Smoking (Gotham)",
            "pictures": [
              "https://lh3.googleusercontent.com/hrppk/ANjXD_wa3n-lr_eOJ0aPzXtn0Ebx66AFv4U7oXLWeRazx5Mx2o6WFFtgTe3EqZEunp1KCnoJm_wvXijwQ2Myh3MWvnXHxGeOfrUrPAcH16zjLtwHUkWaD5QHJID78QeK4jwRmpjx-VH9LUNu1xj7yJce1r__ZvucnvWD0Zc"
            ],
            "link": "https://www.google.com/aclk?sa=l&ai=DChsSEwjk_sbYqPiSAxWECAYAHQhZFt4YACICCAEQDhoCd3M&co=1&gclid=EAIaIQobChMI5P7G2Kj4kgMVhAgGAB0IWRbeEAoYAiAOEgJgyfD_BwE&sig=AOD64_0DhmqCAFUP4PJ897doHPRo-DoXUw&adurl=",
            "extensions": [
              "1 king bed Free cancellation until Feb 28 Suite"
            ],
            "price": {
              "value": 3763,
              "currency": "EUR"
            },
            "cost": {
              "value": 3763,
              "currency": "EUR"
            },
            "price_with_tax": {
              "value": 3763,
              "currency": "EUR"
            }
          },
          {
            "title": "Suite, 1 King Bed, Non Smoking, Terrace (Gotham)",
            "pictures": [
              "https://lh3.googleusercontent.com/hrppk/ANjXD_wa3n-lr_eOJ0aPzXtn0Ebx66AFv4U7oXLWeRazx5Mx2o6WFFtgTe3EqZEunp1KCnoJm_wvXijwQ2Myh3MWvnXHxGeOfrUrPAcH16zjLtwHUkWaD5QHJID78QeK4jwRmpjx-VH9LUNu1xj7yJce1r__ZvucnvWD0Zc"
            ],
            "link": "https://www.google.com/aclk?sa=l&ai=DChsSEwjk_sbYqPiSAxWECAYAHQhZFt4YACICCAEQDxoCd3M&co=1&gclid=EAIaIQobChMI5P7G2Kj4kgMVhAgGAB0IWRbeEAoYAiAPEgLxivD_BwE&sig=AOD64_36lE-tVjg-zTEHTsq2iii5UCC-mA&adurl=",
            "extensions": [
              "1 king bed Free cancellation until Feb 28 Suite"
            ],
            "price": {
              "value": 3958,
              "currency": "EUR"
            },
            "cost": {
              "value": 3958,
              "currency": "EUR"
            },
            "price_with_tax": {
              "value": 3958,
              "currency": "EUR"
            }
          }
        ]
      },
      {
        "title": "trivago.de",
        "logo": "https://www.gstatic.com/travel-hotels/branding/1922649917165881388.png",
        "link": "https://www.google.com/aclk?sa=l&ai=DChsSEwjk_sbYqPiSAxWECAYAHQhZFt4YACICCAEQGxoCd3M&co=1&gclid=EAIaIQobChMI5P7G2Kj4kgMVhAgGAB0IWRbeEAoYAyABEgInWPD_BwE&sig=AOD64_39CkAu5QatiC1HqSk9jCdelh03mw&adurl=",
        "price": {
          "value": 911,
          "currency": "EUR"
        },
        "cost": {
          "value": 911,
          "currency": "EUR"
        },
        "price_with_tax": {
          "value": 911,
          "currency": "EUR"
        }
      },
      {
        "title": "Tripadvisor.com",
        "logo": "https://www.gstatic.com/travel-hotels/branding/7993073966338005995.png",
        "link": "https://www.google.com/aclk?sa=l&ai=DChsSEwjk_sbYqPiSAxWECAYAHQhZFt4YACICCAEQERoCd3M&co=1&gclid=EAIaIQobChMI5P7G2Kj4kgMVhAgGAB0IWRbeEAoYBCABEgLrBfD_BwE&sig=AOD64_1DG7E3wUl5ZY2x3EFZRgwHazLXXw&adurl=",
        "price": {
          "value": 912,
          "currency": "EUR"
        },
        "cost": {
          "value": 912,
          "currency": "EUR"
        },
        "price_with_tax": {
          "value": 912,
          "currency": "EUR"
        }
      },
      {
        "title": "Expedia.de",
        "logo": "https://www.gstatic.com/travel-hotels/branding/ac238c97-1652-4830-8da8-bb8d8883af88.png",
        "link": "https://www.expedia.de/Hotel-Search?selected=15438428&startDate=2026-03-06&endDate=2026-03-07&MDPCID=DE.META.HPA.HOTEL-ORGANIC-desktop.HOTEL&MDPDTL=HTL.15438428.20260306.20260307.DDT.8.CID..AUDID..RRID.bex_eu_desktop&adults=2&children=&mctc=10&ct=hotel&mpg=EUR&mpf=881.94&mpj=115.95&mpr=0.00&mpl=EUR&exp_pg=google&langid=2057&ad=2&tp=&utm_source=google&utm_medium=cpc&utm_term=15438428&utm_content=localuniversal&utm_campaign=HotelAds&rateplanid=381382188&mpm=24&mpn=201555591&mpo=EC&mpp=1",
        "price": {
          "value": 882,
          "currency": "EUR"
        },
        "cost": {
          "value": 882,
          "currency": "EUR"
        },
        "price_with_tax": {
          "value": 882,
          "currency": "EUR"
        },
        "cost_with_tax": {
          "value": 882,
          "currency": "EUR"
        }
      },
      {
        "title": "Vio.com",
        "logo": "https://www.gstatic.com/travel-hotels/branding/297592521974050080.png",
        "link": "https://deals.vio.com/?sig=73aca13c7f952d2641c156f3e69125e1eb497c325f122828ee5aa8797168b9a12d32303331333438363233&turl=https%3A%2F%2Fwww.vio.com%2FHotel%2FSearch%3FcheckIn%3D2026-03-06%26checkOut%3D2026-03-07%26currency%3DEUR%26forceCurrencyChange%3D1%26lang%3Den%26forceLanguageChange%3D1%26rooms%3D2%3A%26utm_source%3Dgha%26utm_medium%3Dcpc%26hotelId%3D3021724%26userCountry%3DDE%26profile%3Dr2d2m73kn8%26preferredRate%3D877.78%26label%3Dsrc%253Dgha%2526cltype%253Dhotel%2526datype%253Ddefault%2526gsite%253Dlocaluniversal%2526vf%253D0%2526ucountry%253DDE%2526udevice%253Ddesktop%2526hotel%253D3021724%2526day%253D06%2526month%253D03%2526year%253D2026%2526los%253D1%2526price%253D877.78%2526currency%253DEUR%2526cid%253D%2526listid%253D%2526rateid%253DZZ_D%2526closerateid%253D%2526promo%253D0%2526isPrivateRate%253D0%2526isAudienceUser%253D0%2526isPaidClick%253D0%2526%26cp%3DJe1RbssPiD0CgtNYlhfM0Vja2J2bxiPlYPNBiACOKb4juINQhcIq4mL-_S42PLVARD-vwUgi2kqA1VTRA",
        "price": {
          "value": 878,
          "currency": "EUR"
        },
        "cost": {
          "value": 878,
          "currency": "EUR"
        },
        "price_with_tax": {
          "value": 878,
          "currency": "EUR"
        },
        "cost_with_tax": {
          "value": 878,
          "currency": "EUR"
        }
      }
    ],
    "reviews": {
      "rating": 4.7,
      "reviews_cnt": 1280,
      "reviews_by_stars": {
        "5 star": "1%"
      }
    }
  }
  ```
</ResponseExample>


# Google Hotels text search
Source: https://docs.brightdata.com/api-reference/serp/google-hotels/text-search

Configure the Bright Data Google Hotels Google Hotels text search parameter to refine queries and return matching results as JSON or HTML. On port 44445.

```txt wrap theme={null}
https://www.google.com/travel/hotels?q=four+seasons+hotel+new+york+downtown
```

## Parameters

<ParamField type="string">
  The search query parameter. Specifies the keyword or phrase you want to search for on Google.

  ```txt wrap theme={null}
  https://www.google.com/travel/hotels?q=four+seasons+hotel+new+york+downtown
  ```
</ParamField>

<RequestExample>
  ```shell cURL highlight={6} theme={null}
    curl -X POST https://api.brightdata.com/request \
    --header "Content-Type: application/json" \
    --header "Authorization: Bearer API_KEY" \
    --data '{
      "zone": "serp_api1",
      "url": "https://www.google.com/travel/hotels?q=four+seasons+hotel+new+york+downtown",
      "format": "raw"
    }'
  ```

  ```shell Native proxy highlight={4} theme={null}
  curl --proxy brd.superproxy.io:44445 \
    --proxy-user CUSTOMER_USERNAME:CUSTOMER_PASSWORD \
    --ssl-no-revoke \
    "https://www.google.com/travel/hotels?q=four+seasons+hotel+new+york+downtown"
  ```

  ```js Node.js highlight={10} theme={null}
  (async () => {
    const response = await fetch('https://api.brightdata.com/request', {
      method: 'POST',
      headers: {
        'Content-Type': 'application/json',
        'Authorization': 'Bearer API_KEY'
      },
      body: JSON.stringify({
        zone: 'serp_api1',
        url: 'https://www.google.com/travel/hotels?q=four+seasons+hotel+new+york+downtown',
        format: 'raw'
      })
    });
    
    const data = await response.text();
    console.log(data);
  })();
  ```

  ```python Python highlight={11} theme={null}
  import requests

  # API Configuration
  headers = {
      'Content-Type': 'application/json',
      'Authorization': 'Bearer API_KEY',
  }

  payload = {
      'zone': 'serp_api1',
      'url': 'https://www.google.com/travel/hotels?q=four+seasons+hotel+new+york+downtown',
      'format': 'raw'
  }

  # Make the request
  response = requests.post(
      'https://api.brightdata.com/request', 
      json=payload, 
      headers=headers
  )

  print(response.text)
  ```
</RequestExample>

<ResponseExample>
  ```json 200 theme={null}
  {
    "overview": {
      "type": "hotels",
      "title": "Four Seasons Hotel New York Downtown",
      "requested": {
        "start_date": "2026-03-06",
        "end_date": "2026-03-07",
        "occupancy": 2,
        "number_of_adults": 2
      },
      "available": true,
      "currency": "USD",
      "coordinates": {
        "latitude": 40.712633,
        "longitude": -74.0092141
      },
      "address": "27 Barclay St, New York, NY 10007",
      "phone": "(646) 880-1999",
      "fid": "0x89c25a18e3553f8b:0x1337dae5edaabaa2"
    },
    "prices": [
      {
        "title": "Booking.com",
        "logo": "https://www.gstatic.com/travel-hotels/branding/icon_184.png",
        "link": "https://www.google.com/aclk?sa=l&ai=DChsSEwi93-zwnPiSAxXyBwYAHWE7FUMYACICCAEQGRoCd3M&co=1&ase=2&gclid=EAIaIQobChMIvd_s8Jz4kgMV8gcGAB1hOxVDEAoYASABEgKkQPD_BwE&cid=CAASuwHkaL1egiUkcaDPYynZOvPq_V1EjqjtDp-9Z46FQkOyBpyfhHc-NUCl9yq3u7QyCAXmMfG7WgM0eJL-m6ffngDwqurgSL9-kC6NPHZDup2xReT7bDxa38ybswFsaU4B_G16xz9HcBlehtT01ctyXGnH2nDuDzIOE0RQGHNLuEE8c-jZ7vZkqreNfIZPxM-8E2BBF9MBAV42LwdqX2MhImKoMRZiXJ2W1Kk1zYceNVQugE8uJgtuFPUBLOmW&category=acrcp_v1_48&sig=AOD64_3WZxVwX7M7SdQk8bv9GVdk2wUCRA&adurl=",
        "price": {
          "value": 935,
          "currency": "USD"
        },
        "cost": {
          "value": 1076,
          "currency": "USD"
        },
        "price_with_tax": {
          "value": 1076,
          "currency": "USD"
        },
        "rooms": [
          {
            "title": "Manhattan Room with Double Beds",
            "pictures": [
              "https://lh3.googleusercontent.com/hrppk/ANjXD_xnOTripjyZxILxkGgM1cYmQNCrIY1AgC49RisFNimj2Fshwx2QGIQcEqMKtGUPMMgiTEEzO4iBsB7TbE47tH61of_7vI_YBVxRVepXz1HrN4BiNtYi4Ah55Rj-ClCQiYnxdsj2Tpfv5eCDvZZSbZZLfUosmTOb06MxTGypuYoqum1sM7IVOBEd69gXyVDP61aNCFq1_pfxvUA6hH4zIOqsaudDn5pkTw"
            ],
            "link": "https://www.google.com/aclk?sa=l&ai=DChsSEwi93-zwnPiSAxXyBwYAHWE7FUMYACICCAEQHBoCd3M&co=1&ase=2&gclid=EAIaIQobChMIvd_s8Jz4kgMV8gcGAB1hOxVDEAoYASAEEgLuCvD_BwE&cid=CAASuwHkaL1egiUkcaDPYynZOvPq_V1EjqjtDp-9Z46FQkOyBpyfhHc-NUCl9yq3u7QyCAXmMfG7WgM0eJL-m6ffngDwqurgSL9-kC6NPHZDup2xReT7bDxa38ybswFsaU4B_G16xz9HcBlehtT01ctyXGnH2nDuDzIOE0RQGHNLuEE8c-jZ7vZkqreNfIZPxM-8E2BBF9MBAV42LwdqX2MhImKoMRZiXJ2W1Kk1zYceNVQugE8uJgtuFPUBLOmW&category=acrcp_v1_48&sig=AOD64_0cXRg9LtSvb94BUoXNgy8J04C5QQ&adurl=",
            "extensions": [
              "2 double beds Free cancellation until Feb 27"
            ],
            "price": {
              "value": 935,
              "currency": "USD"
            },
            "cost": {
              "value": 1076,
              "currency": "USD"
            },
            "price_with_tax": {
              "value": 1076,
              "currency": "USD"
            }
          },
          {
            "title": "Liberty Suite",
            "pictures": [
              "https://lh3.googleusercontent.com/hrppk/ANjXD_zWFS0CdMRk4l9ZyD2WEhENua_lhcl151tKXdiyVEd3df2rCS_OT9oNo1z9ucWUFbu9qUa-2e94u9qYlLAEhP2kfhc2eC1XuqvQIkVleTmhE-GpsCtZ8W7Z6F9iEH-ksjoYLDTXJpWop7XJncxvLfeaoL8HQBbNlYfm9MGirHA9P__hgBbv44tBBEX614hpQmQ4vIL1OrS_55SiEINCqyNKvzxnZ4mSkSo"
            ],
            "link": "https://www.google.com/aclk?sa=l&ai=DChsSEwi93-zwnPiSAxXyBwYAHWE7FUMYACICCAEQHRoCd3M&co=1&ase=2&gclid=EAIaIQobChMIvd_s8Jz4kgMV8gcGAB1hOxVDEAoYASAFEgLqhPD_BwE&cid=CAASuwHkaL1egiUkcaDPYynZOvPq_V1EjqjtDp-9Z46FQkOyBpyfhHc-NUCl9yq3u7QyCAXmMfG7WgM0eJL-m6ffngDwqurgSL9-kC6NPHZDup2xReT7bDxa38ybswFsaU4B_G16xz9HcBlehtT01ctyXGnH2nDuDzIOE0RQGHNLuEE8c-jZ7vZkqreNfIZPxM-8E2BBF9MBAV42LwdqX2MhImKoMRZiXJ2W1Kk1zYceNVQugE8uJgtuFPUBLOmW&category=acrcp_v1_48&sig=AOD64_1ar70DInUs8eU0WRh2f8RzL1QKww&adurl=",
            "extensions": [
              "Suite 3 guests Free cancellation until Feb 27 Suite"
            ],
            "price": {
              "value": 2440,
              "currency": "USD"
            },
            "cost": {
              "value": 2805,
              "currency": "USD"
            },
            "price_with_tax": {
              "value": 2805,
              "currency": "USD"
            }
          },
          {
            "title": "Liberty Suite",
            "pictures": [
              "https://lh3.googleusercontent.com/hrppk/ANjXD_zWFS0CdMRk4l9ZyD2WEhENua_lhcl151tKXdiyVEd3df2rCS_OT9oNo1z9ucWUFbu9qUa-2e94u9qYlLAEhP2kfhc2eC1XuqvQIkVleTmhE-GpsCtZ8W7Z6F9iEH-ksjoYLDTXJpWop7XJncxvLfeaoL8HQBbNlYfm9MGirHA9P__hgBbv44tBBEX614hpQmQ4vIL1OrS_55SiEINCqyNKvzxnZ4mSkSo"
            ],
            "link": "https://www.google.com/aclk?sa=l&ai=DChsSEwi93-zwnPiSAxXyBwYAHWE7FUMYACICCAEQHhoCd3M&co=1&ase=2&gclid=EAIaIQobChMIvd_s8Jz4kgMV8gcGAB1hOxVDEAoYASAGEgKKYfD_BwE&cid=CAASuwHkaL1egiUkcaDPYynZOvPq_V1EjqjtDp-9Z46FQkOyBpyfhHc-NUCl9yq3u7QyCAXmMfG7WgM0eJL-m6ffngDwqurgSL9-kC6NPHZDup2xReT7bDxa38ybswFsaU4B_G16xz9HcBlehtT01ctyXGnH2nDuDzIOE0RQGHNLuEE8c-jZ7vZkqreNfIZPxM-8E2BBF9MBAV42LwdqX2MhImKoMRZiXJ2W1Kk1zYceNVQugE8uJgtuFPUBLOmW&category=acrcp_v1_48&sig=AOD64_3Tw83cHkve-fjPnlHEu96gRaGYag&adurl=",
            "extensions": [
              "Suite 4 guests Free cancellation until Feb 27 Suite"
            ],
            "price": {
              "value": 2540,
              "currency": "USD"
            },
            "cost": {
              "value": 2920,
              "currency": "USD"
            },
            "price_with_tax": {
              "value": 2920,
              "currency": "USD"
            }
          }
        ]
      },
      {
        "title": "Hotels.com",
        "logo": "https://www.gstatic.com/travel-hotels/branding/f358dd45-ebd1-4af8-988d-d53154b73975.png",
        "link": "https://www.google.com/aclk?sa=l&ai=DChsSEwi93-zwnPiSAxXyBwYAHWE7FUMYACICCAEQIBoCd3M&co=1&ase=2&gclid=EAIaIQobChMIvd_s8Jz4kgMV8gcGAB1hOxVDEAoYAiABEgLFyPD_BwE&cid=CAASuwHkaL1egiUkcaDPYynZOvPq_V1EjqjtDp-9Z46FQkOyBpyfhHc-NUCl9yq3u7QyCAXmMfG7WgM0eJL-m6ffngDwqurgSL9-kC6NPHZDup2xReT7bDxa38ybswFsaU4B_G16xz9HcBlehtT01ctyXGnH2nDuDzIOE0RQGHNLuEE8c-jZ7vZkqreNfIZPxM-8E2BBF9MBAV42LwdqX2MhImKoMRZiXJ2W1Kk1zYceNVQugE8uJgtuFPUBLOmW&category=acrcp_v1_48&sig=AOD64_0Uc0x_tn6Dpzw1hNIA3bvO-V8XeQ&adurl=",
        "price": {
          "value": 935,
          "currency": "USD"
        },
        "cost": {
          "value": 1076,
          "currency": "USD"
        },
        "price_with_tax": {
          "value": 1076,
          "currency": "USD"
        },
        "rooms": [
          {
            "title": "Accessible Manhattan Room with King Bed",
            "pictures": [
              "https://lh3.googleusercontent.com/hrppk/ANjXD_zirGqnNUV3bUkVZ6Yq4QzaxzMTFw8S7BL88YG2xqf5qarRKkr50s-PfillUJkRvSl7KQqXwV9-bVLeYtBRigMpPPejfmFNDLX3qXcjydhC3sIHQL6X9_KcnnQtD_1b8kFPT_gkxt3Bjoif3Alols11Pq0yWqW6dkvZ"
            ],
            "link": "https://www.google.com/aclk?sa=l&ai=DChsSEwi93-zwnPiSAxXyBwYAHWE7FUMYACICCAEQIRoCd3M&co=1&ase=2&gclid=EAIaIQobChMIvd_s8Jz4kgMV8gcGAB1hOxVDEAoYAiACEgLJMfD_BwE&cid=CAASuwHkaL1egiUkcaDPYynZOvPq_V1EjqjtDp-9Z46FQkOyBpyfhHc-NUCl9yq3u7QyCAXmMfG7WgM0eJL-m6ffngDwqurgSL9-kC6NPHZDup2xReT7bDxa38ybswFsaU4B_G16xz9HcBlehtT01ctyXGnH2nDuDzIOE0RQGHNLuEE8c-jZ7vZkqreNfIZPxM-8E2BBF9MBAV42LwdqX2MhImKoMRZiXJ2W1Kk1zYceNVQugE8uJgtuFPUBLOmW&category=acrcp_v1_48&sig=AOD64_1-IaI3Wc2iZiz04F2g0iO4omJcxw&adurl=",
            "extensions": [
              "1 king bed Free cancellation until Feb 28"
            ],
            "price": {
              "value": 935,
              "currency": "USD"
            },
            "cost": {
              "value": 1076,
              "currency": "USD"
            },
            "price_with_tax": {
              "value": 1076,
              "currency": "USD"
            }
          },
          {
            "title": "Manhattan Room with Double Beds",
            "pictures": [
              "https://lh3.googleusercontent.com/hrppk/ANjXD_zBdES1oKIM8aMTINPz_t2xtu2KC-uSe_oOKzsl9YklwJYFM1GwO-qFi8swCpTQ_KV9p47-tkiSad2to48uKImdUBLBvt6mhp6Hs8Q18Gxe3ss20foBlRPuXa_2vk47r8GRUWFd23wok1KV0TIGM9U2NVIgJ0V74PeZ"
            ],
            "link": "https://www.google.com/aclk?sa=l&ai=DChsSEwi93-zwnPiSAxXyBwYAHWE7FUMYACICCAEQIhoCd3M&co=1&ase=2&gclid=EAIaIQobChMIvd_s8Jz4kgMV8gcGAB1hOxVDEAoYAiADEgJLvPD_BwE&cid=CAASuwHkaL1egiUkcaDPYynZOvPq_V1EjqjtDp-9Z46FQkOyBpyfhHc-NUCl9yq3u7QyCAXmMfG7WgM0eJL-m6ffngDwqurgSL9-kC6NPHZDup2xReT7bDxa38ybswFsaU4B_G16xz9HcBlehtT01ctyXGnH2nDuDzIOE0RQGHNLuEE8c-jZ7vZkqreNfIZPxM-8E2BBF9MBAV42LwdqX2MhImKoMRZiXJ2W1Kk1zYceNVQugE8uJgtuFPUBLOmW&category=acrcp_v1_48&sig=AOD64_1l9E4tRWWXqZXljR31RIHW1CjIRg&adurl=",
            "extensions": [
              "2 double beds Free cancellation until Feb 28"
            ],
            "price": {
              "value": 935,
              "currency": "USD"
            },
            "cost": {
              "value": 1076,
              "currency": "USD"
            },
            "price_with_tax": {
              "value": 1076,
              "currency": "USD"
            }
          },
          {
            "title": "Manhattan Room with king bed",
            "pictures": [
              "https://lh3.googleusercontent.com/hrppk/ANjXD_zirGqnNUV3bUkVZ6Yq4QzaxzMTFw8S7BL88YG2xqf5qarRKkr50s-PfillUJkRvSl7KQqXwV9-bVLeYtBRigMpPPejfmFNDLX3qXcjydhC3sIHQL6X9_KcnnQtD_1b8kFPT_gkxt3Bjoif3Alols11Pq0yWqW6dkvZ"
            ],
            "link": "https://www.google.com/aclk?sa=l&ai=DChsSEwi93-zwnPiSAxXyBwYAHWE7FUMYACICCAEQIxoCd3M&co=1&ase=2&gclid=EAIaIQobChMIvd_s8Jz4kgMV8gcGAB1hOxVDEAoYAiAEEgL_UvD_BwE&cid=CAASuwHkaL1egiUkcaDPYynZOvPq_V1EjqjtDp-9Z46FQkOyBpyfhHc-NUCl9yq3u7QyCAXmMfG7WgM0eJL-m6ffngDwqurgSL9-kC6NPHZDup2xReT7bDxa38ybswFsaU4B_G16xz9HcBlehtT01ctyXGnH2nDuDzIOE0RQGHNLuEE8c-jZ7vZkqreNfIZPxM-8E2BBF9MBAV42LwdqX2MhImKoMRZiXJ2W1Kk1zYceNVQugE8uJgtuFPUBLOmW&category=acrcp_v1_48&sig=AOD64_2kR-kPDdNnb1lcBUNkpM5s-Q_yLw&adurl=",
            "extensions": [
              "1 king bed Free cancellation until Feb 28"
            ],
            "price": {
              "value": 935,
              "currency": "USD"
            },
            "cost": {
              "value": 1076,
              "currency": "USD"
            },
            "price_with_tax": {
              "value": 1076,
              "currency": "USD"
            }
          },
          {
            "title": "Accessible SoHo Premier King",
            "pictures": [
              "https://lh3.googleusercontent.com/hrppk/ANjXD_xfIleTKUi_ePsxGkSstGASzo99qNFBpB94rAAtcEI1C-ZLD4XATuPdh4hGG4RUio3DvonDRyOo7dGZScl55LMBJ7ZEgdijCjGdglXAmtBG3qRZGZdrm-Uggx1OjUAheXtRIDPT0atuWFPccAbkfddjQ7vp6ud3UM4"
            ],
            "link": "https://www.google.com/aclk?sa=l&ai=DChsSEwi93-zwnPiSAxXyBwYAHWE7FUMYACICCAEQJBoCd3M&co=1&ase=2&gclid=EAIaIQobChMIvd_s8Jz4kgMV8gcGAB1hOxVDEAoYAiAFEgKVwPD_BwE&cid=CAASuwHkaL1egiUkcaDPYynZOvPq_V1EjqjtDp-9Z46FQkOyBpyfhHc-NUCl9yq3u7QyCAXmMfG7WgM0eJL-m6ffngDwqurgSL9-kC6NPHZDup2xReT7bDxa38ybswFsaU4B_G16xz9HcBlehtT01ctyXGnH2nDuDzIOE0RQGHNLuEE8c-jZ7vZkqreNfIZPxM-8E2BBF9MBAV42LwdqX2MhImKoMRZiXJ2W1Kk1zYceNVQugE8uJgtuFPUBLOmW&category=acrcp_v1_48&sig=AOD64_0ZrJRz7IXgFt5CcI54GIb2V_aOEA&adurl=",
            "extensions": [
              "1 king bed Free cancellation until Feb 28"
            ],
            "price": {
              "value": 1035,
              "currency": "USD"
            },
            "cost": {
              "value": 1191,
              "currency": "USD"
            },
            "price_with_tax": {
              "value": 1191,
              "currency": "USD"
            }
          },
          {
            "title": "SoHo Premier King",
            "pictures": [
              "https://lh3.googleusercontent.com/hrppk/ANjXD_wuMW97qyG0dgi5Gj5Nob9SzWQ170RVssqu5Fios_swsegU93lsHLoiTo_9hPSttkpklB0QBmU3t8wNPCQgylOL-NJIgsqbtdxI9d0gUE0XKG75M-LzpdyK3M_cTzH8nIl8lL0Sg42N7pxz2ygDzoP-qsR7LH3Hj-q4"
            ],
            "link": "https://www.google.com/aclk?sa=l&ai=DChsSEwi93-zwnPiSAxXyBwYAHWE7FUMYACICCAEQJRoCd3M&co=1&ase=2&gclid=EAIaIQobChMIvd_s8Jz4kgMV8gcGAB1hOxVDEAoYAiAGEgLyS_D_BwE&cid=CAASuwHkaL1egiUkcaDPYynZOvPq_V1EjqjtDp-9Z46FQkOyBpyfhHc-NUCl9yq3u7QyCAXmMfG7WgM0eJL-m6ffngDwqurgSL9-kC6NPHZDup2xReT7bDxa38ybswFsaU4B_G16xz9HcBlehtT01ctyXGnH2nDuDzIOE0RQGHNLuEE8c-jZ7vZkqreNfIZPxM-8E2BBF9MBAV42LwdqX2MhImKoMRZiXJ2W1Kk1zYceNVQugE8uJgtuFPUBLOmW&category=acrcp_v1_48&sig=AOD64_0iD3vQeRSxwkBcCu0F0NEdbpHPBQ&adurl=",
            "extensions": [
              "1 king bed Free cancellation until Feb 28"
            ],
            "price": {
              "value": 1035,
              "currency": "USD"
            },
            "cost": {
              "value": 1191,
              "currency": "USD"
            },
            "price_with_tax": {
              "value": 1191,
              "currency": "USD"
            }
          },
          {
            "title": "SoHo Premier Double",
            "pictures": [
              "https://lh3.googleusercontent.com/hrppk/ANjXD_yWbtP4vz4gyFOxx-uO3-5Qz-n7oPrXCYz5CjsOYpGwfd4vSy9B9DmddpQ72H1LjiPhk20d5mt6c1lijronkH7FfBq_eJpzEc5CHGZ7teq5zP3sV-Qv2c7VwXXrPvClVawgmkgAWf80sXLQrVzreBLAZ8lA7k1Ud8YY"
            ],
            "link": "https://www.google.com/aclk?sa=l&ai=DChsSEwi93-zwnPiSAxXyBwYAHWE7FUMYACICCAEQJhoCd3M&co=1&ase=2&gclid=EAIaIQobChMIvd_s8Jz4kgMV8gcGAB1hOxVDEAoYAiAHEgJD9_D_BwE&cid=CAASuwHkaL1egiUkcaDPYynZOvPq_V1EjqjtDp-9Z46FQkOyBpyfhHc-NUCl9yq3u7QyCAXmMfG7WgM0eJL-m6ffngDwqurgSL9-kC6NPHZDup2xReT7bDxa38ybswFsaU4B_G16xz9HcBlehtT01ctyXGnH2nDuDzIOE0RQGHNLuEE8c-jZ7vZkqreNfIZPxM-8E2BBF9MBAV42LwdqX2MhImKoMRZiXJ2W1Kk1zYceNVQugE8uJgtuFPUBLOmW&category=acrcp_v1_48&sig=AOD64_1-qvLSoH3qtZl1Jzkpvr6iRQtDug&adurl=",
            "extensions": [
              "1 double bed Free cancellation until Feb 28"
            ],
            "price": {
              "value": 1070,
              "currency": "USD"
            },
            "cost": {
              "value": 1231,
              "currency": "USD"
            },
            "price_with_tax": {
              "value": 1231,
              "currency": "USD"
            }
          },
          {
            "title": "Hudson Corner King",
            "pictures": [
              "https://lh3.googleusercontent.com/hrppk/ANjXD_xh7ZruI7-cODN5bzF1IWAG3PEIQADDGgw0sWtDDRk-TbV4EPtEVYDEJewJgMRtl6Zejine24V66DGiU5FlqCq-EMgShWDmqhjLyVs9FERHWG0QxGnFxW7LN7-HGl4UrF7-s8XcAj7YDUQ5xjlaAX-v836WgUq0svU"
            ],
            "link": "https://www.google.com/aclk?sa=l&ai=DChsSEwi93-zwnPiSAxXyBwYAHWE7FUMYACICCAEQJxoCd3M&co=1&ase=2&gclid=EAIaIQobChMIvd_s8Jz4kgMV8gcGAB1hOxVDEAoYAiAIEgK2a_D_BwE&cid=CAASuwHkaL1egiUkcaDPYynZOvPq_V1EjqjtDp-9Z46FQkOyBpyfhHc-NUCl9yq3u7QyCAXmMfG7WgM0eJL-m6ffngDwqurgSL9-kC6NPHZDup2xReT7bDxa38ybswFsaU4B_G16xz9HcBlehtT01ctyXGnH2nDuDzIOE0RQGHNLuEE8c-jZ7vZkqreNfIZPxM-8E2BBF9MBAV42LwdqX2MhImKoMRZiXJ2W1Kk1zYceNVQugE8uJgtuFPUBLOmW&category=acrcp_v1_48&sig=AOD64_1zUSId1nUwCQq7yh4XLKuB1Ohivg&adurl=",
            "extensions": [
              "1 king bed Free cancellation until Feb 28"
            ],
            "price": {
              "value": 1135,
              "currency": "USD"
            },
            "cost": {
              "value": 1306,
              "currency": "USD"
            },
            "price_with_tax": {
              "value": 1306,
              "currency": "USD"
            }
          },
          {
            "title": "Hudson Corner Double",
            "pictures": [
              "https://lh3.googleusercontent.com/hrppk/ANjXD_zBdES1oKIM8aMTINPz_t2xtu2KC-uSe_oOKzsl9YklwJYFM1GwO-qFi8swCpTQ_KV9p47-tkiSad2to48uKImdUBLBvt6mhp6Hs8Q18Gxe3ss20foBlRPuXa_2vk47r8GRUWFd23wok1KV0TIGM9U2NVIgJ0V74PeZ"
            ],
            "link": "https://www.google.com/aclk?sa=l&ai=DChsSEwi93-zwnPiSAxXyBwYAHWE7FUMYACICCAEQKBoCd3M&co=1&ase=2&gclid=EAIaIQobChMIvd_s8Jz4kgMV8gcGAB1hOxVDEAoYAiAJEgJde_D_BwE&cid=CAASuwHkaL1egiUkcaDPYynZOvPq_V1EjqjtDp-9Z46FQkOyBpyfhHc-NUCl9yq3u7QyCAXmMfG7WgM0eJL-m6ffngDwqurgSL9-kC6NPHZDup2xReT7bDxa38ybswFsaU4B_G16xz9HcBlehtT01ctyXGnH2nDuDzIOE0RQGHNLuEE8c-jZ7vZkqreNfIZPxM-8E2BBF9MBAV42LwdqX2MhImKoMRZiXJ2W1Kk1zYceNVQugE8uJgtuFPUBLOmW&category=acrcp_v1_48&sig=AOD64_22y9VcsfNpoGEERdBgj2VqhrAopg&adurl=",
            "extensions": [
              "1 double bed Free cancellation until Feb 28"
            ],
            "price": {
              "value": 1170,
              "currency": "USD"
            },
            "cost": {
              "value": 1346,
              "currency": "USD"
            },
            "price_with_tax": {
              "value": 1346,
              "currency": "USD"
            }
          },
          {
            "title": "Accessible Liberty Suite",
            "pictures": [
              "https://lh3.googleusercontent.com/hrppk/ANjXD_ww5DsjCN4YmZZyFdZwwPcaACASJul2NHBc33CJI6PmL57ABgizbEjzHfF-mdnm5fxu6htw4H8-uYg1_Hp4qVlRby0MErfZfndCcURjMKhkg1-H-L9fnoCjiJ7eBmFoggT1Yxbr1qxMmBTH5lSeBZGEPtjpj86vT0g"
            ],
            "link": "https://www.google.com/aclk?sa=l&ai=DChsSEwi93-zwnPiSAxXyBwYAHWE7FUMYACICCAEQKRoCd3M&co=1&ase=2&gclid=EAIaIQobChMIvd_s8Jz4kgMV8gcGAB1hOxVDEAoYAiAKEgJvsfD_BwE&cid=CAASuwHkaL1egiUkcaDPYynZOvPq_V1EjqjtDp-9Z46FQkOyBpyfhHc-NUCl9yq3u7QyCAXmMfG7WgM0eJL-m6ffngDwqurgSL9-kC6NPHZDup2xReT7bDxa38ybswFsaU4B_G16xz9HcBlehtT01ctyXGnH2nDuDzIOE0RQGHNLuEE8c-jZ7vZkqreNfIZPxM-8E2BBF9MBAV42LwdqX2MhImKoMRZiXJ2W1Kk1zYceNVQugE8uJgtuFPUBLOmW&category=acrcp_v1_48&sig=AOD64_2U0x0rvKUK5FsuuDInhoRPaeosTQ&adurl=",
            "extensions": [
              "Suite Free cancellation until Feb 28 Suite"
            ],
            "price": {
              "value": 2340,
              "currency": "USD"
            },
            "cost": {
              "value": 2691,
              "currency": "USD"
            },
            "price_with_tax": {
              "value": 2691,
              "currency": "USD"
            }
          },
          {
            "title": "Liberty Suite",
            "pictures": [
              "https://lh3.googleusercontent.com/hrppk/ANjXD_wzZm0OmUCedgu3fTY7PUUPLbLCV5zcQfVDJeHlIBCvk_avmplnbY5FYHLBDZKrSL5xDNRYIn5kBNf-pTzMl2LYIG88MTku07E2_2upUCMIEmY5ZBgeEaPLdgYIcJi5ZTmfLknhkRwQxfF_ZBA8n0mDClKJ3zKe-XUZ"
            ],
            "link": "https://www.google.com/aclk?sa=l&ai=DChsSEwi93-zwnPiSAxXyBwYAHWE7FUMYACICCAEQKhoCd3M&co=1&ase=2&gclid=EAIaIQobChMIvd_s8Jz4kgMV8gcGAB1hOxVDEAoYAiALEgIye_D_BwE&cid=CAASuwHkaL1egiUkcaDPYynZOvPq_V1EjqjtDp-9Z46FQkOyBpyfhHc-NUCl9yq3u7QyCAXmMfG7WgM0eJL-m6ffngDwqurgSL9-kC6NPHZDup2xReT7bDxa38ybswFsaU4B_G16xz9HcBlehtT01ctyXGnH2nDuDzIOE0RQGHNLuEE8c-jZ7vZkqreNfIZPxM-8E2BBF9MBAV42LwdqX2MhImKoMRZiXJ2W1Kk1zYceNVQugE8uJgtuFPUBLOmW&category=acrcp_v1_48&sig=AOD64_34I7FZ_rEBXGJThi3NhYqDuWYI3A&adurl=",
            "extensions": [
              "Suite Free cancellation until Feb 28 Suite"
            ],
            "price": {
              "value": 2340,
              "currency": "USD"
            },
            "cost": {
              "value": 2691,
              "currency": "USD"
            },
            "price_with_tax": {
              "value": 2691,
              "currency": "USD"
            }
          },
          {
            "title": "Accessible Oculus Suite",
            "link": "https://www.google.com/aclk?sa=l&ai=DChsSEwi93-zwnPiSAxXyBwYAHWE7FUMYACICCAEQKxoCd3M&co=1&ase=2&gclid=EAIaIQobChMIvd_s8Jz4kgMV8gcGAB1hOxVDEAoYAiAMEgIFE_D_BwE&cid=CAASuwHkaL1egiUkcaDPYynZOvPq_V1EjqjtDp-9Z46FQkOyBpyfhHc-NUCl9yq3u7QyCAXmMfG7WgM0eJL-m6ffngDwqurgSL9-kC6NPHZDup2xReT7bDxa38ybswFsaU4B_G16xz9HcBlehtT01ctyXGnH2nDuDzIOE0RQGHNLuEE8c-jZ7vZkqreNfIZPxM-8E2BBF9MBAV42LwdqX2MhImKoMRZiXJ2W1Kk1zYceNVQugE8uJgtuFPUBLOmW&category=acrcp_v1_48&sig=AOD64_3ti3aEDih8ZhM7xCfbWZFN0AcKQg&adurl=",
            "extensions": [
              "Suite Free cancellation until Feb 28 Suite"
            ],
            "price": {
              "value": 3370,
              "currency": "USD"
            },
            "cost": {
              "value": 3873,
              "currency": "USD"
            },
            "price_with_tax": {
              "value": 3873,
              "currency": "USD"
            }
          },
          {
            "title": "Oculus Suite",
            "pictures": [
              "https://lh3.googleusercontent.com/hrppk/ANjXD_y4BiOX0ESx2hQ7R1AbK80n3kIom2QrPE77qx5wQvFyLUGAipd0VVxl3bzztdN3u3e0coud9niym1jM0s4UhuNUWRzj21SpdUKFbMiimNpy6v_iUqVvWpe-e3YUNId8uEmwiUehwTzNU9zmegcaboD_rrmY0mNts-tK"
            ],
            "link": "https://www.google.com/aclk?sa=l&ai=DChsSEwi93-zwnPiSAxXyBwYAHWE7FUMYACICCAEQLBoCd3M&co=1&ase=2&gclid=EAIaIQobChMIvd_s8Jz4kgMV8gcGAB1hOxVDEAoYAiANEgLNU_D_BwE&cid=CAASuwHkaL1egiUkcaDPYynZOvPq_V1EjqjtDp-9Z46FQkOyBpyfhHc-NUCl9yq3u7QyCAXmMfG7WgM0eJL-m6ffngDwqurgSL9-kC6NPHZDup2xReT7bDxa38ybswFsaU4B_G16xz9HcBlehtT01ctyXGnH2nDuDzIOE0RQGHNLuEE8c-jZ7vZkqreNfIZPxM-8E2BBF9MBAV42LwdqX2MhImKoMRZiXJ2W1Kk1zYceNVQugE8uJgtuFPUBLOmW&category=acrcp_v1_48&sig=AOD64_0LHnRl4WLtqnzsap0aQqFfKg1BbQ&adurl=",
            "extensions": [
              "Suite Free cancellation until Feb 28 Suite"
            ],
            "price": {
              "value": 3370,
              "currency": "USD"
            },
            "cost": {
              "value": 3873,
              "currency": "USD"
            },
            "price_with_tax": {
              "value": 3873,
              "currency": "USD"
            }
          },
          {
            "title": "Suite, 1 King Bed, Non Smoking (Gotham)",
            "pictures": [
              "https://lh3.googleusercontent.com/hrppk/ANjXD_wa3n-lr_eOJ0aPzXtn0Ebx66AFv4U7oXLWeRazx5Mx2o6WFFtgTe3EqZEunp1KCnoJm_wvXijwQ2Myh3MWvnXHxGeOfrUrPAcH16zjLtwHUkWaD5QHJID78QeK4jwRmpjx-VH9LUNu1xj7yJce1r__ZvucnvWD0Zc"
            ],
            "link": "https://www.google.com/aclk?sa=l&ai=DChsSEwi93-zwnPiSAxXyBwYAHWE7FUMYACICCAEQLRoCd3M&co=1&ase=2&gclid=EAIaIQobChMIvd_s8Jz4kgMV8gcGAB1hOxVDEAoYAiAOEgJKvvD_BwE&cid=CAASuwHkaL1egiUkcaDPYynZOvPq_V1EjqjtDp-9Z46FQkOyBpyfhHc-NUCl9yq3u7QyCAXmMfG7WgM0eJL-m6ffngDwqurgSL9-kC6NPHZDup2xReT7bDxa38ybswFsaU4B_G16xz9HcBlehtT01ctyXGnH2nDuDzIOE0RQGHNLuEE8c-jZ7vZkqreNfIZPxM-8E2BBF9MBAV42LwdqX2MhImKoMRZiXJ2W1Kk1zYceNVQugE8uJgtuFPUBLOmW&category=acrcp_v1_48&sig=AOD64_2S_jbXgWlzoU8K7yog2CEpOluqOg&adurl=",
            "extensions": [
              "1 king bed Free cancellation until Feb 28 Suite"
            ],
            "price": {
              "value": 3870,
              "currency": "USD"
            },
            "cost": {
              "value": 4446,
              "currency": "USD"
            },
            "price_with_tax": {
              "value": 4446,
              "currency": "USD"
            }
          },
          {
            "title": "Suite, 1 King Bed, Non Smoking, Terrace (Gotham)",
            "pictures": [
              "https://lh3.googleusercontent.com/hrppk/ANjXD_wa3n-lr_eOJ0aPzXtn0Ebx66AFv4U7oXLWeRazx5Mx2o6WFFtgTe3EqZEunp1KCnoJm_wvXijwQ2Myh3MWvnXHxGeOfrUrPAcH16zjLtwHUkWaD5QHJID78QeK4jwRmpjx-VH9LUNu1xj7yJce1r__ZvucnvWD0Zc"
            ],
            "link": "https://www.google.com/aclk?sa=l&ai=DChsSEwi93-zwnPiSAxXyBwYAHWE7FUMYACICCAEQLhoCd3M&co=1&ase=2&gclid=EAIaIQobChMIvd_s8Jz4kgMV8gcGAB1hOxVDEAoYAiAPEgKOW_D_BwE&cid=CAASuwHkaL1egiUkcaDPYynZOvPq_V1EjqjtDp-9Z46FQkOyBpyfhHc-NUCl9yq3u7QyCAXmMfG7WgM0eJL-m6ffngDwqurgSL9-kC6NPHZDup2xReT7bDxa38ybswFsaU4B_G16xz9HcBlehtT01ctyXGnH2nDuDzIOE0RQGHNLuEE8c-jZ7vZkqreNfIZPxM-8E2BBF9MBAV42LwdqX2MhImKoMRZiXJ2W1Kk1zYceNVQugE8uJgtuFPUBLOmW&category=acrcp_v1_48&sig=AOD64_2C1L5MfDLw9PVpTdVQNSYIu3EKvA&adurl=",
            "extensions": [
              "1 king bed Free cancellation until Feb 28 Suite"
            ],
            "price": {
              "value": 4070,
              "currency": "USD"
            },
            "cost": {
              "value": 4676,
              "currency": "USD"
            },
            "price_with_tax": {
              "value": 4676,
              "currency": "USD"
            }
          }
        ]
      }
    ],
    "reviews": {
      "rating": 4.7,
      "reviews_cnt": 1280,
      "reviews_by_stars": {
        "5 star": "1%"
      }
    }
  }
  ```
</ResponseExample>


# Google Lens async request
Source: https://docs.brightdata.com/api-reference/serp/google-lens/async

Use the Bright Data Google Lens async endpoint (31 languages). Submit a request, poll the job ID and retrieve results as JSON with 200 OK on success.

```txt wrap theme={null}
https://lens.google.com/uploadbyurl?url=https%3A%2F%2Fwww.youtube.com%2Fimg%2Fdesktop%2Fyt_1200.png
```

<ParamField type="boolean">
  Set `async=true` in the request URL to enable asynchronous requests.

  ```txt wrap theme={null}
  https://api.brightdata.com/request?async=true
  ```
</ParamField>

## Parameters

<ParamField type="query">
  URL of image you want to search

  ```txt wrap theme={null}
  https://lens.google.com/uploadbyurl?url=https%3A%2F%2Fwww.youtube.com%2Fimg%2Fdesktop%2Fyt_1200.png
  ```
</ParamField>

<RequestExample>
  ```shell cURL highlight={1} theme={null}
    curl -X POST https://api.brightdata.com/request?async=true \
    --header "Content-Type: application/json" \
    --header "Authorization: Bearer API_KEY" \
    --data '{
      "zone": "serp_api1",
      "url": "https://lens.google.com/uploadbyurl?url=https%3A%2F%2Fwww.youtube.com%2Fimg%2Fdesktop%2Fyt_1200.png",
      "format": "raw"
    }'
  ```

  ```shell Native proxy highlight={4} theme={null}
  curl -i --silent --compressed \
    -H "Content-Type: application/json"
    -H "Authorization: Bearer API_KEY" \
    -d $'{"country":"us","query":{"q":"pizza"}}'
    "https://api.brightdata.com/serp/req?customer=CUSTOMER_USERNAME&zone=ZONE_NAME"
  ```

  ```js Node.js highlight={2} theme={null}
  (async () => {
    const response = await fetch('https://api.brightdata.com/request?async=true', {
      method: 'POST',
      headers: {
        'Content-Type': 'application/json',
        'Authorization': 'Bearer API_KEY'
      },
      body: JSON.stringify({
        zone: 'serp_api1',
        url: 'https://lens.google.com/uploadbyurl?url=https%3A%2F%2Fwww.youtube.com%2Fimg%2Fdesktop%2Fyt_1200.png',
        format: 'raw'
      })
    });
    
    const data = await response.text();
    console.log(data);
  })();
  ```

  ```python Python highlight={17} theme={null}
  import requests

  # API Configuration
  headers = {
      'Content-Type': 'application/json',
      'Authorization': 'Bearer API_KEY',
  }

  payload = {
      'zone': 'serp_api1',
      'url': 'https://lens.google.com/uploadbyurl?url=https%3A%2F%2Fwww.youtube.com%2Fimg%2Fdesktop%2Fyt_1200.png',
      'format': 'raw'
  }

  # Make the request
  response = requests.post(
      'https://api.brightdata.com/request?async=true', 
      json=payload, 
      headers=headers
  )

  print(response.text)
  ```
</RequestExample>

<ResponseExample>
  ```json 200 theme={null}
  {
    "general": {
      "language": "en",
      "mode": "search",
      "type": "all"
    },
    "tabs": [
      {
        "name": "AI Mode",
        "link": "https://www.google.com/search?sca_esv=5f09d3ac69940124&lns_surface=26&biw=1051&bih=903&hl=en&gl=US&udm=50&vsrid=CKyfsYXfqLqsXBACGAEiJDY2YWJkOGFmLTNjOGQtNGQwNi1hMDdlLTU4YWRmNzhlMGI5NTIGIgJlaCgOOM7hleir95ID&vsint=CAIqDAoCCAcSAggKGAEgATojChYNAAAAPxUAAAA_HQAAgD8lAACAPzABEIAIGIAIJQAAgD8&lns_mode=un&source=lns.web.gsbubu&vsdim=1024,1024&gsessionid=X5sybacr9AH2FFW5u55jWMKsjzMaGy26mNmVV5pQr_H0M5pBEc7j0Q&lsessionid=KHO-TDOe8LGxANpz2bra8gWY4yp0Cd_aUyg0SL1ygC5KScvNoK5hgg&fbs=ADc_l-Yv0YTTwuvIVYRVntg99Yl4C2siJayzZyC50sFnWwRH6ow_bxUxJgqfeyXucYwXL8BodgQvcQKf4r6af6eJrUBEJPcPla2xArZ4O2zHdIqqQ1YVgeUF-eZ8YfKEFkJDuGVjK7bY&q=&aep=1&ntc=1&sa=X&ved=2ahUKEwiu8dLoq_eSAxU_0AIHHdfmKpcQ2J8OegQIDxAD"
      },
      {
        "name": "All",
        "type": "all",
        "selected": true
      },
      {
        "name": "Exact matches",
        "type": "exact_matches",
        "link": "https://www.google.com/search?sca_esv=5f09d3ac69940124&lns_surface=26&biw=1051&bih=903&hl=en&gl=US&udm=48&vsrid=CKyfsYXfqLqsXBACGAEiJDY2YWJkOGFmLTNjOGQtNGQwNi1hMDdlLTU4YWRmNzhlMGI5NTIGIgJlaCgOOM7hleir95ID&vsint=CAIqDAoCCAcSAggKGAEgATojChYNAAAAPxUAAAA_HQAAgD8lAACAPzABEIAIGIAIJQAAgD8&lns_mode=un&source=lns.web.gsbubu&vsdim=1024,1024&gsessionid=X5sybacr9AH2FFW5u55jWMKsjzMaGy26mNmVV5pQr_H0M5pBEc7j0Q&lsessionid=KHO-TDOe8LGxANpz2bra8gWY4yp0Cd_aUyg0SL1ygC5KScvNoK5hgg&vsrid=CKyfsYXfqLqsXBACGAEiJGRjZWVkMGFmLTg2ZDAtNDA5MS04YTg0LWI1OWU2Y2Q2ZWNlOTIGIgJlaCgOOM7hleir95IDUAA&q=&sa=X&ved=2ahUKEwiu8dLoq_eSAxU_0AIHHdfmKpcQs6gLegQIEhAB"
      },
      {
        "name": "Visual matches",
        "type": "visual_matches",
        "link": "https://www.google.com/search?sca_esv=5f09d3ac69940124&lns_surface=26&biw=1051&bih=903&hl=en&gl=US&udm=44&vsrid=CKyfsYXfqLqsXBACGAEiJDY2YWJkOGFmLTNjOGQtNGQwNi1hMDdlLTU4YWRmNzhlMGI5NTIGIgJlaCgOOM7hleir95ID&vsint=CAIqDAoCCAcSAggKGAEgATojChYNAAAAPxUAAAA_HQAAgD8lAACAPzABEIAIGIAIJQAAgD8&lns_mode=un&source=lns.web.gsbubu&vsdim=1024,1024&gsessionid=X5sybacr9AH2FFW5u55jWMKsjzMaGy26mNmVV5pQr_H0M5pBEc7j0Q&lsessionid=KHO-TDOe8LGxANpz2bra8gWY4yp0Cd_aUyg0SL1ygC5KScvNoK5hgg&q=&sa=X&ved=2ahUKEwiu8dLoq_eSAxU_0AIHHdfmKpcQs6gLegQIEBAB"
      },
      {
        "name": "About this image",
        "type": "about",
        "link": "https://www.google.com/search/about-this-image?img=H4sIAAAAAAAAAFPy5HLnWDN_Y-v9FbvWxAgwSTAqqZiZJSalWCSm6RonW6TomqQYmOkmGpin6ppaJKakmVukGiRZmhqxKTGlZmjwWZx7OPXF6u-TmAMYANX5B_RLAAAA&sa=X&ved=2ahUKEwiu8dLoq_eSAxU_0AIHHdfmKpcQs6gLegQIERAB"
      }
    ],
    "images": [
      {
        "title": "Youtube Live Streaming – Varvid",
        "link": "https://varvid.com/broadcast-platforms/youtube/",
        "logo": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAACAAAA...",
        "source": "varvid.com",
        "image": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAZ8AAA...",
        "image_base64": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAZ8AAA...",
        "rank": 1,
        "global_rank": 1
      },
      {
        "title": "YouTube - App on Amazon Appstore",
        "link": "https://www.amazon.com/Google-LLC-YouTube/dp/B07T771SPH",
        "logo": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAACAAAA...",
        "source": "Amazon.com",
        "image": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAOEAAA...",
        "image_base64": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAOEAAA...",
        "rank": 2,
        "global_rank": 2
      },
      {
        "title": "How to Turn Off YouTube Shorts Remixing [Tutorial] - YouTube",
        "link": "https://www.youtube.com/watch?v=cRHC1EFtsk0",
        "logo": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAACAAAA...",
        "source": "YouTube",
        "image": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAQMAAA...",
        "image_base64": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAQMAAA...",
        "rank": 3,
        "global_rank": 3
      },
      {
        "title": "YouTube (YouTube channel) - Wikipedia",
        "link": "https://en.wikipedia.org/wiki/YouTube_(YouTube_channel)",
        "logo": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAACAAAA...",
        "source": "Wikipedia",
        "image": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAOEAAA...",
        "image_base64": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAOEAAA...",
        "rank": 4,
        "global_rank": 4
      },
      {
        "title": "YouTube Shuts Down Original Content Group : r/television",
        "link": "https://www.reddit.com/r/television/comments/s73vjv/youtube_shuts_down_original_content_group/",
        "logo": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAACAAAA...",
        "source": "Reddit",
        "image": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAASsAAA...",
        "image_base64": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAASsAAA...",
        "rank": 5,
        "global_rank": 5
      },
      {
        "title": "How to Upload a Video to YouTube From iPhone or Android",
        "link": "https://www.howtogeek.com/744825/how-to-upload-a-video-to-youtube-from-iphone-or-android/",
        "logo": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAACAAAA...",
        "source": "How-To Geek",
        "image": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQABAAD/2w...",
        "image_base64": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQABAAD/2w...",
        "rank": 6,
        "global_rank": 6
      },
      {
        "title": "Worship – New Horizons Christian Church",
        "link": "https://newhorizonschristianchurch.com/worship/",
        "logo": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAACAAAA...",
        "source": "New Horizons Christian Church",
        "image": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAcAAAA...",
        "image_base64": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAcAAAA...",
        "rank": 7,
        "global_rank": 7
      },
      {
        "title": "File:YouTube logo upside down.jpg - Wikipedia",
        "link": "https://en.wikipedia.org/wiki/File:YouTube_logo_upside_down.jpg",
        "logo": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAACAAAA...",
        "source": "Wikipedia",
        "image": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQABAAD/2w...",
        "image_base64": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQABAAD/2w...",
        "rank": 8,
        "global_rank": 8
      },
      {
        "title": "YouTube has new features to try. Here's how to use them - CNET",
        "link": "https://www.cnet.com/tech/services-and-software/youtube-has-new-features-to-try-how-to-use-them/",
        "logo": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAACAAAA...",
        "source": "CNET",
        "image": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQABAAD/2w...",
        "image_base64": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQABAAD/2w...",
        "rank": 9,
        "global_rank": 9
      },
      {
        "title": "Shannon Ong - Product Lead at YouTube (Google) | Ex-Amazon ...",
        "link": "https://www.linkedin.com/in/shannon-ong-44887053",
        "logo": "https://encrypted-tbn3.gstatic.com/favicon-tbn?q=tbn:ANd9GcTFMvFisG5Yfyq07VS0hk1otTr6uQvufSrlgYLzmBkZlxd7MQh66ZmKRUOdwfXrertN7RslYSLWGQCDyxLn3JsHLob5z5LPzTRUUQlVmSHaBnVJlJa8",
        "source": "LinkedIn",
        "image": "https://encrypted-tbn3.gstatic.com/images?q=tbn:ANd9GcSHV_Rg6Zrd0YDIQ2z9jIc_bujs7QKmKxjUMoDk6jXc_c9S5XVv",
        "image_url": "https://encrypted-tbn3.gstatic.com/images?q=tbn:ANd9GcSHV_Rg6Zrd0YDIQ2z9jIc_bujs7QKmKxjUMoDk6jXc_c9S5XVv",
        "rank": 10,
        "global_rank": 10
      },
      {
        "title": "YouTube is getting a dynamic new look, no matter where you ...",
        "link": "https://www.androidpolice.com/youtube-new-look-new-features-web-mobile-tvs/",
        "logo": "https://encrypted-tbn1.gstatic.com/favicon-tbn?q=tbn:ANd9GcRh-53vY1i8heyMuwxhs4Rh2bAOMAEhKGRMSyNqK3XnCg8XxR6fsmw51vJ1BdWTmU0zdaBZKX0INk_QSxu8WtbQpVSnvw7AvcHACAbySI8alifLtpZD7BW9J6s",
        "source": "Android Police",
        "image": "https://encrypted-tbn3.gstatic.com/images?q=tbn:ANd9GcSN6xABbWVsaoYSrrb3HJASKCExp3mmdNc7_Gf22OtW4h_5_9DQ",
        "image_url": "https://encrypted-tbn3.gstatic.com/images?q=tbn:ANd9GcSN6xABbWVsaoYSrrb3HJASKCExp3mmdNc7_Gf22OtW4h_5_9DQ",
        "rank": 11,
        "global_rank": 11
      },
      {
        "title": "really hard question here: whats even the purpose of this ad ...",
        "link": "https://www.reddit.com/r/youtube/comments/1pxov43/really_hard_question_here_whats_even_the_purpose/",
        "logo": "https://encrypted-tbn2.gstatic.com/favicon-tbn?q=tbn:ANd9GcRFeJS-IhfJCysoVmCqJ1d-1lzbIHTsbcy4DrBsZJpxQ31zznhym7THnNEKCEnngpvdl4aupEFtEblIPBEMJY7_biy055d40m6TYfVg7CpFOrWOXw",
        "source": "Reddit",
        "image": "https://encrypted-tbn1.gstatic.com/images?q=tbn:ANd9GcQjQaN7z_b3AiHrbsF4XB6ToTBej8slFG0IIzUuIqFHfjKAys53",
        "image_url": "https://encrypted-tbn1.gstatic.com/images?q=tbn:ANd9GcQjQaN7z_b3AiHrbsF4XB6ToTBej8slFG0IIzUuIqFHfjKAys53",
        "rank": 12,
        "global_rank": 12
      },
      {
        "title": "An unknown YouTube channel just broke all records… kind of ...",
        "link": "https://www.instagram.com/p/DTcrRD8DUUl/",
        "logo": "https://encrypted-tbn3.gstatic.com/favicon-tbn?q=tbn:ANd9GcSpoKX-MM8KwYvjLm-JRx4G0Kwl8RLkE48NjkNQo2Gq3SC32GSp-nb0Bv1Gwdg0bIZuT7qIQcsQnlAbeKhfDsUARVp1OzzHay_AKGuFGTR9Of3S2pacaw",
        "source": "Instagram",
        "image": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcR-A9yKAxNvhWfCefDoHRIKNCAL4C3rqCrAG7tRnddJa3G5J1TQ",
        "image_url": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcR-A9yKAxNvhWfCefDoHRIKNCAL4C3rqCrAG7tRnddJa3G5J1TQ",
        "rank": 13,
        "global_rank": 13
      },
      {
        "title": "Get YouTube Premium - YouTube",
        "link": "https://www.youtube.com/premium",
        "logo": "https://encrypted-tbn0.gstatic.com/favicon-tbn?q=tbn:ANd9GcQHQslzHLLyLc_qne5jxn7JocidlmUPyegZ8ojX3WVlorFk8BxW9a3vJWjDzN99UHVTqSaNBj_-6XykhxuVQfF3Ye7xScSWSuc2QHXi0a12CkVwBmo",
        "source": "YouTube",
        "image": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcRoA3XLRLlSu7GDeIM4mOo8n2IsC2MMXJTUWuPEhLl8-H8UQjAV",
        "image_url": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcRoA3XLRLlSu7GDeIM4mOo8n2IsC2MMXJTUWuPEhLl8-H8UQjAV",
        "rank": 14,
        "global_rank": 14
      },
      {
        "title": "YouTube debuts new Recap feature. Here's how to get your ...",
        "link": "https://www.independent.co.uk/arts-entertainment/music/news/youtube-recap-2025-music-video-wrapped-how-to-get-b2877770.html",
        "logo": "https://encrypted-tbn2.gstatic.com/favicon-tbn?q=tbn:ANd9GcSrV5qFXK4MrrpmF-qGRuGZ3XvO58kiXpkOWX91Kx8-eTpm--qUCQciIk1KfIFiK7-tBEP0myCykgJYy4NHLoay0SMKqJd_ci1MQXzy391HtuxldxaIDbUucMM",
        "source": "The Independent",
        "image": "https://encrypted-tbn2.gstatic.com/images?q=tbn:ANd9GcTuzg2v7alS0tL2thS_clhgpAbur9kGjuALPI12kLuwKXZiu9at",
        "image_url": "https://encrypted-tbn2.gstatic.com/images?q=tbn:ANd9GcTuzg2v7alS0tL2thS_clhgpAbur9kGjuALPI12kLuwKXZiu9at",
        "rank": 15,
        "global_rank": 15
      },
      {
        "title": "Video — Paul Lincoln",
        "link": "http://www.paullincoln.com/media-2",
        "logo": "https://encrypted-tbn1.gstatic.com/favicon-tbn?q=tbn:ANd9GcR-7rvA3OHfu4y9znRDkYgG7MqdqU9M_63edTViGISPZfmcm4O5VHSj1fgqQaZhVc97bITyZ4ipdRQsSwDz9CXyGSmbU5bwbTAtn4uoZeT55MUe9P61fVQ",
        "source": "paullincoln.com",
        "image": "https://encrypted-tbn2.gstatic.com/images?q=tbn:ANd9GcT09i7ZbByzqgW95PWzZyFcVp4mWoEZcKolsA6nd0lmJES3epCe",
        "image_url": "https://encrypted-tbn2.gstatic.com/images?q=tbn:ANd9GcT09i7ZbByzqgW95PWzZyFcVp4mWoEZcKolsA6nd0lmJES3epCe",
        "rank": 16,
        "global_rank": 16
      },
      {
        "title": "What is YouTube?",
        "link": "https://www.webwise.ie/parents/what-is-youtube/",
        "logo": "https://encrypted-tbn2.gstatic.com/favicon-tbn?q=tbn:ANd9GcSbLBrYqX4Z0t1sT5T5OU0dU6Fvo9atHPiaH8iMCrSjf5T6HovbHsmdOsi0EyUarD3VOBf91gWcD9zD6UooW24U6P9v-9hAL7DI5HNE9UQ5lM_Xvw",
        "source": "Webwise",
        "image": "https://encrypted-tbn3.gstatic.com/images?q=tbn:ANd9GcQwO8Vfju8uGEWjkvVBJbZ-TFwjll0_nwfouGH5ZX0GP62kXokW",
        "image_url": "https://encrypted-tbn3.gstatic.com/images?q=tbn:ANd9GcQwO8Vfju8uGEWjkvVBJbZ-TFwjll0_nwfouGH5ZX0GP62kXokW",
        "rank": 17,
        "global_rank": 17
      },
      {
        "title": "YouTube Recap 2025 now available. How users can see their recap",
        "link": "https://www.rgj.com/story/life/2025/12/05/youtube-wrapped-2025-now-available-for-nevadans/87628967007/",
        "logo": "https://encrypted-tbn2.gstatic.com/favicon-tbn?q=tbn:ANd9GcQkBRB-B1bhwblr3JZ2n5B-bzIRXa5zL8IeBYmMtvs34T7OWwzAwMnFTasLSxYfqOr82Qi-hJMikzLPqOL4TMHp4APbkxL5s_Y2Vuz9hYxt2Q",
        "source": "Reno Gazette Journal",
        "image": "https://encrypted-tbn1.gstatic.com/images?q=tbn:ANd9GcSNWx8A2aLUw2Fxug1gCZyFLvZ4Y7aKVraBvUsGh4CACU8aGzpV",
        "image_url": "https://encrypted-tbn1.gstatic.com/images?q=tbn:ANd9GcSNWx8A2aLUw2Fxug1gCZyFLvZ4Y7aKVraBvUsGh4CACU8aGzpV",
        "rank": 18,
        "global_rank": 18
      },
      {
        "title": "Top 10 most-watched videos on YouTube globally as of 2024",
        "link": "https://indianexpress.com/article/trending/top-10-listing/top-10-most-watched-videos-on-youtube-globally-as-of-2024-9644368/",
        "logo": "https://encrypted-tbn0.gstatic.com/favicon-tbn?q=tbn:ANd9GcREHhA82Fap_IO3U-7dlibrn8yJlsi0qT2kUdbck1KimPVEHNIsCtGxstAKlPt07s9RhkEkAIgCRXi9RFzfFCaR0Y8p_z22jf2uaKW4DCqIgJOO0GBmOA",
        "source": "The Indian Express",
        "image": "https://encrypted-tbn2.gstatic.com/images?q=tbn:ANd9GcT8p0DDTwJ21nLYDW12Vmj8DsHfuIxqF5R7sZDvK_cUKPazOEQT",
        "image_url": "https://encrypted-tbn2.gstatic.com/images?q=tbn:ANd9GcT8p0DDTwJ21nLYDW12Vmj8DsHfuIxqF5R7sZDvK_cUKPazOEQT",
        "rank": 19,
        "global_rank": 19
      },
      {
        "title": "YouTube secretly tested AI video enhancement without ...",
        "link": "https://arstechnica.com/google/2025/08/youtube-secretly-tested-ai-video-enhancement-without-notifying-creators/",
        "logo": "https://encrypted-tbn2.gstatic.com/favicon-tbn?q=tbn:ANd9GcQoMdSJ0j3GUYtZdhvAzdB08yh2z11ylT-saWok78BDvRQ-2lYkLNBMp7mID2z5fLuG1RmEM90UiyubJEejEhO0VIEZXzsojyonbUtnqqZ9Q2NvyIk",
        "source": "Ars Technica",
        "image": "https://encrypted-tbn3.gstatic.com/images?q=tbn:ANd9GcSl2yITQzATmYhGq-fB7XwmSF01zPiThjHEJQrZtJKQGxIEFP-l",
        "image_url": "https://encrypted-tbn3.gstatic.com/images?q=tbn:ANd9GcSl2yITQzATmYhGq-fB7XwmSF01zPiThjHEJQrZtJKQGxIEFP-l",
        "rank": 20,
        "global_rank": 20
      },
      {
        "title": "Videos - Springdale FWB - Springdale Free Will Baptist Church",
        "link": "https://www.springdalefwb.org/videos.html",
        "logo": "https://encrypted-tbn1.gstatic.com/favicon-tbn?q=tbn:ANd9GcRqfiy0VdOS4lUakqCu5N8oAxk1lHi2UaYOIXQHAKeXimo0wfiqsUhsC8W74MzgM1uVP4A1OfEYMAxluM5HZzWfyPpD_RblP2GNnRHVxUFnREbuqPZT2UY4gw4",
        "source": "Springdale Free Will Baptist Church",
        "image": "https://encrypted-tbn2.gstatic.com/images?q=tbn:ANd9GcQnoUBdcMizJv-JxXxIQAVVUTuZKps3gGr-K2riQiHI58po0zMW",
        "image_url": "https://encrypted-tbn2.gstatic.com/images?q=tbn:ANd9GcQnoUBdcMizJv-JxXxIQAVVUTuZKps3gGr-K2riQiHI58po0zMW",
        "rank": 21,
        "global_rank": 21
      },
      {
        "title": "Anyone older than YouTube is officially old enough to drink ...",
        "link": "https://www.reddit.com/r/BarbaraWalters4Scale/comments/1r4ejjo/anyone_older_than_youtube_is_officially_old/",
        "logo": "https://encrypted-tbn2.gstatic.com/favicon-tbn?q=tbn:ANd9GcRFeJS-IhfJCysoVmCqJ1d-1lzbIHTsbcy4DrBsZJpxQ31zznhym7THnNEKCEnngpvdl4aupEFtEblIPBEMJY7_biy055d40m6TYfVg7CpFOrWOXw",
        "source": "Reddit",
        "image": "https://encrypted-tbn2.gstatic.com/images?q=tbn:ANd9GcS8t9_wIn62SKBGmnoLU0RvrOhQ9CoGqM3t2yjRkvStTp14An5n",
        "image_url": "https://encrypted-tbn2.gstatic.com/images?q=tbn:ANd9GcS8t9_wIn62SKBGmnoLU0RvrOhQ9CoGqM3t2yjRkvStTp14An5n",
        "rank": 22,
        "global_rank": 22
      },
      {
        "title": "YouTube should give more prominence to public service media ...",
        "link": "https://www.bbc.co.uk/news/articles/clyl07nekzxo",
        "logo": "https://encrypted-tbn2.gstatic.com/favicon-tbn?q=tbn:ANd9GcQkfkHsgY8lS21mPHFUbDtwW6Et_KFgAwjd1eumnE7PsvEhqdw6Kv69JwDtX9AXmV8-fm6t54pB8PATe-Pzv5BHmyDELvrJFZqQ7nx8_vZwcD6x",
        "source": "BBC",
        "image": "https://encrypted-tbn1.gstatic.com/images?q=tbn:ANd9GcTCIXoliRxY3r5Vx1pd9ThbHblQxHEbzddAo4HHt2kSCUd7gsqf",
        "image_url": "https://encrypted-tbn1.gstatic.com/images?q=tbn:ANd9GcTCIXoliRxY3r5Vx1pd9ThbHblQxHEbzddAo4HHt2kSCUd7gsqf",
        "rank": 23,
        "global_rank": 23
      },
      {
        "title": "YouTube | The Verge",
        "link": "https://www.theverge.com/youtube",
        "logo": "https://encrypted-tbn2.gstatic.com/favicon-tbn?q=tbn:ANd9GcQUvjXAGG2ILQkdobGNlrkN845RoDIT9G4L-sPBcsw7sdEAQIF2bqZftAiLLpBKccaBBAjaSpfW9ouqLNlezyTrUZXWckKVGEY4FwEpL2uaLSkcp1gZ",
        "source": "The Verge",
        "image": "https://encrypted-tbn3.gstatic.com/images?q=tbn:ANd9GcQTN14quh9Stlf80QyS_Hu3gvWmTirVetvyHyozGMqJsSmd-QWx",
        "image_url": "https://encrypted-tbn3.gstatic.com/images?q=tbn:ANd9GcQTN14quh9Stlf80QyS_Hu3gvWmTirVetvyHyozGMqJsSmd-QWx",
        "rank": 24,
        "global_rank": 24
      },
      {
        "title": "Yt randomly stopped working yesterday - YouTube",
        "link": "https://www.youtube.com/watch?v=SYWjR4Ie9H4",
        "logo": "https://encrypted-tbn0.gstatic.com/favicon-tbn?q=tbn:ANd9GcQHQslzHLLyLc_qne5jxn7JocidlmUPyegZ8ojX3WVlorFk8BxW9a3vJWjDzN99UHVTqSaNBj_-6XykhxuVQfF3Ye7xScSWSuc2QHXi0a12CkVwBmo",
        "source": "YouTube",
        "image": "https://encrypted-tbn3.gstatic.com/images?q=tbn:ANd9GcQc_5D9QjSgCLNacTmdhIf96JsDys4r2sKAXqaKXihgWf0K-S-C",
        "image_url": "https://encrypted-tbn3.gstatic.com/images?q=tbn:ANd9GcQc_5D9QjSgCLNacTmdhIf96JsDys4r2sKAXqaKXihgWf0K-S-C",
        "rank": 25,
        "global_rank": 25
      },
      {
        "title": "Sorry Search, YouTube Is More Important to Google Than Ever ...",
        "link": "https://www.wired.com/2015/10/sorry-search-youtube-is-more-important-to-google-than-ever/",
        "logo": "https://encrypted-tbn0.gstatic.com/favicon-tbn?q=tbn:ANd9GcThlD2e1C2_v--cgb8ALlm86tHfzrbkhTDvq9HqJqt0GoealFINHn1O1SnJiZeCJz_iJdliO5UpQz_2yc4oIqE_wZwQYOWkpR7S4fJyBLlWCG9w",
        "source": "WIRED",
        "image": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcTXLdsL_7M3gvVqAYuTTqVg-ckcsaFhdg9LEPdn_s-bZ7JJ4JSt",
        "image_url": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcTXLdsL_7M3gvVqAYuTTqVg-ckcsaFhdg9LEPdn_s-bZ7JJ4JSt",
        "rank": 26,
        "global_rank": 26
      },
      {
        "title": "Watching YouTube Videos in Whonix",
        "link": "https://www.whonix.org/wiki/YouTube",
        "logo": "https://encrypted-tbn1.gstatic.com/favicon-tbn?q=tbn:ANd9GcR7RCT4r1ULdXFpOWV7360X_4uHe_tgQD8LjRH_CH1PdrUaVhIVyar26V_7gxFFa3iH8Oy21z9GPKAYnBLMmPWgbGAmEwYkn8RSAqv6Zzv0OcuUFQ",
        "source": "Whonix",
        "image": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcRXYvXSyyCilfbT9uHBSCn_f8N0EHl1BJIvVnTlaimF1YfRaHUK",
        "image_url": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcRXYvXSyyCilfbT9uHBSCn_f8N0EHl1BJIvVnTlaimF1YfRaHUK",
        "rank": 27,
        "global_rank": 27
      },
      {
        "title": "YouTube Music Review | PCMag",
        "link": "https://www.pcmag.com/reviews/youtube-music",
        "logo": "https://encrypted-tbn2.gstatic.com/favicon-tbn?q=tbn:ANd9GcQT2SxtS9PqiMpEW2DDJLdjuVqHzsB-BQ_R7sUFdvjuE3SMmj4UDrJTT0vpXgXFeSKQtj3idX4xCu9G5dm0yLJ9c45ktlpBDPBKR2kVTtday3EF",
        "source": "PCMag",
        "image": "https://encrypted-tbn2.gstatic.com/images?q=tbn:ANd9GcRuf5sF-d6UFF8UNcLGO-duPlx_Ir1i4MoSICNnH8NU08ifkakF",
        "image_url": "https://encrypted-tbn2.gstatic.com/images?q=tbn:ANd9GcRuf5sF-d6UFF8UNcLGO-duPlx_Ir1i4MoSICNnH8NU08ifkakF",
        "rank": 28,
        "global_rank": 28
      },
      {
        "title": "5 facts about Americans and YouTube | Pew Research Center",
        "link": "https://www.pewresearch.org/short-reads/2025/02/28/5-facts-about-americans-and-youtube/",
        "logo": "https://encrypted-tbn0.gstatic.com/favicon-tbn?q=tbn:ANd9GcR17CLniZiP5RD4SSFBbTXMqovUhHiNZ6yCLWZRWhSdopCIttlaz9BdH7uaz3dkB5DNfwoRw2bfkueSYNMVp9gc7dN9ER0CA0x59pXXqIG1tptNBNM52iPO",
        "source": "Pew Research Center",
        "image": "https://encrypted-tbn1.gstatic.com/images?q=tbn:ANd9GcT6PQoNDFTvRBZ0WDSLnorgHo35ZVej0QjPZ78OOGTTE0F0I0mt",
        "image_url": "https://encrypted-tbn1.gstatic.com/images?q=tbn:ANd9GcT6PQoNDFTvRBZ0WDSLnorgHo35ZVej0QjPZ78OOGTTE0F0I0mt",
        "rank": 29,
        "global_rank": 29
      },
      {
        "title": "10 Reasons to Start a YouTube Channel Today | TubeBuddy",
        "link": "https://www.tubebuddy.com/blog/10-reasons-start-youtube-channel/",
        "logo": "https://encrypted-tbn3.gstatic.com/favicon-tbn?q=tbn:ANd9GcQBpw2mbW8vadl8QZpNXIHukGlh5Coavo8CfqmCVM0SS02q94VLSJJLzwjVhOCQSIFe7Hrul3Ykzz-aqn1btCE8KE1zDbk1srhzknIFUWmi3v9eDwTBLw",
        "source": "TubeBuddy",
        "image": "https://encrypted-tbn3.gstatic.com/images?q=tbn:ANd9GcSBPIH0c-fIrX1ZpB-T3QK8ydY6_Kn5Y2_L9ZzfwZNcuJlmJVz7",
        "image_url": "https://encrypted-tbn3.gstatic.com/images?q=tbn:ANd9GcSBPIH0c-fIrX1ZpB-T3QK8ydY6_Kn5Y2_L9ZzfwZNcuJlmJVz7",
        "rank": 30,
        "global_rank": 30
      },
      {
        "title": "How Can I Watch Videos on YouTube?",
        "link": "https://www.ncoa.org/article/how-to-find-and-watch-videos-on-youtube-a-tutorial/",
        "logo": "https://encrypted-tbn3.gstatic.com/favicon-tbn?q=tbn:ANd9GcQus8nqyjv6rmz1FLbKGZwnxSd9hg2_yL96BFiHAN5QTJwn-zY4BSa6vY_ZLuZfuYPBbNQe3YDy_mTjL8MRVHMK4-T4re0IpNTONmS2C4dVF44",
        "source": "The National Council on Aging (NCOA)",
        "image": "https://encrypted-tbn1.gstatic.com/images?q=tbn:ANd9GcR-23W6IbOhj49W3-iVbuNP5cdswORmNoZkpGYmYJSrHXpeXZbp",
        "image_url": "https://encrypted-tbn1.gstatic.com/images?q=tbn:ANd9GcR-23W6IbOhj49W3-iVbuNP5cdswORmNoZkpGYmYJSrHXpeXZbp",
        "rank": 31,
        "global_rank": 31
      },
      {
        "title": "YouTube Is Getting Two New Smart Features",
        "link": "https://www.howtogeek.com/youtube-is-getting-two-new-smart-features/",
        "logo": "https://encrypted-tbn0.gstatic.com/favicon-tbn?q=tbn:ANd9GcQi7d7OE3tYYpQ0K0N2YmwhwaeJDpQia9z8E5mUUGmYuXveM7Jc79TKGAwew0HGVw8nR3bhm6JDzDYTfw9UOl8rmynEx6jiQgFI18MGyTgd52tKjiLMwQ",
        "source": "How-To Geek",
        "image": "https://encrypted-tbn3.gstatic.com/images?q=tbn:ANd9GcQjsUXO2w4xeQxrjXEq137RF1UCZAmNj-EvtP0ZBa-_fNtTmPav",
        "image_url": "https://encrypted-tbn3.gstatic.com/images?q=tbn:ANd9GcQjsUXO2w4xeQxrjXEq137RF1UCZAmNj-EvtP0ZBa-_fNtTmPav",
        "rank": 32,
        "global_rank": 32
      },
      {
        "title": "AI Overviews Are Coming To YouTube In New Test",
        "link": "https://www.tulsamarketingonline.com/ai-overviews-are-coming-to-youtube-in-new-test/",
        "logo": "https://encrypted-tbn0.gstatic.com/favicon-tbn?q=tbn:ANd9GcQdlX-huMkuAXP9QrJWUVbCax_aXdhGZO9qhv8aeHvTCCjnHzWOfuNp56fCD5n-lQFo2UOXmqvBrWv1EP-Y3kRZL70kqvASoG3GGaVXHP1FDF_9UrN2663TziCS-bzqD4Hw",
        "source": "Tulsa Marketing Online",
        "image": "https://encrypted-tbn1.gstatic.com/images?q=tbn:ANd9GcSrAt7rOPRTZ3ARkL-YGWskDIZZrBNHNFU8hu07vmAdCxPSDyOH",
        "image_url": "https://encrypted-tbn1.gstatic.com/images?q=tbn:ANd9GcSrAt7rOPRTZ3ARkL-YGWskDIZZrBNHNFU8hu07vmAdCxPSDyOH",
        "rank": 33,
        "global_rank": 33
      },
      {
        "title": "Reports that YouTube is d0wn for many users 🚨",
        "link": "https://www.instagram.com/p/DU4h9Wlj3Tr/",
        "logo": "https://encrypted-tbn3.gstatic.com/favicon-tbn?q=tbn:ANd9GcSpoKX-MM8KwYvjLm-JRx4G0Kwl8RLkE48NjkNQo2Gq3SC32GSp-nb0Bv1Gwdg0bIZuT7qIQcsQnlAbeKhfDsUARVp1OzzHay_AKGuFGTR9Of3S2pacaw",
        "source": "Instagram",
        "image": "https://encrypted-tbn1.gstatic.com/images?q=tbn:ANd9GcSQDo_DFR_HJoAMOXQ1BQc5evDdbjSlU2h2IZXlnuK1xGoIg2AR",
        "image_url": "https://encrypted-tbn1.gstatic.com/images?q=tbn:ANd9GcSQDo_DFR_HJoAMOXQ1BQc5evDdbjSlU2h2IZXlnuK1xGoIg2AR",
        "rank": 34,
        "global_rank": 34
      },
      {
        "title": "Council Meeting Videos | City of Oconomowoc, WI - Official ...",
        "link": "https://www.oconomowoc-wi.gov/769/Council-Meeting-Videos-on-YouTube",
        "logo": "https://encrypted-tbn3.gstatic.com/favicon-tbn?q=tbn:ANd9GcQTyr2X3_sexqjYHbmBx8BOfYR2NdvXo7-7f_aOtDoQqtUeIhYdRlCTaktRxMJqisDnx5bKSz--9AFYPlCBMyEtRQwVFaVo85gmzwH-C_YqrqE2qay2p3PyKYw",
        "source": "City of Oconomowoc, WI (.gov)",
        "image": "https://encrypted-tbn3.gstatic.com/images?q=tbn:ANd9GcRdPwT4HJnPOPNlvcKaANyl-0YrnwPHxnAmbKyRdYM5SIE35CD3",
        "image_url": "https://encrypted-tbn3.gstatic.com/images?q=tbn:ANd9GcRdPwT4HJnPOPNlvcKaANyl-0YrnwPHxnAmbKyRdYM5SIE35CD3",
        "rank": 35,
        "global_rank": 35
      },
      {
        "title": "YouTube Has a New Way to Share Channels",
        "link": "https://www.howtogeek.com/youtube-channels-qr-codes/",
        "logo": "https://encrypted-tbn0.gstatic.com/favicon-tbn?q=tbn:ANd9GcQi7d7OE3tYYpQ0K0N2YmwhwaeJDpQia9z8E5mUUGmYuXveM7Jc79TKGAwew0HGVw8nR3bhm6JDzDYTfw9UOl8rmynEx6jiQgFI18MGyTgd52tKjiLMwQ",
        "source": "How-To Geek",
        "image": "https://encrypted-tbn1.gstatic.com/images?q=tbn:ANd9GcQZge9V5uwknS8grLnlN9-MjxTo_CzGn4MBqlS2DL32NmfuEOdk",
        "image_url": "https://encrypted-tbn1.gstatic.com/images?q=tbn:ANd9GcQZge9V5uwknS8grLnlN9-MjxTo_CzGn4MBqlS2DL32NmfuEOdk",
        "rank": 36,
        "global_rank": 36
      },
      {
        "title": "Popaganda Podcast",
        "link": "https://www.popagandapod.com/season1",
        "logo": "https://encrypted-tbn0.gstatic.com/favicon-tbn?q=tbn:ANd9GcSxbqFeVrr2di3ffaWz_O8ivKYW7tRtmi51RAq8MylGvGAQHmV9lqUDOdmE8rMpy9s63aeBGIzHjho53xhXkEkOIxVNl6MrlEqQ859957BgADrGHPH31PUP5g",
        "source": "Popaganda Podcast",
        "image": "https://encrypted-tbn3.gstatic.com/images?q=tbn:ANd9GcQti39Qu5s92QMRuS63qsnoyO5JlBmIu84Q0GtL1b0Sc1XG0O0s",
        "image_url": "https://encrypted-tbn3.gstatic.com/images?q=tbn:ANd9GcQti39Qu5s92QMRuS63qsnoyO5JlBmIu84Q0GtL1b0Sc1XG0O0s",
        "rank": 37,
        "global_rank": 37
      },
      {
        "title": "YouTube Music - YouTube",
        "link": "https://www.youtube.com/channel/UCStaiwu-FAgp_RC_tBiLh9A",
        "logo": "https://encrypted-tbn0.gstatic.com/favicon-tbn?q=tbn:ANd9GcQHQslzHLLyLc_qne5jxn7JocidlmUPyegZ8ojX3WVlorFk8BxW9a3vJWjDzN99UHVTqSaNBj_-6XykhxuVQfF3Ye7xScSWSuc2QHXi0a12CkVwBmo",
        "source": "YouTube",
        "image": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcTE12NwfEIz3s1Scc9ug0S0sWhuK0DDv5kBgBbvJc5phh3nDliM",
        "image_url": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcTE12NwfEIz3s1Scc9ug0S0sWhuK0DDv5kBgBbvJc5phh3nDliM",
        "rank": 38,
        "global_rank": 38
      },
      {
        "title": "How To Upload To YouTube [Guide] - YouTube",
        "link": "https://www.youtube.com/watch?v=s-KZu1kru8Y",
        "logo": "https://encrypted-tbn0.gstatic.com/favicon-tbn?q=tbn:ANd9GcQHQslzHLLyLc_qne5jxn7JocidlmUPyegZ8ojX3WVlorFk8BxW9a3vJWjDzN99UHVTqSaNBj_-6XykhxuVQfF3Ye7xScSWSuc2QHXi0a12CkVwBmo",
        "source": "YouTube",
        "image": "https://encrypted-tbn1.gstatic.com/images?q=tbn:ANd9GcTmetLJpEeBZIkBH8iY9Hl9Zmg6FyRiNKggrlH2TYUydoK_WFTm",
        "image_url": "https://encrypted-tbn1.gstatic.com/images?q=tbn:ANd9GcTmetLJpEeBZIkBH8iY9Hl9Zmg6FyRiNKggrlH2TYUydoK_WFTm",
        "rank": 39,
        "global_rank": 39
      },
      {
        "title": "Where is Your YouTube History? - YouTube",
        "link": "https://www.youtube.com/watch?v=hcnkv0y-0WM",
        "logo": "https://encrypted-tbn0.gstatic.com/favicon-tbn?q=tbn:ANd9GcQHQslzHLLyLc_qne5jxn7JocidlmUPyegZ8ojX3WVlorFk8BxW9a3vJWjDzN99UHVTqSaNBj_-6XykhxuVQfF3Ye7xScSWSuc2QHXi0a12CkVwBmo",
        "source": "YouTube",
        "image": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcR3b0891aPxG36yA2V8x8ScZNv17SVWNfwTDtXyZFdmJMa4mdIu",
        "image_url": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcR3b0891aPxG36yA2V8x8ScZNv17SVWNfwTDtXyZFdmJMa4mdIu",
        "rank": 40,
        "global_rank": 40
      },
      {
        "title": "Rob Pratley",
        "link": "https://luc.devroye.org/fonts-87321.html",
        "logo": "https://encrypted-tbn1.gstatic.com/favicon-tbn?q=tbn:ANd9GcQWUq4levL2IJLit-bQYDm4o9U35ZP1zDILK4M6PZ6IXNLyCCfM8mN-Dbup_Cpy009Pdqs1OO4W0vRc2OyGIu5EkE4SHxrmzXIh0JQo5KSeh2hI2HA",
        "source": "devroye.org",
        "image": "https://encrypted-tbn2.gstatic.com/images?q=tbn:ANd9GcRVwnQjv1TrJlbyTjSQfLesOC8dVjEjXQlEF08KnM-2HdN1g0po",
        "image_url": "https://encrypted-tbn2.gstatic.com/images?q=tbn:ANd9GcRVwnQjv1TrJlbyTjSQfLesOC8dVjEjXQlEF08KnM-2HdN1g0po",
        "rank": 41,
        "global_rank": 41
      },
      {
        "title": "How to Live Stream on YouTube Using Your iPhone 15, iPhone ...",
        "link": "https://www.youtube.com/watch?v=rXU3sRnDi5M",
        "logo": "https://encrypted-tbn0.gstatic.com/favicon-tbn?q=tbn:ANd9GcQHQslzHLLyLc_qne5jxn7JocidlmUPyegZ8ojX3WVlorFk8BxW9a3vJWjDzN99UHVTqSaNBj_-6XykhxuVQfF3Ye7xScSWSuc2QHXi0a12CkVwBmo",
        "source": "YouTube",
        "image": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcT2J6imTTg_XtsK2Yul9RScPHVLmB1y2NppWjMLXRW2mzJYEfsC",
        "image_url": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcT2J6imTTg_XtsK2Yul9RScPHVLmB1y2NppWjMLXRW2mzJYEfsC",
        "rank": 42,
        "global_rank": 42
      },
      {
        "title": "YouTube says that music is now 25% of its global watch time",
        "link": "https://musically.com/2021/09/16/youtube-says-that-music-is-now-25-of-its-global-watch-time/",
        "logo": "https://encrypted-tbn3.gstatic.com/favicon-tbn?q=tbn:ANd9GcSFAxZpnQqFaA4qoNqYk_NlH7wPwpNpjN3Fyh-p6wfFTc-IhE0-Ufkg2aomh1NFcGdcunSi9BYOB0RK6mkP7VVvlBlxdcQcbJILVSRsFGTY83Gj",
        "source": "Music Ally",
        "image": "https://encrypted-tbn3.gstatic.com/images?q=tbn:ANd9GcQjPmybg3_wHprlJf2gIX5GjEPxEsB51OyF42VDXiKkYjYF2oTr",
        "image_url": "https://encrypted-tbn3.gstatic.com/images?q=tbn:ANd9GcQjPmybg3_wHprlJf2gIX5GjEPxEsB51OyF42VDXiKkYjYF2oTr",
        "rank": 43,
        "global_rank": 43
      },
      {
        "title": "Livestreams and Recordings – Saint Robert's Catholic Church",
        "link": "https://saintroberts.org/livestreams-and-recordings/",
        "logo": "https://encrypted-tbn3.gstatic.com/favicon-tbn?q=tbn:ANd9GcRjhous8nGXkV0aOGtVkKN5c1hOh61JSqwS0iq3rZZWxnMc_gYOJFfkdICHl9Am33bjcVi1267LSKrraHCqHZjkiNVaDkNMLWUQ3DdvxgaI5IouOlq8",
        "source": "Saint Robert's Catholic Church",
        "image": "https://encrypted-tbn2.gstatic.com/images?q=tbn:ANd9GcQhDUhnp1HB4uSLfEsS8T6WgFzOGY6vStFEMzNyh1NVhas8Pvd3",
        "image_url": "https://encrypted-tbn2.gstatic.com/images?q=tbn:ANd9GcQhDUhnp1HB4uSLfEsS8T6WgFzOGY6vStFEMzNyh1NVhas8Pvd3",
        "rank": 44,
        "global_rank": 44
      },
      {
        "title": "YouTube is giving you better control over what videos are on ...",
        "link": "https://www.xda-developers.com/youtube-better-control-over-what-videos-are-on-your-homepage/",
        "logo": "https://encrypted-tbn1.gstatic.com/favicon-tbn?q=tbn:ANd9GcRAME90RmDvZ7n5QF-g_fXA6hrG1UpK1yFStismLE2bPsvQ8NDeM_419lGa-XTsXWEQ7-TMRilzLDBgbo39QRarJ_dIvrWYKxo3Lc1KDOvngg4HxOqxV7yDSBqR",
        "source": "XDA",
        "image": "https://encrypted-tbn3.gstatic.com/images?q=tbn:ANd9GcRQic49NGU9caQSmutaO1b9OICmJ1yA74nHS4EBDblaazX9dnyE",
        "image_url": "https://encrypted-tbn3.gstatic.com/images?q=tbn:ANd9GcRQic49NGU9caQSmutaO1b9OICmJ1yA74nHS4EBDblaazX9dnyE",
        "rank": 45,
        "global_rank": 45
      },
      {
        "title": "YouTube Set To Overtake Facebook As Second Largest Website ...",
        "link": "https://www.tubefilter.com/2018/08/08/youtube-second-largest-us-website/",
        "logo": "https://encrypted-tbn0.gstatic.com/favicon-tbn?q=tbn:ANd9GcQOnfaQAkwfbzgAhZAsN5ZEqvhBteEgAtOUgDLozCYjPpNAwfem0ykIevsPO1a2BQWF_eWOq8yhCPPs39ddN7Qnn_REbXXsh4g8Ox6A4cd2s6tzF_8vt3Y",
        "source": "Tubefilter",
        "image": "https://encrypted-tbn3.gstatic.com/images?q=tbn:ANd9GcQdG1HLsjtJ1yGqDtoqiT8_0BJBOdjgBslZdnESZl90s5Ogt1M9",
        "image_url": "https://encrypted-tbn3.gstatic.com/images?q=tbn:ANd9GcQdG1HLsjtJ1yGqDtoqiT8_0BJBOdjgBslZdnESZl90s5Ogt1M9",
        "rank": 46,
        "global_rank": 46
      },
      {
        "title": "Listen – Kicks Band of Fargo-Moorhead",
        "link": "https://fmkicksband.com/listen/",
        "logo": "https://encrypted-tbn2.gstatic.com/favicon-tbn?q=tbn:ANd9GcSXIP238x7Ns9vg5fxViRnkAHehX-cXBHAumAnxFErtlfXQpKU6hVJib-drG2IjKuQ3zFj0pmu3F_N8pdVpuCn5VuYHj67pIOKWTIo3uZnmRNt9Eag",
        "source": "Kicks Band of Fargo-Moorhead",
        "image": "https://encrypted-tbn2.gstatic.com/images?q=tbn:ANd9GcRoVsB0EGH2wECLCNA1IotQT_M1ApQTGq-53qFeSPfLlaP7dceG",
        "image_url": "https://encrypted-tbn2.gstatic.com/images?q=tbn:ANd9GcRoVsB0EGH2wECLCNA1IotQT_M1ApQTGq-53qFeSPfLlaP7dceG",
        "rank": 47,
        "global_rank": 47
      },
      {
        "title": "Church News | Grace Community Church West Allis, Wisconsin 53227",
        "link": "https://www.ourgcc.com/LiveStream",
        "logo": "https://encrypted-tbn1.gstatic.com/favicon-tbn?q=tbn:ANd9GcQjOVrgTcfOQd208wODKcdmYhpg0A4c8rI0iQOfObfVtqWQ3A82OkIxtd9eJo8DhTCB4XaOFUL34ZsE90N4upcd5sNfeR0y0DH1HagFogmWOS1Jdw",
        "source": "ourgcc.com",
        "image": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcTC3exulTpXNFqIrOs03eepYpCz8B5lco2RIq-ASaFmrLW9GiZe",
        "image_url": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcTC3exulTpXNFqIrOs03eepYpCz8B5lco2RIq-ASaFmrLW9GiZe",
        "rank": 48,
        "global_rank": 48
      },
      {
        "title": "Calvary Chapel Myrtle Beach - YouTube",
        "link": "https://www.youtube.com/c/CalvaryChapelMyrtleBeach",
        "logo": "https://encrypted-tbn0.gstatic.com/favicon-tbn?q=tbn:ANd9GcQHQslzHLLyLc_qne5jxn7JocidlmUPyegZ8ojX3WVlorFk8BxW9a3vJWjDzN99UHVTqSaNBj_-6XykhxuVQfF3Ye7xScSWSuc2QHXi0a12CkVwBmo",
        "source": "YouTube",
        "image": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcTNzpg3c-1dwwy9JkJ-8U9yJF8wTocFJoEsF19F1v5VWwUAUT_j",
        "image_url": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcTNzpg3c-1dwwy9JkJ-8U9yJF8wTocFJoEsF19F1v5VWwUAUT_j",
        "rank": 49,
        "global_rank": 49
      },
      {
        "title": "YouTube Links for Anne Z | Anne Z on the Web",
        "link": "https://annezontheweb.com/you-tube-links-anne-z-on-the-web/",
        "logo": "https://encrypted-tbn1.gstatic.com/favicon-tbn?q=tbn:ANd9GcSDIIO4W4Ama4T6lvAPC7HUk1SV3hRP_oJkukjBzEtKDA7PUJXbLEZ-Tjp-4nBHRgMn1FPzDOR62BrAex4X0BvfOfJjndvL3FjGsa2F37448wajStuF3g",
        "source": "annezontheweb.com",
        "image": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcR7QzVG2h-AGEuDvhAWzIs1oJltO_TwztlJYqfZE--A3SpDptSx",
        "image_url": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcR7QzVG2h-AGEuDvhAWzIs1oJltO_TwztlJYqfZE--A3SpDptSx",
        "rank": 50,
        "global_rank": 50
      },
      {
        "title": "Practices + Playlists — Shawn J. Moore, The Mindful Rebel®",
        "link": "https://www.shawnjmoore.com/listen",
        "logo": "https://encrypted-tbn1.gstatic.com/favicon-tbn?q=tbn:ANd9GcRtkwHR73zt_pPwLkrunvKwi5t5l12sPzyLDJiB0L5o99WE7uXv8OPet3Po9wW4dyeA0FeuNfoVOed_WWwZL9ihFpVlRie_NG1JuggWI4Xnv8U0blP_7wOD",
        "source": "shawnjmoore.com",
        "image": "https://encrypted-tbn3.gstatic.com/images?q=tbn:ANd9GcTzD6aBv7OJzyeYz2m1jZBbaEYlKxk1ScXMopYqPJcp5i55Fu15",
        "image_url": "https://encrypted-tbn3.gstatic.com/images?q=tbn:ANd9GcTzD6aBv7OJzyeYz2m1jZBbaEYlKxk1ScXMopYqPJcp5i55Fu15",
        "rank": 51,
        "global_rank": 51
      },
      {
        "title": "Simplest way to embed a Youtube video in your React app ...",
        "link": "https://dev.to/bravemaster619/simplest-way-to-embed-a-youtube-video-in-your-react-app-3bk2",
        "logo": "https://encrypted-tbn0.gstatic.com/favicon-tbn?q=tbn:ANd9GcSQRYRjo6rRDeEwOaYrr8zfImMVmlI3BXXupnqDJb9APJUNVXQUR_ECPJEd7MrgNMDi2ZkWz2U7Ukg8DNNNK2HaNLsmHqhhaPiKpi4",
        "source": "DEV Community",
        "image": "https://encrypted-tbn1.gstatic.com/images?q=tbn:ANd9GcSh5PWTqIAO1R2wHP12Nb0aflEKKY5TP5n42uX4UK7IAizpajZQ",
        "image_url": "https://encrypted-tbn1.gstatic.com/images?q=tbn:ANd9GcSh5PWTqIAO1R2wHP12Nb0aflEKKY5TP5n42uX4UK7IAizpajZQ",
        "rank": 52,
        "global_rank": 52
      },
      {
        "title": "live — Edgerton First Reformed",
        "link": "https://www.edgertonfrc.org/live",
        "logo": "https://encrypted-tbn2.gstatic.com/favicon-tbn?q=tbn:ANd9GcQX0DHkVwqsNq8LU6oTPXlV6-xin23cGL575S3bUgZ-ziBlBpRnlJZ3jTzBnHkxrc1w_hwFCKe0N3ZBwslfw9g6etfzO4wticYgPriK-2Mu0IXr_c98ZeHj",
        "source": "edgertonfrc.org",
        "image": "https://encrypted-tbn2.gstatic.com/images?q=tbn:ANd9GcSf1bfDH6bh3UdF_o7mdSZ2UoprkQF0je__l3Y6hHynVZH7gQ-O",
        "image_url": "https://encrypted-tbn2.gstatic.com/images?q=tbn:ANd9GcSf1bfDH6bh3UdF_o7mdSZ2UoprkQF0je__l3Y6hHynVZH7gQ-O",
        "rank": 53,
        "global_rank": 53
      },
      {
        "title": "YouTube's Checks to Warn Creators About Copyright Issues ...",
        "link": "https://ottverse.com/youtube-checks-warn-creators-about-copyright-issues/",
        "logo": "https://encrypted-tbn2.gstatic.com/favicon-tbn?q=tbn:ANd9GcQV3QA33hwGlp-HOrq6qCTu4V6QtzpxE8W62b4_TiSVunAN06tPoZW18UhkT5wOHmoEx5PlHrrZjin1Jl1x4ad_9aAYWSZe79fxVLSv4UJHaJ8",
        "source": "OTTVerse",
        "image": "https://encrypted-tbn2.gstatic.com/images?q=tbn:ANd9GcQ4tiYPe8b5sDGi8ePUF7WnAyOgV0ZcmTYWZBsgXYT-fq0M7m6J",
        "image_url": "https://encrypted-tbn2.gstatic.com/images?q=tbn:ANd9GcQ4tiYPe8b5sDGi8ePUF7WnAyOgV0ZcmTYWZBsgXYT-fq0M7m6J",
        "rank": 54,
        "global_rank": 54
      },
      {
        "title": "How to Sign Up for YouTube TV - YouTube",
        "link": "https://www.youtube.com/watch?v=Qw_8AEoy59o",
        "logo": "https://encrypted-tbn0.gstatic.com/favicon-tbn?q=tbn:ANd9GcQHQslzHLLyLc_qne5jxn7JocidlmUPyegZ8ojX3WVlorFk8BxW9a3vJWjDzN99UHVTqSaNBj_-6XykhxuVQfF3Ye7xScSWSuc2QHXi0a12CkVwBmo",
        "source": "YouTube",
        "image": "https://encrypted-tbn1.gstatic.com/images?q=tbn:ANd9GcSGXVl_lm2UZWqLNkC80N2ZUZlVjMaQzdQaePReyiDB3XDRdz3v",
        "image_url": "https://encrypted-tbn1.gstatic.com/images?q=tbn:ANd9GcSGXVl_lm2UZWqLNkC80N2ZUZlVjMaQzdQaePReyiDB3XDRdz3v",
        "rank": 55,
        "global_rank": 55
      },
      {
        "title": "Lincoln Community Foundation Garden Performance Series - Home",
        "link": "https://artsincorporated.org/fgps/",
        "logo": "https://encrypted-tbn2.gstatic.com/favicon-tbn?q=tbn:ANd9GcS_mDfJIg_rnjz21iR8FusOKVEXvVIiA-75CTo2W2-sI2qE6ostf4cDLy__KgU7p6j5H6qkYP9c1yefmjXdqXrlcrn42fsPCfAlyCZDyPivGq2Luyw4ywFD8Q",
        "source": "Arts Incorporated",
        "image": "https://encrypted-tbn2.gstatic.com/images?q=tbn:ANd9GcTPfkm0GAi--1NuzfHwVOBBGRUoQvIuQIeTV6G8cOOVVsWh-Z9V",
        "image_url": "https://encrypted-tbn2.gstatic.com/images?q=tbn:ANd9GcTPfkm0GAi--1NuzfHwVOBBGRUoQvIuQIeTV6G8cOOVVsWh-Z9V",
        "rank": 56,
        "global_rank": 56
      },
      {
        "title": "The differences between RTK and PPK. Which method is best ...",
        "link": "https://www.ardusimple.com/ppk-vs-rtk/",
        "logo": "https://encrypted-tbn1.gstatic.com/favicon-tbn?q=tbn:ANd9GcTNV33vg9eOKdK3IItijTo0CjIoVAK2c9OzzYXzVXS1gtbyE61651a9drsxjJW2yC0K7rfttJXAP3g7_LZ0wmwPHQOmepn9z-zIMHJDGlgrijHfNKFESgc",
        "source": "ArduSimple",
        "image": "https://encrypted-tbn1.gstatic.com/images?q=tbn:ANd9GcS0cxDcJbc9ypZFOS_APjj_8Xzy-gGHG-wbSV_WR0Wn0-tqUAVf",
        "image_url": "https://encrypted-tbn1.gstatic.com/images?q=tbn:ANd9GcS0cxDcJbc9ypZFOS_APjj_8Xzy-gGHG-wbSV_WR0Wn0-tqUAVf",
        "rank": 57,
        "global_rank": 57
      },
      {
        "title": "services — New Horizons Fellowship Church",
        "link": "https://www.nhfchurch.com/services",
        "logo": "https://encrypted-tbn0.gstatic.com/favicon-tbn?q=tbn:ANd9GcTx3EZkS6f0vTYrOCdoVKZ0ixnXJfk3j5vGiEvhGHSQu_S0tK-En_lsD39BVN-vCPey0Az03DUsK682x59bi7rV2Ak9QaYX15hZYCqn6_QGaKllETzKFw",
        "source": "nhfchurch.com",
        "image": "https://encrypted-tbn2.gstatic.com/images?q=tbn:ANd9GcSd-3Ystky8B46WBC0gNQABC8vpOxd9wmxTIUeTIBkExCpwHtET",
        "image_url": "https://encrypted-tbn2.gstatic.com/images?q=tbn:ANd9GcSd-3Ystky8B46WBC0gNQABC8vpOxd9wmxTIUeTIBkExCpwHtET",
        "rank": 58,
        "global_rank": 58
      },
      {
        "title": "YouTube Logo (2017-current) - YouTube",
        "link": "https://www.youtube.com/watch?v=qGkE0wz2dwY",
        "logo": "https://encrypted-tbn0.gstatic.com/favicon-tbn?q=tbn:ANd9GcQHQslzHLLyLc_qne5jxn7JocidlmUPyegZ8ojX3WVlorFk8BxW9a3vJWjDzN99UHVTqSaNBj_-6XykhxuVQfF3Ye7xScSWSuc2QHXi0a12CkVwBmo",
        "source": "YouTube",
        "image": "https://encrypted-tbn3.gstatic.com/images?q=tbn:ANd9GcSrIsvSRQmUafGp12uSG_RsufFOOqUxiuk1fYHDoW5gUqWAzpUz",
        "image_url": "https://encrypted-tbn3.gstatic.com/images?q=tbn:ANd9GcSrIsvSRQmUafGp12uSG_RsufFOOqUxiuk1fYHDoW5gUqWAzpUz",
        "rank": 59,
        "global_rank": 59
      },
      {
        "title": "Kristeen Garcia - Google | LinkedIn",
        "link": "https://www.linkedin.com/in/kristeen-garcia-6879a73b",
        "logo": "https://encrypted-tbn3.gstatic.com/favicon-tbn?q=tbn:ANd9GcTFMvFisG5Yfyq07VS0hk1otTr6uQvufSrlgYLzmBkZlxd7MQh66ZmKRUOdwfXrertN7RslYSLWGQCDyxLn3JsHLob5z5LPzTRUUQlVmSHaBnVJlJa8",
        "source": "LinkedIn",
        "image": "https://encrypted-tbn2.gstatic.com/images?q=tbn:ANd9GcQTy_qmt5vLpWNHYFG0-Lswj8W_w9tqvcuXY9-9zmjyLrBEa_5h",
        "image_url": "https://encrypted-tbn2.gstatic.com/images?q=tbn:ANd9GcQTy_qmt5vLpWNHYFG0-Lswj8W_w9tqvcuXY9-9zmjyLrBEa_5h",
        "rank": 60,
        "global_rank": 60
      }
    ]
  }
  ```
</ResponseExample>


# Exact matches
Source: https://docs.brightdata.com/api-reference/serp/google-lens/exact-matches

Configure the Bright Data Google Lens Exact Matches parameter to refine queries and return matching results as JSON or HTML. On port 44445.

```txt wrap theme={null}
https://lens.google.com/uploadbyurl?url=https%3A%2F%2Fwww.youtube.com%2Fimg%2Fdesktop%2Fyt_1200.png&brd_lens=exact_matches
```

## Parameters

<ParamField type="query">
  URL of image you want to search
</ParamField>

<ParamField type="string">
  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`).

  ```txt wrap theme={null}
  https://lens.google.com/uploadbyurl?url=https%3A%2F%2Fwww.youtube.com%2Fimg%2Fdesktop%2Fyt_1200.png&brd_lens=exact_matches
  ```
</ParamField>

<RequestExample>
  ```shell cURL highlight={6} theme={null}
    curl -X POST https://api.brightdata.com/request \
    --header "Content-Type: application/json" \
    --header "Authorization: Bearer API_KEY" \
    --data '{
      "zone": "serp_api1",
      "url": "https://lens.google.com/uploadbyurl?url=https%3A%2F%2Fwww.youtube.com%2Fimg%2Fdesktop%2Fyt_1200.png&brd_lens=exact_matches",
      "format": "raw"
    }'
  ```

  ```shell Native proxy highlight={4} theme={null}
  curl --proxy brd.superproxy.io:44445 \
    --proxy-user CUSTOMER_USERNAME:CUSTOMER_PASSWORD \
    --ssl-no-revoke \
    "https://lens.google.com/uploadbyurl?url=https%3A%2F%2Fwww.youtube.com%2Fimg%2Fdesktop%2Fyt_1200.png&brd_lens=exact_matches"
  ```

  ```js Node.js highlight={10} theme={null}
  (async () => {
    const response = await fetch('https://api.brightdata.com/request', {
      method: 'POST',
      headers: {
        'Content-Type': 'application/json',
        'Authorization': 'Bearer API_KEY'
      },
      body: JSON.stringify({
        zone: 'serp_api1',
        url: 'https://lens.google.com/uploadbyurl?url=https%3A%2F%2Fwww.youtube.com%2Fimg%2Fdesktop%2Fyt_1200.png&brd_lens=exact_matches',
        format: 'raw'
      })
    });
    
    const data = await response.text();
    console.log(data);
  })();
  ```

  ```python Python highlight={11} theme={null}
  import requests

  # API Configuration
  headers = {
      'Content-Type': 'application/json',
      'Authorization': 'Bearer API_KEY',
  }

  payload = {
      'zone': 'serp_api1',
      'url': 'https://lens.google.com/uploadbyurl?url=https%3A%2F%2Fwww.youtube.com%2Fimg%2Fdesktop%2Fyt_1200.png&brd_lens=exact_matches',
      'format': 'raw'
  }

  # Make the request
  response = requests.post(
      'https://api.brightdata.com/request', 
      json=payload, 
      headers=headers
  )

  print(response.text)
  ```
</RequestExample>

<ResponseExample>
  ```json 200 highlight={5} theme={null}
  {
    "general": {
      "language": "en",
      "mode": "search",
      "type": "exact_matches"
    },
    "tabs": [
      {
        "name": "AI Mode",
        "link": "https://www.google.com/search?sa=X&sca_esv=2dc65c8cbd5d287b&lns_surface=26&biw=1060&bih=1095&hl=en&gl=us&udm=50&vsrid=CNeD0ePDsf-PugEQAhgBIiRiYmRjMDRlOC04YzcwLTRjZDAtYWUzNi1iMzAyYWQyMGY0M2MyBiICcHcoHDiYp4b09PySA1AA&vsint=CAIqDAoCCAcSAggKGAEgATojChYNAAAAPxUAAAA_HQAAgD8lAACAPzABEIAIGIAIJQAAgD8&lns_mode=un&source=lns.web.gsbubu&vsdim=1024,1024&gsessionid=fEUg-2t0DWAPdWWQnNYlwye88VeRdG-Q3ryaW-kJC7VZkm8UN79RVQ&lsessionid=LpJLEfXiJ2BaHlGUfp7QHwMAzKrkYM_GI7nGrYtEkxI3UVsA6QtSGA&fbs=ADc_l-Yv0YTTwuvIVYRVntg99Yl4C2siJayzZyC50sFnWwRH6ow_bxUxJgqfeyXucYwXL8BodgQvcQKf4r6af6eJrUBEJPcPla2xArZ4O2zHdIqqQ1YVgeUF-eZ8YfKEFkJDuGVjK7bY&q=&aep=1&ntc=1&ved=2ahUKEwiixqr19PySAxXrETQIHYm2EFEQ2J8OegQIBBAD"
      },
      {
        "name": "All",
        "type": "all",
        "link": "https://www.google.com/search?sa=X&sca_esv=2dc65c8cbd5d287b&lns_surface=26&biw=1060&bih=1095&hl=en&gl=us&udm=26&vsrid=CNeD0ePDsf-PugEQAhgBIiRiYmRjMDRlOC04YzcwLTRjZDAtYWUzNi1iMzAyYWQyMGY0M2MyBiICcHcoHDiYp4b09PySA1AA&vsint=CAIqDAoCCAcSAggKGAEgATojChYNAAAAPxUAAAA_HQAAgD8lAACAPzABEIAIGIAIJQAAgD8&lns_mode=un&source=lns.web.gsbubu&vsdim=1024,1024&gsessionid=fEUg-2t0DWAPdWWQnNYlwye88VeRdG-Q3ryaW-kJC7VZkm8UN79RVQ&lsessionid=LpJLEfXiJ2BaHlGUfp7QHwMAzKrkYM_GI7nGrYtEkxI3UVsA6QtSGA&q=&ved=2ahUKEwiixqr19PySAxXrETQIHYm2EFEQs6gLegQICBAB"
      },
      {
        "name": "Exact matches",
        "type": "exact_matches",
        "selected": true
      },
      {
        "name": "Visual matches",
        "type": "visual_matches",
        "link": "https://www.google.com/search?sa=X&sca_esv=2dc65c8cbd5d287b&lns_surface=26&biw=1060&bih=1095&hl=en&gl=us&udm=44&vsrid=CNeD0ePDsf-PugEQAhgBIiRiYmRjMDRlOC04YzcwLTRjZDAtYWUzNi1iMzAyYWQyMGY0M2MyBiICcHcoHDiYp4b09PySA1AA&vsint=CAIqDAoCCAcSAggKGAEgATojChYNAAAAPxUAAAA_HQAAgD8lAACAPzABEIAIGIAIJQAAgD8&lns_mode=un&source=lns.web.gsbubu&vsdim=1024,1024&gsessionid=fEUg-2t0DWAPdWWQnNYlwye88VeRdG-Q3ryaW-kJC7VZkm8UN79RVQ&lsessionid=LpJLEfXiJ2BaHlGUfp7QHwMAzKrkYM_GI7nGrYtEkxI3UVsA6QtSGA&q=&ved=2ahUKEwiixqr19PySAxXrETQIHYm2EFEQs6gLegQIBhAB"
      },
      {
        "name": "About this image",
        "type": "about",
        "link": "https://www.google.com/search/about-this-image?img=H4sIAAAAAAAAAFPy4vLguN588fHhjf_7dzEKMEkwKqkkJaUkG5ikWuhaJJsb6JokpxjoJqYam-kmGRsYJaYYGaSZGCcbsSkxFZRryFjMWN725cufScwBDACKWlZTTAAAAA&sa=X&ved=2ahUKEwiixqr19PySAxXrETQIHYm2EFEQs6gLegQIBxAB"
      }
    ],
    "exact_matches": [
      {
        "title": "MRU's YouTube Channel - Emissions Analyzers",
        "link": "https://mru-instruments.com/inthenews/mrus-youtube-channel/",
        "extensions": [
          "Sep 14, 2020",
          "1,140x500"
        ],
        "source": "MRU Instruments",
        "logo": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAACAAAA...",
        "image": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAVMAAA...",
        "image_base64": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAVMAAA...",
        "rank": 1,
        "global_rank": 1
      },
      {
        "title": "Subscribe to out YouTube Channel - Connected Community Schools",
        "link": "https://connectedcommunityschools.org/subscribe-to-out-youtube-channel/",
        "extensions": [
          "980x595"
        ],
        "source": "Connected Community Schools",
        "logo": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAABwAAA...",
        "image": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQABAAD/2w...",
        "image_base64": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQABAAD/2w...",
        "rank": 2,
        "global_rank": 2
      },
      {
        "title": "YouTube | Nintendo Switch download software | Games",
        "link": "https://www.nintendo.com/en-gb/Games/Nintendo-Switch-download-software/YouTube-1467860.html",
        "extensions": [
          "Aug 11, 2018",
          "2,000x1,000"
        ],
        "source": "Nintendo",
        "logo": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAABwAAA...",
        "image": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAT4AAA...",
        "image_base64": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAT4AAA...",
        "rank": 3,
        "global_rank": 3
      },
      {
        "title": "YouTube says that music is now 25% of its global watch time",
        "link": "https://musically.com/2021/09/16/youtube-says-that-music-is-now-25-of-its-global-watch-time/",
        "extensions": [
          "Sep 16, 2021",
          "780x260"
        ],
        "source": "Music Ally",
        "logo": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAABwAAA...",
        "image": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAYUAAA...",
        "image_base64": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAYUAAA...",
        "rank": 4,
        "global_rank": 4
      },
      {
        "title": "YouTube Music gets background listening for free users in Canada",
        "link": "https://musically.com/2021/10/05/youtube-music-gets-background-listening-for-free-users-in-canada/",
        "extensions": [
          "Oct 5, 2021",
          "780x260"
        ],
        "source": "Music Ally",
        "logo": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAABwAAA...",
        "image": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAYUAAA...",
        "image_base64": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAYUAAA...",
        "rank": 5,
        "global_rank": 5
      },
      {
        "title": "Industry figures hail YouTube Music's 50m-subscribers milestone",
        "link": "https://musically.com/2021/09/03/industry-hail-youtube-subscribers/",
        "extensions": [
          "Sep 3, 2021",
          "780x260"
        ],
        "source": "Music Ally",
        "logo": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAABwAAA...",
        "image": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAYUAAA...",
        "image_base64": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAYUAAA...",
        "rank": 6,
        "global_rank": 6
      },
      {
        "title": "Social Media Tutorials - Visual One Law",
        "link": "https://visualonelaw.com/social-media-tutorials/",
        "extensions": [
          "1,730x580"
        ],
        "source": "Visualonelaw",
        "logo": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAACAAAA...",
        "image": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAYQAAA...",
        "image_base64": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAYQAAA...",
        "rank": 7,
        "global_rank": 7
      },
      {
        "title": "How to restore Dislikes in Youtube - Hardware Busters",
        "link": "https://hwbusters.com/news/how-to-restore-dislikes-in-youtube/",
        "extensions": [
          "Aug 26, 2022",
          "1,920x720"
        ],
        "source": "Hardware Busters",
        "logo": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAABwAAA...",
        "image": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAW8AAA...",
        "image_base64": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAW8AAA...",
        "rank": 8,
        "global_rank": 8
      },
      {
        "title": "Adverts On Youtube - Can You Avoid Them On Your Video?",
        "link": "https://www.media2u.co.uk/adverts-on-youtube-can-you-avoid-them-on-your-video/",
        "extensions": [
          "Apr 20, 2022",
          "867x266"
        ],
        "source": "Media2u",
        "logo": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAABwAAA...",
        "image": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAZYAAA...",
        "image_base64": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAZYAAA...",
        "rank": 9,
        "global_rank": 9
      },
      {
        "title": "AI Overviews Are Coming To YouTube In New Test",
        "link": "https://www.tulsamarketingonline.com/ai-overviews-are-coming-to-youtube-in-new-test/",
        "extensions": [
          "Apr 25, 2025",
          "707x190"
        ],
        "source": "Tulsa Marketing Online",
        "logo": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAABwAAA...",
        "image": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQABAAD/2w...",
        "image_base64": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQABAAD/2w...",
        "rank": 10,
        "global_rank": 10
      },
      {
        "title": "YouTube | Hitler Parody Wiki - Fandom",
        "link": "https://hitlerparody.fandom.com/wiki/YouTube",
        "extensions": [
          "1,200x393"
        ],
        "source": "Hitler Parody Wiki",
        "logo": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQABAAD/2w...",
        "image": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAYkAAA...",
        "image_base64": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAYkAAA...",
        "rank": 11,
        "global_rank": 11
      },
      {
        "title": "Subscribe to our YouTube channel - Tataylino.com",
        "link": "https://tataylino.com/subscribe-to-our-youtube-channel/",
        "extensions": [
          "Apr 16, 2019",
          "640x164"
        ],
        "source": "Tataylino.com",
        "logo": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAACAAAA...",
        "image": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcR_psUGnh3vZ3sXlJw7jVAYoSuR71ZdDi4qIbGUb0Mro34k51pRhFgRIZ0&s",
        "image_url": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcR_psUGnh3vZ3sXlJw7jVAYoSuR71ZdDi4qIbGUb0Mro34k51pRhFgRIZ0&s",
        "rank": 12,
        "global_rank": 12
      },
      {
        "title": "In the Asian Evening, Singapore, Jakarta, Manila and North. On ...",
        "link": "https://x.com/tomkeene/status/1821308177930969460",
        "extensions": [
          "Aug 7, 2024",
          "1,200x300"
        ],
        "source": "X",
        "logo": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAABwAAA...",
        "image": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcQ-4GOC0vgtX2GCD65XyX5eT2urI45FymFw1Uhdwathjbw3GKVDaw8QEto&s",
        "image_url": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcQ-4GOC0vgtX2GCD65XyX5eT2urI45FymFw1Uhdwathjbw3GKVDaw8QEto&s",
        "rank": 13,
        "global_rank": 13
      },
      {
        "title": "How to: YouTube Marketing - Snob Monkey",
        "link": "https://snobmonkey.com/how-to-youtube-marketing/",
        "extensions": [
          "Jul 12, 2021",
          "1,920x720"
        ],
        "source": "Snob Monkey",
        "logo": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAABwAAA...",
        "image": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcTlRMnxh88z62FES3D7rsZSN2WmKodtzDXtKPnF8veHWW0EnOGZDIFnOkut&s",
        "image_url": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcTlRMnxh88z62FES3D7rsZSN2WmKodtzDXtKPnF8veHWW0EnOGZDIFnOkut&s",
        "rank": 14,
        "global_rank": 14
      },
      {
        "title": "The differences between RTK and PPK. Which method is best for ...",
        "link": "https://www.ardusimple.com/ppk-vs-rtk/",
        "extensions": [
          "1,000x400"
        ],
        "source": "ArduSimple",
        "logo": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAABwAAA...",
        "image": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcRTSOfaprHZdVN8UCo8I3KGyyCdaDUgKmETI7BVYwD8EnDpTH2304GR6ic9&s",
        "image_url": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcRTSOfaprHZdVN8UCo8I3KGyyCdaDUgKmETI7BVYwD8EnDpTH2304GR6ic9&s",
        "rank": 15,
        "global_rank": 15
      },
      {
        "title": "YouTube Logo and the history of the company - LogoMyWay",
        "link": "https://blog.logomyway.com/youtube-logo/",
        "extensions": [
          "707x190"
        ],
        "source": "LogoMyWay",
        "logo": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAB0AAA...",
        "image": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcQy3L_1DMIwi0fIZCfLDMfL7RIVAXgCx6_y7OhadkHjSkbYZxY0xjirBAA&s",
        "image_url": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcQy3L_1DMIwi0fIZCfLDMfL7RIVAXgCx6_y7OhadkHjSkbYZxY0xjirBAA&s",
        "rank": 16,
        "global_rank": 16
      },
      {
        "title": "Some of My Favorite YouTube Channels - The \"Make Do\" Homemaker",
        "link": "http://makedohomemaker.blogspot.com/2024/04/some-of-my-favorite-youtube-channels.html",
        "extensions": [
          "Apr 16, 2024",
          "1,125x360"
        ],
        "source": "The \"Make Do\" Homemaker",
        "logo": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAABwAAA...",
        "image": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcSywszzbKDZNevDZGLNeU9tv7P4y8wFTXWt_WF17cZxi9O7H_TFXrx4RsA&s",
        "image_url": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcSywszzbKDZNevDZGLNeU9tv7P4y8wFTXWt_WF17cZxi9O7H_TFXrx4RsA&s",
        "rank": 17,
        "global_rank": 17
      },
      {
        "title": "Others - Tataylino.com",
        "link": "https://tataylino.com/category/others/",
        "extensions": [
          "Sep 30, 2020",
          "640x164"
        ],
        "source": "Tataylino.com",
        "logo": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAACAAAA...",
        "image": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcR_psUGnh3vZ3sXlJw7jVAYoSuR71ZdDi4qIbGUb0Mro34k51pRhFgRIZ0&s",
        "image_url": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcR_psUGnh3vZ3sXlJw7jVAYoSuR71ZdDi4qIbGUb0Mro34k51pRhFgRIZ0&s",
        "rank": 18,
        "global_rank": 18
      }
    ]
  }
  ```
</ResponseExample>


# Geo location
Source: https://docs.brightdata.com/api-reference/serp/google-lens/geo-location

Configure the Bright Data Google Lens Geo Location parameter to refine queries and return matching results as JSON or HTML. On port 44445.

```txt wrap theme={null}
https://lens.google.com/uploadbyurl?url=https%3A%2F%2Fwww.youtube.com%2Fimg%2Fdesktop%2Fyt_1200.png&uule=w+CAIQICINVW5pdGVkK1N0YXRlcw
```

## Parameters

<ParamField type="query">
  URL of image you want to search
</ParamField>

<ParamField type="string">
  Stands for the encoded location you want to use for your search and will be used to change geo-location.

  ```http theme={null}
  https://www.google.com/search?q=pizza&uule=w+CAIQICINVW5pdGVkK1N0YXRlcw
  ```

  <Tip>
    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`
  </Tip>
</ParamField>

<RequestExample>
  ```shell cURL highlight={6} theme={null}
    curl -X POST https://api.brightdata.com/request \
    --header "Content-Type: application/json" \
    --header "Authorization: Bearer API_KEY" \
    --data '{
      "zone": "serp_api1",
      "url": "https://lens.google.com/uploadbyurl?url=https%3A%2F%2Fwww.youtube.com%2Fimg%2Fdesktop%2Fyt_1200.png&hl=de",
      "format": "raw"
    }'
  ```

  ```shell Native proxy highlight={4} theme={null}
  curl --proxy brd.superproxy.io:44445 \
    --proxy-user CUSTOMER_USERNAME:CUSTOMER_PASSWORD \
    --ssl-no-revoke \
    "https://lens.google.com/uploadbyurl?url=https%3A%2F%2Fwww.youtube.com%2Fimg%2Fdesktop%2Fyt_1200.png"
  ```

  ```js Node.js highlight={10} theme={null}
  (async () => {
    const response = await fetch('https://api.brightdata.com/request', {
      method: 'POST',
      headers: {
        'Content-Type': 'application/json',
        'Authorization': 'Bearer API_KEY'
      },
      body: JSON.stringify({
        zone: 'serp_api1',
        url: 'https://lens.google.com/uploadbyurl?url=https%3A%2F%2Fwww.youtube.com%2Fimg%2Fdesktop%2Fyt_1200.png&hl=de',
        format: 'raw'
      })
    });
    
    const data = await response.text();
    console.log(data);
  })();
  ```

  ```python Python highlight={11} theme={null}
  import requests

  # API Configuration
  headers = {
      'Content-Type': 'application/json',
      'Authorization': 'Bearer API_KEY',
  }

  payload = {
      'zone': 'serp_api1',
      'url': 'https://lens.google.com/uploadbyurl?url=https%3A%2F%2Fwww.youtube.com%2Fimg%2Fdesktop%2Fyt_1200.png&hl=de',
      'format': 'raw'
  }

  # Make the request
  response = requests.post(
      'https://api.brightdata.com/request', 
      json=payload, 
      headers=headers
  )

  print(response.text)
  ```
</RequestExample>

<ResponseExample>
  ```json 200 theme={null}
  {
    "general": {
      "language": "en",
      "mode": "search",
      "type": "all"
    },
    "tabs": [
      {
        "name": "AI Mode",
        "link": "https://www.google.com/search?sca_esv=b5143ed2853990e4&lns_surface=26&biw=1037&bih=919&hl=en&gl=US&udm=50&vsrid=CNWSwa6dvb26MRACGAEiJGZjZmVkMTA5LWU1YjUtNGY2MS1hZmM3LTcyYzUyYjQ0NmY0MDIGIgJyZCgUOI2kxu-TkpMD&vsint=CAIqDAoCCAcSAggKGAEgATojChYNAAAAPxUAAAA_HQAAgD8lAACAPzABEIAIGIAIJQAAgD8&lns_mode=un&source=lns.web.gsbubu&vsdim=1024,1024&gsessionid=DZR50JQYyMxbQJrvq7PeV_MY0rIByGIyG3idXE9XvEwv8h4VM8wPfQ&lsessionid=10HbqH5rQCTpEG8xd9XfsRcHLz-290cV44RmAYO_JKusBKWhwkH5Og&fbs=ADc_l-Yv0YTTwuvIVYRVntg99Yl4C2siJayzZyC50sFnWwRH6ow_bxUxJgqfeyXucYwXL8BodgQvcQKf4r6af6eJrUBEJPcPla2xArZ4O2zHdIqqQ1YVgeUF-eZ8YfKEFkJDuGVjK7bY&q=&aep=1&ntc=1&sa=X&ved=2ahUKEwi_y5jwk5KTAxUBcvEDHb79Jl0Q2J8OegQIDxAD"
      },
      {
        "name": "All",
        "type": "all",
        "selected": true
      },
      {
        "name": "Exact matches",
        "type": "exact_matches",
        "link": "https://www.google.com/search?sca_esv=b5143ed2853990e4&lns_surface=26&biw=1037&bih=919&hl=en&gl=US&udm=48&vsrid=CNWSwa6dvb26MRACGAEiJGZjZmVkMTA5LWU1YjUtNGY2MS1hZmM3LTcyYzUyYjQ0NmY0MDIGIgJyZCgUOI2kxu-TkpMD&vsint=CAIqDAoCCAcSAggKGAEgATojChYNAAAAPxUAAAA_HQAAgD8lAACAPzABEIAIGIAIJQAAgD8&lns_mode=un&source=lns.web.gsbubu&vsdim=1024,1024&gsessionid=DZR50JQYyMxbQJrvq7PeV_MY0rIByGIyG3idXE9XvEwv8h4VM8wPfQ&lsessionid=10HbqH5rQCTpEG8xd9XfsRcHLz-290cV44RmAYO_JKusBKWhwkH5Og&vsrid=CNWSwa6dvb26MRACGAEiJGMzZDNlNmUzLTFmY2MtNGE1MC05ZjQ5LTkxY2QzNDg0NzI2NTIGIgJyZCgUOI2kxu-TkpMDUAA&q=&sa=X&ved=2ahUKEwi_y5jwk5KTAxUBcvEDHb79Jl0Qs6gLegQIEhAB"
      },
      {
        "name": "Visual matches",
        "type": "visual_matches",
        "link": "https://www.google.com/search?sca_esv=b5143ed2853990e4&lns_surface=26&biw=1037&bih=919&hl=en&gl=US&udm=44&vsrid=CNWSwa6dvb26MRACGAEiJGZjZmVkMTA5LWU1YjUtNGY2MS1hZmM3LTcyYzUyYjQ0NmY0MDIGIgJyZCgUOI2kxu-TkpMD&vsint=CAIqDAoCCAcSAggKGAEgATojChYNAAAAPxUAAAA_HQAAgD8lAACAPzABEIAIGIAIJQAAgD8&lns_mode=un&source=lns.web.gsbubu&vsdim=1024,1024&gsessionid=DZR50JQYyMxbQJrvq7PeV_MY0rIByGIyG3idXE9XvEwv8h4VM8wPfQ&lsessionid=10HbqH5rQCTpEG8xd9XfsRcHLz-290cV44RmAYO_JKusBKWhwkH5Og&q=&sa=X&ved=2ahUKEwi_y5jwk5KTAxUBcvEDHb79Jl0Qs6gLegQIExAB"
      },
      {
        "name": "About this image",
        "type": "about",
        "link": "https://www.google.com/search/about-this-image?img=H4sIAAAAAAAAAFPy5HLnuDrp4Lq5e_fuMhRgkmBUUklLTktNMTSw1E01TTLVNUkzM9RNTEs21zU3SjY1SjIxMUszMTBiU2IqStEQsehdcuz95EmTmQMYACLVmXhLAAAA&sa=X&ved=2ahUKEwi_y5jwk5KTAxUBcvEDHb79Jl0Qs6gLegQIERAB"
      }
    ],
    "images": [
      {
        "title": "Youtube Live Streaming – Varvid",
        "link": "https://varvid.com/broadcast-platforms/youtube/",
        "logo": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAACAAAA...",
        "source": "varvid.com",
        "image": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAZ8AAA...",
        "image_base64": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAZ8AAA...",
        "rank": 1,
        "global_rank": 1
      },
      {
        "title": "YouTube - App on Amazon Appstore",
        "link": "https://www.amazon.com/Google-LLC-YouTube/dp/B07T771SPH",
        "logo": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAACAAAA...",
        "source": "Amazon.com",
        "image": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAOEAAA...",
        "image_base64": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAOEAAA...",
        "rank": 2,
        "global_rank": 2
      },
      {
        "title": "How to Turn On Comments on YouTube Channel [Guide] - YouTube",
        "link": "https://www.youtube.com/watch?v=RlIZ4-RaLpY",
        "logo": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAACAAAA...",
        "source": "YouTube",
        "image": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAQMAAA...",
        "image_base64": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAQMAAA...",
        "rank": 3,
        "global_rank": 3
      },
      {
        "title": "YouTube (YouTube channel) - Wikipedia",
        "link": "https://en.wikipedia.org/wiki/YouTube_(YouTube_channel)",
        "logo": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAACAAAA...",
        "source": "Wikipedia",
        "image": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAOEAAA...",
        "image_base64": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAOEAAA...",
        "rank": 4,
        "global_rank": 4
      },
      {
        "title": "really hard question here: whats even the purpose of this ad ...",
        "link": "https://www.reddit.com/r/youtube/comments/1pxov43/really_hard_question_here_whats_even_the_purpose/",
        "logo": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAACAAAA...",
        "source": "Reddit",
        "image": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAVQAAA...",
        "image_base64": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAVQAAA...",
        "rank": 5,
        "global_rank": 5
      },
      {
        "title": "How to Message Someone on YouTube",
        "link": "https://www.howtogeek.com/738001/how-to-message-someone-on-youtube/",
        "logo": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAACAAAA...",
        "source": "How-To Geek",
        "image": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQABAAD/2w...",
        "image_base64": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQABAAD/2w...",
        "rank": 6,
        "global_rank": 6
      },
      {
        "title": "Worship – New Horizons Christian Church",
        "link": "https://newhorizonschristianchurch.com/worship/",
        "logo": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAACAAAA...",
        "source": "New Horizons Christian Church",
        "image": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAcAAAA...",
        "image_base64": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAcAAAA...",
        "rank": 7,
        "global_rank": 7
      },
      {
        "title": "File:YouTube logo upside down.jpg - Wikipedia",
        "link": "https://en.wikipedia.org/wiki/File:YouTube_logo_upside_down.jpg",
        "logo": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAACAAAA...",
        "source": "Wikipedia",
        "image": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQABAAD/2w...",
        "image_base64": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQABAAD/2w...",
        "rank": 8,
        "global_rank": 8
      },
      {
        "title": "Videos - Springdale FWB - Springdale Free Will Baptist Church",
        "link": "https://www.springdalefwb.org/videos.html",
        "logo": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAACAAAA...",
        "source": "Springdale Free Will Baptist Church",
        "image": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAa8AAA...",
        "image_base64": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAa8AAA...",
        "rank": 9,
        "global_rank": 9
      },
      {
        "title": "YouTube, the online video powerhouse, turns 20 - The ...",
        "link": "https://www.businesstimes.com.sg/international/youtube-online-video-powerhouse-turns-20",
        "logo": "https://encrypted-tbn2.gstatic.com/favicon-tbn?q=tbn:ANd9GcT5N3_bzDYGNT2jalJYdfr8L458W6cjkhi7txmPQNCeYfAwLKYRa01dM-1pEzcSfDW9pLGzZVqOTTADpX0dGNxRFd-qULiLJ4xB7jcbYT_Ofd46fyEd3LyVL-1j2Po",
        "source": "The Business Times",
        "image": "https://encrypted-tbn3.gstatic.com/images?q=tbn:ANd9GcTpth80AXpzNoCU2kpFOoxi-CSR7bwLgBrwa2ZvU_gI9jCormwe",
        "image_url": "https://encrypted-tbn3.gstatic.com/images?q=tbn:ANd9GcTpth80AXpzNoCU2kpFOoxi-CSR7bwLgBrwa2ZvU_gI9jCormwe",
        "rank": 10,
        "global_rank": 10
      },
      {
        "title": "As disinformation and hate thrive online, YouTube quietly ...",
        "link": "https://www.cbc.ca/news/entertainment/youtube-content-moderation-rules-1.7559931",
        "logo": "https://encrypted-tbn2.gstatic.com/favicon-tbn?q=tbn:ANd9GcSXNmMtLoL3Z6BddLurw0e_OAJKtMjmtSQOZ6A7NlD45zcbWRzY7f2GBGKzdX9IKdw7C9AbyIREv9irUlf46b-SQExzT2Vi01mKo8Ei1jo2",
        "source": "CBC",
        "image": "https://encrypted-tbn2.gstatic.com/images?q=tbn:ANd9GcTG8Yr3O3bHwxq33pMWvAJPw4Tyz-Yg7PGceA4e0l2Hne4vKeED",
        "image_url": "https://encrypted-tbn2.gstatic.com/images?q=tbn:ANd9GcTG8Yr3O3bHwxq33pMWvAJPw4Tyz-Yg7PGceA4e0l2Hne4vKeED",
        "rank": 11,
        "global_rank": 11
      },
      {
        "title": "YouTube is getting a dynamic new look, no matter where you ...",
        "link": "https://www.androidpolice.com/youtube-new-look-new-features-web-mobile-tvs/",
        "logo": "https://encrypted-tbn1.gstatic.com/favicon-tbn?q=tbn:ANd9GcRh-53vY1i8heyMuwxhs4Rh2bAOMAEhKGRMSyNqK3XnCg8XxR6fsmw51vJ1BdWTmU0zdaBZKX0INk_QSxu8WtbQpVSnvw7AvcHACAbySI8alifLtpZD7BW9J6s",
        "source": "Android Police",
        "image": "https://encrypted-tbn3.gstatic.com/images?q=tbn:ANd9GcSN6xABbWVsaoYSrrb3HJASKCExp3mmdNc7_Gf22OtW4h_5_9DQ",
        "image_url": "https://encrypted-tbn3.gstatic.com/images?q=tbn:ANd9GcSN6xABbWVsaoYSrrb3HJASKCExp3mmdNc7_Gf22OtW4h_5_9DQ",
        "rank": 12,
        "global_rank": 12
      },
      {
        "title": "Someone just broke YouTube! 🤯 This video is over 1.2 ...",
        "link": "https://www.instagram.com/p/DTcugJjkbhE/",
        "logo": "https://encrypted-tbn3.gstatic.com/favicon-tbn?q=tbn:ANd9GcSpoKX-MM8KwYvjLm-JRx4G0Kwl8RLkE48NjkNQo2Gq3SC32GSp-nb0Bv1Gwdg0bIZuT7qIQcsQnlAbeKhfDsUARVp1OzzHay_AKGuFGTR9Of3S2pacaw",
        "source": "Instagram",
        "image": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcR-A9yKAxNvhWfCefDoHRIKNCAL4C3rqCrAG7tRnddJa3G5J1TQ",
        "image_url": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcR-A9yKAxNvhWfCefDoHRIKNCAL4C3rqCrAG7tRnddJa3G5J1TQ",
        "rank": 13,
        "global_rank": 13
      },
      {
        "title": "YouTube now second only to BBC as most popular media ...",
        "link": "https://www.bbc.co.uk/news/articles/c4gzvee78eqo",
        "logo": "https://encrypted-tbn2.gstatic.com/favicon-tbn?q=tbn:ANd9GcQkfkHsgY8lS21mPHFUbDtwW6Et_KFgAwjd1eumnE7PsvEhqdw6Kv69JwDtX9AXmV8-fm6t54pB8PATe-Pzv5BHmyDELvrJFZqQ7nx8_vZwcD6x",
        "source": "BBC",
        "image": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcS75k2PhGgSWUgIpGDWZESBMOoZJh5Rz0RyjgaxkwEN6peMudvE",
        "image_url": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcS75k2PhGgSWUgIpGDWZESBMOoZJh5Rz0RyjgaxkwEN6peMudvE",
        "rank": 14,
        "global_rank": 14
      },
      {
        "title": "Top 10 most-subscribed YouTube channels | Mashable",
        "link": "https://mashable.com/article/most-subscribed-youtube-channels",
        "logo": "https://encrypted-tbn0.gstatic.com/favicon-tbn?q=tbn:ANd9GcQ7RhLwgx1nFu2wvGlmXALP-5gdBSTAHTHo61tnylb_OE1TylgB9waP9v2lwGMa7cFseQ8lC1ie7GmQqDNfEnPNHgu6SULXkGK45bLtSjMho3Q",
        "source": "Mashable",
        "image": "https://encrypted-tbn2.gstatic.com/images?q=tbn:ANd9GcTmWpdRF4lk_Sk9GFHAFu_Vr3vdVTLq3aNnjsDUpqgo4sKN1Z-L",
        "image_url": "https://encrypted-tbn2.gstatic.com/images?q=tbn:ANd9GcTmWpdRF4lk_Sk9GFHAFu_Vr3vdVTLq3aNnjsDUpqgo4sKN1Z-L",
        "rank": 15,
        "global_rank": 15
      },
      {
        "title": "YouTube launches its biggest live update: What's new with AI ...",
        "link": "https://timesofindia.indiatimes.com/technology/tech-news/youtube-launches-its-biggest-live-update-whats-new-with-ai-shorts-and-latest-streaming-tools/articleshow/123939418.cms",
        "logo": "https://encrypted-tbn0.gstatic.com/favicon-tbn?q=tbn:ANd9GcQGahxRW9Oc075lMrHzhtYmwFLaO-CZMJ16aIR6QABQBjrURgF1kzgixv8P1D_g-AGpqo-qfCqp4WFV8-cCam-9iz92wPK-i8aGInj83AiKehqzZgsxHSZf6aB-G6dehTI",
        "source": "Indiatimes",
        "image": "https://encrypted-tbn1.gstatic.com/images?q=tbn:ANd9GcSmYEqxKCvnDXuWiIRff3LPC-AI74uC0PlwIfkrPnypv9TTJ8GK",
        "image_url": "https://encrypted-tbn1.gstatic.com/images?q=tbn:ANd9GcSmYEqxKCvnDXuWiIRff3LPC-AI74uC0PlwIfkrPnypv9TTJ8GK",
        "rank": 16,
        "global_rank": 16
      },
      {
        "title": "Shannon Ong - Google | LinkedIn",
        "link": "https://www.linkedin.com/in/shannon-ong-44887053",
        "logo": "https://encrypted-tbn3.gstatic.com/favicon-tbn?q=tbn:ANd9GcTFMvFisG5Yfyq07VS0hk1otTr6uQvufSrlgYLzmBkZlxd7MQh66ZmKRUOdwfXrertN7RslYSLWGQCDyxLn3JsHLob5z5LPzTRUUQlVmSHaBnVJlJa8",
        "source": "LinkedIn",
        "image": "https://encrypted-tbn3.gstatic.com/images?q=tbn:ANd9GcSHV_Rg6Zrd0YDIQ2z9jIc_bujs7QKmKxjUMoDk6jXc_c9S5XVv",
        "image_url": "https://encrypted-tbn3.gstatic.com/images?q=tbn:ANd9GcSHV_Rg6Zrd0YDIQ2z9jIc_bujs7QKmKxjUMoDk6jXc_c9S5XVv",
        "rank": 17,
        "global_rank": 17
      },
      {
        "title": "YouTube debuts new Recap feature. Here's how to get your ...",
        "link": "https://www.independent.co.uk/arts-entertainment/music/news/youtube-recap-2025-music-video-wrapped-how-to-get-b2877770.html",
        "logo": "https://encrypted-tbn2.gstatic.com/favicon-tbn?q=tbn:ANd9GcSrV5qFXK4MrrpmF-qGRuGZ3XvO58kiXpkOWX91Kx8-eTpm--qUCQciIk1KfIFiK7-tBEP0myCykgJYy4NHLoay0SMKqJd_ci1MQXzy391HtuxldxaIDbUucMM",
        "source": "The Independent",
        "image": "https://encrypted-tbn2.gstatic.com/images?q=tbn:ANd9GcTuzg2v7alS0tL2thS_clhgpAbur9kGjuALPI12kLuwKXZiu9at",
        "image_url": "https://encrypted-tbn2.gstatic.com/images?q=tbn:ANd9GcTuzg2v7alS0tL2thS_clhgpAbur9kGjuALPI12kLuwKXZiu9at",
        "rank": 18,
        "global_rank": 18
      },
      {
        "title": "YouTube Recap is here. How to view your most-watched content ...",
        "link": "https://www.cincinnati.com/story/entertainment/2025/12/04/youtube-recap-2025how-to-view-most-watched-videos-content/87601902007/",
        "logo": "https://encrypted-tbn1.gstatic.com/favicon-tbn?q=tbn:ANd9GcR27tm_wiYENng1DwhCw2hHE-PifONmz3eN7eRaSr85X5NOl3M7uQQvNP_zd950V0OZG2Y3QemU27pUUCQRbPsqdpLJlzgOK3OxVCBu1cDfvNIPfAlKldE",
        "source": "Cincinnati Enquirer",
        "image": "https://encrypted-tbn1.gstatic.com/images?q=tbn:ANd9GcSNWx8A2aLUw2Fxug1gCZyFLvZ4Y7aKVraBvUsGh4CACU8aGzpV",
        "image_url": "https://encrypted-tbn1.gstatic.com/images?q=tbn:ANd9GcSNWx8A2aLUw2Fxug1gCZyFLvZ4Y7aKVraBvUsGh4CACU8aGzpV",
        "rank": 19,
        "global_rank": 19
      },
      {
        "title": "What is YouTube?",
        "link": "https://www.webwise.ie/parents/what-is-youtube/",
        "logo": "https://encrypted-tbn2.gstatic.com/favicon-tbn?q=tbn:ANd9GcSbLBrYqX4Z0t1sT5T5OU0dU6Fvo9atHPiaH8iMCrSjf5T6HovbHsmdOsi0EyUarD3VOBf91gWcD9zD6UooW24U6P9v-9hAL7DI5HNE9UQ5lM_Xvw",
        "source": "Webwise - Internet Safety",
        "image": "https://encrypted-tbn3.gstatic.com/images?q=tbn:ANd9GcQwO8Vfju8uGEWjkvVBJbZ-TFwjll0_nwfouGH5ZX0GP62kXokW",
        "image_url": "https://encrypted-tbn3.gstatic.com/images?q=tbn:ANd9GcQwO8Vfju8uGEWjkvVBJbZ-TFwjll0_nwfouGH5ZX0GP62kXokW",
        "rank": 20,
        "global_rank": 20
      },
      {
        "title": "YouTube Is a Big Business. Just How Big Is Anyone's Guess ...",
        "link": "https://www.nytimes.com/2019/07/24/technology/youtube-financial-disclosure-google.html",
        "logo": "https://encrypted-tbn2.gstatic.com/favicon-tbn?q=tbn:ANd9GcRszyNSCYR04WGtSoefBwhwwe0NZDJ2NRax9ELrHGpQtwbG2FlJEx0ypzELo9V6Wpi6bcLEWpUcrMTLpkhIptbuYuWkKpaRsx-z4E6t7l8zAoUPsCc",
        "source": "The New York Times",
        "image": "https://encrypted-tbn1.gstatic.com/images?q=tbn:ANd9GcStmaUZMu5JHN9J3SglDlcn2E-q03ztxHL5MwhQm9Ru1qeD4o-q",
        "image_url": "https://encrypted-tbn1.gstatic.com/images?q=tbn:ANd9GcStmaUZMu5JHN9J3SglDlcn2E-q03ztxHL5MwhQm9Ru1qeD4o-q",
        "rank": 21,
        "global_rank": 21
      },
      {
        "title": "YouTube Australia & New Zealand - YouTube",
        "link": "https://www.youtube.com/channel/UCgffSD0hpI0nglPAV_77dtA",
        "logo": "https://encrypted-tbn0.gstatic.com/favicon-tbn?q=tbn:ANd9GcQHQslzHLLyLc_qne5jxn7JocidlmUPyegZ8ojX3WVlorFk8BxW9a3vJWjDzN99UHVTqSaNBj_-6XykhxuVQfF3Ye7xScSWSuc2QHXi0a12CkVwBmo",
        "source": "YouTube",
        "image": "https://encrypted-tbn3.gstatic.com/images?q=tbn:ANd9GcRNJVypm9wQcKz7Io8sTjglOqe-TND59T-1cEZ1NsgWtrAgJb4P",
        "image_url": "https://encrypted-tbn3.gstatic.com/images?q=tbn:ANd9GcRNJVypm9wQcKz7Io8sTjglOqe-TND59T-1cEZ1NsgWtrAgJb4P",
        "rank": 22,
        "global_rank": 22
      },
      {
        "title": "Video — Paul Lincoln",
        "link": "http://www.paullincoln.com/media-2",
        "logo": "https://encrypted-tbn1.gstatic.com/favicon-tbn?q=tbn:ANd9GcR-7rvA3OHfu4y9znRDkYgG7MqdqU9M_63edTViGISPZfmcm4O5VHSj1fgqQaZhVc97bITyZ4ipdRQsSwDz9CXyGSmbU5bwbTAtn4uoZeT55MUe9P61fVQ",
        "source": "paullincoln.com",
        "image": "https://encrypted-tbn2.gstatic.com/images?q=tbn:ANd9GcT09i7ZbByzqgW95PWzZyFcVp4mWoEZcKolsA6nd0lmJES3epCe",
        "image_url": "https://encrypted-tbn2.gstatic.com/images?q=tbn:ANd9GcT09i7ZbByzqgW95PWzZyFcVp4mWoEZcKolsA6nd0lmJES3epCe",
        "rank": 23,
        "global_rank": 23
      },
      {
        "title": "Youtube: Latest News, Entertainment, and YouTubers | The Sun",
        "link": "https://www.thesun.co.uk/topic/youtube/",
        "logo": "https://encrypted-tbn3.gstatic.com/favicon-tbn?q=tbn:ANd9GcTAzmaCeD7SECQ6CzPSL-VtJwcaglmxyDTR5rjxf1QsNNldg6Ahh515idFNHVCPJF3-vrEuRFIgpzGHMAuf1O3tkyjn_KuGrOJcB6ZDtoxo8EkQimfu",
        "source": "The Sun",
        "image": "https://encrypted-tbn1.gstatic.com/images?q=tbn:ANd9GcT246CmjQ5nHxzTYzWqaOmHWpZRNYZszEwX16RfyEdnh-mbKEq-",
        "image_url": "https://encrypted-tbn1.gstatic.com/images?q=tbn:ANd9GcT246CmjQ5nHxzTYzWqaOmHWpZRNYZszEwX16RfyEdnh-mbKEq-",
        "rank": 24,
        "global_rank": 24
      },
      {
        "title": "YouTube Stops Counting Paid Ads in Music-Video Viewing ...",
        "link": "https://www.bloomberg.com/news/articles/2019-09-13/youtube-stops-counting-paid-ads-in-music-video-viewing-records",
        "logo": "https://encrypted-tbn0.gstatic.com/favicon-tbn?q=tbn:ANd9GcQe8-4u1vGHnWI08nokhQFeCBq2xuVVby17tJeU809SoWIBa1aZsXjfC6uoUnIhUMVxQJ6mFczTws3NcsaQRl5J1JOXqlx_niS6uct6oz-52kMQZtZEiQ",
        "source": "Bloomberg.com",
        "image": "https://encrypted-tbn2.gstatic.com/images?q=tbn:ANd9GcQIsKpZ2VIjNLorJiTxxVc7O_FB7wwCgq82vZVNXjlPcuTs45D9",
        "image_url": "https://encrypted-tbn2.gstatic.com/images?q=tbn:ANd9GcQIsKpZ2VIjNLorJiTxxVc7O_FB7wwCgq82vZVNXjlPcuTs45D9",
        "rank": 25,
        "global_rank": 25
      },
      {
        "title": "Top 10 most-watched videos on YouTube globally as of 2024",
        "link": "https://indianexpress.com/article/trending/top-10-listing/top-10-most-watched-videos-on-youtube-globally-as-of-2024-9644368/",
        "logo": "https://encrypted-tbn0.gstatic.com/favicon-tbn?q=tbn:ANd9GcREHhA82Fap_IO3U-7dlibrn8yJlsi0qT2kUdbck1KimPVEHNIsCtGxstAKlPt07s9RhkEkAIgCRXi9RFzfFCaR0Y8p_z22jf2uaKW4DCqIgJOO0GBmOA",
        "source": "The Indian Express",
        "image": "https://encrypted-tbn2.gstatic.com/images?q=tbn:ANd9GcT8p0DDTwJ21nLYDW12Vmj8DsHfuIxqF5R7sZDvK_cUKPazOEQT",
        "image_url": "https://encrypted-tbn2.gstatic.com/images?q=tbn:ANd9GcT8p0DDTwJ21nLYDW12Vmj8DsHfuIxqF5R7sZDvK_cUKPazOEQT",
        "rank": 26,
        "global_rank": 26
      },
      {
        "title": "YouTube Is Getting Two New Smart Features",
        "link": "https://www.howtogeek.com/youtube-is-getting-two-new-smart-features/",
        "logo": "https://encrypted-tbn0.gstatic.com/favicon-tbn?q=tbn:ANd9GcQi7d7OE3tYYpQ0K0N2YmwhwaeJDpQia9z8E5mUUGmYuXveM7Jc79TKGAwew0HGVw8nR3bhm6JDzDYTfw9UOl8rmynEx6jiQgFI18MGyTgd52tKjiLMwQ",
        "source": "How-To Geek",
        "image": "https://encrypted-tbn3.gstatic.com/images?q=tbn:ANd9GcQjsUXO2w4xeQxrjXEq137RF1UCZAmNj-EvtP0ZBa-_fNtTmPav",
        "image_url": "https://encrypted-tbn3.gstatic.com/images?q=tbn:ANd9GcQjsUXO2w4xeQxrjXEq137RF1UCZAmNj-EvtP0ZBa-_fNtTmPav",
        "rank": 27,
        "global_rank": 27
      },
      {
        "title": "Watching YouTube Videos in Whonix",
        "link": "https://www.whonix.org/wiki/YouTube",
        "logo": "https://encrypted-tbn1.gstatic.com/favicon-tbn?q=tbn:ANd9GcR7RCT4r1ULdXFpOWV7360X_4uHe_tgQD8LjRH_CH1PdrUaVhIVyar26V_7gxFFa3iH8Oy21z9GPKAYnBLMmPWgbGAmEwYkn8RSAqv6Zzv0OcuUFQ",
        "source": "Whonix",
        "image": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcRXYvXSyyCilfbT9uHBSCn_f8N0EHl1BJIvVnTlaimF1YfRaHUK",
        "image_url": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcRXYvXSyyCilfbT9uHBSCn_f8N0EHl1BJIvVnTlaimF1YfRaHUK",
        "rank": 28,
        "global_rank": 28
      },
      {
        "title": "News and updates about YouTube | Google Blog",
        "link": "https://blog.google/products-and-platforms/products/youtube/",
        "logo": "https://encrypted-tbn3.gstatic.com/favicon-tbn?q=tbn:ANd9GcStL-sTzHn2J4VaK5tWXvxPveo_FDanN9An682O-vsvvva1mpz3OvUYdtmBNqFXZBSCAaE8oq_nkmdnRPg3lOUregpQRTKpqiQAjs18pfPSUQ",
        "source": "blog.google",
        "image": "https://encrypted-tbn1.gstatic.com/images?q=tbn:ANd9GcTt0bO3rityxtULGmxQEMrEyasw8yy5NIpK_5zOdPx0_6rNpqUx",
        "image_url": "https://encrypted-tbn1.gstatic.com/images?q=tbn:ANd9GcTt0bO3rityxtULGmxQEMrEyasw8yy5NIpK_5zOdPx0_6rNpqUx",
        "rank": 29,
        "global_rank": 29
      },
      {
        "title": "YouTube Music Review | PCMag",
        "link": "https://www.pcmag.com/reviews/youtube-music",
        "logo": "https://encrypted-tbn2.gstatic.com/favicon-tbn?q=tbn:ANd9GcQT2SxtS9PqiMpEW2DDJLdjuVqHzsB-BQ_R7sUFdvjuE3SMmj4UDrJTT0vpXgXFeSKQtj3idX4xCu9G5dm0yLJ9c45ktlpBDPBKR2kVTtday3EF",
        "source": "PCMag",
        "image": "https://encrypted-tbn2.gstatic.com/images?q=tbn:ANd9GcRuf5sF-d6UFF8UNcLGO-duPlx_Ir1i4MoSICNnH8NU08ifkakF",
        "image_url": "https://encrypted-tbn2.gstatic.com/images?q=tbn:ANd9GcRuf5sF-d6UFF8UNcLGO-duPlx_Ir1i4MoSICNnH8NU08ifkakF",
        "rank": 30,
        "global_rank": 30
      },
      {
        "title": "YouTube should give more prominence to public service media ...",
        "link": "https://www.bbc.co.uk/news/articles/clyl07nekzxo",
        "logo": "https://encrypted-tbn2.gstatic.com/favicon-tbn?q=tbn:ANd9GcQkfkHsgY8lS21mPHFUbDtwW6Et_KFgAwjd1eumnE7PsvEhqdw6Kv69JwDtX9AXmV8-fm6t54pB8PATe-Pzv5BHmyDELvrJFZqQ7nx8_vZwcD6x",
        "source": "BBC",
        "image": "https://encrypted-tbn1.gstatic.com/images?q=tbn:ANd9GcTCIXoliRxY3r5Vx1pd9ThbHblQxHEbzddAo4HHt2kSCUd7gsqf",
        "image_url": "https://encrypted-tbn1.gstatic.com/images?q=tbn:ANd9GcTCIXoliRxY3r5Vx1pd9ThbHblQxHEbzddAo4HHt2kSCUd7gsqf",
        "rank": 31,
        "global_rank": 31
      },
      {
        "title": "File:YouTube 2024 (white text).svg - 维基百科，自由的百科全书",
        "link": "https://zh.wikipedia.org/wiki/File:YouTube_2024_(white_text).svg",
        "logo": "https://encrypted-tbn0.gstatic.com/favicon-tbn?q=tbn:ANd9GcTgod29MM5WNalqnjIcBsJz-FYzexdoriMaYgfDJBNVB0dbbr8oUvUUdO4TpGJwnQik_QDLqNUx8Xng_fGxFXTCjPoQ5kaT0V-VDXPPm6cez-UNBLHj",
        "source": "Wikipedia",
        "image": "https://encrypted-tbn3.gstatic.com/images?q=tbn:ANd9GcR_SW1C9p0Im0tfYKM0a6X_vnDSB2PBhaui6vlP1juYkU54F6De",
        "image_url": "https://encrypted-tbn3.gstatic.com/images?q=tbn:ANd9GcR_SW1C9p0Im0tfYKM0a6X_vnDSB2PBhaui6vlP1juYkU54F6De",
        "rank": 32,
        "global_rank": 32
      },
      {
        "title": "The YouTube app is about to get a big change for millions of ...",
        "link": "https://www.tomsguide.com/phones/the-youtube-app-is-about-to-get-a-big-change-for-millions-of-users-heres-how",
        "logo": "https://encrypted-tbn1.gstatic.com/favicon-tbn?q=tbn:ANd9GcQsE43WEfOZgVYWDovFX_tyPSpSCRqQFo91ibMPqiy_m0F1N4zEImtI17toXeeuTIJYtqiOnB_2IPvFYGTZqmWbYqamkcqaiG1WI3FXmcAKcbogzL4nuw",
        "source": "Tom's Guide",
        "image": "https://encrypted-tbn2.gstatic.com/images?q=tbn:ANd9GcR-WWCeow11tvybRoNr-Iuy7_WJviCTGg1k3EIWXWWPA3w0HdN6",
        "image_url": "https://encrypted-tbn2.gstatic.com/images?q=tbn:ANd9GcR-WWCeow11tvybRoNr-Iuy7_WJviCTGg1k3EIWXWWPA3w0HdN6",
        "rank": 33,
        "global_rank": 33
      },
      {
        "title": "10 Reasons to Start a YouTube Channel Today | TubeBuddy",
        "link": "https://www.tubebuddy.com/blog/10-reasons-start-youtube-channel/",
        "logo": "https://encrypted-tbn3.gstatic.com/favicon-tbn?q=tbn:ANd9GcQBpw2mbW8vadl8QZpNXIHukGlh5Coavo8CfqmCVM0SS02q94VLSJJLzwjVhOCQSIFe7Hrul3Ykzz-aqn1btCE8KE1zDbk1srhzknIFUWmi3v9eDwTBLw",
        "source": "TubeBuddy",
        "image": "https://encrypted-tbn3.gstatic.com/images?q=tbn:ANd9GcSBPIH0c-fIrX1ZpB-T3QK8ydY6_Kn5Y2_L9ZzfwZNcuJlmJVz7",
        "image_url": "https://encrypted-tbn3.gstatic.com/images?q=tbn:ANd9GcSBPIH0c-fIrX1ZpB-T3QK8ydY6_Kn5Y2_L9ZzfwZNcuJlmJVz7",
        "rank": 34,
        "global_rank": 34
      },
      {
        "title": "YouTube Premium - YouTube Music",
        "link": "https://music.youtube.com/youtube_premium/family",
        "logo": "https://encrypted-tbn1.gstatic.com/favicon-tbn?q=tbn:ANd9GcQ-VBgsmwz5f69M533t3sJUHkFBS_kxEG3iuqRIevaZHUUbgiPCwBCSivswuNFKV42TtMpHyFx8k7aRMWDlPWNRF5-O_2wJbazOBTE4A4GnbUXlpRn4RA",
        "source": "YouTube",
        "image": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcRoA3XLRLlSu7GDeIM4mOo8n2IsC2MMXJTUWuPEhLl8-H8UQjAV",
        "image_url": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcRoA3XLRLlSu7GDeIM4mOo8n2IsC2MMXJTUWuPEhLl8-H8UQjAV",
        "rank": 35,
        "global_rank": 35
      },
      {
        "title": "AI Overviews Are Coming To YouTube In New Test",
        "link": "https://www.tulsamarketingonline.com/ai-overviews-are-coming-to-youtube-in-new-test/",
        "logo": "https://encrypted-tbn0.gstatic.com/favicon-tbn?q=tbn:ANd9GcQdlX-huMkuAXP9QrJWUVbCax_aXdhGZO9qhv8aeHvTCCjnHzWOfuNp56fCD5n-lQFo2UOXmqvBrWv1EP-Y3kRZL70kqvASoG3GGaVXHP1FDF_9UrN2663TziCS-bzqD4Hw",
        "source": "Tulsa Marketing Online",
        "image": "https://encrypted-tbn1.gstatic.com/images?q=tbn:ANd9GcSrAt7rOPRTZ3ARkL-YGWskDIZZrBNHNFU8hu07vmAdCxPSDyOH",
        "image_url": "https://encrypted-tbn1.gstatic.com/images?q=tbn:ANd9GcSrAt7rOPRTZ3ARkL-YGWskDIZZrBNHNFU8hu07vmAdCxPSDyOH",
        "rank": 36,
        "global_rank": 36
      },
      {
        "title": "Get Ready to Talk to the YouTube App",
        "link": "https://www.howtogeek.com/youtube-conversational-ai-feature/",
        "logo": "https://encrypted-tbn0.gstatic.com/favicon-tbn?q=tbn:ANd9GcQi7d7OE3tYYpQ0K0N2YmwhwaeJDpQia9z8E5mUUGmYuXveM7Jc79TKGAwew0HGVw8nR3bhm6JDzDYTfw9UOl8rmynEx6jiQgFI18MGyTgd52tKjiLMwQ",
        "source": "How-To Geek",
        "image": "https://encrypted-tbn1.gstatic.com/images?q=tbn:ANd9GcQZge9V5uwknS8grLnlN9-MjxTo_CzGn4MBqlS2DL32NmfuEOdk",
        "image_url": "https://encrypted-tbn1.gstatic.com/images?q=tbn:ANd9GcQZge9V5uwknS8grLnlN9-MjxTo_CzGn4MBqlS2DL32NmfuEOdk",
        "rank": 37,
        "global_rank": 37
      },
      {
        "title": "Council Meeting Videos | City of Oconomowoc, WI - Official ...",
        "link": "https://www.oconomowoc-wi.gov/769/Council-Meeting-Videos-on-YouTube",
        "logo": "https://encrypted-tbn3.gstatic.com/favicon-tbn?q=tbn:ANd9GcQTyr2X3_sexqjYHbmBx8BOfYR2NdvXo7-7f_aOtDoQqtUeIhYdRlCTaktRxMJqisDnx5bKSz--9AFYPlCBMyEtRQwVFaVo85gmzwH-C_YqrqE2qay2p3PyKYw",
        "source": "City of Oconomowoc, WI (.gov)",
        "image": "https://encrypted-tbn3.gstatic.com/images?q=tbn:ANd9GcRdPwT4HJnPOPNlvcKaANyl-0YrnwPHxnAmbKyRdYM5SIE35CD3",
        "image_url": "https://encrypted-tbn3.gstatic.com/images?q=tbn:ANd9GcRdPwT4HJnPOPNlvcKaANyl-0YrnwPHxnAmbKyRdYM5SIE35CD3",
        "rank": 38,
        "global_rank": 38
      },
      {
        "title": "Popaganda Podcast",
        "link": "https://www.popagandapod.com/season1",
        "logo": "https://encrypted-tbn0.gstatic.com/favicon-tbn?q=tbn:ANd9GcSxbqFeVrr2di3ffaWz_O8ivKYW7tRtmi51RAq8MylGvGAQHmV9lqUDOdmE8rMpy9s63aeBGIzHjho53xhXkEkOIxVNl6MrlEqQ859957BgADrGHPH31PUP5g",
        "source": "Popaganda Podcast",
        "image": "https://encrypted-tbn3.gstatic.com/images?q=tbn:ANd9GcQti39Qu5s92QMRuS63qsnoyO5JlBmIu84Q0GtL1b0Sc1XG0O0s",
        "image_url": "https://encrypted-tbn3.gstatic.com/images?q=tbn:ANd9GcQti39Qu5s92QMRuS63qsnoyO5JlBmIu84Q0GtL1b0Sc1XG0O0s",
        "rank": 39,
        "global_rank": 39
      },
      {
        "title": "List of YouTube Premium original programming - Wikipedia",
        "link": "https://en.wikipedia.org/wiki/List_of_YouTube_Premium_original_programming",
        "logo": "https://encrypted-tbn2.gstatic.com/favicon-tbn?q=tbn:ANd9GcRLIcgPlYxOaoBg0MnSobLYyflrgF_RLdwAY09AXHWGy2jqWQnuIBNCY5I1BuzY7jeAJga0y0b9htBHe94i3Pg4B0NhHMNDVsmS-FVRKL014d-Xf6sX",
        "source": "Wikipedia",
        "image": "https://encrypted-tbn2.gstatic.com/images?q=tbn:ANd9GcQCdjg8v5Sy3YsUUJ7-QKrqKVv26GF2AbrlVv_rQrpC5kdTfq9_",
        "image_url": "https://encrypted-tbn2.gstatic.com/images?q=tbn:ANd9GcQCdjg8v5Sy3YsUUJ7-QKrqKVv26GF2AbrlVv_rQrpC5kdTfq9_",
        "rank": 40,
        "global_rank": 40
      },
      {
        "title": "YouTube Music - YouTube",
        "link": "https://www.youtube.com/channel/UCStaiwu-FAgp_RC_tBiLh9A",
        "logo": "https://encrypted-tbn0.gstatic.com/favicon-tbn?q=tbn:ANd9GcQHQslzHLLyLc_qne5jxn7JocidlmUPyegZ8ojX3WVlorFk8BxW9a3vJWjDzN99UHVTqSaNBj_-6XykhxuVQfF3Ye7xScSWSuc2QHXi0a12CkVwBmo",
        "source": "YouTube",
        "image": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcTE12NwfEIz3s1Scc9ug0S0sWhuK0DDv5kBgBbvJc5phh3nDliM",
        "image_url": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcTE12NwfEIz3s1Scc9ug0S0sWhuK0DDv5kBgBbvJc5phh3nDliM",
        "rank": 41,
        "global_rank": 41
      },
      {
        "title": "Where is Your YouTube History? - YouTube",
        "link": "https://www.youtube.com/watch?v=hcnkv0y-0WM",
        "logo": "https://encrypted-tbn0.gstatic.com/favicon-tbn?q=tbn:ANd9GcQHQslzHLLyLc_qne5jxn7JocidlmUPyegZ8ojX3WVlorFk8BxW9a3vJWjDzN99UHVTqSaNBj_-6XykhxuVQfF3Ye7xScSWSuc2QHXi0a12CkVwBmo",
        "source": "YouTube",
        "image": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcR3b0891aPxG36yA2V8x8ScZNv17SVWNfwTDtXyZFdmJMa4mdIu",
        "image_url": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcR3b0891aPxG36yA2V8x8ScZNv17SVWNfwTDtXyZFdmJMa4mdIu",
        "rank": 42,
        "global_rank": 42
      },
      {
        "title": "YouTube says that music is now 25% of its global watch time",
        "link": "https://musically.com/2021/09/16/youtube-says-that-music-is-now-25-of-its-global-watch-time/",
        "logo": "https://encrypted-tbn3.gstatic.com/favicon-tbn?q=tbn:ANd9GcSFAxZpnQqFaA4qoNqYk_NlH7wPwpNpjN3Fyh-p6wfFTc-IhE0-Ufkg2aomh1NFcGdcunSi9BYOB0RK6mkP7VVvlBlxdcQcbJILVSRsFGTY83Gj",
        "source": "Music Ally",
        "image": "https://encrypted-tbn3.gstatic.com/images?q=tbn:ANd9GcQjPmybg3_wHprlJf2gIX5GjEPxEsB51OyF42VDXiKkYjYF2oTr",
        "image_url": "https://encrypted-tbn3.gstatic.com/images?q=tbn:ANd9GcQjPmybg3_wHprlJf2gIX5GjEPxEsB51OyF42VDXiKkYjYF2oTr",
        "rank": 43,
        "global_rank": 43
      },
      {
        "title": "Calvary Chapel Myrtle Beach - YouTube",
        "link": "https://www.youtube.com/channel/UC8-zrGpx1tbkjV4vOzlLvdg",
        "logo": "https://encrypted-tbn0.gstatic.com/favicon-tbn?q=tbn:ANd9GcQHQslzHLLyLc_qne5jxn7JocidlmUPyegZ8ojX3WVlorFk8BxW9a3vJWjDzN99UHVTqSaNBj_-6XykhxuVQfF3Ye7xScSWSuc2QHXi0a12CkVwBmo",
        "source": "YouTube",
        "image": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcTNzpg3c-1dwwy9JkJ-8U9yJF8wTocFJoEsF19F1v5VWwUAUT_j",
        "image_url": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcTNzpg3c-1dwwy9JkJ-8U9yJF8wTocFJoEsF19F1v5VWwUAUT_j",
        "rank": 44,
        "global_rank": 44
      },
      {
        "title": "How To Turn On Comments On Specific YouTube Video [Guide ...",
        "link": "https://www.youtube.com/watch?v=YaLKiiIjPFo",
        "logo": "https://encrypted-tbn0.gstatic.com/favicon-tbn?q=tbn:ANd9GcQHQslzHLLyLc_qne5jxn7JocidlmUPyegZ8ojX3WVlorFk8BxW9a3vJWjDzN99UHVTqSaNBj_-6XykhxuVQfF3Ye7xScSWSuc2QHXi0a12CkVwBmo",
        "source": "YouTube",
        "image": "https://encrypted-tbn1.gstatic.com/images?q=tbn:ANd9GcTmetLJpEeBZIkBH8iY9Hl9Zmg6FyRiNKggrlH2TYUydoK_WFTm",
        "image_url": "https://encrypted-tbn1.gstatic.com/images?q=tbn:ANd9GcTmetLJpEeBZIkBH8iY9Hl9Zmg6FyRiNKggrlH2TYUydoK_WFTm",
        "rank": 45,
        "global_rank": 45
      },
      {
        "title": "Find Out Who Posts the Most Comments on Your YouTube Videos",
        "link": "https://vidiq.com/blog/post/youtube-video-comments/",
        "logo": "https://encrypted-tbn2.gstatic.com/favicon-tbn?q=tbn:ANd9GcRi92uWOGPpN-xT5Ryt5IsYXvQHoOTBvyLZ2UjgKY_BLC8EJVHrkRRsBYEkfaKwauzv1iwUYLMLcLs84kgjvH43R9WYkdS7Okx5MWmEzWE",
        "source": "vidIQ",
        "image": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcTdiX3UycHs_XFFkysSeTNa27anWDPZA1eGMDEQ4uRrj35e2Vpp",
        "image_url": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcTdiX3UycHs_XFFkysSeTNa27anWDPZA1eGMDEQ4uRrj35e2Vpp",
        "rank": 46,
        "global_rank": 46
      },
      {
        "title": "YouTube app gets a huge redesign - PhoneArena",
        "link": "https://www.phonearena.com/news/YouTube-app-gets-a-huge-redesign_id97544",
        "logo": "https://encrypted-tbn3.gstatic.com/favicon-tbn?q=tbn:ANd9GcTzmmUWlKNu2N6Vu_BuvybF4XRJzXoEG5iXXHkZMamhlXGoSgsSvpeu9hQP8FywapcndqFH07W0BWQ3DUcUTSh89ouuATT334y1FEgi-BAx9N93KNMDMNw",
        "source": "PhoneArena",
        "image": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcSQ0Itkcn1QdHRMaVdbpRl6vFhhmq__ZvwiBpWzUYix_VJl8ChG",
        "image_url": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcSQ0Itkcn1QdHRMaVdbpRl6vFhhmq__ZvwiBpWzUYix_VJl8ChG",
        "rank": 47,
        "global_rank": 47
      },
      {
        "title": "How to Live Stream on YouTube Using Your iPhone 15, iPhone ...",
        "link": "https://www.youtube.com/watch?v=rXU3sRnDi5M",
        "logo": "https://encrypted-tbn0.gstatic.com/favicon-tbn?q=tbn:ANd9GcQHQslzHLLyLc_qne5jxn7JocidlmUPyegZ8ojX3WVlorFk8BxW9a3vJWjDzN99UHVTqSaNBj_-6XykhxuVQfF3Ye7xScSWSuc2QHXi0a12CkVwBmo",
        "source": "YouTube",
        "image": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcT2J6imTTg_XtsK2Yul9RScPHVLmB1y2NppWjMLXRW2mzJYEfsC",
        "image_url": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcT2J6imTTg_XtsK2Yul9RScPHVLmB1y2NppWjMLXRW2mzJYEfsC",
        "rank": 48,
        "global_rank": 48
      },
      {
        "title": "Lincoln Municipal Band - Home",
        "link": "https://www.artsincorporated.org/lmb/",
        "logo": "https://encrypted-tbn0.gstatic.com/favicon-tbn?q=tbn:ANd9GcQuvdPTZZ78-9IyZ_1DsRl9-qzEAGLKh2kDWKxvcYVspd4pk2Ua9HA--cFdERby410oLEF3KxmAdP-0p_dpjWLh4V0MqU3eKqpU_PSiKWmjX2RJszYD1WTCQyTttSg",
        "source": "Arts Incorporated",
        "image": "https://encrypted-tbn2.gstatic.com/images?q=tbn:ANd9GcTPfkm0GAi--1NuzfHwVOBBGRUoQvIuQIeTV6G8cOOVVsWh-Z9V",
        "image_url": "https://encrypted-tbn2.gstatic.com/images?q=tbn:ANd9GcTPfkm0GAi--1NuzfHwVOBBGRUoQvIuQIeTV6G8cOOVVsWh-Z9V",
        "rank": 49,
        "global_rank": 49
      },
      {
        "title": "new u-center video tutorials on Youtube - ArduSimple",
        "link": "https://www.ardusimple.com/u-center-tutorials-with-ardusimple/",
        "logo": "https://encrypted-tbn1.gstatic.com/favicon-tbn?q=tbn:ANd9GcTNV33vg9eOKdK3IItijTo0CjIoVAK2c9OzzYXzVXS1gtbyE61651a9drsxjJW2yC0K7rfttJXAP3g7_LZ0wmwPHQOmepn9z-zIMHJDGlgrijHfNKFESgc",
        "source": "ArduSimple",
        "image": "https://encrypted-tbn1.gstatic.com/images?q=tbn:ANd9GcS0cxDcJbc9ypZFOS_APjj_8Xzy-gGHG-wbSV_WR0Wn0-tqUAVf",
        "image_url": "https://encrypted-tbn1.gstatic.com/images?q=tbn:ANd9GcS0cxDcJbc9ypZFOS_APjj_8Xzy-gGHG-wbSV_WR0Wn0-tqUAVf",
        "rank": 50,
        "global_rank": 50
      },
      {
        "title": "Listen – Kicks Band of Fargo-Moorhead",
        "link": "https://fmkicksband.com/listen/",
        "logo": "https://encrypted-tbn2.gstatic.com/favicon-tbn?q=tbn:ANd9GcSXIP238x7Ns9vg5fxViRnkAHehX-cXBHAumAnxFErtlfXQpKU6hVJib-drG2IjKuQ3zFj0pmu3F_N8pdVpuCn5VuYHj67pIOKWTIo3uZnmRNt9Eag",
        "source": "Kicks Band of Fargo-Moorhead",
        "image": "https://encrypted-tbn2.gstatic.com/images?q=tbn:ANd9GcRoVsB0EGH2wECLCNA1IotQT_M1ApQTGq-53qFeSPfLlaP7dceG",
        "image_url": "https://encrypted-tbn2.gstatic.com/images?q=tbn:ANd9GcRoVsB0EGH2wECLCNA1IotQT_M1ApQTGq-53qFeSPfLlaP7dceG",
        "rank": 51,
        "global_rank": 51
      },
      {
        "title": "Second chances on YouTube - YouTube Blog",
        "link": "https://blog.youtube/inside-youtube/second-chances-on-youtube/",
        "logo": "https://encrypted-tbn0.gstatic.com/favicon-tbn?q=tbn:ANd9GcQ6knNVKlTZXHba4AvgwcPeP1LSOT0TtO_nBtUHwAPuP-HGZD_UR3N4CIuTBLH014pjXkVi8F1RBibCJPxLvsuH6kqD7AxlkWJpv5mcAAer2BE",
        "source": "YouTube Official Blog",
        "image": "https://encrypted-tbn1.gstatic.com/images?q=tbn:ANd9GcTTf5i3EODOl4b32sCP5Yhgj4hNmvVPWgwZTD5YDT0OncItqKCO",
        "image_url": "https://encrypted-tbn1.gstatic.com/images?q=tbn:ANd9GcTTf5i3EODOl4b32sCP5Yhgj4hNmvVPWgwZTD5YDT0OncItqKCO",
        "rank": 52,
        "global_rank": 52
      },
      {
        "title": "YouTube Links for Anne Z | Anne Z on the Web",
        "link": "https://annezontheweb.com/you-tube-links-anne-z-on-the-web/",
        "logo": "https://encrypted-tbn1.gstatic.com/favicon-tbn?q=tbn:ANd9GcSDIIO4W4Ama4T6lvAPC7HUk1SV3hRP_oJkukjBzEtKDA7PUJXbLEZ-Tjp-4nBHRgMn1FPzDOR62BrAex4X0BvfOfJjndvL3FjGsa2F37448wajStuF3g",
        "source": "annezontheweb.com",
        "image": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcR7QzVG2h-AGEuDvhAWzIs1oJltO_TwztlJYqfZE--A3SpDptSx",
        "image_url": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcR7QzVG2h-AGEuDvhAWzIs1oJltO_TwztlJYqfZE--A3SpDptSx",
        "rank": 53,
        "global_rank": 53
      },
      {
        "title": "Practices + Playlists — Shawn J. Moore, The Mindful Rebel®",
        "link": "https://www.shawnjmoore.com/listen",
        "logo": "https://encrypted-tbn1.gstatic.com/favicon-tbn?q=tbn:ANd9GcRtkwHR73zt_pPwLkrunvKwi5t5l12sPzyLDJiB0L5o99WE7uXv8OPet3Po9wW4dyeA0FeuNfoVOed_WWwZL9ihFpVlRie_NG1JuggWI4Xnv8U0blP_7wOD",
        "source": "shawnjmoore.com",
        "image": "https://encrypted-tbn3.gstatic.com/images?q=tbn:ANd9GcTzD6aBv7OJzyeYz2m1jZBbaEYlKxk1ScXMopYqPJcp5i55Fu15",
        "image_url": "https://encrypted-tbn3.gstatic.com/images?q=tbn:ANd9GcTzD6aBv7OJzyeYz2m1jZBbaEYlKxk1ScXMopYqPJcp5i55Fu15",
        "rank": 54,
        "global_rank": 54
      },
      {
        "title": "Kristeen Garcia - Google | LinkedIn",
        "link": "https://www.linkedin.com/in/kristeen-garcia-6879a73b",
        "logo": "https://encrypted-tbn3.gstatic.com/favicon-tbn?q=tbn:ANd9GcTFMvFisG5Yfyq07VS0hk1otTr6uQvufSrlgYLzmBkZlxd7MQh66ZmKRUOdwfXrertN7RslYSLWGQCDyxLn3JsHLob5z5LPzTRUUQlVmSHaBnVJlJa8",
        "source": "LinkedIn",
        "image": "https://encrypted-tbn2.gstatic.com/images?q=tbn:ANd9GcQTy_qmt5vLpWNHYFG0-Lswj8W_w9tqvcuXY9-9zmjyLrBEa_5h",
        "image_url": "https://encrypted-tbn2.gstatic.com/images?q=tbn:ANd9GcQTy_qmt5vLpWNHYFG0-Lswj8W_w9tqvcuXY9-9zmjyLrBEa_5h",
        "rank": 55,
        "global_rank": 55
      },
      {
        "title": "Simplest way to embed a Youtube video in your React app ...",
        "link": "https://dev.to/bravemaster619/simplest-way-to-embed-a-youtube-video-in-your-react-app-3bk2",
        "logo": "https://encrypted-tbn0.gstatic.com/favicon-tbn?q=tbn:ANd9GcSQRYRjo6rRDeEwOaYrr8zfImMVmlI3BXXupnqDJb9APJUNVXQUR_ECPJEd7MrgNMDi2ZkWz2U7Ukg8DNNNK2HaNLsmHqhhaPiKpi4",
        "source": "DEV Community",
        "image": "https://encrypted-tbn1.gstatic.com/images?q=tbn:ANd9GcSh5PWTqIAO1R2wHP12Nb0aflEKKY5TP5n42uX4UK7IAizpajZQ",
        "image_url": "https://encrypted-tbn1.gstatic.com/images?q=tbn:ANd9GcSh5PWTqIAO1R2wHP12Nb0aflEKKY5TP5n42uX4UK7IAizpajZQ",
        "rank": 56,
        "global_rank": 56
      },
      {
        "title": "How to Sign Up for YouTube TV - YouTube",
        "link": "https://www.youtube.com/watch?v=Qw_8AEoy59o",
        "logo": "https://encrypted-tbn0.gstatic.com/favicon-tbn?q=tbn:ANd9GcQHQslzHLLyLc_qne5jxn7JocidlmUPyegZ8ojX3WVlorFk8BxW9a3vJWjDzN99UHVTqSaNBj_-6XykhxuVQfF3Ye7xScSWSuc2QHXi0a12CkVwBmo",
        "source": "YouTube",
        "image": "https://encrypted-tbn1.gstatic.com/images?q=tbn:ANd9GcSGXVl_lm2UZWqLNkC80N2ZUZlVjMaQzdQaePReyiDB3XDRdz3v",
        "image_url": "https://encrypted-tbn1.gstatic.com/images?q=tbn:ANd9GcSGXVl_lm2UZWqLNkC80N2ZUZlVjMaQzdQaePReyiDB3XDRdz3v",
        "rank": 57,
        "global_rank": 57
      },
      {
        "title": "YouTube | DanTDM Wiki | Fandom",
        "link": "https://dantdm.fandom.com/wiki/YouTube",
        "logo": "https://encrypted-tbn2.gstatic.com/favicon-tbn?q=tbn:ANd9GcSDCanRiWJrZS7a13YyMPPZ6coybQKs2az6TVioAGkAmKXHG0PBmhzVHm1YMDZdiI1hUyOkhQJ3blcHmQK0ItSZzAgSbzPtQZS1C8COApTsVzE2QQNqgg",
        "source": "Fandom",
        "image": "https://encrypted-tbn2.gstatic.com/images?q=tbn:ANd9GcTLwjLbNQwAMg-RuJ8KfrLlNWHvHxtx72iFWtW2PjOtlbseAaSR",
        "image_url": "https://encrypted-tbn2.gstatic.com/images?q=tbn:ANd9GcTLwjLbNQwAMg-RuJ8KfrLlNWHvHxtx72iFWtW2PjOtlbseAaSR",
        "rank": 58,
        "global_rank": 58
      },
      {
        "title": "Streaming — Circa Blue",
        "link": "http://www.circa-blue.com/streaming",
        "logo": "https://encrypted-tbn0.gstatic.com/favicon-tbn?q=tbn:ANd9GcTt3fNIjA-fl6fHJU_Tgl1Fk56_swi_Ij-_JFF5erPd7uzyCKFJy9ns5E9-tjhfWsQHN3FR47EQtgit-UWbLwsbIdRRNp-iQH2AC4L7nscMj3e-XADIgw",
        "source": "Circa Blue",
        "image": "https://encrypted-tbn3.gstatic.com/images?q=tbn:ANd9GcSi2nZFN-lVelw1BqLmLlBvH9w-6upuwyZXJ-NhZkAGPmy-3v77",
        "image_url": "https://encrypted-tbn3.gstatic.com/images?q=tbn:ANd9GcSi2nZFN-lVelw1BqLmLlBvH9w-6upuwyZXJ-NhZkAGPmy-3v77",
        "rank": 59,
        "global_rank": 59
      },
      {
        "title": "Church Online — Littleton Church of Christ",
        "link": "https://www.littletonchurch.org/churchonline",
        "logo": "https://encrypted-tbn3.gstatic.com/favicon-tbn?q=tbn:ANd9GcQmfVipbq7rQtwPoqC4Po-xMH3P5qM5wg-EiVrEzIM2YuYZi43HsxiThXF45lTkdaYGMxPX9S2W8IVzVEU9fT930n6iskBckvsKR2IypAVZNdYDIvPFY6v82FNF3A",
        "source": "Littleton Church of Christ",
        "image": "https://encrypted-tbn2.gstatic.com/images?q=tbn:ANd9GcQWWCUZZ6WNLcZiywey8g4QDw2H7naK4fL7-G7NAmYDymOd8ZFd",
        "image_url": "https://encrypted-tbn2.gstatic.com/images?q=tbn:ANd9GcQWWCUZZ6WNLcZiywey8g4QDw2H7naK4fL7-G7NAmYDymOd8ZFd",
        "rank": 60,
        "global_rank": 60
      }
    ]
  }
  ```
</ResponseExample>


# Homework
Source: https://docs.brightdata.com/api-reference/serp/google-lens/homework

Reference for the Bright Data Google Lens Homework parameter. Refines queries and returns matching results as JSON or HTML. On port 44445.

```txt wrap theme={null}
https://lens.google.com/uploadbyurl?url=https%3A%2F%2Fwww.youtube.com%2Fimg%2Fdesktop%2Fyt_1200.png&brd_lens=homework
```

## Parameters

<ParamField type="query">
  URL of image you want to search
</ParamField>

<ParamField type="string">
  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`).

  ```txt wrap theme={null}
  https://lens.google.com/uploadbyurl?url=https%3A%2F%2Fwww.youtube.com%2Fimg%2Fdesktop%2Fyt_1200.png&brd_lens=homework
  ```
</ParamField>

<RequestExample>
  ```shell cURL highlight={6} theme={null}
    curl -X POST https://api.brightdata.com/request \
    --header "Content-Type: application/json" \
    --header "Authorization: Bearer API_KEY" \
    --data '{
      "zone": "serp_api1",
      https://lens.google.com/uploadbyurl?url=https%3A%2F%2Fwww.youtube.com%2Fimg%2Fdesktop%2Fyt_1200.png&brd_lens=homework
      "format": "raw"
    }'
  ```

  ```shell Native proxy highlight={4} theme={null}
  curl --proxy brd.superproxy.io:44445 \
    --proxy-user CUSTOMER_USERNAME:CUSTOMER_PASSWORD \
    --ssl-no-revoke \
    "https://lens.google.com/uploadbyurl?url=https%3A%2F%2Fwww.youtube.com%2Fimg%2Fdesktop%2Fyt_1200.png&brd_lens=homework"
  ```

  ```js Node.js highlight={10} theme={null}
  (async () => {
    const response = await fetch('https://api.brightdata.com/request', {
      method: 'POST',
      headers: {
        'Content-Type': 'application/json',
        'Authorization': 'Bearer API_KEY'
      },
      body: JSON.stringify({
        zone: 'serp_api1',
        url: 'https://lens.google.com/uploadbyurl?url=https%3A%2F%2Fwww.youtube.com%2Fimg%2Fdesktop%2Fyt_1200.png&brd_lens=homework',
        format: 'raw'
      })
    });
    
    const data = await response.text();
    console.log(data);
  })();
  ```

  ```python Python highlight={11} theme={null}
  import requests

  # API Configuration
  headers = {
      'Content-Type': 'application/json',
      'Authorization': 'Bearer API_KEY',
  }

  payload = {
      'zone': 'serp_api1',
      'url': 'https://lens.google.com/uploadbyurl?url=https%3A%2F%2Fwww.youtube.com%2Fimg%2Fdesktop%2Fyt_1200.png&brd_lens=homework',
      'format': 'raw'
  }

  # Make the request
  response = requests.post(
      'https://api.brightdata.com/request', 
      json=payload, 
      headers=headers
  )

  print(response.text)
  ```
</RequestExample>

<ResponseExample>
  ```json 200 theme={null}
  {
    "general": {
      "language": "en-IT",
      "mode": "search",
      "type": "all"
    },
    "tabs": [
      {
        "name": "All",
        "type": "all",
        "selected": true
      },
      {
        "name": "Exact matches",
        "type": "exact_matches",
        "link": "https://www.google.com/search?newwindow=1&sca_esv=2dc65c8cbd5d287b&lns_surface=26&hl=en&udm=48&vsrid=CNOUvZmOpL2mwgEQAhgBIiRmM2MwMDIwOC1iNWQ3LTRlYzYtOGM0MS04MmUyODY1NzYyYmIyBiICbHUoGTiiwvzx9fySAw&vsint=CAIqDAoCCAcSAggKGAEgATojChYNAAAAPxUAAAA_HQAAgD8lAACAPzABEIAIGIAIJQAAgD8&lns_mode=un&source=lns.web.gsbubu&vsdim=1024,1024&gsessionid=199BB_yGai7OYftshUcQc_T1bixm7iSCOlobtaK0eHMeUJZrpcZ5Ng&lsessionid=YplFE6xNV5NtX7HzSrAuqm7Dy9VcsV2Jk_HtsKDahzJkkw0tHtBl1g&vsrid=CNOUvZmOpL2mwgEQAhgBIiQwZTFkYzdjMS0xNDdkLTRmN2QtYmE0Mi1iOTY5MDdjZWEyMzgyBiICbHUoGTiiwvzx9fySA1AA&q=&sa=X&ved=2ahUKEwjapK_z9fySAxWVDxAIHXA9KdsQs6gLegQIExAB"
      },
      {
        "name": "Visual matches",
        "type": "visual_matches",
        "link": "https://www.google.com/search?newwindow=1&sca_esv=2dc65c8cbd5d287b&lns_surface=26&hl=en&udm=44&vsrid=CNOUvZmOpL2mwgEQAhgBIiRmM2MwMDIwOC1iNWQ3LTRlYzYtOGM0MS04MmUyODY1NzYyYmIyBiICbHUoGTiiwvzx9fySAw&vsint=CAIqDAoCCAcSAggKGAEgATojChYNAAAAPxUAAAA_HQAAgD8lAACAPzABEIAIGIAIJQAAgD8&lns_mode=un&source=lns.web.gsbubu&vsdim=1024,1024&gsessionid=199BB_yGai7OYftshUcQc_T1bixm7iSCOlobtaK0eHMeUJZrpcZ5Ng&lsessionid=YplFE6xNV5NtX7HzSrAuqm7Dy9VcsV2Jk_HtsKDahzJkkw0tHtBl1g&q=&sa=X&ved=2ahUKEwjapK_z9fySAxWVDxAIHXA9KdsQs6gLegQIEhAB"
      },
      {
        "name": "About this image",
        "type": "about",
        "link": "https://www.google.com/search/about-this-image?img=H4sIAAAAAAAAAAFMALP_IkoKSAjTlL2ZjqS9psIBEAIYASIkZjNjMDAyMDgtYjVkNy00ZWM2LThjNDEtODJlMjg2NTc2MmJiMgYiAmx1KBk4osL88fX8kgNQAOdfoXtMAAAA&sa=X&ved=2ahUKEwjapK_z9fySAxWVDxAIHXA9KdsQs6gLegQIERAB"
      }
    ],
    "images": [
      {
        "title": "File:YouTube Logo 2017.svg - Wikipedia",
        "link": "https://it.wikipedia.org/wiki/File:YouTube_Logo_2017.svg",
        "logo": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAACAAAA...",
        "source": "Wikipedia",
        "image": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAdsAAA...",
        "image_base64": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAdsAAA...",
        "rank": 1,
        "global_rank": 1
      },
      {
        "title": "YouTube-Nuovo-Logo – Parrocchia Ss. Rufina e Seconda ...",
        "link": "https://www.santerufinaeseconda.it/youtube-nuovo-logo/",
        "logo": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQABAAD/2w...",
        "source": "Parrocchia Sante Rufina e Seconda",
        "image": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQABAAD/2w...",
        "image_base64": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQABAAD/2w...",
        "rank": 2,
        "global_rank": 2
      },
      {
        "title": "L'alternativa a Youtube? I nuovi social video | Webhero",
        "link": "https://www.webhero.it/alternativa-a-youtube/",
        "logo": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAACAAAA...",
        "source": "webhero.it",
        "image": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAASwAAA...",
        "image_base64": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAASwAAA...",
        "rank": 3,
        "global_rank": 3
      },
      {
        "title": "File:YouTube Logo (2013-2017).svg - Wikipedia",
        "link": "https://it.wikipedia.org/wiki/File:YouTube_Logo.svg",
        "logo": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAACAAAA...",
        "source": "Wikipedia",
        "image": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAVcAAA...",
        "image_base64": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAVcAAA...",
        "rank": 4,
        "global_rank": 4
      },
      {
        "title": "Social",
        "link": "https://www.volleylivorno.com/social.htm",
        "logo": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQABAAD/2w...",
        "source": "Volley Livorno",
        "image": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAQsAAA...",
        "image_base64": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAQsAAA...",
        "rank": 5,
        "global_rank": 5
      },
      {
        "title": "Youtube logo per popolare in linea media soddisfare ...",
        "link": "https://it.vecteezy.com/png/22721714-youtube-logo-per-popolare-in-linea-media-soddisfare-creazione-sito-web-e-applicazione",
        "logo": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAACAAAA...",
        "source": "Vecteezy",
        "image": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAARwAAA...",
        "image_base64": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAARwAAA...",
        "rank": 6,
        "global_rank": 6
      },
      {
        "title": "Abbonamenti YouTube come funziona | by Michele Maccini | Medium",
        "link": "https://medium.com/@michelemaccini/abbonamenti-youtube-come-funziona-343d2314b1b2",
        "logo": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAACAAAA...",
        "source": "Medium",
        "image": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAbUAAA...",
        "image_base64": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAbUAAA...",
        "rank": 7,
        "global_rank": 7
      },
      {
        "title": "YouTube Creators Italia - YouTube",
        "link": "https://www.youtube.com/@YouTubeCreatorsItalia/shorts",
        "logo": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAACAAAA...",
        "source": "YouTube",
        "image": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAOEAAA...",
        "image_base64": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAOEAAA...",
        "rank": 8,
        "global_rank": 8
      },
      {
        "title": "YouTube (Website) - SteamGridDB",
        "link": "https://www.steamgriddb.com/game/36663",
        "logo": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAACAAAA...",
        "source": "SteamGridDB",
        "image": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAALcAAA...",
        "image_base64": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAALcAAA...",
        "rank": 9,
        "global_rank": 9
      },
      {
        "title": "YouTube now second only to BBC as most popular media ...",
        "link": "https://www.bbc.co.uk/news/articles/c4gzvee78eqo",
        "logo": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAACAAAA...",
        "source": "BBC",
        "image": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQABAAD/2w...",
        "image_base64": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQABAAD/2w...",
        "rank": 10,
        "global_rank": 10
      },
      {
        "title": "Social Unipv | Università di Pavia",
        "link": "https://portale.unipv.it/it/social-unipv",
        "logo": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAABAAAA...",
        "source": "Università di Pavia",
        "image": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQABAAD/2w...",
        "image_base64": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQABAAD/2w...",
        "rank": 11,
        "global_rank": 11
      },
      {
        "title": "YouTube",
        "link": "https://www.youtube.com/watch?v=2rjtpWxRSP8",
        "logo": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAACAAAA...",
        "source": "YouTube",
        "image": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAASwAAA...",
        "image_base64": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAASwAAA...",
        "rank": 12,
        "global_rank": 12
      },
      {
        "title": "YouTube: app su Amazon Appstore",
        "link": "https://www.amazon.it/Google-LLC-YouTube/dp/B07T771SPH",
        "logo": "https://encrypted-tbn0.gstatic.com/favicon-tbn?q=tbn:ANd9GcRrWOi-uC3lC6i4Y5BR23l1r_krEzq6-XeaA-OmOUDcF7MinJfzKPpK8BLim4sdIhs1McRYibNwWRyVuUwqb9-s6vvkCfbv-XG6KQuPTpYyLOt2",
        "source": "Amazon.it",
        "image": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcR-6m6YWsWrwK0xLxwV3BwaFdz-2ShM4ZmwbBHxiaB1psVHSuGY",
        "image_url": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcR-6m6YWsWrwK0xLxwV3BwaFdz-2ShM4ZmwbBHxiaB1psVHSuGY",
        "rank": 13,
        "global_rank": 13
      },
      {
        "title": "Cos'è Recap di YouTube, il riassunto del tuo 2025 come ...",
        "link": "https://www.fastweb.it/fastweb-plus/digital-marketing-social/cose-recap-di-youtube-il-riassunto-del-tuo-2025-come-wrapped-di-spotify/",
        "logo": "https://encrypted-tbn3.gstatic.com/favicon-tbn?q=tbn:ANd9GcQibqeiTf2oFFIN3s6727bZSB4Eh1lvb2OvJmpGdkfR7-S__vUDUXK7ZtPlN5Zxn6s9VhgIQQeesoWmdXjq4U3aaUFd4J5NvcsORecUJ1teM-PwvQ",
        "source": "Fastweb",
        "image": "https://encrypted-tbn2.gstatic.com/images?q=tbn:ANd9GcRVH2dSLC7vGH3Y1yHXjdN1813MLPK5CK-TfI2qcTc4Zb32IXy7",
        "image_url": "https://encrypted-tbn2.gstatic.com/images?q=tbn:ANd9GcRVH2dSLC7vGH3Y1yHXjdN1813MLPK5CK-TfI2qcTc4Zb32IXy7",
        "rank": 14,
        "global_rank": 14
      },
      {
        "title": "YouTube debuts new Recap feature. Here's how to get your ...",
        "link": "https://www.independent.co.uk/arts-entertainment/music/news/youtube-recap-2025-music-video-wrapped-how-to-get-b2877770.html",
        "logo": "https://encrypted-tbn2.gstatic.com/favicon-tbn?q=tbn:ANd9GcSrV5qFXK4MrrpmF-qGRuGZ3XvO58kiXpkOWX91Kx8-eTpm--qUCQciIk1KfIFiK7-tBEP0myCykgJYy4NHLoay0SMKqJd_ci1MQXzy391HtuxldxaIDbUucMM",
        "source": "The Independent",
        "image": "https://encrypted-tbn2.gstatic.com/images?q=tbn:ANd9GcTuzg2v7alS0tL2thS_clhgpAbur9kGjuALPI12kLuwKXZiu9at",
        "image_url": "https://encrypted-tbn2.gstatic.com/images?q=tbn:ANd9GcTuzg2v7alS0tL2thS_clhgpAbur9kGjuALPI12kLuwKXZiu9at",
        "rank": 15,
        "global_rank": 15
      },
      {
        "title": "File:YouTube icon (2013-2017).svg - Wikipedia",
        "link": "https://it.wikipedia.org/wiki/File:YouTube_icon_(2013-2017).svg",
        "logo": "https://encrypted-tbn1.gstatic.com/favicon-tbn?q=tbn:ANd9GcT2KN4_0uNdyYsmuqBnsfNd2oA3qDagOJceNJq4UmjB5HJYGxbH-XBIhG9cB-OPNzK4-NViS9Rx5Qbhckroz79jN-qc9tfJZGFIkiBOLs0yqgITnKC4",
        "source": "Wikipedia",
        "image": "https://encrypted-tbn2.gstatic.com/images?q=tbn:ANd9GcTM9jPouDIip3ZBRP4KSYlnrmN6mbKLej1iYljENHlNRMKZANkH",
        "image_url": "https://encrypted-tbn2.gstatic.com/images?q=tbn:ANd9GcTM9jPouDIip3ZBRP4KSYlnrmN6mbKLej1iYljENHlNRMKZANkH",
        "rank": 16,
        "global_rank": 16
      },
      {
        "title": "What is YouTube?",
        "link": "https://www.webwise.ie/parents/what-is-youtube/",
        "logo": "https://encrypted-tbn2.gstatic.com/favicon-tbn?q=tbn:ANd9GcSbLBrYqX4Z0t1sT5T5OU0dU6Fvo9atHPiaH8iMCrSjf5T6HovbHsmdOsi0EyUarD3VOBf91gWcD9zD6UooW24U6P9v-9hAL7DI5HNE9UQ5lM_Xvw",
        "source": "Webwise - Internet Safety",
        "image": "https://encrypted-tbn3.gstatic.com/images?q=tbn:ANd9GcQwO8Vfju8uGEWjkvVBJbZ-TFwjll0_nwfouGH5ZX0GP62kXokW",
        "image_url": "https://encrypted-tbn3.gstatic.com/images?q=tbn:ANd9GcQwO8Vfju8uGEWjkvVBJbZ-TFwjll0_nwfouGH5ZX0GP62kXokW",
        "rank": 17,
        "global_rank": 17
      },
      {
        "title": "YouTube compie 20 anni, ecco come ha fatto la storia | Wired ...",
        "link": "https://www.wired.it/article/youtube-20-anni-storia/",
        "logo": "https://encrypted-tbn1.gstatic.com/favicon-tbn?q=tbn:ANd9GcTNZPRbDNIzqnpXEHf9D7gMsMgswNoc6Ai37G-l1N3pvkacWcLbUEyoW3tsBvzel43K6dUNlJ40GxqCQU2KUizIP64IQ5ws8e6N-8Q1-MLHtG8",
        "source": "Wired",
        "image": "https://encrypted-tbn2.gstatic.com/images?q=tbn:ANd9GcQHkhjtx-2zs48nSm64xwXgqqAp2ZaOPOWgiKlg1Cg5fyaQpt0R",
        "image_url": "https://encrypted-tbn2.gstatic.com/images?q=tbn:ANd9GcQHkhjtx-2zs48nSm64xwXgqqAp2ZaOPOWgiKlg1Cg5fyaQpt0R",
        "rank": 18,
        "global_rank": 18
      },
      {
        "title": "Installare APP di YOUTUBE su Windows10 - YouTube",
        "link": "https://www.youtube.com/watch?v=0sk3XWTRKCY",
        "logo": "https://encrypted-tbn0.gstatic.com/favicon-tbn?q=tbn:ANd9GcQHQslzHLLyLc_qne5jxn7JocidlmUPyegZ8ojX3WVlorFk8BxW9a3vJWjDzN99UHVTqSaNBj_-6XykhxuVQfF3Ye7xScSWSuc2QHXi0a12CkVwBmo",
        "source": "YouTube",
        "image": "https://encrypted-tbn3.gstatic.com/images?q=tbn:ANd9GcQjTW3p5Nd9g_MBrLsKVgg4xCEp5tfcDUn0JX1zuLVhshjygn2N",
        "image_url": "https://encrypted-tbn3.gstatic.com/images?q=tbn:ANd9GcQjTW3p5Nd9g_MBrLsKVgg4xCEp5tfcDUn0JX1zuLVhshjygn2N",
        "rank": 19,
        "global_rank": 19
      },
      {
        "title": "I canali YouTube da seguire per imparare la storia ...",
        "link": "https://www.focusjunior.it/scuola/storia/canali-youtube-storia/",
        "logo": "https://encrypted-tbn2.gstatic.com/favicon-tbn?q=tbn:ANd9GcQ_Ztb3_R87Lu4TAwYlJh4eQS2DFxwc6Hjy4fNTmHj2WcpOY0JSBg6M93uVJtSZglgzTMPO9IhAlk9MfCnR0guQtlhZcSFpDMH-ui_8UPNmO0CifGa7f_U",
        "source": "FocusJunior.it",
        "image": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcSTLmZSLFh9nZYcFeAHEk9gKYx4UhtbsLA6iyHLPlvvUg5qCYZK",
        "image_url": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcSTLmZSLFh9nZYcFeAHEk9gKYx4UhtbsLA6iyHLPlvvUg5qCYZK",
        "rank": 20,
        "global_rank": 20
      },
      {
        "title": "Canali Video | Dipartimento di Chirurgia",
        "link": "https://chirurgia.web.uniroma1.it/it/canali-video",
        "logo": "https://encrypted-tbn0.gstatic.com/favicon-tbn?q=tbn:ANd9GcSfJxpEqOXXBiVDlt5IZlpYGoN3lzKbj6vD6YsAucBIwVBD4ehjMyaNuN7_c0Ha9bvVpJ1mXWPN-EgqIMnO7Nl0L4kX-d2jyPymqjipoKfh9McdVzu0jL_hTldPD-sF",
        "source": "Sapienza Università di Roma",
        "image": "https://encrypted-tbn3.gstatic.com/images?q=tbn:ANd9GcQN41rEo-ELHGSR8uZak6deN5MHa258xeZNO2zerFebjzL8yCz0",
        "image_url": "https://encrypted-tbn3.gstatic.com/images?q=tbn:ANd9GcQN41rEo-ELHGSR8uZak6deN5MHa258xeZNO2zerFebjzL8yCz0",
        "rank": 21,
        "global_rank": 21
      },
      {
        "title": "Youtube Live Streaming – Varvid",
        "link": "https://varvid.com/broadcast-platforms/youtube/",
        "logo": "https://encrypted-tbn0.gstatic.com/favicon-tbn?q=tbn:ANd9GcRt9iyy-3-IW5iqOAYPaXafEUkma3FFNpyZ975Llg6NySgv6jDhL0aC_yGcYyedQxEPrACxZiQcVikTSGJKfEPFpCr0bG55riarTKeEvAGH",
        "source": "varvid.com",
        "image": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcTFA-6rv6huR7t2LS2ELkPJV7iQ2AM5sC6GCwWtvL37ACe-Sm9T",
        "image_url": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcTFA-6rv6huR7t2LS2ELkPJV7iQ2AM5sC6GCwWtvL37ACe-Sm9T",
        "rank": 22,
        "global_rank": 22
      },
      {
        "title": "How to share a YouTube video starting at a specific time ...",
        "link": "https://www.foxnews.com/tech/how-share-youtube-video-starting-specific-time",
        "logo": "https://encrypted-tbn1.gstatic.com/favicon-tbn?q=tbn:ANd9GcQVx4PNOkwyIKigtzRRkbJhhFkJHqN_SRMlPVlAq-1o8H9-VoeLnReotGS2Fkrg1KkJqFas-T4SuJ0YVKtQx5MZEu0ladHVFErrMwzVLr1-aon-6FI",
        "source": "Fox News",
        "image": "https://encrypted-tbn2.gstatic.com/images?q=tbn:ANd9GcTOoImdEyesSvClzoCpQvmbJmAsN7lfIbIRVsGNHsWXWkRGzNaC",
        "image_url": "https://encrypted-tbn2.gstatic.com/images?q=tbn:ANd9GcTOoImdEyesSvClzoCpQvmbJmAsN7lfIbIRVsGNHsWXWkRGzNaC",
        "rank": 23,
        "global_rank": 23
      },
      {
        "title": "Storia di YouTube - FASTWEBPLUS",
        "link": "https://www.fastweb.it/fastweb-plus/digital-marketing-social/youtube-la-storia/",
        "logo": "https://encrypted-tbn3.gstatic.com/favicon-tbn?q=tbn:ANd9GcQibqeiTf2oFFIN3s6727bZSB4Eh1lvb2OvJmpGdkfR7-S__vUDUXK7ZtPlN5Zxn6s9VhgIQQeesoWmdXjq4U3aaUFd4J5NvcsORecUJ1teM-PwvQ",
        "source": "Fastweb",
        "image": "https://encrypted-tbn2.gstatic.com/images?q=tbn:ANd9GcSzv_0opRJ0u9J_Lcbbr0LY_4PGj6MNzNnsobq6-mGou5-hIezj",
        "image_url": "https://encrypted-tbn2.gstatic.com/images?q=tbn:ANd9GcSzv_0opRJ0u9J_Lcbbr0LY_4PGj6MNzNnsobq6-mGou5-hIezj",
        "rank": 24,
        "global_rank": 24
      },
      {
        "title": "Pubblicità su YouTube: quanto costa e come farla | Italiaonline",
        "link": "https://www.italiaonline.it/risorse/pubblicita-su-youtube-costi-e-consigli-pratici-per-iniziare-2704",
        "logo": "https://encrypted-tbn0.gstatic.com/favicon-tbn?q=tbn:ANd9GcQzG707t-UnUkkRWg4KMLn7GIjexYOv4o7xwM0Uz-g7WVQ3rQpAIATR55SpSz1V1Tq4xeIqHIlpKwjI9J__AWDdoelelTtfCfGsmJusO-yRD8fAEk_HWwlW",
        "source": "Italiaonline",
        "image": "https://encrypted-tbn2.gstatic.com/images?q=tbn:ANd9GcQ24gfzQMiyMHQCrMxA_AVhoU_T4Z2VKliwWYRjUY5WpwMkLw36",
        "image_url": "https://encrypted-tbn2.gstatic.com/images?q=tbn:ANd9GcQ24gfzQMiyMHQCrMxA_AVhoU_T4Z2VKliwWYRjUY5WpwMkLw36",
        "rank": 25,
        "global_rank": 25
      },
      {
        "title": "YouTube Creators (@YouTubeCreators) / Posts / X",
        "link": "https://x.com/YouTubeCreators",
        "logo": "https://encrypted-tbn0.gstatic.com/favicon-tbn?q=tbn:ANd9GcSofvqtbDtdUTZsANJSe_PTSgsuDSmzMNykD5ePbsMk3EyTY0EoF56jNp_rHuufm9BtNpZYsFhp9M6u-DLxqcg2x-FRa41-OCrNmA",
        "source": "X",
        "image": "https://encrypted-tbn1.gstatic.com/images?q=tbn:ANd9GcTpYm0h48xaRTDWgjq-VmSTCs-T0tZlf-TYLWaEkUFI6qXpuNBd",
        "image_url": "https://encrypted-tbn1.gstatic.com/images?q=tbn:ANd9GcTpYm0h48xaRTDWgjq-VmSTCs-T0tZlf-TYLWaEkUFI6qXpuNBd",
        "rank": 26,
        "global_rank": 26
      },
      {
        "title": "YouTube Premium Hiking Prices On Family Plan Service Just ...",
        "link": "https://www.imdb.com/it/news/ni63800513/",
        "logo": "https://encrypted-tbn2.gstatic.com/favicon-tbn?q=tbn:ANd9GcTFehdJYsJGaKRE9UV-IK0kaOc0dNWXVGr3XLPVFUGvc-sssumlm-DVVWDCahNCXEbCcS9XnW6yhTAYAjfCH8kiJvjjmg2R3XCq5d_cl1CJe0c",
        "source": "IMDb",
        "image": "https://encrypted-tbn3.gstatic.com/images?q=tbn:ANd9GcRUdwMKaMRwijquPGu_ZMr2yIh-lfejdvzeXEUCGNwG_2n-tIZk",
        "image_url": "https://encrypted-tbn3.gstatic.com/images?q=tbn:ANd9GcRUdwMKaMRwijquPGu_ZMr2yIh-lfejdvzeXEUCGNwG_2n-tIZk",
        "rank": 27,
        "global_rank": 27
      },
      {
        "title": "Cost of Living in Italy | Italian Cell Phone and Home Internet",
        "link": "http://www.rafaeldifuria.com/2-cost-of-living-in-italy/",
        "logo": "https://encrypted-tbn2.gstatic.com/favicon-tbn?q=tbn:ANd9GcSSG0TUm1VLSIjW78ktClbDJulZat6eOZP3TJxOP1PdHL6PZTGop5ECoMjdHNN0lecB0JDj8uJj_1kkM9Q87mOfPdABhegUSEWpxq9Fj3M59_GRYPRszlFA_A",
        "source": "Rafael Di Furia",
        "image": "https://encrypted-tbn3.gstatic.com/images?q=tbn:ANd9GcQdy8ZDbQmGHV96HohESFUmKVQINpBGorhyafzXgCcIOYhx5_oJ",
        "image_url": "https://encrypted-tbn3.gstatic.com/images?q=tbn:ANd9GcQdy8ZDbQmGHV96HohESFUmKVQINpBGorhyafzXgCcIOYhx5_oJ",
        "rank": 28,
        "global_rank": 28
      },
      {
        "title": "Lo youtuber: un lavoro di fatto o solo hobby? - CMW lab",
        "link": "https://www.cmwlab.it/talks/lo-youtuber-un-lavoro-di-fatto-o-solo-hobby/",
        "logo": "https://encrypted-tbn0.gstatic.com/favicon-tbn?q=tbn:ANd9GcQDS40iZ9iFdwM0TimYwq-JoKczfwRWm7IX1qzwu9jMmVA-my1r6OLC2qkLZhlbHtP-q15MSAARchruDzl5d4M5yJDz_k6LvWmgW7jDh3uBUfVt",
        "source": "cmwlab.it",
        "image": "https://encrypted-tbn3.gstatic.com/images?q=tbn:ANd9GcRixio63NO9jA1g35ur5-MbGRcXPbkfdB19_NshxJmHXFiCuORW",
        "image_url": "https://encrypted-tbn3.gstatic.com/images?q=tbn:ANd9GcRixio63NO9jA1g35ur5-MbGRcXPbkfdB19_NshxJmHXFiCuORW",
        "rank": 29,
        "global_rank": 29
      },
      {
        "title": "Come funziona l'algoritmo di YouTube | Salvatore Aranzulla",
        "link": "https://www.aranzulla.it/come-funziona-lalgoritmo-di-youtube-1546586.html",
        "logo": "https://encrypted-tbn2.gstatic.com/favicon-tbn?q=tbn:ANd9GcRUu0vV7VyqmAzB58l9-BV8KO7uXEv-d4K9t-cRarNgGwxsjyslQbkplYUCIfAsXtpEqzxxgl_ZfX3bkWztATTed0jsqb74J0Ua-KH4cV7BS6-i8oVS",
        "source": "Salvatore Aranzulla",
        "image": "https://encrypted-tbn1.gstatic.com/images?q=tbn:ANd9GcTYMrxHzP3aoUB_2mrdV54z20x_HgJPjhXuUw4eA53yc11D6hNY",
        "image_url": "https://encrypted-tbn1.gstatic.com/images?q=tbn:ANd9GcTYMrxHzP3aoUB_2mrdV54z20x_HgJPjhXuUw4eA53yc11D6hNY",
        "rank": 30,
        "global_rank": 30
      },
      {
        "title": "YouTube Is Getting Two New Smart Features",
        "link": "https://www.howtogeek.com/youtube-is-getting-two-new-smart-features/",
        "logo": "https://encrypted-tbn0.gstatic.com/favicon-tbn?q=tbn:ANd9GcQi7d7OE3tYYpQ0K0N2YmwhwaeJDpQia9z8E5mUUGmYuXveM7Jc79TKGAwew0HGVw8nR3bhm6JDzDYTfw9UOl8rmynEx6jiQgFI18MGyTgd52tKjiLMwQ",
        "source": "How-To Geek",
        "image": "https://encrypted-tbn1.gstatic.com/images?q=tbn:ANd9GcS5aAPiqqU_t-jR1gLb3Fs8bPIaW2N7eKjZlmGEZUU8MP0N-sP_",
        "image_url": "https://encrypted-tbn1.gstatic.com/images?q=tbn:ANd9GcS5aAPiqqU_t-jR1gLb3Fs8bPIaW2N7eKjZlmGEZUU8MP0N-sP_",
        "rank": 31,
        "global_rank": 31
      },
      {
        "title": "YouTube Music Review | PCMag",
        "link": "https://www.pcmag.com/reviews/youtube-music",
        "logo": "https://encrypted-tbn2.gstatic.com/favicon-tbn?q=tbn:ANd9GcQT2SxtS9PqiMpEW2DDJLdjuVqHzsB-BQ_R7sUFdvjuE3SMmj4UDrJTT0vpXgXFeSKQtj3idX4xCu9G5dm0yLJ9c45ktlpBDPBKR2kVTtday3EF",
        "source": "PCMag",
        "image": "https://encrypted-tbn2.gstatic.com/images?q=tbn:ANd9GcRuf5sF-d6UFF8UNcLGO-duPlx_Ir1i4MoSICNnH8NU08ifkakF",
        "image_url": "https://encrypted-tbn2.gstatic.com/images?q=tbn:ANd9GcRuf5sF-d6UFF8UNcLGO-duPlx_Ir1i4MoSICNnH8NU08ifkakF",
        "rank": 32,
        "global_rank": 32
      },
      {
        "title": "File:YouTube logo upside down.jpg - Wikipedia",
        "link": "https://en.wikipedia.org/wiki/File:YouTube_logo_upside_down.jpg",
        "logo": "https://encrypted-tbn2.gstatic.com/favicon-tbn?q=tbn:ANd9GcRLIcgPlYxOaoBg0MnSobLYyflrgF_RLdwAY09AXHWGy2jqWQnuIBNCY5I1BuzY7jeAJga0y0b9htBHe94i3Pg4B0NhHMNDVsmS-FVRKL014d-Xf6sX",
        "source": "Wikipedia",
        "image": "https://encrypted-tbn2.gstatic.com/images?q=tbn:ANd9GcSfrQHl2V53W7OwOig95s00ICt1v4hY4a7lZNd0b-uyTTtj5cGV",
        "image_url": "https://encrypted-tbn2.gstatic.com/images?q=tbn:ANd9GcSfrQHl2V53W7OwOig95s00ICt1v4hY4a7lZNd0b-uyTTtj5cGV",
        "rank": 33,
        "global_rank": 33
      },
      {
        "title": "Come funziona il sistema dei video consigliati su YouTube",
        "link": "https://www.franzrusso.it/condividere-comunicare/come-funziona-sistema-video-consigliati-youtube/",
        "logo": "https://encrypted-tbn3.gstatic.com/favicon-tbn?q=tbn:ANd9GcQaF0FSE7PxA7btowNW0WI4eDj_FIKEI_8408re2-q1-EWHUjS5AQVoTTaJ-RakzjGMdUBAvUq-zSLlGEqkkpNnEcOtOky24fZQuUa_IiOj565m9k0KBw",
        "source": "Franz Russo",
        "image": "https://encrypted-tbn2.gstatic.com/images?q=tbn:ANd9GcT-1SdNMHWAPCiQEx-PaXPiQgbyeVdsltTbQ1JQ2wYMJqxu4kPJ",
        "image_url": "https://encrypted-tbn2.gstatic.com/images?q=tbn:ANd9GcT-1SdNMHWAPCiQEx-PaXPiQgbyeVdsltTbQ1JQ2wYMJqxu4kPJ",
        "rank": 34,
        "global_rank": 34
      },
      {
        "title": "I 10 video di YouTube più visti di sempre | Wired Italia",
        "link": "https://www.wired.it/article/video-youtube-piu-visti-di-sempre/",
        "logo": "https://encrypted-tbn1.gstatic.com/favicon-tbn?q=tbn:ANd9GcTNZPRbDNIzqnpXEHf9D7gMsMgswNoc6Ai37G-l1N3pvkacWcLbUEyoW3tsBvzel43K6dUNlJ40GxqCQU2KUizIP64IQ5ws8e6N-8Q1-MLHtG8",
        "source": "Wired",
        "image": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcRM76n1BuaKDNQ68GXp_7gBquBqhONk5FYIlzrpM8FOTfAqKlXv",
        "image_url": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcRM76n1BuaKDNQ68GXp_7gBquBqhONk5FYIlzrpM8FOTfAqKlXv",
        "rank": 35,
        "global_rank": 35
      },
      {
        "title": "Shannon Ong - Product Lead at YouTube (Google) | Ex-Amazon ...",
        "link": "https://www.linkedin.com/in/shannon-ong-44887053",
        "logo": "https://encrypted-tbn3.gstatic.com/favicon-tbn?q=tbn:ANd9GcTFMvFisG5Yfyq07VS0hk1otTr6uQvufSrlgYLzmBkZlxd7MQh66ZmKRUOdwfXrertN7RslYSLWGQCDyxLn3JsHLob5z5LPzTRUUQlVmSHaBnVJlJa8",
        "source": "LinkedIn",
        "image": "https://encrypted-tbn3.gstatic.com/images?q=tbn:ANd9GcSHV_Rg6Zrd0YDIQ2z9jIc_bujs7QKmKxjUMoDk6jXc_c9S5XVv",
        "image_url": "https://encrypted-tbn3.gstatic.com/images?q=tbn:ANd9GcSHV_Rg6Zrd0YDIQ2z9jIc_bujs7QKmKxjUMoDk6jXc_c9S5XVv",
        "rank": 36,
        "global_rank": 36
      },
      {
        "title": "YouTube for Android TV - Download APK per Android | Aptoide",
        "link": "https://atv-smart-youtube-tv-bridge.it.aptoide.com/app",
        "logo": "https://encrypted-tbn2.gstatic.com/favicon-tbn?q=tbn:ANd9GcRmou9huBiGuvQ21o1_oHca9pNgDLkKfBV39Ymzeqzl9bVNgBcQESX4EAfJATbcbQY7S7GQuJO1Ou6Jc24MdGEl8WlzAqg5TJjUSdBlq3Ukq0yLY5PpixNL4RUL2kJVtac3Fo67G2BmBOCHfCB5okQ",
        "source": "Aptoide",
        "image": "https://encrypted-tbn1.gstatic.com/images?q=tbn:ANd9GcQbFb_Z78oKP5XSvEuouNwS_eTmOoVZjJsJNzdvHMokFARfQcCI",
        "image_url": "https://encrypted-tbn1.gstatic.com/images?q=tbn:ANd9GcQbFb_Z78oKP5XSvEuouNwS_eTmOoVZjJsJNzdvHMokFARfQcCI",
        "rank": 37,
        "global_rank": 37
      },
      {
        "title": "YouTube | Giochi scaricabili per Nintendo Switch | Giochi ...",
        "link": "https://www.nintendo.com/it-it/Giochi/Giochi-scaricabili-per-Nintendo-Switch/YouTube-1467860.html",
        "logo": "https://encrypted-tbn2.gstatic.com/favicon-tbn?q=tbn:ANd9GcToBGjo96GmUCHevYIGmN-UpS53MeR2ZhzA3_OkIOo1c13GKN_eBvJl9QW6mzxeD5hTpJ-y6aDxlz1ebw2zFTwvBQpumpCdgwqbY9MRx5lDJF5Ae_Qe",
        "source": "Nintendo",
        "image": "https://encrypted-tbn3.gstatic.com/images?q=tbn:ANd9GcTPcmAj_Iyu7oeyUAs0i72rjbHTIqZRXvIAVCd2qhICSr95odw4",
        "image_url": "https://encrypted-tbn3.gstatic.com/images?q=tbn:ANd9GcTPcmAj_Iyu7oeyUAs0i72rjbHTIqZRXvIAVCd2qhICSr95odw4",
        "rank": 38,
        "global_rank": 38
      },
      {
        "title": "Videos - Springdale FWB - Springdale Free Will Baptist Church",
        "link": "https://www.springdalefwb.org/videos.html",
        "logo": "https://encrypted-tbn1.gstatic.com/favicon-tbn?q=tbn:ANd9GcRqfiy0VdOS4lUakqCu5N8oAxk1lHi2UaYOIXQHAKeXimo0wfiqsUhsC8W74MzgM1uVP4A1OfEYMAxluM5HZzWfyPpD_RblP2GNnRHVxUFnREbuqPZT2UY4gw4",
        "source": "Springdale Free Will Baptist Church",
        "image": "https://encrypted-tbn2.gstatic.com/images?q=tbn:ANd9GcQnoUBdcMizJv-JxXxIQAVVUTuZKps3gGr-K2riQiHI58po0zMW",
        "image_url": "https://encrypted-tbn2.gstatic.com/images?q=tbn:ANd9GcQnoUBdcMizJv-JxXxIQAVVUTuZKps3gGr-K2riQiHI58po0zMW",
        "rank": 39,
        "global_rank": 39
      },
      {
        "title": "Come scaricare un immagine copertina di un video YouTube ...",
        "link": "https://webalquadrato.it/come-scaricare-un-immagine-copertina-di-un-video-youtube/",
        "logo": "https://encrypted-tbn2.gstatic.com/favicon-tbn?q=tbn:ANd9GcQqQLHtVtIDCM4p5M9cKyfWvs5oDIfpFJfHM-vRxjW2lSZ2fiShFZO5qOTXBiu0qgA_-nJOD15TpD_-4orPtUBnc5n-PMslDq5f983xndy1DgwZmzob",
        "source": "Web al quadrato",
        "image": "https://encrypted-tbn2.gstatic.com/images?q=tbn:ANd9GcTMsPGpEn62QA4Mbp5b1w1BukB0845GFcxnabPIa_NNOti8mwbY",
        "image_url": "https://encrypted-tbn2.gstatic.com/images?q=tbn:ANd9GcTMsPGpEn62QA4Mbp5b1w1BukB0845GFcxnabPIa_NNOti8mwbY",
        "rank": 40,
        "global_rank": 40
      },
      {
        "title": "List of YouTube Premium original programming - Wikipedia",
        "link": "https://en.wikipedia.org/wiki/List_of_YouTube_Premium_original_programming",
        "logo": "https://encrypted-tbn2.gstatic.com/favicon-tbn?q=tbn:ANd9GcRLIcgPlYxOaoBg0MnSobLYyflrgF_RLdwAY09AXHWGy2jqWQnuIBNCY5I1BuzY7jeAJga0y0b9htBHe94i3Pg4B0NhHMNDVsmS-FVRKL014d-Xf6sX",
        "source": "Wikipedia",
        "image": "https://encrypted-tbn2.gstatic.com/images?q=tbn:ANd9GcQCdjg8v5Sy3YsUUJ7-QKrqKVv26GF2AbrlVv_rQrpC5kdTfq9_",
        "image_url": "https://encrypted-tbn2.gstatic.com/images?q=tbn:ANd9GcQCdjg8v5Sy3YsUUJ7-QKrqKVv26GF2AbrlVv_rQrpC5kdTfq9_",
        "rank": 41,
        "global_rank": 41
      },
      {
        "title": "YouTube come mezzo di comunicazione. I canali diventano ...",
        "link": "https://www.ecommerceguru.it/youtube-come-mezzo-di-comunicazione/",
        "logo": "https://encrypted-tbn2.gstatic.com/favicon-tbn?q=tbn:ANd9GcTlXC0HckJlOMKsilif9KELjOHd62VYSJFK0mmewDY9MDAHHi5mGbZATgwf9k581dMWeh1F_DidSh11JvqMsWzelPmDvArMyJnlogBFKOkDzeu6xgKiikhvpw",
        "source": "ecommerceguru.it",
        "image": "https://encrypted-tbn1.gstatic.com/images?q=tbn:ANd9GcQ4WRq8HcvOsFshqR-1_Mqnh8S8nyW5vqEc7U0mQsCAMAQZvXva",
        "image_url": "https://encrypted-tbn1.gstatic.com/images?q=tbn:ANd9GcQ4WRq8HcvOsFshqR-1_Mqnh8S8nyW5vqEc7U0mQsCAMAQZvXva",
        "rank": 42,
        "global_rank": 42
      },
      {
        "title": "AI Overviews Are Coming To YouTube In New Test",
        "link": "https://www.tulsamarketingonline.com/ai-overviews-are-coming-to-youtube-in-new-test/",
        "logo": "https://encrypted-tbn0.gstatic.com/favicon-tbn?q=tbn:ANd9GcQdlX-huMkuAXP9QrJWUVbCax_aXdhGZO9qhv8aeHvTCCjnHzWOfuNp56fCD5n-lQFo2UOXmqvBrWv1EP-Y3kRZL70kqvASoG3GGaVXHP1FDF_9UrN2663TziCS-bzqD4Hw",
        "source": "Tulsa Marketing Online",
        "image": "https://encrypted-tbn1.gstatic.com/images?q=tbn:ANd9GcSrAt7rOPRTZ3ARkL-YGWskDIZZrBNHNFU8hu07vmAdCxPSDyOH",
        "image_url": "https://encrypted-tbn1.gstatic.com/images?q=tbn:ANd9GcSrAt7rOPRTZ3ARkL-YGWskDIZZrBNHNFU8hu07vmAdCxPSDyOH",
        "rank": 43,
        "global_rank": 43
      },
      {
        "title": "youtubelogo.tiny - Piccola Università Italiana",
        "link": "https://piccolauniversitaitaliana.com/blog/youtube-channel-of-our-school/attachment/youtubelogo-tiny-2/",
        "logo": "https://encrypted-tbn0.gstatic.com/favicon-tbn?q=tbn:ANd9GcR_uujiZj-c2T9IQGsi6RNDQA89V4tPPS5KRIxQZ9N88MXVOjUm4UoW-68H-wX87kpvdGQooJKCi1audgBArGeKR1a8zRH9D8hYgcR6mwH7nciS06nMb8nanUXoewto4NcU9g",
        "source": "Piccola Università Italiana",
        "image": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcT1WIniCTAf1KvBtx0SgYqJnVbcv2-_Ss44mQt0Z6xqtFZ27oAx",
        "image_url": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcT1WIniCTAf1KvBtx0SgYqJnVbcv2-_Ss44mQt0Z6xqtFZ27oAx",
        "rank": 44,
        "global_rank": 44
      },
      {
        "title": "Watching YouTube Videos in Whonix",
        "link": "https://www.whonix.org/wiki/YouTube",
        "logo": "https://encrypted-tbn1.gstatic.com/favicon-tbn?q=tbn:ANd9GcR7RCT4r1ULdXFpOWV7360X_4uHe_tgQD8LjRH_CH1PdrUaVhIVyar26V_7gxFFa3iH8Oy21z9GPKAYnBLMmPWgbGAmEwYkn8RSAqv6Zzv0OcuUFQ",
        "source": "Whonix",
        "image": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcRXYvXSyyCilfbT9uHBSCn_f8N0EHl1BJIvVnTlaimF1YfRaHUK",
        "image_url": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcRXYvXSyyCilfbT9uHBSCn_f8N0EHl1BJIvVnTlaimF1YfRaHUK",
        "rank": 45,
        "global_rank": 45
      },
      {
        "title": "Città di Ponte San Pietro : Canale YouTube: aggiornamenti video",
        "link": "https://www.comune.pontesanpietro.bg.it/novita/comunicati/dettaglio-notizia/Canale-YouTube-aggiornamenti-video/",
        "logo": "https://encrypted-tbn2.gstatic.com/favicon-tbn?q=tbn:ANd9GcQYy6M3JjkX0X8LPbEOZE4CKd12ng6JUKdWNiyzTNZJ6sQl3rJtN7USDPjLsV-quvoQfua6PHHUlDqm9DlYGTlNZOwqt2JsjYxjLCzBzofYZHBnh5TLsWLRhLBSIP2wNx3BaZpR",
        "source": "pontesanpietro.bg.it",
        "image": "https://encrypted-tbn2.gstatic.com/images?q=tbn:ANd9GcTuKDi6F0Pi_otuJXdsJk3LoL3vUdYphDcle31ckVsg5tR1ce_3",
        "image_url": "https://encrypted-tbn2.gstatic.com/images?q=tbn:ANd9GcTuKDi6F0Pi_otuJXdsJk3LoL3vUdYphDcle31ckVsg5tR1ce_3",
        "rank": 46,
        "global_rank": 46
      },
      {
        "title": "Press",
        "link": "https://www.iiha.org/press.html",
        "logo": "https://encrypted-tbn2.gstatic.com/favicon-tbn?q=tbn:ANd9GcRhW5srReDyH4_Ak-Tx9sMmSq-Dbpveb62oLnH4KmiLq3WFl3jmpv0iPDENzO-MoVm8mduSVpKp_WebkoCPBxhk8dFAXXiZwVYRfIxPXJ5JWro",
        "source": "Irish Ice Hockey Association",
        "image": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcQ2hEDNlncUZyS8U3J6dUD1-BxhSq1amS3ffxckJGdzzilKYXsJ",
        "image_url": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcQ2hEDNlncUZyS8U3J6dUD1-BxhSq1amS3ffxckJGdzzilKYXsJ",
        "rank": 47,
        "global_rank": 47
      },
      {
        "title": "YouTube su Switch: un'accoppiata che funziona",
        "link": "https://it.ign.com/nintendo-switch/147290/feature/youtube-su-switch-unaccoppiata-che-funziona",
        "logo": "https://encrypted-tbn0.gstatic.com/favicon-tbn?q=tbn:ANd9GcSSV2SvwjCHocUU61DsiGPk_xEyElRFvCIpM_4xYZbvJZt60dCBPEDxcQG_Btpd1nXTXg3O6C2K0d7Knb8SZOxPols7I1RBKwjo2DG8czqG",
        "source": "IGN",
        "image": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcQ4guUHpb7PpQ0iB6vnGeBIVPaKrwBMErmLOxQYBGwoWW434KJK",
        "image_url": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcQ4guUHpb7PpQ0iB6vnGeBIVPaKrwBMErmLOxQYBGwoWW434KJK",
        "rank": 48,
        "global_rank": 48
      },
      {
        "title": "Second chances on YouTube - YouTube Blog",
        "link": "https://blog.youtube/inside-youtube/second-chances-on-youtube/",
        "logo": "https://encrypted-tbn0.gstatic.com/favicon-tbn?q=tbn:ANd9GcQ6knNVKlTZXHba4AvgwcPeP1LSOT0TtO_nBtUHwAPuP-HGZD_UR3N4CIuTBLH014pjXkVi8F1RBibCJPxLvsuH6kqD7AxlkWJpv5mcAAer2BE",
        "source": "blog.youtube",
        "image": "https://encrypted-tbn1.gstatic.com/images?q=tbn:ANd9GcTTf5i3EODOl4b32sCP5Yhgj4hNmvVPWgwZTD5YDT0OncItqKCO",
        "image_url": "https://encrypted-tbn1.gstatic.com/images?q=tbn:ANd9GcTTf5i3EODOl4b32sCP5Yhgj4hNmvVPWgwZTD5YDT0OncItqKCO",
        "rank": 49,
        "global_rank": 49
      },
      {
        "title": "Talking Socks – Yarndale",
        "link": "https://yarndale.co.uk/yarndale-hub/talking-socks/",
        "logo": "https://encrypted-tbn2.gstatic.com/favicon-tbn?q=tbn:ANd9GcRW-jDkjydIsMxsIswJAjXKYPgAGHbi5frCW_wkxIlJVsn_RX57VXne-KKjHK3yL5mtffPfYwTcrfJuXw4HXZ2YD6jOEsMhuRORN8GTa40qsyq_Ww",
        "source": "Yarndale",
        "image": "https://encrypted-tbn3.gstatic.com/images?q=tbn:ANd9GcSdYWY7pF-cjaLg7cqkh-bus_51jAvae90N7h3ieGK14aqKSA1G",
        "image_url": "https://encrypted-tbn3.gstatic.com/images?q=tbn:ANd9GcSdYWY7pF-cjaLg7cqkh-bus_51jAvae90N7h3ieGK14aqKSA1G",
        "rank": 50,
        "global_rank": 50
      },
      {
        "title": "Best Free YouTube Video Downloader for Windows 2025",
        "link": "https://www.donemax.com/video-download/top-4-free-youtube-video-downloader.html",
        "logo": "https://encrypted-tbn3.gstatic.com/favicon-tbn?q=tbn:ANd9GcT42ycJdf2UKgzoluI34OleyFF20kCMoM4nCVIyKw6nZHeVCEEYZRNkNzQOSdCzqTsMJC0veLw3rjdZkoJJJb57F_FMNM63E8_laLInHR0Vxvk-wSQ",
        "source": "Donemax",
        "image": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcSRNHWLmtSnUSexb14Iegqe3ZtC3-TjRAiHzoLmjzm2dhr9a8fc",
        "image_url": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcSRNHWLmtSnUSexb14Iegqe3ZtC3-TjRAiHzoLmjzm2dhr9a8fc",
        "rank": 51,
        "global_rank": 51
      },
      {
        "title": "Testimonianze - Clau, voglio diventare ingegnere",
        "link": "https://clauqsi.com/it/testimonianze",
        "logo": "https://encrypted-tbn1.gstatic.com/favicon-tbn?q=tbn:ANd9GcRq0bWaYnFKSUlL5Bqc42G56ZVCx7Wxy_brTzlvm8n1DqzAznp8xdso2ZwOv9R8lwFL3Xf5cxBfFkRPmOhpcPSP4WUhlU4W4W4idiHKRyFIWA",
        "source": "Clau, quiero ser ingeniera",
        "image": "https://encrypted-tbn1.gstatic.com/images?q=tbn:ANd9GcTRu0KyScoMFSBoE16gLVu9g7A3WpgVOkFi4H13bzbIvW_ZzC7y",
        "image_url": "https://encrypted-tbn1.gstatic.com/images?q=tbn:ANd9GcTRu0KyScoMFSBoE16gLVu9g7A3WpgVOkFi4H13bzbIvW_ZzC7y",
        "rank": 52,
        "global_rank": 52
      },
      {
        "title": "Modello youtube logo | PosterMyWall",
        "link": "https://it.postermywall.com/index.php/art/template/7f67c7b6e98d694318172f5e604754bf/youtube-logo-design-template",
        "logo": "https://encrypted-tbn3.gstatic.com/favicon-tbn?q=tbn:ANd9GcRpQxOSkKstTyAFbJHW7rFZ432-A3RYGcUNLv2-07rCPWsOoVu086hoXkahUhaXtmu30niar0mQHpOfVbOLQTutltborWpYq9eh-eAnQWpzodI5tEtf8uW_",
        "source": "PosterMyWall",
        "image": "https://encrypted-tbn2.gstatic.com/images?q=tbn:ANd9GcQ0BRHf0T2mCd0w0aZdoBUQJdUm1Ln9AeKzH_-Jla64YK6_3TBU",
        "image_url": "https://encrypted-tbn2.gstatic.com/images?q=tbn:ANd9GcQ0BRHf0T2mCd0w0aZdoBUQJdUm1Ln9AeKzH_-Jla64YK6_3TBU",
        "rank": 53,
        "global_rank": 53
      },
      {
        "title": "Rob Pratley",
        "link": "https://luc.devroye.org/fonts-87321.html",
        "logo": "https://encrypted-tbn1.gstatic.com/favicon-tbn?q=tbn:ANd9GcQWUq4levL2IJLit-bQYDm4o9U35ZP1zDILK4M6PZ6IXNLyCCfM8mN-Dbup_Cpy009Pdqs1OO4W0vRc2OyGIu5EkE4SHxrmzXIh0JQo5KSeh2hI2HA",
        "source": "devroye.org",
        "image": "https://encrypted-tbn2.gstatic.com/images?q=tbn:ANd9GcRVwnQjv1TrJlbyTjSQfLesOC8dVjEjXQlEF08KnM-2HdN1g0po",
        "image_url": "https://encrypted-tbn2.gstatic.com/images?q=tbn:ANd9GcRVwnQjv1TrJlbyTjSQfLesOC8dVjEjXQlEF08KnM-2HdN1g0po",
        "rank": 54,
        "global_rank": 54
      },
      {
        "title": "YouTube ha cambiato logo e grafica",
        "link": "https://www.ilpost.it/2017/08/29/youtube-nuovo-logo-grafica/",
        "logo": "https://encrypted-tbn0.gstatic.com/favicon-tbn?q=tbn:ANd9GcQp-snfKZuufR_iAZB397tN-BNRwouvNzxo8dSsZEupR4RNui_AX8ap7B4vsR34kj0V10xUWUWoXUN0aPkZ68w3plXZyyzZHsJZPopGufKBbFE7",
        "source": "Il Post",
        "image": "https://encrypted-tbn1.gstatic.com/images?q=tbn:ANd9GcTfUtY8fn-_Pip0clNa2qDhwz2rDmxTB3sESP0I7OO3TmQw5Co8",
        "image_url": "https://encrypted-tbn1.gstatic.com/images?q=tbn:ANd9GcTfUtY8fn-_Pip0clNa2qDhwz2rDmxTB3sESP0I7OO3TmQw5Co8",
        "rank": 55,
        "global_rank": 55
      },
      {
        "title": "Come guadagnare su YouTube - EuroFormation Formazione ...",
        "link": "https://www.euroformation.it/elenco-corsi/come-guadagnare-su-youtube/",
        "logo": "https://encrypted-tbn3.gstatic.com/favicon-tbn?q=tbn:ANd9GcQ4trsmZFzYn4QUE3VmVGhk133-S5_qpuEytq7ujFk4NGhIqk5hig3XfNYZU5Wqmatsqq94VuU1nNR1_eyw6nWrAdifa1y5jb622URJ_0XMNHbSSt3SMzHrGw",
        "source": "EuroFormation",
        "image": "https://encrypted-tbn3.gstatic.com/images?q=tbn:ANd9GcQwSNRvPPOe3Lr4tNIW3KEAag8zcgL6tDmrwQmG4rVtEvak75lI",
        "image_url": "https://encrypted-tbn3.gstatic.com/images?q=tbn:ANd9GcQwSNRvPPOe3Lr4tNIW3KEAag8zcgL6tDmrwQmG4rVtEvak75lI",
        "rank": 56,
        "global_rank": 56
      },
      {
        "title": "How to Copy YouTube Video URL Link from YouTube App on Phone ...",
        "link": "https://www.youtube.com/watch?v=QCwoGxArIsY",
        "logo": "https://encrypted-tbn0.gstatic.com/favicon-tbn?q=tbn:ANd9GcQHQslzHLLyLc_qne5jxn7JocidlmUPyegZ8ojX3WVlorFk8BxW9a3vJWjDzN99UHVTqSaNBj_-6XykhxuVQfF3Ye7xScSWSuc2QHXi0a12CkVwBmo",
        "source": "YouTube",
        "image": "https://encrypted-tbn1.gstatic.com/images?q=tbn:ANd9GcTmetLJpEeBZIkBH8iY9Hl9Zmg6FyRiNKggrlH2TYUydoK_WFTm",
        "image_url": "https://encrypted-tbn1.gstatic.com/images?q=tbn:ANd9GcTmetLJpEeBZIkBH8iY9Hl9Zmg6FyRiNKggrlH2TYUydoK_WFTm",
        "rank": 57,
        "global_rank": 57
      },
      {
        "title": "Youtube Immagini - Sfoglia 139,903 foto, vettoriali e video ...",
        "link": "https://stock.adobe.com/it/search?k=youtube",
        "logo": "https://encrypted-tbn2.gstatic.com/favicon-tbn?q=tbn:ANd9GcRmO_8sjV79Lvr80yZ9v1mjcRZDN1hZFi-kX0mYgHFcDxvZ4OuuaYwV5sxiW05Fr2yEjvT8RYkmpSI3x9KzYnAoAOZc8ty6wCgzyZMh0u3JrhgGpag",
        "source": "Adobe",
        "image": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcQjtKyF0z1Hck78_jgdXgYKBeedGXV1jWUKglS7pNRJlYkDBhrW",
        "image_url": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcQjtKyF0z1Hck78_jgdXgYKBeedGXV1jWUKglS7pNRJlYkDBhrW",
        "rank": 58,
        "global_rank": 58
      },
      {
        "title": "YouTube says that music is now 25% of its global watch time",
        "link": "https://musically.com/2021/09/16/youtube-says-that-music-is-now-25-of-its-global-watch-time/",
        "logo": "https://encrypted-tbn3.gstatic.com/favicon-tbn?q=tbn:ANd9GcSFAxZpnQqFaA4qoNqYk_NlH7wPwpNpjN3Fyh-p6wfFTc-IhE0-Ufkg2aomh1NFcGdcunSi9BYOB0RK6mkP7VVvlBlxdcQcbJILVSRsFGTY83Gj",
        "source": "Music Ally",
        "image": "https://encrypted-tbn3.gstatic.com/images?q=tbn:ANd9GcQjPmybg3_wHprlJf2gIX5GjEPxEsB51OyF42VDXiKkYjYF2oTr",
        "image_url": "https://encrypted-tbn3.gstatic.com/images?q=tbn:ANd9GcQjPmybg3_wHprlJf2gIX5GjEPxEsB51OyF42VDXiKkYjYF2oTr",
        "rank": 59,
        "global_rank": 59
      },
      {
        "title": "Come mandare un messaggio privato su YouTube - YouTube",
        "link": "https://www.youtube.com/watch?v=KmU-csRfCW0",
        "logo": "https://encrypted-tbn0.gstatic.com/favicon-tbn?q=tbn:ANd9GcQHQslzHLLyLc_qne5jxn7JocidlmUPyegZ8ojX3WVlorFk8BxW9a3vJWjDzN99UHVTqSaNBj_-6XykhxuVQfF3Ye7xScSWSuc2QHXi0a12CkVwBmo",
        "source": "YouTube",
        "image": "https://encrypted-tbn3.gstatic.com/images?q=tbn:ANd9GcRljGzaUycjQb5RmqkBcRwZeuHns3XuLgI69iBQQSFnPijyMXBd",
        "image_url": "https://encrypted-tbn3.gstatic.com/images?q=tbn:ANd9GcRljGzaUycjQb5RmqkBcRwZeuHns3XuLgI69iBQQSFnPijyMXBd",
        "rank": 60,
        "global_rank": 60
      }
    ]
  }
  ```
</ResponseExample>


# Image URL
Source: https://docs.brightdata.com/api-reference/serp/google-lens/image-url

Configure the Bright Data Google Lens Image URL parameter to refine queries and return matching results as JSON or HTML. On port 44445.

```txt wrap theme={null}
https://lens.google.com/uploadbyurl?url=https%3A%2F%2Fwww.youtube.com%2Fimg%2Fdesktop%2Fyt_1200.png
```

## Parameters

<ParamField type="query">
  URL of image you want to search

  ```txt wrap theme={null}
  https://lens.google.com/uploadbyurl?url=https%3A%2F%2Fwww.youtube.com%2Fimg%2Fdesktop%2Fyt_1200.png
  ```
</ParamField>

<RequestExample>
  ```shell cURL highlight={6} theme={null}
    curl -X POST https://api.brightdata.com/request \
    --header "Content-Type: application/json" \
    --header "Authorization: Bearer API_KEY" \
    --data '{
      "zone": "serp_api1",
      "url": "https://lens.google.com/uploadbyurl?url=https%3A%2F%2Fwww.youtube.com%2Fimg%2Fdesktop%2Fyt_1200.png",
      "format": "raw"
    }'
  ```

  ```shell Native proxy highlight={4} theme={null}
  curl --proxy brd.superproxy.io:44445 \
    --proxy-user CUSTOMER_USERNAME:CUSTOMER_PASSWORD \
    --ssl-no-revoke \
    "https://lens.google.com/uploadbyurl?url=https%3A%2F%2Fwww.youtube.com%2Fimg%2Fdesktop%2Fyt_1200.png"
  ```

  ```js Node.js highlight={10} theme={null}
  (async () => {
    const response = await fetch('https://api.brightdata.com/request', {
      method: 'POST',
      headers: {
        'Content-Type': 'application/json',
        'Authorization': 'Bearer API_KEY'
      },
      body: JSON.stringify({
        zone: 'serp_api1',
        url: 'https://lens.google.com/uploadbyurl?url=https%3A%2F%2Fwww.youtube.com%2Fimg%2Fdesktop%2Fyt_1200.png',
        format: 'raw'
      })
    });
    
    const data = await response.text();
    console.log(data);
  })();
  ```

  ```python Python highlight={11} theme={null}
  import requests

  # API Configuration
  headers = {
      'Content-Type': 'application/json',
      'Authorization': 'Bearer API_KEY',
  }

  payload = {
      'zone': 'serp_api1',
      'url': 'https://lens.google.com/uploadbyurl?url=https%3A%2F%2Fwww.youtube.com%2Fimg%2Fdesktop%2Fyt_1200.png',
      'format': 'raw'
  }

  # Make the request
  response = requests.post(
      'https://api.brightdata.com/request', 
      json=payload, 
      headers=headers
  )

  print(response.text)
  ```
</RequestExample>

<ResponseExample>
  ```json 200 theme={null}
  {
    "general": {
      "language": "en",
      "mode": "search",
      "type": "all"
    },
    "tabs": [
      {
        "name": "AI Mode",
        "link": "https://www.google.com/search?sca_esv=5f09d3ac69940124&lns_surface=26&biw=1051&bih=903&hl=en&gl=US&udm=50&vsrid=CKyfsYXfqLqsXBACGAEiJDY2YWJkOGFmLTNjOGQtNGQwNi1hMDdlLTU4YWRmNzhlMGI5NTIGIgJlaCgOOM7hleir95ID&vsint=CAIqDAoCCAcSAggKGAEgATojChYNAAAAPxUAAAA_HQAAgD8lAACAPzABEIAIGIAIJQAAgD8&lns_mode=un&source=lns.web.gsbubu&vsdim=1024,1024&gsessionid=X5sybacr9AH2FFW5u55jWMKsjzMaGy26mNmVV5pQr_H0M5pBEc7j0Q&lsessionid=KHO-TDOe8LGxANpz2bra8gWY4yp0Cd_aUyg0SL1ygC5KScvNoK5hgg&fbs=ADc_l-Yv0YTTwuvIVYRVntg99Yl4C2siJayzZyC50sFnWwRH6ow_bxUxJgqfeyXucYwXL8BodgQvcQKf4r6af6eJrUBEJPcPla2xArZ4O2zHdIqqQ1YVgeUF-eZ8YfKEFkJDuGVjK7bY&q=&aep=1&ntc=1&sa=X&ved=2ahUKEwiu8dLoq_eSAxU_0AIHHdfmKpcQ2J8OegQIDxAD"
      },
      {
        "name": "All",
        "type": "all",
        "selected": true
      },
      {
        "name": "Exact matches",
        "type": "exact_matches",
        "link": "https://www.google.com/search?sca_esv=5f09d3ac69940124&lns_surface=26&biw=1051&bih=903&hl=en&gl=US&udm=48&vsrid=CKyfsYXfqLqsXBACGAEiJDY2YWJkOGFmLTNjOGQtNGQwNi1hMDdlLTU4YWRmNzhlMGI5NTIGIgJlaCgOOM7hleir95ID&vsint=CAIqDAoCCAcSAggKGAEgATojChYNAAAAPxUAAAA_HQAAgD8lAACAPzABEIAIGIAIJQAAgD8&lns_mode=un&source=lns.web.gsbubu&vsdim=1024,1024&gsessionid=X5sybacr9AH2FFW5u55jWMKsjzMaGy26mNmVV5pQr_H0M5pBEc7j0Q&lsessionid=KHO-TDOe8LGxANpz2bra8gWY4yp0Cd_aUyg0SL1ygC5KScvNoK5hgg&vsrid=CKyfsYXfqLqsXBACGAEiJGRjZWVkMGFmLTg2ZDAtNDA5MS04YTg0LWI1OWU2Y2Q2ZWNlOTIGIgJlaCgOOM7hleir95IDUAA&q=&sa=X&ved=2ahUKEwiu8dLoq_eSAxU_0AIHHdfmKpcQs6gLegQIEhAB"
      },
      {
        "name": "Visual matches",
        "type": "visual_matches",
        "link": "https://www.google.com/search?sca_esv=5f09d3ac69940124&lns_surface=26&biw=1051&bih=903&hl=en&gl=US&udm=44&vsrid=CKyfsYXfqLqsXBACGAEiJDY2YWJkOGFmLTNjOGQtNGQwNi1hMDdlLTU4YWRmNzhlMGI5NTIGIgJlaCgOOM7hleir95ID&vsint=CAIqDAoCCAcSAggKGAEgATojChYNAAAAPxUAAAA_HQAAgD8lAACAPzABEIAIGIAIJQAAgD8&lns_mode=un&source=lns.web.gsbubu&vsdim=1024,1024&gsessionid=X5sybacr9AH2FFW5u55jWMKsjzMaGy26mNmVV5pQr_H0M5pBEc7j0Q&lsessionid=KHO-TDOe8LGxANpz2bra8gWY4yp0Cd_aUyg0SL1ygC5KScvNoK5hgg&q=&sa=X&ved=2ahUKEwiu8dLoq_eSAxU_0AIHHdfmKpcQs6gLegQIEBAB"
      },
      {
        "name": "About this image",
        "type": "about",
        "link": "https://www.google.com/search/about-this-image?img=H4sIAAAAAAAAAFPy5HLnWDN_Y-v9FbvWxAgwSTAqqZiZJSalWCSm6RonW6TomqQYmOkmGpin6ppaJKakmVukGiRZmhqxKTGlZmjwWZx7OPXF6u-TmAMYANX5B_RLAAAA&sa=X&ved=2ahUKEwiu8dLoq_eSAxU_0AIHHdfmKpcQs6gLegQIERAB"
      }
    ],
    "images": [
      {
        "title": "Youtube Live Streaming – Varvid",
        "link": "https://varvid.com/broadcast-platforms/youtube/",
        "logo": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAACAAAA...",
        "source": "varvid.com",
        "image": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAZ8AAA...",
        "image_base64": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAZ8AAA...",
        "rank": 1,
        "global_rank": 1
      },
      {
        "title": "YouTube - App on Amazon Appstore",
        "link": "https://www.amazon.com/Google-LLC-YouTube/dp/B07T771SPH",
        "logo": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAACAAAA...",
        "source": "Amazon.com",
        "image": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAOEAAA...",
        "image_base64": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAOEAAA...",
        "rank": 2,
        "global_rank": 2
      },
      {
        "title": "How to Turn Off YouTube Shorts Remixing [Tutorial] - YouTube",
        "link": "https://www.youtube.com/watch?v=cRHC1EFtsk0",
        "logo": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAACAAAA...",
        "source": "YouTube",
        "image": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAQMAAA...",
        "image_base64": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAQMAAA...",
        "rank": 3,
        "global_rank": 3
      },
      {
        "title": "YouTube (YouTube channel) - Wikipedia",
        "link": "https://en.wikipedia.org/wiki/YouTube_(YouTube_channel)",
        "logo": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAACAAAA...",
        "source": "Wikipedia",
        "image": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAOEAAA...",
        "image_base64": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAOEAAA...",
        "rank": 4,
        "global_rank": 4
      },
      {
        "title": "YouTube Shuts Down Original Content Group : r/television",
        "link": "https://www.reddit.com/r/television/comments/s73vjv/youtube_shuts_down_original_content_group/",
        "logo": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAACAAAA...",
        "source": "Reddit",
        "image": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAASsAAA...",
        "image_base64": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAASsAAA...",
        "rank": 5,
        "global_rank": 5
      },
      {
        "title": "How to Upload a Video to YouTube From iPhone or Android",
        "link": "https://www.howtogeek.com/744825/how-to-upload-a-video-to-youtube-from-iphone-or-android/",
        "logo": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAACAAAA...",
        "source": "How-To Geek",
        "image": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQABAAD/2w...",
        "image_base64": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQABAAD/2w...",
        "rank": 6,
        "global_rank": 6
      },
      {
        "title": "Worship – New Horizons Christian Church",
        "link": "https://newhorizonschristianchurch.com/worship/",
        "logo": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAACAAAA...",
        "source": "New Horizons Christian Church",
        "image": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAcAAAA...",
        "image_base64": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAcAAAA...",
        "rank": 7,
        "global_rank": 7
      },
      {
        "title": "File:YouTube logo upside down.jpg - Wikipedia",
        "link": "https://en.wikipedia.org/wiki/File:YouTube_logo_upside_down.jpg",
        "logo": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAACAAAA...",
        "source": "Wikipedia",
        "image": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQABAAD/2w...",
        "image_base64": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQABAAD/2w...",
        "rank": 8,
        "global_rank": 8
      },
      {
        "title": "YouTube has new features to try. Here's how to use them - CNET",
        "link": "https://www.cnet.com/tech/services-and-software/youtube-has-new-features-to-try-how-to-use-them/",
        "logo": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAACAAAA...",
        "source": "CNET",
        "image": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQABAAD/2w...",
        "image_base64": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQABAAD/2w...",
        "rank": 9,
        "global_rank": 9
      },
      {
        "title": "Shannon Ong - Product Lead at YouTube (Google) | Ex-Amazon ...",
        "link": "https://www.linkedin.com/in/shannon-ong-44887053",
        "logo": "https://encrypted-tbn3.gstatic.com/favicon-tbn?q=tbn:ANd9GcTFMvFisG5Yfyq07VS0hk1otTr6uQvufSrlgYLzmBkZlxd7MQh66ZmKRUOdwfXrertN7RslYSLWGQCDyxLn3JsHLob5z5LPzTRUUQlVmSHaBnVJlJa8",
        "source": "LinkedIn",
        "image": "https://encrypted-tbn3.gstatic.com/images?q=tbn:ANd9GcSHV_Rg6Zrd0YDIQ2z9jIc_bujs7QKmKxjUMoDk6jXc_c9S5XVv",
        "image_url": "https://encrypted-tbn3.gstatic.com/images?q=tbn:ANd9GcSHV_Rg6Zrd0YDIQ2z9jIc_bujs7QKmKxjUMoDk6jXc_c9S5XVv",
        "rank": 10,
        "global_rank": 10
      },
      {
        "title": "YouTube is getting a dynamic new look, no matter where you ...",
        "link": "https://www.androidpolice.com/youtube-new-look-new-features-web-mobile-tvs/",
        "logo": "https://encrypted-tbn1.gstatic.com/favicon-tbn?q=tbn:ANd9GcRh-53vY1i8heyMuwxhs4Rh2bAOMAEhKGRMSyNqK3XnCg8XxR6fsmw51vJ1BdWTmU0zdaBZKX0INk_QSxu8WtbQpVSnvw7AvcHACAbySI8alifLtpZD7BW9J6s",
        "source": "Android Police",
        "image": "https://encrypted-tbn3.gstatic.com/images?q=tbn:ANd9GcSN6xABbWVsaoYSrrb3HJASKCExp3mmdNc7_Gf22OtW4h_5_9DQ",
        "image_url": "https://encrypted-tbn3.gstatic.com/images?q=tbn:ANd9GcSN6xABbWVsaoYSrrb3HJASKCExp3mmdNc7_Gf22OtW4h_5_9DQ",
        "rank": 11,
        "global_rank": 11
      },
      {
        "title": "really hard question here: whats even the purpose of this ad ...",
        "link": "https://www.reddit.com/r/youtube/comments/1pxov43/really_hard_question_here_whats_even_the_purpose/",
        "logo": "https://encrypted-tbn2.gstatic.com/favicon-tbn?q=tbn:ANd9GcRFeJS-IhfJCysoVmCqJ1d-1lzbIHTsbcy4DrBsZJpxQ31zznhym7THnNEKCEnngpvdl4aupEFtEblIPBEMJY7_biy055d40m6TYfVg7CpFOrWOXw",
        "source": "Reddit",
        "image": "https://encrypted-tbn1.gstatic.com/images?q=tbn:ANd9GcQjQaN7z_b3AiHrbsF4XB6ToTBej8slFG0IIzUuIqFHfjKAys53",
        "image_url": "https://encrypted-tbn1.gstatic.com/images?q=tbn:ANd9GcQjQaN7z_b3AiHrbsF4XB6ToTBej8slFG0IIzUuIqFHfjKAys53",
        "rank": 12,
        "global_rank": 12
      },
      {
        "title": "An unknown YouTube channel just broke all records… kind of ...",
        "link": "https://www.instagram.com/p/DTcrRD8DUUl/",
        "logo": "https://encrypted-tbn3.gstatic.com/favicon-tbn?q=tbn:ANd9GcSpoKX-MM8KwYvjLm-JRx4G0Kwl8RLkE48NjkNQo2Gq3SC32GSp-nb0Bv1Gwdg0bIZuT7qIQcsQnlAbeKhfDsUARVp1OzzHay_AKGuFGTR9Of3S2pacaw",
        "source": "Instagram",
        "image": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcR-A9yKAxNvhWfCefDoHRIKNCAL4C3rqCrAG7tRnddJa3G5J1TQ",
        "image_url": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcR-A9yKAxNvhWfCefDoHRIKNCAL4C3rqCrAG7tRnddJa3G5J1TQ",
        "rank": 13,
        "global_rank": 13
      },
      {
        "title": "Get YouTube Premium - YouTube",
        "link": "https://www.youtube.com/premium",
        "logo": "https://encrypted-tbn0.gstatic.com/favicon-tbn?q=tbn:ANd9GcQHQslzHLLyLc_qne5jxn7JocidlmUPyegZ8ojX3WVlorFk8BxW9a3vJWjDzN99UHVTqSaNBj_-6XykhxuVQfF3Ye7xScSWSuc2QHXi0a12CkVwBmo",
        "source": "YouTube",
        "image": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcRoA3XLRLlSu7GDeIM4mOo8n2IsC2MMXJTUWuPEhLl8-H8UQjAV",
        "image_url": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcRoA3XLRLlSu7GDeIM4mOo8n2IsC2MMXJTUWuPEhLl8-H8UQjAV",
        "rank": 14,
        "global_rank": 14
      },
      {
        "title": "YouTube debuts new Recap feature. Here's how to get your ...",
        "link": "https://www.independent.co.uk/arts-entertainment/music/news/youtube-recap-2025-music-video-wrapped-how-to-get-b2877770.html",
        "logo": "https://encrypted-tbn2.gstatic.com/favicon-tbn?q=tbn:ANd9GcSrV5qFXK4MrrpmF-qGRuGZ3XvO58kiXpkOWX91Kx8-eTpm--qUCQciIk1KfIFiK7-tBEP0myCykgJYy4NHLoay0SMKqJd_ci1MQXzy391HtuxldxaIDbUucMM",
        "source": "The Independent",
        "image": "https://encrypted-tbn2.gstatic.com/images?q=tbn:ANd9GcTuzg2v7alS0tL2thS_clhgpAbur9kGjuALPI12kLuwKXZiu9at",
        "image_url": "https://encrypted-tbn2.gstatic.com/images?q=tbn:ANd9GcTuzg2v7alS0tL2thS_clhgpAbur9kGjuALPI12kLuwKXZiu9at",
        "rank": 15,
        "global_rank": 15
      },
      {
        "title": "Video — Paul Lincoln",
        "link": "http://www.paullincoln.com/media-2",
        "logo": "https://encrypted-tbn1.gstatic.com/favicon-tbn?q=tbn:ANd9GcR-7rvA3OHfu4y9znRDkYgG7MqdqU9M_63edTViGISPZfmcm4O5VHSj1fgqQaZhVc97bITyZ4ipdRQsSwDz9CXyGSmbU5bwbTAtn4uoZeT55MUe9P61fVQ",
        "source": "paullincoln.com",
        "image": "https://encrypted-tbn2.gstatic.com/images?q=tbn:ANd9GcT09i7ZbByzqgW95PWzZyFcVp4mWoEZcKolsA6nd0lmJES3epCe",
        "image_url": "https://encrypted-tbn2.gstatic.com/images?q=tbn:ANd9GcT09i7ZbByzqgW95PWzZyFcVp4mWoEZcKolsA6nd0lmJES3epCe",
        "rank": 16,
        "global_rank": 16
      },
      {
        "title": "What is YouTube?",
        "link": "https://www.webwise.ie/parents/what-is-youtube/",
        "logo": "https://encrypted-tbn2.gstatic.com/favicon-tbn?q=tbn:ANd9GcSbLBrYqX4Z0t1sT5T5OU0dU6Fvo9atHPiaH8iMCrSjf5T6HovbHsmdOsi0EyUarD3VOBf91gWcD9zD6UooW24U6P9v-9hAL7DI5HNE9UQ5lM_Xvw",
        "source": "Webwise",
        "image": "https://encrypted-tbn3.gstatic.com/images?q=tbn:ANd9GcQwO8Vfju8uGEWjkvVBJbZ-TFwjll0_nwfouGH5ZX0GP62kXokW",
        "image_url": "https://encrypted-tbn3.gstatic.com/images?q=tbn:ANd9GcQwO8Vfju8uGEWjkvVBJbZ-TFwjll0_nwfouGH5ZX0GP62kXokW",
        "rank": 17,
        "global_rank": 17
      },
      {
        "title": "YouTube Recap 2025 now available. How users can see their recap",
        "link": "https://www.rgj.com/story/life/2025/12/05/youtube-wrapped-2025-now-available-for-nevadans/87628967007/",
        "logo": "https://encrypted-tbn2.gstatic.com/favicon-tbn?q=tbn:ANd9GcQkBRB-B1bhwblr3JZ2n5B-bzIRXa5zL8IeBYmMtvs34T7OWwzAwMnFTasLSxYfqOr82Qi-hJMikzLPqOL4TMHp4APbkxL5s_Y2Vuz9hYxt2Q",
        "source": "Reno Gazette Journal",
        "image": "https://encrypted-tbn1.gstatic.com/images?q=tbn:ANd9GcSNWx8A2aLUw2Fxug1gCZyFLvZ4Y7aKVraBvUsGh4CACU8aGzpV",
        "image_url": "https://encrypted-tbn1.gstatic.com/images?q=tbn:ANd9GcSNWx8A2aLUw2Fxug1gCZyFLvZ4Y7aKVraBvUsGh4CACU8aGzpV",
        "rank": 18,
        "global_rank": 18
      },
      {
        "title": "Top 10 most-watched videos on YouTube globally as of 2024",
        "link": "https://indianexpress.com/article/trending/top-10-listing/top-10-most-watched-videos-on-youtube-globally-as-of-2024-9644368/",
        "logo": "https://encrypted-tbn0.gstatic.com/favicon-tbn?q=tbn:ANd9GcREHhA82Fap_IO3U-7dlibrn8yJlsi0qT2kUdbck1KimPVEHNIsCtGxstAKlPt07s9RhkEkAIgCRXi9RFzfFCaR0Y8p_z22jf2uaKW4DCqIgJOO0GBmOA",
        "source": "The Indian Express",
        "image": "https://encrypted-tbn2.gstatic.com/images?q=tbn:ANd9GcT8p0DDTwJ21nLYDW12Vmj8DsHfuIxqF5R7sZDvK_cUKPazOEQT",
        "image_url": "https://encrypted-tbn2.gstatic.com/images?q=tbn:ANd9GcT8p0DDTwJ21nLYDW12Vmj8DsHfuIxqF5R7sZDvK_cUKPazOEQT",
        "rank": 19,
        "global_rank": 19
      },
      {
        "title": "YouTube secretly tested AI video enhancement without ...",
        "link": "https://arstechnica.com/google/2025/08/youtube-secretly-tested-ai-video-enhancement-without-notifying-creators/",
        "logo": "https://encrypted-tbn2.gstatic.com/favicon-tbn?q=tbn:ANd9GcQoMdSJ0j3GUYtZdhvAzdB08yh2z11ylT-saWok78BDvRQ-2lYkLNBMp7mID2z5fLuG1RmEM90UiyubJEejEhO0VIEZXzsojyonbUtnqqZ9Q2NvyIk",
        "source": "Ars Technica",
        "image": "https://encrypted-tbn3.gstatic.com/images?q=tbn:ANd9GcSl2yITQzATmYhGq-fB7XwmSF01zPiThjHEJQrZtJKQGxIEFP-l",
        "image_url": "https://encrypted-tbn3.gstatic.com/images?q=tbn:ANd9GcSl2yITQzATmYhGq-fB7XwmSF01zPiThjHEJQrZtJKQGxIEFP-l",
        "rank": 20,
        "global_rank": 20
      },
      {
        "title": "Videos - Springdale FWB - Springdale Free Will Baptist Church",
        "link": "https://www.springdalefwb.org/videos.html",
        "logo": "https://encrypted-tbn1.gstatic.com/favicon-tbn?q=tbn:ANd9GcRqfiy0VdOS4lUakqCu5N8oAxk1lHi2UaYOIXQHAKeXimo0wfiqsUhsC8W74MzgM1uVP4A1OfEYMAxluM5HZzWfyPpD_RblP2GNnRHVxUFnREbuqPZT2UY4gw4",
        "source": "Springdale Free Will Baptist Church",
        "image": "https://encrypted-tbn2.gstatic.com/images?q=tbn:ANd9GcQnoUBdcMizJv-JxXxIQAVVUTuZKps3gGr-K2riQiHI58po0zMW",
        "image_url": "https://encrypted-tbn2.gstatic.com/images?q=tbn:ANd9GcQnoUBdcMizJv-JxXxIQAVVUTuZKps3gGr-K2riQiHI58po0zMW",
        "rank": 21,
        "global_rank": 21
      },
      {
        "title": "Anyone older than YouTube is officially old enough to drink ...",
        "link": "https://www.reddit.com/r/BarbaraWalters4Scale/comments/1r4ejjo/anyone_older_than_youtube_is_officially_old/",
        "logo": "https://encrypted-tbn2.gstatic.com/favicon-tbn?q=tbn:ANd9GcRFeJS-IhfJCysoVmCqJ1d-1lzbIHTsbcy4DrBsZJpxQ31zznhym7THnNEKCEnngpvdl4aupEFtEblIPBEMJY7_biy055d40m6TYfVg7CpFOrWOXw",
        "source": "Reddit",
        "image": "https://encrypted-tbn2.gstatic.com/images?q=tbn:ANd9GcS8t9_wIn62SKBGmnoLU0RvrOhQ9CoGqM3t2yjRkvStTp14An5n",
        "image_url": "https://encrypted-tbn2.gstatic.com/images?q=tbn:ANd9GcS8t9_wIn62SKBGmnoLU0RvrOhQ9CoGqM3t2yjRkvStTp14An5n",
        "rank": 22,
        "global_rank": 22
      },
      {
        "title": "YouTube should give more prominence to public service media ...",
        "link": "https://www.bbc.co.uk/news/articles/clyl07nekzxo",
        "logo": "https://encrypted-tbn2.gstatic.com/favicon-tbn?q=tbn:ANd9GcQkfkHsgY8lS21mPHFUbDtwW6Et_KFgAwjd1eumnE7PsvEhqdw6Kv69JwDtX9AXmV8-fm6t54pB8PATe-Pzv5BHmyDELvrJFZqQ7nx8_vZwcD6x",
        "source": "BBC",
        "image": "https://encrypted-tbn1.gstatic.com/images?q=tbn:ANd9GcTCIXoliRxY3r5Vx1pd9ThbHblQxHEbzddAo4HHt2kSCUd7gsqf",
        "image_url": "https://encrypted-tbn1.gstatic.com/images?q=tbn:ANd9GcTCIXoliRxY3r5Vx1pd9ThbHblQxHEbzddAo4HHt2kSCUd7gsqf",
        "rank": 23,
        "global_rank": 23
      },
      {
        "title": "YouTube | The Verge",
        "link": "https://www.theverge.com/youtube",
        "logo": "https://encrypted-tbn2.gstatic.com/favicon-tbn?q=tbn:ANd9GcQUvjXAGG2ILQkdobGNlrkN845RoDIT9G4L-sPBcsw7sdEAQIF2bqZftAiLLpBKccaBBAjaSpfW9ouqLNlezyTrUZXWckKVGEY4FwEpL2uaLSkcp1gZ",
        "source": "The Verge",
        "image": "https://encrypted-tbn3.gstatic.com/images?q=tbn:ANd9GcQTN14quh9Stlf80QyS_Hu3gvWmTirVetvyHyozGMqJsSmd-QWx",
        "image_url": "https://encrypted-tbn3.gstatic.com/images?q=tbn:ANd9GcQTN14quh9Stlf80QyS_Hu3gvWmTirVetvyHyozGMqJsSmd-QWx",
        "rank": 24,
        "global_rank": 24
      },
      {
        "title": "Yt randomly stopped working yesterday - YouTube",
        "link": "https://www.youtube.com/watch?v=SYWjR4Ie9H4",
        "logo": "https://encrypted-tbn0.gstatic.com/favicon-tbn?q=tbn:ANd9GcQHQslzHLLyLc_qne5jxn7JocidlmUPyegZ8ojX3WVlorFk8BxW9a3vJWjDzN99UHVTqSaNBj_-6XykhxuVQfF3Ye7xScSWSuc2QHXi0a12CkVwBmo",
        "source": "YouTube",
        "image": "https://encrypted-tbn3.gstatic.com/images?q=tbn:ANd9GcQc_5D9QjSgCLNacTmdhIf96JsDys4r2sKAXqaKXihgWf0K-S-C",
        "image_url": "https://encrypted-tbn3.gstatic.com/images?q=tbn:ANd9GcQc_5D9QjSgCLNacTmdhIf96JsDys4r2sKAXqaKXihgWf0K-S-C",
        "rank": 25,
        "global_rank": 25
      },
      {
        "title": "Sorry Search, YouTube Is More Important to Google Than Ever ...",
        "link": "https://www.wired.com/2015/10/sorry-search-youtube-is-more-important-to-google-than-ever/",
        "logo": "https://encrypted-tbn0.gstatic.com/favicon-tbn?q=tbn:ANd9GcThlD2e1C2_v--cgb8ALlm86tHfzrbkhTDvq9HqJqt0GoealFINHn1O1SnJiZeCJz_iJdliO5UpQz_2yc4oIqE_wZwQYOWkpR7S4fJyBLlWCG9w",
        "source": "WIRED",
        "image": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcTXLdsL_7M3gvVqAYuTTqVg-ckcsaFhdg9LEPdn_s-bZ7JJ4JSt",
        "image_url": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcTXLdsL_7M3gvVqAYuTTqVg-ckcsaFhdg9LEPdn_s-bZ7JJ4JSt",
        "rank": 26,
        "global_rank": 26
      },
      {
        "title": "Watching YouTube Videos in Whonix",
        "link": "https://www.whonix.org/wiki/YouTube",
        "logo": "https://encrypted-tbn1.gstatic.com/favicon-tbn?q=tbn:ANd9GcR7RCT4r1ULdXFpOWV7360X_4uHe_tgQD8LjRH_CH1PdrUaVhIVyar26V_7gxFFa3iH8Oy21z9GPKAYnBLMmPWgbGAmEwYkn8RSAqv6Zzv0OcuUFQ",
        "source": "Whonix",
        "image": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcRXYvXSyyCilfbT9uHBSCn_f8N0EHl1BJIvVnTlaimF1YfRaHUK",
        "image_url": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcRXYvXSyyCilfbT9uHBSCn_f8N0EHl1BJIvVnTlaimF1YfRaHUK",
        "rank": 27,
        "global_rank": 27
      },
      {
        "title": "YouTube Music Review | PCMag",
        "link": "https://www.pcmag.com/reviews/youtube-music",
        "logo": "https://encrypted-tbn2.gstatic.com/favicon-tbn?q=tbn:ANd9GcQT2SxtS9PqiMpEW2DDJLdjuVqHzsB-BQ_R7sUFdvjuE3SMmj4UDrJTT0vpXgXFeSKQtj3idX4xCu9G5dm0yLJ9c45ktlpBDPBKR2kVTtday3EF",
        "source": "PCMag",
        "image": "https://encrypted-tbn2.gstatic.com/images?q=tbn:ANd9GcRuf5sF-d6UFF8UNcLGO-duPlx_Ir1i4MoSICNnH8NU08ifkakF",
        "image_url": "https://encrypted-tbn2.gstatic.com/images?q=tbn:ANd9GcRuf5sF-d6UFF8UNcLGO-duPlx_Ir1i4MoSICNnH8NU08ifkakF",
        "rank": 28,
        "global_rank": 28
      },
      {
        "title": "5 facts about Americans and YouTube | Pew Research Center",
        "link": "https://www.pewresearch.org/short-reads/2025/02/28/5-facts-about-americans-and-youtube/",
        "logo": "https://encrypted-tbn0.gstatic.com/favicon-tbn?q=tbn:ANd9GcR17CLniZiP5RD4SSFBbTXMqovUhHiNZ6yCLWZRWhSdopCIttlaz9BdH7uaz3dkB5DNfwoRw2bfkueSYNMVp9gc7dN9ER0CA0x59pXXqIG1tptNBNM52iPO",
        "source": "Pew Research Center",
        "image": "https://encrypted-tbn1.gstatic.com/images?q=tbn:ANd9GcT6PQoNDFTvRBZ0WDSLnorgHo35ZVej0QjPZ78OOGTTE0F0I0mt",
        "image_url": "https://encrypted-tbn1.gstatic.com/images?q=tbn:ANd9GcT6PQoNDFTvRBZ0WDSLnorgHo35ZVej0QjPZ78OOGTTE0F0I0mt",
        "rank": 29,
        "global_rank": 29
      },
      {
        "title": "10 Reasons to Start a YouTube Channel Today | TubeBuddy",
        "link": "https://www.tubebuddy.com/blog/10-reasons-start-youtube-channel/",
        "logo": "https://encrypted-tbn3.gstatic.com/favicon-tbn?q=tbn:ANd9GcQBpw2mbW8vadl8QZpNXIHukGlh5Coavo8CfqmCVM0SS02q94VLSJJLzwjVhOCQSIFe7Hrul3Ykzz-aqn1btCE8KE1zDbk1srhzknIFUWmi3v9eDwTBLw",
        "source": "TubeBuddy",
        "image": "https://encrypted-tbn3.gstatic.com/images?q=tbn:ANd9GcSBPIH0c-fIrX1ZpB-T3QK8ydY6_Kn5Y2_L9ZzfwZNcuJlmJVz7",
        "image_url": "https://encrypted-tbn3.gstatic.com/images?q=tbn:ANd9GcSBPIH0c-fIrX1ZpB-T3QK8ydY6_Kn5Y2_L9ZzfwZNcuJlmJVz7",
        "rank": 30,
        "global_rank": 30
      },
      {
        "title": "How Can I Watch Videos on YouTube?",
        "link": "https://www.ncoa.org/article/how-to-find-and-watch-videos-on-youtube-a-tutorial/",
        "logo": "https://encrypted-tbn3.gstatic.com/favicon-tbn?q=tbn:ANd9GcQus8nqyjv6rmz1FLbKGZwnxSd9hg2_yL96BFiHAN5QTJwn-zY4BSa6vY_ZLuZfuYPBbNQe3YDy_mTjL8MRVHMK4-T4re0IpNTONmS2C4dVF44",
        "source": "The National Council on Aging (NCOA)",
        "image": "https://encrypted-tbn1.gstatic.com/images?q=tbn:ANd9GcR-23W6IbOhj49W3-iVbuNP5cdswORmNoZkpGYmYJSrHXpeXZbp",
        "image_url": "https://encrypted-tbn1.gstatic.com/images?q=tbn:ANd9GcR-23W6IbOhj49W3-iVbuNP5cdswORmNoZkpGYmYJSrHXpeXZbp",
        "rank": 31,
        "global_rank": 31
      },
      {
        "title": "YouTube Is Getting Two New Smart Features",
        "link": "https://www.howtogeek.com/youtube-is-getting-two-new-smart-features/",
        "logo": "https://encrypted-tbn0.gstatic.com/favicon-tbn?q=tbn:ANd9GcQi7d7OE3tYYpQ0K0N2YmwhwaeJDpQia9z8E5mUUGmYuXveM7Jc79TKGAwew0HGVw8nR3bhm6JDzDYTfw9UOl8rmynEx6jiQgFI18MGyTgd52tKjiLMwQ",
        "source": "How-To Geek",
        "image": "https://encrypted-tbn3.gstatic.com/images?q=tbn:ANd9GcQjsUXO2w4xeQxrjXEq137RF1UCZAmNj-EvtP0ZBa-_fNtTmPav",
        "image_url": "https://encrypted-tbn3.gstatic.com/images?q=tbn:ANd9GcQjsUXO2w4xeQxrjXEq137RF1UCZAmNj-EvtP0ZBa-_fNtTmPav",
        "rank": 32,
        "global_rank": 32
      },
      {
        "title": "AI Overviews Are Coming To YouTube In New Test",
        "link": "https://www.tulsamarketingonline.com/ai-overviews-are-coming-to-youtube-in-new-test/",
        "logo": "https://encrypted-tbn0.gstatic.com/favicon-tbn?q=tbn:ANd9GcQdlX-huMkuAXP9QrJWUVbCax_aXdhGZO9qhv8aeHvTCCjnHzWOfuNp56fCD5n-lQFo2UOXmqvBrWv1EP-Y3kRZL70kqvASoG3GGaVXHP1FDF_9UrN2663TziCS-bzqD4Hw",
        "source": "Tulsa Marketing Online",
        "image": "https://encrypted-tbn1.gstatic.com/images?q=tbn:ANd9GcSrAt7rOPRTZ3ARkL-YGWskDIZZrBNHNFU8hu07vmAdCxPSDyOH",
        "image_url": "https://encrypted-tbn1.gstatic.com/images?q=tbn:ANd9GcSrAt7rOPRTZ3ARkL-YGWskDIZZrBNHNFU8hu07vmAdCxPSDyOH",
        "rank": 33,
        "global_rank": 33
      },
      {
        "title": "Reports that YouTube is d0wn for many users 🚨",
        "link": "https://www.instagram.com/p/DU4h9Wlj3Tr/",
        "logo": "https://encrypted-tbn3.gstatic.com/favicon-tbn?q=tbn:ANd9GcSpoKX-MM8KwYvjLm-JRx4G0Kwl8RLkE48NjkNQo2Gq3SC32GSp-nb0Bv1Gwdg0bIZuT7qIQcsQnlAbeKhfDsUARVp1OzzHay_AKGuFGTR9Of3S2pacaw",
        "source": "Instagram",
        "image": "https://encrypted-tbn1.gstatic.com/images?q=tbn:ANd9GcSQDo_DFR_HJoAMOXQ1BQc5evDdbjSlU2h2IZXlnuK1xGoIg2AR",
        "image_url": "https://encrypted-tbn1.gstatic.com/images?q=tbn:ANd9GcSQDo_DFR_HJoAMOXQ1BQc5evDdbjSlU2h2IZXlnuK1xGoIg2AR",
        "rank": 34,
        "global_rank": 34
      },
      {
        "title": "Council Meeting Videos | City of Oconomowoc, WI - Official ...",
        "link": "https://www.oconomowoc-wi.gov/769/Council-Meeting-Videos-on-YouTube",
        "logo": "https://encrypted-tbn3.gstatic.com/favicon-tbn?q=tbn:ANd9GcQTyr2X3_sexqjYHbmBx8BOfYR2NdvXo7-7f_aOtDoQqtUeIhYdRlCTaktRxMJqisDnx5bKSz--9AFYPlCBMyEtRQwVFaVo85gmzwH-C_YqrqE2qay2p3PyKYw",
        "source": "City of Oconomowoc, WI (.gov)",
        "image": "https://encrypted-tbn3.gstatic.com/images?q=tbn:ANd9GcRdPwT4HJnPOPNlvcKaANyl-0YrnwPHxnAmbKyRdYM5SIE35CD3",
        "image_url": "https://encrypted-tbn3.gstatic.com/images?q=tbn:ANd9GcRdPwT4HJnPOPNlvcKaANyl-0YrnwPHxnAmbKyRdYM5SIE35CD3",
        "rank": 35,
        "global_rank": 35
      },
      {
        "title": "YouTube Has a New Way to Share Channels",
        "link": "https://www.howtogeek.com/youtube-channels-qr-codes/",
        "logo": "https://encrypted-tbn0.gstatic.com/favicon-tbn?q=tbn:ANd9GcQi7d7OE3tYYpQ0K0N2YmwhwaeJDpQia9z8E5mUUGmYuXveM7Jc79TKGAwew0HGVw8nR3bhm6JDzDYTfw9UOl8rmynEx6jiQgFI18MGyTgd52tKjiLMwQ",
        "source": "How-To Geek",
        "image": "https://encrypted-tbn1.gstatic.com/images?q=tbn:ANd9GcQZge9V5uwknS8grLnlN9-MjxTo_CzGn4MBqlS2DL32NmfuEOdk",
        "image_url": "https://encrypted-tbn1.gstatic.com/images?q=tbn:ANd9GcQZge9V5uwknS8grLnlN9-MjxTo_CzGn4MBqlS2DL32NmfuEOdk",
        "rank": 36,
        "global_rank": 36
      },
      {
        "title": "Popaganda Podcast",
        "link": "https://www.popagandapod.com/season1",
        "logo": "https://encrypted-tbn0.gstatic.com/favicon-tbn?q=tbn:ANd9GcSxbqFeVrr2di3ffaWz_O8ivKYW7tRtmi51RAq8MylGvGAQHmV9lqUDOdmE8rMpy9s63aeBGIzHjho53xhXkEkOIxVNl6MrlEqQ859957BgADrGHPH31PUP5g",
        "source": "Popaganda Podcast",
        "image": "https://encrypted-tbn3.gstatic.com/images?q=tbn:ANd9GcQti39Qu5s92QMRuS63qsnoyO5JlBmIu84Q0GtL1b0Sc1XG0O0s",
        "image_url": "https://encrypted-tbn3.gstatic.com/images?q=tbn:ANd9GcQti39Qu5s92QMRuS63qsnoyO5JlBmIu84Q0GtL1b0Sc1XG0O0s",
        "rank": 37,
        "global_rank": 37
      },
      {
        "title": "YouTube Music - YouTube",
        "link": "https://www.youtube.com/channel/UCStaiwu-FAgp_RC_tBiLh9A",
        "logo": "https://encrypted-tbn0.gstatic.com/favicon-tbn?q=tbn:ANd9GcQHQslzHLLyLc_qne5jxn7JocidlmUPyegZ8ojX3WVlorFk8BxW9a3vJWjDzN99UHVTqSaNBj_-6XykhxuVQfF3Ye7xScSWSuc2QHXi0a12CkVwBmo",
        "source": "YouTube",
        "image": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcTE12NwfEIz3s1Scc9ug0S0sWhuK0DDv5kBgBbvJc5phh3nDliM",
        "image_url": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcTE12NwfEIz3s1Scc9ug0S0sWhuK0DDv5kBgBbvJc5phh3nDliM",
        "rank": 38,
        "global_rank": 38
      },
      {
        "title": "How To Upload To YouTube [Guide] - YouTube",
        "link": "https://www.youtube.com/watch?v=s-KZu1kru8Y",
        "logo": "https://encrypted-tbn0.gstatic.com/favicon-tbn?q=tbn:ANd9GcQHQslzHLLyLc_qne5jxn7JocidlmUPyegZ8ojX3WVlorFk8BxW9a3vJWjDzN99UHVTqSaNBj_-6XykhxuVQfF3Ye7xScSWSuc2QHXi0a12CkVwBmo",
        "source": "YouTube",
        "image": "https://encrypted-tbn1.gstatic.com/images?q=tbn:ANd9GcTmetLJpEeBZIkBH8iY9Hl9Zmg6FyRiNKggrlH2TYUydoK_WFTm",
        "image_url": "https://encrypted-tbn1.gstatic.com/images?q=tbn:ANd9GcTmetLJpEeBZIkBH8iY9Hl9Zmg6FyRiNKggrlH2TYUydoK_WFTm",
        "rank": 39,
        "global_rank": 39
      },
      {
        "title": "Where is Your YouTube History? - YouTube",
        "link": "https://www.youtube.com/watch?v=hcnkv0y-0WM",
        "logo": "https://encrypted-tbn0.gstatic.com/favicon-tbn?q=tbn:ANd9GcQHQslzHLLyLc_qne5jxn7JocidlmUPyegZ8ojX3WVlorFk8BxW9a3vJWjDzN99UHVTqSaNBj_-6XykhxuVQfF3Ye7xScSWSuc2QHXi0a12CkVwBmo",
        "source": "YouTube",
        "image": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcR3b0891aPxG36yA2V8x8ScZNv17SVWNfwTDtXyZFdmJMa4mdIu",
        "image_url": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcR3b0891aPxG36yA2V8x8ScZNv17SVWNfwTDtXyZFdmJMa4mdIu",
        "rank": 40,
        "global_rank": 40
      },
      {
        "title": "Rob Pratley",
        "link": "https://luc.devroye.org/fonts-87321.html",
        "logo": "https://encrypted-tbn1.gstatic.com/favicon-tbn?q=tbn:ANd9GcQWUq4levL2IJLit-bQYDm4o9U35ZP1zDILK4M6PZ6IXNLyCCfM8mN-Dbup_Cpy009Pdqs1OO4W0vRc2OyGIu5EkE4SHxrmzXIh0JQo5KSeh2hI2HA",
        "source": "devroye.org",
        "image": "https://encrypted-tbn2.gstatic.com/images?q=tbn:ANd9GcRVwnQjv1TrJlbyTjSQfLesOC8dVjEjXQlEF08KnM-2HdN1g0po",
        "image_url": "https://encrypted-tbn2.gstatic.com/images?q=tbn:ANd9GcRVwnQjv1TrJlbyTjSQfLesOC8dVjEjXQlEF08KnM-2HdN1g0po",
        "rank": 41,
        "global_rank": 41
      },
      {
        "title": "How to Live Stream on YouTube Using Your iPhone 15, iPhone ...",
        "link": "https://www.youtube.com/watch?v=rXU3sRnDi5M",
        "logo": "https://encrypted-tbn0.gstatic.com/favicon-tbn?q=tbn:ANd9GcQHQslzHLLyLc_qne5jxn7JocidlmUPyegZ8ojX3WVlorFk8BxW9a3vJWjDzN99UHVTqSaNBj_-6XykhxuVQfF3Ye7xScSWSuc2QHXi0a12CkVwBmo",
        "source": "YouTube",
        "image": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcT2J6imTTg_XtsK2Yul9RScPHVLmB1y2NppWjMLXRW2mzJYEfsC",
        "image_url": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcT2J6imTTg_XtsK2Yul9RScPHVLmB1y2NppWjMLXRW2mzJYEfsC",
        "rank": 42,
        "global_rank": 42
      },
      {
        "title": "YouTube says that music is now 25% of its global watch time",
        "link": "https://musically.com/2021/09/16/youtube-says-that-music-is-now-25-of-its-global-watch-time/",
        "logo": "https://encrypted-tbn3.gstatic.com/favicon-tbn?q=tbn:ANd9GcSFAxZpnQqFaA4qoNqYk_NlH7wPwpNpjN3Fyh-p6wfFTc-IhE0-Ufkg2aomh1NFcGdcunSi9BYOB0RK6mkP7VVvlBlxdcQcbJILVSRsFGTY83Gj",
        "source": "Music Ally",
        "image": "https://encrypted-tbn3.gstatic.com/images?q=tbn:ANd9GcQjPmybg3_wHprlJf2gIX5GjEPxEsB51OyF42VDXiKkYjYF2oTr",
        "image_url": "https://encrypted-tbn3.gstatic.com/images?q=tbn:ANd9GcQjPmybg3_wHprlJf2gIX5GjEPxEsB51OyF42VDXiKkYjYF2oTr",
        "rank": 43,
        "global_rank": 43
      },
      {
        "title": "Livestreams and Recordings – Saint Robert's Catholic Church",
        "link": "https://saintroberts.org/livestreams-and-recordings/",
        "logo": "https://encrypted-tbn3.gstatic.com/favicon-tbn?q=tbn:ANd9GcRjhous8nGXkV0aOGtVkKN5c1hOh61JSqwS0iq3rZZWxnMc_gYOJFfkdICHl9Am33bjcVi1267LSKrraHCqHZjkiNVaDkNMLWUQ3DdvxgaI5IouOlq8",
        "source": "Saint Robert's Catholic Church",
        "image": "https://encrypted-tbn2.gstatic.com/images?q=tbn:ANd9GcQhDUhnp1HB4uSLfEsS8T6WgFzOGY6vStFEMzNyh1NVhas8Pvd3",
        "image_url": "https://encrypted-tbn2.gstatic.com/images?q=tbn:ANd9GcQhDUhnp1HB4uSLfEsS8T6WgFzOGY6vStFEMzNyh1NVhas8Pvd3",
        "rank": 44,
        "global_rank": 44
      },
      {
        "title": "YouTube is giving you better control over what videos are on ...",
        "link": "https://www.xda-developers.com/youtube-better-control-over-what-videos-are-on-your-homepage/",
        "logo": "https://encrypted-tbn1.gstatic.com/favicon-tbn?q=tbn:ANd9GcRAME90RmDvZ7n5QF-g_fXA6hrG1UpK1yFStismLE2bPsvQ8NDeM_419lGa-XTsXWEQ7-TMRilzLDBgbo39QRarJ_dIvrWYKxo3Lc1KDOvngg4HxOqxV7yDSBqR",
        "source": "XDA",
        "image": "https://encrypted-tbn3.gstatic.com/images?q=tbn:ANd9GcRQic49NGU9caQSmutaO1b9OICmJ1yA74nHS4EBDblaazX9dnyE",
        "image_url": "https://encrypted-tbn3.gstatic.com/images?q=tbn:ANd9GcRQic49NGU9caQSmutaO1b9OICmJ1yA74nHS4EBDblaazX9dnyE",
        "rank": 45,
        "global_rank": 45
      },
      {
        "title": "YouTube Set To Overtake Facebook As Second Largest Website ...",
        "link": "https://www.tubefilter.com/2018/08/08/youtube-second-largest-us-website/",
        "logo": "https://encrypted-tbn0.gstatic.com/favicon-tbn?q=tbn:ANd9GcQOnfaQAkwfbzgAhZAsN5ZEqvhBteEgAtOUgDLozCYjPpNAwfem0ykIevsPO1a2BQWF_eWOq8yhCPPs39ddN7Qnn_REbXXsh4g8Ox6A4cd2s6tzF_8vt3Y",
        "source": "Tubefilter",
        "image": "https://encrypted-tbn3.gstatic.com/images?q=tbn:ANd9GcQdG1HLsjtJ1yGqDtoqiT8_0BJBOdjgBslZdnESZl90s5Ogt1M9",
        "image_url": "https://encrypted-tbn3.gstatic.com/images?q=tbn:ANd9GcQdG1HLsjtJ1yGqDtoqiT8_0BJBOdjgBslZdnESZl90s5Ogt1M9",
        "rank": 46,
        "global_rank": 46
      },
      {
        "title": "Listen – Kicks Band of Fargo-Moorhead",
        "link": "https://fmkicksband.com/listen/",
        "logo": "https://encrypted-tbn2.gstatic.com/favicon-tbn?q=tbn:ANd9GcSXIP238x7Ns9vg5fxViRnkAHehX-cXBHAumAnxFErtlfXQpKU6hVJib-drG2IjKuQ3zFj0pmu3F_N8pdVpuCn5VuYHj67pIOKWTIo3uZnmRNt9Eag",
        "source": "Kicks Band of Fargo-Moorhead",
        "image": "https://encrypted-tbn2.gstatic.com/images?q=tbn:ANd9GcRoVsB0EGH2wECLCNA1IotQT_M1ApQTGq-53qFeSPfLlaP7dceG",
        "image_url": "https://encrypted-tbn2.gstatic.com/images?q=tbn:ANd9GcRoVsB0EGH2wECLCNA1IotQT_M1ApQTGq-53qFeSPfLlaP7dceG",
        "rank": 47,
        "global_rank": 47
      },
      {
        "title": "Church News | Grace Community Church West Allis, Wisconsin 53227",
        "link": "https://www.ourgcc.com/LiveStream",
        "logo": "https://encrypted-tbn1.gstatic.com/favicon-tbn?q=tbn:ANd9GcQjOVrgTcfOQd208wODKcdmYhpg0A4c8rI0iQOfObfVtqWQ3A82OkIxtd9eJo8DhTCB4XaOFUL34ZsE90N4upcd5sNfeR0y0DH1HagFogmWOS1Jdw",
        "source": "ourgcc.com",
        "image": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcTC3exulTpXNFqIrOs03eepYpCz8B5lco2RIq-ASaFmrLW9GiZe",
        "image_url": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcTC3exulTpXNFqIrOs03eepYpCz8B5lco2RIq-ASaFmrLW9GiZe",
        "rank": 48,
        "global_rank": 48
      },
      {
        "title": "Calvary Chapel Myrtle Beach - YouTube",
        "link": "https://www.youtube.com/c/CalvaryChapelMyrtleBeach",
        "logo": "https://encrypted-tbn0.gstatic.com/favicon-tbn?q=tbn:ANd9GcQHQslzHLLyLc_qne5jxn7JocidlmUPyegZ8ojX3WVlorFk8BxW9a3vJWjDzN99UHVTqSaNBj_-6XykhxuVQfF3Ye7xScSWSuc2QHXi0a12CkVwBmo",
        "source": "YouTube",
        "image": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcTNzpg3c-1dwwy9JkJ-8U9yJF8wTocFJoEsF19F1v5VWwUAUT_j",
        "image_url": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcTNzpg3c-1dwwy9JkJ-8U9yJF8wTocFJoEsF19F1v5VWwUAUT_j",
        "rank": 49,
        "global_rank": 49
      },
      {
        "title": "YouTube Links for Anne Z | Anne Z on the Web",
        "link": "https://annezontheweb.com/you-tube-links-anne-z-on-the-web/",
        "logo": "https://encrypted-tbn1.gstatic.com/favicon-tbn?q=tbn:ANd9GcSDIIO4W4Ama4T6lvAPC7HUk1SV3hRP_oJkukjBzEtKDA7PUJXbLEZ-Tjp-4nBHRgMn1FPzDOR62BrAex4X0BvfOfJjndvL3FjGsa2F37448wajStuF3g",
        "source": "annezontheweb.com",
        "image": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcR7QzVG2h-AGEuDvhAWzIs1oJltO_TwztlJYqfZE--A3SpDptSx",
        "image_url": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcR7QzVG2h-AGEuDvhAWzIs1oJltO_TwztlJYqfZE--A3SpDptSx",
        "rank": 50,
        "global_rank": 50
      },
      {
        "title": "Practices + Playlists — Shawn J. Moore, The Mindful Rebel®",
        "link": "https://www.shawnjmoore.com/listen",
        "logo": "https://encrypted-tbn1.gstatic.com/favicon-tbn?q=tbn:ANd9GcRtkwHR73zt_pPwLkrunvKwi5t5l12sPzyLDJiB0L5o99WE7uXv8OPet3Po9wW4dyeA0FeuNfoVOed_WWwZL9ihFpVlRie_NG1JuggWI4Xnv8U0blP_7wOD",
        "source": "shawnjmoore.com",
        "image": "https://encrypted-tbn3.gstatic.com/images?q=tbn:ANd9GcTzD6aBv7OJzyeYz2m1jZBbaEYlKxk1ScXMopYqPJcp5i55Fu15",
        "image_url": "https://encrypted-tbn3.gstatic.com/images?q=tbn:ANd9GcTzD6aBv7OJzyeYz2m1jZBbaEYlKxk1ScXMopYqPJcp5i55Fu15",
        "rank": 51,
        "global_rank": 51
      },
      {
        "title": "Simplest way to embed a Youtube video in your React app ...",
        "link": "https://dev.to/bravemaster619/simplest-way-to-embed-a-youtube-video-in-your-react-app-3bk2",
        "logo": "https://encrypted-tbn0.gstatic.com/favicon-tbn?q=tbn:ANd9GcSQRYRjo6rRDeEwOaYrr8zfImMVmlI3BXXupnqDJb9APJUNVXQUR_ECPJEd7MrgNMDi2ZkWz2U7Ukg8DNNNK2HaNLsmHqhhaPiKpi4",
        "source": "DEV Community",
        "image": "https://encrypted-tbn1.gstatic.com/images?q=tbn:ANd9GcSh5PWTqIAO1R2wHP12Nb0aflEKKY5TP5n42uX4UK7IAizpajZQ",
        "image_url": "https://encrypted-tbn1.gstatic.com/images?q=tbn:ANd9GcSh5PWTqIAO1R2wHP12Nb0aflEKKY5TP5n42uX4UK7IAizpajZQ",
        "rank": 52,
        "global_rank": 52
      },
      {
        "title": "live — Edgerton First Reformed",
        "link": "https://www.edgertonfrc.org/live",
        "logo": "https://encrypted-tbn2.gstatic.com/favicon-tbn?q=tbn:ANd9GcQX0DHkVwqsNq8LU6oTPXlV6-xin23cGL575S3bUgZ-ziBlBpRnlJZ3jTzBnHkxrc1w_hwFCKe0N3ZBwslfw9g6etfzO4wticYgPriK-2Mu0IXr_c98ZeHj",
        "source": "edgertonfrc.org",
        "image": "https://encrypted-tbn2.gstatic.com/images?q=tbn:ANd9GcSf1bfDH6bh3UdF_o7mdSZ2UoprkQF0je__l3Y6hHynVZH7gQ-O",
        "image_url": "https://encrypted-tbn2.gstatic.com/images?q=tbn:ANd9GcSf1bfDH6bh3UdF_o7mdSZ2UoprkQF0je__l3Y6hHynVZH7gQ-O",
        "rank": 53,
        "global_rank": 53
      },
      {
        "title": "YouTube's Checks to Warn Creators About Copyright Issues ...",
        "link": "https://ottverse.com/youtube-checks-warn-creators-about-copyright-issues/",
        "logo": "https://encrypted-tbn2.gstatic.com/favicon-tbn?q=tbn:ANd9GcQV3QA33hwGlp-HOrq6qCTu4V6QtzpxE8W62b4_TiSVunAN06tPoZW18UhkT5wOHmoEx5PlHrrZjin1Jl1x4ad_9aAYWSZe79fxVLSv4UJHaJ8",
        "source": "OTTVerse",
        "image": "https://encrypted-tbn2.gstatic.com/images?q=tbn:ANd9GcQ4tiYPe8b5sDGi8ePUF7WnAyOgV0ZcmTYWZBsgXYT-fq0M7m6J",
        "image_url": "https://encrypted-tbn2.gstatic.com/images?q=tbn:ANd9GcQ4tiYPe8b5sDGi8ePUF7WnAyOgV0ZcmTYWZBsgXYT-fq0M7m6J",
        "rank": 54,
        "global_rank": 54
      },
      {
        "title": "How to Sign Up for YouTube TV - YouTube",
        "link": "https://www.youtube.com/watch?v=Qw_8AEoy59o",
        "logo": "https://encrypted-tbn0.gstatic.com/favicon-tbn?q=tbn:ANd9GcQHQslzHLLyLc_qne5jxn7JocidlmUPyegZ8ojX3WVlorFk8BxW9a3vJWjDzN99UHVTqSaNBj_-6XykhxuVQfF3Ye7xScSWSuc2QHXi0a12CkVwBmo",
        "source": "YouTube",
        "image": "https://encrypted-tbn1.gstatic.com/images?q=tbn:ANd9GcSGXVl_lm2UZWqLNkC80N2ZUZlVjMaQzdQaePReyiDB3XDRdz3v",
        "image_url": "https://encrypted-tbn1.gstatic.com/images?q=tbn:ANd9GcSGXVl_lm2UZWqLNkC80N2ZUZlVjMaQzdQaePReyiDB3XDRdz3v",
        "rank": 55,
        "global_rank": 55
      },
      {
        "title": "Lincoln Community Foundation Garden Performance Series - Home",
        "link": "https://artsincorporated.org/fgps/",
        "logo": "https://encrypted-tbn2.gstatic.com/favicon-tbn?q=tbn:ANd9GcS_mDfJIg_rnjz21iR8FusOKVEXvVIiA-75CTo2W2-sI2qE6ostf4cDLy__KgU7p6j5H6qkYP9c1yefmjXdqXrlcrn42fsPCfAlyCZDyPivGq2Luyw4ywFD8Q",
        "source": "Arts Incorporated",
        "image": "https://encrypted-tbn2.gstatic.com/images?q=tbn:ANd9GcTPfkm0GAi--1NuzfHwVOBBGRUoQvIuQIeTV6G8cOOVVsWh-Z9V",
        "image_url": "https://encrypted-tbn2.gstatic.com/images?q=tbn:ANd9GcTPfkm0GAi--1NuzfHwVOBBGRUoQvIuQIeTV6G8cOOVVsWh-Z9V",
        "rank": 56,
        "global_rank": 56
      },
      {
        "title": "The differences between RTK and PPK. Which method is best ...",
        "link": "https://www.ardusimple.com/ppk-vs-rtk/",
        "logo": "https://encrypted-tbn1.gstatic.com/favicon-tbn?q=tbn:ANd9GcTNV33vg9eOKdK3IItijTo0CjIoVAK2c9OzzYXzVXS1gtbyE61651a9drsxjJW2yC0K7rfttJXAP3g7_LZ0wmwPHQOmepn9z-zIMHJDGlgrijHfNKFESgc",
        "source": "ArduSimple",
        "image": "https://encrypted-tbn1.gstatic.com/images?q=tbn:ANd9GcS0cxDcJbc9ypZFOS_APjj_8Xzy-gGHG-wbSV_WR0Wn0-tqUAVf",
        "image_url": "https://encrypted-tbn1.gstatic.com/images?q=tbn:ANd9GcS0cxDcJbc9ypZFOS_APjj_8Xzy-gGHG-wbSV_WR0Wn0-tqUAVf",
        "rank": 57,
        "global_rank": 57
      },
      {
        "title": "services — New Horizons Fellowship Church",
        "link": "https://www.nhfchurch.com/services",
        "logo": "https://encrypted-tbn0.gstatic.com/favicon-tbn?q=tbn:ANd9GcTx3EZkS6f0vTYrOCdoVKZ0ixnXJfk3j5vGiEvhGHSQu_S0tK-En_lsD39BVN-vCPey0Az03DUsK682x59bi7rV2Ak9QaYX15hZYCqn6_QGaKllETzKFw",
        "source": "nhfchurch.com",
        "image": "https://encrypted-tbn2.gstatic.com/images?q=tbn:ANd9GcSd-3Ystky8B46WBC0gNQABC8vpOxd9wmxTIUeTIBkExCpwHtET",
        "image_url": "https://encrypted-tbn2.gstatic.com/images?q=tbn:ANd9GcSd-3Ystky8B46WBC0gNQABC8vpOxd9wmxTIUeTIBkExCpwHtET",
        "rank": 58,
        "global_rank": 58
      },
      {
        "title": "YouTube Logo (2017-current) - YouTube",
        "link": "https://www.youtube.com/watch?v=qGkE0wz2dwY",
        "logo": "https://encrypted-tbn0.gstatic.com/favicon-tbn?q=tbn:ANd9GcQHQslzHLLyLc_qne5jxn7JocidlmUPyegZ8ojX3WVlorFk8BxW9a3vJWjDzN99UHVTqSaNBj_-6XykhxuVQfF3Ye7xScSWSuc2QHXi0a12CkVwBmo",
        "source": "YouTube",
        "image": "https://encrypted-tbn3.gstatic.com/images?q=tbn:ANd9GcSrIsvSRQmUafGp12uSG_RsufFOOqUxiuk1fYHDoW5gUqWAzpUz",
        "image_url": "https://encrypted-tbn3.gstatic.com/images?q=tbn:ANd9GcSrIsvSRQmUafGp12uSG_RsufFOOqUxiuk1fYHDoW5gUqWAzpUz",
        "rank": 59,
        "global_rank": 59
      },
      {
        "title": "Kristeen Garcia - Google | LinkedIn",
        "link": "https://www.linkedin.com/in/kristeen-garcia-6879a73b",
        "logo": "https://encrypted-tbn3.gstatic.com/favicon-tbn?q=tbn:ANd9GcTFMvFisG5Yfyq07VS0hk1otTr6uQvufSrlgYLzmBkZlxd7MQh66ZmKRUOdwfXrertN7RslYSLWGQCDyxLn3JsHLob5z5LPzTRUUQlVmSHaBnVJlJa8",
        "source": "LinkedIn",
        "image": "https://encrypted-tbn2.gstatic.com/images?q=tbn:ANd9GcQTy_qmt5vLpWNHYFG0-Lswj8W_w9tqvcuXY9-9zmjyLrBEa_5h",
        "image_url": "https://encrypted-tbn2.gstatic.com/images?q=tbn:ANd9GcQTy_qmt5vLpWNHYFG0-Lswj8W_w9tqvcuXY9-9zmjyLrBEa_5h",
        "rank": 60,
        "global_rank": 60
      }
    ]
  }
  ```
</ResponseExample>


# Google Lens localization
Source: https://docs.brightdata.com/api-reference/serp/google-lens/localization

Configure the Bright Data Google Lens Google Lens localization parameter to refine queries and return matching results as JSON or HTML. On port 44445.

```txt wrap theme={null}
https://lens.google.com/uploadbyurl?url=https%3A%2F%2Fwww.youtube.com%2Fimg%2Fdesktop%2Fyt_1200.png&hl=de
```

## Parameters

<ParamField type="query">
  URL of image you want to search
</ParamField>

<ParamField type="string">
  Two-letter language code used to define the page languages

  ```txt wrap theme={null}
  https://lens.google.com/uploadbyurl?url=https%3A%2F%2Fwww.youtube.com%2Fimg%2Fdesktop%2Fyt_1200.png&hl=de
  ```
</ParamField>

<RequestExample>
  ```shell cURL highlight={6} theme={null}
    curl -X POST https://api.brightdata.com/request \
    --header "Content-Type: application/json" \
    --header "Authorization: Bearer API_KEY" \
    --data '{
      "zone": "serp_api1",
      "url": "https://lens.google.com/uploadbyurl?url=https%3A%2F%2Fwww.youtube.com%2Fimg%2Fdesktop%2Fyt_1200.png&hl=de",
      "format": "raw"
    }'
  ```

  ```shell Native proxy highlight={4} theme={null}
  curl --proxy brd.superproxy.io:44445 \
    --proxy-user CUSTOMER_USERNAME:CUSTOMER_PASSWORD \
    --ssl-no-revoke \
    "https://lens.google.com/uploadbyurl?url=https%3A%2F%2Fwww.youtube.com%2Fimg%2Fdesktop%2Fyt_1200.png&hl=de"
  ```

  ```js Node.js highlight={10} theme={null}
  (async () => {
    const response = await fetch('https://api.brightdata.com/request', {
      method: 'POST',
      headers: {
        'Content-Type': 'application/json',
        'Authorization': 'Bearer API_KEY'
      },
      body: JSON.stringify({
        zone: 'serp_api1',
        url: 'https://lens.google.com/uploadbyurl?url=https%3A%2F%2Fwww.youtube.com%2Fimg%2Fdesktop%2Fyt_1200.png&hl=de',
        format: 'raw'
      })
    });
    
    const data = await response.text();
    console.log(data);
  })();
  ```

  ```python Python highlight={11} theme={null}
  import requests

  # API Configuration
  headers = {
      'Content-Type': 'application/json',
      'Authorization': 'Bearer API_KEY',
  }

  payload = {
      'zone': 'serp_api1',
      'url': 'https://lens.google.com/uploadbyurl?url=https%3A%2F%2Fwww.youtube.com%2Fimg%2Fdesktop%2Fyt_1200.png&hl=de',
      'format': 'raw'
  }

  # Make the request
  response = requests.post(
      'https://api.brightdata.com/request', 
      json=payload, 
      headers=headers
  )

  print(response.text)
  ```
</RequestExample>

<ResponseExample>
  ```json 200 theme={null}
  {
    "general": {
      "language": "de-US",
      "mode": "search",
      "type": "all"
    },
    "tabs": [
      {
        "name": "KI‑Modus",
        "link": "https://www.google.com/search?sca_esv=5f09d3ac69940124&lns_surface=26&biw=912&bih=1055&hl=de&gl=US&udm=50&vsrid=CLyBnbbE-rvuaRACGAEiJGFhMWIwOWE2LTI1ZDctNDk0Zi05NDM0LTZiZTliNDc3NjAxODIGIgJzZChYOOmkpJat95ID&vsint=CAIqDAoCCAcSAggKGAEgATojChYNAAAAPxUAAAA_HQAAgD8lAACAPzABEIAIGIAIJQAAgD8&lns_mode=un&source=lns.web.gsbubu&vsdim=1024,1024&gsessionid=asRPaSchYw9tQDTXqsGk5tww15VHt6nmfxqTlI0tV3giA4ZvNBcMSg&lsessionid=oLjt_CfkSy9-l6EqHLU0PHJfSb-wMWPOKj12yxI_Q5OqAs21rlPJQw&fbs=ADc_l-bQrFPR8qvD0srDSK1yPoIVJPB2H6jQhOFYRGjy7Uwrp_IJFEdt-fFKhyqjW5-jKsNNUav_lvb78dH42zTP5T_ZC54CsSV8FOJkJCb7fXQPvfzdf4bhuW6UZhaCk5wfbDpkA4p8v7RxnwLLKLzB8iFQuiocRg&q=&aep=1&ntc=1&sa=X&ved=2ahUKEwjYx46XrfeSAxVYTWwGHa5WMUIQ2J8OegQIDxAD"
      },
      {
        "name": "Alle",
        "type": "all",
        "selected": true
      },
      {
        "name": "Genaue Übereinstimmungen",
        "type": "exact_matches",
        "link": "https://www.google.com/search?sca_esv=5f09d3ac69940124&lns_surface=26&biw=912&bih=1055&hl=de&gl=US&udm=48&vsrid=CLyBnbbE-rvuaRACGAEiJGFhMWIwOWE2LTI1ZDctNDk0Zi05NDM0LTZiZTliNDc3NjAxODIGIgJzZChYOOmkpJat95ID&vsint=CAIqDAoCCAcSAggKGAEgATojChYNAAAAPxUAAAA_HQAAgD8lAACAPzABEIAIGIAIJQAAgD8&lns_mode=un&source=lns.web.gsbubu&vsdim=1024,1024&gsessionid=asRPaSchYw9tQDTXqsGk5tww15VHt6nmfxqTlI0tV3giA4ZvNBcMSg&lsessionid=oLjt_CfkSy9-l6EqHLU0PHJfSb-wMWPOKj12yxI_Q5OqAs21rlPJQw&vsrid=CLyBnbbE-rvuaRACGAEiJDc5NGUxYzBmLTA2MjktNDA1Yi1hZjNlLWU0MWRiNTFiNDViMzIGIgJzZChYOOmkpJat95IDUAA&q=&sa=X&ved=2ahUKEwjYx46XrfeSAxVYTWwGHa5WMUIQs6gLegQIExAB"
      },
      {
        "name": "Visuelle Übereinstimmungen",
        "type": "visual_matches",
        "link": "https://www.google.com/search?sca_esv=5f09d3ac69940124&lns_surface=26&biw=912&bih=1055&hl=de&gl=US&udm=44&vsrid=CLyBnbbE-rvuaRACGAEiJGFhMWIwOWE2LTI1ZDctNDk0Zi05NDM0LTZiZTliNDc3NjAxODIGIgJzZChYOOmkpJat95ID&vsint=CAIqDAoCCAcSAggKGAEgATojChYNAAAAPxUAAAA_HQAAgD8lAACAPzABEIAIGIAIJQAAgD8&lns_mode=un&source=lns.web.gsbubu&vsdim=1024,1024&gsessionid=asRPaSchYw9tQDTXqsGk5tww15VHt6nmfxqTlI0tV3giA4ZvNBcMSg&lsessionid=oLjt_CfkSy9-l6EqHLU0PHJfSb-wMWPOKj12yxI_Q5OqAs21rlPJQw&q=&sa=X&ved=2ahUKEwjYx46XrfeSAxVYTWwGHa5WMUIQs6gLegQIEBAB"
      },
      {
        "name": "Infos zu diesem Bild",
        "type": "about",
        "link": "https://www.google.com/search/about-this-image?img=H4sIAAAAAAAAAFPy5HLn2NM4d9uRX7vfZQowSTAqqSQmGiYZWCaa6RqZppjrmliapOlamhib6JolpVommZibmxkYWhixKTEVp2hEWLxcsmTa2u-TmAMYAHJruTJLAAAA&sa=X&ved=2ahUKEwjYx46XrfeSAxVYTWwGHa5WMUIQs6gLegQIEhAB"
      }
    ],
    "images": [
      {
        "title": "Youtube Live Streaming – Varvid",
        "link": "https://varvid.com/broadcast-platforms/youtube/",
        "logo": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAACAAAA...",
        "source": "varvid.com",
        "image": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAZ8AAA...",
        "image_base64": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAZ8AAA...",
        "rank": 1,
        "global_rank": 1
      },
      {
        "title": "Worship – New Horizons Christian Church",
        "link": "https://newhorizonschristianchurch.com/worship/",
        "logo": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAACAAAA...",
        "source": "New Horizons Christian Church",
        "image": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAcAAAA...",
        "image_base64": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAcAAAA...",
        "rank": 2,
        "global_rank": 2
      },
      {
        "title": "YouTube:www.amazon.com:Appstore for Android",
        "link": "https://www.amazon.de/-/en/dp/B07T771SPH",
        "logo": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAACAAAA...",
        "source": "Amazon.de",
        "image": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAOEAAA...",
        "image_base64": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAOEAAA...",
        "rank": 3,
        "global_rank": 3
      },
      {
        "title": "Die Taskleiste wird während der Wiedergabe von YouTube ...",
        "link": "https://www.youtube.com/watch?v=Tt4Jb80DFQw",
        "logo": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAACAAAA...",
        "source": "YouTube",
        "image": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAQMAAA...",
        "image_base64": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAQMAAA...",
        "rank": 4,
        "global_rank": 4
      },
      {
        "title": "Shannon Ong - Product Lead at YouTube (Google) | Ex-Amazon ...",
        "link": "https://www.linkedin.com/in/shannon-ong-44887053",
        "logo": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAACAAAA...",
        "source": "LinkedIn",
        "image": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAcIAAA...",
        "image_base64": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAcIAAA...",
        "rank": 5,
        "global_rank": 5
      },
      {
        "title": "Bark Avenue",
        "link": "https://barkavenue6.com/",
        "logo": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQABAAD/2w...",
        "source": "barkavenue6.com",
        "image": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAT4AAA...",
        "image_base64": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAT4AAA...",
        "rank": 6,
        "global_rank": 6
      },
      {
        "title": "YouTube-Hintergrund. YouTube-Symbol. Social-Media-Symbole ...",
        "link": "https://de.freepik.com/vektoren-premium/youtube-hintergrund-youtube-symbol-social-media-symbole-realistisches-logo-vektor-saporischschja-ukraine-10-mai-2021_16494843.htm",
        "logo": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAACAAAA...",
        "source": "Freepik",
        "image": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAOEAAA...",
        "image_base64": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAOEAAA...",
        "rank": 7,
        "global_rank": 7
      },
      {
        "title": "Run - Ludovico Einaudi (1 hour) - YouTube",
        "link": "https://www.youtube.com/watch?v=mYB8kd3F26g",
        "logo": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAACAAAA...",
        "source": "YouTube",
        "image": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAASsAAA...",
        "image_base64": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAASsAAA...",
        "rank": 8,
        "global_rank": 8
      },
      {
        "title": "Does your YouTube logo also have a peace loop? Is that ...",
        "link": "https://www.reddit.com/r/Switzerland/comments/1q21t42/does_your_youtube_logo_also_have_a_peace_loop_is/",
        "logo": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAACAAAA...",
        "source": "Reddit",
        "image": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAASgAAA...",
        "image_base64": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAASgAAA...",
        "rank": 9,
        "global_rank": 9
      },
      {
        "title": "AI Overviews Are Coming To YouTube In New Test",
        "link": "https://www.tulsamarketingonline.com/ai-overviews-are-coming-to-youtube-in-new-test/",
        "logo": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAACAAAA...",
        "source": "Tulsa Marketing Online",
        "image": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQABAAD/2w...",
        "image_base64": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQABAAD/2w...",
        "rank": 10,
        "global_rank": 10
      },
      {
        "title": "Videos - Springdale FWB - Springdale Free Will Baptist Church",
        "link": "https://www.springdalefwb.org/videos.html",
        "logo": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAACAAAA...",
        "source": "Springdale Free Will Baptist Church",
        "image": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAa8AAA...",
        "image_base64": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAa8AAA...",
        "rank": 11,
        "global_rank": 11
      },
      {
        "title": "Emergence with Elaira",
        "link": "https://www.elairaflow.com/podcast/",
        "logo": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAACAAAA...",
        "source": "Elaira Flow",
        "image": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAbUAAA...",
        "image_base64": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAbUAAA...",
        "rank": 12,
        "global_rank": 12
      },
      {
        "title": "Watching YouTube Videos in Whonix",
        "link": "https://www.whonix.org/wiki/YouTube",
        "logo": "https://encrypted-tbn1.gstatic.com/favicon-tbn?q=tbn:ANd9GcR7RCT4r1ULdXFpOWV7360X_4uHe_tgQD8LjRH_CH1PdrUaVhIVyar26V_7gxFFa3iH8Oy21z9GPKAYnBLMmPWgbGAmEwYkn8RSAqv6Zzv0OcuUFQ",
        "source": "Whonix",
        "image": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcRXYvXSyyCilfbT9uHBSCn_f8N0EHl1BJIvVnTlaimF1YfRaHUK",
        "image_url": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcRXYvXSyyCilfbT9uHBSCn_f8N0EHl1BJIvVnTlaimF1YfRaHUK",
        "rank": 13,
        "global_rank": 13
      },
      {
        "title": "Council Meeting Videos | City of Oconomowoc, WI - Official ...",
        "link": "https://www.oconomowoc-wi.gov/769/Council-Meeting-Videos-on-YouTube",
        "logo": "https://encrypted-tbn3.gstatic.com/favicon-tbn?q=tbn:ANd9GcQTyr2X3_sexqjYHbmBx8BOfYR2NdvXo7-7f_aOtDoQqtUeIhYdRlCTaktRxMJqisDnx5bKSz--9AFYPlCBMyEtRQwVFaVo85gmzwH-C_YqrqE2qay2p3PyKYw",
        "source": "City of Oconomowoc, WI (.gov)",
        "image": "https://encrypted-tbn3.gstatic.com/images?q=tbn:ANd9GcRdPwT4HJnPOPNlvcKaANyl-0YrnwPHxnAmbKyRdYM5SIE35CD3",
        "image_url": "https://encrypted-tbn3.gstatic.com/images?q=tbn:ANd9GcRdPwT4HJnPOPNlvcKaANyl-0YrnwPHxnAmbKyRdYM5SIE35CD3",
        "rank": 14,
        "global_rank": 14
      },
      {
        "title": "YouTube pours money into how-to videos",
        "link": "https://www.bbc.com/news/technology-45940777",
        "logo": "https://encrypted-tbn1.gstatic.com/favicon-tbn?q=tbn:ANd9GcRqQdPtFBN3bPsr-Qgzb7Y0PF6GpVT51CS6HYSB6PXjFM1KQM0riEjmg6eZuNil3vXzxVUlL9E0q5Xq_wIPsMz28MXi8-AtXYEI7eLNJMpzlQ",
        "source": "BBC",
        "image": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcTGZQ6e8cZafg_Gf3BelBILe655wBxWBgMcfq4SS-_T-HNPLV0H",
        "image_url": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcTGZQ6e8cZafg_Gf3BelBILe655wBxWBgMcfq4SS-_T-HNPLV0H",
        "rank": 15,
        "global_rank": 15
      },
      {
        "title": "Rob Pratley",
        "link": "https://luc.devroye.org/fonts-87321.html",
        "logo": "https://encrypted-tbn1.gstatic.com/favicon-tbn?q=tbn:ANd9GcQWUq4levL2IJLit-bQYDm4o9U35ZP1zDILK4M6PZ6IXNLyCCfM8mN-Dbup_Cpy009Pdqs1OO4W0vRc2OyGIu5EkE4SHxrmzXIh0JQo5KSeh2hI2HA",
        "source": "devroye.org",
        "image": "https://encrypted-tbn2.gstatic.com/images?q=tbn:ANd9GcRVwnQjv1TrJlbyTjSQfLesOC8dVjEjXQlEF08KnM-2HdN1g0po",
        "image_url": "https://encrypted-tbn2.gstatic.com/images?q=tbn:ANd9GcRVwnQjv1TrJlbyTjSQfLesOC8dVjEjXQlEF08KnM-2HdN1g0po",
        "rank": 16,
        "global_rank": 16
      },
      {
        "title": "Popaganda Podcast",
        "link": "https://www.popagandapod.com/season1",
        "logo": "https://encrypted-tbn0.gstatic.com/favicon-tbn?q=tbn:ANd9GcSxbqFeVrr2di3ffaWz_O8ivKYW7tRtmi51RAq8MylGvGAQHmV9lqUDOdmE8rMpy9s63aeBGIzHjho53xhXkEkOIxVNl6MrlEqQ859957BgADrGHPH31PUP5g",
        "source": "Popaganda Podcast",
        "image": "https://encrypted-tbn3.gstatic.com/images?q=tbn:ANd9GcQti39Qu5s92QMRuS63qsnoyO5JlBmIu84Q0GtL1b0Sc1XG0O0s",
        "image_url": "https://encrypted-tbn3.gstatic.com/images?q=tbn:ANd9GcQti39Qu5s92QMRuS63qsnoyO5JlBmIu84Q0GtL1b0Sc1XG0O0s",
        "rank": 17,
        "global_rank": 17
      },
      {
        "title": "The differences between RTK and PPK. Which method is best ...",
        "link": "https://www.ardusimple.com/ppk-vs-rtk/",
        "logo": "https://encrypted-tbn1.gstatic.com/favicon-tbn?q=tbn:ANd9GcTNV33vg9eOKdK3IItijTo0CjIoVAK2c9OzzYXzVXS1gtbyE61651a9drsxjJW2yC0K7rfttJXAP3g7_LZ0wmwPHQOmepn9z-zIMHJDGlgrijHfNKFESgc",
        "source": "ArduSimple",
        "image": "https://encrypted-tbn1.gstatic.com/images?q=tbn:ANd9GcS0cxDcJbc9ypZFOS_APjj_8Xzy-gGHG-wbSV_WR0Wn0-tqUAVf",
        "image_url": "https://encrypted-tbn1.gstatic.com/images?q=tbn:ANd9GcS0cxDcJbc9ypZFOS_APjj_8Xzy-gGHG-wbSV_WR0Wn0-tqUAVf",
        "rank": 18,
        "global_rank": 18
      },
      {
        "title": "Listen – Kicks Band of Fargo-Moorhead",
        "link": "https://fmkicksband.com/listen/",
        "logo": "https://encrypted-tbn2.gstatic.com/favicon-tbn?q=tbn:ANd9GcSXIP238x7Ns9vg5fxViRnkAHehX-cXBHAumAnxFErtlfXQpKU6hVJib-drG2IjKuQ3zFj0pmu3F_N8pdVpuCn5VuYHj67pIOKWTIo3uZnmRNt9Eag",
        "source": "Kicks Band of Fargo-Moorhead",
        "image": "https://encrypted-tbn2.gstatic.com/images?q=tbn:ANd9GcRoVsB0EGH2wECLCNA1IotQT_M1ApQTGq-53qFeSPfLlaP7dceG",
        "image_url": "https://encrypted-tbn2.gstatic.com/images?q=tbn:ANd9GcRoVsB0EGH2wECLCNA1IotQT_M1ApQTGq-53qFeSPfLlaP7dceG",
        "rank": 19,
        "global_rank": 19
      },
      {
        "title": "YouTube says that music is now 25% of its global watch time",
        "link": "https://musically.com/2021/09/16/youtube-says-that-music-is-now-25-of-its-global-watch-time/",
        "logo": "https://encrypted-tbn3.gstatic.com/favicon-tbn?q=tbn:ANd9GcSFAxZpnQqFaA4qoNqYk_NlH7wPwpNpjN3Fyh-p6wfFTc-IhE0-Ufkg2aomh1NFcGdcunSi9BYOB0RK6mkP7VVvlBlxdcQcbJILVSRsFGTY83Gj",
        "source": "Music Ally",
        "image": "https://encrypted-tbn3.gstatic.com/images?q=tbn:ANd9GcQjPmybg3_wHprlJf2gIX5GjEPxEsB51OyF42VDXiKkYjYF2oTr",
        "image_url": "https://encrypted-tbn3.gstatic.com/images?q=tbn:ANd9GcQjPmybg3_wHprlJf2gIX5GjEPxEsB51OyF42VDXiKkYjYF2oTr",
        "rank": 20,
        "global_rank": 20
      },
      {
        "title": "Haases Papiertheater auf YouTube – Haases Papiertheater",
        "link": "https://www.haases-papiertheater.de/foerderung-vom-land-nrw-fuer-haases-papiertheater/",
        "logo": "https://encrypted-tbn1.gstatic.com/favicon-tbn?q=tbn:ANd9GcRSbs77zp164Kuy7sGM2Gom24YH_NFR_5v6RjiePFuZ22m27Ln1xCjlR5g_2fpkRwwuxmQhpNpHWuSYaaWUNOjD3JhChL8zn6Y06KyQW409ZWQIYKbmbO1lyEc1Dsx6Kf0",
        "source": "Haases Papiertheater",
        "image": "https://encrypted-tbn3.gstatic.com/images?q=tbn:ANd9GcQbTcRQfP9eXQEOyuwSbayvlRvs-i4tAGSVk9keXMQgZ7ZXUT7_",
        "image_url": "https://encrypted-tbn3.gstatic.com/images?q=tbn:ANd9GcQbTcRQfP9eXQEOyuwSbayvlRvs-i4tAGSVk9keXMQgZ7ZXUT7_",
        "rank": 21,
        "global_rank": 21
      },
      {
        "title": "Titanium Exhaust Shop USA & Supercar Exhaust Fabrication ...",
        "link": "https://www.juggernautmotorsports.com/contact-us",
        "logo": "https://encrypted-tbn1.gstatic.com/favicon-tbn?q=tbn:ANd9GcR8hgMBnSvz0patcT-KaUUmbTuH8f3sF83fa2jAOmFcrLOiOE6fT5HmQjPzlbF6Np1BGYRy6orYGanCsOolZ3U9jKBDL2SugPBWgDoKPDoycWlcMK9NgAeZKoHLFqsV3fY9_Q",
        "source": "Juggernaut Motorsports",
        "image": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcQ-6pPnPTwM0a4_gapWHEGKYYe7bU38hPSJcYBf3ozmr1kUgg-O",
        "image_url": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcQ-6pPnPTwM0a4_gapWHEGKYYe7bU38hPSJcYBf3ozmr1kUgg-O",
        "rank": 22,
        "global_rank": 22
      },
      {
        "title": "Practices + Playlists — Shawn J. Moore, The Mindful Rebel®",
        "link": "https://www.shawnjmoore.com/listen",
        "logo": "https://encrypted-tbn1.gstatic.com/favicon-tbn?q=tbn:ANd9GcRtkwHR73zt_pPwLkrunvKwi5t5l12sPzyLDJiB0L5o99WE7uXv8OPet3Po9wW4dyeA0FeuNfoVOed_WWwZL9ihFpVlRie_NG1JuggWI4Xnv8U0blP_7wOD",
        "source": "shawnjmoore.com",
        "image": "https://encrypted-tbn3.gstatic.com/images?q=tbn:ANd9GcTzD6aBv7OJzyeYz2m1jZBbaEYlKxk1ScXMopYqPJcp5i55Fu15",
        "image_url": "https://encrypted-tbn3.gstatic.com/images?q=tbn:ANd9GcTzD6aBv7OJzyeYz2m1jZBbaEYlKxk1ScXMopYqPJcp5i55Fu15",
        "rank": 23,
        "global_rank": 23
      },
      {
        "title": "YouTube Links for Anne Z | Anne Z on the Web",
        "link": "https://annezontheweb.com/you-tube-links-anne-z-on-the-web/",
        "logo": "https://encrypted-tbn1.gstatic.com/favicon-tbn?q=tbn:ANd9GcSDIIO4W4Ama4T6lvAPC7HUk1SV3hRP_oJkukjBzEtKDA7PUJXbLEZ-Tjp-4nBHRgMn1FPzDOR62BrAex4X0BvfOfJjndvL3FjGsa2F37448wajStuF3g",
        "source": "annezontheweb.com",
        "image": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcR7QzVG2h-AGEuDvhAWzIs1oJltO_TwztlJYqfZE--A3SpDptSx",
        "image_url": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcR7QzVG2h-AGEuDvhAWzIs1oJltO_TwztlJYqfZE--A3SpDptSx",
        "rank": 24,
        "global_rank": 24
      },
      {
        "title": "Kristeen Garcia - Google | LinkedIn",
        "link": "https://www.linkedin.com/in/kristeen-garcia-6879a73b",
        "logo": "https://encrypted-tbn3.gstatic.com/favicon-tbn?q=tbn:ANd9GcTFMvFisG5Yfyq07VS0hk1otTr6uQvufSrlgYLzmBkZlxd7MQh66ZmKRUOdwfXrertN7RslYSLWGQCDyxLn3JsHLob5z5LPzTRUUQlVmSHaBnVJlJa8",
        "source": "LinkedIn",
        "image": "https://encrypted-tbn2.gstatic.com/images?q=tbn:ANd9GcQTy_qmt5vLpWNHYFG0-Lswj8W_w9tqvcuXY9-9zmjyLrBEa_5h",
        "image_url": "https://encrypted-tbn2.gstatic.com/images?q=tbn:ANd9GcQTy_qmt5vLpWNHYFG0-Lswj8W_w9tqvcuXY9-9zmjyLrBEa_5h",
        "rank": 25,
        "global_rank": 25
      },
      {
        "title": "How to Live Stream on YouTube Using Your iPhone 15, iPhone ...",
        "link": "https://www.youtube.com/watch?v=rXU3sRnDi5M",
        "logo": "https://encrypted-tbn0.gstatic.com/favicon-tbn?q=tbn:ANd9GcQHQslzHLLyLc_qne5jxn7JocidlmUPyegZ8ojX3WVlorFk8BxW9a3vJWjDzN99UHVTqSaNBj_-6XykhxuVQfF3Ye7xScSWSuc2QHXi0a12CkVwBmo",
        "source": "YouTube",
        "image": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcT2J6imTTg_XtsK2Yul9RScPHVLmB1y2NppWjMLXRW2mzJYEfsC",
        "image_url": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcT2J6imTTg_XtsK2Yul9RScPHVLmB1y2NppWjMLXRW2mzJYEfsC",
        "rank": 26,
        "global_rank": 26
      },
      {
        "title": "YouTube's Checks to Warn Creators About Copyright Issues ...",
        "link": "https://ottverse.com/youtube-checks-warn-creators-about-copyright-issues/",
        "logo": "https://encrypted-tbn2.gstatic.com/favicon-tbn?q=tbn:ANd9GcQV3QA33hwGlp-HOrq6qCTu4V6QtzpxE8W62b4_TiSVunAN06tPoZW18UhkT5wOHmoEx5PlHrrZjin1Jl1x4ad_9aAYWSZe79fxVLSv4UJHaJ8",
        "source": "OTTVerse",
        "image": "https://encrypted-tbn2.gstatic.com/images?q=tbn:ANd9GcQ4tiYPe8b5sDGi8ePUF7WnAyOgV0ZcmTYWZBsgXYT-fq0M7m6J",
        "image_url": "https://encrypted-tbn2.gstatic.com/images?q=tbn:ANd9GcQ4tiYPe8b5sDGi8ePUF7WnAyOgV0ZcmTYWZBsgXYT-fq0M7m6J",
        "rank": 27,
        "global_rank": 27
      },
      {
        "title": "How to Turn On YouTube Shorts Remixing [Tutorial] - YouTube",
        "link": "https://www.youtube.com/watch?v=vjD2N1AWZd4",
        "logo": "https://encrypted-tbn0.gstatic.com/favicon-tbn?q=tbn:ANd9GcQHQslzHLLyLc_qne5jxn7JocidlmUPyegZ8ojX3WVlorFk8BxW9a3vJWjDzN99UHVTqSaNBj_-6XykhxuVQfF3Ye7xScSWSuc2QHXi0a12CkVwBmo",
        "source": "YouTube",
        "image": "https://encrypted-tbn1.gstatic.com/images?q=tbn:ANd9GcTmetLJpEeBZIkBH8iY9Hl9Zmg6FyRiNKggrlH2TYUydoK_WFTm",
        "image_url": "https://encrypted-tbn1.gstatic.com/images?q=tbn:ANd9GcTmetLJpEeBZIkBH8iY9Hl9Zmg6FyRiNKggrlH2TYUydoK_WFTm",
        "rank": 28,
        "global_rank": 28
      },
      {
        "title": "Veranstaltungen zum Nachschauen und -hören - Deutsch ...",
        "link": "https://dai-heidelberg.de/de/news/veranstaltungen-zum-nachhschauen-und-hoeren-63191/",
        "logo": "https://encrypted-tbn0.gstatic.com/favicon-tbn?q=tbn:ANd9GcRubgKOCSHYYQVWP5ywYqLMUuc9FMnPidY092PuUbWdw8Wqn6nd_adSREb9JX8HEHn1PSRgBVIlDCA_RF-rCb-6gveaFLTejz3pR3RcGDIg95HUnlN3Yw",
        "source": "dai-heidelberg.de",
        "image": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcQMngHlpuDdQU9Q1GE5VdctE3yinroAJPfKefg6uv__gAcfCAGR",
        "image_url": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcQMngHlpuDdQU9Q1GE5VdctE3yinroAJPfKefg6uv__gAcfCAGR",
        "rank": 29,
        "global_rank": 29
      },
      {
        "title": "Contact - Floorotex : Floorotex",
        "link": "https://www.floorotex.com/contact/",
        "logo": "https://encrypted-tbn1.gstatic.com/favicon-tbn?q=tbn:ANd9GcT7-TOxoo2JACiBhQ1IAhyD0w5Dad-Ait8UJ-eSRUDY6ekkFnjPALCvxXAU96xjtKYDQURiYt4Q7_uuABwt9-Vhv4QfKHqJMXzZlVDFAJBqCpP9sz_ZUg",
        "source": "Floorotex",
        "image": "https://encrypted-tbn1.gstatic.com/images?q=tbn:ANd9GcQu7YMOulaVrpBem_YLg7z8UJY34rCTQtTYuhrZy9L_L1RQFtcX",
        "image_url": "https://encrypted-tbn1.gstatic.com/images?q=tbn:ANd9GcQu7YMOulaVrpBem_YLg7z8UJY34rCTQtTYuhrZy9L_L1RQFtcX",
        "rank": 30,
        "global_rank": 30
      },
      {
        "title": "Video Gallery — Hay Street United Methodist Church",
        "link": "https://www.haystreetchurch.org/video-gallery",
        "logo": "https://encrypted-tbn0.gstatic.com/favicon-tbn?q=tbn:ANd9GcQ3pXOvQSC3hZs5EWZ0GtX4OOH7IrL_oUiE-ZB9RBOWZH5-j0fd3YogXOtepk9iG8rzsY0NZvIyPgFkTQjVLiCO78bTCZgDveUS_aRdGyO2ue8T9dL1qUwUk2wXaA",
        "source": "Hay Street United Methodist Church",
        "image": "https://encrypted-tbn2.gstatic.com/images?q=tbn:ANd9GcQhO-_k6w9u19ktOabB7m6miYtUyUo_q5yhx1wDAy51XGgj1gUI",
        "image_url": "https://encrypted-tbn2.gstatic.com/images?q=tbn:ANd9GcQhO-_k6w9u19ktOabB7m6miYtUyUo_q5yhx1wDAy51XGgj1gUI",
        "rank": 31,
        "global_rank": 31
      },
      {
        "title": "Filme - Network for Fashion Textile.Interior.Accessory.Design",
        "link": "https://vdmd.de/de/filme/",
        "logo": "https://encrypted-tbn2.gstatic.com/favicon-tbn?q=tbn:ANd9GcR7ldkB8Lul97UqWiMBOWruO1c735YYEZGCec9D08sT6cEdtf5qpjSGe9Ue47ecwWq-g7SugxfGsAbnUdAyuQLdHSN_iMsXL_qyNDox",
        "source": "vdmd.de",
        "image": "https://encrypted-tbn1.gstatic.com/images?q=tbn:ANd9GcTxh6IZAo2T2oTqzj9xiSmxIWxZxbixj2j-ICuVvOqYlVaoKenC",
        "image_url": "https://encrypted-tbn1.gstatic.com/images?q=tbn:ANd9GcTxh6IZAo2T2oTqzj9xiSmxIWxZxbixj2j-ICuVvOqYlVaoKenC",
        "rank": 32,
        "global_rank": 32
      },
      {
        "title": "Creative Works – Thaddeus Patrick",
        "link": "https://thaddeusthought.com/creative-works/",
        "logo": "https://encrypted-tbn0.gstatic.com/favicon-tbn?q=tbn:ANd9GcR9H-Uc02qgJl7WDZEQsH1N02jvcPWlLdbOlHlS7Z30I-bEHZ5h0xv93j6OLjoC_ItqzSJ0f6PGdr0SLYhHLgpH2VpVDiQW8wq1UoQMMISLxmgHL5BtXtwA",
        "source": "thaddeusthought.com",
        "image": "https://encrypted-tbn2.gstatic.com/images?q=tbn:ANd9GcQKG7fqC0d46Ny6wd_aOxD6hTy-XddCy6qjZCzBnRRx2Gdb5ir0",
        "image_url": "https://encrypted-tbn2.gstatic.com/images?q=tbn:ANd9GcQKG7fqC0d46Ny6wd_aOxD6hTy-XddCy6qjZCzBnRRx2Gdb5ir0",
        "rank": 33,
        "global_rank": 33
      },
      {
        "title": "Youtube Channels | TV Apps | Roku Channel Store | Roku",
        "link": "https://channelstore.roku.com/en-gb/details/501a4e61aa4f7737df0305124a39119b:9f0f785535ad319cd05f98e8af0171c6/youtube",
        "logo": "https://encrypted-tbn0.gstatic.com/favicon-tbn?q=tbn:ANd9GcSO_kezB5kMQoD9_s3N-QRanlvx8SnyVdj4oVz-z-YMqBY42JynrtZZjT8A7Y6s6CZXzmwsRDriFFretsc90DQaj3mxyyki3ZZE7zOfPSi0OUSyI2c-lr3XTmo",
        "source": "Roku",
        "image": "https://encrypted-tbn3.gstatic.com/images?q=tbn:ANd9GcTTCA7weGXnEdtDhaHBwHUAF-KOHPUZEkmhgX08pFr0Z9zoEwCt",
        "image_url": "https://encrypted-tbn3.gstatic.com/images?q=tbn:ANd9GcTTCA7weGXnEdtDhaHBwHUAF-KOHPUZEkmhgX08pFr0Z9zoEwCt",
        "rank": 34,
        "global_rank": 34
      },
      {
        "title": "Bayerische Kartoffel auf YouTube | Die Bayerische Kartoffel",
        "link": "https://www.bayerische-kartoffel.de/aktuelles/bayerische-kartoffel-auf-youtube/",
        "logo": "https://encrypted-tbn0.gstatic.com/favicon-tbn?q=tbn:ANd9GcR9K9HiIajG2nwWdB6xTp23C8Pxt8gwW1-NTh-gICYKEhSd2a9FzhttVd_0ZX3p1tHjDYSCFv4BMUOegG6-Vo2Q6eEotRwmzGHFz5sP-UZO3b7tInKflGxX6OSSdZP6JuE",
        "source": "Die Bayerische Kartoffel",
        "image": "https://encrypted-tbn2.gstatic.com/images?q=tbn:ANd9GcSAW8PSzvHDR8w-DtwSa_BacOu2CidT_Gj5U8KYoJNZ7Yi8uLrp",
        "image_url": "https://encrypted-tbn2.gstatic.com/images?q=tbn:ANd9GcSAW8PSzvHDR8w-DtwSa_BacOu2CidT_Gj5U8KYoJNZ7Yi8uLrp",
        "rank": 35,
        "global_rank": 35
      },
      {
        "title": "Oakland Woods Baptist Church Clarkston, MI 48346 | SERMONS",
        "link": "http://oaklandwoodschurch.com/sermons",
        "logo": "https://encrypted-tbn2.gstatic.com/favicon-tbn?q=tbn:ANd9GcTXfJE8ouK2vMdX69h7N9hTKqb3Iwwv_tiR6Qy7yMpvk-fdv8p7Kerkm5O2CiIXIN2ofBE1QylpSaJmJ6jyv2IrSVNAIloIRCQA5al_ZZ5Ys0JcdmsC9wSF5uE",
        "source": "Oakland Woods Baptist Church",
        "image": "https://encrypted-tbn1.gstatic.com/images?q=tbn:ANd9GcTNV6lCytXThIrG4j-8UnGh3luZqr6RFmPLEFz3Q1zk6hZl8OL6",
        "image_url": "https://encrypted-tbn1.gstatic.com/images?q=tbn:ANd9GcTNV6lCytXThIrG4j-8UnGh3luZqr6RFmPLEFz3Q1zk6hZl8OL6",
        "rank": 36,
        "global_rank": 36
      },
      {
        "title": "Home - Lee Elci",
        "link": "https://leeelci.com/",
        "logo": "https://encrypted-tbn3.gstatic.com/favicon-tbn?q=tbn:ANd9GcSHzFCDKQSmNCwYFbcv_DuBQL5I_58V2XjhA7XXKwCjXFJAlHo9X8hb9DNhViTlrFhg5-BD3W4Ol5DeDs9KsmrtYa98y-SEmu6Ic3fTLWSxiA",
        "source": "leeelci.com",
        "image": "https://encrypted-tbn1.gstatic.com/images?q=tbn:ANd9GcQuqb4DjbLh83llruMEH1J3CjUX6x_e_P44LRIf88dlY6q2eUeH",
        "image_url": "https://encrypted-tbn1.gstatic.com/images?q=tbn:ANd9GcQuqb4DjbLh83llruMEH1J3CjUX6x_e_P44LRIf88dlY6q2eUeH",
        "rank": 37,
        "global_rank": 37
      },
      {
        "title": "Audio",
        "link": "https://brendaportman.com/audio",
        "logo": "https://encrypted-tbn3.gstatic.com/favicon-tbn?q=tbn:ANd9GcRPjf6QxgmeUGa05T8HdECxJNNlljUS99TcB9GpPhQPUt0tiH_f9DcBpWKe8SrSR0ytd9QHKXFz-FZ0baurTnTM-LXGqzJgNnshlSal0c0GLOELKYENCw",
        "source": "Brenda Portman",
        "image": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcRE25aYMxpbO5iS_s7uFs8vAHPekYHm0rLFDBJytzIStBePD0mH",
        "image_url": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcRE25aYMxpbO5iS_s7uFs8vAHPekYHm0rLFDBJytzIStBePD0mH",
        "rank": 38,
        "global_rank": 38
      },
      {
        "title": "YouTube 동영상 업로드 오류 안내",
        "link": "https://blog.google/intl/ko-kr/company-news/inside-google/youtube-notice/",
        "logo": "https://encrypted-tbn3.gstatic.com/favicon-tbn?q=tbn:ANd9GcStL-sTzHn2J4VaK5tWXvxPveo_FDanN9An682O-vsvvva1mpz3OvUYdtmBNqFXZBSCAaE8oq_nkmdnRPg3lOUregpQRTKpqiQAjs18pfPSUQ",
        "source": "blog.google",
        "image": "https://encrypted-tbn2.gstatic.com/images?q=tbn:ANd9GcQ4rcFXGBKsxw_bVlL03UUllcJr3-edp5hnWRpxBvXRRlFGeYSe",
        "image_url": "https://encrypted-tbn2.gstatic.com/images?q=tbn:ANd9GcQ4rcFXGBKsxw_bVlL03UUllcJr3-edp5hnWRpxBvXRRlFGeYSe",
        "rank": 39,
        "global_rank": 39
      },
      {
        "title": "Contact Us - Hallenbeck Coin Gallery",
        "link": "https://www.hallenbeckcoingallery.com/contact-us/",
        "logo": "https://encrypted-tbn3.gstatic.com/favicon-tbn?q=tbn:ANd9GcQWWAUyOLwNPgurEHGWs6O5nK3gzRktiQIDHonqXHjbbVgeB2dIORFssSne4yuGA2IOpY29Jt8EUT9Ldmj38MMYq_i2V6bFOZq9ylncdWC3pFeXFzSQ9ufhXM6Z7SAB9tMkNA",
        "source": "Hallenbeck Coin Gallery",
        "image": "https://encrypted-tbn1.gstatic.com/images?q=tbn:ANd9GcRn5nRuouCl-6RhwoOhbfXaWlngehryBlZjRT9RixkO6XNK9XUC",
        "image_url": "https://encrypted-tbn1.gstatic.com/images?q=tbn:ANd9GcRn5nRuouCl-6RhwoOhbfXaWlngehryBlZjRT9RixkO6XNK9XUC",
        "rank": 40,
        "global_rank": 40
      },
      {
        "title": "The Texas Rottweiler Ranch - Home",
        "link": "http://www.txrottweilerranch.com/",
        "logo": "https://encrypted-tbn2.gstatic.com/favicon-tbn?q=tbn:ANd9GcTBDNxpP9eOxf0Ypwz4oWBJfb5KK1L30dFjVxexlJHK5slCqqP_NZxA8_qv9FiUUNO-T-GrDxaCg7d-BZ2UDhzPu1lKn87KOKacsjVJkWM-gB-poSpVmcAdWzOJVHI",
        "source": "The Texas Rottweiler Ranch",
        "image": "https://encrypted-tbn3.gstatic.com/images?q=tbn:ANd9GcSN-ze1vuOfO-5jpYKAsuiZ2hKxMEFZV81x8QzmhzeORZ_n7Poc",
        "image_url": "https://encrypted-tbn3.gstatic.com/images?q=tbn:ANd9GcSN-ze1vuOfO-5jpYKAsuiZ2hKxMEFZV81x8QzmhzeORZ_n7Poc",
        "rank": 41,
        "global_rank": 41
      },
      {
        "title": "YouTube Logo (2017-current) - YouTube",
        "link": "https://www.youtube.com/watch?v=qGkE0wz2dwY",
        "logo": "https://encrypted-tbn0.gstatic.com/favicon-tbn?q=tbn:ANd9GcQHQslzHLLyLc_qne5jxn7JocidlmUPyegZ8ojX3WVlorFk8BxW9a3vJWjDzN99UHVTqSaNBj_-6XykhxuVQfF3Ye7xScSWSuc2QHXi0a12CkVwBmo",
        "source": "YouTube",
        "image": "https://encrypted-tbn3.gstatic.com/images?q=tbn:ANd9GcSrIsvSRQmUafGp12uSG_RsufFOOqUxiuk1fYHDoW5gUqWAzpUz",
        "image_url": "https://encrypted-tbn3.gstatic.com/images?q=tbn:ANd9GcSrIsvSRQmUafGp12uSG_RsufFOOqUxiuk1fYHDoW5gUqWAzpUz",
        "rank": 42,
        "global_rank": 42
      },
      {
        "title": "YouTube Logo and the history of the company | LogoMyWay",
        "link": "https://blog.logomyway.com/youtube-logo/",
        "logo": "https://encrypted-tbn3.gstatic.com/favicon-tbn?q=tbn:ANd9GcRDhnhnZAw_dtHXVlyEHDgNsfsuCdE9Olv5SxsSbMitiTsa_ufALNgLS0r4eDvmSP6uhnM9oqlRWXEJ_l9x6g2BULG9lnkCwz9AgRvI15F7QmsEY641VQc",
        "source": "LogoMyWay",
        "image": "https://encrypted-tbn2.gstatic.com/images?q=tbn:ANd9GcQpI8R30EVrYnnmV0b5mTFM56JDvDTaPIir8iK3Qcoo9Ad4eu1Q",
        "image_url": "https://encrypted-tbn2.gstatic.com/images?q=tbn:ANd9GcQpI8R30EVrYnnmV0b5mTFM56JDvDTaPIir8iK3Qcoo9Ad4eu1Q",
        "rank": 43,
        "global_rank": 43
      },
      {
        "title": "File:YouTube Logo 2017.svg - Wikipedia",
        "link": "https://en.wikipedia.org/wiki/File:YouTube_Logo_2017.svg",
        "logo": "https://encrypted-tbn2.gstatic.com/favicon-tbn?q=tbn:ANd9GcRLIcgPlYxOaoBg0MnSobLYyflrgF_RLdwAY09AXHWGy2jqWQnuIBNCY5I1BuzY7jeAJga0y0b9htBHe94i3Pg4B0NhHMNDVsmS-FVRKL014d-Xf6sX",
        "source": "Wikipedia",
        "image": "https://encrypted-tbn1.gstatic.com/images?q=tbn:ANd9GcTL-8CUJTd73GCUIV8UGB5fmmuMsr_d6qBRcWfDwJ6HzKPVJnDE",
        "image_url": "https://encrypted-tbn1.gstatic.com/images?q=tbn:ANd9GcTL-8CUJTd73GCUIV8UGB5fmmuMsr_d6qBRcWfDwJ6HzKPVJnDE",
        "rank": 44,
        "global_rank": 44
      },
      {
        "title": "Should I translate the name of a university from the ...",
        "link": "https://www.reddit.com/r/German/comments/1dr9pqo/should_i_translate_the_name_of_a_university_from/",
        "logo": "https://encrypted-tbn2.gstatic.com/favicon-tbn?q=tbn:ANd9GcRFeJS-IhfJCysoVmCqJ1d-1lzbIHTsbcy4DrBsZJpxQ31zznhym7THnNEKCEnngpvdl4aupEFtEblIPBEMJY7_biy055d40m6TYfVg7CpFOrWOXw",
        "source": "Reddit",
        "image": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcSbWnwY1aI2EIjSbMzjyYGUQ-DMTGcDz01a9-Ww5zEO2_To-b-2",
        "image_url": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcSbWnwY1aI2EIjSbMzjyYGUQ-DMTGcDz01a9-Ww5zEO2_To-b-2",
        "rank": 45,
        "global_rank": 45
      },
      {
        "title": "YouTube Logo - Panzoid",
        "link": "https://panzoid.com/creations/596198",
        "logo": "https://encrypted-tbn2.gstatic.com/favicon-tbn?q=tbn:ANd9GcQL5lXx3JDQdDJ-mJXnJF9PpovKVrQSLxtSgej1YQdbS02oZEGYShIBCfEOK2u04sSpgl0F5IS_zxaK5suWnw_CJ1UonivnEBZcfC0A7dLqIg",
        "source": "Panzoid",
        "image": "https://encrypted-tbn2.gstatic.com/images?q=tbn:ANd9GcQn2qYndjltUvCrL4dyPggse2p8imimFnHvoqMt-EHWRCtFp1e6",
        "image_url": "https://encrypted-tbn2.gstatic.com/images?q=tbn:ANd9GcQn2qYndjltUvCrL4dyPggse2p8imimFnHvoqMt-EHWRCtFp1e6",
        "rank": 46,
        "global_rank": 46
      },
      {
        "title": "So deaktivieren Sie „Video angehalten“. Weiter ansehen' auf ...",
        "link": "https://www.youtube.com/watch?v=XO0bS573BX0",
        "logo": "https://encrypted-tbn0.gstatic.com/favicon-tbn?q=tbn:ANd9GcQHQslzHLLyLc_qne5jxn7JocidlmUPyegZ8ojX3WVlorFk8BxW9a3vJWjDzN99UHVTqSaNBj_-6XykhxuVQfF3Ye7xScSWSuc2QHXi0a12CkVwBmo",
        "source": "YouTube",
        "image": "https://encrypted-tbn3.gstatic.com/images?q=tbn:ANd9GcRljGzaUycjQb5RmqkBcRwZeuHns3XuLgI69iBQQSFnPijyMXBd",
        "image_url": "https://encrypted-tbn3.gstatic.com/images?q=tbn:ANd9GcRljGzaUycjQb5RmqkBcRwZeuHns3XuLgI69iBQQSFnPijyMXBd",
        "rank": 47,
        "global_rank": 47
      },
      {
        "title": "YouTube Logo (2018-2021 #2) - YouTube",
        "link": "https://www.youtube.com/watch?v=xtL7yvRndCc",
        "logo": "https://encrypted-tbn0.gstatic.com/favicon-tbn?q=tbn:ANd9GcQHQslzHLLyLc_qne5jxn7JocidlmUPyegZ8ojX3WVlorFk8BxW9a3vJWjDzN99UHVTqSaNBj_-6XykhxuVQfF3Ye7xScSWSuc2QHXi0a12CkVwBmo",
        "source": "YouTube",
        "image": "https://encrypted-tbn1.gstatic.com/images?q=tbn:ANd9GcTm3CC34QLpm3ysWo1wybCF78VXBI065JHZXMqApDxrdTV9XhX9",
        "image_url": "https://encrypted-tbn1.gstatic.com/images?q=tbn:ANd9GcTm3CC34QLpm3ysWo1wybCF78VXBI065JHZXMqApDxrdTV9XhX9",
        "rank": 48,
        "global_rank": 48
      },
      {
        "title": "Sermon Archives | orangecoastchurch",
        "link": "https://www.orangecoastchurch.org/copy-of-oc-youth",
        "logo": "https://encrypted-tbn1.gstatic.com/favicon-tbn?q=tbn:ANd9GcSRl-YuyI6JKnSDVeAkRbGF6Q79arjy9006NvRHlZfCK4z9_FZuDFiY9BBmIBW-TKzUcQ1c0af9KTY2lgC6b4rCPwkW0qfwCRVH5_T8MfkBoUuNVDy7NTyXoxE25ewf",
        "source": "orangecoastchurch",
        "image": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcRAgK4l11CcpbAbn6cSP8XXDWcBCM96MeyMMqizC1zJmLgpybGW",
        "image_url": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcRAgK4l11CcpbAbn6cSP8XXDWcBCM96MeyMMqizC1zJmLgpybGW",
        "rank": 49,
        "global_rank": 49
      },
      {
        "title": "YouTube | Nintendo Switch Download-Software | Spiele ...",
        "link": "https://www.nintendo.com/de-de/Spiele/Nintendo-Switch-Download-Software/YouTube-1467860.html",
        "logo": "https://encrypted-tbn2.gstatic.com/favicon-tbn?q=tbn:ANd9GcToBGjo96GmUCHevYIGmN-UpS53MeR2ZhzA3_OkIOo1c13GKN_eBvJl9QW6mzxeD5hTpJ-y6aDxlz1ebw2zFTwvBQpumpCdgwqbY9MRx5lDJF5Ae_Qe",
        "source": "Nintendo",
        "image": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcTGpA4xQIe7fXc11z8A81pK0q3YGsufPEU8nLwQ1i7WmtEYr9ow",
        "image_url": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcTGpA4xQIe7fXc11z8A81pK0q3YGsufPEU8nLwQ1i7WmtEYr9ow",
        "rank": 50,
        "global_rank": 50
      },
      {
        "title": "在YouTube上获得100个订阅者需要多长时间？",
        "link": "https://www.huaqiutong.com/web-seo/2397.html",
        "logo": "https://encrypted-tbn1.gstatic.com/favicon-tbn?q=tbn:ANd9GcRBAf2G9E6Rvndjr1-s8Iz67cMph7tzbdTGHuTg2omlwfp1EfSIX8ghExnZqbZtdgy7FpAT4gZl2u_CUk2ARnfEicVgNeVMzRlmEMf9xS5610ADm1bKqOk",
        "source": "huaqiutong.com",
        "image": "https://encrypted-tbn1.gstatic.com/images?q=tbn:ANd9GcSOb3S0sW3yfSaXpjCGw6awPB9P1P_AyjyvGujOvfG6qRYhDq82",
        "image_url": "https://encrypted-tbn1.gstatic.com/images?q=tbn:ANd9GcSOb3S0sW3yfSaXpjCGw6awPB9P1P_AyjyvGujOvfG6qRYhDq82",
        "rank": 51,
        "global_rank": 51
      },
      {
        "title": "Einen Podcast per RSS in Youtube integrieren – Jörn Schaars ...",
        "link": "https://joernschaar.de/einen-podcast-per-rss-in-youtube-integrieren/",
        "logo": "https://encrypted-tbn2.gstatic.com/favicon-tbn?q=tbn:ANd9GcRet8iXqe6yDnYpGMpMcp-bME0tzlQgTk297zWKqWeHzDkFmVnKziV2mnQNIgbTm4aV2OS9-D2z3gLvSTPgm8DGFVYsfK2gQ7pkhjI7ZXp4npFT7A",
        "source": "joernschaar.de",
        "image": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcQHoAd9FaBVTUNQo2fHJvtxknczljt7kq9E6hKRewIcBHzwxwsn",
        "image_url": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcQHoAd9FaBVTUNQo2fHJvtxknczljt7kq9E6hKRewIcBHzwxwsn",
        "rank": 52,
        "global_rank": 52
      },
      {
        "title": "Unsere Gottesdienste auf YouTube - Stadtmission Solingen",
        "link": "https://www.stadtmission-solingen.de/sermon/unsere-gottesdienste-auf-youtube/",
        "logo": "https://encrypted-tbn2.gstatic.com/favicon-tbn?q=tbn:ANd9GcQRd_bJaeVbzjj0lHqkBKiC6WyXT9A4fZURJAzZxIea8Oxj28PLx2LHy3rLnADulQnW-_cqeDBCmTV3IxlV5EylS20hWQZ8DnlWwzc3mtYBffsHHAXNldXvE5SzRfhBAUhk",
        "source": "Stadtmission Solingen",
        "image": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcSB8z8JeUTqzBQrTnFfVILg5fRl9Yj9JokYcjDnxMF0lwpL-TIi",
        "image_url": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcSB8z8JeUTqzBQrTnFfVILg5fRl9Yj9JokYcjDnxMF0lwpL-TIi",
        "rank": 53,
        "global_rank": 53
      },
      {
        "title": "YouTube app gets a huge redesign - PhoneArena",
        "link": "https://www.phonearena.com/news/YouTube-app-gets-a-huge-redesign_id97544",
        "logo": "https://encrypted-tbn3.gstatic.com/favicon-tbn?q=tbn:ANd9GcTzmmUWlKNu2N6Vu_BuvybF4XRJzXoEG5iXXHkZMamhlXGoSgsSvpeu9hQP8FywapcndqFH07W0BWQ3DUcUTSh89ouuATT334y1FEgi-BAx9N93KNMDMNw",
        "source": "PhoneArena",
        "image": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcSQ0Itkcn1QdHRMaVdbpRl6vFhhmq__ZvwiBpWzUYix_VJl8ChG",
        "image_url": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcSQ0Itkcn1QdHRMaVdbpRl6vFhhmq__ZvwiBpWzUYix_VJl8ChG",
        "rank": 54,
        "global_rank": 54
      },
      {
        "title": "Youtube-канал — Беляевы и партнеры",
        "link": "https://bvlegal.by/blog/youtube-channel/",
        "logo": "https://encrypted-tbn0.gstatic.com/favicon-tbn?q=tbn:ANd9GcTkBUDhrCRXCnQXWwr_iQt3hLQ-Vy3zaBZeoQeNhfaUBQVBoK67CYhwzVIa_ZoOax1jZhOWxUKvO7z4sb4cyETtVElOpqxp3uwO0B0Ctnh1",
        "source": "Беляевы и партнеры",
        "image": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcTGvHt9kJ7YyNC4TaYSEphTg-YRdfzsYHBtBzNv2sGLry77qYEW",
        "image_url": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcTGvHt9kJ7YyNC4TaYSEphTg-YRdfzsYHBtBzNv2sGLry77qYEW",
        "rank": 55,
        "global_rank": 55
      },
      {
        "title": "yt-log-groß - meta HR",
        "link": "https://www.metahr.de/meta-hr-startet-youtube-kanal/youtube-logo-gross/",
        "logo": "https://encrypted-tbn0.gstatic.com/favicon-tbn?q=tbn:ANd9GcS0sP2SEAn181zYtVCdK90wy22QwvKAtYibQInkDPPU06cOp878Llkhq2yoJ39uMg1e7cKH6ajMBtU_WqoelbZefvfaOy1a4lNQfqeuA7cc_X9V",
        "source": "metahr.de",
        "image": "https://encrypted-tbn3.gstatic.com/images?q=tbn:ANd9GcTPcmAj_Iyu7oeyUAs0i72rjbHTIqZRXvIAVCd2qhICSr95odw4",
        "image_url": "https://encrypted-tbn3.gstatic.com/images?q=tbn:ANd9GcTPcmAj_Iyu7oeyUAs0i72rjbHTIqZRXvIAVCd2qhICSr95odw4",
        "rank": 56,
        "global_rank": 56
      },
      {
        "title": "YouTube: Neues Logo und Videos im Hochkant-Format - onlinepc.ch",
        "link": "https://www.onlinepc.ch/internet/youtube/youtube-neues-logo-videos-im-hochkant-format-1286877.html",
        "logo": "https://encrypted-tbn2.gstatic.com/favicon-tbn?q=tbn:ANd9GcSKmZAmq7gBwvxYvipHi3z-YJT92XyRBjzeVv9jjaZ-_TrOlNRoKbBYuhQwztM-lUXpYzF4WHUbpj251FtoBzBI8kAV7sH-uG4o-dU_lnp617TuTJQ",
        "source": "onlinepc.ch",
        "image": "https://encrypted-tbn1.gstatic.com/images?q=tbn:ANd9GcQThZmFA2Ekg_YSopFPubNH39O8K3o0GTuYeVrgUmy0tlsf6wlA",
        "image_url": "https://encrypted-tbn1.gstatic.com/images?q=tbn:ANd9GcQThZmFA2Ekg_YSopFPubNH39O8K3o0GTuYeVrgUmy0tlsf6wlA",
        "rank": 57,
        "global_rank": 57
      },
      {
        "title": "Lincoln Municipal Band - Home",
        "link": "https://www.artsincorporated.org/lmb/",
        "logo": "https://encrypted-tbn0.gstatic.com/favicon-tbn?q=tbn:ANd9GcQuvdPTZZ78-9IyZ_1DsRl9-qzEAGLKh2kDWKxvcYVspd4pk2Ua9HA--cFdERby410oLEF3KxmAdP-0p_dpjWLh4V0MqU3eKqpU_PSiKWmjX2RJszYD1WTCQyTttSg",
        "source": "Arts Incorporated",
        "image": "https://encrypted-tbn2.gstatic.com/images?q=tbn:ANd9GcTPfkm0GAi--1NuzfHwVOBBGRUoQvIuQIeTV6G8cOOVVsWh-Z9V",
        "image_url": "https://encrypted-tbn2.gstatic.com/images?q=tbn:ANd9GcTPfkm0GAi--1NuzfHwVOBBGRUoQvIuQIeTV6G8cOOVVsWh-Z9V",
        "rank": 58,
        "global_rank": 58
      },
      {
        "title": "EULE – TV – Kinder-Lehm-Haus",
        "link": "https://kinder-lehm-haus.de/eule-tv-videothek-ueberblick",
        "logo": "https://encrypted-tbn2.gstatic.com/favicon-tbn?q=tbn:ANd9GcRXvNd56A5WwXSA37VnQwpY0W2ZICTtUuq5az8nusIwDky5KCYDBe4JKgb2SbIGN5AKnbrAQueAueEr_7YWoxwtxUeylf6rIrwoAEeWz-CAN973zrRpZ0AI",
        "source": "Kinder-Lehm-Haus",
        "image": "https://encrypted-tbn3.gstatic.com/images?q=tbn:ANd9GcQQgA8PGntx1hbjo-bMUWZfso0ZW5j8RDIaAIAjb4JacLbgXtFz",
        "image_url": "https://encrypted-tbn3.gstatic.com/images?q=tbn:ANd9GcQQgA8PGntx1hbjo-bMUWZfso0ZW5j8RDIaAIAjb4JacLbgXtFz",
        "rank": 59,
        "global_rank": 59
      },
      {
        "title": "Classic Week 2024 – 15. bis 23. Juni 2024",
        "link": "https://www.classic-week.de/",
        "logo": "https://encrypted-tbn0.gstatic.com/favicon-tbn?q=tbn:ANd9GcSZ4bHkh5NV1s9nUVoVSABAPmnkLKauZCqWcAeSeyDq5BZcoIqyx61DD76wnbtHWy2Jc0Cf3NosR8QSLM4vloj9I-MU6ckLPgcyxj1XhfqO455HIT5f3IeA",
        "source": "Classic Week 2024",
        "image": "https://encrypted-tbn2.gstatic.com/images?q=tbn:ANd9GcQ9yUmAdMXWs2aOIjikcIBUXJZVV4treOr8WzpMyqQ_oACFOUyB",
        "image_url": "https://encrypted-tbn2.gstatic.com/images?q=tbn:ANd9GcQ9yUmAdMXWs2aOIjikcIBUXJZVV4treOr8WzpMyqQ_oACFOUyB",
        "rank": 60,
        "global_rank": 60
      }
    ]
  }
  ```
</ResponseExample>


# Google Lens parsed JSON
Source: https://docs.brightdata.com/api-reference/serp/google-lens/parsed-json

Configure the Bright Data Google Lens Google Lens parsed JSON parameter to refine queries and return matching results as JSON or HTML. On port 44445.

```txt wrap theme={null}
https://lens.google.com/uploadbyurl?url=https%3A%2F%2Fwww.youtube.com%2Fimg%2Fdesktop%2Fyt_1200.png&brd_json=1
```

## Parameters

<ParamField type="query">
  URL of image you want to search
</ParamField>

<ParamField type="string">
  Set the `brd_json` parameter to `json` to get the results in JSON format.

  ```txt wrap theme={null}
  https://lens.google.com/uploadbyurl?url=https%3A%2F%2Fwww.youtube.com%2Fimg%2Fdesktop%2Fyt_1200.png&brd_json=1
  ```

  | value            | description                                                                                                         |
  | ---------------- | ------------------------------------------------------------------------------------------------------------------- |
  | `html` (default) | Returns the standard HTML response from Google Maps.                                                                |
  | `json`           | Returns the search results in a structured JSON format, making it easier to parse and extract specific data points. |
</ParamField>

<RequestExample>
  ```shell cURL highlight={6} theme={null}
    curl -X POST https://api.brightdata.com/request \
    --header "Content-Type: application/json" \
    --header "Authorization: Bearer API_KEY" \
    --data '{
      "zone": "serp_api1",
      "url": "https://lens.google.com/uploadbyurl?url=https%3A%2F%2Fwww.youtube.com%2Fimg%2Fdesktop%2Fyt_1200.png&brd_json=1",
      "format": "raw"
    }'
  ```

  ```shell Native proxy highlight={4} theme={null}
  curl --proxy brd.superproxy.io:44445 \
    --proxy-user CUSTOMER_USERNAME:CUSTOMER_PASSWORD \
    --ssl-no-revoke \
    "https://lens.google.com/uploadbyurl?url=https%3A%2F%2Fwww.youtube.com%2Fimg%2Fdesktop%2Fyt_1200.png&brd_json=1"
  ```

  ```js Node.js highlight={10} theme={null}
  (async () => {
    const response = await fetch('https://api.brightdata.com/request', {
      method: 'POST',
      headers: {
        'Content-Type': 'application/json',
        'Authorization': 'Bearer API_KEY'
      },
      body: JSON.stringify({
        zone: 'serp_api1',
        url: 'https://lens.google.com/uploadbyurl?url=https%3A%2F%2Fwww.youtube.com%2Fimg%2Fdesktop%2Fyt_1200.png&brd_json=1',
        format: 'raw'
      })
    });
    
    const data = await response.text();
    console.log(data);
  })();
  ```

  ```python Python highlight={11} theme={null}
  import requests

  # API Configuration
  headers = {
      'Content-Type': 'application/json',
      'Authorization': 'Bearer API_KEY',
  }

  payload = {
      'zone': 'serp_api1',
      'url': 'https://lens.google.com/uploadbyurl?url=https%3A%2F%2Fwww.youtube.com%2Fimg%2Fdesktop%2Fyt_1200.png&brd_json=1',
      'format': 'raw'
  }

  # Make the request
  response = requests.post(
      'https://api.brightdata.com/request', 
      json=payload, 
      headers=headers
  )

  print(response.text)
  ```
</RequestExample>

<ResponseExample>
  ```json 200 theme={null}
  {
    "general": {
      "language": "en",
      "mode": "search",
      "type": "all"
    },
    "tabs": [
      {
        "name": "AI Mode",
        "link": "https://www.google.com/search?sca_esv=5f09d3ac69940124&lns_surface=26&biw=1073&bih=1042&hl=en&gl=US&udm=50&vsrid=CK2WzY-pjI-16QEQAhgBIiRlMDYzMjhlZC01MTc1LTQxYzQtODhiNS0yN2NlODEyYTEwZWIyBiICbHUoADj_gK6NrveSAw&vsint=CAIqDAoCCAcSAggKGAEgATojChYNAAAAPxUAAAA_HQAAgD8lAACAPzABEIAIGIAIJQAAgD8&lns_mode=un&source=lns.web.gsbubu&vsdim=1024,1024&gsessionid=MT3grhEKqHgQVHgJnUBREyQXyRnNWZAssdsZ77bDS9Xpej1yiuSa3A&lsessionid=5msAOvETWC1NffbKCz-rMtHP2AxXEoZ6vqQrhpFpYavgEfO62MmIyQ&fbs=ADc_l-Yv0YTTwuvIVYRVntg99Yl4C2siJayzZyC50sFnWwRH6ow_bxUxJgqfeyXucYwXL8BodgQvcQKf4r6af6eJrUBEJPcPla2xArZ4O2zHdIqqQ1YVgeUF-eZ8YfKEFkJDuGVjK7bY&q=&aep=1&ntc=1&sa=X&ved=2ahUKEwih2OGNrveSAxXQHxAIHR4aAUMQ2J8OegQIDxAD"
      },
      {
        "name": "All",
        "type": "all",
        "selected": true
      },
      {
        "name": "Exact matches",
        "type": "exact_matches",
        "link": "https://www.google.com/search?sca_esv=5f09d3ac69940124&lns_surface=26&biw=1073&bih=1042&hl=en&gl=US&udm=48&vsrid=CK2WzY-pjI-16QEQAhgBIiRlMDYzMjhlZC01MTc1LTQxYzQtODhiNS0yN2NlODEyYTEwZWIyBiICbHUoADj_gK6NrveSAw&vsint=CAIqDAoCCAcSAggKGAEgATojChYNAAAAPxUAAAA_HQAAgD8lAACAPzABEIAIGIAIJQAAgD8&lns_mode=un&source=lns.web.gsbubu&vsdim=1024,1024&gsessionid=MT3grhEKqHgQVHgJnUBREyQXyRnNWZAssdsZ77bDS9Xpej1yiuSa3A&lsessionid=5msAOvETWC1NffbKCz-rMtHP2AxXEoZ6vqQrhpFpYavgEfO62MmIyQ&vsrid=CK2WzY-pjI-16QEQAhgBIiRjMDdlZmExZi0wZWY5LTQ3ZWItOWZiYS00OGE4ZTYyNTQxMGIyBiICbHUoADj_gK6NrveSA1AA&q=&sa=X&ved=2ahUKEwih2OGNrveSAxXQHxAIHR4aAUMQs6gLegQIEhAB"
      },
      {
        "name": "Visual matches",
        "type": "visual_matches",
        "link": "https://www.google.com/search?sca_esv=5f09d3ac69940124&lns_surface=26&biw=1073&bih=1042&hl=en&gl=US&udm=44&vsrid=CK2WzY-pjI-16QEQAhgBIiRlMDYzMjhlZC01MTc1LTQxYzQtODhiNS0yN2NlODEyYTEwZWIyBiICbHUoADj_gK6NrveSAw&vsint=CAIqDAoCCAcSAggKGAEgATojChYNAAAAPxUAAAA_HQAAgD8lAACAPzABEIAIGIAIJQAAgD8&lns_mode=un&source=lns.web.gsbubu&vsdim=1024,1024&gsessionid=MT3grhEKqHgQVHgJnUBREyQXyRnNWZAssdsZ77bDS9Xpej1yiuSa3A&lsessionid=5msAOvETWC1NffbKCz-rMtHP2AxXEoZ6vqQrhpFpYavgEfO62MmIyQ&q=&sa=X&ved=2ahUKEwih2OGNrveSAxXQHxAIHR4aAUMQs6gLegQIExAB"
      },
      {
        "name": "About this image",
        "type": "about",
        "link": "https://www.google.com/search/about-this-image?img=H4sIAAAAAAAAAFPy4vLgWDvtbP_Knv6tLxkFmCQYlVRSDcyMjSxSU3RNDc1NdU0Mk010LSySTHWNzJNTLQyNEg0NUpOM2JSYcko1GCz-N6zrXfd9EnMAAwBNfA7iTAAAAA&sa=X&ved=2ahUKEwih2OGNrveSAxXQHxAIHR4aAUMQs6gLegQIERAB"
      }
    ],
    "images": [
      {
        "title": "Youtube Live Streaming – Varvid",
        "link": "https://varvid.com/broadcast-platforms/youtube/",
        "logo": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAACAAAA...",
        "source": "varvid.com",
        "image": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAZ8AAA...",
        "image_base64": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAZ8AAA...",
        "rank": 1,
        "global_rank": 1
      },
      {
        "title": "Stopmotion x cel animation mixed media reel✨ I have lots of ...",
        "link": "https://www.instagram.com/reel/DLm6SS8yeLx/",
        "logo": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAACAAAA...",
        "source": "Instagram",
        "image": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQABAAD/2w...",
        "image_base64": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQABAAD/2w...",
        "rank": 2,
        "global_rank": 2
      },
      {
        "title": "How To Turn Off “Paid Promotion” Disclaimer on YouTube ...",
        "link": "https://www.youtube.com/watch?v=yTfcl3jHKvA",
        "logo": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAACAAAA...",
        "source": "YouTube",
        "image": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAQMAAA...",
        "image_base64": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAQMAAA...",
        "rank": 3,
        "global_rank": 3
      },
      {
        "title": "YouTube Shuts Down Original Content Group : r/television",
        "link": "https://www.reddit.com/r/television/comments/s73vjv/youtube_shuts_down_original_content_group/",
        "logo": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAACAAAA...",
        "source": "Reddit",
        "image": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAASsAAA...",
        "image_base64": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAASsAAA...",
        "rank": 4,
        "global_rank": 4
      },
      {
        "title": "File:YouTube logo upside down.jpg - Wikipedia",
        "link": "https://en.wikipedia.org/wiki/File:YouTube_logo_upside_down.jpg",
        "logo": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAACAAAA...",
        "source": "Wikipedia",
        "image": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQABAAD/2w...",
        "image_base64": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQABAAD/2w...",
        "rank": 5,
        "global_rank": 5
      },
      {
        "title": "Worship – New Horizons Christian Church",
        "link": "https://newhorizonschristianchurch.com/worship/",
        "logo": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAACAAAA...",
        "source": "New Horizons Christian Church",
        "image": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAcAAAA...",
        "image_base64": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAcAAAA...",
        "rank": 6,
        "global_rank": 6
      },
      {
        "title": "Shannon Ong - Product Lead at YouTube (Google) | Ex-Amazon ...",
        "link": "https://www.linkedin.com/in/shannon-ong-44887053",
        "logo": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAACAAAA...",
        "source": "LinkedIn",
        "image": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAcIAAA...",
        "image_base64": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAcIAAA...",
        "rank": 7,
        "global_rank": 7
      },
      {
        "title": "really hard question here: whats even the purpose of this ad ...",
        "link": "https://www.reddit.com/r/youtube/comments/1pxov43/really_hard_question_here_whats_even_the_purpose/",
        "logo": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAACAAAA...",
        "source": "Reddit",
        "image": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAVQAAA...",
        "image_base64": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAVQAAA...",
        "rank": 8,
        "global_rank": 8
      },
      {
        "title": "Videos - Springdale FWB - Springdale Free Will Baptist Church",
        "link": "https://www.springdalefwb.org/videos.html",
        "logo": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAACAAAA...",
        "source": "Springdale Free Will Baptist Church",
        "image": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAa8AAA...",
        "image_base64": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAa8AAA...",
        "rank": 9,
        "global_rank": 9
      },
      {
        "title": "Yt randomly stopped working yesterday - YouTube",
        "link": "https://www.youtube.com/watch?v=SYWjR4Ie9H4",
        "logo": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAACAAAA...",
        "source": "YouTube",
        "image": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQABAAD/2w...",
        "image_base64": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQABAAD/2w...",
        "rank": 10,
        "global_rank": 10
      },
      {
        "title": "Emergence with Elaira",
        "link": "https://www.elairaflow.com/podcast/",
        "logo": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAACAAAA...",
        "source": "Elaira Flow",
        "image": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAbUAAA...",
        "image_base64": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAbUAAA...",
        "rank": 11,
        "global_rank": 11
      },
      {
        "title": "Watching YouTube Videos in Whonix",
        "link": "https://www.whonix.org/wiki/YouTube",
        "logo": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAACAAAA...",
        "source": "Whonix",
        "image": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAbIAAA...",
        "image_base64": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAbIAAA...",
        "rank": 12,
        "global_rank": 12
      },
      {
        "title": "AI Overviews Are Coming To YouTube In New Test",
        "link": "https://www.tulsamarketingonline.com/ai-overviews-are-coming-to-youtube-in-new-test/",
        "logo": "https://encrypted-tbn0.gstatic.com/favicon-tbn?q=tbn:ANd9GcQdlX-huMkuAXP9QrJWUVbCax_aXdhGZO9qhv8aeHvTCCjnHzWOfuNp56fCD5n-lQFo2UOXmqvBrWv1EP-Y3kRZL70kqvASoG3GGaVXHP1FDF_9UrN2663TziCS-bzqD4Hw",
        "source": "Tulsa Marketing Online",
        "image": "https://encrypted-tbn1.gstatic.com/images?q=tbn:ANd9GcSrAt7rOPRTZ3ARkL-YGWskDIZZrBNHNFU8hu07vmAdCxPSDyOH",
        "image_url": "https://encrypted-tbn1.gstatic.com/images?q=tbn:ANd9GcSrAt7rOPRTZ3ARkL-YGWskDIZZrBNHNFU8hu07vmAdCxPSDyOH",
        "rank": 13,
        "global_rank": 13
      },
      {
        "title": "YouTube",
        "link": "https://www.youtube.com/c/youtubeANZ",
        "logo": "https://encrypted-tbn0.gstatic.com/favicon-tbn?q=tbn:ANd9GcQHQslzHLLyLc_qne5jxn7JocidlmUPyegZ8ojX3WVlorFk8BxW9a3vJWjDzN99UHVTqSaNBj_-6XykhxuVQfF3Ye7xScSWSuc2QHXi0a12CkVwBmo",
        "source": "YouTube",
        "image": "https://encrypted-tbn3.gstatic.com/images?q=tbn:ANd9GcRNJVypm9wQcKz7Io8sTjglOqe-TND59T-1cEZ1NsgWtrAgJb4P",
        "image_url": "https://encrypted-tbn3.gstatic.com/images?q=tbn:ANd9GcRNJVypm9wQcKz7Io8sTjglOqe-TND59T-1cEZ1NsgWtrAgJb4P",
        "rank": 14,
        "global_rank": 14
      },
      {
        "title": "Council Meeting Videos | City of Oconomowoc, WI - Official ...",
        "link": "https://www.oconomowoc-wi.gov/769/Council-Meeting-Videos-on-YouTube",
        "logo": "https://encrypted-tbn3.gstatic.com/favicon-tbn?q=tbn:ANd9GcQTyr2X3_sexqjYHbmBx8BOfYR2NdvXo7-7f_aOtDoQqtUeIhYdRlCTaktRxMJqisDnx5bKSz--9AFYPlCBMyEtRQwVFaVo85gmzwH-C_YqrqE2qay2p3PyKYw",
        "source": "City of Oconomowoc, WI (.gov)",
        "image": "https://encrypted-tbn3.gstatic.com/images?q=tbn:ANd9GcRdPwT4HJnPOPNlvcKaANyl-0YrnwPHxnAmbKyRdYM5SIE35CD3",
        "image_url": "https://encrypted-tbn3.gstatic.com/images?q=tbn:ANd9GcRdPwT4HJnPOPNlvcKaANyl-0YrnwPHxnAmbKyRdYM5SIE35CD3",
        "rank": 15,
        "global_rank": 15
      },
      {
        "title": "Popaganda Podcast",
        "link": "https://www.popagandapod.com/season1",
        "logo": "https://encrypted-tbn0.gstatic.com/favicon-tbn?q=tbn:ANd9GcSxbqFeVrr2di3ffaWz_O8ivKYW7tRtmi51RAq8MylGvGAQHmV9lqUDOdmE8rMpy9s63aeBGIzHjho53xhXkEkOIxVNl6MrlEqQ859957BgADrGHPH31PUP5g",
        "source": "Popaganda Podcast",
        "image": "https://encrypted-tbn3.gstatic.com/images?q=tbn:ANd9GcQti39Qu5s92QMRuS63qsnoyO5JlBmIu84Q0GtL1b0Sc1XG0O0s",
        "image_url": "https://encrypted-tbn3.gstatic.com/images?q=tbn:ANd9GcQti39Qu5s92QMRuS63qsnoyO5JlBmIu84Q0GtL1b0Sc1XG0O0s",
        "rank": 16,
        "global_rank": 16
      },
      {
        "title": "How To Upload To YouTube [Guide] - YouTube",
        "link": "https://www.youtube.com/watch?v=s-KZu1kru8Y",
        "logo": "https://encrypted-tbn0.gstatic.com/favicon-tbn?q=tbn:ANd9GcQHQslzHLLyLc_qne5jxn7JocidlmUPyegZ8ojX3WVlorFk8BxW9a3vJWjDzN99UHVTqSaNBj_-6XykhxuVQfF3Ye7xScSWSuc2QHXi0a12CkVwBmo",
        "source": "YouTube",
        "image": "https://encrypted-tbn1.gstatic.com/images?q=tbn:ANd9GcTmetLJpEeBZIkBH8iY9Hl9Zmg6FyRiNKggrlH2TYUydoK_WFTm",
        "image_url": "https://encrypted-tbn1.gstatic.com/images?q=tbn:ANd9GcTmetLJpEeBZIkBH8iY9Hl9Zmg6FyRiNKggrlH2TYUydoK_WFTm",
        "rank": 17,
        "global_rank": 17
      },
      {
        "title": "Where is Your YouTube History? - YouTube",
        "link": "https://www.youtube.com/watch?v=hcnkv0y-0WM",
        "logo": "https://encrypted-tbn0.gstatic.com/favicon-tbn?q=tbn:ANd9GcQHQslzHLLyLc_qne5jxn7JocidlmUPyegZ8ojX3WVlorFk8BxW9a3vJWjDzN99UHVTqSaNBj_-6XykhxuVQfF3Ye7xScSWSuc2QHXi0a12CkVwBmo",
        "source": "YouTube",
        "image": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcR3b0891aPxG36yA2V8x8ScZNv17SVWNfwTDtXyZFdmJMa4mdIu",
        "image_url": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcR3b0891aPxG36yA2V8x8ScZNv17SVWNfwTDtXyZFdmJMa4mdIu",
        "rank": 18,
        "global_rank": 18
      },
      {
        "title": "How to Live Stream on YouTube Using Your iPhone 15, iPhone ...",
        "link": "https://www.youtube.com/watch?v=rXU3sRnDi5M",
        "logo": "https://encrypted-tbn0.gstatic.com/favicon-tbn?q=tbn:ANd9GcQHQslzHLLyLc_qne5jxn7JocidlmUPyegZ8ojX3WVlorFk8BxW9a3vJWjDzN99UHVTqSaNBj_-6XykhxuVQfF3Ye7xScSWSuc2QHXi0a12CkVwBmo",
        "source": "YouTube",
        "image": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcT2J6imTTg_XtsK2Yul9RScPHVLmB1y2NppWjMLXRW2mzJYEfsC",
        "image_url": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcT2J6imTTg_XtsK2Yul9RScPHVLmB1y2NppWjMLXRW2mzJYEfsC",
        "rank": 19,
        "global_rank": 19
      },
      {
        "title": "Rob Pratley",
        "link": "https://luc.devroye.org/fonts-87321.html",
        "logo": "https://encrypted-tbn1.gstatic.com/favicon-tbn?q=tbn:ANd9GcQWUq4levL2IJLit-bQYDm4o9U35ZP1zDILK4M6PZ6IXNLyCCfM8mN-Dbup_Cpy009Pdqs1OO4W0vRc2OyGIu5EkE4SHxrmzXIh0JQo5KSeh2hI2HA",
        "source": "devroye.org",
        "image": "https://encrypted-tbn2.gstatic.com/images?q=tbn:ANd9GcRVwnQjv1TrJlbyTjSQfLesOC8dVjEjXQlEF08KnM-2HdN1g0po",
        "image_url": "https://encrypted-tbn2.gstatic.com/images?q=tbn:ANd9GcRVwnQjv1TrJlbyTjSQfLesOC8dVjEjXQlEF08KnM-2HdN1g0po",
        "rank": 20,
        "global_rank": 20
      },
      {
        "title": "Video — Paul Lincoln",
        "link": "http://www.paullincoln.com/media-2",
        "logo": "https://encrypted-tbn1.gstatic.com/favicon-tbn?q=tbn:ANd9GcR-7rvA3OHfu4y9znRDkYgG7MqdqU9M_63edTViGISPZfmcm4O5VHSj1fgqQaZhVc97bITyZ4ipdRQsSwDz9CXyGSmbU5bwbTAtn4uoZeT55MUe9P61fVQ",
        "source": "paullincoln.com",
        "image": "https://encrypted-tbn2.gstatic.com/images?q=tbn:ANd9GcT09i7ZbByzqgW95PWzZyFcVp4mWoEZcKolsA6nd0lmJES3epCe",
        "image_url": "https://encrypted-tbn2.gstatic.com/images?q=tbn:ANd9GcT09i7ZbByzqgW95PWzZyFcVp4mWoEZcKolsA6nd0lmJES3epCe",
        "rank": 21,
        "global_rank": 21
      },
      {
        "title": "YouTube Set To Overtake Facebook As Second Largest Website ...",
        "link": "https://www.tubefilter.com/2018/08/08/youtube-second-largest-us-website/",
        "logo": "https://encrypted-tbn0.gstatic.com/favicon-tbn?q=tbn:ANd9GcQOnfaQAkwfbzgAhZAsN5ZEqvhBteEgAtOUgDLozCYjPpNAwfem0ykIevsPO1a2BQWF_eWOq8yhCPPs39ddN7Qnn_REbXXsh4g8Ox6A4cd2s6tzF_8vt3Y",
        "source": "Tubefilter",
        "image": "https://encrypted-tbn3.gstatic.com/images?q=tbn:ANd9GcQdG1HLsjtJ1yGqDtoqiT8_0BJBOdjgBslZdnESZl90s5Ogt1M9",
        "image_url": "https://encrypted-tbn3.gstatic.com/images?q=tbn:ANd9GcQdG1HLsjtJ1yGqDtoqiT8_0BJBOdjgBslZdnESZl90s5Ogt1M9",
        "rank": 22,
        "global_rank": 22
      },
      {
        "title": "Livestreams and Recordings – Saint Robert's Catholic Church",
        "link": "https://saintroberts.org/livestreams-and-recordings/",
        "logo": "https://encrypted-tbn3.gstatic.com/favicon-tbn?q=tbn:ANd9GcRjhous8nGXkV0aOGtVkKN5c1hOh61JSqwS0iq3rZZWxnMc_gYOJFfkdICHl9Am33bjcVi1267LSKrraHCqHZjkiNVaDkNMLWUQ3DdvxgaI5IouOlq8",
        "source": "Saint Robert's Catholic Church",
        "image": "https://encrypted-tbn2.gstatic.com/images?q=tbn:ANd9GcQhDUhnp1HB4uSLfEsS8T6WgFzOGY6vStFEMzNyh1NVhas8Pvd3",
        "image_url": "https://encrypted-tbn2.gstatic.com/images?q=tbn:ANd9GcQhDUhnp1HB4uSLfEsS8T6WgFzOGY6vStFEMzNyh1NVhas8Pvd3",
        "rank": 23,
        "global_rank": 23
      },
      {
        "title": "Calvary Chapel Myrtle Beach - YouTube",
        "link": "https://www.youtube.com/c/CalvaryChapelMyrtleBeach",
        "logo": "https://encrypted-tbn0.gstatic.com/favicon-tbn?q=tbn:ANd9GcQHQslzHLLyLc_qne5jxn7JocidlmUPyegZ8ojX3WVlorFk8BxW9a3vJWjDzN99UHVTqSaNBj_-6XykhxuVQfF3Ye7xScSWSuc2QHXi0a12CkVwBmo",
        "source": "YouTube",
        "image": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcTNzpg3c-1dwwy9JkJ-8U9yJF8wTocFJoEsF19F1v5VWwUAUT_j",
        "image_url": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcTNzpg3c-1dwwy9JkJ-8U9yJF8wTocFJoEsF19F1v5VWwUAUT_j",
        "rank": 24,
        "global_rank": 24
      },
      {
        "title": "Church News | Grace Community Church West Allis, Wisconsin 53227",
        "link": "https://www.ourgcc.com/LiveStream",
        "logo": "https://encrypted-tbn1.gstatic.com/favicon-tbn?q=tbn:ANd9GcQjOVrgTcfOQd208wODKcdmYhpg0A4c8rI0iQOfObfVtqWQ3A82OkIxtd9eJo8DhTCB4XaOFUL34ZsE90N4upcd5sNfeR0y0DH1HagFogmWOS1Jdw",
        "source": "ourgcc.com",
        "image": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcTC3exulTpXNFqIrOs03eepYpCz8B5lco2RIq-ASaFmrLW9GiZe",
        "image_url": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcTC3exulTpXNFqIrOs03eepYpCz8B5lco2RIq-ASaFmrLW9GiZe",
        "rank": 25,
        "global_rank": 25
      },
      {
        "title": "Listen – Kicks Band of Fargo-Moorhead",
        "link": "https://fmkicksband.com/listen/",
        "logo": "https://encrypted-tbn2.gstatic.com/favicon-tbn?q=tbn:ANd9GcSXIP238x7Ns9vg5fxViRnkAHehX-cXBHAumAnxFErtlfXQpKU6hVJib-drG2IjKuQ3zFj0pmu3F_N8pdVpuCn5VuYHj67pIOKWTIo3uZnmRNt9Eag",
        "source": "Kicks Band of Fargo-Moorhead",
        "image": "https://encrypted-tbn2.gstatic.com/images?q=tbn:ANd9GcRoVsB0EGH2wECLCNA1IotQT_M1ApQTGq-53qFeSPfLlaP7dceG",
        "image_url": "https://encrypted-tbn2.gstatic.com/images?q=tbn:ANd9GcRoVsB0EGH2wECLCNA1IotQT_M1ApQTGq-53qFeSPfLlaP7dceG",
        "rank": 26,
        "global_rank": 26
      },
      {
        "title": "Industry figures hail YouTube Music's 50m-subscribers ...",
        "link": "https://musically.com/2021/09/03/industry-hail-youtube-subscribers/",
        "logo": "https://encrypted-tbn3.gstatic.com/favicon-tbn?q=tbn:ANd9GcSFAxZpnQqFaA4qoNqYk_NlH7wPwpNpjN3Fyh-p6wfFTc-IhE0-Ufkg2aomh1NFcGdcunSi9BYOB0RK6mkP7VVvlBlxdcQcbJILVSRsFGTY83Gj",
        "source": "Music Ally",
        "image": "https://encrypted-tbn3.gstatic.com/images?q=tbn:ANd9GcQjPmybg3_wHprlJf2gIX5GjEPxEsB51OyF42VDXiKkYjYF2oTr",
        "image_url": "https://encrypted-tbn3.gstatic.com/images?q=tbn:ANd9GcQjPmybg3_wHprlJf2gIX5GjEPxEsB51OyF42VDXiKkYjYF2oTr",
        "rank": 27,
        "global_rank": 27
      },
      {
        "title": "YouTube Links for Anne Z | Anne Z on the Web",
        "link": "https://annezontheweb.com/you-tube-links-anne-z-on-the-web/",
        "logo": "https://encrypted-tbn1.gstatic.com/favicon-tbn?q=tbn:ANd9GcSDIIO4W4Ama4T6lvAPC7HUk1SV3hRP_oJkukjBzEtKDA7PUJXbLEZ-Tjp-4nBHRgMn1FPzDOR62BrAex4X0BvfOfJjndvL3FjGsa2F37448wajStuF3g",
        "source": "annezontheweb.com",
        "image": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcR7QzVG2h-AGEuDvhAWzIs1oJltO_TwztlJYqfZE--A3SpDptSx",
        "image_url": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcR7QzVG2h-AGEuDvhAWzIs1oJltO_TwztlJYqfZE--A3SpDptSx",
        "rank": 28,
        "global_rank": 28
      },
      {
        "title": "Practices + Playlists — Shawn J. Moore, The Mindful Rebel®",
        "link": "https://www.shawnjmoore.com/listen",
        "logo": "https://encrypted-tbn1.gstatic.com/favicon-tbn?q=tbn:ANd9GcRtkwHR73zt_pPwLkrunvKwi5t5l12sPzyLDJiB0L5o99WE7uXv8OPet3Po9wW4dyeA0FeuNfoVOed_WWwZL9ihFpVlRie_NG1JuggWI4Xnv8U0blP_7wOD",
        "source": "shawnjmoore.com",
        "image": "https://encrypted-tbn3.gstatic.com/images?q=tbn:ANd9GcTzD6aBv7OJzyeYz2m1jZBbaEYlKxk1ScXMopYqPJcp5i55Fu15",
        "image_url": "https://encrypted-tbn3.gstatic.com/images?q=tbn:ANd9GcTzD6aBv7OJzyeYz2m1jZBbaEYlKxk1ScXMopYqPJcp5i55Fu15",
        "rank": 29,
        "global_rank": 29
      },
      {
        "title": "live — Edgerton First Reformed",
        "link": "https://www.edgertonfrc.org/live",
        "logo": "https://encrypted-tbn2.gstatic.com/favicon-tbn?q=tbn:ANd9GcQX0DHkVwqsNq8LU6oTPXlV6-xin23cGL575S3bUgZ-ziBlBpRnlJZ3jTzBnHkxrc1w_hwFCKe0N3ZBwslfw9g6etfzO4wticYgPriK-2Mu0IXr_c98ZeHj",
        "source": "edgertonfrc.org",
        "image": "https://encrypted-tbn2.gstatic.com/images?q=tbn:ANd9GcSf1bfDH6bh3UdF_o7mdSZ2UoprkQF0je__l3Y6hHynVZH7gQ-O",
        "image_url": "https://encrypted-tbn2.gstatic.com/images?q=tbn:ANd9GcSf1bfDH6bh3UdF_o7mdSZ2UoprkQF0je__l3Y6hHynVZH7gQ-O",
        "rank": 30,
        "global_rank": 30
      },
      {
        "title": "Lincoln Community Foundation Garden Performance Series - Home",
        "link": "https://artsincorporated.org/fgps/",
        "logo": "https://encrypted-tbn2.gstatic.com/favicon-tbn?q=tbn:ANd9GcS_mDfJIg_rnjz21iR8FusOKVEXvVIiA-75CTo2W2-sI2qE6ostf4cDLy__KgU7p6j5H6qkYP9c1yefmjXdqXrlcrn42fsPCfAlyCZDyPivGq2Luyw4ywFD8Q",
        "source": "Arts Incorporated",
        "image": "https://encrypted-tbn2.gstatic.com/images?q=tbn:ANd9GcTPfkm0GAi--1NuzfHwVOBBGRUoQvIuQIeTV6G8cOOVVsWh-Z9V",
        "image_url": "https://encrypted-tbn2.gstatic.com/images?q=tbn:ANd9GcTPfkm0GAi--1NuzfHwVOBBGRUoQvIuQIeTV6G8cOOVVsWh-Z9V",
        "rank": 31,
        "global_rank": 31
      },
      {
        "title": "Apps Channels | TV Apps | Roku Channel Store | Roku",
        "link": "https://channelstore.roku.com/browse/apps",
        "logo": "https://encrypted-tbn0.gstatic.com/favicon-tbn?q=tbn:ANd9GcSO_kezB5kMQoD9_s3N-QRanlvx8SnyVdj4oVz-z-YMqBY42JynrtZZjT8A7Y6s6CZXzmwsRDriFFretsc90DQaj3mxyyki3ZZE7zOfPSi0OUSyI2c-lr3XTmo",
        "source": "Roku",
        "image": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcR-0RyHs8e9iZZ2WURifM75lBtdqOWoDlQT8RGPCju-gJ9oKlcw",
        "image_url": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcR-0RyHs8e9iZZ2WURifM75lBtdqOWoDlQT8RGPCju-gJ9oKlcw",
        "rank": 32,
        "global_rank": 32
      },
      {
        "title": "Church Online — Littleton Church of Christ",
        "link": "https://www.littletonchurch.org/churchonline",
        "logo": "https://encrypted-tbn3.gstatic.com/favicon-tbn?q=tbn:ANd9GcQmfVipbq7rQtwPoqC4Po-xMH3P5qM5wg-EiVrEzIM2YuYZi43HsxiThXF45lTkdaYGMxPX9S2W8IVzVEU9fT930n6iskBckvsKR2IypAVZNdYDIvPFY6v82FNF3A",
        "source": "Littleton Church of Christ",
        "image": "https://encrypted-tbn2.gstatic.com/images?q=tbn:ANd9GcQWWCUZZ6WNLcZiywey8g4QDw2H7naK4fL7-G7NAmYDymOd8ZFd",
        "image_url": "https://encrypted-tbn2.gstatic.com/images?q=tbn:ANd9GcQWWCUZZ6WNLcZiywey8g4QDw2H7naK4fL7-G7NAmYDymOd8ZFd",
        "rank": 33,
        "global_rank": 33
      },
      {
        "title": "services — New Horizons Fellowship Church",
        "link": "https://www.nhfchurch.com/services",
        "logo": "https://encrypted-tbn0.gstatic.com/favicon-tbn?q=tbn:ANd9GcTx3EZkS6f0vTYrOCdoVKZ0ixnXJfk3j5vGiEvhGHSQu_S0tK-En_lsD39BVN-vCPey0Az03DUsK682x59bi7rV2Ak9QaYX15hZYCqn6_QGaKllETzKFw",
        "source": "nhfchurch.com",
        "image": "https://encrypted-tbn2.gstatic.com/images?q=tbn:ANd9GcSd-3Ystky8B46WBC0gNQABC8vpOxd9wmxTIUeTIBkExCpwHtET",
        "image_url": "https://encrypted-tbn2.gstatic.com/images?q=tbn:ANd9GcSd-3Ystky8B46WBC0gNQABC8vpOxd9wmxTIUeTIBkExCpwHtET",
        "rank": 34,
        "global_rank": 34
      },
      {
        "title": "The differences between RTK and PPK. Which method is best ...",
        "link": "https://www.ardusimple.com/ppk-vs-rtk/",
        "logo": "https://encrypted-tbn1.gstatic.com/favicon-tbn?q=tbn:ANd9GcTNV33vg9eOKdK3IItijTo0CjIoVAK2c9OzzYXzVXS1gtbyE61651a9drsxjJW2yC0K7rfttJXAP3g7_LZ0wmwPHQOmepn9z-zIMHJDGlgrijHfNKFESgc",
        "source": "ArduSimple",
        "image": "https://encrypted-tbn1.gstatic.com/images?q=tbn:ANd9GcS0cxDcJbc9ypZFOS_APjj_8Xzy-gGHG-wbSV_WR0Wn0-tqUAVf",
        "image_url": "https://encrypted-tbn1.gstatic.com/images?q=tbn:ANd9GcS0cxDcJbc9ypZFOS_APjj_8Xzy-gGHG-wbSV_WR0Wn0-tqUAVf",
        "rank": 35,
        "global_rank": 35
      },
      {
        "title": "Kristeen Garcia - Google | LinkedIn",
        "link": "https://www.linkedin.com/in/kristeen-garcia-6879a73b",
        "logo": "https://encrypted-tbn3.gstatic.com/favicon-tbn?q=tbn:ANd9GcTFMvFisG5Yfyq07VS0hk1otTr6uQvufSrlgYLzmBkZlxd7MQh66ZmKRUOdwfXrertN7RslYSLWGQCDyxLn3JsHLob5z5LPzTRUUQlVmSHaBnVJlJa8",
        "source": "LinkedIn",
        "image": "https://encrypted-tbn2.gstatic.com/images?q=tbn:ANd9GcQTy_qmt5vLpWNHYFG0-Lswj8W_w9tqvcuXY9-9zmjyLrBEa_5h",
        "image_url": "https://encrypted-tbn2.gstatic.com/images?q=tbn:ANd9GcQTy_qmt5vLpWNHYFG0-Lswj8W_w9tqvcuXY9-9zmjyLrBEa_5h",
        "rank": 36,
        "global_rank": 36
      },
      {
        "title": "YouTube Logo (2017-current) - YouTube",
        "link": "https://www.youtube.com/watch?v=qGkE0wz2dwY",
        "logo": "https://encrypted-tbn0.gstatic.com/favicon-tbn?q=tbn:ANd9GcQHQslzHLLyLc_qne5jxn7JocidlmUPyegZ8ojX3WVlorFk8BxW9a3vJWjDzN99UHVTqSaNBj_-6XykhxuVQfF3Ye7xScSWSuc2QHXi0a12CkVwBmo",
        "source": "YouTube",
        "image": "https://encrypted-tbn3.gstatic.com/images?q=tbn:ANd9GcSrIsvSRQmUafGp12uSG_RsufFOOqUxiuk1fYHDoW5gUqWAzpUz",
        "image_url": "https://encrypted-tbn3.gstatic.com/images?q=tbn:ANd9GcSrIsvSRQmUafGp12uSG_RsufFOOqUxiuk1fYHDoW5gUqWAzpUz",
        "rank": 37,
        "global_rank": 37
      },
      {
        "title": "YouTube's Checks to Warn Creators About Copyright Issues ...",
        "link": "https://ottverse.com/youtube-checks-warn-creators-about-copyright-issues/",
        "logo": "https://encrypted-tbn2.gstatic.com/favicon-tbn?q=tbn:ANd9GcQV3QA33hwGlp-HOrq6qCTu4V6QtzpxE8W62b4_TiSVunAN06tPoZW18UhkT5wOHmoEx5PlHrrZjin1Jl1x4ad_9aAYWSZe79fxVLSv4UJHaJ8",
        "source": "OTTVerse",
        "image": "https://encrypted-tbn2.gstatic.com/images?q=tbn:ANd9GcQ4tiYPe8b5sDGi8ePUF7WnAyOgV0ZcmTYWZBsgXYT-fq0M7m6J",
        "image_url": "https://encrypted-tbn2.gstatic.com/images?q=tbn:ANd9GcQ4tiYPe8b5sDGi8ePUF7WnAyOgV0ZcmTYWZBsgXYT-fq0M7m6J",
        "rank": 38,
        "global_rank": 38
      },
      {
        "title": "Streaming — Circa Blue",
        "link": "http://www.circa-blue.com/streaming",
        "logo": "https://encrypted-tbn0.gstatic.com/favicon-tbn?q=tbn:ANd9GcTt3fNIjA-fl6fHJU_Tgl1Fk56_swi_Ij-_JFF5erPd7uzyCKFJy9ns5E9-tjhfWsQHN3FR47EQtgit-UWbLwsbIdRRNp-iQH2AC4L7nscMj3e-XADIgw",
        "source": "Circa Blue",
        "image": "https://encrypted-tbn3.gstatic.com/images?q=tbn:ANd9GcSi2nZFN-lVelw1BqLmLlBvH9w-6upuwyZXJ-NhZkAGPmy-3v77",
        "image_url": "https://encrypted-tbn3.gstatic.com/images?q=tbn:ANd9GcSi2nZFN-lVelw1BqLmLlBvH9w-6upuwyZXJ-NhZkAGPmy-3v77",
        "rank": 39,
        "global_rank": 39
      },
      {
        "title": "YouTube Logo and the history of the company | LogoMyWay",
        "link": "https://blog.logomyway.com/youtube-logo/",
        "logo": "https://encrypted-tbn3.gstatic.com/favicon-tbn?q=tbn:ANd9GcRDhnhnZAw_dtHXVlyEHDgNsfsuCdE9Olv5SxsSbMitiTsa_ufALNgLS0r4eDvmSP6uhnM9oqlRWXEJ_l9x6g2BULG9lnkCwz9AgRvI15F7QmsEY641VQc",
        "source": "LogoMyWay",
        "image": "https://encrypted-tbn2.gstatic.com/images?q=tbn:ANd9GcQpI8R30EVrYnnmV0b5mTFM56JDvDTaPIir8iK3Qcoo9Ad4eu1Q",
        "image_url": "https://encrypted-tbn2.gstatic.com/images?q=tbn:ANd9GcQpI8R30EVrYnnmV0b5mTFM56JDvDTaPIir8iK3Qcoo9Ad4eu1Q",
        "rank": 40,
        "global_rank": 40
      },
      {
        "title": "Video Gallery — Hay Street United Methodist Church",
        "link": "https://www.haystreetchurch.org/video-gallery",
        "logo": "https://encrypted-tbn0.gstatic.com/favicon-tbn?q=tbn:ANd9GcQ3pXOvQSC3hZs5EWZ0GtX4OOH7IrL_oUiE-ZB9RBOWZH5-j0fd3YogXOtepk9iG8rzsY0NZvIyPgFkTQjVLiCO78bTCZgDveUS_aRdGyO2ue8T9dL1qUwUk2wXaA",
        "source": "Hay Street United Methodist Church",
        "image": "https://encrypted-tbn2.gstatic.com/images?q=tbn:ANd9GcQhO-_k6w9u19ktOabB7m6miYtUyUo_q5yhx1wDAy51XGgj1gUI",
        "image_url": "https://encrypted-tbn2.gstatic.com/images?q=tbn:ANd9GcQhO-_k6w9u19ktOabB7m6miYtUyUo_q5yhx1wDAy51XGgj1gUI",
        "rank": 41,
        "global_rank": 41
      },
      {
        "title": "Titanium Exhaust Shop USA & Supercar Exhaust Fabrication ...",
        "link": "https://www.juggernautmotorsports.com/contact-us",
        "logo": "https://encrypted-tbn1.gstatic.com/favicon-tbn?q=tbn:ANd9GcR8hgMBnSvz0patcT-KaUUmbTuH8f3sF83fa2jAOmFcrLOiOE6fT5HmQjPzlbF6Np1BGYRy6orYGanCsOolZ3U9jKBDL2SugPBWgDoKPDoycWlcMK9NgAeZKoHLFqsV3fY9_Q",
        "source": "Juggernaut Motorsports",
        "image": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcQ-6pPnPTwM0a4_gapWHEGKYYe7bU38hPSJcYBf3ozmr1kUgg-O",
        "image_url": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcQ-6pPnPTwM0a4_gapWHEGKYYe7bU38hPSJcYBf3ozmr1kUgg-O",
        "rank": 42,
        "global_rank": 42
      },
      {
        "title": "Creative Works – Thaddeus Patrick",
        "link": "https://thaddeusthought.com/creative-works/",
        "logo": "https://encrypted-tbn0.gstatic.com/favicon-tbn?q=tbn:ANd9GcR9H-Uc02qgJl7WDZEQsH1N02jvcPWlLdbOlHlS7Z30I-bEHZ5h0xv93j6OLjoC_ItqzSJ0f6PGdr0SLYhHLgpH2VpVDiQW8wq1UoQMMISLxmgHL5BtXtwA",
        "source": "thaddeusthought.com",
        "image": "https://encrypted-tbn2.gstatic.com/images?q=tbn:ANd9GcQKG7fqC0d46Ny6wd_aOxD6hTy-XddCy6qjZCzBnRRx2Gdb5ir0",
        "image_url": "https://encrypted-tbn2.gstatic.com/images?q=tbn:ANd9GcQKG7fqC0d46Ny6wd_aOxD6hTy-XddCy6qjZCzBnRRx2Gdb5ir0",
        "rank": 43,
        "global_rank": 43
      },
      {
        "title": "Media — Family Life",
        "link": "https://www.familylifechurch.me/media",
        "logo": "https://encrypted-tbn1.gstatic.com/favicon-tbn?q=tbn:ANd9GcTOeWZ9jZa4Ht-whsllIBvoXsJBLS7blh4YOJFlBAEXitJ1ud9HgUl2HMBGpBHv1zgp3rvxRZLYCYa7_8Fm_Y8_r6hoVGksZhCYdXNWLOzojOKIL1pRppR7kOHwWw",
        "source": "familylifechurch.me",
        "image": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcR-X_hzrtPVUIBHfI_iNjJPMJUOlZgOV5JdXXu2YE-S7ZssIZqA",
        "image_url": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcR-X_hzrtPVUIBHfI_iNjJPMJUOlZgOV5JdXXu2YE-S7ZssIZqA",
        "rank": 44,
        "global_rank": 44
      },
      {
        "title": "YouTube app gets a huge redesign - PhoneArena",
        "link": "https://www.phonearena.com/news/YouTube-app-gets-a-huge-redesign_id97544",
        "logo": "https://encrypted-tbn3.gstatic.com/favicon-tbn?q=tbn:ANd9GcTzmmUWlKNu2N6Vu_BuvybF4XRJzXoEG5iXXHkZMamhlXGoSgsSvpeu9hQP8FywapcndqFH07W0BWQ3DUcUTSh89ouuATT334y1FEgi-BAx9N93KNMDMNw",
        "source": "PhoneArena",
        "image": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcSQ0Itkcn1QdHRMaVdbpRl6vFhhmq__ZvwiBpWzUYix_VJl8ChG",
        "image_url": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcSQ0Itkcn1QdHRMaVdbpRl6vFhhmq__ZvwiBpWzUYix_VJl8ChG",
        "rank": 45,
        "global_rank": 45
      },
      {
        "title": "Current and Past sermons — Foundation Life Bible Church",
        "link": "https://www.foundationlbc.com/current-past-sermons",
        "logo": "https://encrypted-tbn3.gstatic.com/favicon-tbn?q=tbn:ANd9GcTq-xC-QB4eZoBS4DqluJM9tL3BYTkwcThRQQPPZHR4nIM0hEe30FxSMS0CeL22FQM45RzaTnM_HG0qwTWRqH0Sj9G37kr5WK1xlPPGsKCV-BVrAFJfrC71ivU",
        "source": "Foundation Life Bible Church",
        "image": "https://encrypted-tbn1.gstatic.com/images?q=tbn:ANd9GcTC53jUWWmtIi-G7SAhX7IJUuj08aRco0kzVt7hphJsvyGMwWZM",
        "image_url": "https://encrypted-tbn1.gstatic.com/images?q=tbn:ANd9GcTC53jUWWmtIi-G7SAhX7IJUuj08aRco0kzVt7hphJsvyGMwWZM",
        "rank": 46,
        "global_rank": 46
      },
      {
        "title": "YouTube unveils homepage redesign for desktop web, tablets ...",
        "link": "https://9to5google.com/2019/11/07/youtube-homepage-redesign/",
        "logo": "https://encrypted-tbn0.gstatic.com/favicon-tbn?q=tbn:ANd9GcSC2wBsL2-6jUZRgkl0ZXRz8gpwdpLpTxlI8h6mQjpB188cgO9NzasbxthOpq32FkvwGqDIJyinNbCcMaYDXi09_z9bCOou8fJppEVDHjq5_Lpv5g",
        "source": "9to5Google",
        "image": "https://encrypted-tbn3.gstatic.com/images?q=tbn:ANd9GcQjg6NW8e4I6ISrW--CRXep5kxRkO1B7PqkZCEu7ESWkaK7rKIX",
        "image_url": "https://encrypted-tbn3.gstatic.com/images?q=tbn:ANd9GcQjg6NW8e4I6ISrW--CRXep5kxRkO1B7PqkZCEu7ESWkaK7rKIX",
        "rank": 47,
        "global_rank": 47
      },
      {
        "title": "YouTube Logo (2018-2021 #2) - YouTube",
        "link": "https://www.youtube.com/watch?v=xtL7yvRndCc",
        "logo": "https://encrypted-tbn0.gstatic.com/favicon-tbn?q=tbn:ANd9GcQHQslzHLLyLc_qne5jxn7JocidlmUPyegZ8ojX3WVlorFk8BxW9a3vJWjDzN99UHVTqSaNBj_-6XykhxuVQfF3Ye7xScSWSuc2QHXi0a12CkVwBmo",
        "source": "YouTube",
        "image": "https://encrypted-tbn1.gstatic.com/images?q=tbn:ANd9GcTm3CC34QLpm3ysWo1wybCF78VXBI065JHZXMqApDxrdTV9XhX9",
        "image_url": "https://encrypted-tbn1.gstatic.com/images?q=tbn:ANd9GcTm3CC34QLpm3ysWo1wybCF78VXBI065JHZXMqApDxrdTV9XhX9",
        "rank": 48,
        "global_rank": 48
      },
      {
        "title": "Contact - Floorotex : Floorotex",
        "link": "https://www.floorotex.com/contact/",
        "logo": "https://encrypted-tbn1.gstatic.com/favicon-tbn?q=tbn:ANd9GcT7-TOxoo2JACiBhQ1IAhyD0w5Dad-Ait8UJ-eSRUDY6ekkFnjPALCvxXAU96xjtKYDQURiYt4Q7_uuABwt9-Vhv4QfKHqJMXzZlVDFAJBqCpP9sz_ZUg",
        "source": "Floorotex",
        "image": "https://encrypted-tbn1.gstatic.com/images?q=tbn:ANd9GcQu7YMOulaVrpBem_YLg7z8UJY34rCTQtTYuhrZy9L_L1RQFtcX",
        "image_url": "https://encrypted-tbn1.gstatic.com/images?q=tbn:ANd9GcQu7YMOulaVrpBem_YLg7z8UJY34rCTQtTYuhrZy9L_L1RQFtcX",
        "rank": 49,
        "global_rank": 49
      },
      {
        "title": "Solved: HubSpot Community - Videos in blogs - upload file or ...",
        "link": "https://community.hubspot.com/t5/Blog-Website-Page-Publishing/Videos-in-blogs-upload-file-or-embed-YouTube-video-Which-is/m-p/206849",
        "logo": "https://encrypted-tbn1.gstatic.com/favicon-tbn?q=tbn:ANd9GcT0ejhaBcqcekAURVnne4Gi4GZgSvgA2EKTPrErARZWejRQImvTgl0UKyuTJRF2DIUWx4D_VU2wpGQZDaBP5zJzigVgGNBIgqB9-J-9GrxdEe0CSe5DlCD19sI",
        "source": "HubSpot",
        "image": "https://encrypted-tbn1.gstatic.com/images?q=tbn:ANd9GcQI4GdPyH4qaXU1S0cQEEGxPqc2UqV2Ng6AtVEDdlcOjy3GCBsn",
        "image_url": "https://encrypted-tbn1.gstatic.com/images?q=tbn:ANd9GcQI4GdPyH4qaXU1S0cQEEGxPqc2UqV2Ng6AtVEDdlcOjy3GCBsn",
        "rank": 50,
        "global_rank": 50
      },
      {
        "title": "YouTube Ident NEW August 2017 - YouTube",
        "link": "https://www.youtube.com/watch?v=ceA2XVoh0Z4",
        "logo": "https://encrypted-tbn0.gstatic.com/favicon-tbn?q=tbn:ANd9GcQHQslzHLLyLc_qne5jxn7JocidlmUPyegZ8ojX3WVlorFk8BxW9a3vJWjDzN99UHVTqSaNBj_-6XykhxuVQfF3Ye7xScSWSuc2QHXi0a12CkVwBmo",
        "source": "YouTube",
        "image": "https://encrypted-tbn1.gstatic.com/images?q=tbn:ANd9GcRRTAfBYG-g4MIQVwrdCFHpejrjpVW8cIrQO1Zs1NhiT9ugg7Vg",
        "image_url": "https://encrypted-tbn1.gstatic.com/images?q=tbn:ANd9GcRRTAfBYG-g4MIQVwrdCFHpejrjpVW8cIrQO1Zs1NhiT9ugg7Vg",
        "rank": 51,
        "global_rank": 51
      },
      {
        "title": "Oakland Woods Baptist Church Clarkston, MI 48346 | SERMONS",
        "link": "http://oaklandwoodschurch.com/sermons",
        "logo": "https://encrypted-tbn2.gstatic.com/favicon-tbn?q=tbn:ANd9GcTXfJE8ouK2vMdX69h7N9hTKqb3Iwwv_tiR6Qy7yMpvk-fdv8p7Kerkm5O2CiIXIN2ofBE1QylpSaJmJ6jyv2IrSVNAIloIRCQA5al_ZZ5Ys0JcdmsC9wSF5uE",
        "source": "Oakland Woods Baptist Church",
        "image": "https://encrypted-tbn1.gstatic.com/images?q=tbn:ANd9GcTNV6lCytXThIrG4j-8UnGh3luZqr6RFmPLEFz3Q1zk6hZl8OL6",
        "image_url": "https://encrypted-tbn1.gstatic.com/images?q=tbn:ANd9GcTNV6lCytXThIrG4j-8UnGh3luZqr6RFmPLEFz3Q1zk6hZl8OL6",
        "rank": 52,
        "global_rank": 52
      },
      {
        "title": "How to Sign Up for YouTube TV - YouTube",
        "link": "https://www.youtube.com/watch?v=Qw_8AEoy59o",
        "logo": "https://encrypted-tbn0.gstatic.com/favicon-tbn?q=tbn:ANd9GcQHQslzHLLyLc_qne5jxn7JocidlmUPyegZ8ojX3WVlorFk8BxW9a3vJWjDzN99UHVTqSaNBj_-6XykhxuVQfF3Ye7xScSWSuc2QHXi0a12CkVwBmo",
        "source": "YouTube",
        "image": "https://encrypted-tbn1.gstatic.com/images?q=tbn:ANd9GcSGXVl_lm2UZWqLNkC80N2ZUZlVjMaQzdQaePReyiDB3XDRdz3v",
        "image_url": "https://encrypted-tbn1.gstatic.com/images?q=tbn:ANd9GcSGXVl_lm2UZWqLNkC80N2ZUZlVjMaQzdQaePReyiDB3XDRdz3v",
        "rank": 53,
        "global_rank": 53
      },
      {
        "title": "Elite Recognition Programs Use Our Bespoke E-Commerce Sites",
        "link": "https://societyawards.com/pages/client-retail-stores",
        "logo": "https://encrypted-tbn3.gstatic.com/favicon-tbn?q=tbn:ANd9GcRYk1npGvp5ODOp9brtfx6w50k7MYAMedVhazQ4WB-vvl9K85IsRsixZ9GpHW2te6FBzzL5-bKVIvXia1GKQyN9conp9AtuYgZYX_gwZXP9sagKRQtuSQ",
        "source": "Society Awards",
        "image": "https://encrypted-tbn1.gstatic.com/images?q=tbn:ANd9GcS4qAmp-7hc-YaD1gpl4DLD6PXSdtWO2CkVx1E5PApu9FPPX31U",
        "image_url": "https://encrypted-tbn1.gstatic.com/images?q=tbn:ANd9GcS4qAmp-7hc-YaD1gpl4DLD6PXSdtWO2CkVx1E5PApu9FPPX31U",
        "rank": 54,
        "global_rank": 54
      },
      {
        "title": "Grace Baptist Church, Evansville, Indiana - Livestream",
        "link": "https://gbcevansville.org/livestream",
        "logo": "https://encrypted-tbn1.gstatic.com/favicon-tbn?q=tbn:ANd9GcRV4NguZWfiQ6mFl6KYjn9wcq58bKAdpmD9dNoPp05Lwcfb5jcopqg5RfY4SoDPSDetllVbeRuefoV9gSz460bLOSoP0QV8A2Wl319Xah8QJeRFQsT_xg",
        "source": "Grace Baptist Church, Evansville, Indiana",
        "image": "https://encrypted-tbn2.gstatic.com/images?q=tbn:ANd9GcS-YNqtRd2r0dX-jAR5XulC-Ohw3KmUPTD4xSa51-t3oirJR64p",
        "image_url": "https://encrypted-tbn2.gstatic.com/images?q=tbn:ANd9GcS-YNqtRd2r0dX-jAR5XulC-Ohw3KmUPTD4xSa51-t3oirJR64p",
        "rank": 55,
        "global_rank": 55
      },
      {
        "title": "Home - Lee Elci",
        "link": "https://leeelci.com/",
        "logo": "https://encrypted-tbn3.gstatic.com/favicon-tbn?q=tbn:ANd9GcSHzFCDKQSmNCwYFbcv_DuBQL5I_58V2XjhA7XXKwCjXFJAlHo9X8hb9DNhViTlrFhg5-BD3W4Ol5DeDs9KsmrtYa98y-SEmu6Ic3fTLWSxiA",
        "source": "leeelci.com",
        "image": "https://encrypted-tbn1.gstatic.com/images?q=tbn:ANd9GcQuqb4DjbLh83llruMEH1J3CjUX6x_e_P44LRIf88dlY6q2eUeH",
        "image_url": "https://encrypted-tbn1.gstatic.com/images?q=tbn:ANd9GcQuqb4DjbLh83llruMEH1J3CjUX6x_e_P44LRIf88dlY6q2eUeH",
        "rank": 56,
        "global_rank": 56
      },
      {
        "title": "Trickshots Yoodle playing now on the YouTube homepage ...",
        "link": "https://www.instagram.com/p/C0flYK7LjUn/",
        "logo": "https://encrypted-tbn3.gstatic.com/favicon-tbn?q=tbn:ANd9GcSpoKX-MM8KwYvjLm-JRx4G0Kwl8RLkE48NjkNQo2Gq3SC32GSp-nb0Bv1Gwdg0bIZuT7qIQcsQnlAbeKhfDsUARVp1OzzHay_AKGuFGTR9Of3S2pacaw",
        "source": "Instagram",
        "image": "https://encrypted-tbn1.gstatic.com/images?q=tbn:ANd9GcQCZEUC7yeNkzodt4yVdRTth4dYyv7WmfQa9DLsxppGav-PHyna",
        "image_url": "https://encrypted-tbn1.gstatic.com/images?q=tbn:ANd9GcQCZEUC7yeNkzodt4yVdRTth4dYyv7WmfQa9DLsxppGav-PHyna",
        "rank": 57,
        "global_rank": 57
      },
      {
        "title": "Sermons - St. John Lutheran Church",
        "link": "https://www.stjohnclarinda.org/page/sermons",
        "logo": "https://encrypted-tbn0.gstatic.com/favicon-tbn?q=tbn:ANd9GcSvb-FwLr9PmStwWcCqR6UDm_JcypU8n6xD6QyIqQ7-Xxct9mPocyLWLDKh8IRG8bHWfrSkzaism9ja6OTui6AGTNCYIeDDsh2K3TUO7JFzQZAbaajA22O2gXzY",
        "source": "stjohnclarinda.org",
        "image": "https://encrypted-tbn3.gstatic.com/images?q=tbn:ANd9GcTMeSkAm2H_pzdGPDEwyLH0n2dywTfg3evBf8EQfhZK0loy4q-X",
        "image_url": "https://encrypted-tbn3.gstatic.com/images?q=tbn:ANd9GcTMeSkAm2H_pzdGPDEwyLH0n2dywTfg3evBf8EQfhZK0loy4q-X",
        "rank": 58,
        "global_rank": 58
      },
      {
        "title": "Audio",
        "link": "https://brendaportman.com/audio",
        "logo": "https://encrypted-tbn3.gstatic.com/favicon-tbn?q=tbn:ANd9GcRPjf6QxgmeUGa05T8HdECxJNNlljUS99TcB9GpPhQPUt0tiH_f9DcBpWKe8SrSR0ytd9QHKXFz-FZ0baurTnTM-LXGqzJgNnshlSal0c0GLOELKYENCw",
        "source": "Brenda Portman",
        "image": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcRE25aYMxpbO5iS_s7uFs8vAHPekYHm0rLFDBJytzIStBePD0mH",
        "image_url": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcRE25aYMxpbO5iS_s7uFs8vAHPekYHm0rLFDBJytzIStBePD0mH",
        "rank": 59,
        "global_rank": 59
      },
      {
        "title": "New Jerusalem Baptist Church - Landover - Church",
        "link": "https://njbc-landover.org/",
        "logo": "https://encrypted-tbn3.gstatic.com/favicon-tbn?q=tbn:ANd9GcTZKZfvNGoD6tUxakhZrEH0P0WPV5gjubqX7FS8GYaOdRnnZU5kj_R54v1djk3YGM7CA72ole_O9Y-MMAZzPjGXoPouGFqC9J__tVFoKy3OCcDG0aKQxQ",
        "source": "njbc-landover.org",
        "image": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcSpJH4guqf7yMwpci0J7ebdCxdCq8n7-KO3s-hv7NPwYmwerjKw",
        "image_url": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcSpJH4guqf7yMwpci0J7ebdCxdCq8n7-KO3s-hv7NPwYmwerjKw",
        "rank": 60,
        "global_rank": 60
      }
    ]
  }
  ```
</ResponseExample>


# Products
Source: https://docs.brightdata.com/api-reference/serp/google-lens/products

Reference for the Bright Data Google Lens Products parameter. Refines queries and returns matching results as JSON or HTML. On port 44445.

```txt wrap theme={null}
https://lens.google.com/uploadbyurl?url=https%3A%2F%2Fwww.youtube.com%2Fimg%2Fdesktop%2Fyt_1200.png&brd_lens=products
```

## Parameters

<ParamField type="query">
  URL of image you want to search
</ParamField>

<ParamField type="string">
  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`).

  ```txt wrap theme={null}
  https://lens.google.com/uploadbyurl?url=https%3A%2F%2Fwww.youtube.com%2Fimg%2Fdesktop%2Fyt_1200.png&brd_lens=products
  ```
</ParamField>

<RequestExample>
  ```shell cURL highlight={6} theme={null}
    curl -X POST https://api.brightdata.com/request \
    --header "Content-Type: application/json" \
    --header "Authorization: Bearer API_KEY" \
    --data '{
      "zone": "serp_api1",
      "url": "https://lens.google.com/uploadbyurl?url=https%3A%2F%2Fwww.youtube.com%2Fimg%2Fdesktop%2Fyt_1200.png&brd_lens=products",
      "format": "raw"
    }'
  ```

  ```shell Native proxy highlight={4} theme={null}
  curl --proxy brd.superproxy.io:44445 \
    --proxy-user CUSTOMER_USERNAME:CUSTOMER_PASSWORD \
    --ssl-no-revoke \
    "https://lens.google.com/uploadbyurl?url=https%3A%2F%2Fwww.youtube.com%2Fimg%2Fdesktop%2Fyt_1200.png&brd_lens=products"
  ```

  ```js Node.js highlight={10} theme={null}
  (async () => {
    const response = await fetch('https://api.brightdata.com/request', {
      method: 'POST',
      headers: {
        'Content-Type': 'application/json',
        'Authorization': 'Bearer API_KEY'
      },
      body: JSON.stringify({
        zone: 'serp_api1',
        url: 'https://lens.google.com/uploadbyurl?url=https%3A%2F%2Fwww.youtube.com%2Fimg%2Fdesktop%2Fyt_1200.png&brd_lens=products',
        format: 'raw'
      })
    });
    
    const data = await response.text();
    console.log(data);
  })();
  ```

  ```python Python highlight={11} theme={null}
  import requests

  # API Configuration
  headers = {
      'Content-Type': 'application/json',
      'Authorization': 'Bearer API_KEY',
  }

  payload = {
      'zone': 'serp_api1',
      'url': 'https://lens.google.com/uploadbyurl?url=https%3A%2F%2Fwww.youtube.com%2Fimg%2Fdesktop%2Fyt_1200.png&brd_lens=products',
      'format': 'raw'
  }

  # Make the request
  response = requests.post(
      'https://api.brightdata.com/request', 
      json=payload, 
      headers=headers
  )

  print(response.text)
  ```
</RequestExample>

<ResponseExample>
  ```json 200 theme={null}
  {
    "general": {
      "language": "en-AR",
      "mode": "search",
      "type": "all"
    },
    "tabs": [
      {
        "name": "AI Mode",
        "link": "https://www.google.com/search?sca_esv=2dc65c8cbd5d287b&lns_surface=26&hl=en&udm=50&vsrid=CMKUncyTyreC-QEQAhgBIiRkODk3MGI4MC1jMTMzLTRjOTEtYjE4My1mYWMzMjdjMWFhOTMyBiICY2coCjjV7f7D9vySAw&vsint=CAIqDAoCCAcSAggKGAEgATojChYNAAAAPxUAAAA_HQAAgD8lAACAPzABEIAIGIAIJQAAgD8&lns_mode=un&source=lns.web.gsbubu&vsdim=1024,1024&gsessionid=iyuSUvhA6gPxqXtV7-kWdx271odwkq52yC_ZQadCLcsOiJt-udofqA&lsessionid=j-5aVB4uWbzMVnMov8kPD0zsJOqrvTRbwGvIZDr4E-UxmI7_r6L2NA&fbs=ADc_l-Yv0YTTwuvIVYRVntg99Yl4C2siJayzZyC50sFnWwRH6ow_bxUxJgqfeyXucYwXL8BodgQvcQKf4r6af6eJrUBEJPcPla2xArZ4O2zHdIqqQ1YVgeUF-eZ8YfKEFkJDuGVjK7bY&q=&aep=1&ntc=1&sa=X&ved=2ahUKEwiRuIDF9vySAxU7npUCHcrTGNsQ2J8OegQIDxAD"
      },
      {
        "name": "All",
        "type": "all",
        "selected": true
      },
      {
        "name": "Exact matches",
        "type": "exact_matches",
        "link": "https://www.google.com/search?sca_esv=2dc65c8cbd5d287b&lns_surface=26&hl=en&udm=48&vsrid=CMKUncyTyreC-QEQAhgBIiRkODk3MGI4MC1jMTMzLTRjOTEtYjE4My1mYWMzMjdjMWFhOTMyBiICY2coCjjV7f7D9vySAw&vsint=CAIqDAoCCAcSAggKGAEgATojChYNAAAAPxUAAAA_HQAAgD8lAACAPzABEIAIGIAIJQAAgD8&lns_mode=un&source=lns.web.gsbubu&vsdim=1024,1024&gsessionid=iyuSUvhA6gPxqXtV7-kWdx271odwkq52yC_ZQadCLcsOiJt-udofqA&lsessionid=j-5aVB4uWbzMVnMov8kPD0zsJOqrvTRbwGvIZDr4E-UxmI7_r6L2NA&vsrid=CMKUncyTyreC-QEQAhgBIiQ3ZTEzNGQ4Zi1hMTU2LTQ5ZmEtYmJiZC0zZWY2Yzc0MGMxNjQyBiICY2coCjjV7f7D9vySA1AA&q=&sa=X&ved=2ahUKEwiRuIDF9vySAxU7npUCHcrTGNsQs6gLegQIEhAB"
      },
      {
        "name": "Visual matches",
        "type": "visual_matches",
        "link": "https://www.google.com/search?sca_esv=2dc65c8cbd5d287b&lns_surface=26&hl=en&udm=44&vsrid=CMKUncyTyreC-QEQAhgBIiRkODk3MGI4MC1jMTMzLTRjOTEtYjE4My1mYWMzMjdjMWFhOTMyBiICY2coCjjV7f7D9vySAw&vsint=CAIqDAoCCAcSAggKGAEgATojChYNAAAAPxUAAAA_HQAAgD8lAACAPzABEIAIGIAIJQAAgD8&lns_mode=un&source=lns.web.gsbubu&vsdim=1024,1024&gsessionid=iyuSUvhA6gPxqXtV7-kWdx271odwkq52yC_ZQadCLcsOiJt-udofqA&lsessionid=j-5aVB4uWbzMVnMov8kPD0zsJOqrvTRbwGvIZDr4E-UxmI7_r6L2NA&q=&sa=X&ved=2ahUKEwiRuIDF9vySAxU7npUCHcrTGNsQs6gLegQIERAB"
      },
      {
        "name": "About this image",
        "type": "about",
        "link": "https://www.google.com/search/about-this-image?img=H4sIAAAAAAAAAAFMALP_IkoKSAjClJ3Mk8q3gvkBEAIYASIkZDg5NzBiODAtYzEzMy00YzkxLWIxODMtZmFjMzI3YzFhYTkzMgYiAmNnKAo41e3-w_b8kgNQAP3h16dMAAAA&sa=X&ved=2ahUKEwiRuIDF9vySAxU7npUCHcrTGNsQs6gLegQIExAB"
      },
      {
        "name": "Feedback",
        "link": "https://www.google.com#"
      }
    ],
    "images": [
      {
        "title": "YouTube | Memespedia | Fandom",
        "link": "https://meme.fandom.com/es/wiki/YouTube",
        "logo": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAACAAAA...",
        "source": "Fandom",
        "image": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAWwAAA...",
        "image_base64": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAWwAAA...",
        "rank": 1,
        "global_rank": 1
      },
      {
        "title": "App YouTube - App Store",
        "link": "https://apps.apple.com/us/app/youtube/id544007664?l=es-MX&platform=tv",
        "logo": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAACAAAA...",
        "source": "Apple",
        "image": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAATYAAA...",
        "image_base64": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAATYAAA...",
        "rank": 2,
        "global_rank": 2
      },
      {
        "title": "Archivo:YouTube Logo (2013-2017).svg - Wikipedia, la ...",
        "link": "https://es.wikipedia.org/wiki/Archivo:YouTube_Logo_(2013-2017).svg",
        "logo": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAACAAAA...",
        "source": "Wikipedia",
        "image": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAVcAAA...",
        "image_base64": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAVcAAA...",
        "rank": 3,
        "global_rank": 3
      },
      {
        "title": "YouTube se actualiza - YouTube",
        "link": "https://www.youtube.com/watch?v=F1nq3JfbFgQ",
        "logo": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAACAAAA...",
        "source": "YouTube",
        "image": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAQMAAA...",
        "image_base64": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAQMAAA...",
        "rank": 4,
        "global_rank": 4
      },
      {
        "title": "Universidad del Cine",
        "link": "https://ucine.edu.ar/actividades/youtube-summer-camp-2020",
        "logo": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAABkAAA...",
        "source": "Universidad del Cine",
        "image": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAUEAAA...",
        "image_base64": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAUEAAA...",
        "rank": 5,
        "global_rank": 5
      },
      {
        "title": "Qué logo de YouTube es mejor? : r/youtube",
        "link": "https://www.reddit.com/r/youtube/comments/1d4y2s0/which_youtube_logo_is_better/?tl=es-es",
        "logo": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAACAAAA...",
        "source": "Reddit",
        "image": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAd0AAA...",
        "image_base64": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAd0AAA...",
        "rank": 6,
        "global_rank": 6
      },
      {
        "title": "El nuevo negocio de YouTube",
        "link": "https://www.clarin.com/tecnologia/nuevo-negocio-youtube_0_BJVX94-cz.html",
        "logo": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAACAAAA...",
        "source": "Clarin.com",
        "image": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAUAAAA...",
        "image_base64": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAUAAAA...",
        "rank": 7,
        "global_rank": 7
      },
      {
        "title": "YouTube Latinoamérica - YouTube",
        "link": "https://www.youtube.com/channel/UCBrGE6cmFbcwzlwAyIDMGpw",
        "logo": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAACAAAA...",
        "source": "YouTube",
        "image": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAOEAAA...",
        "image_base64": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAOEAAA...",
        "rank": 8,
        "global_rank": 8
      },
      {
        "title": "2020 | Wiki YouTube Pedia | Fandom",
        "link": "https://youtube.fandom.com/es/wiki/2020",
        "logo": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAACAAAA...",
        "source": "Fandom",
        "image": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQABAAD/2w...",
        "image_base64": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQABAAD/2w...",
        "rank": 9,
        "global_rank": 9
      },
      {
        "title": "YouTube now second only to BBC as most popular media ...",
        "link": "https://www.bbc.co.uk/news/articles/c4gzvee78eqo",
        "logo": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAACAAAA...",
        "source": "BBC",
        "image": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQABAAD/2w...",
        "image_base64": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQABAAD/2w...",
        "rank": 10,
        "global_rank": 10
      },
      {
        "title": "Cómo usar y publicar los Cortos de YouTube con su beta, la ...",
        "link": "https://www.xataka.com/basics/como-usar-publicar-cortos-youtube-alternativa-a-tiktok",
        "logo": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAACAAAA...",
        "source": "Xataka",
        "image": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAWwAAA...",
        "image_base64": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAWwAAA...",
        "rank": 11,
        "global_rank": 11
      },
      {
        "title": "YouTube prueba los videos de calidad superior",
        "link": "https://www.iprofesional.com/tecnologia/278517-4k-internet-video-YouTube-prueba-los-videos-de-calidad-superior",
        "logo": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAACAAAA...",
        "source": "iProfesional",
        "image": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQABAAD/2w...",
        "image_base64": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQABAAD/2w...",
        "rank": 12,
        "global_rank": 12
      },
      {
        "title": "Diseño del logo de YouTube: historia y evolución | Turbologo",
        "link": "https://turbologo.com/es/blog/logotipo-de-youtube/",
        "logo": "https://encrypted-tbn0.gstatic.com/favicon-tbn?q=tbn:ANd9GcR6tUu-mAbS6Kcb50kBPqLT98Mp3NtABDtMpKcwLAfhbn1T5xdZLM64whLYXwy2bw2P60gTc7zIAhcjk6cfQA2RW3jRZeFq8_AwdrwVOIIXWp0A",
        "source": "Turbologo logo maker",
        "image": "https://encrypted-tbn2.gstatic.com/images?q=tbn:ANd9GcSN1CN7mcicZ-Uo5-OaUBUNJNB9F1E2h1okTubW7Q0-KLVWEAaH",
        "image_url": "https://encrypted-tbn2.gstatic.com/images?q=tbn:ANd9GcSN1CN7mcicZ-Uo5-OaUBUNJNB9F1E2h1okTubW7Q0-KLVWEAaH",
        "rank": 13,
        "global_rank": 13
      },
      {
        "title": "Últimas noticias de Videos virales | TN",
        "link": "https://tn.com.ar/tags/%2Fvideos-virales/",
        "logo": "https://encrypted-tbn3.gstatic.com/favicon-tbn?q=tbn:ANd9GcSJbU5ugKLEVJpAJhKG-Kpo0ZqLVY2ON4Wm5ybBFA5621Bgmq_nKNqPV_RJj9v6V_22fldVB78-4r1aW0t2r0iBRco8sthKzCKBqp9xlF4",
        "source": "TN",
        "image": "https://encrypted-tbn3.gstatic.com/images?q=tbn:ANd9GcSiA-hAINFCOeRB5x02QlA03ByvJb3X6DUGkU9TBb3ymCl1EhT2",
        "image_url": "https://encrypted-tbn3.gstatic.com/images?q=tbn:ANd9GcSiA-hAINFCOeRB5x02QlA03ByvJb3X6DUGkU9TBb3ymCl1EhT2",
        "rank": 14,
        "global_rank": 14
      },
      {
        "title": "A 20 años de la llegada de YouTube: la plataforma que ...",
        "link": "https://www.conclusion.com.ar/info-general/a-20-anos-de-la-llegada-de-youtube-la-plataforma-que-transformo-los-videos-caseros-en-una-profesion/02/2025/",
        "logo": "https://encrypted-tbn1.gstatic.com/favicon-tbn?q=tbn:ANd9GcQa-eLJd9_jHp81mqzGDa0ycAFBH9np6w9cd_qzY8ZwzNkXtPjg9RB02q8DHs5bvH-Hl9xkYc9PMeTGCb8tGrV7TWbF7fiivnn4L49H3ZC50Y-2Tx6vbrLz7Ys",
        "source": "Diario Digital Conclusión",
        "image": "https://encrypted-tbn1.gstatic.com/images?q=tbn:ANd9GcRf6tQ43gFnFLiqCk3k28LJCpFPdNcUCffhp97v5Ekn9zkAlWSI",
        "image_url": "https://encrypted-tbn1.gstatic.com/images?q=tbn:ANd9GcRf6tQ43gFnFLiqCk3k28LJCpFPdNcUCffhp97v5Ekn9zkAlWSI",
        "rank": 15,
        "global_rank": 15
      },
      {
        "title": "YouTube presenta su nuevo logotipo y un profundo rediseño de ...",
        "link": "https://www.outono.net/elentir/2017/08/29/youtube-presenta-su-nuevo-logotipo-y-un-profundo-rediseno-de-su-portal/",
        "logo": "https://encrypted-tbn1.gstatic.com/favicon-tbn?q=tbn:ANd9GcTOvB0_qpvIfTOqAnMDcCvH2Lc7LhVX0xg18uwBryjiPTd7iaXQs3WcgYY5nXHW01ApiD06O2FX82Qju-FCkt5WFXRrtmpk09eYCiGvEai1KiA_Ig",
        "source": "Contando Estrelas",
        "image": "https://encrypted-tbn1.gstatic.com/images?q=tbn:ANd9GcQT1uIGMKDvU8vJCs3gdq4AZ2H-CdD9xkEZI_jLwCsZjnyDVjuM",
        "image_url": "https://encrypted-tbn1.gstatic.com/images?q=tbn:ANd9GcQT1uIGMKDvU8vJCs3gdq4AZ2H-CdD9xkEZI_jLwCsZjnyDVjuM",
        "rank": 16,
        "global_rank": 16
      },
      {
        "title": "Qué tan grande es YouTube? Nadie lo sabe - The New York Times",
        "link": "https://www.nytimes.com/es/2019/07/28/espanol/youtube-ganancias-google.html",
        "logo": "https://encrypted-tbn2.gstatic.com/favicon-tbn?q=tbn:ANd9GcRszyNSCYR04WGtSoefBwhwwe0NZDJ2NRax9ELrHGpQtwbG2FlJEx0ypzELo9V6Wpi6bcLEWpUcrMTLpkhIptbuYuWkKpaRsx-z4E6t7l8zAoUPsCc",
        "source": "The New York Times",
        "image": "https://encrypted-tbn2.gstatic.com/images?q=tbn:ANd9GcQUrEBqelGhE2yFiY8Ndcoa4wMUkfjMt6iRo7yDD_MpIsB6S8jU",
        "image_url": "https://encrypted-tbn2.gstatic.com/images?q=tbn:ANd9GcQUrEBqelGhE2yFiY8Ndcoa4wMUkfjMt6iRo7yDD_MpIsB6S8jU",
        "rank": 17,
        "global_rank": 17
      },
      {
        "title": "Streaming: qué es esta nueva moda y con qué plataformas se hace",
        "link": "https://www.lacapital.com.ar/informacion-general/streaming-que-es-esta-nueva-moda-y-que-plataformas-se-hace-n2629027.html",
        "logo": "https://encrypted-tbn1.gstatic.com/favicon-tbn?q=tbn:ANd9GcRvjD9C8f1iRqlUM1tJLrVPgl_PPIIWkoEF07zoIMN5LpLiEaxDbVtC-xVQFSdv4R-fIvM2s1O1jBU8tcef0o8vFk5TsZN1CNQox-kgBM-IycO8Jak7Jxs7JQ",
        "source": "La Capital",
        "image": "https://encrypted-tbn2.gstatic.com/images?q=tbn:ANd9GcTZ8uRHP8tWztYzrUUFVoj3wbSZMpkc9mvnaY2ajphoiOfz6h86",
        "image_url": "https://encrypted-tbn2.gstatic.com/images?q=tbn:ANd9GcTZ8uRHP8tWztYzrUUFVoj3wbSZMpkc9mvnaY2ajphoiOfz6h86",
        "rank": 18,
        "global_rank": 18
      },
      {
        "title": "Hype, la nueva herramienta de Youtube para Creadores de ...",
        "link": "https://www.a24.com/trends/youtube-lanza-una-nueva-herramienta-ayudar-los-creadores-contenido-pocos-seguidores-n1359433",
        "logo": "https://encrypted-tbn3.gstatic.com/favicon-tbn?q=tbn:ANd9GcTNEcleeClkxVsgUZPqJalPF5C8B8W1QZ8C5ISiFMBneB3QVAH8gVIE7oeepN3M0YwNftP9a2WWndJXtA1wioUcNrQ4FuOEHZ33VDa9sHQqBw",
        "source": "a24.com",
        "image": "https://encrypted-tbn1.gstatic.com/images?q=tbn:ANd9GcQkdwfP5dHc06cUX4Blh36d_hB2UWA74ekM1TC8r0rjr6hHUyhv",
        "image_url": "https://encrypted-tbn1.gstatic.com/images?q=tbn:ANd9GcQkdwfP5dHc06cUX4Blh36d_hB2UWA74ekM1TC8r0rjr6hHUyhv",
        "rank": 19,
        "global_rank": 19
      },
      {
        "title": "Noticias de Youtube - El Destape",
        "link": "https://www.eldestapeweb.com/tag/youtube",
        "logo": "https://encrypted-tbn3.gstatic.com/favicon-tbn?q=tbn:ANd9GcT5tjXlL4a6_N6iDYuOuEOCT7-QaFXti9GFgpdxTjI4bgP7wngjc4FtUeCTozmraUbLLmBPlzgnksXM3dghB4kUuOCn5zUWGVG2bOMlqXLzLzafhzluL5b8PA",
        "source": "El Destape",
        "image": "https://encrypted-tbn2.gstatic.com/images?q=tbn:ANd9GcQA5_xQbWxlIeUWBe2g7YEIOYPwA2Ka10qMnusOqyQXedUtEEeB",
        "image_url": "https://encrypted-tbn2.gstatic.com/images?q=tbn:ANd9GcQA5_xQbWxlIeUWBe2g7YEIOYPwA2Ka10qMnusOqyQXedUtEEeB",
        "rank": 20,
        "global_rank": 20
      },
      {
        "title": "File:YouTube logo upside down.jpg - Wikipedia",
        "link": "https://en.wikipedia.org/wiki/File:YouTube_logo_upside_down.jpg",
        "logo": "https://encrypted-tbn2.gstatic.com/favicon-tbn?q=tbn:ANd9GcRLIcgPlYxOaoBg0MnSobLYyflrgF_RLdwAY09AXHWGy2jqWQnuIBNCY5I1BuzY7jeAJga0y0b9htBHe94i3Pg4B0NhHMNDVsmS-FVRKL014d-Xf6sX",
        "source": "Wikipedia",
        "image": "https://encrypted-tbn2.gstatic.com/images?q=tbn:ANd9GcSfrQHl2V53W7OwOig95s00ICt1v4hY4a7lZNd0b-uyTTtj5cGV",
        "image_url": "https://encrypted-tbn2.gstatic.com/images?q=tbn:ANd9GcSfrQHl2V53W7OwOig95s00ICt1v4hY4a7lZNd0b-uyTTtj5cGV",
        "rank": 21,
        "global_rank": 21
      },
      {
        "title": "La caída de YouTube: ¿qué pasó y por qué te quedaste sin videos?",
        "link": "https://www.iprofesional.com/tecnologia/448363-el-fin-de-youtube-que-paso-y-por-que-te-quedaste-sin-videos",
        "logo": "https://encrypted-tbn0.gstatic.com/favicon-tbn?q=tbn:ANd9GcQIY5tthJUk2HFe1X82Pc1B0p_xyfdGPejRT2hGeDXEDFRAuF8RVCRWPQt5nrBwptU1dRzDJgBPte6yFOPjtsvuy7XouJ8-B2k67KhrpfvD6r0Fbme2qD3nDg",
        "source": "iProfesional",
        "image": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcRfj_K55WxnGboVPK_VFDwHDF9MZ0FNYD0p9Q2vYUSJfRCJybbz",
        "image_url": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcRfj_K55WxnGboVPK_VFDwHDF9MZ0FNYD0p9Q2vYUSJfRCJybbz",
        "rank": 22,
        "global_rank": 22
      },
      {
        "title": "20.000 suscriptores en YouTube y el cambio que vi en la ...",
        "link": "https://www.sirchandler.com.ar/2018/07/20-000-suscriptores-en-youtube-y-el-cambio-que-vi-en-la-plataforma/",
        "logo": "https://encrypted-tbn2.gstatic.com/favicon-tbn?q=tbn:ANd9GcQqyKc2GXt9Z8xgsjkPfcOvc-GGQ3Qm3sHdlU3-J5pYeDXwujlJfHlvXEr3ywQ9s9GOzHVtQ30LV-C9y1hZlbllIv59UL8c16K06k541VDTY-ShRCnzJQQMwVmf",
        "source": "Sir Chandler",
        "image": "https://encrypted-tbn3.gstatic.com/images?q=tbn:ANd9GcScbSRfuTNQ8N4vsN7i2r6ppN6SQ7gweiPa5reRISkXwxsGBHZ7",
        "image_url": "https://encrypted-tbn3.gstatic.com/images?q=tbn:ANd9GcScbSRfuTNQ8N4vsN7i2r6ppN6SQ7gweiPa5reRISkXwxsGBHZ7",
        "rank": 23,
        "global_rank": 23
      },
      {
        "title": "Cuánto paga YouTube por un video que supera las 1.000 ...",
        "link": "https://www.lagaceta.com.ar/nota/1060541/sociedad/cuanto-paga-youtube-video-supera-1000-visualizaciones.html",
        "logo": "https://encrypted-tbn0.gstatic.com/favicon-tbn?q=tbn:ANd9GcTuu44DyXS2om-cU2I3lzPmu90_4SScET0wWBL2Qdk5if5Ya545htgXwr7K__IJu5FA6Nid52A8QjMIQt0UmPy0o-HRf5_G0sSEFsdyxJNlB0UE7pIOgwt2",
        "source": "La Gaceta",
        "image": "https://encrypted-tbn2.gstatic.com/images?q=tbn:ANd9GcQNm9sZXv7dm8ucLqShCSrLwD6f0MP4FTzqwIqv_7D5pBsSctWu",
        "image_url": "https://encrypted-tbn2.gstatic.com/images?q=tbn:ANd9GcQNm9sZXv7dm8ucLqShCSrLwD6f0MP4FTzqwIqv_7D5pBsSctWu",
        "rank": 24,
        "global_rank": 24
      },
      {
        "title": "YouTube: el truco viral para resumir los videos y que es ...",
        "link": "https://www.ambito.com/tecnologia/youtube-el-truco-viral-resumir-los-videos-y-que-es-completamente-gratis-n6078103",
        "logo": "https://encrypted-tbn2.gstatic.com/favicon-tbn?q=tbn:ANd9GcRrvz5bLnZhSkk0pRUzYwvsBlv97yjyOcjNpDbJK1Ykl-rOWXS5YVVbeGarqUUFe8eN7Xb8Z7o_lPiwC8Ca6AexPxXuPeZPgeOuzRYgqHnpEf036g",
        "source": "Ambito",
        "image": "https://encrypted-tbn3.gstatic.com/images?q=tbn:ANd9GcQWj2v-hwFsJMx6lS8l19J1TVP03QB5rqRwZpBngX8MisOnyvAM",
        "image_url": "https://encrypted-tbn3.gstatic.com/images?q=tbn:ANd9GcQWj2v-hwFsJMx6lS8l19J1TVP03QB5rqRwZpBngX8MisOnyvAM",
        "rank": 25,
        "global_rank": 25
      },
      {
        "title": "21 ANIVERSARIO DE:\"YOUTUBE\" 14 de febrero de 2005, se lanzó ...",
        "link": "https://www.instagram.com/p/DUvidwzj0wh/",
        "logo": "https://encrypted-tbn3.gstatic.com/favicon-tbn?q=tbn:ANd9GcSpoKX-MM8KwYvjLm-JRx4G0Kwl8RLkE48NjkNQo2Gq3SC32GSp-nb0Bv1Gwdg0bIZuT7qIQcsQnlAbeKhfDsUARVp1OzzHay_AKGuFGTR9Of3S2pacaw",
        "source": "Instagram",
        "image": "https://encrypted-tbn2.gstatic.com/images?q=tbn:ANd9GcQT4N8A_ZfJasQcFUwjMciAzoSf7lVsH1hJ9oNLqks1Mi6Psbvr",
        "image_url": "https://encrypted-tbn2.gstatic.com/images?q=tbn:ANd9GcQT4N8A_ZfJasQcFUwjMciAzoSf7lVsH1hJ9oNLqks1Mi6Psbvr",
        "rank": 26,
        "global_rank": 26
      },
      {
        "title": "What is YouTube?",
        "link": "https://www.webwise.ie/parents/what-is-youtube/",
        "logo": "https://encrypted-tbn2.gstatic.com/favicon-tbn?q=tbn:ANd9GcSbLBrYqX4Z0t1sT5T5OU0dU6Fvo9atHPiaH8iMCrSjf5T6HovbHsmdOsi0EyUarD3VOBf91gWcD9zD6UooW24U6P9v-9hAL7DI5HNE9UQ5lM_Xvw",
        "source": "Webwise - Internet Safety",
        "image": "https://encrypted-tbn3.gstatic.com/images?q=tbn:ANd9GcQwO8Vfju8uGEWjkvVBJbZ-TFwjll0_nwfouGH5ZX0GP62kXokW",
        "image_url": "https://encrypted-tbn3.gstatic.com/images?q=tbn:ANd9GcQwO8Vfju8uGEWjkvVBJbZ-TFwjll0_nwfouGH5ZX0GP62kXokW",
        "rank": 27,
        "global_rank": 27
      },
      {
        "title": "Historia del logo de YouTube: evolución desde el 2005 hasta hoy",
        "link": "https://www.imprentaonline.net/blog/logo-youtube/",
        "logo": "https://encrypted-tbn3.gstatic.com/favicon-tbn?q=tbn:ANd9GcT1eWyufUIDauJkbZXSRQ1XN83wJwy0lqzrCCTC6XuIYz8x5rlXAOtKFwAWjroj04nnlbYVyVoCuZsyZ9-REe_y91pZVyFVgQgJBf-PToAm_dsNBE6zm_e_S470",
        "source": "Imprenta Online",
        "image": "https://encrypted-tbn3.gstatic.com/images?q=tbn:ANd9GcRg97a8CdqdCZmA0_cEVZ0yufqqkyJ4q4NI8dkPRjiLZ5q5767T",
        "image_url": "https://encrypted-tbn3.gstatic.com/images?q=tbn:ANd9GcRg97a8CdqdCZmA0_cEVZ0yufqqkyJ4q4NI8dkPRjiLZ5q5767T",
        "rank": 28,
        "global_rank": 28
      },
      {
        "title": "Últimas noticias de YouTube | TN",
        "link": "https://tn.com.ar/tags/youtube/",
        "logo": "https://encrypted-tbn3.gstatic.com/favicon-tbn?q=tbn:ANd9GcSJbU5ugKLEVJpAJhKG-Kpo0ZqLVY2ON4Wm5ybBFA5621Bgmq_nKNqPV_RJj9v6V_22fldVB78-4r1aW0t2r0iBRco8sthKzCKBqp9xlF4",
        "source": "TN",
        "image": "https://encrypted-tbn2.gstatic.com/images?q=tbn:ANd9GcSpQLoWP-Z8oXD4avRfZQh7PhGIQYWS-37zNUdfSf_A9ePF3eBh",
        "image_url": "https://encrypted-tbn2.gstatic.com/images?q=tbn:ANd9GcSpQLoWP-Z8oXD4avRfZQh7PhGIQYWS-37zNUdfSf_A9ePF3eBh",
        "rank": 29,
        "global_rank": 29
      },
      {
        "title": "Se cayó YouTube: qué pasó y cuándo vuelve - TyC Sports",
        "link": "https://www.tycsports.com/interes-general/se-cayo-youtube-que-paso-y-cuando-vuelve-id704724.html",
        "logo": "https://encrypted-tbn0.gstatic.com/favicon-tbn?q=tbn:ANd9GcQWBz2_p1S6liAJwp3r1Ghs4-CVkJ7uWrq2SN__qyJc0tZEaPV44tv2Y6mwXYKtx2_yVs4Bjk4yjKde1GcPDfxZu9DhPp6oKoZlx0-UOEFa3M4POWSZpw",
        "source": "TyC Sports",
        "image": "https://encrypted-tbn2.gstatic.com/images?q=tbn:ANd9GcRlq2yLRIJW5dykvjMHhoMGErZf-Rf4EwrMKi01OUM9fWirAgF_",
        "image_url": "https://encrypted-tbn2.gstatic.com/images?q=tbn:ANd9GcRlq2yLRIJW5dykvjMHhoMGErZf-Rf4EwrMKi01OUM9fWirAgF_",
        "rank": 30,
        "global_rank": 30
      },
      {
        "title": "YouTube para Nintendo Switch - Sitio Oficial de Nintendo ...",
        "link": "https://www.nintendo.com/es-ar/store/products/youtube-switch/",
        "logo": "https://encrypted-tbn2.gstatic.com/favicon-tbn?q=tbn:ANd9GcToBGjo96GmUCHevYIGmN-UpS53MeR2ZhzA3_OkIOo1c13GKN_eBvJl9QW6mzxeD5hTpJ-y6aDxlz1ebw2zFTwvBQpumpCdgwqbY9MRx5lDJF5Ae_Qe",
        "source": "Nintendo",
        "image": "https://encrypted-tbn1.gstatic.com/images?q=tbn:ANd9GcRTAm2QK0oWNamFEEaSAGn-YXfdVX2J0FgPq402JWb5mitzKB24",
        "image_url": "https://encrypted-tbn1.gstatic.com/images?q=tbn:ANd9GcRTAm2QK0oWNamFEEaSAGn-YXfdVX2J0FgPq402JWb5mitzKB24",
        "rank": 31,
        "global_rank": 31
      },
      {
        "title": "YouTube Creators (@YouTubeCreators) / Posts / X",
        "link": "https://x.com/YouTubeCreators",
        "logo": "https://encrypted-tbn0.gstatic.com/favicon-tbn?q=tbn:ANd9GcSofvqtbDtdUTZsANJSe_PTSgsuDSmzMNykD5ePbsMk3EyTY0EoF56jNp_rHuufm9BtNpZYsFhp9M6u-DLxqcg2x-FRa41-OCrNmA",
        "source": "X",
        "image": "https://encrypted-tbn1.gstatic.com/images?q=tbn:ANd9GcTpYm0h48xaRTDWgjq-VmSTCs-T0tZlf-TYLWaEkUFI6qXpuNBd",
        "image_url": "https://encrypted-tbn1.gstatic.com/images?q=tbn:ANd9GcTpYm0h48xaRTDWgjq-VmSTCs-T0tZlf-TYLWaEkUFI6qXpuNBd",
        "rank": 32,
        "global_rank": 32
      },
      {
        "title": "YouTube",
        "link": "https://www.youtube.com/watch?v=2rjtpWxRSP8",
        "logo": "https://encrypted-tbn0.gstatic.com/favicon-tbn?q=tbn:ANd9GcQHQslzHLLyLc_qne5jxn7JocidlmUPyegZ8ojX3WVlorFk8BxW9a3vJWjDzN99UHVTqSaNBj_-6XykhxuVQfF3Ye7xScSWSuc2QHXi0a12CkVwBmo",
        "source": "YouTube",
        "image": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcSIG8oSJsLuYZ6VU_Eza7vyti1F9pMnaPAiH3dGZTFw31zOVole",
        "image_url": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcSIG8oSJsLuYZ6VU_Eza7vyti1F9pMnaPAiH3dGZTFw31zOVole",
        "rank": 33,
        "global_rank": 33
      },
      {
        "title": "Microcurso: Aprendé a usar YouTube | Educ.ar, portal ...",
        "link": "https://www.educ.ar/recursos/157416/microcurso-aprende-a-usar-youtube",
        "logo": "https://encrypted-tbn0.gstatic.com/favicon-tbn?q=tbn:ANd9GcSOVQrKfBshEiz9Z856_AfmPDmFagGCjiOzhCABq_tWARw_V3Swe9UQ--NEMhYE9svYtsxkj7uMF6_da5l-Wv2u7D31b6g9mX46zIx5gRTFlQ",
        "source": "Educ.ar",
        "image": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcQeNFmvKVVqq7JAl6MKlh4tGJtUa9FKIFVuvY-nezCYqplh8zK8",
        "image_url": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcQeNFmvKVVqq7JAl6MKlh4tGJtUa9FKIFVuvY-nezCYqplh8zK8",
        "rank": 34,
        "global_rank": 34
      },
      {
        "title": "Youtube se cayó a nivel mundial: miles de usuarios ...",
        "link": "https://radiomitre.cienradios.com/mundo/youtube-se-cayo-a-nivel-mundial-miles-de-usuarios-reportaron-fallas-al-momento-de-utilizarlo/",
        "logo": "https://encrypted-tbn1.gstatic.com/favicon-tbn?q=tbn:ANd9GcRYud675uvJsE28w3xxp10rd9pH7gOnuLTTYzU4dGi6lCdPNYwND4rGytlEzec5Q-y_8iQJqlU-60XvQlS3h9eU4IfTGrtm0UP0lfajo9JpcKRTQViwduGXdBVDh3VE",
        "source": "Cienradios",
        "image": "https://encrypted-tbn2.gstatic.com/images?q=tbn:ANd9GcSC-OEaaBPYm-qsL_CPOkxHCZfzFGjA4K20GSOBWBCTPWvPLDZw",
        "image_url": "https://encrypted-tbn2.gstatic.com/images?q=tbn:ANd9GcSC-OEaaBPYm-qsL_CPOkxHCZfzFGjA4K20GSOBWBCTPWvPLDZw",
        "rank": 35,
        "global_rank": 35
      },
      {
        "title": "Por qué YouTube impulsa las herramientas de IA para ...",
        "link": "https://www.rionegro.com.ar/tecnologia/por-que-youtube-impulsa-las-herramientas-de-ia-para-creadores-de-videos/",
        "logo": "https://encrypted-tbn1.gstatic.com/favicon-tbn?q=tbn:ANd9GcQPXtmlbUUF-TvlAH5Rh72QkGVUM6wECTPLuYKur6oe3mcp55McLFWNN_jkc-nlmBnY2MWhf2DzSGRlAixfY1-avuOpHVRZwzHDt-MUJ25TD1t6UyR4Jg64",
        "source": "Diario Río Negro",
        "image": "https://encrypted-tbn3.gstatic.com/images?q=tbn:ANd9GcS2hujQa-2w3xZ-MMU9sDTVzjXj0cf5p3qoHmSU2sikaZCCDndk",
        "image_url": "https://encrypted-tbn3.gstatic.com/images?q=tbn:ANd9GcS2hujQa-2w3xZ-MMU9sDTVzjXj0cf5p3qoHmSU2sikaZCCDndk",
        "rank": 36,
        "global_rank": 36
      },
      {
        "title": "YouTube celebra su 20° Aniversario | PORTAL INFOBRANDSEN",
        "link": "https://www.infobrandsen.com.ar/2025/04/23/youtube-celebra-su-20-aniversario/",
        "logo": "https://encrypted-tbn1.gstatic.com/favicon-tbn?q=tbn:ANd9GcRiNs6yRqD0TYtn9LAUaMaY1Zy1t7g5VxE-BXsHy6RS6m-C-_4y6R7v11lvrpTDqeZCZySRpYVNK0gVd9y-gW7NCUuzwHRE03Jz2ZIuUAX5dlgSv3gN-DSXws6AyQ",
        "source": "Infobrandsen",
        "image": "https://encrypted-tbn2.gstatic.com/images?q=tbn:ANd9GcTMsPGpEn62QA4Mbp5b1w1BukB0845GFcxnabPIa_NNOti8mwbY",
        "image_url": "https://encrypted-tbn2.gstatic.com/images?q=tbn:ANd9GcTMsPGpEn62QA4Mbp5b1w1BukB0845GFcxnabPIa_NNOti8mwbY",
        "rank": 37,
        "global_rank": 37
      },
      {
        "title": "YouTube Recap 2025 en Argentina revela cuáles son los videos ...",
        "link": "https://www.clarin.com/tecnologia/youtube-recap-2025-argentina-revela-videos-creadores-vistos-viste_0_fANqjYaTe5.html",
        "logo": "https://encrypted-tbn3.gstatic.com/favicon-tbn?q=tbn:ANd9GcTjJ58r7L5G0jSZyHd6tQ8oeizM_cAj-DHZy-SaoLLYhvAQDSIqECAy16IlRKF3xQT5UZusZY-YYCzt7M2jBY3EmvAm6btP8u2jHqGK8NXvKUs8sA",
        "source": "Clarin.com",
        "image": "https://encrypted-tbn3.gstatic.com/images?q=tbn:ANd9GcRo-xxKoMUsaHCMxUjR952ic5dSOBDsfzbMy8gZZ5SZYSqs2RKU",
        "image_url": "https://encrypted-tbn3.gstatic.com/images?q=tbn:ANd9GcRo-xxKoMUsaHCMxUjR952ic5dSOBDsfzbMy8gZZ5SZYSqs2RKU",
        "rank": 38,
        "global_rank": 38
      },
      {
        "title": "Descubre vídeos de YouTube adecuados para familias ...",
        "link": "https://www.youtube.com/intl/ALL_es/kids/familyfriendly-videos/",
        "logo": "https://encrypted-tbn0.gstatic.com/favicon-tbn?q=tbn:ANd9GcQHQslzHLLyLc_qne5jxn7JocidlmUPyegZ8ojX3WVlorFk8BxW9a3vJWjDzN99UHVTqSaNBj_-6XykhxuVQfF3Ye7xScSWSuc2QHXi0a12CkVwBmo",
        "source": "YouTube",
        "image": "https://encrypted-tbn2.gstatic.com/images?q=tbn:ANd9GcREjZAOHqN4ntQCHnWupART1zemHPNxT-K6Vkhxa9GMMuNOZ9ER",
        "image_url": "https://encrypted-tbn2.gstatic.com/images?q=tbn:ANd9GcREjZAOHqN4ntQCHnWupART1zemHPNxT-K6Vkhxa9GMMuNOZ9ER",
        "rank": 39,
        "global_rank": 39
      },
      {
        "title": "YouTube actualizará tus videos antiguos a 4k usando IA: un ...",
        "link": "https://www.infobae.com/tecno/2025/10/30/youtube-actualizara-tus-videos-antiguos-a-4k-usando-ia-un-cambio-muy-favorable/",
        "logo": "https://encrypted-tbn3.gstatic.com/favicon-tbn?q=tbn:ANd9GcQDJSoti_tDfiR_vuZSDA_MJ_IjYOOlEmN7SbCZfohWPjZ_7d8VVr2r2xFglMDSqxYoST6tmoMREWvo1ShnVcRLcth-da1-O4UZ7xomdiLQCc_YdRs",
        "source": "Infobae",
        "image": "https://encrypted-tbn1.gstatic.com/images?q=tbn:ANd9GcTUThi_9UBd0ItPQTIKnvkraVPx_BE1UR5XoWu3TZ2EtF7-xb6B",
        "image_url": "https://encrypted-tbn1.gstatic.com/images?q=tbn:ANd9GcTUThi_9UBd0ItPQTIKnvkraVPx_BE1UR5XoWu3TZ2EtF7-xb6B",
        "rank": 40,
        "global_rank": 40
      },
      {
        "title": "Vector de Stock Youtube logo on a white background | Adobe Stock",
        "link": "https://stock.adobe.com/ar/images/youtube-logo-on-a-white-background/300389025",
        "logo": "https://encrypted-tbn2.gstatic.com/favicon-tbn?q=tbn:ANd9GcRmO_8sjV79Lvr80yZ9v1mjcRZDN1hZFi-kX0mYgHFcDxvZ4OuuaYwV5sxiW05Fr2yEjvT8RYkmpSI3x9KzYnAoAOZc8ty6wCgzyZMh0u3JrhgGpag",
        "source": "Adobe",
        "image": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcQjtKyF0z1Hck78_jgdXgYKBeedGXV1jWUKglS7pNRJlYkDBhrW",
        "image_url": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcQjtKyF0z1Hck78_jgdXgYKBeedGXV1jWUKglS7pNRJlYkDBhrW",
        "rank": 41,
        "global_rank": 41
      },
      {
        "title": "FM ALTAVOZ – FM 94.1",
        "link": "https://fmaltavozclasicos.ar/",
        "logo": "https://encrypted-tbn1.gstatic.com/favicon-tbn?q=tbn:ANd9GcSn4fhxjdfhpn6Du5HX7oa-73KWVr9C70IQjc0i7KwTi2IJ6ZHtb3oo0r_MFE16hjwiusvELJ2dXuTNA5h9Z7vuDdppuyueLD2mGgidraS3II1oKu9C-xVY5A",
        "source": "fm altavoz",
        "image": "https://encrypted-tbn2.gstatic.com/images?q=tbn:ANd9GcTFuO2Irn3aJOPN7atMv-J4SSfjdOYSMuNsNvO91ax44iaeRvlo",
        "image_url": "https://encrypted-tbn2.gstatic.com/images?q=tbn:ANd9GcTFuO2Irn3aJOPN7atMv-J4SSfjdOYSMuNsNvO91ax44iaeRvlo",
        "rank": 42,
        "global_rank": 42
      },
      {
        "title": "YouTube Premium - YouTube",
        "link": "https://www.youtube.com/premium?app=desktop&gl=MX&hl=es-419",
        "logo": "https://encrypted-tbn0.gstatic.com/favicon-tbn?q=tbn:ANd9GcQHQslzHLLyLc_qne5jxn7JocidlmUPyegZ8ojX3WVlorFk8BxW9a3vJWjDzN99UHVTqSaNBj_-6XykhxuVQfF3Ye7xScSWSuc2QHXi0a12CkVwBmo",
        "source": "YouTube",
        "image": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcRoA3XLRLlSu7GDeIM4mOo8n2IsC2MMXJTUWuPEhLl8-H8UQjAV",
        "image_url": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcRoA3XLRLlSu7GDeIM4mOo8n2IsC2MMXJTUWuPEhLl8-H8UQjAV",
        "rank": 43,
        "global_rank": 43
      },
      {
        "title": "Bienvenidos a nuestro nuevo canal de Youtube",
        "link": "https://convivir.org/2022/08/bienvenidos-a-nuestro-nuevo-canal-de-youtube/",
        "logo": "https://encrypted-tbn0.gstatic.com/favicon-tbn?q=tbn:ANd9GcRuyJeitZ-_zbSuk7V0aMlEZz31ZLzke2G4kPWJ3dGfy9aY3Mw4PGMgmJjtzOQgJUW0Z7yM6ZqhCJgu-rAVI2he9Jy3txyZttHqdhymeAlJj0Q",
        "source": "convivir.org",
        "image": "https://encrypted-tbn1.gstatic.com/images?q=tbn:ANd9GcSPTuiwSU2bu7guekjPAgE39vAcduX2aMm85k5GrZANTU4P-Xa6",
        "image_url": "https://encrypted-tbn1.gstatic.com/images?q=tbn:ANd9GcSPTuiwSU2bu7guekjPAgE39vAcduX2aMm85k5GrZANTU4P-Xa6",
        "rank": 44,
        "global_rank": 44
      },
      {
        "title": "Cómo superar a tu competencia en Youtube 2025 🚀",
        "link": "https://comprarvisitas.net/como-superar-a-tu-competencia-en-youtube/",
        "logo": "https://encrypted-tbn0.gstatic.com/favicon-tbn?q=tbn:ANd9GcQ7ZL0TitorxOOVxwsDP3WXZyeHp4FAZqSJnbUe8b_V9-QNUwp-0DR2Ad-bOKcpryp-10NC_Ae5quhY-mkQgZ7sfPTjxk2X4W-rLmYSrwNWD8FFHj__nNg",
        "source": "Comprarvisitas.net",
        "image": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcQbF2iyk4oG4zMb1WHxp6EUGPGUHL2UYktp6XSPjs2x_Ucui_Or",
        "image_url": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcQbF2iyk4oG4zMb1WHxp6EUGPGUHL2UYktp6XSPjs2x_Ucui_Or",
        "rank": 45,
        "global_rank": 45
      },
      {
        "title": "Ocho de cada diez argentinos afirman que YouTube es el ...",
        "link": "https://www.eltribuno.com/tecnologia/2024-1-6-17-1-0-ocho-de-cada-diez-argentinos-afirman-que-youtube-es-el-servicio-de-videos-que-mas-miran",
        "logo": "https://encrypted-tbn2.gstatic.com/favicon-tbn?q=tbn:ANd9GcTFlGm6kDo__eMV3uQ7Fl4TO20X1SIfFb8jDeOzXx7JFU_4sDnVnPwempbQsfLHzC57jbACV8HqopmZTUZRDXErYUhL9_Bw0lt9vE8Y-oZpQgx_4Zi6TQ",
        "source": "El Tribuno",
        "image": "https://encrypted-tbn1.gstatic.com/images?q=tbn:ANd9GcRAL4bCogkWpDQobugDeI1QMf0D3x_Bq6c9699iK3oWR_TO1FiQ",
        "image_url": "https://encrypted-tbn1.gstatic.com/images?q=tbn:ANd9GcRAL4bCogkWpDQobugDeI1QMf0D3x_Bq6c9699iK3oWR_TO1FiQ",
        "rank": 46,
        "global_rank": 46
      },
      {
        "title": "YouTube is giving you better control over what videos are on ...",
        "link": "https://www.xda-developers.com/youtube-better-control-over-what-videos-are-on-your-homepage/",
        "logo": "https://encrypted-tbn1.gstatic.com/favicon-tbn?q=tbn:ANd9GcRAME90RmDvZ7n5QF-g_fXA6hrG1UpK1yFStismLE2bPsvQ8NDeM_419lGa-XTsXWEQ7-TMRilzLDBgbo39QRarJ_dIvrWYKxo3Lc1KDOvngg4HxOqxV7yDSBqR",
        "source": "XDA",
        "image": "https://encrypted-tbn3.gstatic.com/images?q=tbn:ANd9GcRQic49NGU9caQSmutaO1b9OICmJ1yA74nHS4EBDblaazX9dnyE",
        "image_url": "https://encrypted-tbn3.gstatic.com/images?q=tbn:ANd9GcRQic49NGU9caQSmutaO1b9OICmJ1yA74nHS4EBDblaazX9dnyE",
        "rank": 47,
        "global_rank": 47
      },
      {
        "title": "Logotipo de YouTube YouTube es un sitio web para compartir ...",
        "link": "https://www.freepik.es/vector-premium/logotipo-youtube-youtube-es-sitio-web-compartir-videos_30873446.htm",
        "logo": "https://encrypted-tbn2.gstatic.com/favicon-tbn?q=tbn:ANd9GcQjfDgOxQ9diXs3nHxnVm0cOXUeN2KLO4fzw6694xmC8tFwgYIZ1Ukmss0xzHh9FeA4GBpeeiHWbiDUrO2skF2b_zaY-B9AW_w0lq9idE-UcYKVCQ",
        "source": "Freepik",
        "image": "https://encrypted-tbn2.gstatic.com/images?q=tbn:ANd9GcRFIr7apuuUboNA9BNNRXvFmDCqDqnq6y9Ns4jZl4gdHv2Xx39C",
        "image_url": "https://encrypted-tbn2.gstatic.com/images?q=tbn:ANd9GcRFIr7apuuUboNA9BNNRXvFmDCqDqnq6y9Ns4jZl4gdHv2Xx39C",
        "rank": 48,
        "global_rank": 48
      },
      {
        "title": "Shannon Ong - Product Lead at YouTube (Google) | Ex-Amazon ...",
        "link": "https://www.linkedin.com/in/shannon-ong-44887053",
        "logo": "https://encrypted-tbn3.gstatic.com/favicon-tbn?q=tbn:ANd9GcTFMvFisG5Yfyq07VS0hk1otTr6uQvufSrlgYLzmBkZlxd7MQh66ZmKRUOdwfXrertN7RslYSLWGQCDyxLn3JsHLob5z5LPzTRUUQlVmSHaBnVJlJa8",
        "source": "LinkedIn",
        "image": "https://encrypted-tbn3.gstatic.com/images?q=tbn:ANd9GcSHV_Rg6Zrd0YDIQ2z9jIc_bujs7QKmKxjUMoDk6jXc_c9S5XVv",
        "image_url": "https://encrypted-tbn3.gstatic.com/images?q=tbn:ANd9GcSHV_Rg6Zrd0YDIQ2z9jIc_bujs7QKmKxjUMoDk6jXc_c9S5XVv",
        "rank": 49,
        "global_rank": 49
      },
      {
        "title": "Tienda Online de Mates Imperio Verde - YOUTUBE",
        "link": "https://matesimperioverde.com.ar/youtube/",
        "logo": "https://encrypted-tbn2.gstatic.com/favicon-tbn?q=tbn:ANd9GcR5Trf_oqul8xGk_4jZQfKCZ-lk2734NX87Uwm_GxwlN_lbvnhhXrpdFv50y6oLusQg9dlOc7xvbLBAiHfF4uLxvUcIoFH8zsPoaUft1Hnt21uI4B_GSdBh8iTtyoI",
        "source": "Mates Imperio Verde",
        "image": "https://encrypted-tbn1.gstatic.com/images?q=tbn:ANd9GcRY6VMEnyET4gl4llMs0eN_sbvlU-ykjoPYVR34W_9AejsMhW_s",
        "image_url": "https://encrypted-tbn1.gstatic.com/images?q=tbn:ANd9GcRY6VMEnyET4gl4llMs0eN_sbvlU-ykjoPYVR34W_9AejsMhW_s",
        "rank": 50,
        "global_rank": 50
      },
      {
        "title": "YouTube como herramienta educativa | Revista Cabal",
        "link": "https://www.revistacabal.coop/tecnologia/youtube-como-herramienta-educativa",
        "logo": "https://encrypted-tbn1.gstatic.com/favicon-tbn?q=tbn:ANd9GcQ5dtjoI0FQNrhM5bawPCCVj0-38LAVb5pM2MpzMjqJGHl0jV-LWq1DwpI7ISWMXzGJ1OE78u26weDllx5NWpJvXmAifXPi-nqfsMURD32bGRij_X0ncqxkahM",
        "source": "Revista Cabal",
        "image": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcRTNylW048lm1-5LdJclgNpW9DfUVYU_5tiMdDo7OrW2DKK7v74",
        "image_url": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcRTNylW048lm1-5LdJclgNpW9DfUVYU_5tiMdDo7OrW2DKK7v74",
        "rank": 51,
        "global_rank": 51
      },
      {
        "title": "Best Free YouTube Video Downloader for Windows 2025",
        "link": "https://www.donemax.com/video-download/top-4-free-youtube-video-downloader.html",
        "logo": "https://encrypted-tbn3.gstatic.com/favicon-tbn?q=tbn:ANd9GcT42ycJdf2UKgzoluI34OleyFF20kCMoM4nCVIyKw6nZHeVCEEYZRNkNzQOSdCzqTsMJC0veLw3rjdZkoJJJb57F_FMNM63E8_laLInHR0Vxvk-wSQ",
        "source": "Donemax",
        "image": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcSRNHWLmtSnUSexb14Iegqe3ZtC3-TjRAiHzoLmjzm2dhr9a8fc",
        "image_url": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcSRNHWLmtSnUSexb14Iegqe3ZtC3-TjRAiHzoLmjzm2dhr9a8fc",
        "rank": 52,
        "global_rank": 52
      },
      {
        "title": "Me at the Zoo: el primer video de YouTube cumple 17 años y ...",
        "link": "https://www.lacapital.com.ar/informacion-general/me-at-the-zoo-el-primer-video-youtube-cumple-17-anos-y-sigue-sumando-clicks-n10013748.html",
        "logo": "https://encrypted-tbn1.gstatic.com/favicon-tbn?q=tbn:ANd9GcRvjD9C8f1iRqlUM1tJLrVPgl_PPIIWkoEF07zoIMN5LpLiEaxDbVtC-xVQFSdv4R-fIvM2s1O1jBU8tcef0o8vFk5TsZN1CNQox-kgBM-IycO8Jak7Jxs7JQ",
        "source": "La Capital",
        "image": "https://encrypted-tbn2.gstatic.com/images?q=tbn:ANd9GcQDgcQDY8awAQt18xCSFVORK9VD5KCPes_loy4eE5nTE-zZ03Nz",
        "image_url": "https://encrypted-tbn2.gstatic.com/images?q=tbn:ANd9GcQDgcQDY8awAQt18xCSFVORK9VD5KCPes_loy4eE5nTE-zZ03Nz",
        "rank": 53,
        "global_rank": 53
      },
      {
        "title": "Comparte tu pasión por la cocina y únete a nuestra comunidad ...",
        "link": "https://www.facebook.com/hoyquecomemosblog/posts/comparte-tu-pasi%C3%B3n-por-la-cocina-y-%C3%BAnete-a-nuestra-comunidad-de-youtube-gratis-c/884788059910526/",
        "logo": "https://encrypted-tbn3.gstatic.com/favicon-tbn?q=tbn:ANd9GcRv794zBOQO02ChHD5K_TnlJwwf8PThFmn58OZAhQnomqvb1XKnHGAk8BQDBcyXho53FvXtsB2eVFSimUAzH3zcBAPC_yfttm2gkn07x3UumIdkepR5",
        "source": "Facebook",
        "image": "https://encrypted-tbn2.gstatic.com/images?q=tbn:ANd9GcSmsFe8ViO8t8SNMFkStD6BhROxgG9kDif5gAZngEiWrUSYahIK",
        "image_url": "https://encrypted-tbn2.gstatic.com/images?q=tbn:ANd9GcSmsFe8ViO8t8SNMFkStD6BhROxgG9kDif5gAZngEiWrUSYahIK",
        "rank": 54,
        "global_rank": 54
      },
      {
        "title": "Ya puedes descargar la aplicación de YouTube en Nintendo ...",
        "link": "https://www.3djuegos.com/nintendo-switch/noticias/ya-puedes-descargar-la-aplicacion-de-youtube-en-nintendo-181108-87335",
        "logo": "https://encrypted-tbn1.gstatic.com/favicon-tbn?q=tbn:ANd9GcSKZlwlNGXQBQKkw2pg-KrPUZxAksUOqKO1ZdE0lJO-0YI4-YZJjm9P3LU5coiCkfrI0iYvMeBJIor0-yoKl7hpjYnvqmThha4uqv_qpcrByskNvvW1",
        "source": "3DJuegos",
        "image": "https://encrypted-tbn3.gstatic.com/images?q=tbn:ANd9GcS5LV_hdWzY-suftbx6omDTvx21lflPXeIRtc5HjJs9OqZd3J-2",
        "image_url": "https://encrypted-tbn3.gstatic.com/images?q=tbn:ANd9GcS5LV_hdWzY-suftbx6omDTvx21lflPXeIRtc5HjJs9OqZd3J-2",
        "rank": 55,
        "global_rank": 55
      },
      {
        "title": "¿Cuánto dinero genera Youtube? Por primera vez desde que ...",
        "link": "https://www.infobae.com/economia/2020/02/04/cuanto-dinero-genera-youtube-por-primera-vez-desde-que-compro-la-empresa-google-dio-cifras-de-su-sitio-de-videos-estrella/",
        "logo": "https://encrypted-tbn3.gstatic.com/favicon-tbn?q=tbn:ANd9GcQDJSoti_tDfiR_vuZSDA_MJ_IjYOOlEmN7SbCZfohWPjZ_7d8VVr2r2xFglMDSqxYoST6tmoMREWvo1ShnVcRLcth-da1-O4UZ7xomdiLQCc_YdRs",
        "source": "Infobae",
        "image": "https://encrypted-tbn1.gstatic.com/images?q=tbn:ANd9GcQINP_FiwMrIzkRSoE_zj6e0foYKcekJ6zxWiL5EKcwIRUxvwtV",
        "image_url": "https://encrypted-tbn1.gstatic.com/images?q=tbn:ANd9GcQINP_FiwMrIzkRSoE_zj6e0foYKcekJ6zxWiL5EKcwIRUxvwtV",
        "rank": 56,
        "global_rank": 56
      },
      {
        "title": "Tutorial: ¿Cómo hacer para que YouTube siempre me avise ...",
        "link": "https://www.youtube.com/watch?v=Dcl7XDJeFdw",
        "logo": "https://encrypted-tbn0.gstatic.com/favicon-tbn?q=tbn:ANd9GcQHQslzHLLyLc_qne5jxn7JocidlmUPyegZ8ojX3WVlorFk8BxW9a3vJWjDzN99UHVTqSaNBj_-6XykhxuVQfF3Ye7xScSWSuc2QHXi0a12CkVwBmo",
        "source": "YouTube",
        "image": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcSNIr-THYZRUQIpMuyoK0WjonB4jWMFW9YXOH5WuCpUqc5dm9k7",
        "image_url": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcSNIr-THYZRUQIpMuyoK0WjonB4jWMFW9YXOH5WuCpUqc5dm9k7",
        "rank": 57,
        "global_rank": 57
      },
      {
        "title": "Videos - Springdale FWB - Springdale Free Will Baptist Church",
        "link": "https://www.springdalefwb.org/videos.html",
        "logo": "https://encrypted-tbn1.gstatic.com/favicon-tbn?q=tbn:ANd9GcRqfiy0VdOS4lUakqCu5N8oAxk1lHi2UaYOIXQHAKeXimo0wfiqsUhsC8W74MzgM1uVP4A1OfEYMAxluM5HZzWfyPpD_RblP2GNnRHVxUFnREbuqPZT2UY4gw4",
        "source": "Springdale Free Will Baptist Church",
        "image": "https://encrypted-tbn2.gstatic.com/images?q=tbn:ANd9GcQnoUBdcMizJv-JxXxIQAVVUTuZKps3gGr-K2riQiHI58po0zMW",
        "image_url": "https://encrypted-tbn2.gstatic.com/images?q=tbn:ANd9GcQnoUBdcMizJv-JxXxIQAVVUTuZKps3gGr-K2riQiHI58po0zMW",
        "rank": 58,
        "global_rank": 58
      },
      {
        "title": "Youtube Live Streaming – Varvid",
        "link": "https://varvid.com/broadcast-platforms/youtube/",
        "logo": "https://encrypted-tbn0.gstatic.com/favicon-tbn?q=tbn:ANd9GcRt9iyy-3-IW5iqOAYPaXafEUkma3FFNpyZ975Llg6NySgv6jDhL0aC_yGcYyedQxEPrACxZiQcVikTSGJKfEPFpCr0bG55riarTKeEvAGH",
        "source": "varvid.com",
        "image": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcTFA-6rv6huR7t2LS2ELkPJV7iQ2AM5sC6GCwWtvL37ACe-Sm9T",
        "image_url": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcTFA-6rv6huR7t2LS2ELkPJV7iQ2AM5sC6GCwWtvL37ACe-Sm9T",
        "rank": 59,
        "global_rank": 59
      },
      {
        "title": "How to Make a YouTube API Call? - DEV Community",
        "link": "https://dev.to/cyanspray/how-to-make-a-youtube-api-call-13nn",
        "logo": "https://encrypted-tbn0.gstatic.com/favicon-tbn?q=tbn:ANd9GcSQRYRjo6rRDeEwOaYrr8zfImMVmlI3BXXupnqDJb9APJUNVXQUR_ECPJEd7MrgNMDi2ZkWz2U7Ukg8DNNNK2HaNLsmHqhhaPiKpi4",
        "source": "DEV Community",
        "image": "https://encrypted-tbn3.gstatic.com/images?q=tbn:ANd9GcSTtMgLcdFtkbexCqPOGOD6z8hnKY18bw5PNXmFT4mXItLYMVfw",
        "image_url": "https://encrypted-tbn3.gstatic.com/images?q=tbn:ANd9GcSTtMgLcdFtkbexCqPOGOD6z8hnKY18bw5PNXmFT4mXItLYMVfw",
        "rank": 60,
        "global_rank": 60
      }
    ]
  }
  ```
</ResponseExample>


# Upload file
Source: https://docs.brightdata.com/api-reference/serp/google-lens/upload-file

Configure the Bright Data Google Lens Upload File parameter to refine queries and return matching results as JSON or HTML. On port 44445.

```sh theme={null}
curl -k -F "encoded_image=@cat.jpg" \
  --proxy brd.superproxy.io:44445 \
  --proxy-user "brd-customer-CUSTOMER_USERNAME-zone-ZONE-NAME:CUSTOMER_PASSWORD" \
  "https://lens.google.com/v3/upload"
```

## Parameters

<ParamField type="file">
  The image file to upload for Google Lens search (e.g., `cat.jpg`).
</ParamField>

<RequestExample>
  ```sh Native proxy theme={null}
  curl -k -F "encoded_image=@cat.jpg" \
    --proxy brd.superproxy.io:44445 \
    --proxy-user "brd-customer-CUSTOMER_USERNAME-zone-ZONE-NAME:CUSTOMER_PASSWORD" \
    "https://lens.google.com/v3/upload"
  ```

  ```py Python theme={null}
  import requests

  url = "https://lens.google.com/v3/upload"
  proxy_url = "http://brd-customer-CUSTOMER_USERNAME-zone-ZONE-NAME:CUSTOMER_PASSWORD@brd.superproxy.io:44445"

  proxies = {
      "http": proxy_url,
      "https": proxy_url,
  }

  # Opening the local file 'cat.jpg'
  files = {
      'encoded_image': ('cat.jpg', open('cat.jpg', 'rb'), 'image/jpeg')
  }

  # verify=False mimics the -k (insecure) flag in curl
  response = requests.post(url, proxies=proxies, files=files, verify=False)

  # Save the JSON response
  with open("response-2.json", "w", encoding="utf-8") as f:
      f.write(response.text)
  ```
</RequestExample>

<ResponseExample>
  ```json 200 theme={null}
  {
    "general": {
      "language": "vi-MZ",
      "mode": "search",
      "type": "all"
    },
    "tabs": [
      {
        "name": "Chế độ AI",
        "link": "https://www.google.com/search?sca_esv=b5143ed2853990e4&lns_surface=26&udm=50&vsrid=CLaIsa2N3ajiJBACGAEiJDU2MThkODM5LWY2NDItNDVhZi04NjlmLWM3NjM0ZGNlODhhMTIGIgJ3ZSgQOI7_me6YkpMD&vsint=CAIqDAoCCAcSAggKGAEgATojChYNAAAAPxUAAAA_HQAAgD8lAACAPzABEJgFGOkDJQAAgD8&lns_mode=un&source=lns.web.ukn&vsdim=664,489&gsessionid=WUJuhv7x0JMKXLsFwcKDV6Ufy323c9CGeknNum_eaJqe2RR6hs2IDw&lsessionid=lDdJjKQ3-v9Qr28WxvUl4h8jWEzdn5R6D-_FG9QyXNUgnJJgrnWlHA&fbs=ADc_l-ZfYqvb1LHQ3Tukr-_BxDE0X-Uvzm4xOB4VvS95wD_MPW-mtjKIHr8wde7qnTyuHHpMrqvxJBudekBp9hzzuzgReN80u3GBIQEsa88i1Ahyl7M4t-xwaIWYVAn2ltCAjbrUccfafxAU7uZFk9XKyx1gCwBqL2OtYXhOaw3bPgjXo8jmKBE&q=&aep=1&ntc=1&sa=X&ved=2ahUKEwi4yqrvmJKTAxVLpCcCHdItHaYQ2J8OegQIDxAD"
      },
      {
        "name": "Tất cả",
        "type": "all",
        "selected": true
      },
      {
        "name": "Kết quả khớp chính xác",
        "type": "exact_matches",
        "link": "https://www.google.com/search?sca_esv=b5143ed2853990e4&lns_surface=26&udm=48&vsrid=CLaIsa2N3ajiJBACGAEiJDU2MThkODM5LWY2NDItNDVhZi04NjlmLWM3NjM0ZGNlODhhMTIGIgJ3ZSgQOI7_me6YkpMD&vsint=CAIqDAoCCAcSAggKGAEgATojChYNAAAAPxUAAAA_HQAAgD8lAACAPzABEJgFGOkDJQAAgD8&lns_mode=un&source=lns.web.ukn&vsdim=664,489&gsessionid=WUJuhv7x0JMKXLsFwcKDV6Ufy323c9CGeknNum_eaJqe2RR6hs2IDw&lsessionid=lDdJjKQ3-v9Qr28WxvUl4h8jWEzdn5R6D-_FG9QyXNUgnJJgrnWlHA&vsrid=CLaIsa2N3ajiJBACGAEiJGY3MzEzYmYwLTFmMWMtNDkwYi04ZDMzLTU2YjYyZGM5MjM3YTIGIgJ3ZSgQOI7_me6YkpMDUAA&q=&sa=X&ved=2ahUKEwi4yqrvmJKTAxVLpCcCHdItHaYQs6gLegQIEBAB"
      },
      {
        "name": "Hình ảnh trùng khớp",
        "type": "visual_matches",
        "link": "https://www.google.com/search?sca_esv=b5143ed2853990e4&lns_surface=26&udm=44&vsrid=CLaIsa2N3ajiJBACGAEiJDU2MThkODM5LWY2NDItNDVhZi04NjlmLWM3NjM0ZGNlODhhMTIGIgJ3ZSgQOI7_me6YkpMD&vsint=CAIqDAoCCAcSAggKGAEgATojChYNAAAAPxUAAAA_HQAAgD8lAACAPzABEJgFGOkDJQAAgD8&lns_mode=un&source=lns.web.ukn&vsdim=664,489&gsessionid=WUJuhv7x0JMKXLsFwcKDV6Ufy323c9CGeknNum_eaJqe2RR6hs2IDw&lsessionid=lDdJjKQ3-v9Qr28WxvUl4h8jWEzdn5R6D-_FG9QyXNUgnJJgrnWlHA&q=&sa=X&ved=2ahUKEwi4yqrvmJKTAxVLpCcCHdItHaYQs6gLegQIExAB"
      },
      {
        "name": "Thông tin về hình ảnh này",
        "type": "about",
        "link": "https://www.google.com/search/about-this-image?img=H4sIAAAAAAAAAFPy5HLn2NaxcW3v3RWPVASYJBiVVEzNDC1SLIwtddPMTIx0TUwT03QtzCzTdJPNzYxNUpJTLSwSDY3YlJjKUzUELPr-z3w3Y9Jk5gAGAGCc-FhLAAAA&sa=X&ved=2ahUKEwi4yqrvmJKTAxVLpCcCHdItHaYQs6gLegQIERAB"
      }
    ],
    "images": [
      {
        "title": "Cat Breeds and Their Characteristics | L&L Info Hub – Lords ...",
        "link": "https://www.lordsandlabradors.co.uk/blogs/journal/cat-breeds-and-their-characteristics",
        "logo": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAACAAAA...",
        "source": "Lords & Labradors",
        "image": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQABAAD/2w...",
        "image_base64": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQABAAD/2w...",
        "rank": 1,
        "global_rank": 1
      },
      {
        "title": "Samuel Arnold Lion",
        "link": "https://arnoldlion.com/kittens/samuel",
        "logo": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAACAAAA...",
        "source": "Arnold Lion Cattery",
        "image": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQABAAD/2w...",
        "image_base64": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQABAAD/2w...",
        "rank": 2,
        "global_rank": 5
      },
      {
        "title": "Maine Coon Cattery Argentina | Buenos Aires",
        "link": "https://www.facebook.com/bbcattery/?locale=pt_BR",
        "logo": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAACAAAA...",
        "source": "Facebook",
        "image": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQABAAD/2w...",
        "image_base64": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQABAAD/2w...",
        "rank": 3,
        "global_rank": 6
      },
      {
        "title": "Gatinho Maine Coon Red Tabby Bicolor | Foto Premium",
        "link": "https://br.freepik.com/fotos-premium/gatinho-maine-coon-red-tabby-bicolor_31031132.htm",
        "logo": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAACAAAA...",
        "source": "Freepik",
        "image": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQABAAD/2w...",
        "image_base64": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQABAAD/2w...",
        "rank": 4,
        "global_rank": 7
      },
      {
        "title": "He's such a proper gentleman! : r/mainecoons",
        "link": "https://www.reddit.com/r/mainecoons/comments/1ivs3oe/hes_such_a_proper_gentleman/",
        "logo": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAACAAAA...",
        "source": "Reddit",
        "image": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQABAAD/2w...",
        "image_base64": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQABAAD/2w...",
        "rank": 5,
        "global_rank": 8
      },
      {
        "title": "Carina cats",
        "link": "https://www.instagram.com/reel/DT3GLXQiHVr/",
        "logo": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAACAAAA...",
        "source": "Instagram",
        "image": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQABAAD/2w...",
        "image_base64": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQABAAD/2w...",
        "rank": 6,
        "global_rank": 9
      },
      {
        "title": "Light Orange Maine Coon Kitten Laying Stock Photo 411860023 ...",
        "link": "https://www.shutterstock.com/image-photo/light-orange-maine-coon-kitten-laying-411860023",
        "logo": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAACAAAA...",
        "source": "Shutterstock",
        "image": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQABAAD/2w...",
        "image_base64": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQABAAD/2w...",
        "rank": 7,
        "global_rank": 10
      },
      {
        "title": "Adopting a cream silver maine coon cat",
        "link": "https://www.facebook.com/groups/406917014031585/posts/1235952737794671/",
        "logo": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAACAAAA...",
        "source": "Facebook",
        "image": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQABAAD/2w...",
        "image_base64": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQABAAD/2w...",
        "rank": 8,
        "global_rank": 11
      },
      {
        "title": "大家好像都蠻喜歡紅銀虎斑🤔🤔 但我還是偷站銀黑虎斑一票😂",
        "link": "https://www.threads.com/@lucien_mainecoon/post/DS60jTfksLC/%E5%A4%A7%E5%AE%B6%E5%A5%BD%E5%83%8F%E9%83%BD%E8%A0%BB%E5%96%9C%E6%AD%A1%E7%B4%85%E9%8A%80%E8%99%8E%E6%96%91%E4%BD%86%E6%88%91%E9%82%84%E6%98%AF%E5%81%B7%E7%AB%99%E9%8A%80%E9%BB%91%E8%99%8E%E6%96%91%E4%B8%80%E7%A5%A8",
        "logo": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAACAAAA...",
        "source": "Threads",
        "image": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQABAAD/2w...",
        "image_base64": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQABAAD/2w...",
        "rank": 9,
        "global_rank": 12
      },
      {
        "title": "Here is Jadzia : r/mainecoons",
        "link": "https://www.reddit.com/r/mainecoons/comments/1bub4rt/here_is_jadzia/",
        "logo": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAACAAAA...",
        "source": "Reddit",
        "image": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQABAAD/2w...",
        "image_base64": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQABAAD/2w...",
        "rank": 10,
        "global_rank": 13
      },
      {
        "title": "Фотогалерея – Питомник котов",
        "link": "https://mainecoonsintengel.com/%D1%84%D0%BE%D1%82%D0%BE%D0%B3%D0%B0%D0%BB%D0%B5%D1%80%D0%B5%D1%8F/",
        "logo": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQABAAD/2w...",
        "source": "mainecoonsintengel.com",
        "image": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQABAAD/2w...",
        "image_base64": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQABAAD/2w...",
        "rank": 11,
        "global_rank": 14
      },
      {
        "title": "kefir | Kitties",
        "link": "https://www.missmainecoon.com/kefir",
        "logo": "https://encrypted-tbn3.gstatic.com/favicon-tbn?q=tbn:ANd9GcTi1oDj6Fuxl44i1zoZulsdc_WTg7gdWqBdDrzXkV5nDD2Vy7f2_AbymlYEjjgEQN30rQjWWotfKt_xDsrRndEaV2WF3QEabRzxOIgqhCpcvmPNpxAt1xyr-Ok",
        "source": "missmainecoon.com",
        "image": "https://encrypted-tbn2.gstatic.com/images?q=tbn:ANd9GcRpBw_v4WdkaXx8-nouGx2jBjyZnhx2pLK43Tez49pFS11r6Alx",
        "image_url": "https://encrypted-tbn2.gstatic.com/images?q=tbn:ANd9GcRpBw_v4WdkaXx8-nouGx2jBjyZnhx2pLK43Tez49pFS11r6Alx",
        "rank": 12,
        "global_rank": 15
      },
      {
        "title": "Maine Coon - Người Bạn Bốn Chân Khổng Lồ - Pet House - Cửa ...",
        "link": "https://pethouse.com.vn/maine-coon-nguoi-ban-bon-chan-khong-lo/",
        "logo": "https://encrypted-tbn3.gstatic.com/favicon-tbn?q=tbn:ANd9GcR99I1MiUPQYOMjUOL4XZH-gAU9xrv7LHNzEosnnBue-Pjxc_A9kcm2fFsWeXbciZfWLWUzFb-EgFhenNa423sysObYfNLYBNU0N09cFvzdyw9S2jA",
        "source": "pethouse.com.vn",
        "image": "https://encrypted-tbn1.gstatic.com/images?q=tbn:ANd9GcTklJc6P_z7aE_lGoWnnjC00OkXF3MikzfgiFjc_hkNETbxOsHd",
        "image_url": "https://encrypted-tbn1.gstatic.com/images?q=tbn:ANd9GcTklJc6P_z7aE_lGoWnnjC00OkXF3MikzfgiFjc_hkNETbxOsHd",
        "rank": 13,
        "global_rank": 16
      },
      {
        "title": "Veterinary Clinic Shows Off 'Biggest Cat They've Ever Seen ...",
        "link": "https://www.yahoo.com/lifestyle/articles/veterinary-clinic-shows-off-biggest-153000861.html",
        "logo": "https://encrypted-tbn2.gstatic.com/favicon-tbn?q=tbn:ANd9GcQ98tQHFQS3n7QHqC7pmpE-1Z-UlH70Xakqp_talW_6584HsAJbQSpaXQuXSvIGnmhrnpeqIsZGvSvSm6DfJQ3SyRT60SFIdZnZ1XwLf-UtO1Hj",
        "source": "Yahoo",
        "image": "https://encrypted-tbn1.gstatic.com/images?q=tbn:ANd9GcQsjtW-xkRyKfOdimg1GrJPYXoQT7ddg5EqYbuAwuGbyBf_kAtk",
        "image_url": "https://encrypted-tbn1.gstatic.com/images?q=tbn:ANd9GcQsjtW-xkRyKfOdimg1GrJPYXoQT7ddg5EqYbuAwuGbyBf_kAtk",
        "rank": 14,
        "global_rank": 17
      },
      {
        "title": "Vom Dattelner Meer - Maine Coon Cattery",
        "link": "https://www.vom-dattelner-meer.de/",
        "logo": "https://encrypted-tbn2.gstatic.com/favicon-tbn?q=tbn:ANd9GcSIiIl8YfgA596O3F7M9CyObkhxEpuylB_DFOu_dSMpNzHn7G3m7ctaFX3bxzMuRkri2A-8Fp10me66-6q0VHRk4O9dEJ-w9pqb1A98ieETLeE6dxIRDZmchU2V_1Rm",
        "source": "Vom Dattelner Meer",
        "image": "https://encrypted-tbn1.gstatic.com/images?q=tbn:ANd9GcT2KXnPmJnIU_Cll4SPTbP_96XUVUtylLXoQgE_n8Cj6VOm2xNn",
        "image_url": "https://encrypted-tbn1.gstatic.com/images?q=tbn:ANd9GcT2KXnPmJnIU_Cll4SPTbP_96XUVUtylLXoQgE_n8Cj6VOm2xNn",
        "rank": 15,
        "global_rank": 18
      },
      {
        "title": "Photo gallery :: WildNfluffy",
        "link": "https://www.wildnfluffy.com/photo-gallery/",
        "logo": "https://encrypted-tbn0.gstatic.com/favicon-tbn?q=tbn:ANd9GcQl9uFsvTCsVxrIaORywqmHIuKE_SI7CTEzoU6gjhhwkUbGxu2lC25h1zRsTrkJo8WLjg99NTRrswGrOp4rXR0eQV8_sGFE9wVJNkjCGB42wqmM83-0NOQe",
        "source": "WildNfluffy",
        "image": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcSo-21X0krB_TXVsV-agzxxsxyjPRgNj9aq5VAKlp8yx3i25Kqq",
        "image_url": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcSo-21X0krB_TXVsV-agzxxsxyjPRgNj9aq5VAKlp8yx3i25Kqq",
        "rank": 16,
        "global_rank": 19
      },
      {
        "title": "Kastraten – Maine Coon vom drei Galgenberg",
        "link": "https://vomdreigalgenberg.de/kastraten/",
        "logo": "https://encrypted-tbn3.gstatic.com/favicon-tbn?q=tbn:ANd9GcRQHx4CQqvaBc4LF-o_oG9Y1ixpMo5DaeBpnWHb27FvCY9z9rzEy6eFC2CVOEaQQwhx5ng7_VYS8cWIrs-nPwOhewXXOJx24_4zgG8vI1N4AaofS4X0sM_4AA",
        "source": "Maine Coon vom drei Galgenberg",
        "image": "https://encrypted-tbn3.gstatic.com/images?q=tbn:ANd9GcTFpkb29cq_AgrHYqqZV_ocdgWgy3c9tbscDUyQkkimsbGPToGX",
        "image_url": "https://encrypted-tbn3.gstatic.com/images?q=tbn:ANd9GcTFpkb29cq_AgrHYqqZV_ocdgWgy3c9tbscDUyQkkimsbGPToGX",
        "rank": 17,
        "global_rank": 20
      },
      {
        "title": "The Cat Market",
        "link": "https://www.petage.com/the-cat-market/",
        "logo": "https://encrypted-tbn2.gstatic.com/favicon-tbn?q=tbn:ANd9GcSieb7w70lzy65clVXWGqqGSZ-LVtMgL6LZKkfwEYgq2YKOi77Xx53w0uqGKulHsvpWB2Y0xmpwcvXgecSeuH6mZhti-dqaYLJr6krW0UZRaMGRbw",
        "source": "Pet Age",
        "image": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcTsdSgtilRi0CVU9rhjVorgst-I_AtjIdsxCCryvXMID9zy_QVD",
        "image_url": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcTsdSgtilRi0CVU9rhjVorgst-I_AtjIdsxCCryvXMID9zy_QVD",
        "rank": 18,
        "global_rank": 21
      },
      {
        "title": "STARKS EDMOND — Starks",
        "link": "http://starkscoon.ru/gallery/starks-edmond/",
        "logo": "https://encrypted-tbn3.gstatic.com/favicon-tbn?q=tbn:ANd9GcSxM7a1CsnrWHQLeS0q652KjbJFF3ZrGDKscukFsuzoVaUNVSJLqmNPBJFbFI6ho_QAMFTdlQo6o3wGZ9jhfiiKPn1vdpIliYfu-z_AauT0QHM",
        "source": "starkscoon.ru",
        "image": "https://encrypted-tbn3.gstatic.com/images?q=tbn:ANd9GcS7lApLQryXfLr4qUJPlBO9GD4mdbpRT9WLIuid6G3JHXEp2-Fj",
        "image_url": "https://encrypted-tbn3.gstatic.com/images?q=tbn:ANd9GcS7lApLQryXfLr4qUJPlBO9GD4mdbpRT9WLIuid6G3JHXEp2-Fj",
        "rank": 19,
        "global_rank": 22
      },
      {
        "title": "Ginger Cat Sleeps On Pile TextileẢnh có sẵn2496921573 ...",
        "link": "https://www.shutterstock.com/vi/image-photo/ginger-cat-sleeps-on-pile-textile-2496921573",
        "logo": "https://encrypted-tbn0.gstatic.com/favicon-tbn?q=tbn:ANd9GcQwdI3sb1idjasgpEajuGBarrfMhFwWbJceP1HmKLp9LB8NKtpVfuUo17r2zkDPmlw6QrBqa5Pauk8AHMTKtOxo2mv157Swt5427ca_0tkvot_JzOuLv-zNkQ",
        "source": "Shutterstock",
        "image": "https://encrypted-tbn3.gstatic.com/images?q=tbn:ANd9GcSA8oYXwNx1A4jV9GSv7cr7TRt-v4yt8fgMFFsvFNjeiNK1fNyF",
        "image_url": "https://encrypted-tbn3.gstatic.com/images?q=tbn:ANd9GcSA8oYXwNx1A4jV9GSv7cr7TRt-v4yt8fgMFFsvFNjeiNK1fNyF",
        "rank": 20,
        "global_rank": 23
      },
      {
        "title": "TICA European Maine Coon Cat Breeder | Cattery",
        "link": "https://mainecoonkittens.com/",
        "logo": "https://encrypted-tbn0.gstatic.com/favicon-tbn?q=tbn:ANd9GcSAmjQiPVDAsiDIsT-tH9LAktJ53sdgQwhuMkTdsX3P-VoZViancxGDrtHdq7LgThwKqnf88l4xwvUAe3nJOAzIXXaeAUTz8FFCv-mZG8tk11ADpvCY6ofcNw",
        "source": "mainecoonkittens.com",
        "image": "https://encrypted-tbn3.gstatic.com/images?q=tbn:ANd9GcRBOFfs6E6vUJSUsHigj2luwKwtUmqEuMs2OyYdx-UdPfZ5veaL",
        "image_url": "https://encrypted-tbn3.gstatic.com/images?q=tbn:ANd9GcRBOFfs6E6vUJSUsHigj2luwKwtUmqEuMs2OyYdx-UdPfZ5veaL",
        "rank": 21,
        "global_rank": 24
      },
      {
        "title": "Remi (5) | Sandra Notenboom-Frencken | Flickr",
        "link": "https://www.flickr.com/photos/153127362@N07/26756503017/",
        "logo": "https://encrypted-tbn2.gstatic.com/favicon-tbn?q=tbn:ANd9GcTfrOu0sWKs3Pcw2QmgK3YJ56j2-ayOW-qRIJSQvaGvhVZy3tuULAELn-9WhCkJkgiSJmW8S2sgnoc74IbwPBg6aBaBJfMsZdN3QKOSPEQO0xq3oQ",
        "source": "Flickr",
        "image": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcTYQeqYVBFq6qU5x4B-VqzWEniODoZmtVTrmJYQeAXVGM4hY7ty",
        "image_url": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcTYQeqYVBFq6qU5x4B-VqzWEniODoZmtVTrmJYQeAXVGM4hY7ty",
        "rank": 22,
        "global_rank": 25
      },
      {
        "title": "LT*Šešuvos Brendis - BALTIC LYNX - Namine lusis",
        "link": "https://balticlynx.weebly.com/ltscaronescaronuvos-brendis.html",
        "logo": "https://encrypted-tbn3.gstatic.com/favicon-tbn?q=tbn:ANd9GcREbs6EwEX044DLm4uuSESOblHE_OP6DXiF3X-1oyzDtX9IUTpCXtMYlWyPvZiceP245PwUZ_NR0kpKbYp5shH1-6nYDzhOsAMqO9zfs2KIR2U6zbrbYUWjIRw",
        "source": "Weebly",
        "image": "https://encrypted-tbn1.gstatic.com/images?q=tbn:ANd9GcSKEpxjgeyXdR1gnr0dfhb0L7zEK7PdqJxE9SsYHCXWRXBmleKI",
        "image_url": "https://encrypted-tbn1.gstatic.com/images?q=tbn:ANd9GcSKEpxjgeyXdR1gnr0dfhb0L7zEK7PdqJxE9SsYHCXWRXBmleKI",
        "rank": 23,
        "global_rank": 26
      },
      {
        "title": "ELARA ECLIPSE MAINE COON CATTERY - Updated March ...",
        "link": "https://m.yelp.com/biz/elara-eclipse-maine-coon-cattery-pinehurst",
        "logo": "https://encrypted-tbn1.gstatic.com/favicon-tbn?q=tbn:ANd9GcTMJbNJmAPdfKj5ih9ASLCbVCvZ1HdFNJLDlwoVMI6AJI9InCRbnDekwhO1QIBYzQ0DgkguT65-RKJGpPZn4x5Zr1jrsau2XRfsFlcSyqnD",
        "source": "Yelp",
        "image": "https://encrypted-tbn2.gstatic.com/images?q=tbn:ANd9GcQtrBbMI0rildJKuThv1wJREtJMuAJ-fXewoAJGazVf1xZGYjqb",
        "image_url": "https://encrypted-tbn2.gstatic.com/images?q=tbn:ANd9GcQtrBbMI0rildJKuThv1wJREtJMuAJ-fXewoAJGazVf1xZGYjqb",
        "rank": 24,
        "global_rank": 27
      },
      {
        "title": "Купить котенка породы Рэгдолл из проверенных питомников ...",
        "link": "http://zoonika.com/pitomniki/regdoll",
        "logo": "https://encrypted-tbn1.gstatic.com/favicon-tbn?q=tbn:ANd9GcSdNWWb7TsMRYA5En4YMwBPgzxAKiBnqXwVnuHnSws1XnY5e_oz-YOHi0JSgmUa-n7S2EVtkCDKSk4cCaZah-5PVvbW7m0D8OLV1mxL-tCI",
        "source": "Зооника",
        "image": "https://encrypted-tbn1.gstatic.com/images?q=tbn:ANd9GcTROyBIIZD93Sq8Q097C86zViUA96dVoCA2Ct31nCzVTQnGTomz",
        "image_url": "https://encrypted-tbn1.gstatic.com/images?q=tbn:ANd9GcTROyBIIZD93Sq8Q097C86zViUA96dVoCA2Ct31nCzVTQnGTomz",
        "rank": 25,
        "global_rank": 28
      },
      {
        "title": "Maine Coon Fleece Blanket by Joachim G Pinkawa - Fine Art ...",
        "link": "https://fineartamerica.com/featured/maine-coon-joachim-g-pinkawa.html?product=fleece-blanket",
        "logo": "https://encrypted-tbn0.gstatic.com/favicon-tbn?q=tbn:ANd9GcQDwpYAYqn3EBF7tk14LrzU-6oVXH9tDyHifIHLcDe-g-Vp3eY6oGA-iJQiD7-_7GD-xuDMSsgXtmDxPRfnZ9ptcLVyhoHIl4NQeQppRIEV4diQfx-Gdf4",
        "source": "Fine Art America",
        "image": "https://encrypted-tbn1.gstatic.com/images?q=tbn:ANd9GcR0IdmvPJQlJ1Oyk1tYqGogVQP1jrqKD899DMopCtxtOGuiZ8Na",
        "image_url": "https://encrypted-tbn1.gstatic.com/images?q=tbn:ANd9GcR0IdmvPJQlJ1Oyk1tYqGogVQP1jrqKD899DMopCtxtOGuiZ8Na",
        "rank": 26,
        "global_rank": 29
      },
      {
        "title": "Les Sentiers Sauvages - Elevage familial de Maine Coon",
        "link": "https://www.ckc-net.com/creation-site-web/les-sentiers-sauvages",
        "logo": "https://encrypted-tbn0.gstatic.com/favicon-tbn?q=tbn:ANd9GcRfLfP8CXklJKr02UIN0KiCFbgTE8fwedBZThB2744Gp1NxnkYUolGJIuv5Pj2Tox-ezEL7kzK5DytdVAZYKjqQzoI3vwYQrp823QoTmMNRwtrCRM4",
        "source": "CKC-Net",
        "image": "https://encrypted-tbn3.gstatic.com/images?q=tbn:ANd9GcRrkW8fPsP_lFuIgESpuBYcnwwtDildK8WAC45tq-7BSzJ2ulex",
        "image_url": "https://encrypted-tbn3.gstatic.com/images?q=tbn:ANd9GcRrkW8fPsP_lFuIgESpuBYcnwwtDildK8WAC45tq-7BSzJ2ulex",
        "rank": 27,
        "global_rank": 30
      },
      {
        "title": "Maine Coon Adventures Live! - YouTube",
        "link": "https://www.youtube.com/watch?v=V_L03xdRpDM",
        "logo": "https://encrypted-tbn0.gstatic.com/favicon-tbn?q=tbn:ANd9GcQHQslzHLLyLc_qne5jxn7JocidlmUPyegZ8ojX3WVlorFk8BxW9a3vJWjDzN99UHVTqSaNBj_-6XykhxuVQfF3Ye7xScSWSuc2QHXi0a12CkVwBmo",
        "source": "YouTube",
        "image": "https://encrypted-tbn2.gstatic.com/images?q=tbn:ANd9GcQpyBFPZErIfFp1ov73KSTWFZyXSXOSbXpfhoZ5Nn9nWAPqgTwe",
        "image_url": "https://encrypted-tbn2.gstatic.com/images?q=tbn:ANd9GcQpyBFPZErIfFp1ov73KSTWFZyXSXOSbXpfhoZ5Nn9nWAPqgTwe",
        "rank": 28,
        "global_rank": 31
      },
      {
        "title": "American Bobtail Tea",
        "link": "https://www.adagio.com/signature_blend/blend.html?blend=232279",
        "logo": "https://encrypted-tbn1.gstatic.com/favicon-tbn?q=tbn:ANd9GcS3fFVdB-VNMS6SBFUCZ4wi1x2NSU9S6sGVyJkgsPtApVouB4_g2LZfUEBztW-NoWAhpMTLyNFOrKoH1F9CkehM4PRYBUCTOn-qXKnqMbeIbUYCvQ",
        "source": "adagio.com",
        "image": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcS4rBaFHGnRZxlwAtAEraaKqf2hWcBxolTLl0I-f2v7n4toZxzh",
        "image_url": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcS4rBaFHGnRZxlwAtAEraaKqf2hWcBxolTLl0I-f2v7n4toZxzh",
        "rank": 29,
        "global_rank": 32
      },
      {
        "title": "Mèo Maincoon màu Kem mã MC1774 - Pet House - Cửa hàng thú ...",
        "link": "https://pethouse.com.vn/san-pham/meo-maincoon-mau-kem-ma-mc1774/",
        "logo": "https://encrypted-tbn3.gstatic.com/favicon-tbn?q=tbn:ANd9GcR99I1MiUPQYOMjUOL4XZH-gAU9xrv7LHNzEosnnBue-Pjxc_A9kcm2fFsWeXbciZfWLWUzFb-EgFhenNa423sysObYfNLYBNU0N09cFvzdyw9S2jA",
        "source": "pethouse.com.vn",
        "image": "https://encrypted-tbn1.gstatic.com/images?q=tbn:ANd9GcQeDIGQhXlC4DsLxb06_ItW9nyivGa_4wtfXK72L8nrtMPr8rOD",
        "image_url": "https://encrypted-tbn1.gstatic.com/images?q=tbn:ANd9GcQeDIGQhXlC4DsLxb06_ItW9nyivGa_4wtfXK72L8nrtMPr8rOD",
        "rank": 30,
        "global_rank": 33
      },
      {
        "title": "Geriatric Care for Senior Dogs & Cats in Rancho Cucamonga",
        "link": "https://www.ranchovet.com/site/veterinary-services-rancho-cucamonga/geriatrics",
        "logo": "https://encrypted-tbn3.gstatic.com/favicon-tbn?q=tbn:ANd9GcQnf_X15t0JgJLFc7OIAVFuDLn2Ti3VDrhRY0c9qRrd0al4rzxDUS-Nrhq8bwHd5VPNLxdtJHBcObw9crihLAa50TQ0HH6UWNGgJtdR1FvHtwnxG1MHzQ",
        "source": "Rancho Regional Veterinary Hospital",
        "image": "https://encrypted-tbn3.gstatic.com/images?q=tbn:ANd9GcRt-zNv90rUbD9roBd9tSrqE1V8QOz4Qg6PtoWfLDizCv9JhNO3",
        "image_url": "https://encrypted-tbn3.gstatic.com/images?q=tbn:ANd9GcRt-zNv90rUbD9roBd9tSrqE1V8QOz4Qg6PtoWfLDizCv9JhNO3",
        "rank": 31,
        "global_rank": 34
      },
      {
        "title": "Mom Cats | Maine Coon NY",
        "link": "https://mainecoonny.com/mom-cats",
        "logo": "https://encrypted-tbn2.gstatic.com/favicon-tbn?q=tbn:ANd9GcSb8751R8664h1wRIV8OSf0JEzM1uxNMwzohG611JAzg_Ww6vglo2j8oh7WrS2PEL5MLSzFXZlOB3-iRUiiTZh0XfS0OowJ6Etj9sfjZ9pmrSvqH3w",
        "source": "Maine Coon NY",
        "image": "https://encrypted-tbn2.gstatic.com/images?q=tbn:ANd9GcRpDO8sk53goOtLUu3K1o4-19vYM3AgRaz1YFwuWkVCIOcfI_ei",
        "image_url": "https://encrypted-tbn2.gstatic.com/images?q=tbn:ANd9GcRpDO8sk53goOtLUu3K1o4-19vYM3AgRaz1YFwuWkVCIOcfI_ei",
        "rank": 32,
        "global_rank": 35
      },
      {
        "title": "Nos males - La tour d'Eden",
        "link": "https://www.latourdeden.net/nos-males",
        "logo": "https://encrypted-tbn1.gstatic.com/favicon-tbn?q=tbn:ANd9GcTJ3kL3zAcJplRzS4ESf_Usw3z6HjbPYH5hAmuU8YO7HcADajdJoE92QErCkJbqyJuEKkbw8biwGCfLlMFfv71jZ52dYs1zqDdhLhLnhHGfLJAOkYy1ePvy",
        "source": "La tour d'Eden",
        "image": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcTDX5poFdpjh6Pm0cf3RUZQnRNk2WjzKx01U8hPdt9zNpQJYpOq",
        "image_url": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcTDX5poFdpjh6Pm0cf3RUZQnRNk2WjzKx01U8hPdt9zNpQJYpOq",
        "rank": 33,
        "global_rank": 36
      },
      {
        "title": "Photo de votre animal - Studio Louise Mary",
        "link": "https://www.studiolouisemary.com/prestation/animaux/",
        "logo": "https://encrypted-tbn3.gstatic.com/favicon-tbn?q=tbn:ANd9GcTp__S8oPDCwLjz5RTYLnxB5sacyiWhHDOdHblknqRjiD0NneFPNIhTLh1wU00vUW54DHPP2HhgpylaxANCQyD0AVYoX2JWmxsXBT3AvNL4uXNUbNJ3cq-7YPHkrpk",
        "source": "Studio Louise Mary",
        "image": "https://encrypted-tbn1.gstatic.com/images?q=tbn:ANd9GcRKM0GZM2G-Hl4nDTP0JHVlIho5I-IMVG2ssdeB7IixZ351nRwH",
        "image_url": "https://encrypted-tbn1.gstatic.com/images?q=tbn:ANd9GcRKM0GZM2G-Hl4nDTP0JHVlIho5I-IMVG2ssdeB7IixZ351nRwH",
        "rank": 34,
        "global_rank": 37
      },
      {
        "title": "Maine Coon Cat's Persistent Way of Demanding Treats Is ...",
        "link": "https://paradepets.com/pet-news/maine-coon-cat-persistent-way-demanding-treats-on-point",
        "logo": "https://encrypted-tbn0.gstatic.com/favicon-tbn?q=tbn:ANd9GcQUrf3qSBiZG-yhrsTbmR9akt3A1UR82dgfZv-j7l0vvT2ErjoGqohREU8VzqWxVY0U36KjFroQNlRZdOqPLv9GnOEQYcRLim3ZnlAFwE4Ruq6Acg",
        "source": "ParadePets",
        "image": "https://encrypted-tbn3.gstatic.com/images?q=tbn:ANd9GcQKlmwdqB6y3rzTHz7Aa3EiyrAhRXmXJIEPXxkaJuGgdW0c4zQb",
        "image_url": "https://encrypted-tbn3.gstatic.com/images?q=tbn:ANd9GcQKlmwdqB6y3rzTHz7Aa3EiyrAhRXmXJIEPXxkaJuGgdW0c4zQb",
        "rank": 35,
        "global_rank": 38
      },
      {
        "title": "Le Coonoahope Shana - Chat Maine coon polydactyle Loiret",
        "link": "https://www.mainecoonchaton.com/maine-coon-polydactyle-shana",
        "logo": "https://encrypted-tbn1.gstatic.com/favicon-tbn?q=tbn:ANd9GcR55ompJ6QjCEoyBrv77-5Spcb73mfvYop9spKBH4n8KbvSTY0msHwRxGnma2-Ri7UWQOc0fsBJmiS_1NZQHEjpd0jI26Yj686piPy24yRqIWkjC99mK6v1YfAwfg",
        "source": "www.mainecoonchaton.com",
        "image": "https://encrypted-tbn2.gstatic.com/images?q=tbn:ANd9GcSqVsEp3YL3w_rWKAJcOgWNsHbp8Hki1eaA0cEXLUqoGQMZxHGQ",
        "image_url": "https://encrypted-tbn2.gstatic.com/images?q=tbn:ANd9GcSqVsEp3YL3w_rWKAJcOgWNsHbp8Hki1eaA0cEXLUqoGQMZxHGQ",
        "rank": 36,
        "global_rank": 39
      },
      {
        "title": "Coonattack Maine Coon Cats",
        "link": "http://www.coonattack.de/Galerie/Galerie.htm",
        "logo": "https://encrypted-tbn3.gstatic.com/favicon-tbn?q=tbn:ANd9GcQVuA4YKgp3DjvGOi9XgIiHZZFtaTLxXZK-uXJwJapYHiMKXMviMsnZcxa3vy2OVvTNfmeACwilr906ZSkAxXBB2UrCYCz_mavD1I0Y397zsug6347J",
        "source": "coonattack.de",
        "image": "https://encrypted-tbn3.gstatic.com/images?q=tbn:ANd9GcTHA4PWqxGBDB_xdTkU0iytV8secxQnY8WzTGKbKyxmVf5AtCyB",
        "image_url": "https://encrypted-tbn3.gstatic.com/images?q=tbn:ANd9GcTHA4PWqxGBDB_xdTkU0iytV8secxQnY8WzTGKbKyxmVf5AtCyB",
        "rank": 37,
        "global_rank": 40
      },
      {
        "title": "Mèo Maine Coon: Những Người Khổng Lồ Dịu Dàng Nước Mỹ",
        "link": "https://nhapet.com/meo-canh/meo-maine-coon/",
        "logo": "https://encrypted-tbn1.gstatic.com/favicon-tbn?q=tbn:ANd9GcQ1XoP7YDmYBSbqh8Xr9oxNh2SvBQCKovZrEIFFwJwJQaUiBxJCrHb0m-x-tOY3udkSyq0Smbw-0DObZIct9WxAOQI-KAB8U93Q6ytjYOs0",
        "source": "nhapet.com",
        "image": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcRmUbHLV3PL1GxokRP6w3wdalL-zHmGOooQoSYwXTrfUut9bib0",
        "image_url": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcRmUbHLV3PL1GxokRP6w3wdalL-zHmGOooQoSYwXTrfUut9bib0",
        "rank": 38,
        "global_rank": 41
      },
      {
        "title": "Thutmosis",
        "link": "http://www.of-juja-tuja.de/index.php/34-news/231-thutmosis",
        "logo": "https://encrypted-tbn1.gstatic.com/favicon-tbn?q=tbn:ANd9GcTIn2ie3oouVxOQjNlLfQjguYL9xYjFc5qbL4Sa2-4aX8HGH5Ur-V-FlSy5l8EwjvFgKAwrOFl5qz-NmA5alEcfYtuSXhdBC3rYGEkYSKGcCfIM43jYsWQ",
        "source": "of-juja-tuja.de",
        "image": "https://encrypted-tbn1.gstatic.com/images?q=tbn:ANd9GcS7pT04WtJKlLunMEMB4wQqxydXdcoTaZSaBlrbvApeDYVhE_Cd",
        "image_url": "https://encrypted-tbn1.gstatic.com/images?q=tbn:ANd9GcS7pT04WtJKlLunMEMB4wQqxydXdcoTaZSaBlrbvApeDYVhE_Cd",
        "rank": 39,
        "global_rank": 42
      },
      {
        "title": "XXL Maine Coon Kater Alex of Maine Coon Castle",
        "link": "https://www.maine-coon-castle.de/xxl-maine-coon-kater-alex-mcc-cats/",
        "logo": "https://encrypted-tbn0.gstatic.com/favicon-tbn?q=tbn:ANd9GcRdZwEsk0itLNiuD9wO1Fg9Y36uUSlxsJeCZEDKTYHzNQs3bt5QDDAzEaT3DotArbnvWUOjpUfwgSkwnzPpByEBcVF2NyKJ0uNNJNz6KgfDP0oJm0BXgkoBa1as9wA",
        "source": "Maine Coon Castle",
        "image": "https://encrypted-tbn1.gstatic.com/images?q=tbn:ANd9GcTIufIWj-g-O2pF4FLAoFLdvK79g2lBARkQaFl3TLnOq-nUMNvC",
        "image_url": "https://encrypted-tbn1.gstatic.com/images?q=tbn:ANd9GcTIufIWj-g-O2pF4FLAoFLdvK79g2lBARkQaFl3TLnOq-nUMNvC",
        "rank": 40,
        "global_rank": 43
      },
      {
        "title": "Our Available Kittens | Aristocoon Cat",
        "link": "https://www.aristocooncat.com/our-available-kittens-1",
        "logo": "https://encrypted-tbn3.gstatic.com/favicon-tbn?q=tbn:ANd9GcTVsL-tSdCbppraBcdDdRvkytD6p6QcRD3RZpvRVDiA_6pqYQtxZiDe7T8wO0GBgN7ddHnCseDCt2OPy3dz_3AOqL4Kht1qLH71TWQBgVDhvxWD50s6xVNwndI",
        "source": "Aristocoon Cat",
        "image": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcSN6556UnvhfkWDrh8yTHwpI6UuTs-wgPMVliJjNlqBszYnvkR9",
        "image_url": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcSN6556UnvhfkWDrh8yTHwpI6UuTs-wgPMVliJjNlqBszYnvkR9",
        "rank": 41,
        "global_rank": 44
      },
      {
        "title": "Pets | Chipperton Photography | O'ahu, Hawaii",
        "link": "https://www.chipperton.com/miscellaneous",
        "logo": "https://encrypted-tbn2.gstatic.com/favicon-tbn?q=tbn:ANd9GcTh4y6sPQjksnsKM9IWhmiL952V2nkZbn3xzxXlA06J2eoNrYFnUIl5xRVNPfuqF4MOBp6kCDTG7zw03m_1kKyREjpux0h2ZCn8uVtrEgWFrutRQXoIjOU",
        "source": "Chipperton Photography",
        "image": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcRxj1r00B-N0vupC_pCybkL0LA56-SWZFHpBLWzYDO5Z8D01Ph1",
        "image_url": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcRxj1r00B-N0vupC_pCybkL0LA56-SWZFHpBLWzYDO5Z8D01Ph1",
        "rank": 42,
        "global_rank": 45
      },
      {
        "title": "无敌了！全国发货凯米尔色白色大脚银虎缅因猫幼崽，萌化你的每 ...",
        "link": "https://goods.taobao.com/t/_4423/ddaf7c84699233fbff139e745f548085.html",
        "logo": "https://encrypted-tbn2.gstatic.com/favicon-tbn?q=tbn:ANd9GcSeX25HcG4yQvnattuo8Ozi_yupe789ZUwKcK5BE8n_6WupRZoDBIIJwewsIoVi5PDhQ6Q7wASvEw2nLJiHdp7E26KkdodogchMguC1wXPWNKA5PWBp",
        "source": "Taobao.com",
        "image": "https://encrypted-tbn2.gstatic.com/images?q=tbn:ANd9GcS-7cbCCsvzc4nGQLQ3eFIvSkAS97eK_IzqnHSyPnp_HZvk0Kle",
        "image_url": "https://encrypted-tbn2.gstatic.com/images?q=tbn:ANd9GcS-7cbCCsvzc4nGQLQ3eFIvSkAS97eK_IzqnHSyPnp_HZvk0Kle",
        "rank": 43,
        "global_rank": 46
      },
      {
        "title": "Lenne (2019-2023) - Welkom bij Maine Coon Cattery AsKháMo",
        "link": "https://www.askhamo.com/in-memoriam/lenne-2019-2023/",
        "logo": "https://encrypted-tbn3.gstatic.com/favicon-tbn?q=tbn:ANd9GcT9eNhZpVoNF9TX62CROQDwShP00V3zPol_e3DE2sR7eXkTcCQaK1iVUETp4mNTuVDFup1_QqON_g-gVLOIjeA5OeDuSTNXe2I5PMmiDT_1ReM8QhU",
        "source": "askhamo.com",
        "image": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcRw4nLD4sV87-GdI-f1dkGHAQmV0G4t0uLQNlKnNSuanSu0bl-c",
        "image_url": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcRw4nLD4sV87-GdI-f1dkGHAQmV0G4t0uLQNlKnNSuanSu0bl-c",
        "rank": 44,
        "global_rank": 47
      },
      {
        "title": "Red Tabby Maine Coon Kitten Stock Photo - Download Image Now ...",
        "link": "https://www.istockphoto.com/photo/red-tabby-maine-coon-kitten-gm528976532-93176983",
        "logo": "https://encrypted-tbn3.gstatic.com/favicon-tbn?q=tbn:ANd9GcTOkSla3xBgSGY8Vxv3HRJORoHcom_0Lnxa4c9OyARUS6iOZa2CuyO7HRMfIn2Nkn3CbNnVyyX9pi45q3fZlr9Qfs6UX7FLxq_TAfsr6fWeezQZfSQGhVc6",
        "source": "iStock",
        "image": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcTS9WTUN3QQeNXryN1Idqh1MhtDm7rndJni9qJRYySBsdgsgXOR",
        "image_url": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcTS9WTUN3QQeNXryN1Idqh1MhtDm7rndJni9qJRYySBsdgsgXOR",
        "rank": 45,
        "global_rank": 48
      },
      {
        "title": "maine coon kitten mainecoon hobbyzucht aus hamburg",
        "link": "https://mainecoon-hamburg.de/deutsch/kitten_w.php",
        "logo": "https://encrypted-tbn3.gstatic.com/favicon-tbn?q=tbn:ANd9GcT6qmfYzy3fdQze-zbrvVnC_hW0fJPOojQDXI-Q0bLiFWzH8VfgUUT3a0OH0JpYS5K9u67srGaYusuhIhF62Ex8TXPuaA0PGkC7fhe54d4Ubhi1vqu03cxiPQ",
        "source": "mainecoon-hamburg.de",
        "image": "https://encrypted-tbn2.gstatic.com/images?q=tbn:ANd9GcT6jA4weIxUtUUb_juOozkdcChf7Km_yD2bEvsMnSJq6r5STtOx",
        "image_url": "https://encrypted-tbn2.gstatic.com/images?q=tbn:ANd9GcT6jA4weIxUtUUb_juOozkdcChf7Km_yD2bEvsMnSJq6r5STtOx",
        "rank": 46,
        "global_rank": 49
      },
      {
        "title": "Majestuoso Timon cada día más bello ♥️ @timonypumba_coon ...",
        "link": "https://www.instagram.com/p/C9GmdpityDA/",
        "logo": "https://encrypted-tbn3.gstatic.com/favicon-tbn?q=tbn:ANd9GcSpoKX-MM8KwYvjLm-JRx4G0Kwl8RLkE48NjkNQo2Gq3SC32GSp-nb0Bv1Gwdg0bIZuT7qIQcsQnlAbeKhfDsUARVp1OzzHay_AKGuFGTR9Of3S2pacaw",
        "source": "Instagram",
        "image": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcSKGbJYHXBHZNP5eMes_8jjWd77rcBOpWFYyAXWMo9UyzOcfruN",
        "image_url": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcSKGbJYHXBHZNP5eMes_8jjWd77rcBOpWFYyAXWMo9UyzOcfruN",
        "rank": 47,
        "global_rank": 50
      },
      {
        "title": "Рыжий полосатый биколорный котенок мейн-кун ...",
        "link": "https://ru.freepik.com/premium-photo/red-tabby-bicolour-maine-coon-kitten_31031137.htm",
        "logo": "https://encrypted-tbn2.gstatic.com/favicon-tbn?q=tbn:ANd9GcSsZFTTo1ow2OZzLRYRVvk-D-OkYsxjVIweSeVGTTzFNkyki7acUbAdBoGRnbaCuVTX8p0TxVZcFqx7ePsbSJNW-yvjy0DexoxlDoRK33YPs2CTZw",
        "source": "Freepik",
        "image": "https://encrypted-tbn3.gstatic.com/images?q=tbn:ANd9GcRcoHkAUREgVjIdHmLjSs45UOfSZUOuGlISYCyW3K6AbvspoVaM",
        "image_url": "https://encrypted-tbn3.gstatic.com/images?q=tbn:ANd9GcRcoHkAUREgVjIdHmLjSs45UOfSZUOuGlISYCyW3K6AbvspoVaM",
        "rank": 48,
        "global_rank": 51
      },
      {
        "title": "Padhington 🦁 Mainecoon on Instagram: “Do you think i could ...",
        "link": "https://in.pinterest.com/pin/cats--297659856627419519/",
        "logo": "https://encrypted-tbn2.gstatic.com/favicon-tbn?q=tbn:ANd9GcSYpax9-23w3k55h5fvk6iCbcYzKnm1qjhMsJ1P4Bb4O6gI2DZH7bYpZ5seEAXynHj3p4A6cHFAP_wbQ2CvnQYaOUp6ihp29pqECCB1pKH0MRnuasA6",
        "source": "Pinterest",
        "image": "https://encrypted-tbn2.gstatic.com/images?q=tbn:ANd9GcRM9Fzsd21B4QBto1_ty0XKP5DdtfYAysfKBJq_WBjiFwp9IGeV",
        "image_url": "https://encrypted-tbn2.gstatic.com/images?q=tbn:ANd9GcRM9Fzsd21B4QBto1_ty0XKP5DdtfYAysfKBJq_WBjiFwp9IGeV",
        "rank": 49,
        "global_rank": 52
      },
      {
        "title": "AEON Mall Makuhari Shintoshin｜猫カフェ MOCHA(モカ)",
        "link": "https://catmocha.jp/vi/shop/makuhari",
        "logo": "https://encrypted-tbn0.gstatic.com/favicon-tbn?q=tbn:ANd9GcS1927I_9mTpD59EqW47-SXfE5O0gNFrhRzclxOWqO07FNK3BKJSCWT9FMTuzSozLm7nEiytbxW6lRaTEJGQOowgAzP0ITPDm1zYicyOSvIpg",
        "source": "猫カフェ MOCHA",
        "image": "https://encrypted-tbn1.gstatic.com/images?q=tbn:ANd9GcThWx2c57dk4DQNxWSdxyAay20ry0okm-tsjVzMsfrOOlyvCP_8",
        "image_url": "https://encrypted-tbn1.gstatic.com/images?q=tbn:ANd9GcThWx2c57dk4DQNxWSdxyAay20ry0okm-tsjVzMsfrOOlyvCP_8",
        "rank": 50,
        "global_rank": 53
      },
      {
        "title": "Here's my gorgeous 2 year old red silver Maine coon Morris",
        "link": "https://www.facebook.com/groups/mainecoonsuk/posts/541747411467992/",
        "logo": "https://encrypted-tbn3.gstatic.com/favicon-tbn?q=tbn:ANd9GcRv794zBOQO02ChHD5K_TnlJwwf8PThFmn58OZAhQnomqvb1XKnHGAk8BQDBcyXho53FvXtsB2eVFSimUAzH3zcBAPC_yfttm2gkn07x3UumIdkepR5",
        "source": "Facebook",
        "image": "https://encrypted-tbn3.gstatic.com/images?q=tbn:ANd9GcQMp2LgbEWtTjNQi6S35hXQ03X7hu7ak0SroK9S9lxRlufouit2",
        "image_url": "https://encrypted-tbn3.gstatic.com/images?q=tbn:ANd9GcQMp2LgbEWtTjNQi6S35hXQ03X7hu7ak0SroK9S9lxRlufouit2",
        "rank": 51,
        "global_rank": 54
      },
      {
        "title": "Choáng váng chú mèo khổng lồ to gần bằng người | Báo điện tử ...",
        "link": "https://tienphong.vn/choang-vang-chu-meo-khong-lo-to-gan-bang-nguoi-post1071249.tpo",
        "logo": "https://encrypted-tbn2.gstatic.com/favicon-tbn?q=tbn:ANd9GcRCs_jSgp8oBD2KHVaMGzFUn-tld79q888hGrtpAjRYQFRselIgE1ta8ipmQJWjSKLih6spOjUXArSoXZ9YL_2p7CERcTrjROIxk0g-9Y3R9Fs",
        "source": "Báo điện tử Tiền Phong",
        "image": "https://encrypted-tbn3.gstatic.com/images?q=tbn:ANd9GcTYwBN8Bgs3VFk_hxs5qzNKMf9YVk4wSGrb9GUVW4AmK5b4TvAM",
        "image_url": "https://encrypted-tbn3.gstatic.com/images?q=tbn:ANd9GcTYwBN8Bgs3VFk_hxs5qzNKMf9YVk4wSGrb9GUVW4AmK5b4TvAM",
        "rank": 52,
        "global_rank": 55
      },
      {
        "title": "几元一斤和几十一斤的猫粮有区别吗，各有什么优缺点呢？_猫咪 ...",
        "link": "https://post.m.smzdm.com/p/a4xvzem8/",
        "logo": "https://encrypted-tbn0.gstatic.com/favicon-tbn?q=tbn:ANd9GcQiaRo_8LBdLeUqwHuU6NhcrDaA_MYP4SN4AKtM1QE2Jbfu3r_czS4NY6bzRAtLfBvZzGUjJUi7ox8k4Oqvakjfvv7LIQEIGfxm88r2bfSTe8BW5dGg",
        "source": "什么值得买",
        "image": "https://encrypted-tbn1.gstatic.com/images?q=tbn:ANd9GcTKiIKgPXzbgzLNSrqf9EenpYrCDo-VqucUCh6fG3zhbzYyiqlW",
        "image_url": "https://encrypted-tbn1.gstatic.com/images?q=tbn:ANd9GcTKiIKgPXzbgzLNSrqf9EenpYrCDo-VqucUCh6fG3zhbzYyiqlW",
        "rank": 53,
        "global_rank": 56
      },
      {
        "title": "Homepage - TapsiGiants",
        "link": "https://www.tapsigiants.com/",
        "logo": "https://encrypted-tbn3.gstatic.com/favicon-tbn?q=tbn:ANd9GcRXDc4ztHVARBzV6cn6aa5MwOxUMxxMHoV1Z5kIVaRojwwYHT0cLrs4Ql7835-Z-7lkZBShcjOAuEllRGejGaKpzUWtnCFoS7sSsL3tb-sZ2y96Pvb3eWlc",
        "source": "tapsigiants.com",
        "image": "https://encrypted-tbn1.gstatic.com/images?q=tbn:ANd9GcRcDalsy-jbo-2G984rTmtvODNTN64W2uUeCseBP8_2JvDFhvsy",
        "image_url": "https://encrypted-tbn1.gstatic.com/images?q=tbn:ANd9GcRcDalsy-jbo-2G984rTmtvODNTN64W2uUeCseBP8_2JvDFhvsy",
        "rank": 54,
        "global_rank": 57
      },
      {
        "title": "mèo Mỹ lông dài – RussiCat",
        "link": "https://meonhapkhau.com/tu-khoa-tim-kiem/meo-my-long-dai/",
        "logo": "https://encrypted-tbn3.gstatic.com/favicon-tbn?q=tbn:ANd9GcSEHCfO7o9Eh6BGAWjUj3xQZPda4bxgg-G6N46jWpjTilkO7ikFKHHXB93RjMOIf61rOsXyXQRgjec-VwzmIXrHjocXU-T1V74E5uLLBZObnGsQwiE",
        "source": "Mèo Nhập Khẩu",
        "image": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcQBFC31w8lZRVDaBO7V9EJKxdY5EXHNbHjnR0cE9scZuDM-9C4r",
        "image_url": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcQBFC31w8lZRVDaBO7V9EJKxdY5EXHNbHjnR0cE9scZuDM-9C4r",
        "rank": 55,
        "global_rank": 58
      },
      {
        "title": "Enjoy the wintersun | Georg Kohr | Flickr",
        "link": "https://www.flickr.com/photos/145593473@N02/33110211546/",
        "logo": "https://encrypted-tbn2.gstatic.com/favicon-tbn?q=tbn:ANd9GcTfrOu0sWKs3Pcw2QmgK3YJ56j2-ayOW-qRIJSQvaGvhVZy3tuULAELn-9WhCkJkgiSJmW8S2sgnoc74IbwPBg6aBaBJfMsZdN3QKOSPEQO0xq3oQ",
        "source": "Flickr",
        "image": "https://encrypted-tbn2.gstatic.com/images?q=tbn:ANd9GcRblVH-qXDE9QR4UT-yEKwFffj4jpbUE4D_ZZ1R1p1DJn6eeXOU",
        "image_url": "https://encrypted-tbn2.gstatic.com/images?q=tbn:ANd9GcRblVH-qXDE9QR4UT-yEKwFffj4jpbUE4D_ZZ1R1p1DJn6eeXOU",
        "rank": 56,
        "global_rank": 59
      },
      {
        "title": "Maine Coon Special Agent Kociaki - Kittens Poland",
        "link": "http://specialagent.ewitar.com.pl/Miot2J/Jantar.htm",
        "logo": "https://encrypted-tbn3.gstatic.com/favicon-tbn?q=tbn:ANd9GcRrxqQ9kzIVkJJMg5ITcNlo-fZp9fv2yJmbjpUB6CcW1ilNY5UMoSPbryod1qTj0ldOgvFVFDSPunGnvVgY14qrPS1OUl5uazxUWfnzhd92thAFUWreINH9TO-xIhcu",
        "source": "ewitar.com.pl",
        "image": "https://encrypted-tbn3.gstatic.com/images?q=tbn:ANd9GcT0VaTEUX7IvXhl5m_ad3hkrPg7vhn2L3Vv2P8UmE9jSitmq695",
        "image_url": "https://encrypted-tbn3.gstatic.com/images?q=tbn:ANd9GcT0VaTEUX7IvXhl5m_ad3hkrPg7vhn2L3Vv2P8UmE9jSitmq695",
        "rank": 57,
        "global_rank": 60
      },
      {
        "title": "gunillanoren.se - Katter",
        "link": "https://gunillanoren.com/katter",
        "logo": "https://encrypted-tbn1.gstatic.com/favicon-tbn?q=tbn:ANd9GcSqiHFClCLWiBi_608fT9Nmcl1Z_4kSCLfFjH4U-GBRAF6bcryW4zDYpOTDjVZun4JdjUxf26bzvcsI4hMqa6oMPXuCTz3-vxXzUkye2Y50b93p24sR",
        "source": "gunillanoren.com",
        "image": "https://encrypted-tbn2.gstatic.com/images?q=tbn:ANd9GcSjNQdURmcLW2qEhmaKT4Kdj-zIna4jDCP3mR7Y7csFfD1UmdJm",
        "image_url": "https://encrypted-tbn2.gstatic.com/images?q=tbn:ANd9GcSjNQdURmcLW2qEhmaKT4Kdj-zIna4jDCP3mR7Y7csFfD1UmdJm",
        "rank": 58,
        "global_rank": 61
      },
      {
        "title": "Mèo Maine Coon - Vi Sinh Cá Cảnh Aquarium Care",
        "link": "https://aquariumcare.vn/san-pham/396/meo-maine-coon.html",
        "logo": "https://encrypted-tbn2.gstatic.com/favicon-tbn?q=tbn:ANd9GcRj1qsON4rZlp8IQL3mgM-oMKzhEYbuo4O7N_jG7KpyTtjbnV0-gRyP371iuYwyPRJcKy7R52PQmzUtBULk5jpljUR_3h4QubPNQOHrrHR7G0XYlk8",
        "source": "Vi Sinh Cá Cảnh Aquarium Care",
        "image": "https://encrypted-tbn2.gstatic.com/images?q=tbn:ANd9GcSXQ_-JMXW7wI30EhWPQaUoBqDTAkttv4gYoirHIMxHmch7I8nP",
        "image_url": "https://encrypted-tbn2.gstatic.com/images?q=tbn:ANd9GcSXQ_-JMXW7wI30EhWPQaUoBqDTAkttv4gYoirHIMxHmch7I8nP",
        "rank": 59,
        "global_rank": 62
      }
    ],
    "related_search": [
      {
        "title": "Maine Coon",
        "link": "https://lens.google.com/search?sca_esv=b5143ed2853990e4&lns_surface=26&q=Maine+Coon&kgmid=/m/0j60j&sa=X&ved=2ahUKEwi4yqrvmJKTAxVLpCcCHdItHaYQ9_gLKAB6BQiHAhAB",
        "image": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQABAAD/2w...",
        "image_base64": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQABAAD/2w...",
        "rank": 1,
        "global_rank": 2
      },
      {
        "title": "Norwegian Forest Cat",
        "link": "https://lens.google.com/search?sca_esv=b5143ed2853990e4&lns_surface=26&q=Norwegian+Forest+Cat&kgmid=/m/017fsk&sa=X&ved=2ahUKEwi4yqrvmJKTAxVLpCcCHdItHaYQ9_gLKAF6BQiHAhAD",
        "image": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQABAAD/2w...",
        "image_base64": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQABAAD/2w...",
        "rank": 2,
        "global_rank": 3
      },
      {
        "title": "Siberian cat",
        "link": "https://lens.google.com/search?sca_esv=b5143ed2853990e4&lns_surface=26&q=Siberian+cat&kgmid=/m/02zkbf&sa=X&ved=2ahUKEwi4yqrvmJKTAxVLpCcCHdItHaYQ9_gLKAJ6BQiHAhAF",
        "image": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQABAAD/2w...",
        "image_base64": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQABAAD/2w...",
        "rank": 3,
        "global_rank": 4
      }
    ],
    "organic": [
      {
        "link": "https://www.shutterstock.com/vi/image-photo/ginger-cat-sleeps-on-pile-textile-2496921573",
        "source": "Shutterstock",
        "display_link": "https://www.shutterstock.com › image-photo › ginger-c...",
        "title": "Ginger Cat Sleeps On Pile TextileẢnh có sẵn2496921573",
        "extensions": [
          {
            "type": "text",
            "text": "25,00 US$",
            "rank": 1
          },
          {
            "type": "text",
            "text": "Còn hàng",
            "rank": 2
          }
        ],
        "icon": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAABwAAA...",
        "image": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcSHT4y2V82d2E_Amw_Pb5olsPIM0fXjBKNoNCdCdKwXrPIRBw30VpiJ&usqp=CAE&s",
        "image_url": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcSHT4y2V82d2E_Amw_Pb5olsPIM0fXjBKNoNCdCdKwXrPIRBw30VpiJ&usqp=CAE&s",
        "rank": 1,
        "global_rank": 63
      },
      {
        "link": "https://www.adagio.com/signature_blend/blend.html?blend=232279&srsltid=AfmBOooatupRsGtMf2j9jKFWLSq5Eb3mnJ8HjA8gFmUiLD2p-BQjWOHg",
        "source": "adagio.com",
        "display_link": "https://www.adagio.com › blend",
        "title": "American Bobtail - Adagio Teas",
        "extensions": [
          {
            "type": "text",
            "text": "14,00 US$",
            "rank": 1
          },
          {
            "type": "text",
            "text": "Còn hàng",
            "rank": 2
          }
        ],
        "icon": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAABwAAA...",
        "image": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcSc0slC2GsD_mZoWif5P39bAvRqS3FU3qn_tw-kcSF15XFBPOyWn3ES&usqp=CAE&s",
        "image_url": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcSc0slC2GsD_mZoWif5P39bAvRqS3FU3qn_tw-kcSF15XFBPOyWn3ES&usqp=CAE&s",
        "rank": 2,
        "global_rank": 64
      },
      {
        "link": "https://www.facebook.com/bbcattery/?locale=pt_BR",
        "source": "Facebook · Maine Coon Cattery Argentina",
        "display_link": ">1,8 N người theo dõi",
        "title": "Maine Coon Cattery Argentina | Buenos Aires",
        "icon": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAABwAAA...",
        "image": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcRcNsvubDFXpzAMnkde1xYoEWiTRpioJlIVKKAXvlCLQphQcBhKGe-S&usqp=CAE&s",
        "image_url": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcRcNsvubDFXpzAMnkde1xYoEWiTRpioJlIVKKAXvlCLQphQcBhKGe-S&usqp=CAE&s",
        "rank": 3,
        "global_rank": 65
      },
      {
        "link": "https://www.lordsandlabradors.co.uk/blogs/journal/cat-breeds-and-their-characteristics?srsltid=AfmBOor7hkIH6gq0ID2_xBa5Djyme-ejASOM4TwVlGW-kitWwDn39DQX",
        "source": "Lords & Labradors",
        "display_link": "https://www.lordsandlabradors.co.uk › ...",
        "title": "Cat Breeds and Their Characteristics | L&L Info Hub",
        "icon": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAACAAAA...",
        "image": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcTAMw4fY0rOUGp6r06qEJGgtJ7q1DIrzlm1WWZvP5s44PzKUyekUR4t&usqp=CAE&s",
        "image_url": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcTAMw4fY0rOUGp6r06qEJGgtJ7q1DIrzlm1WWZvP5s44PzKUyekUR4t&usqp=CAE&s",
        "rank": 4,
        "global_rank": 66
      },
      {
        "link": "https://www.yelp.com/biz/elara-eclipse-maine-coon-cattery-pinehurst",
        "source": "Yelp",
        "display_link": "https://www.yelp.com › biz › elara-ecl...",
        "title": "ELARA ECLIPSE MAINE COON CATTERY - Yelp",
        "icon": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAABwAAA...",
        "image": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcRY5TAhcrYHlj7QWweaK-6EhkiGxEvHfmFHcA9Zm9E&usqp=CAE&s",
        "image_url": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcRY5TAhcrYHlj7QWweaK-6EhkiGxEvHfmFHcA9Zm9E&usqp=CAE&s",
        "rank": 5,
        "global_rank": 67
      },
      {
        "link": "https://www.freepik.com/free-photos-vectors/purebred-cats/35",
        "source": "Freepik",
        "display_link": "https://www.freepik.com › purebred-c...",
        "title": "Page 35 | Purebred cats Images - Free Download on ...",
        "description": "Find & Download Free Graphic Resources for Purebred cats Vectors, Stock Photos & PSD files. ✓ Free for commercial use ✓ High Quality Images.",
        "icon": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAABwAAA...",
        "images": [
          {
            "image": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcRk0n_3Eld3jFsOYfYQZOdNNWHFSsUUtWKvr5yl-6M_n7-b7XWGCmk-_x7X7qPg9UMVWRxS&s",
            "image_url": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcRk0n_3Eld3jFsOYfYQZOdNNWHFSsUUtWKvr5yl-6M_n7-b7XWGCmk-_x7X7qPg9UMVWRxS&s"
          },
          {
            "image": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcRsFg-kGDTCuYeP4IP6qIAUShjd0sYfvLLZsw7ED5f7_4dok9xiM8xvgmM&s",
            "image_url": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcRsFg-kGDTCuYeP4IP6qIAUShjd0sYfvLLZsw7ED5f7_4dok9xiM8xvgmM&s"
          },
          {
            "image": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcQz_uyb1FbUWMei9f0qKWBQ2F4mfPonXMESPtGElYxSZpvipIAr7qBxMOQe&s",
            "image_url": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcQz_uyb1FbUWMei9f0qKWBQ2F4mfPonXMESPtGElYxSZpvipIAr7qBxMOQe&s"
          }
        ],
        "rank": 6,
        "global_rank": 68
      },
      {
        "link": "https://www.instagram.com/reel/DT3GLXQiHVr/",
        "source": "Instagram · mikhailazarenkov",
        "display_link": ">10 lượt thích · 1 tháng trước",
        "title": "Carina cats",
        "description": "15 likes, 0 comments - mikhailazarenkov on January 23, 2026: \"Carina cats\".",
        "icon": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAABwAAA...",
        "image": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcSKHMqtB3gq19t8wm3OYFXYxI5i6Mn_LnyZX6LLvl81dpMbdyCRF7j7SQ&s",
        "image_url": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcSKHMqtB3gq19t8wm3OYFXYxI5i6Mn_LnyZX6LLvl81dpMbdyCRF7j7SQ&s",
        "duration": "0:20",
        "duration_sec": 20,
        "rank": 7,
        "global_rank": 69
      },
      {
        "link": "https://www.missmainecoon.com/kefir",
        "source": "missmainecoon.com",
        "display_link": "https://www.missmainecoon.com › kefir",
        "title": "kefir | Kitties - Miss Maine Coon",
        "image": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcTDmwtbHpEnQX-ZGB-U7yqVVmBp1XEyEfoN3QaQtQlmyHOQ6NAuJ5vm&usqp=CAE&s",
        "image_url": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcTDmwtbHpEnQX-ZGB-U7yqVVmBp1XEyEfoN3QaQtQlmyHOQ6NAuJ5vm&usqp=CAE&s",
        "rank": 8,
        "global_rank": 70
      },
      {
        "link": "https://www.instagram.com/p/CzMjyVlviCW/",
        "source": "Instagram · dear.fig",
        "display_link": ">8,2 N lượt thích · 2 năm trước",
        "title": "Introducing my wonderful & wild zoo 🤗🐶 ... - Instagram",
        "icon": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAABwAAA...",
        "image": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcTnfbw4xXrCjgIGvU7G1DETerB4oJDMOEbR9e6Vwcu-Utz2jfV5MvqZ&usqp=CAE&s",
        "image_url": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcTnfbw4xXrCjgIGvU7G1DETerB4oJDMOEbR9e6Vwcu-Utz2jfV5MvqZ&usqp=CAE&s",
        "rank": 9,
        "global_rank": 71
      },
      {
        "link": "https://www.thesprucepets.com/orange-boy-cat-names-5114556",
        "source": "The Spruce Pets",
        "display_link": "https://www.thesprucepets.com › oran...",
        "title": "225 Orange Cat Names for Male Cats",
        "description": "18 thg 6, 2025 —",
        "extensions": [
          {
            "inline": true,
            "type": "text",
            "text": "18 thg 6, 2025",
            "rank": 1
          }
        ],
        "icon": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAABwAAA...",
        "image": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcT5T4oXZDS_w4SY3b5UF5_gt5qO38G6wjCg2iYRTJiDtolvxIDj2wBP&usqp=CAE&s",
        "image_url": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcT5T4oXZDS_w4SY3b5UF5_gt5qO38G6wjCg2iYRTJiDtolvxIDj2wBP&usqp=CAE&s",
        "rank": 10,
        "global_rank": 72
      }
    ]
  }
  ```
</ResponseExample>


# Visual matches
Source: https://docs.brightdata.com/api-reference/serp/google-lens/visual-matches

Configure the Bright Data Google Lens Visual Matches parameter to refine queries and return matching results as JSON or HTML. On port 44445.

```txt wrap theme={null}
https://lens.google.com/uploadbyurl?url=https%3A%2F%2Fwww.youtube.com%2Fimg%2Fdesktop%2Fyt_1200.png&brd_lens=visual_matches
```

## Parameters

<ParamField type="query">
  URL of image you want to search
</ParamField>

<ParamField type="string">
  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`).

  ```txt wrap theme={null}
  https://lens.google.com/uploadbyurl?url=https%3A%2F%2Fwww.youtube.com%2Fimg%2Fdesktop%2Fyt_1200.png&brd_lens=visual_matches
  ```
</ParamField>

<RequestExample>
  ```shell cURL highlight={6} theme={null}
    curl -X POST https://api.brightdata.com/request \
    --header "Content-Type: application/json" \
    --header "Authorization: Bearer API_KEY" \
    --data '{
      "zone": "serp_api1",
      "url": "https://lens.google.com/uploadbyurl?url=https%3A%2F%2Fwww.youtube.com%2Fimg%2Fdesktop%2Fyt_1200.png&brd_lens=visual_matches",
      "format": "raw"
    }'
  ```

  ```shell Native proxy highlight={4} theme={null}
  curl --proxy brd.superproxy.io:44445 \
    --proxy-user CUSTOMER_USERNAME:CUSTOMER_PASSWORD \
    --ssl-no-revoke \
    "https://lens.google.com/uploadbyurl?url=https%3A%2F%2Fwww.youtube.com%2Fimg%2Fdesktop%2Fyt_1200.png&brd_lens=visual_matches"
  ```

  ```js Node.js highlight={10} theme={null}
  (async () => {
    const response = await fetch('https://api.brightdata.com/request', {
      method: 'POST',
      headers: {
        'Content-Type': 'application/json',
        'Authorization': 'Bearer API_KEY'
      },
      body: JSON.stringify({
        zone: 'serp_api1',
        url: 'https://lens.google.com/uploadbyurl?url=https%3A%2F%2Fwww.youtube.com%2Fimg%2Fdesktop%2Fyt_1200.png&brd_lens=visual_matches',
        format: 'raw'
      })
    });
    
    const data = await response.text();
    console.log(data);
  })();
  ```

  ```python Python highlight={11} theme={null}
  import requests

  # API Configuration
  headers = {
      'Content-Type': 'application/json',
      'Authorization': 'Bearer API_KEY',
  }

  payload = {
      'zone': 'serp_api1',
      'url': 'https://lens.google.com/uploadbyurl?url=https%3A%2F%2Fwww.youtube.com%2Fimg%2Fdesktop%2Fyt_1200.png&brd_lens=visual_matches',
      'format': 'raw'
  }

  # Make the request
  response = requests.post(
      'https://api.brightdata.com/request', 
      json=payload, 
      headers=headers
  )

  print(response.text)
  ```
</RequestExample>

<ResponseExample>
  ```json 200 highlight={5} theme={null}
  {
    "general": {
      "language": "en",
      "mode": "search",
      "type": "visual_matches"
    },
    "tabs": [
      {
        "name": "AI Mode",
        "link": "https://www.google.com/search?sa=X&sca_esv=71ffffd766b5380a&lns_surface=26&biw=987&bih=1097&hl=en&gl=us&udm=50&vsrid=CKienZejr5684gEQAhgBIiQzNWFmNzM5NS0zM2Y4LTRkNmEtOThjYi01NjliM2E2Mjc2ZDIyBiICc2QoBTi4ueOU8PySAw&vsint=CAIqDAoCCAcSAggKGAEgATojChYNAAAAPxUAAAA_HQAAgD8lAACAPzABEIAIGIAIJQAAgD8&lns_mode=un&source=lns.web.gsbubu&vsdim=1024,1024&gsessionid=hitd2dN0jyWqgFfGjP_XnQPIvavy1d_VkxyabwBmHYuXXOL8cfIoFg&lsessionid=v7TCxI5b8d12uRO4bCJNRxNbkUm0dXpFWrm7z_WkPK3J6NVN2VpjMg&fbs=ADc_l-Yv0YTTwuvIVYRVntg99Yl4C2siJayzZyC50sFnWwRH6ow_bxUxJgqfeyXucYwXL8BodgQvcQKf4r6af6eJrUBEJPcPla2xArZ4O2zHdIqqQ1YVgeUF-eZ8YfKEFkJDuGVjK7bY&q=&aep=1&ntc=1&ved=2ahUKEwjXpfmV8PySAxVOUGwGHXIbGt4Q2J8OegQIDBAD"
      },
      {
        "name": "All",
        "type": "all",
        "link": "https://www.google.com/search?sa=X&sca_esv=71ffffd766b5380a&lns_surface=26&biw=987&bih=1097&hl=en&gl=us&udm=26&vsrid=CKienZejr5684gEQAhgBIiQzNWFmNzM5NS0zM2Y4LTRkNmEtOThjYi01NjliM2E2Mjc2ZDIyBiICc2QoBTi4ueOU8PySAw&vsint=CAIqDAoCCAcSAggKGAEgATojChYNAAAAPxUAAAA_HQAAgD8lAACAPzABEIAIGIAIJQAAgD8&lns_mode=un&source=lns.web.gsbubu&vsdim=1024,1024&gsessionid=hitd2dN0jyWqgFfGjP_XnQPIvavy1d_VkxyabwBmHYuXXOL8cfIoFg&lsessionid=v7TCxI5b8d12uRO4bCJNRxNbkUm0dXpFWrm7z_WkPK3J6NVN2VpjMg&q=&ved=2ahUKEwjXpfmV8PySAxVOUGwGHXIbGt4Qs6gLegQIDxAB"
      },
      {
        "name": "Exact matches",
        "type": "exact_matches",
        "link": "https://www.google.com/search?sa=X&sca_esv=71ffffd766b5380a&lns_surface=26&biw=987&bih=1097&hl=en&gl=us&udm=48&vsrid=CKienZejr5684gEQAhgBIiQzNWFmNzM5NS0zM2Y4LTRkNmEtOThjYi01NjliM2E2Mjc2ZDIyBiICc2QoBTi4ueOU8PySAw&vsint=CAIqDAoCCAcSAggKGAEgATojChYNAAAAPxUAAAA_HQAAgD8lAACAPzABEIAIGIAIJQAAgD8&lns_mode=un&source=lns.web.gsbubu&vsdim=1024,1024&gsessionid=hitd2dN0jyWqgFfGjP_XnQPIvavy1d_VkxyabwBmHYuXXOL8cfIoFg&lsessionid=v7TCxI5b8d12uRO4bCJNRxNbkUm0dXpFWrm7z_WkPK3J6NVN2VpjMg&vsrid=CKienZejr5684gEQAhgBIiQzODQ1Zjk3YS1kYjM0LTRlMDQtODMwNi1jNmYxYTM2Yzg4ODcyBiICc2QoBTi4ueOU8PySA1AA&q=&ved=2ahUKEwjXpfmV8PySAxVOUGwGHXIbGt4Qs6gLegQIDRAB"
      },
      {
        "name": "Visual matches",
        "type": "visual_matches",
        "selected": true
      },
      {
        "name": "About this image",
        "type": "about",
        "link": "https://www.google.com/search/about-this-image?img=H4sIAAAAAAAAAAFMALP_IkoKSAionp2Xo6-evOIBEAIYASIkMzVhZjczOTUtMzNmOC00ZDZhLTk4Y2ItNTY5YjNhNjI3NmQyMgYiAnNkKAU4uLnjlPD8kgNQAJs_T4BMAAAA&sa=X&ved=2ahUKEwjXpfmV8PySAxVOUGwGHXIbGt4Qs6gLegQIEBAB"
      }
    ],
    "images": [
      {
        "title": "YouTube gets a brand new logo and a new look for both mobile and desktop",
        "link": "https://www.androidauthority.com/youtube-new-logo-796482/",
        "logo": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAACAAAA...",
        "source": "Android Authority",
        "image": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAUUAAA...",
        "image_base64": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAUUAAA...",
        "rank": 1,
        "global_rank": 2
      }
    ],
    "exact_matches": [
      {
        "title": "Find Out Who Posts the Most Comments on Your YouTube Videos",
        "logo": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAACAAAA...",
        "source": "vidIQ",
        "image": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQABAAD/2w...",
        "image_base64": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQABAAD/2w...",
        "rank": 1,
        "global_rank": 1
      }
    ]
  }
  ```
</ResponseExample>


# Google Maps async request
Source: https://docs.brightdata.com/api-reference/serp/google-maps/async

Use the Bright Data Google Maps async endpoint (31 languages). Submit a request, poll the job ID and retrieve results as JSON with 200 OK on success.

```txt wrap theme={null}
https://www.google.com/maps/search/hotels+new+york
```

<ParamField type="boolean">
  Set `async=true` in the request URL to enable asynchronous requests.

  ```txt wrap theme={null}
  https://api.brightdata.com/request?async=true
  ```
</ParamField>

## Parameters

<ParamField type="string">
  The search path parameter. Specifies the keyword or phrase you want to search for on Google Maps.

  ```txt wrap theme={null}
  https://www.google.com/maps/search/hotels+new+york
  ```
</ParamField>

<RequestExample>
  ```shell cURL highlight={1} theme={null}
    curl -X POST https://api.brightdata.com/request?async=true \
    --header "Content-Type: application/json" \
    --header "Authorization: Bearer API_KEY" \
    --data '{
      "zone": "serp_api1",
      "url": "https://www.google.com/maps/search/hotels+new+york",
      "format": "raw"
    }'
  ```

  ```shell Native proxy highlight={4} theme={null}
  curl -i --silent --compressed \
    -H "Content-Type: application/json"
    -H "Authorization: Bearer API_KEY" \
    -d $'{"country":"us","query":{"q":"pizza"}}'
    "https://api.brightdata.com/serp/req?customer=CUSTOMER_USERNAME&zone=ZONE_NAME"
  ```

  ```js Node.js highlight={2} theme={null}
  (async () => {
    const response = await fetch('https://api.brightdata.com/request?async=true', {
      method: 'POST',
      headers: {
        'Content-Type': 'application/json',
        'Authorization': 'Bearer API_KEY'
      },
      body: JSON.stringify({
        zone: 'serp_api1',
        url: 'https://www.google.com/maps/search/hotels+new+york',
        format: 'raw'
      })
    });
    
    const data = await response.text();
    console.log(data);
  })();
  ```

  ```python Python highlight={17} theme={null}
  import requests

  # API Configuration
  headers = {
      'Content-Type': 'application/json',
      'Authorization': 'Bearer API_KEY',
  }

  payload = {
      'zone': 'serp_api1',
      'url': 'https://www.google.com/maps/search/hotels+new+york',
      'format': 'raw'
  }

  # Make the request
  response = requests.post(
      'https://api.brightdata.com/request?async=true', 
      json=payload, 
      headers=headers
  )

  print(response.text)
  ```
</RequestExample>


# Coordinates
Source: https://docs.brightdata.com/api-reference/serp/google-maps/coordinates

Configure the Bright Data Google Maps Coordinates parameter to refine queries and return matching results as JSON or HTML. On port 44445.

```txt wrap theme={null}
https://www.google.com/maps/search/service%20de%20transport/@47.30227,1.67458,14.00z
```

## Parameters

<ParamField type="string">
  The search path parameter. Specifies the keyword or phrase you want to search for on Google Maps.
</ParamField>

<ParamField type="string">
  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`

  ```txt wrap theme={null}
  https://www.google.com/maps/search/service%20de%20transport/@47.30227,1.67458,14.00z
  ```
</ParamField>

<RequestExample>
  ```shell cURL highlight={6} theme={null}
    curl -X POST https://api.brightdata.com/request \
    --header "Content-Type: application/json" \
    --header "Authorization: Bearer API_KEY" \
    --data '{
      "zone": "serp_api1",
      "url": "https://www.google.com/maps/search/hotels+new+york/@47.30227,1.67458,14.00z",
      "format": "raw"
    }'
  ```

  ```shell Native proxy highlight={4} theme={null}
  curl --proxy brd.superproxy.io:44445 \
    --proxy-user CUSTOMER_USERNAME:CUSTOMER_PASSWORD \
    --ssl-no-revoke \
    "https://www.google.com/maps/search/service%20de%20transport/@47.30227,1.67458,14.00z"
  ```

  ```js Node.js highlight={10} theme={null}
  (async () => {
    const response = await fetch('https://api.brightdata.com/request', {
      method: 'POST',
      headers: {
        'Content-Type': 'application/json',
        'Authorization': 'Bearer API_KEY'
      },
      body: JSON.stringify({
        zone: 'serp_api1',
        url: 'https://www.google.com/maps/search/hotels+new+york/@47.30227,1.67458,14.00z',
        format: 'raw'
      })
    });
    
    const data = await response.text();
    console.log(data);
  })();
  ```

  ```python Python highlight={11} theme={null}
  import requests

  # API Configuration
  headers = {
      'Content-Type': 'application/json',
      'Authorization': 'Bearer API_KEY',
  }

  payload = {
      'zone': 'serp_api1',
      'url': 'https://www.google.com/maps/search/hotels+new+york/@47.30227,1.67458,14.00z',
      'format': 'raw'
  }

  # Make the request
  response = requests.post(
      'https://api.brightdata.com/request', 
      json=payload, 
      headers=headers
  )

  print(response.text)
  ```
</RequestExample>


# Filtering
Source: https://docs.brightdata.com/api-reference/serp/google-maps/filtering

Configure the Bright Data Google Maps Filtering parameter to refine queries and return matching results as JSON or HTML. On port 44445.

```txt wrap theme={null}
https://www.google.com/maps/search/hotels+new+york/?brd_accommodation_type=vacation_rentals
```

## Parameters

<ParamField type="string">
  The search path parameter. Specifies the keyword or phrase you want to search for on Google Maps.
</ParamField>

<ParamField type="string">
  Accomodation type: Hotels or Vacation Rentals.

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

  ```txt wrap theme={null}
  https://www.google.com/maps/search/hotels+new+york/?brd_accommodation_type=vacation_rentals
  ```
</ParamField>

<RequestExample>
  ```shell cURL highlight={6} theme={null}
    curl -X POST https://api.brightdata.com/request \
    --header "Content-Type: application/json" \
    --header "Authorization: Bearer API_KEY" \
    --data '{
      "zone": "serp_api1",
      "url": "https://www.google.com/maps/search/hotels+new+york/?brd_accommodation_type=vacation_rentals",
      "format": "raw"
    }'
  ```

  ```shell Native proxy highlight={4} theme={null}
  curl --proxy brd.superproxy.io:44445 \
    --proxy-user CUSTOMER_USERNAME:CUSTOMER_PASSWORD \
    --ssl-no-revoke \
    "https://www.google.com/maps/search/hotels+new+york/?brd_accommodation_type=vacation_rentals"
  ```

  ```js Node.js highlight={10} theme={null}
  (async () => {
    const response = await fetch('https://api.brightdata.com/request', {
      method: 'POST',
      headers: {
        'Content-Type': 'application/json',
        'Authorization': 'Bearer API_KEY'
      },
      body: JSON.stringify({
        zone: 'serp_api1',
        url: 'https://www.google.com/maps/search/hotels+new+york/?brd_accommodation_type=vacation_rentals',
        format: 'raw'
      })
    });
    
    const data = await response.text();
    console.log(data);
  })();
  ```

  ```python Python highlight={11} theme={null}
  import requests

  # API Configuration
  headers = {
      'Content-Type': 'application/json',
      'Authorization': 'Bearer API_KEY',
  }

  payload = {
      'zone': 'serp_api1',
      'url': 'https://www.google.com/maps/search/hotels+new+york/?brd_accommodation_type=vacation_rentals',
      'format': 'raw'
  }

  # Make the request
  response = requests.post(
      'https://api.brightdata.com/request', 
      json=payload, 
      headers=headers
  )

  print(response.text)
  ```
</RequestExample>


# Google Maps localization
Source: https://docs.brightdata.com/api-reference/serp/google-maps/localization

Configure the Bright Data Google Maps Google Maps localization parameter to refine queries and return matching results as JSON or HTML. On port 44445.

```txt wrap theme={null}
https://www.google.com/maps/search/hotels+new+york/&gl=us&hl=en
```

## Parameters

<ParamField type="string">
  The search path parameter. Specifies the keyword or phrase you want to search for on Google Maps.
</ParamField>

<ParamField type="string">
  Two-letter country code used to define the country of search

  ```txt wrap theme={null}
  https://www.google.com/maps/search/hotels+new+york/?gl=us
  ```
</ParamField>

<ParamField type="string">
  Two-letter language code used to define the page languages

  ```txt wrap theme={null}
  https://www.google.com/maps/search/hotels+new+york/?hl=en
  ```
</ParamField>

<RequestExample>
  ```shell cURL highlight={6} theme={null}
    curl -X POST https://api.brightdata.com/request \
    --header "Content-Type: application/json" \
    --header "Authorization: Bearer API_KEY" \
    --data '{
      "zone": "serp_api1",
      "url": "https://www.google.com/maps/search/hotels+new+york/&gl=us&hl=en",
      "format": "raw"
    }'
  ```

  ```shell Native proxy highlight={4} theme={null}
  curl --proxy brd.superproxy.io:44445 \
    --proxy-user CUSTOMER_USERNAME:CUSTOMER_PASSWORD \
    --ssl-no-revoke \
    "https://www.google.com/maps/search/hotels+new+york/&gl=us&hl=en"
  ```

  ```js Node.js highlight={10} theme={null}
  (async () => {
    const response = await fetch('https://api.brightdata.com/request', {
      method: 'POST',
      headers: {
        'Content-Type': 'application/json',
        'Authorization': 'Bearer API_KEY'
      },
      body: JSON.stringify({
        zone: 'serp_api1',
        url: 'https://www.google.com/maps/search/hotels+new+york/&gl=us&hl=en',
        format: 'raw'
      })
    });
    
    const data = await response.text();
    console.log(data);
  })();
  ```

  ```python Python highlight={11} theme={null}
  import requests

  # API Configuration
  headers = {
      'Content-Type': 'application/json',
      'Authorization': 'Bearer API_KEY',
  }

  payload = {
      'zone': 'serp_api1',
      'url': 'https://www.google.com/maps/search/hotels+new+york/&gl=us&hl=en',
      'format': 'raw'
  }

  # Make the request
  response = requests.post(
      'https://api.brightdata.com/request', 
      json=payload, 
      headers=headers
  )

  print(response.text)
  ```
</RequestExample>


# Google Maps pagination
Source: https://docs.brightdata.com/api-reference/serp/google-maps/pagination

Configure the Bright Data Google Maps Google Maps pagination parameter to refine queries and return matching results as JSON or HTML. On port 44445.

<Danger>
  **Pagination parameters deprecated on December, 15th 2025.**
</Danger>

```txt wrap theme={null}
https://www.google.com/maps/search/hotels+new+york/?start=20
```

## Parameters

<ParamField type="string">
  The search path parameter. Specifies the keyword or phrase you want to search for on Google Maps.
</ParamField>

<ParamField type="string">
  Define the result offset - results to start from the selected value. Used for managing pagination.

  ```txt wrap theme={null}
  https://www.google.com/maps/search/hotels+new+york/?start=20
  ```
</ParamField>

<ParamField type="string">
  <Warning>
    **Deprecated As of September 11, 2025 by Google**

    * The Number of results to return is usually 10, results' set size may vary.
    * The `start` parameters can be used to paginate within results' set. 
    * To get top 100 results, Bright Data offes a Web Scraping API. Read more here: [Get top google 100 results in one API call](/scraping-automation/serp-api/get-top-100-google-results)
  </Warning>
</ParamField>

<RequestExample>
  ```shell cURL highlight={6} theme={null}
    curl -X POST https://api.brightdata.com/request \
    --header "Content-Type: application/json" \
    --header "Authorization: Bearer API_KEY" \
    --data '{
      "zone": "serp_api1",
      "url": "https://www.google.com/maps/search/hotels+new+york/?start=20",
      "format": "raw"
    }'
  ```

  ```shell Native proxy highlight={4} theme={null}
  curl --proxy brd.superproxy.io:44445 \
    --proxy-user CUSTOMER_USERNAME:CUSTOMER_PASSWORD \
    --ssl-no-revoke \
    "https://www.google.com/maps/search/hotels+new+york/?start=20"
  ```

  ```js Node.js highlight={10} theme={null}
  (async () => {
    const response = await fetch('https://api.brightdata.com/request', {
      method: 'POST',
      headers: {
        'Content-Type': 'application/json',
        'Authorization': 'Bearer API_KEY'
      },
      body: JSON.stringify({
        zone: 'serp_api1',
        url: 'https://www.google.com/maps/search/hotels+new+york/?start=20',
        format: 'raw'
      })
    });
    
    const data = await response.text();
    console.log(data);
  })();
  ```

  ```python Python highlight={11} theme={null}
  import requests

  # API Configuration
  headers = {
      'Content-Type': 'application/json',
      'Authorization': 'Bearer API_KEY',
  }

  payload = {
      'zone': 'serp_api1',
      'url': 'https://www.google.com/maps/search/hotels+new+york/?start=20',
      'format': 'raw'
  }

  # Make the request
  response = requests.post(
      'https://api.brightdata.com/request', 
      json=payload, 
      headers=headers
  )

  print(response.text)
  ```
</RequestExample>


# Google Maps parsed JSON
Source: https://docs.brightdata.com/api-reference/serp/google-maps/parsed-json

Configure the Bright Data Google Maps Google Maps parsed JSON parameter to refine queries and return matching results as JSON or HTML. On port 44445.

```txt wrap theme={null}
https://www.google.com/maps/search/hotels+new+york/?brd_json=json
```

## Parameters

<ParamField type="string">
  The search path parameter. Specifies the keyword or phrase you want to search for on Google Maps.
</ParamField>

<ParamField type="string">
  Set the `brd_json` parameter to `json` to get the results in JSON format.

  ```txt wrap theme={null}
  https://www.google.com/maps/search/hotels+new+york/?brd_json=json
  ```

  | value            | description                                                                                                         |
  | ---------------- | ------------------------------------------------------------------------------------------------------------------- |
  | `html` (default) | Returns the standard HTML response from Google Maps.                                                                |
  | `json`           | Returns the search results in a structured JSON format, making it easier to parse and extract specific data points. |
</ParamField>

<RequestExample>
  ```shell cURL highlight={6} theme={null}
    curl -X POST https://api.brightdata.com/request \
    --header "Content-Type: application/json" \
    --header "Authorization: Bearer API_KEY" \
    --data '{
      "zone": "serp_api1",
      "url": "https://www.google.com/maps/search/hotels+new+york/?brd_json=json",
      "format": "raw"
    }'
  ```

  ```shell Native proxy highlight={4} theme={null}
  curl --proxy brd.superproxy.io:44445 \
    --proxy-user CUSTOMER_USERNAME:CUSTOMER_PASSWORD \
    --ssl-no-revoke \
    "https://www.google.com/maps/search/hotels+new+york/?brd_json=json"
  ```

  ```js Node.js highlight={10} theme={null}
  (async () => {
    const response = await fetch('https://api.brightdata.com/request', {
      method: 'POST',
      headers: {
        'Content-Type': 'application/json',
        'Authorization': 'Bearer API_KEY'
      },
      body: JSON.stringify({
        zone: 'serp_api1',
        url: 'https://www.google.com/maps/search/hotels+new+york/?brd_json=json',
        format: 'raw'
      })
    });
    
    const data = await response.text();
    console.log(data);
  })();
  ```

  ```python Python highlight={11} theme={null}
  import requests

  # API Configuration
  headers = {
      'Content-Type': 'application/json',
      'Authorization': 'Bearer API_KEY',
  }

  payload = {
      'zone': 'serp_api1',
      'url': 'https://www.google.com/maps/search/hotels+new+york/?brd_json=json',
      'format': 'raw'
  }

  # Make the request
  response = requests.post(
      'https://api.brightdata.com/request', 
      json=payload, 
      headers=headers
  )

  print(response.text)
  ```
</RequestExample>


# Place details
Source: https://docs.brightdata.com/api-reference/serp/google-maps/place-details

Configure the Bright Data Google Maps Place Details parameter to refine queries and return matching results as JSON or HTML. On port 44445.

```txt wrap theme={null}
http://www.google.com/maps/place/data=!3m1!4b1!4m2!3m1!1s0x89e37742d0f37093:0xbc048b8a744ff75a
```

## Parameters

<ParamField type="string">
  The search path parameter. Specifies the keyword or phrase you want to search for on Google Maps.
</ParamField>

<ParamField type="string">
  Get the results of a Google Maps Place by `fid`.

  ```txt wrap theme={null}
  http://www.google.com/maps/place/data=!3m1!4b1!4m2!3m1!1s0x89e37742d0f37093:0xbc048b8a744ff75a
  ```
</ParamField>

<RequestExample>
  ```shell cURL highlight={6} theme={null}
    curl -X POST https://api.brightdata.com/request \
    --header "Content-Type: application/json" \
    --header "Authorization: Bearer API_KEY" \
    --data '{
      "zone": "serp_api1",
      "url": "http://www.google.com/maps/place/data=!3m1!4b1!4m2!3m1!1s0x89e37742d0f37093:0xbc048b8a744ff75a",
      "format": "raw"
    }'
  ```

  ```shell Native proxy highlight={4} theme={null}
  curl --proxy brd.superproxy.io:44445 \
    --proxy-user CUSTOMER_USERNAME:CUSTOMER_PASSWORD \
    --ssl-no-revoke \
    "http://www.google.com/maps/place/data=!3m1!4b1!4m2!3m1!1s0x89e37742d0f37093:0xbc048b8a744ff75a"
  ```

  ```js Node.js highlight={10} theme={null}
  (async () => {
    const response = await fetch('https://api.brightdata.com/request', {
      method: 'POST',
      headers: {
        'Content-Type': 'application/json',
        'Authorization': 'Bearer API_KEY'
      },
      body: JSON.stringify({
        zone: 'serp_api1',
        url: 'http://www.google.com/maps/place/data=!3m1!4b1!4m2!3m1!1s0x89e37742d0f37093:0xbc048b8a744ff75a',
        format: 'raw'
      })
    });
    
    const data = await response.text();
    console.log(data);
  })();
  ```

  ```python Python highlight={11} theme={null}
  import requests

  # API Configuration
  headers = {
      'Content-Type': 'application/json',
      'Authorization': 'Bearer API_KEY',
  }

  payload = {
      'zone': 'serp_api1',
      'url': 'http://www.google.com/maps/place/data=!3m1!4b1!4m2!3m1!1s0x89e37742d0f37093:0xbc048b8a744ff75a',
      'format': 'raw'
  }

  # Make the request
  response = requests.post(
      'https://api.brightdata.com/request', 
      json=payload, 
      headers=headers
  )

  print(response.text)
  ```
</RequestExample>


# Google Maps text search
Source: https://docs.brightdata.com/api-reference/serp/google-maps/text-search

Configure the Bright Data Google Maps Google Maps text search parameter to refine queries and return matching results as JSON or HTML. On port 44445.

```txt wrap theme={null}
https://www.google.com/maps/search/hotels+new+york
```

## Parameters

<ParamField type="string">
  The search path parameter. Specifies the keyword or phrase you want to search for on Google Maps.

  ```txt wrap theme={null}
  https://www.google.com/maps/search/hotels+new+york
  ```
</ParamField>

<RequestExample>
  ```shell cURL highlight={6} theme={null}
    curl -X POST https://api.brightdata.com/request \
    --header "Content-Type: application/json" \
    --header "Authorization: Bearer API_KEY" \
    --data '{
      "zone": "serp_api1",
      "url": "https://www.google.com/maps/search/hotels+new+york",
      "format": "raw"
    }'
  ```

  ```shell Native proxy highlight={4} theme={null}
  curl --proxy brd.superproxy.io:44445 \
    --proxy-user CUSTOMER_USERNAME:CUSTOMER_PASSWORD \
    --ssl-no-revoke \
    "https://www.google.com/maps/search/hotels+new+york"
  ```

  ```js Node.js highlight={10} theme={null}
  (async () => {
    const response = await fetch('https://api.brightdata.com/request', {
      method: 'POST',
      headers: {
        'Content-Type': 'application/json',
        'Authorization': 'Bearer API_KEY'
      },
      body: JSON.stringify({
        zone: 'serp_api1',
        url: 'https://www.google.com/maps/search/hotels+new+york',
        format: 'raw'
      })
    });
    
    const data = await response.text();
    console.log(data);
  })();
  ```

  ```python Python highlight={11} theme={null}
  import requests

  # API Configuration
  headers = {
      'Content-Type': 'application/json',
      'Authorization': 'Bearer API_KEY',
  }

  payload = {
      'zone': 'serp_api1',
      'url': 'https://www.google.com/maps/search/hotels+new+york',
      'format': 'raw'
  }

  # Make the request
  response = requests.post(
      'https://api.brightdata.com/request', 
      json=payload, 
      headers=headers
  )

  print(response.text)
  ```
</RequestExample>


# Google Reviews async request
Source: https://docs.brightdata.com/api-reference/serp/google-reviews/async

Use the Bright Data Google Reviews async endpoint (31 languages). Submit a request, poll the job ID and retrieve results as JSON with 200 OK on success.

```txt wrap theme={null}
https://www.google.com/reviews?fid=0x89c25855c0679529:0x2a34371cb33f3c80
```

<ParamField type="boolean">
  Set `async=true` in the request URL to enable asynchronous requests.

  ```txt wrap theme={null}
  https://api.brightdata.com/request?async=true
  ```
</ParamField>

## Parameters

<ParamField type="string">
  Feature id what you want to fetch reviews to. `fid` parameter can be found in `knowledge.fid` field of google search response.

  ```txt wrap theme={null}
  https://www.google.com/reviews?fid=0x89c25855c0679529:0x2a34371cb33f3c80
  ```
</ParamField>

<RequestExample>
  ```shell cURL highlight={1} theme={null}
    curl -X POST https://api.brightdata.com/request?async=true \
    --header "Content-Type: application/json" \
    --header "Authorization: Bearer API_KEY" \
    --data '{
      "zone": "serp_api1",
      "url": "https://www.google.com/reviews?fid=0x89c25855c0679529:0x2a34371cb33f3c80",
      "format": "raw"
    }'
  ```

  ```shell Native proxy highlight={4} theme={null}
  curl -i --silent --compressed \
    -H "Content-Type: application/json"
    -H "Authorization: Bearer API_KEY" \
    -d $'{"country":"us","query":{"q":"pizza"}}'
    "https://api.brightdata.com/serp/req?customer=CUSTOMER_USERNAME&zone=ZONE_NAME"
  ```

  ```js Node.js highlight={2} theme={null}
  (async () => {
    const response = await fetch('https://api.brightdata.com/request?async=true', {
      method: 'POST',
      headers: {
        'Content-Type': 'application/json',
        'Authorization': 'Bearer API_KEY'
      },
      body: JSON.stringify({
        zone: 'serp_api1',
        url: 'https://www.google.com/reviews?fid=0x89c25855c0679529:0x2a34371cb33f3c80',
        format: 'raw'
      })
    });
    
    const data = await response.text();
    console.log(data);
  })();
  ```

  ```python Python highlight={17} theme={null}
  import requests

  # API Configuration
  headers = {
      'Content-Type': 'application/json',
      'Authorization': 'Bearer API_KEY',
  }

  payload = {
      'zone': 'serp_api1',
      'url': 'https://www.google.com/reviews?fid=0x89c25855c0679529:0x2a34371cb33f3c80',
      'format': 'raw'
  }

  # Make the request
  response = requests.post(
      'https://api.brightdata.com/request?async=true', 
      json=payload, 
      headers=headers
  )

  print(response.text)
  ```
</RequestExample>

<ResponseExample>
  ```json 200 theme={null}
  {
    "reviews": [
      {
        "review_id": "ChdDSUhNMG9nS0VKeTJ0di1zNGFpLXF3RRAB",
        "reviewer": {
          "profile_photo_url": "https://lh3.googleusercontent.com/local-reviews/AJMZ0Qczn4VDfUM6-AtEt-6oaNazFa-i9Fy6kqPVfGIlPil6vJulEYyK8t930jZwOW4hD80mzw=s120-c-br100",
          "display_name": "DLSharpsteen",
          "link": "https://www.tripadvisor.com/ShowUserReviews-g60763-d611947-r1045281816?m=68573&staydates=2026_03_08_2026_03_09&uguests=1_2_0&supdv=desktop&supuc=BF&supul=en"
        },
        "link": "https://www.tripadvisor.com/ShowUserReviews-g60763-d611947-r1045281816?m=68573&staydates=2026_03_08_2026_03_09&uguests=1_2_0&supdv=desktop&supuc=BF&supul=en",
        "source": "Tripadvisor",
        "source_logo": "https://www.gstatic.com/travel-hotels/branding/icon_100532569.png",
        "rating": "5/5",
        "created": "a month ago",
        "comment": "We traveled to NYC to watch The Christmas Spectacular at the Radio City Music Hall and stayed at the Hilton for the night. We loved the location as it was within of 5 minute walking distance of literally everything there is to see at Christmas time. Our room was quite spacious and clean with two full beds and a nice view. Staff was friendly and I loved that you can get there early and check in your bags so you can go explore before check in time as we arrived to the city around noon. Also loved that there was parking on site. We used the valet so you pulled in, got everything out you would need, they give you a card with a number and you walk into the doors and right to the luggage storage area. The elevator system is insane and that's my only complaint. I've never stayed in a hotel where you have to put in your room number and can only ride a certain elevator to your room. Seemed our elevators were always the ones with tons of people waiting to get on or off. The only outside noise you could hear were horns, but I was ok with that and thankful I never heard my neighbors or anyone in the halls. I got an insane discount on my room through my employer otherwise I would never be able to stay here during Christmastime. But I understand why the rate is so high as it is a hotel that sits in the middle of all the amazing attractions NYC has to offer. Would definitely stay here again!"
      },
      {
        "review_id": "Ci9DQUlRQUNvZENodHljRjlvT2tRNFRVOXVUVE51YXpKVVdHb3laV3R5TjNScmRuYxAB",
        "reviewer": {
          "profile_photo_url": "https://lh3.googleusercontent.com/a-/ALV-UjXfHOWf_k3xFLr7N87GuvjsQHzsDSZb3FW1zjSl6LV32uKV4qI=s120-c-rp-mo-ba4-br100",
          "display_name": "Brian Ash",
          "link": "https://www.google.com/maps/contrib/109749787540014073287?hl=en"
        },
        "link": "https://www.google.com/maps/reviews/data=!4m8!14m7!1m6!2m5!1sCi9DQUlRQUNvZENodHljRjlvT2tRNFRVOXVUVE51YXpKVVdHb3laV3R5TjNScmRuYxAB!2m1!1s0x0:0x2a34371cb33f3c80!3m1!1s2@1:CAIQACodChtycF9oOkQ4TU9uTTNuazJUWGoyZWtyN3Rrdnc%7C0dK0Oisp5f4%7C?hl=en",
        "source": "Google",
        "source_logo": "https://www.gstatic.com/images/branding/product/1x/googleg_48dp.png",
        "rating": "4/5",
        "created": "a month ago",
        "date": "2025-12-30",
        "comment": "The staff here were friendly and helpful. Everyone was cheerful and considerate. The staff here made our experience pleasant and memorable. The rooms were nice, but the location is perfect if you want to be in thick of the hustle and bustle of the city. Conveniently located, great facilities and a room rate that won’t break the bank. I wouldn’t hesitate to book again.",
        "review_reply": "Dear Brian,\nThank you for the wonderful review. We are glad to hear our team’s friendliness and positive energy helped make your stay pleasant and memorable. It is great to know you enjoyed the room, facilities, and our convenient location, along with a rate that added value to your visit. We truly appreciate your recommendation and look forward to welcoming you back again.\n\nSincerely,\n\nNew York Hilton Midtown Team\n\nNYCNH_FO@hilton.com",
        "review_reply_created": "a month ago",
        "photos": [
          "https://lh3.googleusercontent.com/geougc-cs/ABOP9psEgneI8FIdEeGP0U0DKFzwPjUbeMcfWkr7I6LvoCMXzPz_f8qvhEnl6IrGg73jlvLo1xOLrtjDLM7BY9doDWY9GddvM4JckW6EY8Bi5-GN7IzokII2PtHT99mWEr3bEWjh0RBhA7KKeVk",
          "https://lh3.googleusercontent.com/geougc-cs/ABOP9psP7Yx2Swd3UOEIevzruzpKAerYUdMJPXETQJt-A3SrKXcnHP4Cy0TLirJExW50cQ_kzoUUnZLHzfu-tUwtz_Kp_4yUSeqjo4Tm-BK1z9D6CmokJrkvo9QCtYAG7hjERaHOzibyBzSLaHlz",
          "https://lh3.googleusercontent.com/geougc-cs/ABOP9pun-0zZPPEzWSkW_XUq8eHQSze3imSI7iMEq9_29WwJJdM82HBq3LwycenRdrTRIt70jyr3jPd4kiIABo-GdwhMJ6jd3QbOjrBuq4xfzs9OPPW_DEu52MrDQK0MnY8vgRQG8wfId5sLZtau",
          "https://lh3.googleusercontent.com/geougc-cs/ABOP9pvs0bS1DXsAMv1l2rUc2o5O3r07JiEVr2mXuo8_HxN-e47l0YqBxSfHQCGATeYbu059C-Gh9Om5nIuuoXGKbx-VqSFcovQuuboYcXxg9r4AOkj8y_1Atv5LieCvzZNjKt2lP_EIFUmpNIzv",
          "https://lh3.googleusercontent.com/geougc-cs/ABOP9pvGyxLHYBHrq2Xjc1_XkBMitY3PltgQXVrpUHliY22qm1juTnbcQM9Dppxgbb-YeCgQjzlWuEHfe22uXMf2LyAtWpiNnKrN62zNG5SeDhCZiGYwMDpp6TLNTVPWGcJgeTH7ozM12r70coMx",
          "https://lh3.googleusercontent.com/geougc-cs/ABOP9ptnOwAnTti7y3hrhxJ7TVOyrr9FmaGP1YvVDgo5ca-Mokl4thE-Ds1t9oaM_v6ofHs6MheZ1g02rNAsUlQqc0dRArJXKwYp8JAwhFQPOz0Cel9gu645rgw4O26EzLm1PkYHwzci7D_Wewdf",
          "https://lh3.googleusercontent.com/geougc-cs/ABOP9pu4U-BFG3nJCIUa3yMRZFr2NWas-3A1PUlCsROljZC05rtJhDHjDqd50W5ucTMpu8ywsM7yFNZLywcjhgKaXWqWsIHQtWJdOhAnQlsaq30fmt-3NNu3FISJ1wB1p-TvteQ-A3kcyAVZlkHb",
          "https://lh3.googleusercontent.com/geougc-cs/ABOP9pu8TqvQu_MO3rNMEH_5qVZ5fUYMHgVnS4PWsnKI2EVxPvBBiRZuwVhJLUZfKGxS6mnZMMKRfJB5KYlk2T7eZ1fNk6wqqGENrmoaYnGdqMcQm3CaV2OKSbYMAEcZRGstJI13u37JVn6_dsjI"
        ],
        "details": [
          {
            "id": "HOTELS_PILOT_TRIP_TYPE",
            "name": "Trip type",
            "value": "Vacation",
            "description": "What kind of trip was it?"
          },
          {
            "id": "HOTELS_PILOT_TRAVEL_GROUP_TYPE",
            "name": "Travel group",
            "value": "Couple",
            "description": "Who did you travel with?"
          },
          {
            "id": "HOTELS_ASPECT_ROOMS",
            "name": "Rooms",
            "value": 3,
            "description": "Rooms"
          },
          {
            "id": "HOTELS_ASPECT_SERVICES",
            "name": "Service",
            "value": 4,
            "description": "Service"
          },
          {
            "id": "HOTELS_ASPECT_LOCATION",
            "name": "Location",
            "value": 5,
            "description": "Location"
          },
          {
            "id": "HOTELS_VIBE",
            "name": "Hotel highlights",
            "value": "Great view",
            "description": "How would you describe the hotel?"
          }
        ]
      },
      {
        "review_id": "Ci9DQUlRQUNvZENodHljRjlvT2t0eVMzWjJjbk5tUWt0TGFFcG5kVU5XWTFvMGQwRRAB",
        "reviewer": {
          "profile_photo_url": "https://lh3.googleusercontent.com/a/ACg8ocIb_1I5stFL2E46ANU5a9D1tE37bd7z3TrcvcjeCv8jbP01sQ=s120-c-rp-mo-ba4-br100",
          "display_name": "Diana Nichols",
          "link": "https://www.google.com/maps/contrib/104268723670363283044?hl=en"
        },
        "link": "https://www.google.com/maps/reviews/data=!4m8!14m7!1m6!2m5!1sCi9DQUlRQUNvZENodHljRjlvT2t0eVMzWjJjbk5tUWt0TGFFcG5kVU5XWTFvMGQwRRAB!2m1!1s0x0:0x2a34371cb33f3c80!3m1!1s2@1:CAIQACodChtycF9oOktyS3Z2cnNmQktLaEpndUNWY1o0d0E%7C0dKeRXjPbb4%7C?hl=en",
        "source": "Google",
        "source_logo": "https://www.gstatic.com/images/branding/product/1x/googleg_48dp.png",
        "rating": "5/5",
        "created": "a month ago",
        "comment": "Absolutely the best stay in the world! My room was clean and quiet and had everything I needed. The room was much bigger than I expected for NYC. Shout out to housekeeping who didn’t make a peep in the hallways as they cleaned the vacant rooms. I didn’t leave until around 2pm so they were working hard. Many hotels (even the best of the best) have housekeepers who talk too loudly in the hallways and constantly slam doors. Not here! They were perfect and I didn’t even know they were there until I left. Can’t tell you how much I appreciate that. Tons of security and police presence for the upcoming celebration (New Year’s) or maybe it’s always like that here. Felt extremely safe and protected. Beautiful spacious clean sparkling lobby. Many upscale shops and stores I didn’t have time to visit. Glistening with inviting items to purchase and view. Wish I would have gone into the shops! The staff was very very friendly from the front desk to the security guard who answered all my questions last night about transportation to JFK and local things to visit near the hotel. The man mopping the floor was super friendly (this was around 1am) trying to give me directions for the subway train etc for the next day to JFK. I had the best latte from the wonderful friendly cafe near the lobby. Everything clean and welcoming and beautifully displayed. I decided to take a taxi to JFK\nand asked for a “nice” taxi driver. The gentleman supervising the taxi line immediately made way for me through the throngs of folks on the street and treated me like a celebrity as he directed me to the next available ride. He didn’t laugh at me and I did get the nicest taxi driver - Fabian!!!  I was given excellent directions to get to the airport in JFK by the transportation and show tickets desk and they explained how to take the train bus subway etc but it seemed a little more difficult than I was in the mood for. The energy out on the street was electric and I also wish I had walked around a little before I left the city. This hotel is convenient to everything! Can’t ask for anything more than the wonderful experience I had at this hotel. Thank you everyone who works there and outside and Happy New Year!!!",
        "review_reply": "Dear Diana,\nIt's an absolute pleasure to learn about the exceptional visit you had with us, and we thank you for your perfect marks. Thank you for also going out of your way to spotlight our safe, welcoming facilities and unbeatable New York location. Of course, we'll be sure our team hears they really made a difference with their outstanding service, and we look forward to seeing you again soon here at New York Hilton Midtown for another unforgettable experience.\n\nSincerely,\n\nNew York Hilton Midtown Team\n\nNYCNH_FO@hilton.com",
        "review_reply_created": "a month ago",
        "details": [
          {
            "id": "HOTELS_PILOT_TRIP_TYPE",
            "name": "Trip type",
            "value": "Business",
            "description": "What kind of trip was it?"
          },
          {
            "id": "HOTELS_PILOT_TRAVEL_GROUP_TYPE",
            "name": "Travel group",
            "value": "Solo",
            "description": "Who did you travel with?"
          },
          {
            "id": "HOTELS_ASPECT_ROOMS",
            "name": "Rooms",
            "value": 5,
            "description": "Rooms"
          },
          {
            "id": "HOTELS_ASPECT_SERVICES",
            "name": "Service",
            "value": 5,
            "description": "Service"
          },
          {
            "id": "HOTELS_ASPECT_LOCATION",
            "name": "Location",
            "value": 5,
            "description": "Location"
          },
          {
            "id": "HOTELS_TIPS_TOPICS_ROOMS",
            "name": "Rooms",
            "value": "My room was perfect and bigger than I expected for NYC.",
            "description": "Rooms"
          },
          {
            "id": "HOTELS_TIPS_TOPICS_SAFETY",
            "name": "Safety",
            "value": "Lots of police officers around! Felt extremely safe.",
            "description": "Safety"
          },
          {
            "id": "HOTELS_TIPS_TOPICS_NOTEWORTHY_DETAILS",
            "name": "Noteworthy details",
            "value": "I just found everyone super friendly. Maybe because I love the people and the energy in NYC anyway.",
            "description": "Noteworthy details"
          },
          {
            "id": "HOTELS_VIBE",
            "name": "Hotel highlights",
            "value": "Luxury",
            "description": "How would you describe the hotel?"
          }
        ]
      },
      {
        "review_id": "Ci9DQUlRQUNvZENodHljRjlvT25ReVRFUTJiV0ZNUkdVNFduaFNTMnh6VmpGSU5uYxAB",
        "reviewer": {
          "profile_photo_url": "https://lh3.googleusercontent.com/a-/ALV-UjXmcoJ3y3xhQX30wsKy5q87OD7qFUR6FDUsw_QDL8EWl8-nUSQ=s120-c-rp-mo-ba3-br100",
          "display_name": "Natiesha Wray Henry",
          "link": "https://www.google.com/maps/contrib/102270227746850983681?hl=en"
        },
        "link": "https://www.google.com/maps/reviews/data=!4m8!14m7!1m6!2m5!1sCi9DQUlRQUNvZENodHljRjlvT25ReVRFUTJiV0ZNUkdVNFduaFNTMnh6VmpGSU5uYxAB!2m1!1s0x0:0x2a34371cb33f3c80!3m1!1s2@1:CAIQACodChtycF9oOnQyTEQ2bWFMRGU4WnhSS2xzVjFINnc%7C0dKxrV3ZLWB%7C?hl=en",
        "source": "Google",
        "source_logo": "https://www.gstatic.com/images/branding/product/1x/googleg_48dp.png",
        "rating": "5/5",
        "created": "a month ago",
        "comment": "Location, Location,  Location! This hotel made adventuring in Manhattan a breeze. Central Park, Radio City, Rockefeller Center, were all so close, there was simply no excuse to not take a walk and be in all the action. We loved to food trucks and vendors near by but we also enjoyed the walkable restaurants close by as well. Staff and facilities were great. I'm so happy we stayed here.",
        "review_reply": "Dear Natiesha,\nThank you for sharing your wonderful experience with us! It's great that our prime location, close to New York's best attractions and dining options, enhanced your visit. We're also happy that our friendly service added to your experience. It was a pleasure having you as our guest, and we look forward to welcoming you back for another memorable stay.\n\nSincerely,\n\nNew York Hilton Midtown Team\n\nNYCNH_FO@hilton.com",
        "review_reply_created": "a month ago",
        "details": [
          {
            "id": "HOTELS_PILOT_TRIP_TYPE",
            "name": "Trip type",
            "value": "Vacation",
            "description": "What kind of trip was it?"
          },
          {
            "id": "HOTELS_PILOT_TRAVEL_GROUP_TYPE",
            "name": "Travel group",
            "value": "Family",
            "description": "Who did you travel with?"
          },
          {
            "id": "HOTELS_ASPECT_ROOMS",
            "name": "Rooms",
            "value": 5,
            "description": "Rooms"
          },
          {
            "id": "HOTELS_ASPECT_SERVICES",
            "name": "Service",
            "value": 5,
            "description": "Service"
          },
          {
            "id": "HOTELS_ASPECT_LOCATION",
            "name": "Location",
            "value": 5,
            "description": "Location"
          },
          {
            "id": "HOTELS_TIPS_TOPICS_ROOMS",
            "name": "Rooms",
            "value": "Cozy and comfortable",
            "description": "Rooms"
          },
          {
            "id": "HOTELS_TIPS_TOPICS_NEARBY_ACTIVITIES",
            "name": "Nearby activities",
            "value": "Times Square is walkable from here",
            "description": "Nearby activities"
          },
          {
            "id": "HOTELS_TIPS_TOPICS_WALKABILITY",
            "name": "Walkability",
            "value": "10 out of 10",
            "description": "Walkability"
          },
          {
            "id": "HOTELS_TIPS_TOPICS_NOTEWORTHY_DETAILS",
            "name": "Noteworthy details",
            "value": "Parking and traffic is a nightmare.",
            "description": "Noteworthy details"
          },
          {
            "id": "HOTELS_VIBE",
            "name": "Hotel highlights",
            "value": "Kid-friendly",
            "description": "How would you describe the hotel?"
          }
        ]
      },
      {
        "review_id": "ChdDSUhNMG9nS0VQdnIyOHU1LVppVGlBRRAB",
        "reviewer": {
          "profile_photo_url": "https://lh3.googleusercontent.com/local-reviews/AJMZ0QfnSFWXMd1oJu73a6IhdtgibYcjse2HKQTHeghNQd9Cyw8DYQQJZDCyh-TD68ehXuY-FA=s120-c-br100",
          "display_name": "R471LZalext",
          "link": "https://www.tripadvisor.com/ShowUserReviews-g60763-d1379306-r1043196288?m=68573&staydates=2026_03_08_2026_03_09&uguests=1_2_0&supdv=desktop&supuc=BF&supul=en"
        },
        "link": "https://www.tripadvisor.com/ShowUserReviews-g60763-d1379306-r1043196288?m=68573&staydates=2026_03_08_2026_03_09&uguests=1_2_0&supdv=desktop&supuc=BF&supul=en",
        "source": "Tripadvisor",
        "source_logo": "https://www.gstatic.com/travel-hotels/branding/icon_100532569.png",
        "rating": "3/5",
        "created": "2 months ago",
        "comment": "Room was ok. For a Hilton I thought it would be better. Could do with an update with better placed plug sockets and some USB sockets. It is 2025 and people need multiple sockets to charge phones, tablets, watches etc.||Staff were underwhelming. Our flight home was cancelled and we had to find accommodation for another night. I understand they couldn’t accept us as they were fully booked. I would have appreciated some sort of effort to see if other Hilton hotels available but no, just a shrug of the shoulders pretty much and left to sort ourselves out. I understand that it is probably over there pay grade. However, a phone call or some sort of contact with other Hilton hotels would have been put our anxiety at ease. I am disappointed because i expect staff from the Hilton brand would excel at customer service, but they didn’t. They would’ve earned a decent tip from it. ||Only 2 things impressed me. The coffee machine in our room and the cleaning staff. They always did a superb job."
      },
      {
        "review_id": "Ci9DQUlRQUNvZENodHljRjlvT2pKdk5FdHVMVW8xTjFoT2MzUjJlamQyV0hSTk4wRRAB",
        "reviewer": {
          "profile_photo_url": "https://lh3.googleusercontent.com/a/ACg8ocKxAYr7LFV6ZMNckj3q8VKiPdMIZXgCzt920CSu2v1nYG3GzQ=s120-c-rp-mo-ba4-br100",
          "display_name": "Elia Alejandra",
          "link": "https://www.google.com/maps/contrib/107082141027365570078?hl=en"
        },
        "link": "https://www.google.com/maps/reviews/data=!4m8!14m7!1m6!2m5!1sCi9DQUlRQUNvZENodHljRjlvT2pKdk5FdHVMVW8xTjFoT2MzUjJlamQyV0hSTk4wRRAB!2m1!1s0x0:0x2a34371cb33f3c80!3m1!1s2@1:CAIQACodChtycF9oOjJvNEtuLUo1N1hOc3R2ejd2WHRNN0E%7C0d6T99EL24S%7C?hl=en",
        "source": "Google",
        "source_logo": "https://www.gstatic.com/images/branding/product/1x/googleg_48dp.png",
        "rating": "2/5",
        "created": "3 months ago",
        "comment": "Room had a nice view. Staff was friendly.\nRoom was dirty when we walked in. There were hairs in the bathtub, and sink wasn’t very clean. Restrooms and rooms along with furniture are very old! Bedsheets had some hairs and not very clean. Room was cleaned once out of 4 days so it’s not daily. They do give you a 35$ voucher for the cafe they have and 25$ for their services. Luggage hold is free if you get there early but they charge 5$ a piece if you need to check out of your room but still have time before the airport. Elevators are nice they have a system that makes it run smoother.\nHotel seems very central so that’s a good thing. Lots of things around but that’s just New York.\nOver all because of how old rooms seems and how dirty it was 2/5. Wouldn’t stay here again .",
        "review_reply": "Dear Elia,\nThank you for taking the time to share such detailed feedback. We’re glad to hear you enjoyed the wonderful view, the fantastic location, and the friendliness of the team, but we’re truly sorry to learn that the room did not meet expectations during your stay. Your comments about cleanliness, upkeep, and service frequency are important, and they’ll be shared with the appropriate teams so we can take a closer look. We appreciate you noting the helpful amenities like the café credit, services credit, luggage storage, and elevator system as well. We’re grateful for your perspective and hope the rest of your time in New York City was wonderful.\n\nSincerely,\n\nNew York Hilton Midtown Team\n\nNYCNH_FO@hilton.com",
        "review_reply_created": "3 months ago",
        "details": [
          {
            "id": "HOTELS_PILOT_TRIP_TYPE",
            "name": "Trip type",
            "value": "Vacation",
            "description": "What kind of trip was it?"
          },
          {
            "id": "HOTELS_PILOT_TRAVEL_GROUP_TYPE",
            "name": "Travel group",
            "value": "Family",
            "description": "Who did you travel with?"
          },
          {
            "id": "HOTELS_ASPECT_ROOMS",
            "name": "Rooms",
            "value": 1,
            "description": "Rooms"
          },
          {
            "id": "HOTELS_ASPECT_SERVICES",
            "name": "Service",
            "value": 3,
            "description": "Service"
          },
          {
            "id": "HOTELS_ASPECT_LOCATION",
            "name": "Location",
            "value": 4,
            "description": "Location"
          }
        ]
      },
      {
        "review_id": "Ci9DQUlRQUNvZENodHljRjlvT2xWbGRIaHFUblkzZFdaaFdITlNRMlZNZDE5bmNHYxAB",
        "reviewer": {
          "profile_photo_url": "https://lh3.googleusercontent.com/a-/ALV-UjUizL79_bwGWMDpI7JDM4zojb6e6Ufpryfw23XnFxFSFJMHriK_=s120-c-rp-mo-ba3-br100",
          "display_name": "Amanda Garcia",
          "link": "https://www.google.com/maps/contrib/102898602342998029792?hl=en"
        },
        "link": "https://www.google.com/maps/reviews/data=!4m8!14m7!1m6!2m5!1sCi9DQUlRQUNvZENodHljRjlvT2xWbGRIaHFUblkzZFdaaFdITlNRMlZNZDE5bmNHYxAB!2m1!1s0x0:0x2a34371cb33f3c80!3m1!1s2@1:CAIQACodChtycF9oOlVldHhqTnY3dWZhWHNSQ2VMd19ncGc%7C0dGM04hI_ys%7C?hl=en",
        "source": "Google",
        "source_logo": "https://www.gstatic.com/images/branding/product/1x/googleg_48dp.png",
        "rating": "5/5",
        "created": "2 months ago",
        "comment": "From the moment we arrived, our experience at this hotel was nothing short of exceptional. The property is beautiful, impeccably clean, and thoughtfully designed for comfort and relaxation. Every detail reflected true five-star quality.\nWhat truly made our stay unforgettable was the incredible staff. The team went above and beyond to make us feel welcomed and valued. Special recognition to Lek at concierge, Christina in housekeeping, Brian and Joland at front desk for their professionalism, warmth, and genuine care. Their attentiveness and willingness to assist with every request during our stay as we celebrate a birthday made a lasting impression.\nHousekeeping was flawless, the amenities were excellent, and the overall atmosphere was both luxurious and inviting. This hotel sets the standard for hospitality, and we cannot wait to return.\nHighly recommend to anyone looking for an outstanding stay! Location a huge plus.",
        "review_reply": "Dear Amanda,\nIt's an absolute pleasure to read about the exceptional celebration experience you had with us here at New York Hilton Midtown. Thank you for going out of your way to write about our gorgeous property, where comfort and charm come together perfectly, and we're delighted our team was able to make your experience that much more memorable. We'll be sure your thoughtful compliments are shared with them, and we hope to have the opportunity to welcome you back soon, whether for another special occasion or simply a relaxing New York getaway.\n\nSincerely,\n\nNew York Hilton Midtown Team\n\nNYCNH_FO@hilton.com",
        "review_reply_created": "2 months ago",
        "details": [
          {
            "id": "HOTELS_ASPECT_ROOMS",
            "name": "Rooms",
            "value": 5,
            "description": "Rooms"
          },
          {
            "id": "HOTELS_ASPECT_SERVICES",
            "name": "Service",
            "value": 5,
            "description": "Service"
          },
          {
            "id": "HOTELS_ASPECT_LOCATION",
            "name": "Location",
            "value": 5,
            "description": "Location"
          }
        ]
      },
      {
        "review_id": "ChZDSUhNMG9nS0VKdXluNURVNjR1UWJnEAE",
        "reviewer": {
          "profile_photo_url": "https://lh3.googleusercontent.com/local-reviews/AJMZ0QdVsxDWqDDLG62Q3M3dmLlHORJs5jz0NWRJO3cP21KtRNPfosO7RpofjnbUgpyNjOTDew=s120-c-br100",
          "display_name": "LisaO964",
          "link": "https://www.tripadvisor.com/ShowUserReviews-g60763-d611947-r1045294524?m=68573&staydates=2026_03_08_2026_03_09&uguests=1_2_0&supdv=desktop&supuc=BF&supul=en"
        },
        "link": "https://www.tripadvisor.com/ShowUserReviews-g60763-d611947-r1045294524?m=68573&staydates=2026_03_08_2026_03_09&uguests=1_2_0&supdv=desktop&supuc=BF&supul=en",
        "source": "Tripadvisor",
        "source_logo": "https://www.gstatic.com/travel-hotels/branding/icon_100532569.png",
        "rating": "4/5",
        "created": "a month ago",
        "comment": "Spent 6 nights here with my family- arrives 9.45pm due to flight delay but on arrival rooms were not ready, the gentleman at check in was helpful and found us a room however it was interconnecting with another family which meant we were disturbed by their noise quite a lot. However, this hotel is really lovely and other than this and the elevators being slow I can’t fault it. They have installed a new elevator system and should have thought it through as during busy times they are packed and it can take quite some time to get one. |Rooms are lovely , cleaned every day, excellent location and staff all really lovely. I would recommend staying here."
      },
      {
        "review_id": "ChdDSUhNMG9nS0VNT3NySlBUc01UbTZRRRAB",
        "reviewer": {
          "profile_photo_url": "https://lh3.googleusercontent.com/local-reviews/AJMZ0Qdvd3mFTmnQslJajBtyC7hGXBv5KKEN_7z5ZnXByEfDkAAFDmgEV3HW1P9_iXApXyf1XA=s120-c-br100",
          "display_name": "bobrobb",
          "link": "https://www.tripadvisor.com/ShowUserReviews-g60763-d611947-r1045071077?m=68573&staydates=2026_03_08_2026_03_09&uguests=1_2_0&supdv=desktop&supuc=BF&supul=en"
        },
        "link": "https://www.tripadvisor.com/ShowUserReviews-g60763-d611947-r1045071077?m=68573&staydates=2026_03_08_2026_03_09&uguests=1_2_0&supdv=desktop&supuc=BF&supul=en",
        "source": "Tripadvisor",
        "source_logo": "https://www.gstatic.com/travel-hotels/branding/icon_100532569.png",
        "rating": "2/5",
        "created": "a month ago",
        "comment": "On a positive, the location is excellent and the room was big enough for a family which I think is a rarity for such a location.  We visited from 30th Dec to 6th Jan and in all honesty the hotel is just not set up to be running at capacity.  There were queues for everything, check in, check out, restrooms, bars and the lifts.  The lifts deserve a special mention - if on a lower floor you might have to wait for 5 to 6 lifts to get one that had any capacity if heading down at a busy time.  The service at check in and check out was pretty non- existent, the $35 “destination charge” is to encourage you to spend in their bar.  If lucky enough to actually get served in the lobby bar 2 x beers is more than the $35 - it just leaves a bad taste.  There are no tea and coffee facilities in room (a given in UK), but on a positive note towels were changed daily.  When checking out this morning nobody asked us how our stay was, totally impersonal, then we got hit with the $5 per item holding fee, to hold our baggage from 12 noon to 2 pm - as we had 7 items (hand luggage also counts as a separate item) we got a $35 charge after checking out.  If anyone genuinely cared about customer experience, that would have been taken out of your destination charge, but of course that isn’t possible.    It is a shame really, a once grand hotel, living off the Hilton brand, in need of a refurb with a clear focus on revenue creation as opposed to customer experience.  The location just isn’t enough to make up for the lack of experience I’m afraid - there are much better out there."
      },
      {
        "review_id": "Ci9DQUlRQUNvZENodHljRjlvT2tObGJucGZObk5zTW01M1IzQXhkazgwUkZoclYzYxAB",
        "reviewer": {
          "profile_photo_url": "https://lh3.googleusercontent.com/a/ACg8ocJQgX50KQ8oURrMb8SgiRyqOysMS1rNXBa0wHN1BoF7o8ORvQ=s120-c-rp-mo-br100",
          "display_name": "Olaoluwa Ajilore",
          "link": "https://www.google.com/maps/contrib/115992020596208851571?hl=en"
        },
        "link": "https://www.google.com/maps/reviews/data=!4m8!14m7!1m6!2m5!1sCi9DQUlRQUNvZENodHljRjlvT2tObGJucGZObk5zTW01M1IzQXhkazgwUkZoclYzYxAB!2m1!1s0x0:0x2a34371cb33f3c80!3m1!1s2@1:CAIQACodChtycF9oOkNlbnpfNnNsMm53R3Axdk80RFhrV3c%7C0d3TryOnoQy%7C?hl=en",
        "source": "Google",
        "source_logo": "https://www.gstatic.com/images/branding/product/1x/googleg_48dp.png",
        "rating": "5/5",
        "created": "3 months ago",
        "comment": "I rarely write reviews, but I felt compelled to share my experience—especially because of the outstanding room service I’ve received. I’m currently staying here, and everything has been fantastic so far. What truly sets this place apart is the incredible housekeeping team on the 34th floor.\n\nThey are, without a doubt, the most attentive and genuinely kind crew I’ve encountered in any hotel across the country. Always cheerful, always ready to help—even when I’ve had the “Do Not Disturb” sign up, they’ve gone out of their way to check in if they see me in the hallway, just to make sure I don’t need anything. That level of care and consistency is rare, and it deserves to be celebrated.\n\nThey’re simply the best.",
        "review_reply": "Dear Olaoluwa,\nThank you for taking the time to share this, especially since you mentioned you rarely write reviews. It means even more to know you felt moved to speak about your stay while you’re still here with us. We're truly thrilled to hear how well everything has been going, and your kind words about our housekeeping team on the 34th floor mean the world. They take such pride in caring for our guests with thoughtfulness and genuine warmth, and it’s wonderful to know that their efforts have made such an impression. We'll be sure to share your message with them. I know it will brighten their day and remind them just how meaningful their care is. Thank you again for recognizing their hard work and spirit. We’re grateful to have you with us here at New York Hilton Midtown and are here for anything you may need for the rest of your visit. We hope the rest of your time with us continues to feel relaxing, comfortable, and well cared for!\n\nSincerely,\n\nNew York Hilton Midtown Team\n\nNYCNH_GM@hilton.com",
        "review_reply_created": "3 months ago",
        "details": [
          {
            "id": "HOTELS_ASPECT_ROOMS",
            "name": "Rooms",
            "value": 5,
            "description": "Rooms"
          },
          {
            "id": "HOTELS_ASPECT_SERVICES",
            "name": "Service",
            "value": 5,
            "description": "Service"
          },
          {
            "id": "HOTELS_ASPECT_LOCATION",
            "name": "Location",
            "value": 5,
            "description": "Location"
          },
          {
            "id": "HOTELS_TIPS_TOPICS_ROOMS",
            "name": "Rooms",
            "value": "perfect, nice view, great ambiance",
            "description": "Rooms"
          },
          {
            "id": "HOTELS_TIPS_TOPICS_NEARBY_ACTIVITIES",
            "name": "Nearby activities",
            "value": "Alot of activities",
            "description": "Nearby activities"
          }
        ]
      }
    ]
  }
  ```
</ResponseExample>


# Filter by keyword
Source: https://docs.brightdata.com/api-reference/serp/google-reviews/filter-keyword

Configure the Bright Data Google Reviews Filter by Keyword parameter to refine queries and return matching results as JSON or HTML. On port 44445.

```txt wrap theme={null}
https://www.google.com/reviews?fid=0x89c25855c0679529:0x2a34371cb33f3c80&filter=awesome
```

## Parameters

<ParamField type="string">
  Feature id what you want to fetch reviews to. `fid` parameter can be found in `knowledge.fid` field of google search response.
</ParamField>

<ParamField type="string">
  Filter keyword. Will respond with reviews that contain specified keyword only.

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

  ```txt wrap theme={null}
  https://www.google.com/reviews?fid=0x89c25855c0679529:0x2a34371cb33f3c80&filter=awesome
  ```
</ParamField>

<RequestExample>
  ```shell cURL highlight={6} theme={null}
    curl -X POST https://api.brightdata.com/request \
    --header "Content-Type: application/json" \
    --header "Authorization: Bearer API_KEY" \
    --data '{
      "zone": "serp_api1",
      "url": "https://www.google.com/reviews?fid=0x89c25855c0679529:0x2a34371cb33f3c80&filter=awesome",
      "format": "raw"
    }'
  ```

  ```shell Native proxy highlight={4} theme={null}
  curl --proxy brd.superproxy.io:44445 \
    --proxy-user CUSTOMER_USERNAME:CUSTOMER_PASSWORD \
    --ssl-no-revoke \
    "https://www.google.com/reviews?fid=0x89c25855c0679529:0x2a34371cb33f3c80&filter=awesome"
  ```

  ```js Node.js highlight={10} theme={null}
  (async () => {
    const response = await fetch('https://api.brightdata.com/request', {
      method: 'POST',
      headers: {
        'Content-Type': 'application/json',
        'Authorization': 'Bearer API_KEY'
      },
      body: JSON.stringify({
        zone: 'serp_api1',
        url: 'https://www.google.com/reviews?fid=0x89c25855c0679529:0x2a34371cb33f3c80&filter=awesome',
        format: 'raw'
      })
    });
    
    const data = await response.text();
    console.log(data);
  })();
  ```

  ```python Python highlight={11} theme={null}
  import requests

  # API Configuration
  headers = {
      'Content-Type': 'application/json',
      'Authorization': 'Bearer API_KEY',
  }

  payload = {
      'zone': 'serp_api1',
      'url': 'https://www.google.com/reviews?fid=0x89c25855c0679529:0x2a34371cb33f3c80&filter=awesome',
      'format': 'raw'
  }

  # Make the request
  response = requests.post(
      'https://api.brightdata.com/request', 
      json=payload, 
      headers=headers
  )

  print(response.text)
  ```
</RequestExample>

<ResponseExample>
  ```json 200 theme={null}
  {
    "reviews": [
      {
        "review_id": "Ci9DQUlRQUNvZENodHljRjlvT205WFNsaDVRWFJUWjBsd1Yxb3pNbmhEUkdnM2EwRRAB",
        "reviewer": {
          "profile_photo_url": "https://lh3.googleusercontent.com/a/ACg8ocK7OOVJIAqO_bUXJsXNClGhPiS_codAAJ_4jbQhjngD2I5VQA=s120-c-rp-mo-ba3-br100",
          "display_name": "L File",
          "link": "https://www.google.com/maps/contrib/112336634363254268566?hl=en"
        },
        "link": "https://www.google.com/maps/reviews/data=!4m8!14m7!1m6!2m5!1sCi9DQUlRQUNvZENodHljRjlvT205WFNsaDVRWFJUWjBsd1Yxb3pNbmhEUkdnM2EwRRAB!2m1!1s0x0:0x2a34371cb33f3c80!3m1!1s2@1:CAIQACodChtycF9oOm9XSlh5QXRTZ0lwV1ozMnhDRGg3a0E%7C0dCjYvbWq6w%7C?hl=en",
        "source": "Google",
        "source_logo": "https://www.gstatic.com/images/branding/product/1x/googleg_48dp.png",
        "rating": "4/5",
        "created": "2 months ago",
        "comment": "Awesome location, rooms were clean and comfortable.  Bar drinks are just ok, food is meh.  But I didn’t go to NYC to eat/drinkk in my hotel.  Its location is perfect.  We walked about 5 miles a day to see what we wanted and to go where we wanted.  Subway was easy to use.  The elevators are nice, but they do need more.  Construction on one, but there is almost always a line to go up and getting down is awful.  Give yourself plenty of time and the higher the room, the easier to get “on”.  Oftentimes people had been waiting multiple stops for the elevator to get down to the lobby, if on lower floors, but it would be full.  That was the only pitfall, but could be a significant one if you are in a hurry.",
        "review_reply": "Thank you for sharing your experience with us. We are glad to hear you enjoyed the clean and comfortable rooms, as well as our convenient location, which made it easy to explore the city on foot and by subway. We appreciate your comments regarding food, beverages, and elevator availability, and we will be reviewing these concerns with our team to help improve the overall guest experience. We appreciate you staying with us and hope to have the chance to host you again.\n\nSincerely,\n\nNew York Hilton Midtown Team\n\nNYCNH_FO@hilton.com",
        "review_reply_created": "2 months ago",
        "details": [
          {
            "id": "HOTELS_PILOT_TRIP_TYPE",
            "name": "Trip type",
            "value": "Vacation",
            "description": "What kind of trip was it?"
          },
          {
            "id": "HOTELS_PILOT_TRAVEL_GROUP_TYPE",
            "name": "Travel group",
            "value": "Family",
            "description": "Who did you travel with?"
          },
          {
            "id": "HOTELS_ASPECT_ROOMS",
            "name": "Rooms",
            "value": 5,
            "description": "Rooms"
          },
          {
            "id": "HOTELS_ASPECT_SERVICES",
            "name": "Service",
            "value": 4,
            "description": "Service"
          },
          {
            "id": "HOTELS_ASPECT_LOCATION",
            "name": "Location",
            "value": 5,
            "description": "Location"
          }
        ]
      },
      {
        "review_id": "Ci9DQUlRQUNvZENodHljRjlvT2tOQ2RVOWthRFZwVWtGMFgxTmFSakpqUjBOaVRWRRAB",
        "reviewer": {
          "profile_photo_url": "https://lh3.googleusercontent.com/a/ACg8ocLCd6QVG_vE1DlQTKcKWG5vfq92wigYd3HhKhqbNu3lwOeJag=s120-c-rp-mo-ba2-br100",
          "display_name": "Christine Yacoub",
          "link": "https://www.google.com/maps/contrib/101475921371619109061?hl=en"
        },
        "link": "https://www.google.com/maps/reviews/data=!4m8!14m7!1m6!2m5!1sCi9DQUlRQUNvZENodHljRjlvT2tOQ2RVOWthRFZwVWtGMFgxTmFSakpqUjBOaVRWRRAB!2m1!1s0x0:0x2a34371cb33f3c80!3m1!1s2@1:CAIQACodChtycF9oOkNCdU9kaDVpUkF0X1NaRjJjR0NiTVE%7C0dEkCa75rer%7C?hl=en",
        "source": "Google",
        "source_logo": "https://www.gstatic.com/images/branding/product/1x/googleg_48dp.png",
        "rating": "1/5",
        "created": "2 months ago",
        "comment": "Awesome location in the city, but outdated rooms, zero amenities, and the elevator situation was an absolute nightmare. We had to tack on at least 10+ minutes to account for the elevator ride alone, sometimes having to ride the elevator up to other floors just to catch it back down. Rooms were insanely hot at night with no way to bring down the temperature. Terrible experience, unfortunately. I expected more from a Hilton in such a prime location",
        "review_reply": "Dear Christine,\nThank you for sharing your experience. We are truly sorry that your stay didn’t meet your expectations. Your comments have been shared with our team to help improve the guest experience, and we appreciate you taking the time to provide this detailed feedback.\n\nSincerely,\n\nNew York Hilton Midtown Team\nNYCNH_FO@hilton.com",
        "review_reply_created": "2 months ago",
        "details": [
          {
            "id": "HOTELS_ASPECT_ROOMS",
            "name": "Rooms",
            "value": 1,
            "description": "Rooms"
          },
          {
            "id": "HOTELS_ASPECT_SERVICES",
            "name": "Service",
            "value": 1,
            "description": "Service"
          },
          {
            "id": "HOTELS_ASPECT_LOCATION",
            "name": "Location",
            "value": 5,
            "description": "Location"
          }
        ]
      },
      {
        "review_id": "ChdDSUhNMG9nS0VJQ0FnTUNJc2R5czdRRRAB",
        "reviewer": {
          "profile_photo_url": "https://lh3.googleusercontent.com/a-/ALV-UjUX4Awz4I21tTfDxKx-yJXmRLbBhffYdzezsAe7EFE7BXRxSDa2AQ=s120-c-rp-mo-ba5-br100",
          "display_name": "Jonna Pantelis",
          "link": "https://www.google.com/maps/contrib/107822826899657610772?hl=en"
        },
        "link": "https://www.google.com/maps/reviews/data=!4m8!14m7!1m6!2m5!1sChdDSUhNMG9nS0VJQ0FnTUNJc2R5czdRRRAB!2m1!1s0x0:0x2a34371cb33f3c80!3m1!1s2@1:CIHM0ogKEICAgMCIsdys7QE%7C0cXD2lhpDph%7C?hl=en",
        "source": "Google",
        "source_logo": "https://www.gstatic.com/images/branding/product/1x/googleg_48dp.png",
        "rating": "3/5",
        "created": "Edited 6 months ago",
        "comment": "The difference in reviews on this hotel are just wild. I stayed on the 30th floor and found my room to be great. It was larger than what I typically expect from a hotel room in NYC and was so happy to see a couch!  Everything was clean, with exception of some rust stains around the shower drain.\nNo, the hotel rooms do not have coffee makers, however there's a coffee shop located in the lobby that was open at 5:30am.\nCheck in was a breeze, I checked in online and then visited the front desk to pick up a physical card. Service was fast and easy.\nThe hotel itself is in an awesome location!\n\nEdit to add: my most recent stay is wildly different.\nMy room on 32nd floor really needs refurbishment. The elevators have been absolutely horrible. Only 1 in my floor bank worked and on day 2 that even stopped, I ended up having to take the service elevator down.",
        "details": [
          {
            "id": "HOTELS_PILOT_TRIP_TYPE",
            "name": "Trip type",
            "value": "Business",
            "description": "What kind of trip was it?"
          },
          {
            "id": "HOTELS_ASPECT_ROOMS",
            "name": "Rooms",
            "value": 3,
            "description": "Rooms"
          },
          {
            "id": "HOTELS_ASPECT_SERVICES",
            "name": "Service",
            "value": 5,
            "description": "Service"
          },
          {
            "id": "HOTELS_ASPECT_LOCATION",
            "name": "Location",
            "value": 5,
            "description": "Location"
          }
        ]
      },
      {
        "review_id": "ChdDSUhNMG9nS0VNZXFqTWlOd2MtVWdBRRAB",
        "reviewer": {
          "profile_photo_url": "https://lh3.googleusercontent.com/local-reviews/AJMZ0Qe1FTSCg98CZ3VrSg28YAOa76nyaQfZNd66XhsW7MF99ozoooauY0gRdjL2-kPkUfooOQ=s120-c-br100",
          "display_name": "Maureen",
          "link": "http://www.priceline.com/r/?channel=meta&product=hotel&theme=reviews&refid=PLGOOGLEHARV&refclickid=HARV_39532&hotel_id=39532"
        },
        "link": "http://www.priceline.com/r/?channel=meta&product=hotel&theme=reviews&refid=PLGOOGLEHARV&refclickid=HARV_39532&hotel_id=39532",
        "source": "Priceline",
        "source_logo": "https://www.gstatic.com/travel-hotels/branding/icon_220.png",
        "rating": "10/10",
        "created": "9 months ago",
        "comment": "Positive: The staff was awesome.  On the check-in Kathleen went out of her way to make sure the room worked for us.  It was just the first of many experiences with attentive staff.  Friendly and responsive.  Location was great. Negative: \"\""
      },
      {
        "review_id": "ChdDSUhNMG9nS0VJQ0FnSUNfLUpybzRnRRAB",
        "reviewer": {
          "profile_photo_url": "https://lh3.googleusercontent.com/local-reviews/AJMZ0QdygWaVcJ3ItdBHng2W3iaFRVWQH1rVo2JLZNRPvIK0yuW9fy8TZEHD74TDScrP3xIW2Q=s120-c-br100",
          "display_name": "Kimberly",
          "link": "http://www.priceline.com/r/?channel=meta&product=hotel&theme=reviews&refid=PLGOOGLEHARV&refclickid=HARV_39532&hotel_id=39532"
        },
        "link": "http://www.priceline.com/r/?channel=meta&product=hotel&theme=reviews&refid=PLGOOGLEHARV&refclickid=HARV_39532&hotel_id=39532",
        "source": "Priceline",
        "source_logo": "https://www.gstatic.com/travel-hotels/branding/icon_220.png",
        "rating": "10/10",
        "created": "a year ago",
        "comment": "Positive: The location & staff were awesome! Reminder to spend your daily credit. See Hotel employee in the bar and order a ?Lazarus? if you?re a fan of espresso martinis! Negative: It is getting a bit tired in the hallway and bathrooms. Especially the wallpaper but the other things outweigh so I wasn?t bothered."
      },
      {
        "review_id": "ChdDSUhNMG9nS0VJQ0FnSURlN05XUHhBRRAB",
        "reviewer": {
          "profile_photo_url": "https://lh3.googleusercontent.com/a-/ALV-UjU54My1PEEpcJ07il9yu48emyyENeicNVgsx7mPTtono7URPdXf=s120-c-rp-mo-ba3-br100",
          "display_name": "Caroline Hipple",
          "link": "https://www.google.com/maps/contrib/110997671651209094064?hl=en"
        },
        "link": "https://www.google.com/maps/reviews/data=!4m8!14m7!1m6!2m5!1sChdDSUhNMG9nS0VJQ0FnSURlN05XUHhBRRAB!2m1!1s0x0:0x2a34371cb33f3c80!3m1!1s2@1:CIHM0ogKEICAgIDe7NWPxAE%7C0YvRSCodSVV%7C?hl=en",
        "source": "Google",
        "source_logo": "https://www.gstatic.com/images/branding/product/1x/googleg_48dp.png",
        "rating": "5/5",
        "created": "Edited 3 years ago",
        "comment": "We enjoyed our stay at the Hilton Midtown and would definitely consider it again for a future NYC trip. The location is fabulous, easy walk to anywhere.  Staff were friendly and helpful, got us checked in very quickly despite our early arrival time.  The room was a good size by NYC standards and although a little older, it was clean and comfortable.  Awesome large windows with a great view.  Enjoyed hanging out in the Executive Lounge for coffee and a bit of peace and quiet!",
        "review_reply": "Dear Caroline,\nWe're so happy to hear that our amazing location and friendly team members impressed you at New York Hilton Midtown and that you had a great time overall. It would be an absolute pleasure to host you again the next time you come to the Big Apple, so hurry back!\n\nSincerely,\n\nNew York Hilton Midtown Team\nNYCNH_FO@hilton.com",
        "review_reply_created": "3 years ago",
        "details": [
          {
            "id": "HOTELS_PILOT_TRIP_TYPE",
            "name": "Trip type",
            "value": "Vacation",
            "description": "What kind of trip was it?"
          },
          {
            "id": "HOTELS_PILOT_TRAVEL_GROUP_TYPE",
            "name": "Travel group",
            "value": "Couple",
            "description": "Who did you travel with?"
          },
          {
            "id": "HOTELS_ASPECT_ROOMS",
            "name": "Rooms",
            "value": 4,
            "description": "Rooms"
          },
          {
            "id": "HOTELS_ASPECT_SERVICES",
            "name": "Service",
            "value": 5,
            "description": "Service"
          },
          {
            "id": "HOTELS_ASPECT_LOCATION",
            "name": "Location",
            "value": 5,
            "description": "Location"
          }
        ]
      },
      {
        "review_id": "ChdDSUhNMG9nS0VJQ0FnSUR3ME8tSHJBRRAB",
        "reviewer": {
          "profile_photo_url": "https://lh3.googleusercontent.com/a-/ALV-UjUuDalG7UAbNUpgMrJxdadLrrH_HRlGdnbh3KGWLjKogCERxLA=s120-c-rp-mo-ba4-br100",
          "display_name": "William Purcell",
          "link": "https://www.google.com/maps/contrib/111518848845096895914?hl=en"
        },
        "link": "https://www.google.com/maps/reviews/data=!4m8!14m7!1m6!2m5!1sChdDSUhNMG9nS0VJQ0FnSUR3ME8tSHJBRRAB!2m1!1s0x0:0x2a34371cb33f3c80!3m1!1s2@1:CIHM0ogKEICAgIDw0O-HrAE%7C0YxW5al_xXs%7C?hl=en",
        "source": "Google",
        "source_logo": "https://www.gstatic.com/images/branding/product/1x/googleg_48dp.png",
        "rating": "5/5",
        "created": "Edited 3 years ago",
        "comment": "I have stayed here many times and the location cannot be beat.  The executive lounge is awesome for breakfast with caring staff.  The service at this hotel overall is excellent.   The rooms are very nice too.\n\nI love that you are an 8 min walk to so many things like Broadway theaters and Central Park too.  You can walk to so many places, take a rest in the executive lounge, and go out some more.\n\nMy family highly recommends this New York property."
      },
      {
        "review_id": "ChZDSUhNMG9nS0VJQ0FnSUNEbUxYb2VBEAE",
        "reviewer": {
          "profile_photo_url": "https://lh3.googleusercontent.com/a-/ALV-UjUG0JejyKmnmkKjKsXv3Zqzr53W2a6F95lt-dqtlETw65cW3sY=s120-c-rp-mo-br100",
          "display_name": "Jaxson Karn",
          "link": "https://www.google.com/maps/contrib/115116250847951428621?hl=en"
        },
        "link": "https://www.google.com/maps/reviews/data=!4m8!14m7!1m6!2m5!1sChZDSUhNMG9nS0VJQ0FnSUNEbUxYb2VBEAE!2m1!1s0x0:0x2a34371cb33f3c80!3m1!1s2@1:CIHM0ogKEICAgICDmLXoeA%7C0_zuQCkZ3Fc%7C?hl=en",
        "source": "Google",
        "source_logo": "https://www.gstatic.com/images/branding/product/1x/googleg_48dp.png",
        "rating": "5/5",
        "created": "a year ago",
        "comment": "First Time to New York and I was a little nervous but Midtown Hilton is a super chill hotel that is easy to relax in and take a break from the hectic but fun city. The vibe is good and the rooms are nice. Special shout out to Willie who was working at the Bridges Bar in the lobby. Willie you are the reason I am writing this review. You are the most friendly and down to Earth guy I have met. You make Midtown Hilton awesome, keep it up! Willie is a solid 100/10.",
        "review_reply": "Dear Jaxson,\nThank you for staying with us at New York Hilton Midtown and for your fantastic review. Willie will be pleased when we share your kind words with him. Thank you for choosing to visit us during your trip to the city, and we look forward to seeing you again soon for another relaxing break.\n\nSincerely,\n\nNew York Hilton Midtown Team\n\nNYCNH_FO@hilton.com",
        "review_reply_created": "a year ago",
        "details": [
          {
            "id": "HOTELS_PILOT_TRIP_TYPE",
            "name": "Trip type",
            "value": "Business",
            "description": "What kind of trip was it?"
          },
          {
            "id": "HOTELS_PILOT_TRAVEL_GROUP_TYPE",
            "name": "Travel group",
            "value": "Friends",
            "description": "Who did you travel with?"
          },
          {
            "id": "HOTELS_ASPECT_ROOMS",
            "name": "Rooms",
            "value": 5,
            "description": "Rooms"
          },
          {
            "id": "HOTELS_ASPECT_SERVICES",
            "name": "Service",
            "value": 5,
            "description": "Service"
          },
          {
            "id": "HOTELS_ASPECT_LOCATION",
            "name": "Location",
            "value": 5,
            "description": "Location"
          },
          {
            "id": "HOTELS_TIPS_TOPICS_NOTEWORTHY_DETAILS",
            "name": "Noteworthy details",
            "value": "Willie is a solid guy.",
            "description": "Noteworthy details"
          },
          {
            "id": "HOTELS_VIBE",
            "name": "Hotel highlights",
            "value": "Luxury",
            "description": "How would you describe the hotel?"
          }
        ]
      },
      {
        "review_id": "ChZDSUhNMG9nS0VJQ0FnSURNOXM2NEFnEAE",
        "reviewer": {
          "profile_photo_url": "https://lh3.googleusercontent.com/a-/ALV-UjUhkHISOyI-Hj1pC-_kkDRTzjZw8J_EcPXjWpX3rsTfVAG0s2CS0A=s120-c-rp-mo-ba4-br100",
          "display_name": "Becci Dougherty",
          "link": "https://www.google.com/maps/contrib/106862988338556860792?hl=en"
        },
        "link": "https://www.google.com/maps/reviews/data=!4m8!14m7!1m6!2m5!1sChZDSUhNMG9nS0VJQ0FnSURNOXM2NEFnEAE!2m1!1s0x0:0x2a34371cb33f3c80!3m1!1s2@1:CIHM0ogKEICAgIDM9s64Ag%7C0YxUl92CLoc%7C?hl=en",
        "source": "Google",
        "source_logo": "https://www.gstatic.com/images/branding/product/1x/googleg_48dp.png",
        "rating": "3/5",
        "created": "Edited 3 years ago",
        "comment": "Great location, clean, staff friendly, executive club staff AWESOME.  THE Herb'N'Kitchen has no place being in any Hilton property though.  Food is good sometimes but usually just Okay.  Most of the staff there is very abrupt.  Every where else in the hotel is great..... Except... We were there over Christmas & even with the fan \"on\" constantly & the windows open..... It was very hot in our room. Housekeeping, security, concierge were all fantastic though!",
        "review_reply": "Becci, I'm happy to know that our executive lounge team left you with a great impression! We'll always make sure to be as helpful as we can when you're here. Additionally, we appreciate your patience while you were here. We will always try our best to be accommodating to your needs, but we take note when our guests go above and beyond to make themselves feel at home. We take your feedback to heart as we use any information to improve the overall experience of our guests. -Andrew Verburg, Director of Front Office Operations",
        "review_reply_created": "6 years ago"
      },
      {
        "review_id": "ChdDSUhNMG9nS0VJQ0FnSUMwMG91QXh3RRAB",
        "reviewer": {
          "profile_photo_url": "https://lh3.googleusercontent.com/a-/ALV-UjUFy0ZwQ2ZKM0j0haGOcdBh3u2sxTgJYH1l1tMxwOCaf98Yrus=s120-c-rp-mo-ba2-br100",
          "display_name": "Caleb noiles",
          "link": "https://www.google.com/maps/contrib/114781757379111938014?hl=en"
        },
        "link": "https://www.google.com/maps/reviews/data=!4m8!14m7!1m6!2m5!1sChdDSUhNMG9nS0VJQ0FnSUMwMG91QXh3RRAB!2m1!1s0x0:0x2a34371cb33f3c80!3m1!1s2@1:CIHM0ogKEICAgIC00ouAxwE%7C0YxUtk-RQok%7C?hl=en",
        "source": "Google",
        "source_logo": "https://www.gstatic.com/images/branding/product/1x/googleg_48dp.png",
        "rating": "3/5",
        "created": "Edited 3 years ago",
        "comment": "I am a Hilton diamond member and was quite excited to see what it would give me in New York. But I was dissatisfied with the \"perks\" we had reserved a standard king room knowing we would be upgraded. But that was a total failure, they upgraded us to a premium king room with an accessible bathroom. Which wasn't the issue. The issue was the room was damp and could smell the mold. So we called down to get switched into another room but they had sold our original room and down graded us to a double room...\n\nThe double room was clean but very outdated, the wall paper was curling and the fridge wasn't working.\n\nThe cleaning lady gets 5 stars though she was awesome, she went above and beyond for us.\n\nThe breakfast lobby was just a typical continental breakfast no warm foods. Nothing like any other hilton I had stayed at.\n\nI am just not sure how the hotel has a 4 star rating. It's an easy 3 star in my mind had they made the diamond experience better and put us in a king room of some kind.",
        "review_reply": "Caleb, thank you for taking the time to share your experience. We try our best to maintain our rooms as best as we can, but we're always receptive to our guests' feedback. We'll use this information to improve. We greatly appreciate your review, as we use it as a means to improve. We hope to have the opportunity to welcome you back soon and Make it Right. -Andrew Verburg, Director of Front Office Operations",
        "review_reply_created": "6 years ago",
        "details": [
          {
            "id": "HOTELS_PILOT_TRIP_TYPE",
            "name": "Trip type",
            "value": "Vacation",
            "description": "What kind of trip was it?"
          },
          {
            "id": "HOTELS_PILOT_TRAVEL_GROUP_TYPE",
            "name": "Travel group",
            "value": "Couple",
            "description": "Who did you travel with?"
          },
          {
            "id": "HOTELS_ASPECT_ROOMS",
            "name": "Rooms",
            "value": 3,
            "description": "Rooms"
          },
          {
            "id": "HOTELS_ASPECT_SERVICES",
            "name": "Service",
            "value": 2,
            "description": "Service"
          },
          {
            "id": "HOTELS_ASPECT_LOCATION",
            "name": "Location",
            "value": 5,
            "description": "Location"
          }
        ]
      }
    ]
  }
  ```
</ResponseExample>


# Google Reviews localization
Source: https://docs.brightdata.com/api-reference/serp/google-reviews/localization

Configure the Bright Data Google Reviews Google Reviews localization parameter to refine queries and return matching results as JSON or HTML. On port 44445.

```txt wrap theme={null}
https://www.google.com/reviews?fid=0x89c25855c0679529:0x2a34371cb33f3c80&hl=de
```

## Parameters

<ParamField type="string">
  Feature id what you want to fetch reviews to. `fid` parameter can be found in `knowledge.fid` field of google search response.
</ParamField>

<ParamField type="string">
  Preferred language, two-letter language code

  ```txt wrap theme={null}
  https://www.google.com/reviews?fid=0x89c25855c0679529:0x2a34371cb33f3c80&hl=de
  ```
</ParamField>

<RequestExample>
  ```shell cURL highlight={6} theme={null}
    curl -X POST https://api.brightdata.com/request \
    --header "Content-Type: application/json" \
    --header "Authorization: Bearer API_KEY" \
    --data '{
      "zone": "serp_api1",
      "url": "https://www.google.com/reviews?fid=0x89c25855c0679529:0x2a34371cb33f3c80&hl=de",
      "format": "raw"
    }'
  ```

  ```shell Native proxy highlight={4} theme={null}
  curl --proxy brd.superproxy.io:44445 \
    --proxy-user CUSTOMER_USERNAME:CUSTOMER_PASSWORD \
    --ssl-no-revoke \
    "https://www.google.com/reviews?fid=0x89c25855c0679529:0x2a34371cb33f3c80&hl=de"
  ```

  ```js Node.js highlight={10} theme={null}
  (async () => {
    const response = await fetch('https://api.brightdata.com/request', {
      method: 'POST',
      headers: {
        'Content-Type': 'application/json',
        'Authorization': 'Bearer API_KEY'
      },
      body: JSON.stringify({
        zone: 'serp_api1',
        url: 'https://www.google.com/reviews?fid=0x89c25855c0679529:0x2a34371cb33f3c80&hl=de',
        format: 'raw'
      })
    });
    
    const data = await response.text();
    console.log(data);
  })();
  ```

  ```python Python highlight={11} theme={null}
  import requests

  # API Configuration
  headers = {
      'Content-Type': 'application/json',
      'Authorization': 'Bearer API_KEY',
  }

  payload = {
      'zone': 'serp_api1',
      'url': 'https://www.google.com/reviews?fid=0x89c25855c0679529:0x2a34371cb33f3c80&hl=de',
      'format': 'raw'
  }

  # Make the request
  response = requests.post(
      'https://api.brightdata.com/request', 
      json=payload, 
      headers=headers
  )

  print(response.text)
  ```
</RequestExample>

<ResponseExample>
  ```json 200 theme={null}
  {
    "reviews": [
      {
        "review_id": "Ci9DQUlRQUNvZENodHljRjlvT2xOT2RtRlllRFJKYTBnMWFrWnhhRnBtWkVGdmFuYxAB",
        "reviewer": {
          "profile_photo_url": "https://lh3.googleusercontent.com/a-/ALV-UjV5gtd6dYV7Lvhu20tzKXYYwMuI09-X0aFVeeZHhGHlQc15qxCD=s120-c-rp-mo-ba4-br100",
          "display_name": "N. D.",
          "link": "https://www.google.com/maps/contrib/106942246120347351039?hl=de"
        },
        "link": "https://www.google.com/maps/reviews/data=!4m8!14m7!1m6!2m5!1sCi9DQUlRQUNvZENodHljRjlvT2xOT2RtRlllRFJKYTBnMWFrWnhhRnBtWkVGdmFuYxAB!2m1!1s0x0:0x2a34371cb33f3c80!3m1!1s2@1:CAIQACodChtycF9oOlNOdmFYeDRJa0g1akZxaFpmZEFvanc%7C0d8Sijb1Tmu%7C?hl=de",
        "source": "Google",
        "source_logo": "https://www.gstatic.com/images/branding/product/1x/googleg_48dp.png",
        "rating": "4/5",
        "created": "vor 3 Monaten",
        "date": "2025-11-25",
        "comment": "Hilton, wie man es kennt. Auch in seiner Preisklasse. Günstig und gut geht wo anders auch. Die Lage ist top! Zimmer leider ohne Kaffeemaschine. Im Zuge einer mehrtägigen Veranstaltung kam klar zum Vorschein, dass sich der Aufzug zu einer zeitlichen Herausforderung gestaltet...um nicht zu sagen, eine Katastrophe ist. Ein Grund, warum vereinzelt Teilnehmer ein Hotel gegenüber gebucht haben.\nGrundsätzlich ein freundlicher Empfang.\nWovon wir klar Abstand genommen haben, war der hausinterne \"Markt\". Da sind Apothekenpreise noch harmlos. Hier haben wir zwei Straßen weiter einen genialen Supermarkt entdeckt, der keine Wünsche offen läßt, um die Minibar zu füllen, welche übrigens total leer war...zu unserer leichten Enttäuschung.\nAlles in allem sieht mich NYC definiv wieder. Stadtverliebt...",
        "review_reply": "Thank you for being our guest and sharing your experience. We’re glad to hear the fantastic location and the friendliness of the team stood out during your visit. At the same time, we understand that not everything met your expectations. Your notes are helpful as we continue looking for ways to enhance comfort and ease for our guests. We appreciate your perspective and hope that on your next trip to New York, we can offer a stay that feels more in line with what you were hoping for.\n\nSincerely,\n\nNew York Hilton Midtown Team\n\nNYCNH_FO@hilton.com",
        "review_reply_created": "vor 2 Monaten",
        "photos": [
          "https://lh3.googleusercontent.com/geougc-cs/ABOP9pvpZEDxYyKaTlHOKBSsxcgHubulSh0cH-6nZfs15bae6xs3C3nylcZDXqbo-selkWUd24v0uv4V4qtZF2al3U5D8fM323pCe1TdaJW99h9w-ew5ySoGuxFl027PwBdygbM4NArzr6YRuE4D",
          "https://lh3.googleusercontent.com/geougc-cs/ABOP9puhfI4e--YHFvELu8JP1DuD0bysmpmf6sKVqIHHe9XRFda3sIUCqSSrMuseUSuCPCuk9mDwxjHpmMFCsCEVUyl2GQ7H3vtELTMz5SXnGbMhrOkUkPKBhh7b52J9m1FBJ4bp28TPEQ2jy-o8",
          "https://lh3.googleusercontent.com/geougc-cs/ABOP9psL1uA4fh-0XpvIIgXgvbrfyfu8ZZFcKbLoxFH5eLfgKqQuJMwjvvTfvCFcbqjHKxvNkJWxQ4kf55NNHl2Gvg3Q3p9xPk2dyX-Q_B-OWARWyiA0ozlLXPKG8z2Go_xWaU622o_i39eeI5xx",
          "https://lh3.googleusercontent.com/geougc-cs/ABOP9psB_6iJsBELQK1zS5xbnZ_LPMMPONHzb4C1ghMv0faDDWbrjmlUUkp5SiMcIKsXhn05Go0ufdZfSz77mlhLDGL3WYCiLBv8Y-FJK1dLACGANd0162Icgf3-I-DV-EHaN8tG4QwzFMASc5mr",
          "https://lh3.googleusercontent.com/geougc-cs/ABOP9psWWyPJKenSWHpuhSiMDwL7YO30Zo-EhP7XUmi_ItNtoxH-cdoBC8JozSG1I0wmDFXkkqUYR29DlC1i7MRk5gldyoO1SatJi1qH6XTz92jZ9NYxPjLbgekethhpv_Jz4thE5pbcavCKbKIp",
          "https://lh3.googleusercontent.com/geougc-cs/ABOP9ptrEZAHF1Otczr7nZfe28InIQxJJbGJcu2_I-I36vCKuJmmy0P1LOK_wHTMF9XYtZN1ncD-98tqqajaERqMWRXNyyonDuqRY0pYhBrQbRj9FBbm42-GQzoeomcCD1H3Lg18Aby4alDGdx8o",
          "https://lh3.googleusercontent.com/geougc-cs/ABOP9psE3NHBwTsHFja_pvrFIise1G49AdT_SZKL1O8hqbBcZi_7z-yZSNmVn-TDtGnWeN9dHf7hDv7lGImfQ8aI0Q3cpqB4zgN_BQxbWAhU_rLSlQkKjY8l8zLlJOGf96gWX8fPGtpV0GM7eC0",
          "https://lh3.googleusercontent.com/geougc-cs/ABOP9ptS7vepoKIIouTw3QI1YljuGIxlDRT9dB6KDP_XUAB3U_ZpyFAN3GxnuCAi8r8v8wkD_iP6FeGT8AA9MlHhxQjOyn-HbHHCAWXXVrS_1hCrHXA86pJISBhq9b9c2wpvVkLqftyvu9teOsk",
          "https://lh3.googleusercontent.com/geougc-cs/ABOP9ptplZxq6BJfuS0lHOrT1KPoqOJaVCJq4sYwmgCnmGoR_xNGtex9qchVOK1uWYOLavuGWsFnT2MWDT4jdPuzNZVJpFo0Ei20pEcikIx2HaUMeey1L-IvFQm3LLQc1__8TX17YL6N4GYaZ414",
          "https://lh3.googleusercontent.com/geougc-cs/ABOP9ptFFXdZjlLLduDMpWuEihSoiqDFMUCuf2C9Cra4cIfcccC8vf_YjLiZkWSKsNwj1n6YOp3E8DAAyc4bFcHNfojavHR2KUn2ZUJS613mtqvCip-QHipfMlo7iPHTS4jbXOo4_sLsds_rHeY",
          "https://lh3.googleusercontent.com/geougc-cs/ABOP9pvhl2Wh1brqS8bDEx4NP965YmveHI8P5Nwt3iBNbswIr3Sg5mVs32ZJWad8J3bZU10iY5hseYLpmVpfMdjgsqU_sDirBdAOGqMes7ozc3sR9orLJxFgNATJTbAr2ey6_IGyBS0OEy4mIEEG",
          "https://lh3.googleusercontent.com/geougc-cs/ABOP9puVR5Y3LtcLgO0wnmgmMgqBywKUyE42S0Lpt1k8qxFdCyn6sxloTpf0YcSeM6VHxaDDLu2j13neeGsLuTbdj-odZcKbfrYIiTyXF6gK06T7Jea_yYe2Itg_Sx6-Qgtvm2Zvn3oC9J2kyLw",
          "https://lh3.googleusercontent.com/geougc-cs/ABOP9ps7T-wnjBv5_slqJoxIozJaSbwMC_Sd4ISGZGA10sTsy_RWu-xk7Kl3XdAzpgxQ1vb8HhAbIC9rez74UVQ-2MK5sXeQdDS29KV8HcOhpJGOO8niRxVDbXov8FKqyY4FvcUV9v_vqOsz2ko",
          "https://lh3.googleusercontent.com/geougc-cs/ABOP9puus1ZsNNi3ZCr2AE_65NRdF0vO3ryUBsNH2qORCYCA3kmXhvEZJ1pznvkIA-e-TzZwNb6EOSyzo9OOVCyAwML49PFWzYb6gDAzgC5YoZ6utY5nV6wuj8adcGSaniqTKdidhyv--3-lsF8",
          "https://lh3.googleusercontent.com/geougc-cs/ABOP9pvs8LdtDTe_iOCcTBcLg8H6HjLBaUghNhqm5gOBQGcTT4kHz2J4Gk1H_QExDBw_1jzuZdMBJmNbw2-KvNzWb0gMsala8N56-W2V3w378yGmx88Q2tQd05xE8JfJlzciHLXBHfsX1apJnlGj",
          "https://lh3.googleusercontent.com/geougc-cs/ABOP9psclG3styp6D8_5YEskDQUVXvsPgXx81MRK05-fW-xwKohAQManSe7_c0ZBMqHcpWbs5Sca7I28Gh1QYyix31JvmwzSh12cemXFpOwcADJBqvFh9NvfY0aD0Ut7JaTBg0X2rke3vbph0NI",
          "https://lh3.googleusercontent.com/geougc-cs/ABOP9pvPOYSp6GVL5G-itJhCw3L_8-QOumiHAW4F_w6dYCJL0Ejmz8Rpc-akxPGIsN_HxNspYTRt1liMjI4gSpK6l43i94wb9kVVBWyeqMmv-Fi4-4scmRRUEzTLsKqJfhekfOpY5l8_CpPx-Z_b",
          "https://lh3.googleusercontent.com/geougc-cs/ABOP9pubaRCKu5RRi6mU2GvpU2cB3H-Zq3uVg7hVN1wLO-IX-69mqg-xZm61P6D3e9lAr6IfGX9MucrVT_stsDGNemajfPOOcMErEt8dpjDvTPZxNlO3wRjhQeFx8CYQe9DNGfj-2iB9fTEw_MhJ",
          "https://lh3.googleusercontent.com/geougc-cs/ABOP9pvTiwRW5gBdU8FcfXATTeRg5S8yhXp-OewD2S_rPpViX_9DvP0ZKSXh_CDXIFDvdQlRfg3KRid2Zpk7aePImG1LIXA8xO04gPOBUh30v_4kBgCtcLZB79Yw0hGeYS95FrgX4k7ctTFpJT-Q"
        ],
        "details": [
          {
            "id": "HOTELS_PILOT_TRAVEL_GROUP_TYPE",
            "name": "Reisegruppe",
            "value": "Freunde",
            "description": "Mit wem bist du gereist?"
          },
          {
            "id": "HOTELS_ASPECT_ROOMS",
            "name": "Zimmer",
            "value": 5,
            "description": "Zimmer"
          },
          {
            "id": "HOTELS_ASPECT_SERVICES",
            "name": "Service",
            "value": 3,
            "description": "Service"
          },
          {
            "id": "HOTELS_ASPECT_LOCATION",
            "name": "Standort",
            "value": 5,
            "description": "Standort"
          }
        ]
      },
      {
        "review_id": "Ci9DQUlRQUNvZENodHljRjlvT25sWU5uTllSRlpUZVdneU0xcGtYMnd0U1hjME5tYxAB",
        "reviewer": {
          "profile_photo_url": "https://lh3.googleusercontent.com/a-/ALV-UjUjlW4WZmDBdrEBK7d5iYy8JHcticI0r09r7TcMWUWh3H-Lak_I=s120-c-rp-mo-ba3-br100",
          "display_name": "Ismail S.",
          "link": "https://www.google.com/maps/contrib/100086937401926490816?hl=de"
        },
        "link": "https://www.google.com/maps/reviews/data=!4m8!14m7!1m6!2m5!1sCi9DQUlRQUNvZENodHljRjlvT25sWU5uTllSRlpUZVdneU0xcGtYMnd0U1hjME5tYxAB!2m1!1s0x0:0x2a34371cb33f3c80!3m1!1s2@1:CAIQACodChtycF9oOnlYNnNYRFZTeWgyM1pkX2wtSXc0Nmc%7C0cm1N412Eoc%7C?hl=de",
        "source": "Google",
        "source_logo": "https://www.gstatic.com/images/branding/product/1x/googleg_48dp.png",
        "rating": "3/5",
        "created": "Bearbeitet: vor 5 Monaten",
        "comment": "Die Einrichtung im Zimmer sind leider sehr alt. Keine Steckdosen neben dem Bett. Lampe und Fön funktionieren nicht.\nPro: gute Lage zum Central Park, Times Square und Rockerfella Center.\nServicekräfte des Hotels sehr nett.",
        "review_reply": "Thank you very much for sharing your feedback with us. We’re glad to hear you enjoyed our central location near Central Park, Times Square, and Rockefeller Center, as well as the friendliness of our service team.\n\nWe’re sorry to learn that the furnishings and in-room amenities did not meet your expectations, and we appreciate you bringing the lamp and hair dryer issues to our attention. Your comments will help us make improvements to ensure a more comfortable stay for our future guests.\n\nWe hope to have the opportunity to welcome you back again and provide an even better experience.",
        "review_reply_created": "vor 5 Monaten",
        "details": [
          {
            "id": "HOTELS_PILOT_TRIP_TYPE",
            "name": "Art der Reise",
            "value": "Urlaub",
            "description": "Welche Art von Reise hast du unternommen?"
          },
          {
            "id": "HOTELS_PILOT_TRAVEL_GROUP_TYPE",
            "name": "Reisegruppe",
            "value": "Paar",
            "description": "Mit wem bist du gereist?"
          },
          {
            "id": "HOTELS_ASPECT_ROOMS",
            "name": "Zimmer",
            "value": 2,
            "description": "Zimmer"
          },
          {
            "id": "HOTELS_ASPECT_SERVICES",
            "name": "Service",
            "value": 3,
            "description": "Service"
          },
          {
            "id": "HOTELS_ASPECT_LOCATION",
            "name": "Standort",
            "value": 4,
            "description": "Standort"
          }
        ]
      },
      {
        "review_id": "Ci9DQUlRQUNvZENodHljRjlvT25VMFYzQmZjblZHU2xOa2JISnZibGRyVEMxaldrRRAB",
        "reviewer": {
          "profile_photo_url": "https://lh3.googleusercontent.com/a-/ALV-UjWV7TMK61cNjegRN1_oXpJNL31nlzqzW6d1iTTC-UsyAAozVfs=s120-c-rp-mo-ba5-br100",
          "display_name": "Sonja Dürr",
          "link": "https://www.google.com/maps/contrib/102283591874141539400?hl=de"
        },
        "link": "https://www.google.com/maps/reviews/data=!4m8!14m7!1m6!2m5!1sCi9DQUlRQUNvZENodHljRjlvT25VMFYzQmZjblZHU2xOa2JISnZibGRyVEMxaldrRRAB!2m1!1s0x0:0x2a34371cb33f3c80!3m1!1s2@1:CAIQACodChtycF9oOnU0V3BfcnVGSlNkbHJvbldrTC1jWkE%7C0d7MTqp5WU7%7C?hl=de",
        "source": "Google",
        "source_logo": "https://www.gstatic.com/images/branding/product/1x/googleg_48dp.png",
        "rating": "5/5",
        "created": "vor 3 Monaten",
        "date": "2025-11-22",
        "comment": "Zimmer für NY wirklich gross, die Lage ist gut.\nDie Zimmer, Einrichtung sind allerdings sehr abgenutzt.\nDie Preise im Restaurantbereich sind happig, aber Starbucks ist direkt um die Ecke.",
        "review_reply": "Dear Sonja,\nThank you for choosing New York Hilton Midtown and for sharing your valuable feedback. While we are sorry your stay wasn't quite perfect, we are happy you enjoyed our fantastic location and spacious accommodations. We are continually working to improve, and your comments help us know where to focus our efforts. We look forward to being your \"go-to\" place to stay on future trips to NYC.\n\nSincerely,\n\nNew York Hilton Midtown Team\n\nNYCNH_FO@hilton.com",
        "review_reply_created": "vor 3 Monaten",
        "photos": [
          "https://lh3.googleusercontent.com/geougc-cs/ABOP9pux295aI8VAKS3CWZVuHHg2iJwXdvcM3Z-Bq7QsebDsJif_XY0fBaPaGjHt649a5HPmguobH70SyvUw0ZK-FX7g5AN9rXYsGqBDoVHpTf1bSRnbibmVBKI0YGUynqe-1wDkKkcAY9J6mQJI"
        ],
        "details": [
          {
            "id": "HOTELS_PILOT_TRIP_TYPE",
            "name": "Art der Reise",
            "value": "Urlaub",
            "description": "Welche Art von Reise hast du unternommen?"
          },
          {
            "id": "HOTELS_PILOT_TRAVEL_GROUP_TYPE",
            "name": "Reisegruppe",
            "value": "Paar",
            "description": "Mit wem bist du gereist?"
          },
          {
            "id": "HOTELS_ASPECT_ROOMS",
            "name": "Zimmer",
            "value": 5,
            "description": "Zimmer"
          },
          {
            "id": "HOTELS_ASPECT_SERVICES",
            "name": "Service",
            "value": 4,
            "description": "Service"
          },
          {
            "id": "HOTELS_ASPECT_LOCATION",
            "name": "Standort",
            "value": 5,
            "description": "Standort"
          }
        ]
      },
      {
        "review_id": "ChdDSUhNMG9nS0VKNmx3dGZHdE5tM3JnRRAB",
        "reviewer": {
          "profile_photo_url": "https://lh3.googleusercontent.com/local-reviews/AJMZ0QdCjMUwIiBikRhCLHgN_0vyGAo1GvT8DEukiKQb1ujC_eFsFjYrQ0OvLoSxPtqmCdgvFA=s120-c-br100",
          "display_name": "K4274CPbenjaminm",
          "link": "https://www.tripadvisor.de/ShowUserReviews-g60763-d611947-r1022439626?m=68573&staydates=2026_03_08_2026_03_09&uguests=1_2_0&supdv=desktop&supuc=PH&supul=de"
        },
        "link": "https://www.tripadvisor.de/ShowUserReviews-g60763-d611947-r1022439626?m=68573&staydates=2026_03_08_2026_03_09&uguests=1_2_0&supdv=desktop&supuc=PH&supul=de",
        "source": "Tripadvisor",
        "source_logo": "https://www.gstatic.com/travel-hotels/branding/icon_100532569.png",
        "rating": "1/5",
        "created": "vor 6 Monaten",
        "comment": "Hotel in schlechtem Zustand, Renovierung überfällig: musste zweimal das Zimmer wechseln, im ersten hat es furchtbar moderig gerochen, im zweiten war die Dusche defekt, es hat über eine Stunde gedauert bis ich letztlich ein drittes bekommen habe mit verschimmelten Fugen in der Dusche und altem Duschvorhang, alles in schlechtem Zustand. Hier kommt hinzu dass der Service absolut schlecht ist und sich noch nicht mal für meine Beschwerde entschuldigt hatte. Einzig die Lage ist positiv hervorzuheben. Alles in allem sportlicher Preis für ein schlechtes Hotel, das dem Markennamen Hilton absolut nicht gerecht wird."
      },
      {
        "review_id": "Ci9DQUlRQUNvZENodHljRjlvT2tSUVZsUnhaWGxvYlVWaldtTkRWQzFEYUhoNlFXYxAB",
        "reviewer": {
          "profile_photo_url": "https://lh3.googleusercontent.com/a/ACg8ocJpSWnm_TLvPgWnG_WtYabL505Nx9JyMHMbeJn0yzk8ycarrQ=s120-c-rp-mo-ba4-br100",
          "display_name": "Katharina H.",
          "link": "https://www.google.com/maps/contrib/107438252515681568592?hl=de"
        },
        "link": "https://www.google.com/maps/reviews/data=!4m8!14m7!1m6!2m5!1sCi9DQUlRQUNvZENodHljRjlvT2tSUVZsUnhaWGxvYlVWaldtTkRWQzFEYUhoNlFXYxAB!2m1!1s0x0:0x2a34371cb33f3c80!3m1!1s2@1:CAIQACodChtycF9oOkRQVlRxZXlobUVjWmNDVC1DaHh6QWc%7C0cxt0oRBBtx%7C?hl=de",
        "source": "Google",
        "source_logo": "https://www.gstatic.com/images/branding/product/1x/googleg_48dp.png",
        "rating": "4/5",
        "created": "vor 4 Monaten",
        "comment": "Wir hatten ein ruhiges Zimmer. Für drei Personen groß genug. Die Zimmerbeleuchtung war ungenügend und die Fahrstuhlwartezeiten lang.\nOptimaler Ausgangspunkt für Besichtigungen in Manhatten.",
        "review_reply": "Dear Katharina,\nThank you for sharing your thoughts with us. We are glad you appreciated our spacious accommodations and peaceful environment in the city. It was a pleasure having you as a guest, and we look forward to welcoming you back for an even more exceptional visit in the future.\n\nSincerely,\n\nNew York Hilton Midtown Team\n\n\nNYCNH_FO@hilton.com",
        "review_reply_created": "vor 4 Monaten",
        "details": [
          {
            "id": "HOTELS_ASPECT_ROOMS",
            "name": "Zimmer",
            "value": 4,
            "description": "Zimmer"
          },
          {
            "id": "HOTELS_ASPECT_SERVICES",
            "name": "Service",
            "value": 4,
            "description": "Service"
          },
          {
            "id": "HOTELS_ASPECT_LOCATION",
            "name": "Standort",
            "value": 5,
            "description": "Standort"
          }
        ]
      },
      {
        "review_id": "Ci9DQUlRQUNvZENodHljRjlvT2tGalowOUdYMmxXUjI1aVh6aExPRkpRTVY5Sk9GRRAB",
        "reviewer": {
          "profile_photo_url": "https://lh3.googleusercontent.com/a-/ALV-UjVmtAB8AXA5ZvOm6ghmukAtEDbWPKD_ZXaenKTdm1xxzhvEN7Ti=s120-c-rp-mo-ba5-br100",
          "display_name": "Claudia „CW“ Winter",
          "link": "https://www.google.com/maps/contrib/101770904039323526520?hl=de"
        },
        "link": "https://www.google.com/maps/reviews/data=!4m8!14m7!1m6!2m5!1sCi9DQUlRQUNvZENodHljRjlvT2tGalowOUdYMmxXUjI1aVh6aExPRkpRTVY5Sk9GRRAB!2m1!1s0x0:0x2a34371cb33f3c80!3m1!1s2@1:CAIQACodChtycF9oOkFjZ09GX2lWR25iXzhLOFJQMV9JOFE%7C0cnJVHEw1wA%7C?hl=de",
        "source": "Google",
        "source_logo": "https://www.gstatic.com/images/branding/product/1x/googleg_48dp.png",
        "rating": "4/5",
        "created": "vor 5 Monaten",
        "comment": "Der perfekte Hotel für New York Sightseeing! Direkt am MoMA und parallel zur 5th und Broadway. Subway in allen Richtungen in der Nähe! Central Park um die Ecke. Passt.\nDas Hotel ist okay, aber top Service, sauber und ordentlich!\nGeräuschabsorbierende Fenster wären allerdings toll!!!",
        "review_reply": "Dear Claudia,\nThank you so much for your recent stay at New York Hilton Midtown. We’re delighted to have been a small part of your amazing trip. It’s wonderful to hear that our central location made it easy for you to explore the city. We know how much convenience matters when traveling. We also appreciate your kind words about our staff. Our team takes great pride in going above and beyond to provide every guest with exceptional service. With the hotel located in the heart of Manhattan, the city’s energy and vibrancy can sometimes bring extra noise, and we sincerely apologize for any inconvenience this may have caused. Thank you again for your thoughtful review, and we look forward to welcoming you back on your next visit to New York City.\n\nSincerely,\n\nNew York Hilton Midtown Team\n\nNYCNH_FO@hilton.com",
        "review_reply_created": "vor 5 Monaten",
        "details": [
          {
            "id": "HOTELS_PILOT_TRAVEL_GROUP_TYPE",
            "name": "Reisegruppe",
            "value": "Familie",
            "description": "Mit wem bist du gereist?"
          },
          {
            "id": "HOTELS_ASPECT_ROOMS",
            "name": "Zimmer",
            "value": 4,
            "description": "Zimmer"
          },
          {
            "id": "HOTELS_ASPECT_SERVICES",
            "name": "Service",
            "value": 5,
            "description": "Service"
          },
          {
            "id": "HOTELS_ASPECT_LOCATION",
            "name": "Standort",
            "value": 5,
            "description": "Standort"
          },
          {
            "id": "HOTELS_TIPS_TOPICS_ROOMS",
            "name": "Zimmer",
            "value": "Okay, zu dritt machbar!\nAn Ausstattung fehlt nichts!",
            "description": "Zimmer"
          },
          {
            "id": "HOTELS_TIPS_TOPICS_NEARBY_ACTIVITIES",
            "name": "Aktivitäten in der Nähe",
            "value": "MoMA, Broadway, Central Park, 5 the Avenue",
            "description": "Aktivitäten in der Nähe"
          },
          {
            "id": "HOTELS_TIPS_TOPICS_SAFETY",
            "name": "Sicherheit",
            "value": "Sehr sicher!",
            "description": "Sicherheit"
          },
          {
            "id": "HOTELS_TIPS_TOPICS_WALKABILITY",
            "name": "Fußläufigkeit",
            "value": "Vieles s. Stadtplan",
            "description": "Fußläufigkeit"
          },
          {
            "id": "HOTELS_TIPS_TOPICS_FOOD_AND_DRINKS",
            "name": "Speisen und Getränke",
            "value": "Ist gesorgt.",
            "description": "Speisen und Getränke"
          },
          {
            "id": "HOTELS_VIBE",
            "name": "Highlights des Hotels",
            "value": "Gutes Preis-Leistungs-Verhält.",
            "description": "Wie würdest du das Hotel beschreiben?"
          }
        ]
      },
      {
        "review_id": "Ci9DQUlRQUNvZENodHljRjlvT21aSldraGtWVmhJVmxsNFZHVnlVa1kyZVZKa1JtYxAB",
        "reviewer": {
          "profile_photo_url": "https://lh3.googleusercontent.com/a/ACg8ocIDHdg1hHG__X5gKEg30yEArZkJfh3U0QDEfAzBCqCWsecZcQ=s120-c-rp-mo-ba2-br100",
          "display_name": "Susanne Weber",
          "link": "https://www.google.com/maps/contrib/100391510259633012665?hl=de"
        },
        "link": "https://www.google.com/maps/reviews/data=!4m8!14m7!1m6!2m5!1sCi9DQUlRQUNvZENodHljRjlvT21aSldraGtWVmhJVmxsNFZHVnlVa1kyZVZKa1JtYxAB!2m1!1s0x0:0x2a34371cb33f3c80!3m1!1s2@1:CAIQACodChtycF9oOmZJWkhkVVhIVll4VGVyUkY2eVJkRmc%7C0ckBmsSzIH4%7C?hl=de",
        "source": "Google",
        "source_logo": "https://www.gstatic.com/images/branding/product/1x/googleg_48dp.png",
        "rating": "3/5",
        "created": "vor 5 Monaten",
        "comment": "Das Zimmer ist etwas älter und herabgekommen. Der Service allerdings top.\nDie Lage ist super viele Essens Möglichkeiten und zum Times Square braucht man zu Fuß ca. 10 Minuten.",
        "review_reply": "Thank you for sharing your feedback with us. We’re happy to hear you enjoyed our convenient location with many dining options nearby and just a short walk to Times Square. We’re also especially pleased that our service team made a positive impression during your stay.\n\nWe appreciate your comments regarding the condition of the room and will certainly keep them in mind as we continue to make improvements. Your input is very valuable to us.\n\nWe hope to have the pleasure of welcoming you again on your next visit to New York.",
        "review_reply_created": "vor 5 Monaten",
        "details": [
          {
            "id": "HOTELS_ASPECT_ROOMS",
            "name": "Zimmer",
            "value": 2,
            "description": "Zimmer"
          },
          {
            "id": "HOTELS_ASPECT_SERVICES",
            "name": "Service",
            "value": 5,
            "description": "Service"
          },
          {
            "id": "HOTELS_ASPECT_LOCATION",
            "name": "Standort",
            "value": 4,
            "description": "Standort"
          }
        ]
      },
      {
        "review_id": "Ci9DQUlRQUNvZENodHljRjlvT21aTlFXTk9kMFZOWmxwMVUxaHpNRlYwYURORlEyYxAB",
        "reviewer": {
          "profile_photo_url": "https://lh3.googleusercontent.com/a-/ALV-UjW5NjVfqYWafONdXqb_FIJQrKBgmu0EYM4mDa_Y2ajFVoGE5IQ=s120-c-rp-mo-br100",
          "display_name": "K W",
          "link": "https://www.google.com/maps/contrib/114251727041856868421?hl=de"
        },
        "link": "https://www.google.com/maps/reviews/data=!4m8!14m7!1m6!2m5!1sCi9DQUlRQUNvZENodHljRjlvT21aTlFXTk9kMFZOWmxwMVUxaHpNRlYwYURORlEyYxAB!2m1!1s0x0:0x2a34371cb33f3c80!3m1!1s2@1:CAIQACodChtycF9oOmZNQWNOd0VNZlp1U1hzMFV0aDNFQ2c%7C0d4bRMrp-ze%7C?hl=de",
        "source": "Google",
        "source_logo": "https://www.gstatic.com/images/branding/product/1x/googleg_48dp.png",
        "rating": "3/5",
        "created": "vor 3 Monaten",
        "date": "2025-11-14",
        "comment": "Business-Hotel in Superlage in Midtown, leider komplett abgenutzt, abgewetzte, durchgesessene Stühle in Restaurants, abgebatzte Tische, eines Hilton-Hotels nicht würdig, altes, spartanisch ausgestattetes Zimmer, weit von Hilton-Standard entfernt, freundliches Personal in Restaurants, extrem lange Wartezeiten am Lift, für einen angeblichen early Check-in ( Ankunft ca.15.00 Uhr ?!) wurden kommentarlos 62 $ liquidiert, eine Frechheit, schlechte Preis-Leistungsrelation, absolut enttäuschend, wir sind noch nie in einem derart heruntergekommenen Hilton-Hotel zu solch stolzen Preisen untergekommen,",
        "review_reply": "Thank you for sharing your feedback with us. While we are glad that our team made a positive impression with their friendliness, we are sorry that your stay did not meet your expectations. The comfort and satisfaction of our guests are extremely important to us, and we regret that the condition of the room and restaurant furnishings, as well as the elevator wait times, left you disappointed. Please be assured that your comments have been shared with our team as we strive to make improvements for the benefit of our guests. Regarding the charge you mentioned, we would like to clarify that a Daily Mandatory Destination Charge is added to the room rate. This fee includes premium guest internet access, a daily food and beverage credit for use at our hotel restaurant, bar, and lounge, and local, toll-free, and domestic long-distance phone calls. We apologize if this was not clearly communicated at check-in. We truly appreciate your feedback and hope you will consider giving us another opportunity to provide you with a significantly improved experience in the future. \n\nSincerely,\n\nNew York Hilton Midtown Team\n\nNYCNH_FO@hilton.com",
        "review_reply_created": "vor 3 Monaten",
        "photos": [
          "https://lh3.googleusercontent.com/geougc-cs/ABOP9psD99uhp4c6bAv0MfdVqwaMtWuBIYiDtTfsPsKEdWxseOANkyYEm8whJuoagC4sG3tzDoBaLWp8yZo-3skl7lMThHTpzJlb8DHdPqM1Y9kkEvbk122E1vgzZgT6YvieRLA9v3VoQZjDspM",
          "https://lh3.googleusercontent.com/geougc-cs/ABOP9psrUoxUdtiMo4y87m0yMYNV7BwN-aKu-qfYQ61clp_ekR3ErP24zGyyvhKcK0-goSwuz6m5Acw6fGo0N5CndB7LDjD8azcs7gLXB7AjnAU7twQJ7dJQrGWWVIQ1PCWqueoS6ZjlTOX86hA"
        ],
        "details": [
          {
            "id": "HOTELS_PILOT_TRIP_TYPE",
            "name": "Art der Reise",
            "value": "Urlaub",
            "description": "Welche Art von Reise hast du unternommen?"
          },
          {
            "id": "HOTELS_PILOT_TRAVEL_GROUP_TYPE",
            "name": "Reisegruppe",
            "value": "Paar",
            "description": "Mit wem bist du gereist?"
          },
          {
            "id": "HOTELS_ASPECT_ROOMS",
            "name": "Zimmer",
            "value": 2,
            "description": "Zimmer"
          },
          {
            "id": "HOTELS_ASPECT_SERVICES",
            "name": "Service",
            "value": 3,
            "description": "Service"
          },
          {
            "id": "HOTELS_ASPECT_LOCATION",
            "name": "Standort",
            "value": 5,
            "description": "Standort"
          },
          {
            "id": "HOTELS_TIPS_TOPICS_ROOMS",
            "name": "Zimmer",
            "value": "Einfach ausgestattet und verwohnt, wenig und schwaches Licht",
            "description": "Zimmer"
          },
          {
            "id": "HOTELS_TIPS_TOPICS_FOOD_AND_DRINKS",
            "name": "Speisen und Getränke",
            "value": "Hochpreisige Selfservicetheke, einfache Speisekarte, insgesamt recht rustikales Ambiente, völlig durchgesessene, altes Sitzmobiliar",
            "description": "Speisen und Getränke"
          },
          {
            "id": "HOTELS_VIBE",
            "name": "Highlights des Hotels",
            "value": "Schöne Aussicht",
            "description": "Wie würdest du das Hotel beschreiben?"
          }
        ]
      },
      {
        "review_id": "Ci9DQUlRQUNvZENodHljRjlvT2pKa1FVTlZRekJxYkVwMmNVRnBSRk5OZEhNMFMxRRAB",
        "reviewer": {
          "profile_photo_url": "https://lh3.googleusercontent.com/a/ACg8ocKxgJM--MNqq2CXCjp564UgKU-0MM9ep-nva-7-XQFvAqJUWw=s120-c-rp-mo-br100",
          "display_name": "Nadina Diermann",
          "link": "https://www.google.com/maps/contrib/110667864867690310032?hl=de"
        },
        "link": "https://www.google.com/maps/reviews/data=!4m8!14m7!1m6!2m5!1sCi9DQUlRQUNvZENodHljRjlvT2pKa1FVTlZRekJxYkVwMmNVRnBSRk5OZEhNMFMxRRAB!2m1!1s0x0:0x2a34371cb33f3c80!3m1!1s2@1:CAIQACodChtycF9oOjJkQUNVQzBqbEp2cUFpRFNNdHM0S1E%7C0cUxAXdB9a7%7C?hl=de",
        "source": "Google",
        "source_logo": "https://www.gstatic.com/images/branding/product/1x/googleg_48dp.png",
        "rating": "1/5",
        "created": "vor 7 Monaten",
        "date": "2025-07-22",
        "comment": "Auf gar keinen Fall dieses Hotel buchen!!\nWir hatten uns dafür entschieden, weil es sehr zentral liegt (fußläufig zum Times Square und Central Park) und auf den Bildern recht großzügig geschnittene Zimmer hatte. In dieser Lage sind alle Hotels ähnlich teuer, daher dachten wir, mit einem Hilton Hotel können wir nicht viel falsch machen.\n\nOh doch. Die Zimmer sind in der Tat groß und die Klimaanlage funktionierte gut, das ist aber auch schon das einzig positive, was man über dieses Haus sagen kann.\n\nZimmer:\nDas Zimmer war nicht geputzt und wurde während der Woche, die wir da waren auch nicht geputzt, fingerdicker Staub auf den Oberflächen, fleckige Lampenschirme & Rollos, Fettflecken auf dem Fenster, ein Krümel, der mir am ersten Tag herunterfiel lag 7 Tage später immer noch auf dem Teppich. Handtücher gab es zwar täglich neu, jedoch meist in zufällig gewählter Anzahl (mal 4, mal 3 mal 5) und ALLE hatten immer schwarze Flecken, die nicht von uns kamen (siehe Fotos). Auch auf den Bettlaken fanden sich diese. Die Minibar war leer und blieb leer, der Safe ging nur auf, wenn man die Tür der Kommode mit komplett ausgerissenem Scharnier in einem bestimmten Winkel geöffnet hat (siehe Foto). Ein klebriger Föhn wird bereitgestellt, Klobürste gibt es nicht und die Wände sind so dünn, dass man die Gäste im Nachbarzimmer schnarchen hört.\n\nAb 8:30 klopft der Roomservice, ob man schon fertig sei, was wir als Urlaubsgäste schon sehr früh fanden, zumal ja offenbar nichts geputzt wurde.\n\nRestliche Räumlichkeiten:\nAuch im restlichen Hotel ist alles in die Jahre gekommen und sehr lieblos. Die Lobby hat mehr von einer Bahnhofshalle, es schieben sich ständig Massen hindurch (Tagungsgäste, Schulklassen, Einzelreisende etc.) und um einen Rezeptionisten zu sprechen muss man sich wie im Freizeitpark in ein Warteschlangen-Leitsystem aus Gurten einfädeln. Um mit dem passenden Aufzug zu unserem Zimmer zu fahren mussten wir teilweise 10-15 Minuten anstehen und warten. Die Bar im Erdgeschoss wirkt eher wie eine Sportsbar, Wellnessbereich gibt es keinen und in den Fluren hat man die abblätternde Tapete mit Klebeband geklebt (siehe Foto).\n\nPreise:\nBeim Check in wurde uns mitgeteilt, dass es erforderlich sei, eine Kaution zu hinterlegen. Soweit nicht unüblich. Aber der Mitarbeiter wollte 100$ pro Nacht! Wir waren eine Woche dort und somit wurden direkt 700$ auf der Kreditkarte belastet! Das wurde bei der Buchung mit keiner Silbe erwähnt, und wir fanden das wirklich einen unverschämten Betrag, erst recht, nachdem wir das Zimmer gesehen hatten. Sowas müssen sich Leute ggf. in ihr Reisebudget einplanen, für 14 Tage wären direkt 1.400$ belastet worden, in den ersten 10 Minuten des Aufenthalts. Nachdem die Minibar ja leer war und es zwar einen Eisspender gibt, dies aber eins der wenigen Hotels in New York zu sein scheint, das keinen Wasserspender anbietet, wollten wir im Hotel-Kiosk eine Flasche Wasser kaufen. Die günstigste 1 Liter Plastik-Flasche Wasser kostete sage und schreibe 10,30$ (!) Für Wasser. Das es in den meisten anderen Hotels gratis gibt. Eine bodenlose Unverschämtheit.\n\nAm letzten Tag waren wir auf die Gepäckaufbewahrung angewiesen, da unser Flug erst Abends ging. Kostete 5 $ pro Gepäckstück. Wir hatten jeder einen Rucksack und einen Koffer, also nochmal 20$. Und man wird nochmal freundlich darauf hingewiesen, dass trotzdem keine Haftung besteht, wenn das Gepäck am Ende weg oder beschädigt ist (siehe Foto).\nIch habe in meinem Leben noch nie als Gast für Gepäckaufbewahrung im eigenen Hotel bezahlt, schon gar nicht in einem Hilton.\n\nDer ganze Aufenthalt war wirklich eine bodenlose Unverschämtheit, schmutzige Zimmer, völlig überfüllt, Zero Service und man versucht wo es nur geht dem Gast noch weitere Hundert Dollar aus der Tasche zu ziehen, für Leistungen die eigentlich selbstverständlich sind. Ohne Worte. Und alles zu einem stolzen Preis.\n\nBitte, bitte suchen Sie sich für das gleiche Geld ein ordentliches Hotel in der Nachbarschaft mit ggf. kleineren Zimmern, das Hotel ist sein Geld absolut nicht wert!!",
        "review_reply": "Thank you for taking the time to share such detailed feedback. I am truly sorry to hear about your disappointing experience during your stay with us.\n\nPlease accept our sincerest apologies for the cleanliness issues you encountered in your room, as well as for the overall condition and upkeep that fell far short of expectations. What you described is not reflective of the standards we strive to uphold, and I regret that we did not provide the quality and comfort you rightfully anticipated from a Hilton property.\n\nWe understand how frustrating these matters must have been and are committed to addressing them to prevent recurrence.\n\nWhile we realize this does not change your experience, I do hope you will give us an opportunity to restore your confidence in the future.\n\nSincerely,",
        "review_reply_created": "vor 7 Monaten",
        "photos": [
          "https://lh3.googleusercontent.com/geougc-cs/ABOP9pv9nlsgzWSFYx5qgh248fZn_NdZ0PblXCfkvu6LJw11KEU-w67Qul8TW4ZY7nkabkwR6fWAj7co6ZXL2OzmgTGSXFLZpt4WmV4YbVG04XiHHOYsPF-1LgCbOdvlL0iKWmhZ94NyefalVpxC",
          "https://lh3.googleusercontent.com/geougc-cs/ABOP9puGFHIu940jqX0WVQb_LBLN_3HZptDZm9BtZ6yHn8CO2NgZHVbeYvbNqt_Oz6avzl9Hgzbm2KVBhSFl4TycSITq4Gmf9iEejSWh6LeA7epSVwGYFZURz4URM2SzkFBBLK6gE7tN99Jzw8E",
          "https://lh3.googleusercontent.com/geougc-cs/ABOP9puDhUeyGlou3_1X-o69to-J56T18QHMw9ypdvPuze9H6GxBxZ97MulCDendHg9wZmfUvVLhm-QNiROlJesv4lk34fYlbw9QlKPHOU8lWIjGpsAhZWlAAfB_azRppjXFMstUaSPgV9iP80V0",
          "https://lh3.googleusercontent.com/geougc-cs/ABOP9psyO0JBwHt8RN46oAZKM-L8KrylDSikVI3vPO6e5WrFreOG0XyyZ2n1m434xlT62kE6rvgKxKffAhrpokPDBcQoPUluGQWlw1BZOm3Bjj4U_9dMRRrtUzZdxm3UF6AGUP46-kPym_38zDgF",
          "https://lh3.googleusercontent.com/geougc-cs/ABOP9ptsosofwJjA-HqFhvsj94P3blZzq6GLLFKceT-o0R_TgHUkdCESNDir43DuNFC12SyLyZcx8vQbKlzBejQLOWNc8JdP_p5ZDN3T-_cAb5zizA6cBzTN_urdXLqBFfAFrz_wQnRQLgaI-AhI",
          "https://lh3.googleusercontent.com/geougc-cs/ABOP9pvpUH4L15r1729ydJPdoIbfie5oNq3EkL4eQXsQN-QVsvymF-FK6sWEdGldDsiNpCZspinezSelNwrQvap6WGc8Ob2tPHTvLT0MU4uLLDUWr97zGsZ5tmYb2at-z577OOioutRRMh849mtu",
          "https://lh3.googleusercontent.com/geougc-cs/ABOP9puFDADRqWtwqr2KSjqJJZV6HHujO14Sddj6i-M-GxkB8PVHQQLpnKIj_n-QubZ7WJGSnlHRaKIa4unBCt6e87rTx2xqE1PMUXh9iPlMfCf9jioxn09N33M6BMecdR0jE97XpcquyKnqxBBf"
        ],
        "details": [
          {
            "id": "HOTELS_PILOT_TRIP_TYPE",
            "name": "Art der Reise",
            "value": "Urlaub",
            "description": "Welche Art von Reise hast du unternommen?"
          },
          {
            "id": "HOTELS_PILOT_TRAVEL_GROUP_TYPE",
            "name": "Reisegruppe",
            "value": "Paar",
            "description": "Mit wem bist du gereist?"
          },
          {
            "id": "HOTELS_ASPECT_ROOMS",
            "name": "Zimmer",
            "value": 1,
            "description": "Zimmer"
          },
          {
            "id": "HOTELS_ASPECT_SERVICES",
            "name": "Service",
            "value": 1,
            "description": "Service"
          },
          {
            "id": "HOTELS_ASPECT_LOCATION",
            "name": "Standort",
            "value": 3,
            "description": "Standort"
          }
        ]
      },
      {
        "review_id": "ChdDSUhNMG9nS0VJQ0FnTURvNy1hYzRBRRAB",
        "reviewer": {
          "profile_photo_url": "https://lh3.googleusercontent.com/local-reviews/AJMZ0QewvQXK08PhtQgCu1fT7TcdWcgcaXdOmFk48xW5xlmLo-Eqy0UOp2YqveGvl0etYz5BzA=s120-c-br100",
          "display_name": "Vo10",
          "link": "https://www.tripadvisor.de/ShowUserReviews-g60763-d611947-r971507489?m=68573&staydates=2026_03_08_2026_03_09&uguests=1_2_0&supdv=desktop&supuc=PH&supul=de"
        },
        "link": "https://www.tripadvisor.de/ShowUserReviews-g60763-d611947-r971507489?m=68573&staydates=2026_03_08_2026_03_09&uguests=1_2_0&supdv=desktop&supuc=PH&supul=de",
        "source": "Tripadvisor",
        "source_logo": "https://www.gstatic.com/travel-hotels/branding/icon_100532569.png",
        "rating": "4/5",
        "created": "vor einem Jahr",
        "comment": "Das Hotel liegt zentral in Midtown und ist mit der U-Bahn gut zu erreichen. |Das Personal an der Rezeption war freundlich und es gab zum Glück keine lange Wartezeit. |Zimmer und Bad waren sauber und es gab genügend Handtücher. Das Zimmer war zweckmäßig eingerichtet.|Hatte das Zimmer ohne Frühstück gebucht da es genügend Möglichkeiten zum Frühstücken in der Nähe gibt."
      }
    ]
  }
  ```
</ResponseExample>


# Google Reviews pagination
Source: https://docs.brightdata.com/api-reference/serp/google-reviews/pagination

Configure the Bright Data Google Reviews Google Reviews pagination parameter to refine queries and return matching results as JSON or HTML. On port 44445.

```txt wrap theme={null}
https://www.google.com/reviews?fid=0x89c25855c0679529:0x2a34371cb33f3c80&start=10
```

## Parameters

<ParamField type="string">
  Feature id what you want to fetch reviews to. `fid` parameter can be found in `knowledge.fid` field of google search response.
</ParamField>

<ParamField type="string">
  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.

  ```txt wrap theme={null}
  https://www.google.com/reviews?fid=0x89c25855c0679529:0x2a34371cb33f3c80&start=10
  ```
</ParamField>

<ParamField type="string">
  <Warning>
    **Deprecated As of September 11, 2025 by Google**

    * The Number of results to return is usually 10, results' set size may vary.
    * The `start` parameters can be used to paginate within results' set. 
    * To get top 100 results, Bright Data offers a Web Scraping API. Read more here: [Get top google 100 results in one API call](/scraping-automation/serp-api/get-top-100-google-results)
  </Warning>
</ParamField>

<RequestExample>
  ```shell cURL highlight={6} theme={null}
    curl -X POST https://api.brightdata.com/request \
    --header "Content-Type: application/json" \
    --header "Authorization: Bearer API_KEY" \
    --data '{
      "zone": "serp_api1",
      "url": "https://www.google.com/reviews?fid=0x89c25855c0679529:0x2a34371cb33f3c80&start=10",
      "format": "raw"
    }'
  ```

  ```shell Native proxy highlight={4} theme={null}
  curl --proxy brd.superproxy.io:44445 \
    --proxy-user CUSTOMER_USERNAME:CUSTOMER_PASSWORD \
    --ssl-no-revoke \
    "https://www.google.com/reviews?fid=0x89c25855c0679529:0x2a34371cb33f3c80&start=10"
  ```

  ```js Node.js highlight={10} theme={null}
  (async () => {
    const response = await fetch('https://api.brightdata.com/request', {
      method: 'POST',
      headers: {
        'Content-Type': 'application/json',
        'Authorization': 'Bearer API_KEY'
      },
      body: JSON.stringify({
        zone: 'serp_api1',
        url: 'https://www.google.com/reviews?fid=0x89c25855c0679529:0x2a34371cb33f3c80&start=10',
        format: 'raw'
      })
    });
    
    const data = await response.text();
    console.log(data);
  })();
  ```

  ```python Python highlight={11} theme={null}
  import requests

  # API Configuration
  headers = {
      'Content-Type': 'application/json',
      'Authorization': 'Bearer API_KEY',
  }

  payload = {
      'zone': 'serp_api1',
      'url': 'https://www.google.com/reviews?fid=0x89c25855c0679529:0x2a34371cb33f3c80&start=10',
      'format': 'raw'
  }

  # Make the request
  response = requests.post(
      'https://api.brightdata.com/request', 
      json=payload, 
      headers=headers
  )

  print(response.text)
  ```
</RequestExample>

<ResponseExample>
  ```json 200 theme={null}
  {
    "reviews": [
      {
        "review_id": "Ci9DQUlRQUNvZENodHljRjlvT214TVYwUnBkeTB4YVVSUFdXVmpkRVF5YUdWNU5VRRAB",
        "reviewer": {
          "profile_photo_url": "https://lh3.googleusercontent.com/a/ACg8ocL3C36IqORKTyGT30AEfavKkHg-QKtec5fuvyfp5frlqqNi8A=s120-c-rp-mo-br100",
          "display_name": "Rose Vu",
          "link": "https://www.google.com/maps/contrib/104779998134668984454?hl=en"
        },
        "link": "https://www.google.com/maps/reviews/data=!4m8!14m7!1m6!2m5!1sCi9DQUlRQUNvZENodHljRjlvT214TVYwUnBkeTB4YVVSUFdXVmpkRVF5YUdWNU5VRRAB!2m1!1s0x0:0x2a34371cb33f3c80!3m1!1s2@1:CAIQACodChtycF9oOmxMV0Rpdy0xaURPWWVjdEQyaGV5NUE%7C0d4z-lTsbDt%7C?hl=en",
        "source": "Google",
        "source_logo": "https://www.gstatic.com/images/branding/product/1x/googleg_48dp.png",
        "rating": "4/5",
        "created": "3 months ago",
        "comment": "Great location. Double room with city view was very spacious. Nice gym. Helpful staff all throughout the hotel. Nice random free wine hour one evening. It’s a very large hotel.\n\nMy only two complaints are:\n\nWaiting for the elevator can be very annoying in the mornings and evenings. We ended up using the alternative elevator one morning because the normal ones came by already packed.\n\nThe hot water situation. In order for us to get hot water, we had to run the faucet for 5-7 mins. This was something I had never encountered in any hotel I’ve ever stayed at and was a disappointment considering this hotel is a 4-star hotel. I had to repeat this for each person in the room who planned to shower. It was also an inconvenience during a colder week to not have hot water immediately available.",
        "review_reply": "Dear Rose,\nThank you for staying with us and for sharing these thoughtful details. Hearing that the city view room felt spacious, the gym supported your routine, our team was genuinely helpful, and the surprise wine hour added a nice touch means a great deal. However, we regret the elevator congestion during peak times and the delay before hot water reached the tap. We'll be sure to share your comments with maintenance to improve speed and consistency. Your stay should feel seamless from elevator timing to a comfortable shower, and we hope to welcome you back for a seamless experience down the line.\n\nSincerely,\n\nNew York Hilton Midtown Team\n\nNYCNH_FO@hilton.com",
        "review_reply_created": "3 months ago",
        "details": [
          {
            "id": "HOTELS_ASPECT_ROOMS",
            "name": "Rooms",
            "value": 4,
            "description": "Rooms"
          },
          {
            "id": "HOTELS_ASPECT_SERVICES",
            "name": "Service",
            "value": 5,
            "description": "Service"
          },
          {
            "id": "HOTELS_ASPECT_LOCATION",
            "name": "Location",
            "value": 5,
            "description": "Location"
          }
        ]
      },
      {
        "review_id": "Ci9DQUlRQUNvZENodHljRjlvT21OV1RXdDZRME5yYm01RU9UVXpiMDVEU25kcU5VRRAB",
        "reviewer": {
          "profile_photo_url": "https://lh3.googleusercontent.com/a/ACg8ocJw2qrSfWVwpVjOvixKQwrktL_cVaBt27i66c8B0MoldFk_n8QQ=s120-c-rp-mo-ba3-br100",
          "display_name": "megan zhang",
          "link": "https://www.google.com/maps/contrib/114757865199967482135?hl=en"
        },
        "link": "https://www.google.com/maps/reviews/data=!4m8!14m7!1m6!2m5!1sCi9DQUlRQUNvZENodHljRjlvT21OV1RXdDZRME5yYm01RU9UVXpiMDVEU25kcU5VRRAB!2m1!1s0x0:0x2a34371cb33f3c80!3m1!1s2@1:CAIQACodChtycF9oOmNWTWt6Q0Nrbm5EOTUzb05DSndqNUE%7C0d7PxGL8OrX%7C?hl=en",
        "source": "Google",
        "source_logo": "https://www.gstatic.com/images/branding/product/1x/googleg_48dp.png",
        "rating": "3/5",
        "created": "3 months ago",
        "date": "2025-11-22",
        "comment": "We visit NYC at least once a year. The Hilton Midtown is well located. Hotel lobby has no sitting area for guest to rest. We waited 30 mins to check in, November 21st Friday, so prepared long waiting time. Booked a room with two beds, end up given one king and a pull out couch, the hotel is totally sold out. The front desk lady was not very friendly. She was exhausted and not  very patient. I am in hospitality business, it’s understandable but not acceptable. It didn’t bother me . Management team should either train your employees better or schedule more employees to work. The hotel room is spacious for NYC, but the pull out couch is stained. I will have to call at late night to request sheets to cover it. Hotel Gym is big and well equipped. I also just read they charge $5 per luggage to store your luggage after check out which I will need this service when we check out on Monday. I travel everywhere in the world. First time see a nice hotel charging luggage storage.  Hilton should know you are not Handling hostels guests. Your guests need only couple of  hours to be hands free before catching their flight.",
        "review_reply": "Dear Megan,\nThank you for sharing your comments about your recent stay. It is disappointing to hear about the long check-in wait, the room type not matching your reservation, and the condition of the sofa bed. The experience at the front desk should feel patient and professional, and it is regrettable that this interaction felt otherwise. Your points regarding service are important and will be reviewed internally. It is good to know that the room size and gym were positive aspects, and we hope to welcome you back for a visit that feels far more comfortable and well-supported.\n\nSincerely,\n\nNew York Hilton Midtown Team\n\nNYCNH_FO@hilton.com",
        "review_reply_created": "Edited 3 months ago",
        "photos": [
          "https://lh3.googleusercontent.com/geougc-cs/ABOP9psfevwStQ-CTLagO0LNX5SdjuBX4sQ0xD8ifxyabsqHgHEkdSBa3R0r8B7aAHNfXI_hhxx8XcM_c8lmQbEaZfBxSJsQvf_2eLf08e3FNs-vyZFLOcDx1-0ARxiAwW2SpSBXRyE0gbyQOrl_",
          "https://lh3.googleusercontent.com/geougc-cs/ABOP9ptxi7ADgZPrCMkqepy6MhIITVdd_bCbN3TdsOhsck0m2G149zwbxnEbp2P_VfJmTt03vzpViQR8SYYQmbai7Lt4PpTBERH9sROcDVadqZNvEQn96vxxZ2rsmVSnIAu2GZ9SIuwi7Ex344yp"
        ],
        "details": [
          {
            "id": "HOTELS_ASPECT_ROOMS",
            "name": "Rooms",
            "value": 3,
            "description": "Rooms"
          },
          {
            "id": "HOTELS_ASPECT_SERVICES",
            "name": "Service",
            "value": 4,
            "description": "Service"
          },
          {
            "id": "HOTELS_ASPECT_LOCATION",
            "name": "Location",
            "value": 5,
            "description": "Location"
          }
        ]
      },
      {
        "review_id": "Ci9DQUlRQUNvZENodHljRjlvT205UVowMVZTbTF2V25aVVNsWm5PVTlSTUVrNVgyYxAB",
        "reviewer": {
          "profile_photo_url": "https://lh3.googleusercontent.com/a/ACg8ocIgaHv0uz4qb1IAWCes4xZmxRX7BTldk_Dk5zU0797PEdLoSA=s120-c-rp-mo-ba3-br100",
          "display_name": "John S",
          "link": "https://www.google.com/maps/contrib/104471260898528618969?hl=en"
        },
        "link": "https://www.google.com/maps/reviews/data=!4m8!14m7!1m6!2m5!1sCi9DQUlRQUNvZENodHljRjlvT205UVowMVZTbTF2V25aVVNsWm5PVTlSTUVrNVgyYxAB!2m1!1s0x0:0x2a34371cb33f3c80!3m1!1s2@1:CAIQACodChtycF9oOm9QZ01VSm1vWnZUSlZnOU9RMEk5X2c%7C0dI4AoZafdG%7C?hl=en",
        "source": "Google",
        "source_logo": "https://www.gstatic.com/images/branding/product/1x/googleg_48dp.png",
        "rating": "4/5",
        "created": "2 months ago",
        "comment": "Great hotel in Downtown NYC.  Perfect location for Christmas Season as we could walk everywhere with young kids.  Would definitely stay there again.  Service was very responsive, from checking bags on arrival to room requests.  Clean rooms although old, but no complaints.  Elevators are going through an upgrade process so some delays there, but just had to give yourself an extra 2-5 minutes incase they were delayed or crowded.\nI would definitely stay here again.",
        "review_reply": "Dear John,\nThank you for sharing your experience. We’re delighted to hear that our downtown location worked so well for your family and that our team provided responsive service from start to finish. We appreciate your understanding regarding our elevators during the enhancement process and are glad our room cleanliness and overall stay met your expectations. Your kind words mean a lot, and we look forward to welcoming you back to New York Hilton Midtown for another enjoyable visit.\n\nSincerely,\n\nNew York Hilton Midtown Team\n\nNYCNH_FO@hilton.com",
        "review_reply_created": "a month ago",
        "details": [
          {
            "id": "HOTELS_PILOT_TRIP_TYPE",
            "name": "Trip type",
            "value": "Vacation",
            "description": "What kind of trip was it?"
          },
          {
            "id": "HOTELS_PILOT_TRAVEL_GROUP_TYPE",
            "name": "Travel group",
            "value": "Family",
            "description": "Who did you travel with?"
          },
          {
            "id": "HOTELS_ASPECT_ROOMS",
            "name": "Rooms",
            "value": 4,
            "description": "Rooms"
          },
          {
            "id": "HOTELS_ASPECT_SERVICES",
            "name": "Service",
            "value": 5,
            "description": "Service"
          },
          {
            "id": "HOTELS_ASPECT_LOCATION",
            "name": "Location",
            "value": 5,
            "description": "Location"
          },
          {
            "id": "HOTELS_TIPS_TOPICS_ROOMS",
            "name": "Rooms",
            "value": "Rooms were a little dated and lights were dim, but felt clean, comfortable beds, and quiet.",
            "description": "Rooms"
          },
          {
            "id": "HOTELS_TIPS_TOPICS_NEARBY_ACTIVITIES",
            "name": "Nearby activities",
            "value": "Great location and easy walk to Rockefeller Center, Bryant Park, Time Square, & Central Park",
            "description": "Nearby activities"
          },
          {
            "id": "HOTELS_TIPS_TOPICS_SAFETY",
            "name": "Safety",
            "value": "Always felt safe and secure",
            "description": "Safety"
          },
          {
            "id": "HOTELS_TIPS_TOPICS_WALKABILITY",
            "name": "Walkability",
            "value": "Very walkable for everything we wanted to do",
            "description": "Walkability"
          }
        ]
      },
      {
        "review_id": "Ci9DQUlRQUNvZENodHljRjlvT2tSbFJsWmxYME5KZEVsQ1lrZHZiRXd4Y21SdVptYxAB",
        "reviewer": {
          "profile_photo_url": "https://lh3.googleusercontent.com/a-/ALV-UjWR9P0hsugLdp9Oat4sxTahBKrA0gZ1C7uqw4MNisrIvLu3hy-V=s120-c-rp-mo-ba2-br100",
          "display_name": "Jennifer Wakefield",
          "link": "https://www.google.com/maps/contrib/114840974672973065687?hl=en"
        },
        "link": "https://www.google.com/maps/reviews/data=!4m8!14m7!1m6!2m5!1sCi9DQUlRQUNvZENodHljRjlvT2tSbFJsWmxYME5KZEVsQ1lrZHZiRXd4Y21SdVptYxAB!2m1!1s0x0:0x2a34371cb33f3c80!3m1!1s2@1:CAIQACodChtycF9oOkRlRlZlX0NJdElCYkdvbEwxcmRuZmc%7C0dI--RQ5bgo%7C?hl=en",
        "source": "Google",
        "source_logo": "https://www.gstatic.com/images/branding/product/1x/googleg_48dp.png",
        "rating": "1/5",
        "created": "Edited 2 months ago",
        "date": "2025-12-24",
        "comment": "The location is fabulous. Everything else is terrible. This hotel has severely gone downhill over the years. It is not a four star maybe a two star at best. The rooms were adequate. The bathroom was disgusting and had discolored water forcing us to brush our teeth with bottled water. The wait for the elevators was ridiculous and we ended up using the service elevators and that area was absolutely disgusting and did not feel safe.",
        "review_reply": "Dear Jennifer,\nThough we are glad you enjoyed our central location, we regret that other aspects of your visit fell below your expectations and the high standards we strive for. What you have described regarding our accommodations, amenities, and the comfort and convenience we aim to consistently provide our guests is not typical for us. Rest assured, your insights will be promptly addressed for review and correction. We hope to welcome you back in the future to change your lasting impressions. \n\nSincerely,\n\nNew York Hilton Midtown Team\n\nNYCNH_FO@hilton.com",
        "review_reply_created": "a month ago",
        "photos": [
          "https://lh3.googleusercontent.com/geougc-cs/ABOP9ptLCFihq0e2Rr2xf5cBpxANMMhfDf1JNipzZV2xKzKvd-Td8Qfo806H4UwgM0apfWvMJArehhlrJbvtpuZyVzbpeBnkVhyxekIHl5lw7aRAKEy5Qw6DMp1-Ra6BPNVObzRdWeu7N9tJKFQ",
          "https://lh3.googleusercontent.com/geougc-cs/ABOP9ptpkESmccJfCgtjbmg66XKUKhbCM_Z8uVSsZ9a1wSHiSeaTKmsqURZ5b_UTuXuVxraFCv-MEHjqkhz10E3BsL2XiV3iQlmNEzik1QUg2tHyJVUJYF3XePBNCursMNftK2ATijYCAE3XIGk",
          "https://lh3.googleusercontent.com/geougc-cs/ABOP9psDnhsuOCuRiEKmw2YqOiDUbqGeziogZ0aJj0PL8tIz4-PbpFotEiJa1hZ4reobYw54gMKgbmU-ahevtF4KefFBTpBtOs_6jB8OQBjZiQGtEXE69koipvhvJPHSG0ADdpnkNyYkf4FQxc0"
        ],
        "details": [
          {
            "id": "HOTELS_PILOT_TRIP_TYPE",
            "name": "Trip type",
            "value": "Vacation",
            "description": "What kind of trip was it?"
          },
          {
            "id": "HOTELS_PILOT_TRAVEL_GROUP_TYPE",
            "name": "Travel group",
            "value": "Family",
            "description": "Who did you travel with?"
          },
          {
            "id": "HOTELS_ASPECT_ROOMS",
            "name": "Rooms",
            "value": 1,
            "description": "Rooms"
          },
          {
            "id": "HOTELS_ASPECT_SERVICES",
            "name": "Service",
            "value": 1,
            "description": "Service"
          },
          {
            "id": "HOTELS_ASPECT_LOCATION",
            "name": "Location",
            "value": 5,
            "description": "Location"
          }
        ]
      },
      {
        "review_id": "Ci9DQUlRQUNvZENodHljRjlvT213M01Ib3daVTEwZFdrNFREZG1XbVEyV0ZCQkxYYxAB",
        "reviewer": {
          "profile_photo_url": "https://lh3.googleusercontent.com/a/ACg8ocJ2aeQdtiJkWeCyxq8wk3mwShLLZdvL3mNfhS0phcXWil15iw=s120-c-rp-mo-ba2-br100",
          "display_name": "Sarah Vertrees",
          "link": "https://www.google.com/maps/contrib/114286611919008365782?hl=en"
        },
        "link": "https://www.google.com/maps/reviews/data=!4m8!14m7!1m6!2m5!1sCi9DQUlRQUNvZENodHljRjlvT213M01Ib3daVTEwZFdrNFREZG1XbVEyV0ZCQkxYYxAB!2m1!1s0x0:0x2a34371cb33f3c80!3m1!1s2@1:CAIQACodChtycF9oOmw3MHowZU10dWk4TDdmWmQ2WFBBLXc%7C0dHofB_sbAT%7C?hl=en",
        "source": "Google",
        "source_logo": "https://www.gstatic.com/images/branding/product/1x/googleg_48dp.png",
        "rating": "1/5",
        "created": "2 months ago",
        "comment": "The only positive about this hotel is the location.\n\nWhen we arrived we were told that they were out of parking so we had to park ourselves in the parking garage across the street.\n\nWe paid over $600 a night for a room that was fair at best. It was very dated, screws missing out of the door handle, semi-clean, the bath tub wouldn’t drain-when I went to adjust the stopper it came out and the bath tub itself was pealing, the hotel staff were all less than pleasant!\n\nAs many others have mentioned the elevator stops a nightmare!",
        "review_reply": "emailed guest",
        "review_reply_created": "2 months ago",
        "details": [
          {
            "id": "HOTELS_PILOT_TRIP_TYPE",
            "name": "Trip type",
            "value": "Vacation",
            "description": "What kind of trip was it?"
          },
          {
            "id": "HOTELS_PILOT_TRAVEL_GROUP_TYPE",
            "name": "Travel group",
            "value": "Family",
            "description": "Who did you travel with?"
          },
          {
            "id": "HOTELS_ASPECT_ROOMS",
            "name": "Rooms",
            "value": 1,
            "description": "Rooms"
          },
          {
            "id": "HOTELS_ASPECT_SERVICES",
            "name": "Service",
            "value": 1,
            "description": "Service"
          },
          {
            "id": "HOTELS_ASPECT_LOCATION",
            "name": "Location",
            "value": 5,
            "description": "Location"
          },
          {
            "id": "HOTELS_VIBE",
            "name": "Hotel highlights",
            "value": "Kid-friendly",
            "description": "How would you describe the hotel?"
          }
        ]
      },
      {
        "review_id": "Ci9DQUlRQUNvZENodHljRjlvT21Wc2JWWjJhVlpuZVcxWmVrVllVMFZSYzNBd1JrRRAB",
        "reviewer": {
          "profile_photo_url": "https://lh3.googleusercontent.com/a-/ALV-UjXCL-8vEvUDz822rsEmwqB79dYFIjQbHiK1dnR4PV9_VvfzFXTB=s120-c-rp-mo-br100",
          "display_name": "Sandi Butler Hughes",
          "link": "https://www.google.com/maps/contrib/118216174767304514343?hl=en"
        },
        "link": "https://www.google.com/maps/reviews/data=!4m8!14m7!1m6!2m5!1sCi9DQUlRQUNvZENodHljRjlvT21Wc2JWWjJhVlpuZVcxWmVrVllVMFZSYzNBd1JrRRAB!2m1!1s0x0:0x2a34371cb33f3c80!3m1!1s2@1:CAIQACodChtycF9oOmVsbVZ2aVZneW1ZekVYU0VRc3AwRkE%7C0dDjnmf81ZY%7C?hl=en",
        "source": "Google",
        "source_logo": "https://www.gstatic.com/images/branding/product/1x/googleg_48dp.png",
        "rating": "5/5",
        "created": "2 months ago",
        "date": "2025-12-11",
        "comment": "We stayed here for the Macy’s Thanksgiving Day Parade. The elevators were crowded and the line could be long - but it was overall a great experience and I highly recommend staying here. Room service was fast and good. Staff was helpful. Great, central location!",
        "review_reply": "Dear Sandi,\nThank you for choosing us for your Thanksgiving parade stay and for sharing these thoughtful highlights! It is wonderful to hear that the central setting worked well, room service arrived quickly and hit the spot, and that our team provided helpful care throughout. We recognize that elevator demand can surge during major events, and we are committed to seeking ways to keep things moving more smoothly. It was a pleasure having you here, and we hope to welcome you back for another festive visit.\n\nSincerely,\n\nNew York Hilton Midtown Team\n\nNYCNH_FO@hilton.com",
        "review_reply_created": "2 months ago",
        "photos": [
          "https://lh3.googleusercontent.com/geougc-cs/ABOP9psih2_1OOcMpwE2s3oVDJsT3YU-z52F9_knHdLNoArRhctk8qSKNiZfebnmWcA4a2l9uILAIVTXWa0nJpv7vdFrXZVyVPyZgvz5gOjmU1QKE9wCuI64Fd8ojOo157ZUIP2EKx6tVOsVKikX"
        ],
        "details": [
          {
            "id": "HOTELS_PILOT_TRIP_TYPE",
            "name": "Trip type",
            "value": "Vacation",
            "description": "What kind of trip was it?"
          },
          {
            "id": "HOTELS_PILOT_TRAVEL_GROUP_TYPE",
            "name": "Travel group",
            "value": "Family",
            "description": "Who did you travel with?"
          },
          {
            "id": "HOTELS_ASPECT_ROOMS",
            "name": "Rooms",
            "value": 5,
            "description": "Rooms"
          },
          {
            "id": "HOTELS_ASPECT_SERVICES",
            "name": "Service",
            "value": 5,
            "description": "Service"
          },
          {
            "id": "HOTELS_ASPECT_LOCATION",
            "name": "Location",
            "value": 5,
            "description": "Location"
          },
          {
            "id": "HOTELS_VIBE",
            "name": "Hotel highlights",
            "value": "Great view",
            "description": "How would you describe the hotel?"
          }
        ]
      },
      {
        "review_id": "Ci9DQUlRQUNvZENodHljRjlvT2tGVU9XbEhha3RHZDFKNWFsRkVXbEJWTjJKVWVHYxAB",
        "reviewer": {
          "profile_photo_url": "https://lh3.googleusercontent.com/a-/ALV-UjUEYov0tioO-gi58kZLHwZ7jHvkGkquiLm9YYLfq7ZPZFhuYLpQ=s120-c-rp-mo-ba4-br100",
          "display_name": "Paula Januszkiewicz",
          "link": "https://www.google.com/maps/contrib/108960975385810447306?hl=en"
        },
        "link": "https://www.google.com/maps/reviews/data=!4m8!14m7!1m6!2m5!1sCi9DQUlRQUNvZENodHljRjlvT2tGVU9XbEhha3RHZDFKNWFsRkVXbEJWTjJKVWVHYxAB!2m1!1s0x0:0x2a34371cb33f3c80!3m1!1s2@1:CAIQACodChtycF9oOkFUOWlHaktGd1J5alFEWlBVN2JUeGc%7C0d2miwB-5in%7C?hl=en",
        "source": "Google",
        "source_logo": "https://www.gstatic.com/images/branding/product/1x/googleg_48dp.png",
        "rating": "5/5",
        "created": "3 months ago",
        "date": "2025-11-08",
        "comment": "The reliable favorite! With great, relatively peaceful location, which I appreciate.\n\nI’ve stayed here a few times already - it’s always such a good and reliable hotel. But this time you really surprised me with the yogurt selection: one with a taste of rose and the other matcha - omg, thank you! That little detail truly made my day. So delicious!",
        "review_reply": "Dear Paula,\nThank you for staying with us at New York Hilton Midtown. It means a lot that we’re your go-to when you are in the city. We also love that the new yogurt flavors were a hit, and our team will be so happy that the little touch stood out to you. We appreciate your loyalty and look forward to welcoming you back.\n\nSincerely,\n\nNew York Hilton Midtown Team\n\nNYCNH_FO@hilton.com",
        "review_reply_created": "3 months ago",
        "photos": [
          "https://lh3.googleusercontent.com/geougc-cs/ABOP9psjBORXqPHXaA8lWVYVBmJZG9vNFgZadE2xV7IIBNmMrZYD-cGjNPlD5g8QZfocFZHbG0vrwkPt_mwVMQJqew7JhEdJycvA7kxGjvVCOIoJQjhFVXrOTTLWJcswEKDpSp550TagX22ZUSIP"
        ],
        "details": [
          {
            "id": "HOTELS_PILOT_TRIP_TYPE",
            "name": "Trip type",
            "value": "Business",
            "description": "What kind of trip was it?"
          },
          {
            "id": "HOTELS_ASPECT_ROOMS",
            "name": "Rooms",
            "value": 5,
            "description": "Rooms"
          },
          {
            "id": "HOTELS_ASPECT_SERVICES",
            "name": "Service",
            "value": 5,
            "description": "Service"
          },
          {
            "id": "HOTELS_ASPECT_LOCATION",
            "name": "Location",
            "value": 5,
            "description": "Location"
          },
          {
            "id": "HOTELS_VIBE",
            "name": "Hotel highlights",
            "value": "Luxury",
            "description": "How would you describe the hotel?"
          }
        ]
      },
      {
        "review_id": "ChdDSUhNMG9nS0VQdnIyOHU1LVppVGlBRRAB",
        "reviewer": {
          "profile_photo_url": "https://lh3.googleusercontent.com/local-reviews/AJMZ0QfnSFWXMd1oJu73a6IhdtgibYcjse2HKQTHeghNQd9Cyw8DYQQJZDCyh-TD68ehXuY-FA=s120-c-br100",
          "display_name": "R471LZalext",
          "link": "https://www.tripadvisor.com/ShowUserReviews-g60763-d1379306-r1043196288?m=68573&staydates=2026_03_08_2026_03_09&uguests=1_2_0&supdv=desktop&supuc=KZ&supul=en"
        },
        "link": "https://www.tripadvisor.com/ShowUserReviews-g60763-d1379306-r1043196288?m=68573&staydates=2026_03_08_2026_03_09&uguests=1_2_0&supdv=desktop&supuc=KZ&supul=en",
        "source": "Tripadvisor",
        "source_logo": "https://www.gstatic.com/travel-hotels/branding/icon_100532569.png",
        "rating": "3/5",
        "created": "2 months ago",
        "comment": "Room was ok. For a Hilton I thought it would be better. Could do with an update with better placed plug sockets and some USB sockets. It is 2025 and people need multiple sockets to charge phones, tablets, watches etc.||Staff were underwhelming. Our flight home was cancelled and we had to find accommodation for another night. I understand they couldn’t accept us as they were fully booked. I would have appreciated some sort of effort to see if other Hilton hotels available but no, just a shrug of the shoulders pretty much and left to sort ourselves out. I understand that it is probably over there pay grade. However, a phone call or some sort of contact with other Hilton hotels would have been put our anxiety at ease. I am disappointed because i expect staff from the Hilton brand would excel at customer service, but they didn’t. They would’ve earned a decent tip from it. ||Only 2 things impressed me. The coffee machine in our room and the cleaning staff. They always did a superb job."
      },
      {
        "review_id": "Ci9DQUlRQUNvZENodHljRjlvT25oNFUwVnVkRTB3Y1ZGM2JreHFSVEZXU0hOdFNXYxAB",
        "reviewer": {
          "profile_photo_url": "https://lh3.googleusercontent.com/a-/ALV-UjUfusV7ZUjUCOLqMSt3fppZPTMYkLGZT4DP2M1Af_cL-58ns8WggA=s120-c-rp-mo-br100",
          "display_name": "Alison McGuckin",
          "link": "https://www.google.com/maps/contrib/117751954034681560040?hl=en"
        },
        "link": "https://www.google.com/maps/reviews/data=!4m8!14m7!1m6!2m5!1sCi9DQUlRQUNvZENodHljRjlvT25oNFUwVnVkRTB3Y1ZGM2JreHFSVEZXU0hOdFNXYxAB!2m1!1s0x0:0x2a34371cb33f3c80!3m1!1s2@1:CAIQACodChtycF9oOnh4U0VudE0wcVF3bkxqRTFWSHNtSWc%7C0dC2Wfaja3C%7C?hl=en",
        "source": "Google",
        "source_logo": "https://www.gstatic.com/images/branding/product/1x/googleg_48dp.png",
        "rating": "1/5",
        "created": "2 months ago",
        "comment": "Everything about this hotel would be great if it weren’t for the horrid elevator situation. It took 30 minutes for us to get 4 people downstairs from floor 38. We had to separate as a group to put one person into an elevator every time it showed up and actually had room. While in the jam packed elevator you would stop at every single floor, only for most of them to not even have anyone getting off there or waiting. We used to love this hotel, now we’ll be looking for a different midtown stay.",
        "review_reply": "Good morning, Alison, \nThank you for providing details of your experience with us. I would love to connect with you and make things right. We are currently unable to locate a reservation in your name. Can you kindly send your reservation details to Hannah.Zipkin@hilton.com? I look forward to hearing from you.",
        "review_reply_created": "2 months ago",
        "details": [
          {
            "id": "HOTELS_PILOT_TRIP_TYPE",
            "name": "Trip type",
            "value": "Vacation",
            "description": "What kind of trip was it?"
          },
          {
            "id": "HOTELS_PILOT_TRAVEL_GROUP_TYPE",
            "name": "Travel group",
            "value": "Family",
            "description": "Who did you travel with?"
          },
          {
            "id": "HOTELS_ASPECT_ROOMS",
            "name": "Rooms",
            "value": 4,
            "description": "Rooms"
          },
          {
            "id": "HOTELS_ASPECT_SERVICES",
            "name": "Service",
            "value": 4,
            "description": "Service"
          },
          {
            "id": "HOTELS_ASPECT_LOCATION",
            "name": "Location",
            "value": 4,
            "description": "Location"
          }
        ]
      },
      {
        "review_id": "Ci9DQUlRQUNvZENodHljRjlvT205WFNsaDVRWFJUWjBsd1Yxb3pNbmhEUkdnM2EwRRAB",
        "reviewer": {
          "profile_photo_url": "https://lh3.googleusercontent.com/a/ACg8ocK7OOVJIAqO_bUXJsXNClGhPiS_codAAJ_4jbQhjngD2I5VQA=s120-c-rp-mo-ba3-br100",
          "display_name": "L File",
          "link": "https://www.google.com/maps/contrib/112336634363254268566?hl=en"
        },
        "link": "https://www.google.com/maps/reviews/data=!4m8!14m7!1m6!2m5!1sCi9DQUlRQUNvZENodHljRjlvT205WFNsaDVRWFJUWjBsd1Yxb3pNbmhEUkdnM2EwRRAB!2m1!1s0x0:0x2a34371cb33f3c80!3m1!1s2@1:CAIQACodChtycF9oOm9XSlh5QXRTZ0lwV1ozMnhDRGg3a0E%7C0dCjYvbWq6w%7C?hl=en",
        "source": "Google",
        "source_logo": "https://www.gstatic.com/images/branding/product/1x/googleg_48dp.png",
        "rating": "4/5",
        "created": "2 months ago",
        "comment": "Awesome location, rooms were clean and comfortable.  Bar drinks are just ok, food is meh.  But I didn’t go to NYC to eat/drinkk in my hotel.  Its location is perfect.  We walked about 5 miles a day to see what we wanted and to go where we wanted.  Subway was easy to use.  The elevators are nice, but they do need more.  Construction on one, but there is almost always a line to go up and getting down is awful.  Give yourself plenty of time and the higher the room, the easier to get “on”.  Oftentimes people had been waiting multiple stops for the elevator to get down to the lobby, if on lower floors, but it would be full.  That was the only pitfall, but could be a significant one if you are in a hurry.",
        "review_reply": "Thank you for sharing your experience with us. We are glad to hear you enjoyed the clean and comfortable rooms, as well as our convenient location, which made it easy to explore the city on foot and by subway. We appreciate your comments regarding food, beverages, and elevator availability, and we will be reviewing these concerns with our team to help improve the overall guest experience. We appreciate you staying with us and hope to have the chance to host you again.\n\nSincerely,\n\nNew York Hilton Midtown Team\n\nNYCNH_FO@hilton.com",
        "review_reply_created": "2 months ago",
        "details": [
          {
            "id": "HOTELS_PILOT_TRIP_TYPE",
            "name": "Trip type",
            "value": "Vacation",
            "description": "What kind of trip was it?"
          },
          {
            "id": "HOTELS_PILOT_TRAVEL_GROUP_TYPE",
            "name": "Travel group",
            "value": "Family",
            "description": "Who did you travel with?"
          },
          {
            "id": "HOTELS_ASPECT_ROOMS",
            "name": "Rooms",
            "value": 5,
            "description": "Rooms"
          },
          {
            "id": "HOTELS_ASPECT_SERVICES",
            "name": "Service",
            "value": 4,
            "description": "Service"
          },
          {
            "id": "HOTELS_ASPECT_LOCATION",
            "name": "Location",
            "value": 5,
            "description": "Location"
          }
        ]
      }
    ]
  }
  ```
</ResponseExample>


# Sort (highest)
Source: https://docs.brightdata.com/api-reference/serp/google-reviews/sort-highest

Configure the Bright Data Google Reviews Sort (Highest) parameter to refine queries and return matching results as JSON or HTML. On port 44445.

```txt wrap theme={null}
https://www.google.com/reviews?fid=0x89c25855c0679529:0x2a34371cb33f3c80&sort=ratingHigh
```

## Parameters

<ParamField type="string">
  Feature id what you want to fetch reviews to. `fid` parameter can be found in `knowledge.fid` field of google search response.
</ParamField>

<ParamField type="string">
  The way reviews are sorted.

  | value               | description                     |
  | ------------------- | ------------------------------- |
  | `sort=qualityScore` | most relevant first (`default`) |
  | `sort=newestFirst`  | newest first                    |
  | `sort=ratingHigh`   | highest rating first            |
  | `sort=ratingLow`    | lowest rating first             |

  ```txt wrap theme={null}
  https://www.google.com/reviews?fid=0x89c25855c0679529:0x2a34371cb33f3c80&sort=ratingHigh
  ```
</ParamField>

<RequestExample>
  ```shell cURL highlight={6} theme={null}
    curl -X POST https://api.brightdata.com/request \
    --header "Content-Type: application/json" \
    --header "Authorization: Bearer API_KEY" \
    --data '{
      "zone": "serp_api1",
      "url": "https://www.google.com/reviews?fid=0x89c25855c0679529:0x2a34371cb33f3c80&sort=ratingHigh",
      "format": "raw"
    }'
  ```

  ```shell Native proxy highlight={4} theme={null}
  curl --proxy brd.superproxy.io:44445 \
    --proxy-user CUSTOMER_USERNAME:CUSTOMER_PASSWORD \
    --ssl-no-revoke \
    "https://www.google.com/reviews?fid=0x89c25855c0679529:0x2a34371cb33f3c80&sort=ratingHigh"
  ```

  ```js Node.js highlight={10} theme={null}
  (async () => {
    const response = await fetch('https://api.brightdata.com/request', {
      method: 'POST',
      headers: {
        'Content-Type': 'application/json',
        'Authorization': 'Bearer API_KEY'
      },
      body: JSON.stringify({
        zone: 'serp_api1',
        url: 'https://www.google.com/reviews?fid=0x89c25855c0679529:0x2a34371cb33f3c80&sort=ratingHigh',
        format: 'raw'
      })
    });
    
    const data = await response.text();
    console.log(data);
  })();
  ```

  ```python Python highlight={11} theme={null}
  import requests

  # API Configuration
  headers = {
      'Content-Type': 'application/json',
      'Authorization': 'Bearer API_KEY',
  }

  payload = {
      'zone': 'serp_api1',
      'url': 'https://www.google.com/reviews?fid=0x89c25855c0679529:0x2a34371cb33f3c80&sort=ratingHigh',
      'format': 'raw'
  }

  # Make the request
  response = requests.post(
      'https://api.brightdata.com/request', 
      json=payload, 
      headers=headers
  )

  print(response.text)
  ```
</RequestExample>

<ResponseExample>
  ```json 200 theme={null}
  {
    "reviews": [
      {
        "review_id": "ChdDSUhNMG9nS0VKeTJ0di1zNGFpLXF3RRAB",
        "reviewer": {
          "profile_photo_url": "https://lh3.googleusercontent.com/local-reviews/AJMZ0Qczn4VDfUM6-AtEt-6oaNazFa-i9Fy6kqPVfGIlPil6vJulEYyK8t930jZwOW4hD80mzw=s120-c-br100",
          "display_name": "DLSharpsteen",
          "link": "https://www.tripadvisor.com/ShowUserReviews-g60763-d611947-r1045281816?m=68573&staydates=2026_03_08_2026_03_09&uguests=1_2_0&supdv=desktop&supuc=MU&supul=en"
        },
        "link": "https://www.tripadvisor.com/ShowUserReviews-g60763-d611947-r1045281816?m=68573&staydates=2026_03_08_2026_03_09&uguests=1_2_0&supdv=desktop&supuc=MU&supul=en",
        "source": "Tripadvisor",
        "source_logo": "https://www.gstatic.com/travel-hotels/branding/icon_100532569.png",
        "rating": "5/5",
        "created": "a month ago",
        "comment": "We traveled to NYC to watch The Christmas Spectacular at the Radio City Music Hall and stayed at the Hilton for the night. We loved the location as it was within of 5 minute walking distance of literally everything there is to see at Christmas time. Our room was quite spacious and clean with two full beds and a nice view. Staff was friendly and I loved that you can get there early and check in your bags so you can go explore before check in time as we arrived to the city around noon. Also loved that there was parking on site. We used the valet so you pulled in, got everything out you would need, they give you a card with a number and you walk into the doors and right to the luggage storage area. The elevator system is insane and that's my only complaint. I've never stayed in a hotel where you have to put in your room number and can only ride a certain elevator to your room. Seemed our elevators were always the ones with tons of people waiting to get on or off. The only outside noise you could hear were horns, but I was ok with that and thankful I never heard my neighbors or anyone in the halls. I got an insane discount on my room through my employer otherwise I would never be able to stay here during Christmastime. But I understand why the rate is so high as it is a hotel that sits in the middle of all the amazing attractions NYC has to offer. Would definitely stay here again!"
      },
      {
        "review_id": "Ci9DQUlRQUNvZENodHljRjlvT2t0eVMzWjJjbk5tUWt0TGFFcG5kVU5XWTFvMGQwRRAB",
        "reviewer": {
          "profile_photo_url": "https://lh3.googleusercontent.com/a/ACg8ocIb_1I5stFL2E46ANU5a9D1tE37bd7z3TrcvcjeCv8jbP01sQ=s120-c-rp-mo-ba4-br100",
          "display_name": "Diana Nichols",
          "link": "https://www.google.com/maps/contrib/104268723670363283044?hl=en"
        },
        "link": "https://www.google.com/maps/reviews/data=!4m8!14m7!1m6!2m5!1sCi9DQUlRQUNvZENodHljRjlvT2t0eVMzWjJjbk5tUWt0TGFFcG5kVU5XWTFvMGQwRRAB!2m1!1s0x0:0x2a34371cb33f3c80!3m1!1s2@1:CAIQACodChtycF9oOktyS3Z2cnNmQktLaEpndUNWY1o0d0E%7C0dKeRXjPbb4%7C?hl=en",
        "source": "Google",
        "source_logo": "https://www.gstatic.com/images/branding/product/1x/googleg_48dp.png",
        "rating": "5/5",
        "created": "a month ago",
        "comment": "Absolutely the best stay in the world! My room was clean and quiet and had everything I needed. The room was much bigger than I expected for NYC. Shout out to housekeeping who didn’t make a peep in the hallways as they cleaned the vacant rooms. I didn’t leave until around 2pm so they were working hard. Many hotels (even the best of the best) have housekeepers who talk too loudly in the hallways and constantly slam doors. Not here! They were perfect and I didn’t even know they were there until I left. Can’t tell you how much I appreciate that. Tons of security and police presence for the upcoming celebration (New Year’s) or maybe it’s always like that here. Felt extremely safe and protected. Beautiful spacious clean sparkling lobby. Many upscale shops and stores I didn’t have time to visit. Glistening with inviting items to purchase and view. Wish I would have gone into the shops! The staff was very very friendly from the front desk to the security guard who answered all my questions last night about transportation to JFK and local things to visit near the hotel. The man mopping the floor was super friendly (this was around 1am) trying to give me directions for the subway train etc for the next day to JFK. I had the best latte from the wonderful friendly cafe near the lobby. Everything clean and welcoming and beautifully displayed. I decided to take a taxi to JFK\nand asked for a “nice” taxi driver. The gentleman supervising the taxi line immediately made way for me through the throngs of folks on the street and treated me like a celebrity as he directed me to the next available ride. He didn’t laugh at me and I did get the nicest taxi driver - Fabian!!!  I was given excellent directions to get to the airport in JFK by the transportation and show tickets desk and they explained how to take the train bus subway etc but it seemed a little more difficult than I was in the mood for. The energy out on the street was electric and I also wish I had walked around a little before I left the city. This hotel is convenient to everything! Can’t ask for anything more than the wonderful experience I had at this hotel. Thank you everyone who works there and outside and Happy New Year!!!",
        "review_reply": "Dear Diana,\nIt's an absolute pleasure to learn about the exceptional visit you had with us, and we thank you for your perfect marks. Thank you for also going out of your way to spotlight our safe, welcoming facilities and unbeatable New York location. Of course, we'll be sure our team hears they really made a difference with their outstanding service, and we look forward to seeing you again soon here at New York Hilton Midtown for another unforgettable experience.\n\nSincerely,\n\nNew York Hilton Midtown Team\n\nNYCNH_FO@hilton.com",
        "review_reply_created": "a month ago",
        "details": [
          {
            "id": "HOTELS_PILOT_TRIP_TYPE",
            "name": "Trip type",
            "value": "Business",
            "description": "What kind of trip was it?"
          },
          {
            "id": "HOTELS_PILOT_TRAVEL_GROUP_TYPE",
            "name": "Travel group",
            "value": "Solo",
            "description": "Who did you travel with?"
          },
          {
            "id": "HOTELS_ASPECT_ROOMS",
            "name": "Rooms",
            "value": 5,
            "description": "Rooms"
          },
          {
            "id": "HOTELS_ASPECT_SERVICES",
            "name": "Service",
            "value": 5,
            "description": "Service"
          },
          {
            "id": "HOTELS_ASPECT_LOCATION",
            "name": "Location",
            "value": 5,
            "description": "Location"
          },
          {
            "id": "HOTELS_TIPS_TOPICS_ROOMS",
            "name": "Rooms",
            "value": "My room was perfect and bigger than I expected for NYC.",
            "description": "Rooms"
          },
          {
            "id": "HOTELS_TIPS_TOPICS_SAFETY",
            "name": "Safety",
            "value": "Lots of police officers around! Felt extremely safe.",
            "description": "Safety"
          },
          {
            "id": "HOTELS_TIPS_TOPICS_NOTEWORTHY_DETAILS",
            "name": "Noteworthy details",
            "value": "I just found everyone super friendly. Maybe because I love the people and the energy in NYC anyway.",
            "description": "Noteworthy details"
          },
          {
            "id": "HOTELS_VIBE",
            "name": "Hotel highlights",
            "value": "Luxury",
            "description": "How would you describe the hotel?"
          }
        ]
      },
      {
        "review_id": "Ci9DQUlRQUNvZENodHljRjlvT25ReVRFUTJiV0ZNUkdVNFduaFNTMnh6VmpGSU5uYxAB",
        "reviewer": {
          "profile_photo_url": "https://lh3.googleusercontent.com/a-/ALV-UjXmcoJ3y3xhQX30wsKy5q87OD7qFUR6FDUsw_QDL8EWl8-nUSQ=s120-c-rp-mo-ba3-br100",
          "display_name": "Natiesha Wray Henry",
          "link": "https://www.google.com/maps/contrib/102270227746850983681?hl=en"
        },
        "link": "https://www.google.com/maps/reviews/data=!4m8!14m7!1m6!2m5!1sCi9DQUlRQUNvZENodHljRjlvT25ReVRFUTJiV0ZNUkdVNFduaFNTMnh6VmpGSU5uYxAB!2m1!1s0x0:0x2a34371cb33f3c80!3m1!1s2@1:CAIQACodChtycF9oOnQyTEQ2bWFMRGU4WnhSS2xzVjFINnc%7C0dKxrV3ZLWB%7C?hl=en",
        "source": "Google",
        "source_logo": "https://www.gstatic.com/images/branding/product/1x/googleg_48dp.png",
        "rating": "5/5",
        "created": "a month ago",
        "comment": "Location, Location,  Location! This hotel made adventuring in Manhattan a breeze. Central Park, Radio City, Rockefeller Center, were all so close, there was simply no excuse to not take a walk and be in all the action. We loved to food trucks and vendors near by but we also enjoyed the walkable restaurants close by as well. Staff and facilities were great. I'm so happy we stayed here.",
        "review_reply": "Dear Natiesha,\nThank you for sharing your wonderful experience with us! It's great that our prime location, close to New York's best attractions and dining options, enhanced your visit. We're also happy that our friendly service added to your experience. It was a pleasure having you as our guest, and we look forward to welcoming you back for another memorable stay.\n\nSincerely,\n\nNew York Hilton Midtown Team\n\nNYCNH_FO@hilton.com",
        "review_reply_created": "a month ago",
        "details": [
          {
            "id": "HOTELS_PILOT_TRIP_TYPE",
            "name": "Trip type",
            "value": "Vacation",
            "description": "What kind of trip was it?"
          },
          {
            "id": "HOTELS_PILOT_TRAVEL_GROUP_TYPE",
            "name": "Travel group",
            "value": "Family",
            "description": "Who did you travel with?"
          },
          {
            "id": "HOTELS_ASPECT_ROOMS",
            "name": "Rooms",
            "value": 5,
            "description": "Rooms"
          },
          {
            "id": "HOTELS_ASPECT_SERVICES",
            "name": "Service",
            "value": 5,
            "description": "Service"
          },
          {
            "id": "HOTELS_ASPECT_LOCATION",
            "name": "Location",
            "value": 5,
            "description": "Location"
          },
          {
            "id": "HOTELS_TIPS_TOPICS_ROOMS",
            "name": "Rooms",
            "value": "Cozy and comfortable",
            "description": "Rooms"
          },
          {
            "id": "HOTELS_TIPS_TOPICS_NEARBY_ACTIVITIES",
            "name": "Nearby activities",
            "value": "Times Square is walkable from here",
            "description": "Nearby activities"
          },
          {
            "id": "HOTELS_TIPS_TOPICS_WALKABILITY",
            "name": "Walkability",
            "value": "10 out of 10",
            "description": "Walkability"
          },
          {
            "id": "HOTELS_TIPS_TOPICS_NOTEWORTHY_DETAILS",
            "name": "Noteworthy details",
            "value": "Parking and traffic is a nightmare.",
            "description": "Noteworthy details"
          },
          {
            "id": "HOTELS_VIBE",
            "name": "Hotel highlights",
            "value": "Kid-friendly",
            "description": "How would you describe the hotel?"
          }
        ]
      },
      {
        "review_id": "Ci9DQUlRQUNvZENodHljRjlvT2xWbGRIaHFUblkzZFdaaFdITlNRMlZNZDE5bmNHYxAB",
        "reviewer": {
          "profile_photo_url": "https://lh3.googleusercontent.com/a-/ALV-UjUizL79_bwGWMDpI7JDM4zojb6e6Ufpryfw23XnFxFSFJMHriK_=s120-c-rp-mo-ba3-br100",
          "display_name": "Amanda Garcia",
          "link": "https://www.google.com/maps/contrib/102898602342998029792?hl=en"
        },
        "link": "https://www.google.com/maps/reviews/data=!4m8!14m7!1m6!2m5!1sCi9DQUlRQUNvZENodHljRjlvT2xWbGRIaHFUblkzZFdaaFdITlNRMlZNZDE5bmNHYxAB!2m1!1s0x0:0x2a34371cb33f3c80!3m1!1s2@1:CAIQACodChtycF9oOlVldHhqTnY3dWZhWHNSQ2VMd19ncGc%7C0dGM04hI_ys%7C?hl=en",
        "source": "Google",
        "source_logo": "https://www.gstatic.com/images/branding/product/1x/googleg_48dp.png",
        "rating": "5/5",
        "created": "2 months ago",
        "comment": "From the moment we arrived, our experience at this hotel was nothing short of exceptional. The property is beautiful, impeccably clean, and thoughtfully designed for comfort and relaxation. Every detail reflected true five-star quality.\nWhat truly made our stay unforgettable was the incredible staff. The team went above and beyond to make us feel welcomed and valued. Special recognition to Lek at concierge, Christina in housekeeping, Brian and Joland at front desk for their professionalism, warmth, and genuine care. Their attentiveness and willingness to assist with every request during our stay as we celebrate a birthday made a lasting impression.\nHousekeeping was flawless, the amenities were excellent, and the overall atmosphere was both luxurious and inviting. This hotel sets the standard for hospitality, and we cannot wait to return.\nHighly recommend to anyone looking for an outstanding stay! Location a huge plus.",
        "review_reply": "Dear Amanda,\nIt's an absolute pleasure to read about the exceptional celebration experience you had with us here at New York Hilton Midtown. Thank you for going out of your way to write about our gorgeous property, where comfort and charm come together perfectly, and we're delighted our team was able to make your experience that much more memorable. We'll be sure your thoughtful compliments are shared with them, and we hope to have the opportunity to welcome you back soon, whether for another special occasion or simply a relaxing New York getaway.\n\nSincerely,\n\nNew York Hilton Midtown Team\n\nNYCNH_FO@hilton.com",
        "review_reply_created": "2 months ago",
        "details": [
          {
            "id": "HOTELS_ASPECT_ROOMS",
            "name": "Rooms",
            "value": 5,
            "description": "Rooms"
          },
          {
            "id": "HOTELS_ASPECT_SERVICES",
            "name": "Service",
            "value": 5,
            "description": "Service"
          },
          {
            "id": "HOTELS_ASPECT_LOCATION",
            "name": "Location",
            "value": 5,
            "description": "Location"
          }
        ]
      },
      {
        "review_id": "Ci9DQUlRQUNvZENodHljRjlvT2tObGJucGZObk5zTW01M1IzQXhkazgwUkZoclYzYxAB",
        "reviewer": {
          "profile_photo_url": "https://lh3.googleusercontent.com/a/ACg8ocJQgX50KQ8oURrMb8SgiRyqOysMS1rNXBa0wHN1BoF7o8ORvQ=s120-c-rp-mo-br100",
          "display_name": "Olaoluwa Ajilore",
          "link": "https://www.google.com/maps/contrib/115992020596208851571?hl=en"
        },
        "link": "https://www.google.com/maps/reviews/data=!4m8!14m7!1m6!2m5!1sCi9DQUlRQUNvZENodHljRjlvT2tObGJucGZObk5zTW01M1IzQXhkazgwUkZoclYzYxAB!2m1!1s0x0:0x2a34371cb33f3c80!3m1!1s2@1:CAIQACodChtycF9oOkNlbnpfNnNsMm53R3Axdk80RFhrV3c%7C0d3TryOnoQy%7C?hl=en",
        "source": "Google",
        "source_logo": "https://www.gstatic.com/images/branding/product/1x/googleg_48dp.png",
        "rating": "5/5",
        "created": "3 months ago",
        "comment": "I rarely write reviews, but I felt compelled to share my experience—especially because of the outstanding room service I’ve received. I’m currently staying here, and everything has been fantastic so far. What truly sets this place apart is the incredible housekeeping team on the 34th floor.\n\nThey are, without a doubt, the most attentive and genuinely kind crew I’ve encountered in any hotel across the country. Always cheerful, always ready to help—even when I’ve had the “Do Not Disturb” sign up, they’ve gone out of their way to check in if they see me in the hallway, just to make sure I don’t need anything. That level of care and consistency is rare, and it deserves to be celebrated.\n\nThey’re simply the best.",
        "review_reply": "Dear Olaoluwa,\nThank you for taking the time to share this, especially since you mentioned you rarely write reviews. It means even more to know you felt moved to speak about your stay while you’re still here with us. We're truly thrilled to hear how well everything has been going, and your kind words about our housekeeping team on the 34th floor mean the world. They take such pride in caring for our guests with thoughtfulness and genuine warmth, and it’s wonderful to know that their efforts have made such an impression. We'll be sure to share your message with them. I know it will brighten their day and remind them just how meaningful their care is. Thank you again for recognizing their hard work and spirit. We’re grateful to have you with us here at New York Hilton Midtown and are here for anything you may need for the rest of your visit. We hope the rest of your time with us continues to feel relaxing, comfortable, and well cared for!\n\nSincerely,\n\nNew York Hilton Midtown Team\n\nNYCNH_GM@hilton.com",
        "review_reply_created": "3 months ago",
        "details": [
          {
            "id": "HOTELS_ASPECT_ROOMS",
            "name": "Rooms",
            "value": 5,
            "description": "Rooms"
          },
          {
            "id": "HOTELS_ASPECT_SERVICES",
            "name": "Service",
            "value": 5,
            "description": "Service"
          },
          {
            "id": "HOTELS_ASPECT_LOCATION",
            "name": "Location",
            "value": 5,
            "description": "Location"
          },
          {
            "id": "HOTELS_TIPS_TOPICS_ROOMS",
            "name": "Rooms",
            "value": "perfect, nice view, great ambiance",
            "description": "Rooms"
          },
          {
            "id": "HOTELS_TIPS_TOPICS_NEARBY_ACTIVITIES",
            "name": "Nearby activities",
            "value": "Alot of activities",
            "description": "Nearby activities"
          }
        ]
      },
      {
        "review_id": "Ci9DQUlRQUNvZENodHljRjlvT21Wc2JWWjJhVlpuZVcxWmVrVllVMFZSYzNBd1JrRRAB",
        "reviewer": {
          "profile_photo_url": "https://lh3.googleusercontent.com/a-/ALV-UjXCL-8vEvUDz822rsEmwqB79dYFIjQbHiK1dnR4PV9_VvfzFXTB=s120-c-rp-mo-br100",
          "display_name": "Sandi Butler Hughes",
          "link": "https://www.google.com/maps/contrib/118216174767304514343?hl=en"
        },
        "link": "https://www.google.com/maps/reviews/data=!4m8!14m7!1m6!2m5!1sCi9DQUlRQUNvZENodHljRjlvT21Wc2JWWjJhVlpuZVcxWmVrVllVMFZSYzNBd1JrRRAB!2m1!1s0x0:0x2a34371cb33f3c80!3m1!1s2@1:CAIQACodChtycF9oOmVsbVZ2aVZneW1ZekVYU0VRc3AwRkE%7C0dDjnmf81ZY%7C?hl=en",
        "source": "Google",
        "source_logo": "https://www.gstatic.com/images/branding/product/1x/googleg_48dp.png",
        "rating": "5/5",
        "created": "2 months ago",
        "date": "2025-12-11",
        "comment": "We stayed here for the Macy’s Thanksgiving Day Parade. The elevators were crowded and the line could be long - but it was overall a great experience and I highly recommend staying here. Room service was fast and good. Staff was helpful. Great, central location!",
        "review_reply": "Dear Sandi,\nThank you for choosing us for your Thanksgiving parade stay and for sharing these thoughtful highlights! It is wonderful to hear that the central setting worked well, room service arrived quickly and hit the spot, and that our team provided helpful care throughout. We recognize that elevator demand can surge during major events, and we are committed to seeking ways to keep things moving more smoothly. It was a pleasure having you here, and we hope to welcome you back for another festive visit.\n\nSincerely,\n\nNew York Hilton Midtown Team\n\nNYCNH_FO@hilton.com",
        "review_reply_created": "2 months ago",
        "photos": [
          "https://lh3.googleusercontent.com/geougc-cs/ABOP9psih2_1OOcMpwE2s3oVDJsT3YU-z52F9_knHdLNoArRhctk8qSKNiZfebnmWcA4a2l9uILAIVTXWa0nJpv7vdFrXZVyVPyZgvz5gOjmU1QKE9wCuI64Fd8ojOo157ZUIP2EKx6tVOsVKikX"
        ],
        "details": [
          {
            "id": "HOTELS_PILOT_TRIP_TYPE",
            "name": "Trip type",
            "value": "Vacation",
            "description": "What kind of trip was it?"
          },
          {
            "id": "HOTELS_PILOT_TRAVEL_GROUP_TYPE",
            "name": "Travel group",
            "value": "Family",
            "description": "Who did you travel with?"
          },
          {
            "id": "HOTELS_ASPECT_ROOMS",
            "name": "Rooms",
            "value": 5,
            "description": "Rooms"
          },
          {
            "id": "HOTELS_ASPECT_SERVICES",
            "name": "Service",
            "value": 5,
            "description": "Service"
          },
          {
            "id": "HOTELS_ASPECT_LOCATION",
            "name": "Location",
            "value": 5,
            "description": "Location"
          },
          {
            "id": "HOTELS_VIBE",
            "name": "Hotel highlights",
            "value": "Great view",
            "description": "How would you describe the hotel?"
          }
        ]
      },
      {
        "review_id": "Ci9DQUlRQUNvZENodHljRjlvT2tGVU9XbEhha3RHZDFKNWFsRkVXbEJWTjJKVWVHYxAB",
        "reviewer": {
          "profile_photo_url": "https://lh3.googleusercontent.com/a-/ALV-UjUEYov0tioO-gi58kZLHwZ7jHvkGkquiLm9YYLfq7ZPZFhuYLpQ=s120-c-rp-mo-ba4-br100",
          "display_name": "Paula Januszkiewicz",
          "link": "https://www.google.com/maps/contrib/108960975385810447306?hl=en"
        },
        "link": "https://www.google.com/maps/reviews/data=!4m8!14m7!1m6!2m5!1sCi9DQUlRQUNvZENodHljRjlvT2tGVU9XbEhha3RHZDFKNWFsRkVXbEJWTjJKVWVHYxAB!2m1!1s0x0:0x2a34371cb33f3c80!3m1!1s2@1:CAIQACodChtycF9oOkFUOWlHaktGd1J5alFEWlBVN2JUeGc%7C0d2miwB-5in%7C?hl=en",
        "source": "Google",
        "source_logo": "https://www.gstatic.com/images/branding/product/1x/googleg_48dp.png",
        "rating": "5/5",
        "created": "3 months ago",
        "date": "2025-11-08",
        "comment": "The reliable favorite! With great, relatively peaceful location, which I appreciate.\n\nI’ve stayed here a few times already - it’s always such a good and reliable hotel. But this time you really surprised me with the yogurt selection: one with a taste of rose and the other matcha - omg, thank you! That little detail truly made my day. So delicious!",
        "review_reply": "Dear Paula,\nThank you for staying with us at New York Hilton Midtown. It means a lot that we’re your go-to when you are in the city. We also love that the new yogurt flavors were a hit, and our team will be so happy that the little touch stood out to you. We appreciate your loyalty and look forward to welcoming you back.\n\nSincerely,\n\nNew York Hilton Midtown Team\n\nNYCNH_FO@hilton.com",
        "review_reply_created": "3 months ago",
        "photos": [
          "https://lh3.googleusercontent.com/geougc-cs/ABOP9psjBORXqPHXaA8lWVYVBmJZG9vNFgZadE2xV7IIBNmMrZYD-cGjNPlD5g8QZfocFZHbG0vrwkPt_mwVMQJqew7JhEdJycvA7kxGjvVCOIoJQjhFVXrOTTLWJcswEKDpSp550TagX22ZUSIP"
        ],
        "details": [
          {
            "id": "HOTELS_PILOT_TRIP_TYPE",
            "name": "Trip type",
            "value": "Business",
            "description": "What kind of trip was it?"
          },
          {
            "id": "HOTELS_ASPECT_ROOMS",
            "name": "Rooms",
            "value": 5,
            "description": "Rooms"
          },
          {
            "id": "HOTELS_ASPECT_SERVICES",
            "name": "Service",
            "value": 5,
            "description": "Service"
          },
          {
            "id": "HOTELS_ASPECT_LOCATION",
            "name": "Location",
            "value": 5,
            "description": "Location"
          },
          {
            "id": "HOTELS_VIBE",
            "name": "Hotel highlights",
            "value": "Luxury",
            "description": "How would you describe the hotel?"
          }
        ]
      },
      {
        "review_id": "Ci9DQUlRQUNvZENodHljRjlvT2pKQllqQm5SSE5qYnpaTmRrbEdZMGMyTTBjNWJIYxAB",
        "reviewer": {
          "profile_photo_url": "https://lh3.googleusercontent.com/a-/ALV-UjVW7IQQa1I-xPbiSjPFgq_yV38xEaaWp2c0eMF_rjbXydFynAgZ=s120-c-rp-mo-br100",
          "display_name": "Letícia Niquelatti",
          "link": "https://www.google.com/maps/contrib/106373021198817194762?hl=en"
        },
        "link": "https://www.google.com/maps/reviews/data=!4m8!14m7!1m6!2m5!1sCi9DQUlRQUNvZENodHljRjlvT2pKQllqQm5SSE5qYnpaTmRrbEdZMGMyTTBjNWJIYxAB!2m1!1s0x0:0x2a34371cb33f3c80!3m1!1s2@1:CAIQACodChtycF9oOjJBYjBnRHNjbzZNdklGY0c2M0c5bHc%7C0d8CZSE5EIx%7C?hl=en",
        "source": "Google",
        "source_logo": "https://www.gstatic.com/images/branding/product/1x/googleg_48dp.png",
        "rating": "5/5",
        "created": "3 months ago",
        "comment": "I had a great experience at the New York Hilton Midtown. The location is excellent, allowing you to walk to many attractions. The hotel is well organized, the rooms are comfortable, and the staff was always polite and helpful. It’s a large property, but everything ran smoothly — fast check-in and no issues during my stay. I highly recommend it for its convenience and safety.",
        "review_reply": "Dear Letícia,\nThank you for sharing such a thoughtful review with us. It is wonderful that you enjoyed the convenience of the location and the ability to reach so many nearby attractions on foot. We're glad that the room felt comfortable, the property operated smoothly, and that our team treated you with consistent courtesy paints a picture of a stay that unfolded just as it should. A seamless check-in and a sense of safety in a large property can make travel feel effortless, and it is great that was your experience. We appreciated having you with us, and we hope your travels bring you back again.\n\nSincerely,\n\nNew York Hilton Midtown Team\n\nNYCNH_FO@hilton.com",
        "review_reply_created": "2 months ago",
        "details": [
          {
            "id": "HOTELS_PILOT_TRIP_TYPE",
            "name": "Trip type",
            "value": "Vacation",
            "description": "What kind of trip was it?"
          },
          {
            "id": "HOTELS_PILOT_TRAVEL_GROUP_TYPE",
            "name": "Travel group",
            "value": "Family",
            "description": "Who did you travel with?"
          },
          {
            "id": "HOTELS_ASPECT_ROOMS",
            "name": "Rooms",
            "value": 5,
            "description": "Rooms"
          },
          {
            "id": "HOTELS_ASPECT_SERVICES",
            "name": "Service",
            "value": 5,
            "description": "Service"
          },
          {
            "id": "HOTELS_ASPECT_LOCATION",
            "name": "Location",
            "value": 5,
            "description": "Location"
          }
        ]
      },
      {
        "review_id": "Ci9DQUlRQUNvZENodHljRjlvT2xkSlZ6ZHRkalZIU2pSaFVWbDRVMnhLZGpoSlFVRRAB",
        "reviewer": {
          "profile_photo_url": "https://lh3.googleusercontent.com/a/ACg8ocK9GUmz3QdZCvkPYxAkURvSbS2BhSQZKA7dSq0aBC9gzYk3SA=s120-c-rp-mo-ba4-br100",
          "display_name": "Alison N",
          "link": "https://www.google.com/maps/contrib/114280676597674102522?hl=en"
        },
        "link": "https://www.google.com/maps/reviews/data=!4m8!14m7!1m6!2m5!1sCi9DQUlRQUNvZENodHljRjlvT2xkSlZ6ZHRkalZIU2pSaFVWbDRVMnhLZGpoSlFVRRAB!2m1!1s0x0:0x2a34371cb33f3c80!3m1!1s2@1:CAIQACodChtycF9oOldJVzdtdjVHSjRhUVl4U2xKdjhJQUE%7C0cmFqFJatJu%7C?hl=en",
        "source": "Google",
        "source_logo": "https://www.gstatic.com/images/branding/product/1x/googleg_48dp.png",
        "rating": "5/5",
        "created": "5 months ago",
        "comment": "I had a great stay at the Hilton Midtown. Check-in, room upgrade, and check-out were all very smooth and easy. The rooms are spacious, clean, and comfortable, and the staff is very friendly.\nThere can be a bit of a wait for the elevators, which is slightly inconvenient, but nothing too bothersome. The location is perfect, right in the center of New York, with taxis always available and plenty of restaurants and shops around.\nA nice extra perk: $35 per day to spend at the hotel’s restaurants. Overall, a very good experience. Highly recommend!",
        "review_reply": "Dear Alison,\nThank you for your wonderful review! We’re delighted that you enjoyed your stay at New York Hilton Midtown, from our smooth check-in and room upgrade to the comfort and cleanliness of our accommodations. It’s great that our central location and daily dining credit added to your experience. We appreciate your patience with the elevator wait times and are always working to improve convenience for our guests. Your recommendation means so much to us, and we look forward to welcoming you back for another unforgettable getaway in the future.\n\nSincerely,\n\nNew York Hilton Midtown Team\n\nNYCNH_FO@hilton.com",
        "review_reply_created": "5 months ago",
        "details": [
          {
            "id": "HOTELS_PILOT_TRIP_TYPE",
            "name": "Trip type",
            "value": "Business",
            "description": "What kind of trip was it?"
          },
          {
            "id": "HOTELS_PILOT_TRAVEL_GROUP_TYPE",
            "name": "Travel group",
            "value": "Friends",
            "description": "Who did you travel with?"
          },
          {
            "id": "HOTELS_ASPECT_ROOMS",
            "name": "Rooms",
            "value": 5,
            "description": "Rooms"
          },
          {
            "id": "HOTELS_ASPECT_SERVICES",
            "name": "Service",
            "value": 5,
            "description": "Service"
          },
          {
            "id": "HOTELS_ASPECT_LOCATION",
            "name": "Location",
            "value": 5,
            "description": "Location"
          }
        ]
      },
      {
        "review_id": "Ci9DQUlRQUNvZENodHljRjlvT2pOQmVEWnBZMGRHY1ROMlUxQnplRTFKU20wNVptYxAB",
        "reviewer": {
          "profile_photo_url": "https://lh3.googleusercontent.com/a-/ALV-UjVq8BGEqL10iiXMHjAAkzBnco5rg50LjBZJg1lY604ktQnnVDxUUA=s120-c-rp-mo-ba5-br100",
          "display_name": "Brad Woodruff",
          "link": "https://www.google.com/maps/contrib/110607930004076171319?hl=en"
        },
        "link": "https://www.google.com/maps/reviews/data=!4m8!14m7!1m6!2m5!1sCi9DQUlRQUNvZENodHljRjlvT2pOQmVEWnBZMGRHY1ROMlUxQnplRTFKU20wNVptYxAB!2m1!1s0x0:0x2a34371cb33f3c80!3m1!1s2@1:CAIQACodChtycF9oOjNBeDZpY0dGcTN2U1BzeE1JSm05Zmc%7C0d6dIFB_rJH%7C?hl=en",
        "source": "Google",
        "source_logo": "https://www.gstatic.com/images/branding/product/1x/googleg_48dp.png",
        "rating": "5/5",
        "created": "3 months ago",
        "comment": "The hotel is basic at best. If you want the NYC experience, stay in Times Square or on the rivers.\n\nWhere this hotel excels is location. It's in the heart of Midtown, convenient to Central Park and a host of subway holes to get to the rest of the city.  A good home base for your stay.\n\nIt's a huge hotel with a lot of rooms, so be prepared to wait to check in/out.\n\nThe room (queen, city view, 27th floor) was a normal room with little amenities included, and that was an upgrade. But again, it's location, location, location.\n\nThe Executive Lounge is also basic, but the staff is too notch. Super friendly and attentive. Plus it's a good place to stock up on waters and fruit before your daily excursions. Or to stop in for Happy Hour to grab a snack before a proper dinner.\n\nThe gym is massive. So many bikes, treadmills, ellipticals and stations. Honestly one of the biggest gyms I have seen in a hotel.",
        "review_reply": "Dear Brad,\nThank you for sharing your review. It’s great to know that our central setting served as a convenient starting point for exploring the city, along with our well-equipped fitness center. Our Executive Lounge team will be thrilled to hear that they made a meaningful impression. At the same time, it’s understood that certain aspects of the room and overall experience didn’t meet your expectations, and your perspective is invaluable as enhancements are continually evaluated. Your insights help guide us, and it would be a pleasure to welcome you back to New York Hilton Midtown again soon.\n\nSincerely,\n\nNew York Hilton Midtown Team\n\nNYCNH_FO@hilton.com",
        "review_reply_created": "3 months ago",
        "details": [
          {
            "id": "HOTELS_PILOT_TRIP_TYPE",
            "name": "Trip type",
            "value": "Vacation",
            "description": "What kind of trip was it?"
          },
          {
            "id": "HOTELS_PILOT_TRAVEL_GROUP_TYPE",
            "name": "Travel group",
            "value": "Couple",
            "description": "Who did you travel with?"
          },
          {
            "id": "HOTELS_ASPECT_ROOMS",
            "name": "Rooms",
            "value": 5,
            "description": "Rooms"
          },
          {
            "id": "HOTELS_ASPECT_SERVICES",
            "name": "Service",
            "value": 5,
            "description": "Service"
          },
          {
            "id": "HOTELS_ASPECT_LOCATION",
            "name": "Location",
            "value": 5,
            "description": "Location"
          },
          {
            "id": "HOTELS_VIBE",
            "name": "Hotel highlights",
            "value": "Great value",
            "description": "How would you describe the hotel?"
          }
        ]
      }
    ]
  }
  ```
</ResponseExample>


# Sort (lowest)
Source: https://docs.brightdata.com/api-reference/serp/google-reviews/sort-lowest

Configure the Bright Data Google Reviews Sort (Lowest) parameter to refine queries and return matching results as JSON or HTML. On port 44445.

```txt wrap theme={null}
https://www.google.com/reviews?fid=0x89c25855c0679529:0x2a34371cb33f3c80&sort=ratingLow
```

## Parameters

<ParamField type="string">
  Feature id what you want to fetch reviews to. `fid` parameter can be found in `knowledge.fid` field of google search response.
</ParamField>

<ParamField type="string">
  The way reviews are sorted.

  | value               | description                     |
  | ------------------- | ------------------------------- |
  | `sort=qualityScore` | most relevant first (`default`) |
  | `sort=newestFirst`  | newest first                    |
  | `sort=ratingHigh`   | highest rating first            |
  | `sort=ratingLow`    | lowest rating first             |

  ```txt wrap theme={null}
  https://www.google.com/reviews?fid=0x89c25855c0679529:0x2a34371cb33f3c80&sort=ratingLow
  ```
</ParamField>

<RequestExample>
  ```shell cURL highlight={6} theme={null}
    curl -X POST https://api.brightdata.com/request \
    --header "Content-Type: application/json" \
    --header "Authorization: Bearer API_KEY" \
    --data '{
      "zone": "serp_api1",
      "url": "https://www.google.com/reviews?fid=0x89c25855c0679529:0x2a34371cb33f3c80&sort=ratingLow",
      "format": "raw"
    }'
  ```

  ```shell Native proxy highlight={4} theme={null}
  curl --proxy brd.superproxy.io:44445 \
    --proxy-user CUSTOMER_USERNAME:CUSTOMER_PASSWORD \
    --ssl-no-revoke \
    "https://www.google.com/reviews?fid=0x89c25855c0679529:0x2a34371cb33f3c80&sort=ratingLow"
  ```

  ```js Node.js highlight={10} theme={null}
  (async () => {
    const response = await fetch('https://api.brightdata.com/request', {
      method: 'POST',
      headers: {
        'Content-Type': 'application/json',
        'Authorization': 'Bearer API_KEY'
      },
      body: JSON.stringify({
        zone: 'serp_api1',
        url: 'https://www.google.com/reviews?fid=0x89c25855c0679529:0x2a34371cb33f3c80&sort=ratingLow',
        format: 'raw'
      })
    });
    
    const data = await response.text();
    console.log(data);
  })();
  ```

  ```python Python highlight={11} theme={null}
  import requests

  # API Configuration
  headers = {
      'Content-Type': 'application/json',
      'Authorization': 'Bearer API_KEY',
  }

  payload = {
      'zone': 'serp_api1',
      'url': 'https://www.google.com/reviews?fid=0x89c25855c0679529:0x2a34371cb33f3c80&sort=ratingLow',
      'format': 'raw'
  }

  # Make the request
  response = requests.post(
      'https://api.brightdata.com/request', 
      json=payload, 
      headers=headers
  )

  print(response.text)
  ```
</RequestExample>

<ResponseExample>
  ```json 200 theme={null}
  {
    "reviews": [
      {
        "review_id": "ChdDSUhNMG9nS0VQZm1zUENtb0xMc3NRRRAB",
        "reviewer": {
          "profile_photo_url": "https://lh3.googleusercontent.com/local-reviews/AJMZ0QcielscjLvsxs3qLg_jAt2zcU0gRqU3PrSHHU2lAuv568Mt5lG3Clk44mfbfmM4sEJa1w=s120-c-br100",
          "display_name": "Caity",
          "link": "http://www.priceline.com/r/?channel=meta&product=hotel&theme=reviews&refid=PLGOOGLEHARV&refclickid=HARV_39532&hotel_id=39532"
        },
        "link": "http://www.priceline.com/r/?channel=meta&product=hotel&theme=reviews&refid=PLGOOGLEHARV&refclickid=HARV_39532&hotel_id=39532",
        "source": "Priceline",
        "source_logo": "https://www.gstatic.com/travel-hotels/branding/icon_220.png",
        "rating": "1/10",
        "created": "5 months ago",
        "comment": "Positive: The bathroom was dirty when we arrived. The sink drain was broken and pulled out laying on the sink. The bathtub backed up and filled with water each time we showered. We repeatedly asked for this to be fixed and they did not. Negative: The lightbulb was out in the haPlay with the only mirror we called them and talked to them in person a total of 4 times. They never replaced it. Staff were rude and unhelpful."
      },
      {
        "review_id": "ChdDSUhNMG9nS0VQcTd2ZXJSM3NmdmxBRRAB",
        "reviewer": {
          "profile_photo_url": "https://lh3.googleusercontent.com/local-reviews/AJMZ0QeAy-xp9ZrUglhBV1LZEaPGpmlbQnwJJRBzU4YC55Z65V5JcBYvtxvOT-WqxVgRv6wAOA=s120-c-br100",
          "display_name": "Alessandro",
          "link": "http://www.priceline.com/r/?channel=meta&product=hotel&theme=reviews&refid=PLGOOGLEHARV&refclickid=HARV_39532&hotel_id=39532"
        },
        "link": "http://www.priceline.com/r/?channel=meta&product=hotel&theme=reviews&refid=PLGOOGLEHARV&refclickid=HARV_39532&hotel_id=39532",
        "source": "Priceline",
        "source_logo": "https://www.gstatic.com/travel-hotels/branding/icon_220.png",
        "rating": "1/10",
        "created": "6 months ago",
        "comment": "Positive: Location Negative: I was scamed with the pricing ( the so called city tax which was never mentioned. Also one of the reasons why I booked it said he offered shuttle to the airports. The hotel lounge  literally scamed.me out of money .the bar tender was a scammer"
      },
      {
        "review_id": "ChdDSUhNMG9nS0VJQ0FnTUR3ZzY2NmtBRRAB",
        "reviewer": {
          "profile_photo_url": "https://lh3.googleusercontent.com/local-reviews/AJMZ0QfitSTClYz8LWcvgW5L4tnq-tcK0wDRS5KpgF4zUnjMZguvii9otIV06c_gvv3urQy3ZQ=s120-c-br100",
          "display_name": "Thea",
          "link": "http://www.priceline.com/r/?channel=meta&product=hotel&theme=reviews&refid=PLGOOGLEHARV&refclickid=HARV_39532&hotel_id=39532"
        },
        "link": "http://www.priceline.com/r/?channel=meta&product=hotel&theme=reviews&refid=PLGOOGLEHARV&refclickid=HARV_39532&hotel_id=39532",
        "source": "Priceline",
        "source_logo": "https://www.gstatic.com/travel-hotels/branding/icon_220.png",
        "rating": "1/10",
        "created": "11 months ago",
        "comment": "Positive: \"\" Negative: No microwave, rude staff and they were unwilling to help and did not seem to care. Also, HIlton customer service wouldn't help me when i told them i had issues with the staff and they told me to contact the hotel directly. What are you here for then?."
      },
      {
        "review_id": "ChdDSUhNMG9nS0VKR2Y0b0hjb3V6WDFRRRAB",
        "reviewer": {
          "profile_photo_url": "https://lh3.googleusercontent.com/local-reviews/AJMZ0QchhyJTr8jjr7kbZNRY9gkp3EPmuhZxKqlMWJ5peJxoA1in-DXrIhwxitaLgo-qo75Ujg=s120-c-br100",
          "display_name": "Dan",
          "link": "http://www.priceline.com/r/?channel=meta&product=hotel&theme=reviews&refid=PLGOOGLEHARV&refclickid=HARV_39532&hotel_id=39532"
        },
        "link": "http://www.priceline.com/r/?channel=meta&product=hotel&theme=reviews&refid=PLGOOGLEHARV&refclickid=HARV_39532&hotel_id=39532",
        "source": "Priceline",
        "source_logo": "https://www.gstatic.com/travel-hotels/branding/icon_220.png",
        "rating": "1/10",
        "created": "10 months ago",
        "comment": "Positive: nothing really one of the worst experiences i had staying in a hotel Negative: got to the room at 10 pm nothing went right worst ever"
      },
      {
        "review_id": "ChdDSUhNMG9nS0VJQ0FnSURmdEpLdzJnRRAB",
        "reviewer": {
          "profile_photo_url": "https://lh3.googleusercontent.com/local-reviews/AJMZ0Qe1FTSCg98CZ3VrSg28YAOa76nyaQfZNd66XhsW7MF99ozoooauY0gRdjL2-kPkUfooOQ=s120-c-br100",
          "display_name": "Mary",
          "link": "http://www.priceline.com/r/?channel=meta&product=hotel&theme=reviews&refid=PLGOOGLEHARV&refclickid=HARV_39532&hotel_id=39532"
        },
        "link": "http://www.priceline.com/r/?channel=meta&product=hotel&theme=reviews&refid=PLGOOGLEHARV&refclickid=HARV_39532&hotel_id=39532",
        "source": "Priceline",
        "source_logo": "https://www.gstatic.com/travel-hotels/branding/icon_220.png",
        "rating": "1/10",
        "created": "a year ago",
        "comment": "Positive: \"\" Negative: The metalBed frames stuck out and I sliced my leg and had to get 7 stitches from mt Sinai hospital"
      },
      {
        "review_id": "Ci9DQUlRQUNvZENodHljRjlvT2tSbFJsWmxYME5KZEVsQ1lrZHZiRXd4Y21SdVptYxAB",
        "reviewer": {
          "profile_photo_url": "https://lh3.googleusercontent.com/a-/ALV-UjWR9P0hsugLdp9Oat4sxTahBKrA0gZ1C7uqw4MNisrIvLu3hy-V=s120-c-rp-mo-ba2-br100",
          "display_name": "Jennifer Wakefield",
          "link": "https://www.google.com/maps/contrib/114840974672973065687?hl=en"
        },
        "link": "https://www.google.com/maps/reviews/data=!4m8!14m7!1m6!2m5!1sCi9DQUlRQUNvZENodHljRjlvT2tSbFJsWmxYME5KZEVsQ1lrZHZiRXd4Y21SdVptYxAB!2m1!1s0x0:0x2a34371cb33f3c80!3m1!1s2@1:CAIQACodChtycF9oOkRlRlZlX0NJdElCYkdvbEwxcmRuZmc%7C0dI--RQ5bgo%7C?hl=en",
        "source": "Google",
        "source_logo": "https://www.gstatic.com/images/branding/product/1x/googleg_48dp.png",
        "rating": "1/5",
        "created": "Edited 2 months ago",
        "date": "2025-12-24",
        "comment": "The location is fabulous. Everything else is terrible. This hotel has severely gone downhill over the years. It is not a four star maybe a two star at best. The rooms were adequate. The bathroom was disgusting and had discolored water forcing us to brush our teeth with bottled water. The wait for the elevators was ridiculous and we ended up using the service elevators and that area was absolutely disgusting and did not feel safe.",
        "review_reply": "Dear Jennifer,\nThough we are glad you enjoyed our central location, we regret that other aspects of your visit fell below your expectations and the high standards we strive for. What you have described regarding our accommodations, amenities, and the comfort and convenience we aim to consistently provide our guests is not typical for us. Rest assured, your insights will be promptly addressed for review and correction. We hope to welcome you back in the future to change your lasting impressions. \n\nSincerely,\n\nNew York Hilton Midtown Team\n\nNYCNH_FO@hilton.com",
        "review_reply_created": "a month ago",
        "photos": [
          "https://lh3.googleusercontent.com/geougc-cs/ABOP9ptLCFihq0e2Rr2xf5cBpxANMMhfDf1JNipzZV2xKzKvd-Td8Qfo806H4UwgM0apfWvMJArehhlrJbvtpuZyVzbpeBnkVhyxekIHl5lw7aRAKEy5Qw6DMp1-Ra6BPNVObzRdWeu7N9tJKFQ",
          "https://lh3.googleusercontent.com/geougc-cs/ABOP9ptpkESmccJfCgtjbmg66XKUKhbCM_Z8uVSsZ9a1wSHiSeaTKmsqURZ5b_UTuXuVxraFCv-MEHjqkhz10E3BsL2XiV3iQlmNEzik1QUg2tHyJVUJYF3XePBNCursMNftK2ATijYCAE3XIGk",
          "https://lh3.googleusercontent.com/geougc-cs/ABOP9psDnhsuOCuRiEKmw2YqOiDUbqGeziogZ0aJj0PL8tIz4-PbpFotEiJa1hZ4reobYw54gMKgbmU-ahevtF4KefFBTpBtOs_6jB8OQBjZiQGtEXE69koipvhvJPHSG0ADdpnkNyYkf4FQxc0"
        ],
        "details": [
          {
            "id": "HOTELS_PILOT_TRIP_TYPE",
            "name": "Trip type",
            "value": "Vacation",
            "description": "What kind of trip was it?"
          },
          {
            "id": "HOTELS_PILOT_TRAVEL_GROUP_TYPE",
            "name": "Travel group",
            "value": "Family",
            "description": "Who did you travel with?"
          },
          {
            "id": "HOTELS_ASPECT_ROOMS",
            "name": "Rooms",
            "value": 1,
            "description": "Rooms"
          },
          {
            "id": "HOTELS_ASPECT_SERVICES",
            "name": "Service",
            "value": 1,
            "description": "Service"
          },
          {
            "id": "HOTELS_ASPECT_LOCATION",
            "name": "Location",
            "value": 5,
            "description": "Location"
          }
        ]
      },
      {
        "review_id": "Ci9DQUlRQUNvZENodHljRjlvT213M01Ib3daVTEwZFdrNFREZG1XbVEyV0ZCQkxYYxAB",
        "reviewer": {
          "profile_photo_url": "https://lh3.googleusercontent.com/a/ACg8ocJ2aeQdtiJkWeCyxq8wk3mwShLLZdvL3mNfhS0phcXWil15iw=s120-c-rp-mo-ba2-br100",
          "display_name": "Sarah Vertrees",
          "link": "https://www.google.com/maps/contrib/114286611919008365782?hl=en"
        },
        "link": "https://www.google.com/maps/reviews/data=!4m8!14m7!1m6!2m5!1sCi9DQUlRQUNvZENodHljRjlvT213M01Ib3daVTEwZFdrNFREZG1XbVEyV0ZCQkxYYxAB!2m1!1s0x0:0x2a34371cb33f3c80!3m1!1s2@1:CAIQACodChtycF9oOmw3MHowZU10dWk4TDdmWmQ2WFBBLXc%7C0dHofB_sbAT%7C?hl=en",
        "source": "Google",
        "source_logo": "https://www.gstatic.com/images/branding/product/1x/googleg_48dp.png",
        "rating": "1/5",
        "created": "2 months ago",
        "comment": "The only positive about this hotel is the location.\n\nWhen we arrived we were told that they were out of parking so we had to park ourselves in the parking garage across the street.\n\nWe paid over $600 a night for a room that was fair at best. It was very dated, screws missing out of the door handle, semi-clean, the bath tub wouldn’t drain-when I went to adjust the stopper it came out and the bath tub itself was pealing, the hotel staff were all less than pleasant!\n\nAs many others have mentioned the elevator stops a nightmare!",
        "review_reply": "emailed guest",
        "review_reply_created": "2 months ago",
        "details": [
          {
            "id": "HOTELS_PILOT_TRIP_TYPE",
            "name": "Trip type",
            "value": "Vacation",
            "description": "What kind of trip was it?"
          },
          {
            "id": "HOTELS_PILOT_TRAVEL_GROUP_TYPE",
            "name": "Travel group",
            "value": "Family",
            "description": "Who did you travel with?"
          },
          {
            "id": "HOTELS_ASPECT_ROOMS",
            "name": "Rooms",
            "value": 1,
            "description": "Rooms"
          },
          {
            "id": "HOTELS_ASPECT_SERVICES",
            "name": "Service",
            "value": 1,
            "description": "Service"
          },
          {
            "id": "HOTELS_ASPECT_LOCATION",
            "name": "Location",
            "value": 5,
            "description": "Location"
          },
          {
            "id": "HOTELS_VIBE",
            "name": "Hotel highlights",
            "value": "Kid-friendly",
            "description": "How would you describe the hotel?"
          }
        ]
      },
      {
        "review_id": "Ci9DQUlRQUNvZENodHljRjlvT25oNFUwVnVkRTB3Y1ZGM2JreHFSVEZXU0hOdFNXYxAB",
        "reviewer": {
          "profile_photo_url": "https://lh3.googleusercontent.com/a-/ALV-UjUfusV7ZUjUCOLqMSt3fppZPTMYkLGZT4DP2M1Af_cL-58ns8WggA=s120-c-rp-mo-br100",
          "display_name": "Alison McGuckin",
          "link": "https://www.google.com/maps/contrib/117751954034681560040?hl=en"
        },
        "link": "https://www.google.com/maps/reviews/data=!4m8!14m7!1m6!2m5!1sCi9DQUlRQUNvZENodHljRjlvT25oNFUwVnVkRTB3Y1ZGM2JreHFSVEZXU0hOdFNXYxAB!2m1!1s0x0:0x2a34371cb33f3c80!3m1!1s2@1:CAIQACodChtycF9oOnh4U0VudE0wcVF3bkxqRTFWSHNtSWc%7C0dC2Wfaja3C%7C?hl=en",
        "source": "Google",
        "source_logo": "https://www.gstatic.com/images/branding/product/1x/googleg_48dp.png",
        "rating": "1/5",
        "created": "2 months ago",
        "comment": "Everything about this hotel would be great if it weren’t for the horrid elevator situation. It took 30 minutes for us to get 4 people downstairs from floor 38. We had to separate as a group to put one person into an elevator every time it showed up and actually had room. While in the jam packed elevator you would stop at every single floor, only for most of them to not even have anyone getting off there or waiting. We used to love this hotel, now we’ll be looking for a different midtown stay.",
        "review_reply": "Good morning, Alison, \nThank you for providing details of your experience with us. I would love to connect with you and make things right. We are currently unable to locate a reservation in your name. Can you kindly send your reservation details to Hannah.Zipkin@hilton.com? I look forward to hearing from you.",
        "review_reply_created": "2 months ago",
        "details": [
          {
            "id": "HOTELS_PILOT_TRIP_TYPE",
            "name": "Trip type",
            "value": "Vacation",
            "description": "What kind of trip was it?"
          },
          {
            "id": "HOTELS_PILOT_TRAVEL_GROUP_TYPE",
            "name": "Travel group",
            "value": "Family",
            "description": "Who did you travel with?"
          },
          {
            "id": "HOTELS_ASPECT_ROOMS",
            "name": "Rooms",
            "value": 4,
            "description": "Rooms"
          },
          {
            "id": "HOTELS_ASPECT_SERVICES",
            "name": "Service",
            "value": 4,
            "description": "Service"
          },
          {
            "id": "HOTELS_ASPECT_LOCATION",
            "name": "Location",
            "value": 4,
            "description": "Location"
          }
        ]
      },
      {
        "review_id": "Ci9DQUlRQUNvZENodHljRjlvT201VFZHMXJXRmhRY1d4aGVFUXRTVTlxVGxwS2FXYxAB",
        "reviewer": {
          "profile_photo_url": "https://lh3.googleusercontent.com/a/ACg8ocKFFBoM5okLNgq5lmdU_db_kYw5sStw7_b6myemC4LpgdpvYA=s120-c-rp-mo-br100",
          "display_name": "Elizabeth Hubbard",
          "link": "https://www.google.com/maps/contrib/107665312411597262592?hl=en"
        },
        "link": "https://www.google.com/maps/reviews/data=!4m8!14m7!1m6!2m5!1sCi9DQUlRQUNvZENodHljRjlvT201VFZHMXJXRmhRY1d4aGVFUXRTVTlxVGxwS2FXYxAB!2m1!1s0x0:0x2a34371cb33f3c80!3m1!1s2@1:CAIQACodChtycF9oOm5TVG1rWFhQcWxheEQtSU9qTlpKaWc%7C0dEm9J76k0S%7C?hl=en",
        "source": "Google",
        "source_logo": "https://www.gstatic.com/images/branding/product/1x/googleg_48dp.png",
        "rating": "1/5",
        "created": "2 months ago",
        "comment": "Unfortunately, this stay was a major disappointment. We were asked to pay $100 for early check-in despite being Hilton members. The hotel was extremely overcrowded, the lobby was chaotic, and the elevator wait times were outrageous—often 10–20 minutes—forcing us to take the stairs from the 7th floor.\n\nLate checkout was denied unless we paid extra, bag storage took over 45 minutes and cost $5 per bag, and there weren’t even complimentary bottles of water in the room. Overall, the experience felt focused on squeezing money out of guests rather than providing hospitality. Very disappointing, and we will never stay at this hotel again.",
        "review_reply": "Dear Elizabeth,\nThank you for being a Hilton Honors member and for taking the time to share such a detailed account of your stay. We’re genuinely sorry to hear of the issues you encountered. Long elevator wait times and missing in-room amenities are never the impression we want any of our guests to have.  Your feedback will be reviewed with the team as we continue to focus on improving comfort, clarity, and support for all our guests. We appreciate you outlining your experience so thoughtfully and hope you will consider giving us another chance to improve your lasting impression.\n\nSincerely,\n\nNew York Hilton Midtown Team\n\nNYCNH_FO@hilton.com",
        "review_reply_created": "2 months ago",
        "details": [
          {
            "id": "HOTELS_PILOT_TRIP_TYPE",
            "name": "Trip type",
            "value": "Vacation",
            "description": "What kind of trip was it?"
          },
          {
            "id": "HOTELS_PILOT_TRAVEL_GROUP_TYPE",
            "name": "Travel group",
            "value": "Family",
            "description": "Who did you travel with?"
          },
          {
            "id": "HOTELS_ASPECT_ROOMS",
            "name": "Rooms",
            "value": 1,
            "description": "Rooms"
          },
          {
            "id": "HOTELS_ASPECT_SERVICES",
            "name": "Service",
            "value": 1,
            "description": "Service"
          },
          {
            "id": "HOTELS_ASPECT_LOCATION",
            "name": "Location",
            "value": 3,
            "description": "Location"
          }
        ]
      },
      {
        "review_id": "Ci9DQUlRQUNvZENodHljRjlvT2twRWJUSTVkVTQxTTNnNGVtTnhlVlZ3V1V0RmRsRRAB",
        "reviewer": {
          "profile_photo_url": "https://lh3.googleusercontent.com/a-/ALV-UjW0NZGbAlQzaaxlwFZWEu7-nWpfPfpd-WTTzOnIPQ4L301tf5gX=s120-c-rp-mo-ba4-br100",
          "display_name": "Langee Twentytwo",
          "link": "https://www.google.com/maps/contrib/108549160741845792792?hl=en"
        },
        "link": "https://www.google.com/maps/reviews/data=!4m8!14m7!1m6!2m5!1sCi9DQUlRQUNvZENodHljRjlvT2twRWJUSTVkVTQxTTNnNGVtTnhlVlZ3V1V0RmRsRRAB!2m1!1s0x0:0x2a34371cb33f3c80!3m1!1s2@1:CAIQACodChtycF9oOkpEbTI5dU41M3g4emNxeVVwWUtFdlE%7C0dJIrIshcA6%7C?hl=en",
        "source": "Google",
        "source_logo": "https://www.gstatic.com/images/branding/product/1x/googleg_48dp.png",
        "rating": "1/5",
        "created": "a month ago",
        "comment": "Great location. Terribly ran hotel. The first night they took our towels and didn’t replace them. The executive line either had no food or a line out the door. Service was dismissive in all areas. Starting with the front desk. They have convinced me to cancel my Hilton card and open a Marriott car, even as a Diamond member. Awful experience.",
        "review_reply": "Dear Langee,\nWe regret that our team's service did not meet expectations. What you've described is not the typical experience of our guests, and we will address these concerns promptly. Thank you for bringing these matters to our attention, and we hope you will consider giving us another chance to change your perceptions in the future.\n\nSincerely,\n\nNew York Hilton Midtown Team\n\nNYCNH_FO@hilton.com",
        "review_reply_created": "a month ago",
        "details": [
          {
            "id": "HOTELS_PILOT_TRIP_TYPE",
            "name": "Trip type",
            "value": "Vacation",
            "description": "What kind of trip was it?"
          },
          {
            "id": "HOTELS_PILOT_TRAVEL_GROUP_TYPE",
            "name": "Travel group",
            "value": "Couple",
            "description": "Who did you travel with?"
          },
          {
            "id": "HOTELS_ASPECT_ROOMS",
            "name": "Rooms",
            "value": 1,
            "description": "Rooms"
          },
          {
            "id": "HOTELS_ASPECT_SERVICES",
            "name": "Service",
            "value": 1,
            "description": "Service"
          },
          {
            "id": "HOTELS_ASPECT_LOCATION",
            "name": "Location",
            "value": 5,
            "description": "Location"
          }
        ]
      }
    ]
  }
  ```
</ResponseExample>


# Sort (newest)
Source: https://docs.brightdata.com/api-reference/serp/google-reviews/sort-newest

Configure the Bright Data Google Reviews Sort (Newest) parameter to refine queries and return matching results as JSON or HTML. On port 44445.

```txt wrap theme={null}
https://www.google.com/reviews?fid=0x89c25855c0679529:0x2a34371cb33f3c80&sort=newestFirst
```

## Parameters

<ParamField type="string">
  Feature id what you want to fetch reviews to. `fid` parameter can be found in `knowledge.fid` field of google search response.
</ParamField>

<ParamField type="string">
  The way reviews are sorted.

  | value               | description                     |
  | ------------------- | ------------------------------- |
  | `sort=qualityScore` | most relevant first (`default`) |
  | `sort=newestFirst`  | newest first                    |
  | `sort=ratingHigh`   | highest rating first            |
  | `sort=ratingLow`    | lowest rating first             |

  ```txt wrap theme={null}
  https://www.google.com/reviews?fid=0x89c25855c0679529:0x2a34371cb33f3c80&sort=newestFirst
  ```
</ParamField>

<RequestExample>
  ```shell cURL highlight={6} theme={null}
    curl -X POST https://api.brightdata.com/request \
    --header "Content-Type: application/json" \
    --header "Authorization: Bearer API_KEY" \
    --data '{
      "zone": "serp_api1",
      "url": "https://www.google.com/reviews?fid=0x89c25855c0679529:0x2a34371cb33f3c80&sort=newestFirst",
      "format": "raw"
    }'
  ```

  ```shell Native proxy highlight={4} theme={null}
  curl --proxy brd.superproxy.io:44445 \
    --proxy-user CUSTOMER_USERNAME:CUSTOMER_PASSWORD \
    --ssl-no-revoke \
    "https://www.google.com/reviews?fid=0x89c25855c0679529:0x2a34371cb33f3c80&sort=newestFirst"
  ```

  ```js Node.js highlight={10} theme={null}
  (async () => {
    const response = await fetch('https://api.brightdata.com/request', {
      method: 'POST',
      headers: {
        'Content-Type': 'application/json',
        'Authorization': 'Bearer API_KEY'
      },
      body: JSON.stringify({
        zone: 'serp_api1',
        url: 'https://www.google.com/reviews?fid=0x89c25855c0679529:0x2a34371cb33f3c80&sort=newestFirst',
        format: 'raw'
      })
    });
    
    const data = await response.text();
    console.log(data);
  })();
  ```

  ```python Python highlight={11} theme={null}
  import requests

  # API Configuration
  headers = {
      'Content-Type': 'application/json',
      'Authorization': 'Bearer API_KEY',
  }

  payload = {
      'zone': 'serp_api1',
      'url': 'https://www.google.com/reviews?fid=0x89c25855c0679529:0x2a34371cb33f3c80&sort=newestFirst',
      'format': 'raw'
  }

  # Make the request
  response = requests.post(
      'https://api.brightdata.com/request', 
      json=payload, 
      headers=headers
  )

  print(response.text)
  ```
</RequestExample>

<ResponseExample>
  ```json 200 theme={null}
  {
    "reviews": [
      {
        "review_id": "ChZDSUhNMG9nS0VMbUVrYktvcXRqRlBREAE",
        "reviewer": {
          "profile_photo_url": "https://lh3.googleusercontent.com/local-reviews/AJMZ0QeYuXGoFc9HnT35lAJ46cKDIsHY7nNIKUKz_f8yINNlqyrU48jCx-4ctPzihRKgde030w=s120-c-br100",
          "display_name": "Curiosity572892",
          "link": "https://www.tripadvisor.com/ShowUserReviews-g60763-d611947-r1046632270?m=68573&staydates=2026_03_08_2026_03_09&uguests=1_2_0&supdv=desktop&supuc=EG&supul=en"
        },
        "link": "https://www.tripadvisor.com/ShowUserReviews-g60763-d611947-r1046632270?m=68573&staydates=2026_03_08_2026_03_09&uguests=1_2_0&supdv=desktop&supuc=EG&supul=en",
        "source": "Tripadvisor",
        "source_logo": "https://www.gstatic.com/travel-hotels/branding/icon_100532569.png",
        "rating": "3/5",
        "created": "a month ago",
        "comment": "Hotel is getting very dated. Overall staff was mediocre however I need to give a shout out to Jesus at the front desk. He was super helpful in finding a room that was ready. He really cared about getting my family and I a room after we were waiting a long time. He had a joyful attitude and was even great interacting with my kids while he worked on our problem. He was amazing! Thanks Jesus!"
      },
      {
        "review_id": "ChdDSUhNMG9nS0VLLUVvZFgtdXFEeXVnRRAB",
        "reviewer": {
          "profile_photo_url": "https://lh3.googleusercontent.com/local-reviews/AJMZ0QchZeuqqdsc2mxTzAL46o1Zp-eQpx0fXItgIlFx_-eADsDQzpyjY9GuirM6XH9EgCdepg=s120-c-br100",
          "display_name": "dennisdel",
          "link": "https://www.tripadvisor.com/ShowUserReviews-g60763-d611947-r1046213388?m=68573&staydates=2026_03_08_2026_03_09&uguests=1_2_0&supdv=desktop&supuc=EG&supul=en"
        },
        "link": "https://www.tripadvisor.com/ShowUserReviews-g60763-d611947-r1046213388?m=68573&staydates=2026_03_08_2026_03_09&uguests=1_2_0&supdv=desktop&supuc=EG&supul=en",
        "source": "Tripadvisor",
        "source_logo": "https://www.gstatic.com/travel-hotels/branding/icon_100532569.png",
        "rating": "5/5",
        "created": "a month ago",
        "comment": "Mei at the front desk was the friendliest, most helpful person I’ve ever met who works at a Hilton Hotel!"
      },
      {
        "review_id": "ChZDSUhNMG9nS0VPYS16UFdEX0liYmZ3EAE",
        "reviewer": {
          "profile_photo_url": "https://lh3.googleusercontent.com/local-reviews/AJMZ0QdHDxxyBDO6igPA51sqxYAI1TTeuGvapT1sWSCJfPSgzOZltNlMhWmUDpj2A3v7zAw89g=s120-c-br100",
          "display_name": "GlobalCitizen426",
          "link": "https://www.tripadvisor.com/ShowUserReviews-g60763-d611947-r1046073220?m=68573&staydates=2026_03_08_2026_03_09&uguests=1_2_0&supdv=desktop&supuc=EG&supul=en"
        },
        "link": "https://www.tripadvisor.com/ShowUserReviews-g60763-d611947-r1046073220?m=68573&staydates=2026_03_08_2026_03_09&uguests=1_2_0&supdv=desktop&supuc=EG&supul=en",
        "source": "Tripadvisor",
        "source_logo": "https://www.gstatic.com/travel-hotels/branding/icon_100532569.png",
        "rating": "2/5",
        "created": "a month ago",
        "comment": "We've been visiting the city every year for 25 years for a conference. |In the past 5 years since we've all come back to our lives post Covid pandemic, it's just got worse at this property.||We travel extensively and while other properties around the country seem to be making improvements this property just gets worse.||Hey, Hilton - it's time for a renovation and you should get after it!  |You have the finances, so you should not delay this another year.||The housekeeping and customer service staff were 5 star!||This year we were not able to control our room thermostat - to run the AC, b/c wen we arrived it was sweltering hot in parts of the hotel b/c the outside temps were not that cold. We heard others complaining about the same.|The room thermostat stayed at 72-73 the entire time - with the windows cracked, which I've appreciated this feature at this hotel.|72 or 73 may work for some ppl in their homes,  but not in a high rise hotel.||The elevator system was new and completely inefficient - we were riding the service elevator most of the time.||If you're reading this Hilton, room 2737 needs a new bathroom door - there was obviously a water issue in the bathroom and the wood composite was buckling and coming through on the bottom of the door. The wallpaper was peeling and the tub and sink were both very old and worn, there black mold on the shower and sink."
      },
      {
        "review_id": "ChdDSUhNMG9nS0VKNndnb3FIa3N5d3J3RRAB",
        "reviewer": {
          "profile_photo_url": "https://lh3.googleusercontent.com/local-reviews/AJMZ0QdCjMUwIiBikRhCLHgN_0vyGAo1GvT8DEukiKQb1ujC_eFsFjYrQ0OvLoSxPtqmCdgvFA=s120-c-br100",
          "display_name": "KimmyStephenson",
          "link": "https://www.tripadvisor.com/ShowUserReviews-g60763-d611947-r1045867123?m=68573&staydates=2026_03_08_2026_03_09&uguests=1_2_0&supdv=desktop&supuc=EG&supul=en"
        },
        "link": "https://www.tripadvisor.com/ShowUserReviews-g60763-d611947-r1045867123?m=68573&staydates=2026_03_08_2026_03_09&uguests=1_2_0&supdv=desktop&supuc=EG&supul=en",
        "source": "Tripadvisor",
        "source_logo": "https://www.gstatic.com/travel-hotels/branding/icon_100532569.png",
        "rating": "3/5",
        "created": "a month ago",
        "comment": "Hgv owners reception not helpful and rooms not ready for 2hours after check in time  and a 35 minute wait for elevator at busy times"
      },
      {
        "review_id": "ChZDSUhNMG9nS0VKUHY3SWZTeWUtQll3EAE",
        "reviewer": {
          "profile_photo_url": "https://lh3.googleusercontent.com/local-reviews/AJMZ0Qczn4VDfUM6-AtEt-6oaNazFa-i9Fy6kqPVfGIlPil6vJulEYyK8t930jZwOW4hD80mzw=s120-c-br100",
          "display_name": "Drinehart",
          "link": "https://www.tripadvisor.com/ShowUserReviews-g60763-d611947-r1045764208?m=68573&staydates=2026_03_08_2026_03_09&uguests=1_2_0&supdv=desktop&supuc=EG&supul=en"
        },
        "link": "https://www.tripadvisor.com/ShowUserReviews-g60763-d611947-r1045764208?m=68573&staydates=2026_03_08_2026_03_09&uguests=1_2_0&supdv=desktop&supuc=EG&supul=en",
        "source": "Tripadvisor",
        "source_logo": "https://www.gstatic.com/travel-hotels/branding/icon_100532569.png",
        "rating": "5/5",
        "created": "a month ago",
        "comment": "Check-in was easy and staff were friendly. They were very accommodating, clean rooms and the location was perfect. We had a great trip."
      },
      {
        "review_id": "ChdDSUhNMG9nS0VPTEVnZi1EbnI2VW5RRRAB",
        "reviewer": {
          "profile_photo_url": "https://lh3.googleusercontent.com/local-reviews/AJMZ0Qc_hSEOVyYt90T8jEI1lbdGPaVqSrwdtGLOma43xF2tT-AGCQEDWJCQ3qq81gsm_HjiWg=s120-c-br100",
          "display_name": "Y2952BWaprilg",
          "link": "https://www.tripadvisor.com/ShowUserReviews-g60763-d611947-r1045763042?m=68573&staydates=2026_03_08_2026_03_09&uguests=1_2_0&supdv=desktop&supuc=EG&supul=en"
        },
        "link": "https://www.tripadvisor.com/ShowUserReviews-g60763-d611947-r1045763042?m=68573&staydates=2026_03_08_2026_03_09&uguests=1_2_0&supdv=desktop&supuc=EG&supul=en",
        "source": "Tripadvisor",
        "source_logo": "https://www.gstatic.com/travel-hotels/branding/icon_100532569.png",
        "rating": "5/5",
        "created": "a month ago",
        "comment": "Hanna and Jesús were great- appreciate their humanity and gracious attitudes when I needed help pushing past a bureaucratic bottleneck"
      },
      {
        "review_id": "ChdDSUhNMG9nS0VKeTJ0di1zNGFpLXF3RRAB",
        "reviewer": {
          "profile_photo_url": "https://lh3.googleusercontent.com/local-reviews/AJMZ0Qczn4VDfUM6-AtEt-6oaNazFa-i9Fy6kqPVfGIlPil6vJulEYyK8t930jZwOW4hD80mzw=s120-c-br100",
          "display_name": "DLSharpsteen",
          "link": "https://www.tripadvisor.com/ShowUserReviews-g60763-d611947-r1045281816?m=68573&staydates=2026_03_08_2026_03_09&uguests=1_2_0&supdv=desktop&supuc=EG&supul=en"
        },
        "link": "https://www.tripadvisor.com/ShowUserReviews-g60763-d611947-r1045281816?m=68573&staydates=2026_03_08_2026_03_09&uguests=1_2_0&supdv=desktop&supuc=EG&supul=en",
        "source": "Tripadvisor",
        "source_logo": "https://www.gstatic.com/travel-hotels/branding/icon_100532569.png",
        "rating": "5/5",
        "created": "a month ago",
        "comment": "We traveled to NYC to watch The Christmas Spectacular at the Radio City Music Hall and stayed at the Hilton for the night. We loved the location as it was within of 5 minute walking distance of literally everything there is to see at Christmas time. Our room was quite spacious and clean with two full beds and a nice view. Staff was friendly and I loved that you can get there early and check in your bags so you can go explore before check in time as we arrived to the city around noon. Also loved that there was parking on site. We used the valet so you pulled in, got everything out you would need, they give you a card with a number and you walk into the doors and right to the luggage storage area. The elevator system is insane and that's my only complaint. I've never stayed in a hotel where you have to put in your room number and can only ride a certain elevator to your room. Seemed our elevators were always the ones with tons of people waiting to get on or off. The only outside noise you could hear were horns, but I was ok with that and thankful I never heard my neighbors or anyone in the halls. I got an insane discount on my room through my employer otherwise I would never be able to stay here during Christmastime. But I understand why the rate is so high as it is a hotel that sits in the middle of all the amazing attractions NYC has to offer. Would definitely stay here again!"
      },
      {
        "review_id": "ChZDSUhNMG9nS0VKdXluNURVNjR1UWJnEAE",
        "reviewer": {
          "profile_photo_url": "https://lh3.googleusercontent.com/local-reviews/AJMZ0QdVsxDWqDDLG62Q3M3dmLlHORJs5jz0NWRJO3cP21KtRNPfosO7RpofjnbUgpyNjOTDew=s120-c-br100",
          "display_name": "LisaO964",
          "link": "https://www.tripadvisor.com/ShowUserReviews-g60763-d611947-r1045294524?m=68573&staydates=2026_03_08_2026_03_09&uguests=1_2_0&supdv=desktop&supuc=EG&supul=en"
        },
        "link": "https://www.tripadvisor.com/ShowUserReviews-g60763-d611947-r1045294524?m=68573&staydates=2026_03_08_2026_03_09&uguests=1_2_0&supdv=desktop&supuc=EG&supul=en",
        "source": "Tripadvisor",
        "source_logo": "https://www.gstatic.com/travel-hotels/branding/icon_100532569.png",
        "rating": "4/5",
        "created": "a month ago",
        "comment": "Spent 6 nights here with my family- arrives 9.45pm due to flight delay but on arrival rooms were not ready, the gentleman at check in was helpful and found us a room however it was interconnecting with another family which meant we were disturbed by their noise quite a lot. However, this hotel is really lovely and other than this and the elevators being slow I can’t fault it. They have installed a new elevator system and should have thought it through as during busy times they are packed and it can take quite some time to get one. |Rooms are lovely , cleaned every day, excellent location and staff all really lovely. I would recommend staying here."
      },
      {
        "review_id": "ChZDSUhNMG9nS0VPM084Tl9JazlHa0J3EAE",
        "reviewer": {
          "profile_photo_url": "https://lh3.googleusercontent.com/local-reviews/AJMZ0QfzjVLsS8e-67WTk0n2dtmoLvjFzQd1pnSZl8AzVxF0EXF41tQWWb2Gu3UnsT1rmBrWdQ=s120-c-br100",
          "display_name": "paultW1290QF",
          "link": "https://www.tripadvisor.com/ShowUserReviews-g60763-d611947-r1045304354?m=68573&staydates=2026_03_08_2026_03_09&uguests=1_2_0&supdv=desktop&supuc=EG&supul=en"
        },
        "link": "https://www.tripadvisor.com/ShowUserReviews-g60763-d611947-r1045304354?m=68573&staydates=2026_03_08_2026_03_09&uguests=1_2_0&supdv=desktop&supuc=EG&supul=en",
        "source": "Tripadvisor",
        "source_logo": "https://www.gstatic.com/travel-hotels/branding/icon_100532569.png",
        "rating": "5/5",
        "created": "a month ago",
        "comment": "Luis M was the best person ever!|He took care of us like we were family!|He made our special trip. Fantastic!|My wife and I came into the city for the holiday weekend! Luis was able to navigate and inform us with what to do.|He made the accommodations just perfect!"
      },
      {
        "review_id": "ChdDSUhNMG9nS0VQZkNuSlc0X3ZMdDRBRRAB",
        "reviewer": {
          "profile_photo_url": "https://lh3.googleusercontent.com/local-reviews/AJMZ0QfP3vr22Hqep_LgQRKpenb6hspMso2yBvcYnK0_hQDygjr_RJAumA99e80czV94otF4IDs=s120-c-br100",
          "display_name": "\"\"",
          "link": "http://www.priceline.com/r/?channel=meta&product=hotel&theme=reviews&refid=PLGOOGLEHARV&refclickid=HARV_39532&hotel_id=39532"
        },
        "link": "http://www.priceline.com/r/?channel=meta&product=hotel&theme=reviews&refid=PLGOOGLEHARV&refclickid=HARV_39532&hotel_id=39532",
        "source": "Priceline",
        "source_logo": "https://www.gstatic.com/travel-hotels/branding/icon_220.png",
        "rating": "7/10",
        "created": "a month ago",
        "comment": "Positive: Convenient location. Negative: The elevator wait times/ lines could be very long. The room was cold and we couldn’t control the temperature which is particularly difficult to come back to after a day outside in the winter."
      }
    ]
  }
  ```
</ResponseExample>


# Google Reviews text search
Source: https://docs.brightdata.com/api-reference/serp/google-reviews/text-search

Configure the Bright Data Google Reviews Google Reviews text search parameter to refine queries and return matching results as JSON or HTML. On port 44445.

```txt wrap theme={null}
https://www.google.com/reviews?fid=0x89c25855c0679529:0x2a34371cb33f3c80
```

## Parameters

<ParamField type="string">
  Feature id what you want to fetch reviews to. `fid` parameter can be found in `knowledge.fid` field of google search response.

  ```txt wrap theme={null}
  https://www.google.com/reviews?fid=0x89c25855c0679529:0x2a34371cb33f3c80
  ```
</ParamField>

<RequestExample>
  ```shell cURL highlight={6} theme={null}
    curl -X POST https://api.brightdata.com/request \
    --header "Content-Type: application/json" \
    --header "Authorization: Bearer API_KEY" \
    --data '{
      "zone": "serp_api1",
      "url": "https://www.google.com/reviews?fid=0x89c25855c0679529:0x2a34371cb33f3c80",
      "format": "raw"
    }'
  ```

  ```shell Native proxy highlight={4} theme={null}
  curl --proxy brd.superproxy.io:44445 \
    --proxy-user CUSTOMER_USERNAME:CUSTOMER_PASSWORD \
    --ssl-no-revoke \
    "https://www.google.com/reviews?fid=0x89c25855c0679529:0x2a34371cb33f3c80"
  ```

  ```js Node.js highlight={10} theme={null}
  (async () => {
    const response = await fetch('https://api.brightdata.com/request', {
      method: 'POST',
      headers: {
        'Content-Type': 'application/json',
        'Authorization': 'Bearer API_KEY'
      },
      body: JSON.stringify({
        zone: 'serp_api1',
        url: 'https://www.google.com/reviews?fid=0x89c25855c0679529:0x2a34371cb33f3c80',
        format: 'raw'
      })
    });
    
    const data = await response.text();
    console.log(data);
  })();
  ```

  ```python Python highlight={11} theme={null}
  import requests

  # API Configuration
  headers = {
      'Content-Type': 'application/json',
      'Authorization': 'Bearer API_KEY',
  }

  payload = {
      'zone': 'serp_api1',
      'url': 'https://www.google.com/reviews?fid=0x89c25855c0679529:0x2a34371cb33f3c80',
      'format': 'raw'
  }

  # Make the request
  response = requests.post(
      'https://api.brightdata.com/request', 
      json=payload, 
      headers=headers
  )

  print(response.text)
  ```
</RequestExample>

<ResponseExample>
  ```json 200 theme={null}
  {
    "reviews": [
      {
        "review_id": "ChdDSUhNMG9nS0VKeTJ0di1zNGFpLXF3RRAB",
        "reviewer": {
          "profile_photo_url": "https://lh3.googleusercontent.com/local-reviews/AJMZ0Qczn4VDfUM6-AtEt-6oaNazFa-i9Fy6kqPVfGIlPil6vJulEYyK8t930jZwOW4hD80mzw=s120-c-br100",
          "display_name": "DLSharpsteen",
          "link": "https://www.tripadvisor.com/ShowUserReviews-g60763-d611947-r1045281816?m=68573&staydates=2026_03_08_2026_03_09&uguests=1_2_0&supdv=desktop&supuc=BF&supul=en"
        },
        "link": "https://www.tripadvisor.com/ShowUserReviews-g60763-d611947-r1045281816?m=68573&staydates=2026_03_08_2026_03_09&uguests=1_2_0&supdv=desktop&supuc=BF&supul=en",
        "source": "Tripadvisor",
        "source_logo": "https://www.gstatic.com/travel-hotels/branding/icon_100532569.png",
        "rating": "5/5",
        "created": "a month ago",
        "comment": "We traveled to NYC to watch The Christmas Spectacular at the Radio City Music Hall and stayed at the Hilton for the night. We loved the location as it was within of 5 minute walking distance of literally everything there is to see at Christmas time. Our room was quite spacious and clean with two full beds and a nice view. Staff was friendly and I loved that you can get there early and check in your bags so you can go explore before check in time as we arrived to the city around noon. Also loved that there was parking on site. We used the valet so you pulled in, got everything out you would need, they give you a card with a number and you walk into the doors and right to the luggage storage area. The elevator system is insane and that's my only complaint. I've never stayed in a hotel where you have to put in your room number and can only ride a certain elevator to your room. Seemed our elevators were always the ones with tons of people waiting to get on or off. The only outside noise you could hear were horns, but I was ok with that and thankful I never heard my neighbors or anyone in the halls. I got an insane discount on my room through my employer otherwise I would never be able to stay here during Christmastime. But I understand why the rate is so high as it is a hotel that sits in the middle of all the amazing attractions NYC has to offer. Would definitely stay here again!"
      },
      {
        "review_id": "Ci9DQUlRQUNvZENodHljRjlvT2tRNFRVOXVUVE51YXpKVVdHb3laV3R5TjNScmRuYxAB",
        "reviewer": {
          "profile_photo_url": "https://lh3.googleusercontent.com/a-/ALV-UjXfHOWf_k3xFLr7N87GuvjsQHzsDSZb3FW1zjSl6LV32uKV4qI=s120-c-rp-mo-ba4-br100",
          "display_name": "Brian Ash",
          "link": "https://www.google.com/maps/contrib/109749787540014073287?hl=en"
        },
        "link": "https://www.google.com/maps/reviews/data=!4m8!14m7!1m6!2m5!1sCi9DQUlRQUNvZENodHljRjlvT2tRNFRVOXVUVE51YXpKVVdHb3laV3R5TjNScmRuYxAB!2m1!1s0x0:0x2a34371cb33f3c80!3m1!1s2@1:CAIQACodChtycF9oOkQ4TU9uTTNuazJUWGoyZWtyN3Rrdnc%7C0dK0Oisp5f4%7C?hl=en",
        "source": "Google",
        "source_logo": "https://www.gstatic.com/images/branding/product/1x/googleg_48dp.png",
        "rating": "4/5",
        "created": "a month ago",
        "date": "2025-12-30",
        "comment": "The staff here were friendly and helpful. Everyone was cheerful and considerate. The staff here made our experience pleasant and memorable. The rooms were nice, but the location is perfect if you want to be in thick of the hustle and bustle of the city. Conveniently located, great facilities and a room rate that won’t break the bank. I wouldn’t hesitate to book again.",
        "review_reply": "Dear Brian,\nThank you for the wonderful review. We are glad to hear our team’s friendliness and positive energy helped make your stay pleasant and memorable. It is great to know you enjoyed the room, facilities, and our convenient location, along with a rate that added value to your visit. We truly appreciate your recommendation and look forward to welcoming you back again.\n\nSincerely,\n\nNew York Hilton Midtown Team\n\nNYCNH_FO@hilton.com",
        "review_reply_created": "a month ago",
        "photos": [
          "https://lh3.googleusercontent.com/geougc-cs/ABOP9psEgneI8FIdEeGP0U0DKFzwPjUbeMcfWkr7I6LvoCMXzPz_f8qvhEnl6IrGg73jlvLo1xOLrtjDLM7BY9doDWY9GddvM4JckW6EY8Bi5-GN7IzokII2PtHT99mWEr3bEWjh0RBhA7KKeVk",
          "https://lh3.googleusercontent.com/geougc-cs/ABOP9psP7Yx2Swd3UOEIevzruzpKAerYUdMJPXETQJt-A3SrKXcnHP4Cy0TLirJExW50cQ_kzoUUnZLHzfu-tUwtz_Kp_4yUSeqjo4Tm-BK1z9D6CmokJrkvo9QCtYAG7hjERaHOzibyBzSLaHlz",
          "https://lh3.googleusercontent.com/geougc-cs/ABOP9pun-0zZPPEzWSkW_XUq8eHQSze3imSI7iMEq9_29WwJJdM82HBq3LwycenRdrTRIt70jyr3jPd4kiIABo-GdwhMJ6jd3QbOjrBuq4xfzs9OPPW_DEu52MrDQK0MnY8vgRQG8wfId5sLZtau",
          "https://lh3.googleusercontent.com/geougc-cs/ABOP9pvs0bS1DXsAMv1l2rUc2o5O3r07JiEVr2mXuo8_HxN-e47l0YqBxSfHQCGATeYbu059C-Gh9Om5nIuuoXGKbx-VqSFcovQuuboYcXxg9r4AOkj8y_1Atv5LieCvzZNjKt2lP_EIFUmpNIzv",
          "https://lh3.googleusercontent.com/geougc-cs/ABOP9pvGyxLHYBHrq2Xjc1_XkBMitY3PltgQXVrpUHliY22qm1juTnbcQM9Dppxgbb-YeCgQjzlWuEHfe22uXMf2LyAtWpiNnKrN62zNG5SeDhCZiGYwMDpp6TLNTVPWGcJgeTH7ozM12r70coMx",
          "https://lh3.googleusercontent.com/geougc-cs/ABOP9ptnOwAnTti7y3hrhxJ7TVOyrr9FmaGP1YvVDgo5ca-Mokl4thE-Ds1t9oaM_v6ofHs6MheZ1g02rNAsUlQqc0dRArJXKwYp8JAwhFQPOz0Cel9gu645rgw4O26EzLm1PkYHwzci7D_Wewdf",
          "https://lh3.googleusercontent.com/geougc-cs/ABOP9pu4U-BFG3nJCIUa3yMRZFr2NWas-3A1PUlCsROljZC05rtJhDHjDqd50W5ucTMpu8ywsM7yFNZLywcjhgKaXWqWsIHQtWJdOhAnQlsaq30fmt-3NNu3FISJ1wB1p-TvteQ-A3kcyAVZlkHb",
          "https://lh3.googleusercontent.com/geougc-cs/ABOP9pu8TqvQu_MO3rNMEH_5qVZ5fUYMHgVnS4PWsnKI2EVxPvBBiRZuwVhJLUZfKGxS6mnZMMKRfJB5KYlk2T7eZ1fNk6wqqGENrmoaYnGdqMcQm3CaV2OKSbYMAEcZRGstJI13u37JVn6_dsjI"
        ],
        "details": [
          {
            "id": "HOTELS_PILOT_TRIP_TYPE",
            "name": "Trip type",
            "value": "Vacation",
            "description": "What kind of trip was it?"
          },
          {
            "id": "HOTELS_PILOT_TRAVEL_GROUP_TYPE",
            "name": "Travel group",
            "value": "Couple",
            "description": "Who did you travel with?"
          },
          {
            "id": "HOTELS_ASPECT_ROOMS",
            "name": "Rooms",
            "value": 3,
            "description": "Rooms"
          },
          {
            "id": "HOTELS_ASPECT_SERVICES",
            "name": "Service",
            "value": 4,
            "description": "Service"
          },
          {
            "id": "HOTELS_ASPECT_LOCATION",
            "name": "Location",
            "value": 5,
            "description": "Location"
          },
          {
            "id": "HOTELS_VIBE",
            "name": "Hotel highlights",
            "value": "Great view",
            "description": "How would you describe the hotel?"
          }
        ]
      },
      {
        "review_id": "Ci9DQUlRQUNvZENodHljRjlvT2t0eVMzWjJjbk5tUWt0TGFFcG5kVU5XWTFvMGQwRRAB",
        "reviewer": {
          "profile_photo_url": "https://lh3.googleusercontent.com/a/ACg8ocIb_1I5stFL2E46ANU5a9D1tE37bd7z3TrcvcjeCv8jbP01sQ=s120-c-rp-mo-ba4-br100",
          "display_name": "Diana Nichols",
          "link": "https://www.google.com/maps/contrib/104268723670363283044?hl=en"
        },
        "link": "https://www.google.com/maps/reviews/data=!4m8!14m7!1m6!2m5!1sCi9DQUlRQUNvZENodHljRjlvT2t0eVMzWjJjbk5tUWt0TGFFcG5kVU5XWTFvMGQwRRAB!2m1!1s0x0:0x2a34371cb33f3c80!3m1!1s2@1:CAIQACodChtycF9oOktyS3Z2cnNmQktLaEpndUNWY1o0d0E%7C0dKeRXjPbb4%7C?hl=en",
        "source": "Google",
        "source_logo": "https://www.gstatic.com/images/branding/product/1x/googleg_48dp.png",
        "rating": "5/5",
        "created": "a month ago",
        "comment": "Absolutely the best stay in the world! My room was clean and quiet and had everything I needed. The room was much bigger than I expected for NYC. Shout out to housekeeping who didn’t make a peep in the hallways as they cleaned the vacant rooms. I didn’t leave until around 2pm so they were working hard. Many hotels (even the best of the best) have housekeepers who talk too loudly in the hallways and constantly slam doors. Not here! They were perfect and I didn’t even know they were there until I left. Can’t tell you how much I appreciate that. Tons of security and police presence for the upcoming celebration (New Year’s) or maybe it’s always like that here. Felt extremely safe and protected. Beautiful spacious clean sparkling lobby. Many upscale shops and stores I didn’t have time to visit. Glistening with inviting items to purchase and view. Wish I would have gone into the shops! The staff was very very friendly from the front desk to the security guard who answered all my questions last night about transportation to JFK and local things to visit near the hotel. The man mopping the floor was super friendly (this was around 1am) trying to give me directions for the subway train etc for the next day to JFK. I had the best latte from the wonderful friendly cafe near the lobby. Everything clean and welcoming and beautifully displayed. I decided to take a taxi to JFK\nand asked for a “nice” taxi driver. The gentleman supervising the taxi line immediately made way for me through the throngs of folks on the street and treated me like a celebrity as he directed me to the next available ride. He didn’t laugh at me and I did get the nicest taxi driver - Fabian!!!  I was given excellent directions to get to the airport in JFK by the transportation and show tickets desk and they explained how to take the train bus subway etc but it seemed a little more difficult than I was in the mood for. The energy out on the street was electric and I also wish I had walked around a little before I left the city. This hotel is convenient to everything! Can’t ask for anything more than the wonderful experience I had at this hotel. Thank you everyone who works there and outside and Happy New Year!!!",
        "review_reply": "Dear Diana,\nIt's an absolute pleasure to learn about the exceptional visit you had with us, and we thank you for your perfect marks. Thank you for also going out of your way to spotlight our safe, welcoming facilities and unbeatable New York location. Of course, we'll be sure our team hears they really made a difference with their outstanding service, and we look forward to seeing you again soon here at New York Hilton Midtown for another unforgettable experience.\n\nSincerely,\n\nNew York Hilton Midtown Team\n\nNYCNH_FO@hilton.com",
        "review_reply_created": "a month ago",
        "details": [
          {
            "id": "HOTELS_PILOT_TRIP_TYPE",
            "name": "Trip type",
            "value": "Business",
            "description": "What kind of trip was it?"
          },
          {
            "id": "HOTELS_PILOT_TRAVEL_GROUP_TYPE",
            "name": "Travel group",
            "value": "Solo",
            "description": "Who did you travel with?"
          },
          {
            "id": "HOTELS_ASPECT_ROOMS",
            "name": "Rooms",
            "value": 5,
            "description": "Rooms"
          },
          {
            "id": "HOTELS_ASPECT_SERVICES",
            "name": "Service",
            "value": 5,
            "description": "Service"
          },
          {
            "id": "HOTELS_ASPECT_LOCATION",
            "name": "Location",
            "value": 5,
            "description": "Location"
          },
          {
            "id": "HOTELS_TIPS_TOPICS_ROOMS",
            "name": "Rooms",
            "value": "My room was perfect and bigger than I expected for NYC.",
            "description": "Rooms"
          },
          {
            "id": "HOTELS_TIPS_TOPICS_SAFETY",
            "name": "Safety",
            "value": "Lots of police officers around! Felt extremely safe.",
            "description": "Safety"
          },
          {
            "id": "HOTELS_TIPS_TOPICS_NOTEWORTHY_DETAILS",
            "name": "Noteworthy details",
            "value": "I just found everyone super friendly. Maybe because I love the people and the energy in NYC anyway.",
            "description": "Noteworthy details"
          },
          {
            "id": "HOTELS_VIBE",
            "name": "Hotel highlights",
            "value": "Luxury",
            "description": "How would you describe the hotel?"
          }
        ]
      },
      {
        "review_id": "Ci9DQUlRQUNvZENodHljRjlvT25ReVRFUTJiV0ZNUkdVNFduaFNTMnh6VmpGSU5uYxAB",
        "reviewer": {
          "profile_photo_url": "https://lh3.googleusercontent.com/a-/ALV-UjXmcoJ3y3xhQX30wsKy5q87OD7qFUR6FDUsw_QDL8EWl8-nUSQ=s120-c-rp-mo-ba3-br100",
          "display_name": "Natiesha Wray Henry",
          "link": "https://www.google.com/maps/contrib/102270227746850983681?hl=en"
        },
        "link": "https://www.google.com/maps/reviews/data=!4m8!14m7!1m6!2m5!1sCi9DQUlRQUNvZENodHljRjlvT25ReVRFUTJiV0ZNUkdVNFduaFNTMnh6VmpGSU5uYxAB!2m1!1s0x0:0x2a34371cb33f3c80!3m1!1s2@1:CAIQACodChtycF9oOnQyTEQ2bWFMRGU4WnhSS2xzVjFINnc%7C0dKxrV3ZLWB%7C?hl=en",
        "source": "Google",
        "source_logo": "https://www.gstatic.com/images/branding/product/1x/googleg_48dp.png",
        "rating": "5/5",
        "created": "a month ago",
        "comment": "Location, Location,  Location! This hotel made adventuring in Manhattan a breeze. Central Park, Radio City, Rockefeller Center, were all so close, there was simply no excuse to not take a walk and be in all the action. We loved to food trucks and vendors near by but we also enjoyed the walkable restaurants close by as well. Staff and facilities were great. I'm so happy we stayed here.",
        "review_reply": "Dear Natiesha,\nThank you for sharing your wonderful experience with us! It's great that our prime location, close to New York's best attractions and dining options, enhanced your visit. We're also happy that our friendly service added to your experience. It was a pleasure having you as our guest, and we look forward to welcoming you back for another memorable stay.\n\nSincerely,\n\nNew York Hilton Midtown Team\n\nNYCNH_FO@hilton.com",
        "review_reply_created": "a month ago",
        "details": [
          {
            "id": "HOTELS_PILOT_TRIP_TYPE",
            "name": "Trip type",
            "value": "Vacation",
            "description": "What kind of trip was it?"
          },
          {
            "id": "HOTELS_PILOT_TRAVEL_GROUP_TYPE",
            "name": "Travel group",
            "value": "Family",
            "description": "Who did you travel with?"
          },
          {
            "id": "HOTELS_ASPECT_ROOMS",
            "name": "Rooms",
            "value": 5,
            "description": "Rooms"
          },
          {
            "id": "HOTELS_ASPECT_SERVICES",
            "name": "Service",
            "value": 5,
            "description": "Service"
          },
          {
            "id": "HOTELS_ASPECT_LOCATION",
            "name": "Location",
            "value": 5,
            "description": "Location"
          },
          {
            "id": "HOTELS_TIPS_TOPICS_ROOMS",
            "name": "Rooms",
            "value": "Cozy and comfortable",
            "description": "Rooms"
          },
          {
            "id": "HOTELS_TIPS_TOPICS_NEARBY_ACTIVITIES",
            "name": "Nearby activities",
            "value": "Times Square is walkable from here",
            "description": "Nearby activities"
          },
          {
            "id": "HOTELS_TIPS_TOPICS_WALKABILITY",
            "name": "Walkability",
            "value": "10 out of 10",
            "description": "Walkability"
          },
          {
            "id": "HOTELS_TIPS_TOPICS_NOTEWORTHY_DETAILS",
            "name": "Noteworthy details",
            "value": "Parking and traffic is a nightmare.",
            "description": "Noteworthy details"
          },
          {
            "id": "HOTELS_VIBE",
            "name": "Hotel highlights",
            "value": "Kid-friendly",
            "description": "How would you describe the hotel?"
          }
        ]
      },
      {
        "review_id": "ChdDSUhNMG9nS0VQdnIyOHU1LVppVGlBRRAB",
        "reviewer": {
          "profile_photo_url": "https://lh3.googleusercontent.com/local-reviews/AJMZ0QfnSFWXMd1oJu73a6IhdtgibYcjse2HKQTHeghNQd9Cyw8DYQQJZDCyh-TD68ehXuY-FA=s120-c-br100",
          "display_name": "R471LZalext",
          "link": "https://www.tripadvisor.com/ShowUserReviews-g60763-d1379306-r1043196288?m=68573&staydates=2026_03_08_2026_03_09&uguests=1_2_0&supdv=desktop&supuc=BF&supul=en"
        },
        "link": "https://www.tripadvisor.com/ShowUserReviews-g60763-d1379306-r1043196288?m=68573&staydates=2026_03_08_2026_03_09&uguests=1_2_0&supdv=desktop&supuc=BF&supul=en",
        "source": "Tripadvisor",
        "source_logo": "https://www.gstatic.com/travel-hotels/branding/icon_100532569.png",
        "rating": "3/5",
        "created": "2 months ago",
        "comment": "Room was ok. For a Hilton I thought it would be better. Could do with an update with better placed plug sockets and some USB sockets. It is 2025 and people need multiple sockets to charge phones, tablets, watches etc.||Staff were underwhelming. Our flight home was cancelled and we had to find accommodation for another night. I understand they couldn’t accept us as they were fully booked. I would have appreciated some sort of effort to see if other Hilton hotels available but no, just a shrug of the shoulders pretty much and left to sort ourselves out. I understand that it is probably over there pay grade. However, a phone call or some sort of contact with other Hilton hotels would have been put our anxiety at ease. I am disappointed because i expect staff from the Hilton brand would excel at customer service, but they didn’t. They would’ve earned a decent tip from it. ||Only 2 things impressed me. The coffee machine in our room and the cleaning staff. They always did a superb job."
      },
      {
        "review_id": "Ci9DQUlRQUNvZENodHljRjlvT2pKdk5FdHVMVW8xTjFoT2MzUjJlamQyV0hSTk4wRRAB",
        "reviewer": {
          "profile_photo_url": "https://lh3.googleusercontent.com/a/ACg8ocKxAYr7LFV6ZMNckj3q8VKiPdMIZXgCzt920CSu2v1nYG3GzQ=s120-c-rp-mo-ba4-br100",
          "display_name": "Elia Alejandra",
          "link": "https://www.google.com/maps/contrib/107082141027365570078?hl=en"
        },
        "link": "https://www.google.com/maps/reviews/data=!4m8!14m7!1m6!2m5!1sCi9DQUlRQUNvZENodHljRjlvT2pKdk5FdHVMVW8xTjFoT2MzUjJlamQyV0hSTk4wRRAB!2m1!1s0x0:0x2a34371cb33f3c80!3m1!1s2@1:CAIQACodChtycF9oOjJvNEtuLUo1N1hOc3R2ejd2WHRNN0E%7C0d6T99EL24S%7C?hl=en",
        "source": "Google",
        "source_logo": "https://www.gstatic.com/images/branding/product/1x/googleg_48dp.png",
        "rating": "2/5",
        "created": "3 months ago",
        "comment": "Room had a nice view. Staff was friendly.\nRoom was dirty when we walked in. There were hairs in the bathtub, and sink wasn’t very clean. Restrooms and rooms along with furniture are very old! Bedsheets had some hairs and not very clean. Room was cleaned once out of 4 days so it’s not daily. They do give you a 35$ voucher for the cafe they have and 25$ for their services. Luggage hold is free if you get there early but they charge 5$ a piece if you need to check out of your room but still have time before the airport. Elevators are nice they have a system that makes it run smoother.\nHotel seems very central so that’s a good thing. Lots of things around but that’s just New York.\nOver all because of how old rooms seems and how dirty it was 2/5. Wouldn’t stay here again .",
        "review_reply": "Dear Elia,\nThank you for taking the time to share such detailed feedback. We’re glad to hear you enjoyed the wonderful view, the fantastic location, and the friendliness of the team, but we’re truly sorry to learn that the room did not meet expectations during your stay. Your comments about cleanliness, upkeep, and service frequency are important, and they’ll be shared with the appropriate teams so we can take a closer look. We appreciate you noting the helpful amenities like the café credit, services credit, luggage storage, and elevator system as well. We’re grateful for your perspective and hope the rest of your time in New York City was wonderful.\n\nSincerely,\n\nNew York Hilton Midtown Team\n\nNYCNH_FO@hilton.com",
        "review_reply_created": "3 months ago",
        "details": [
          {
            "id": "HOTELS_PILOT_TRIP_TYPE",
            "name": "Trip type",
            "value": "Vacation",
            "description": "What kind of trip was it?"
          },
          {
            "id": "HOTELS_PILOT_TRAVEL_GROUP_TYPE",
            "name": "Travel group",
            "value": "Family",
            "description": "Who did you travel with?"
          },
          {
            "id": "HOTELS_ASPECT_ROOMS",
            "name": "Rooms",
            "value": 1,
            "description": "Rooms"
          },
          {
            "id": "HOTELS_ASPECT_SERVICES",
            "name": "Service",
            "value": 3,
            "description": "Service"
          },
          {
            "id": "HOTELS_ASPECT_LOCATION",
            "name": "Location",
            "value": 4,
            "description": "Location"
          }
        ]
      },
      {
        "review_id": "Ci9DQUlRQUNvZENodHljRjlvT2xWbGRIaHFUblkzZFdaaFdITlNRMlZNZDE5bmNHYxAB",
        "reviewer": {
          "profile_photo_url": "https://lh3.googleusercontent.com/a-/ALV-UjUizL79_bwGWMDpI7JDM4zojb6e6Ufpryfw23XnFxFSFJMHriK_=s120-c-rp-mo-ba3-br100",
          "display_name": "Amanda Garcia",
          "link": "https://www.google.com/maps/contrib/102898602342998029792?hl=en"
        },
        "link": "https://www.google.com/maps/reviews/data=!4m8!14m7!1m6!2m5!1sCi9DQUlRQUNvZENodHljRjlvT2xWbGRIaHFUblkzZFdaaFdITlNRMlZNZDE5bmNHYxAB!2m1!1s0x0:0x2a34371cb33f3c80!3m1!1s2@1:CAIQACodChtycF9oOlVldHhqTnY3dWZhWHNSQ2VMd19ncGc%7C0dGM04hI_ys%7C?hl=en",
        "source": "Google",
        "source_logo": "https://www.gstatic.com/images/branding/product/1x/googleg_48dp.png",
        "rating": "5/5",
        "created": "2 months ago",
        "comment": "From the moment we arrived, our experience at this hotel was nothing short of exceptional. The property is beautiful, impeccably clean, and thoughtfully designed for comfort and relaxation. Every detail reflected true five-star quality.\nWhat truly made our stay unforgettable was the incredible staff. The team went above and beyond to make us feel welcomed and valued. Special recognition to Lek at concierge, Christina in housekeeping, Brian and Joland at front desk for their professionalism, warmth, and genuine care. Their attentiveness and willingness to assist with every request during our stay as we celebrate a birthday made a lasting impression.\nHousekeeping was flawless, the amenities were excellent, and the overall atmosphere was both luxurious and inviting. This hotel sets the standard for hospitality, and we cannot wait to return.\nHighly recommend to anyone looking for an outstanding stay! Location a huge plus.",
        "review_reply": "Dear Amanda,\nIt's an absolute pleasure to read about the exceptional celebration experience you had with us here at New York Hilton Midtown. Thank you for going out of your way to write about our gorgeous property, where comfort and charm come together perfectly, and we're delighted our team was able to make your experience that much more memorable. We'll be sure your thoughtful compliments are shared with them, and we hope to have the opportunity to welcome you back soon, whether for another special occasion or simply a relaxing New York getaway.\n\nSincerely,\n\nNew York Hilton Midtown Team\n\nNYCNH_FO@hilton.com",
        "review_reply_created": "2 months ago",
        "details": [
          {
            "id": "HOTELS_ASPECT_ROOMS",
            "name": "Rooms",
            "value": 5,
            "description": "Rooms"
          },
          {
            "id": "HOTELS_ASPECT_SERVICES",
            "name": "Service",
            "value": 5,
            "description": "Service"
          },
          {
            "id": "HOTELS_ASPECT_LOCATION",
            "name": "Location",
            "value": 5,
            "description": "Location"
          }
        ]
      },
      {
        "review_id": "ChZDSUhNMG9nS0VKdXluNURVNjR1UWJnEAE",
        "reviewer": {
          "profile_photo_url": "https://lh3.googleusercontent.com/local-reviews/AJMZ0QdVsxDWqDDLG62Q3M3dmLlHORJs5jz0NWRJO3cP21KtRNPfosO7RpofjnbUgpyNjOTDew=s120-c-br100",
          "display_name": "LisaO964",
          "link": "https://www.tripadvisor.com/ShowUserReviews-g60763-d611947-r1045294524?m=68573&staydates=2026_03_08_2026_03_09&uguests=1_2_0&supdv=desktop&supuc=BF&supul=en"
        },
        "link": "https://www.tripadvisor.com/ShowUserReviews-g60763-d611947-r1045294524?m=68573&staydates=2026_03_08_2026_03_09&uguests=1_2_0&supdv=desktop&supuc=BF&supul=en",
        "source": "Tripadvisor",
        "source_logo": "https://www.gstatic.com/travel-hotels/branding/icon_100532569.png",
        "rating": "4/5",
        "created": "a month ago",
        "comment": "Spent 6 nights here with my family- arrives 9.45pm due to flight delay but on arrival rooms were not ready, the gentleman at check in was helpful and found us a room however it was interconnecting with another family which meant we were disturbed by their noise quite a lot. However, this hotel is really lovely and other than this and the elevators being slow I can’t fault it. They have installed a new elevator system and should have thought it through as during busy times they are packed and it can take quite some time to get one. |Rooms are lovely , cleaned every day, excellent location and staff all really lovely. I would recommend staying here."
      },
      {
        "review_id": "ChdDSUhNMG9nS0VNT3NySlBUc01UbTZRRRAB",
        "reviewer": {
          "profile_photo_url": "https://lh3.googleusercontent.com/local-reviews/AJMZ0Qdvd3mFTmnQslJajBtyC7hGXBv5KKEN_7z5ZnXByEfDkAAFDmgEV3HW1P9_iXApXyf1XA=s120-c-br100",
          "display_name": "bobrobb",
          "link": "https://www.tripadvisor.com/ShowUserReviews-g60763-d611947-r1045071077?m=68573&staydates=2026_03_08_2026_03_09&uguests=1_2_0&supdv=desktop&supuc=BF&supul=en"
        },
        "link": "https://www.tripadvisor.com/ShowUserReviews-g60763-d611947-r1045071077?m=68573&staydates=2026_03_08_2026_03_09&uguests=1_2_0&supdv=desktop&supuc=BF&supul=en",
        "source": "Tripadvisor",
        "source_logo": "https://www.gstatic.com/travel-hotels/branding/icon_100532569.png",
        "rating": "2/5",
        "created": "a month ago",
        "comment": "On a positive, the location is excellent and the room was big enough for a family which I think is a rarity for such a location.  We visited from 30th Dec to 6th Jan and in all honesty the hotel is just not set up to be running at capacity.  There were queues for everything, check in, check out, restrooms, bars and the lifts.  The lifts deserve a special mention - if on a lower floor you might have to wait for 5 to 6 lifts to get one that had any capacity if heading down at a busy time.  The service at check in and check out was pretty non- existent, the $35 “destination charge” is to encourage you to spend in their bar.  If lucky enough to actually get served in the lobby bar 2 x beers is more than the $35 - it just leaves a bad taste.  There are no tea and coffee facilities in room (a given in UK), but on a positive note towels were changed daily.  When checking out this morning nobody asked us how our stay was, totally impersonal, then we got hit with the $5 per item holding fee, to hold our baggage from 12 noon to 2 pm - as we had 7 items (hand luggage also counts as a separate item) we got a $35 charge after checking out.  If anyone genuinely cared about customer experience, that would have been taken out of your destination charge, but of course that isn’t possible.    It is a shame really, a once grand hotel, living off the Hilton brand, in need of a refurb with a clear focus on revenue creation as opposed to customer experience.  The location just isn’t enough to make up for the lack of experience I’m afraid - there are much better out there."
      },
      {
        "review_id": "Ci9DQUlRQUNvZENodHljRjlvT2tObGJucGZObk5zTW01M1IzQXhkazgwUkZoclYzYxAB",
        "reviewer": {
          "profile_photo_url": "https://lh3.googleusercontent.com/a/ACg8ocJQgX50KQ8oURrMb8SgiRyqOysMS1rNXBa0wHN1BoF7o8ORvQ=s120-c-rp-mo-br100",
          "display_name": "Olaoluwa Ajilore",
          "link": "https://www.google.com/maps/contrib/115992020596208851571?hl=en"
        },
        "link": "https://www.google.com/maps/reviews/data=!4m8!14m7!1m6!2m5!1sCi9DQUlRQUNvZENodHljRjlvT2tObGJucGZObk5zTW01M1IzQXhkazgwUkZoclYzYxAB!2m1!1s0x0:0x2a34371cb33f3c80!3m1!1s2@1:CAIQACodChtycF9oOkNlbnpfNnNsMm53R3Axdk80RFhrV3c%7C0d3TryOnoQy%7C?hl=en",
        "source": "Google",
        "source_logo": "https://www.gstatic.com/images/branding/product/1x/googleg_48dp.png",
        "rating": "5/5",
        "created": "3 months ago",
        "comment": "I rarely write reviews, but I felt compelled to share my experience—especially because of the outstanding room service I’ve received. I’m currently staying here, and everything has been fantastic so far. What truly sets this place apart is the incredible housekeeping team on the 34th floor.\n\nThey are, without a doubt, the most attentive and genuinely kind crew I’ve encountered in any hotel across the country. Always cheerful, always ready to help—even when I’ve had the “Do Not Disturb” sign up, they’ve gone out of their way to check in if they see me in the hallway, just to make sure I don’t need anything. That level of care and consistency is rare, and it deserves to be celebrated.\n\nThey’re simply the best.",
        "review_reply": "Dear Olaoluwa,\nThank you for taking the time to share this, especially since you mentioned you rarely write reviews. It means even more to know you felt moved to speak about your stay while you’re still here with us. We're truly thrilled to hear how well everything has been going, and your kind words about our housekeeping team on the 34th floor mean the world. They take such pride in caring for our guests with thoughtfulness and genuine warmth, and it’s wonderful to know that their efforts have made such an impression. We'll be sure to share your message with them. I know it will brighten their day and remind them just how meaningful their care is. Thank you again for recognizing their hard work and spirit. We’re grateful to have you with us here at New York Hilton Midtown and are here for anything you may need for the rest of your visit. We hope the rest of your time with us continues to feel relaxing, comfortable, and well cared for!\n\nSincerely,\n\nNew York Hilton Midtown Team\n\nNYCNH_GM@hilton.com",
        "review_reply_created": "3 months ago",
        "details": [
          {
            "id": "HOTELS_ASPECT_ROOMS",
            "name": "Rooms",
            "value": 5,
            "description": "Rooms"
          },
          {
            "id": "HOTELS_ASPECT_SERVICES",
            "name": "Service",
            "value": 5,
            "description": "Service"
          },
          {
            "id": "HOTELS_ASPECT_LOCATION",
            "name": "Location",
            "value": 5,
            "description": "Location"
          },
          {
            "id": "HOTELS_TIPS_TOPICS_ROOMS",
            "name": "Rooms",
            "value": "perfect, nice view, great ambiance",
            "description": "Rooms"
          },
          {
            "id": "HOTELS_TIPS_TOPICS_NEARBY_ACTIVITIES",
            "name": "Nearby activities",
            "value": "Alot of activities",
            "description": "Nearby activities"
          }
        ]
      }
    ]
  }
  ```
</ResponseExample>


# AI overview
Source: https://docs.brightdata.com/api-reference/serp/google-search/ai-overview

Configure the Bright Data Google Search AI Overview parameter to refine queries and return matching results as JSON or HTML. On port 44445.

```http theme={null}
https://www.google.com/search?q=what+makes+the+best+pizza&brd_ai_overview=2
```

## Parameters

<ParamField type="string">
  The search query parameter. Specifies the keyword or phrase you want to search for on Google.
</ParamField>

<ParamField type="string">
  Setting `brd_ai_overview=2` will **increase** the likelihood of receiving Google's Generative AI Overviews in your SERP responses, typically appearing in \~15-20%+ of results.

  ```http theme={null}
  https://www.google.com/search?q=what+makes+the+best+pizza&brd_ai_overview=2
  ```

  <Note>
    * Expect an extra \~5-10 seconds of latency in SERP API’s response time with this query parameter, as it launches a browser to capture the entire AI Overview content.
    * To better trigger an AI Overview, your SERP keywords must be relevant to topics that Google considers suitable for generative responses.
  </Note>
</ParamField>

<RequestExample>
  ```shell cURL highlight={6} theme={null}
    curl -X POST https://api.brightdata.com/request \
    --header "Content-Type: application/json" \
    --header "Authorization: Bearer API_KEY" \
    --data '{
      "zone": "serp_api1",
      "url": "https://www.google.com/search?q=what+makes+the+best+pizza&brd_ai_overview=2",
      "format": "raw"
    }'
  ```

  ```shell Native proxy highlight={4} theme={null}
  curl --proxy brd.superproxy.io:44445 \
    --proxy-user CUSTOMER_USERNAME:CUSTOMER_PASSWORD \
    --ssl-no-revoke \
    "https://www.google.com/search?q=what+makes+the+best+pizza&brd_ai_overview=2"
  ```

  ```js Node.js highlight={10} theme={null}
  (async () => {
    const response = await fetch('https://api.brightdata.com/request', {
      method: 'POST',
      headers: {
        'Content-Type': 'application/json',
        'Authorization': 'Bearer API_KEY'
      },
      body: JSON.stringify({
        zone: 'serp_api1',
        url: 'https://www.google.com/search?q=what+makes+the+best+pizza&brd_ai_overview=2',
        format: 'raw'
      })
    });
    
    const data = await response.text();
    console.log(data);
  })();
  ```

  ```python Python highlight={11} theme={null}
  import requests

  # API Configuration
  headers = {
      'Content-Type': 'application/json',
      'Authorization': 'Bearer API_KEY',
  }

  payload = {
      'zone': 'serp_api1',
      'url': 'https://www.google.com/search?q=what+makes+the+best+pizza&brd_ai_overview=2',
      'format': 'raw'
  }

  # Make the request
  response = requests.post(
      'https://api.brightdata.com/request', 
      json=payload, 
      headers=headers
  )

  print(response.text)
  ```
</RequestExample>

<ResponseExample>
  ```json 200 highlight={398-530} theme={null}
  {
    "general": {
      "search_engine": "google",
      "query": "what makes the best pizza",
      "results_cnt": 701000000,
      "search_time": 0.38,
      "language": "en",
      "location": "Unknown",
      "mobile": false,
      "basic_view": false,
      "search_type": "text",
      "page_title": "what makes the best pizza - Google Search",
      "timestamp": "2026-02-25T09:22:55.293Z"
    },
    "input": {
      "original_url": "https://www.google.com/search?q=what+makes+the+best+pizza&brd_ai_overview=2&brd_json=1",
      "request_id": "hl_xxxxxxxxxxxxxxx"
    },
    "navigation": [
      {
        "title": "AI Mode",
        "href": "https://www.google.com/search?q=what+makes+the+best+pizza&sca_esv=206cd4dd954885db&gl=US&hl=en&udm=50&fbs=ADc_l-aN0CWEZBOHjofHoaMMDiKpFZYo9qIX3pM4_jubAu4b8O2J-l05bwPYHG24xCsQH1w8cvTO1NaOffwF4OfCYdQK0BdR_E7UxHc6fNpvQbyybHrDNK0mjL-uF67YhlI3z2rBnM7wvMGu_iF6p4hNJJhStr69YlW2Oj1OAOgdrMAYd4OOAVozEDRKsKFFa3-i1j7aQIzwDIZtEBmkB_W0Pu-qat6qdg&aep=1&ntc=1&sa=X&ved=2ahUKEwj-6bvbqPSSAxUOPRAIHUAgNV4Q2J8OegQIExAE"
      },
      {
        "title": "Forums",
        "href": "https://www.google.com/search?sca_esv=206cd4dd954885db&gl=US&hl=en&udm=18&fbs=ADc_l-aN0CWEZBOHjofHoaMMDiKpFZYo9qIX3pM4_jubAu4b8O2J-l05bwPYHG24xCsQH1w8cvTO1NaOffwF4OfCYdQK0BdR_E7UxHc6fNpvQbyybHrDNK0mjL-uF67YhlI3z2rBnM7wvMGu_iF6p4hNJJhStr69YlW2Oj1OAOgdrMAYd4OOAVozEDRKsKFFa3-i1j7aQIzwDIZtEBmkB_W0Pu-qat6qdg&q=what+makes+the+best+pizza&sa=X&ved=2ahUKEwj-6bvbqPSSAxUOPRAIHUAgNV4Qs6gLegQIFhAB"
      },
      {
        "title": "Short videos",
        "href": "https://www.google.com/search?sca_esv=206cd4dd954885db&gl=US&hl=en&udm=39&fbs=ADc_l-aN0CWEZBOHjofHoaMMDiKpFZYo9qIX3pM4_jubAu4b8O2J-l05bwPYHG24xCsQH1w8cvTO1NaOffwF4OfCYdQK0BdR_E7UxHc6fNpvQbyybHrDNK0mjL-uF67YhlI3z2rBnM7wvMGu_iF6p4hNJJhStr69YlW2Oj1OAOgdrMAYd4OOAVozEDRKsKFFa3-i1j7aQIzwDIZtEBmkB_W0Pu-qat6qdg&q=what+makes+the+best+pizza&sa=X&ved=2ahUKEwj-6bvbqPSSAxUOPRAIHUAgNV4Qs6gLegQIFxAB"
      },
      {
        "title": "Images",
        "href": "https://www.google.com/search?sca_esv=206cd4dd954885db&gl=US&hl=en&udm=2&fbs=ADc_l-aN0CWEZBOHjofHoaMMDiKpFZYo9qIX3pM4_jubAu4b8O2J-l05bwPYHG24xCsQH1w8cvTO1NaOffwF4OfCYdQK0BdR_E7UxHc6fNpvQbyybHrDNK0mjL-uF67YhlI3z2rBnM7wvMGu_iF6p4hNJJhStr69YlW2Oj1OAOgdrMAYd4OOAVozEDRKsKFFa3-i1j7aQIzwDIZtEBmkB_W0Pu-qat6qdg&q=what+makes+the+best+pizza&sa=X&ved=2ahUKEwj-6bvbqPSSAxUOPRAIHUAgNV4QtKgLegQIGBAB"
      },
      {
        "title": "Shopping",
        "href": "https://www.google.com/search?sca_esv=206cd4dd954885db&gl=US&hl=en&udm=28&fbs=ADc_l-aN0CWEZBOHjofHoaMMDiKpFZYo9qIX3pM4_jubAu4b8O2J-l05bwPYHG24xCsQH1w8cvTO1NaOffwF4OfCYdQK0BdR_E7UxHc6fNpvQbyybHrDNK0mjL-uF67YhlI3z2rBnM7wvMGu_iF6p4hNJJhStr69YlW2Oj1OAOgdrMAYd4OOAVozEDRKsKFFa3-i1j7aQIzwDIZtEBmkB_W0Pu-qat6qdg&q=what+makes+the+best+pizza&ved=1t:220175&ictx=111"
      },
      {
        "title": "Videos",
        "href": "https://www.google.com/search?sca_esv=206cd4dd954885db&gl=US&hl=en&udm=7&fbs=ADc_l-aN0CWEZBOHjofHoaMMDiKpFZYo9qIX3pM4_jubAu4b8O2J-l05bwPYHG24xCsQH1w8cvTO1NaOffwF4OfCYdQK0BdR_E7UxHc6fNpvQbyybHrDNK0mjL-uF67YhlI3z2rBnM7wvMGu_iF6p4hNJJhStr69YlW2Oj1OAOgdrMAYd4OOAVozEDRKsKFFa3-i1j7aQIzwDIZtEBmkB_W0Pu-qat6qdg&q=what+makes+the+best+pizza&sa=X&ved=2ahUKEwj-6bvbqPSSAxUOPRAIHUAgNV4QtKgLegQIFRAB"
      },
      {
        "title": "News",
        "href": "https://www.google.com/search?sca_esv=206cd4dd954885db&gl=US&hl=en&q=what+makes+the+best+pizza&tbm=nws&source=lnms&fbs=ADc_l-aN0CWEZBOHjofHoaMMDiKpFZYo9qIX3pM4_jubAu4b8O2J-l05bwPYHG24xCsQH1w8cvTO1NaOffwF4OfCYdQK0BdR_E7UxHc6fNpvQbyybHrDNK0mjL-uF67YhlI3z2rBnM7wvMGu_iF6p4hNJJhStr69YlW2Oj1OAOgdrMAYd4OOAVozEDRKsKFFa3-i1j7aQIzwDIZtEBmkB_W0Pu-qat6qdg&sa=X&ved=2ahUKEwj-6bvbqPSSAxUOPRAIHUAgNV4Q0pQJegQIehAB"
      },
      {
        "title": "Maps",
        "href": "https://maps.google.com/maps?sca_esv=206cd4dd954885db&gl=US&hl=en&output=search&q=what+makes+the+best+pizza&source=lnms&fbs=ADc_l-aN0CWEZBOHjofHoaMMDiKpFZYo9qIX3pM4_jubAu4b8O2J-l05bwPYHG24xCsQH1w8cvTO1NaOffwF4OfCYdQK0BdR_E7UxHc6fNpvQbyybHrDNK0mjL-uF67YhlI3z2rBnM7wvMGu_iF6p4hNJJhStr69YlW2Oj1OAOgdrMAYd4OOAVozEDRKsKFFa3-i1j7aQIzwDIZtEBmkB_W0Pu-qat6qdg&entry=mc&ved=1t:200715&ictx=111"
      },
      {
        "title": "Web",
        "href": "https://www.google.com/search?sca_esv=206cd4dd954885db&gl=US&hl=en&udm=web&fbs=ADc_l-aN0CWEZBOHjofHoaMMDiKpFZYo9qIX3pM4_jubAu4b8O2J-l05bwPYHG24xCsQH1w8cvTO1NaOffwF4OfCYdQK0BdR_E7UxHc6fNpvQbyybHrDNK0mjL-uF67YhlI3z2rBnM7wvMGu_iF6p4hNJJhStr69YlW2Oj1OAOgdrMAYd4OOAVozEDRKsKFFa3-i1j7aQIzwDIZtEBmkB_W0Pu-qat6qdg&q=what+makes+the+best+pizza&sa=X&ved=2ahUKEwj-6bvbqPSSAxUOPRAIHUAgNV4Qs6gLegQIfBAB"
      },
      {
        "title": "Books",
        "href": "https://www.google.com/search?sca_esv=206cd4dd954885db&gl=US&hl=en&q=what+makes+the+best+pizza&udm=36&source=lnms&fbs=ADc_l-aN0CWEZBOHjofHoaMMDiKpFZYo9qIX3pM4_jubAu4b8O2J-l05bwPYHG24xCsQH1w8cvTO1NaOffwF4OfCYdQK0BdR_E7UxHc6fNpvQbyybHrDNK0mjL-uF67YhlI3z2rBnM7wvMGu_iF6p4hNJJhStr69YlW2Oj1OAOgdrMAYd4OOAVozEDRKsKFFa3-i1j7aQIzwDIZtEBmkB_W0Pu-qat6qdg&sa=X&ved=2ahUKEwj-6bvbqPSSAxUOPRAIHUAgNV4Q0pQJegQIfRAB"
      }
    ],
    "organic": [
      {
        "link": "https://www.thekitchn.com/types-of-pizza-23665322",
        "source": "The Kitchn",
        "display_link": "https://www.thekitchn.com › ... › Main Dishes › Pizza",
        "title": "12 Best Types of Pizza Everyone Needs to Know About",
        "description": "New York-style dough frequently has sugar and oil in the recipe, which adds flavor, helps the crust brown, and makes it easier to stretch. The ...Read more",
        "snippet_highlighted_words": [
          "New York-style dough frequently has sugar and oil in the recipe"
        ],
        "extensions": [
          {
            "inline": true,
            "type": "text",
            "text": "Jun 25, 2024",
            "rank": 1
          }
        ],
        "icon": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAABwAAA...",
        "rank": 1,
        "global_rank": 1
      },
      {
        "link": "https://www.bonappetit.com/story/best-homemade-pizza?srsltid=AfmBOoq3vbzR7ZqTK7r8PLxxSkJ0NcgOp_mhKFlgxr8mvrPvIHzsyklg",
        "source": "Bon Appétit",
        "display_link": "https://www.bonappetit.com › Cooking › Pizza",
        "title": "9 Rules for the Best Homemade Pizza OF YOUR LIFE",
        "description": "1. Store-bought Pizza Dough Is Totally Cool—If You Handle It Right · 2. You Need Two Kinds of Mozzarella · 3. Know When to Top · 4. Simple Sauce Is ...Read more",
        "snippet_highlighted_words": [
          "Store-bought Pizza Dough Is Totally Cool—If You Handle It Right"
        ],
        "extensions": [
          {
            "inline": true,
            "type": "text",
            "text": "Mar 28, 2017",
            "rank": 1
          }
        ],
        "icon": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAABwAAA...",
        "rank": 2,
        "global_rank": 21
      },
      {
        "link": "https://www.tastingtable.com/1552373/pizza-styles-ranked-worst-best/",
        "source": "Tasting Table",
        "display_link": "https://www.tastingtable.com › Exclusives › Opinion",
        "title": "14 Pizza Styles, Ranked Worst To Best",
        "description": "The perfect pizza is crisp, not soggy, and can be eaten in a variety of settings. Above all, I want a pizza that will taste the same whether I ...Read more",
        "snippet_highlighted_words": [
          "crisp, not soggy, and can be eaten in a variety of settings"
        ],
        "extensions": [
          {
            "inline": true,
            "type": "text",
            "text": "Apr 2, 2024",
            "rank": 1
          }
        ],
        "icon": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAABwAAA...",
        "rank": 3,
        "global_rank": 22
      },
      {
        "link": "https://www.reddit.com/r/Chattanooga/comments/1fcsux7/what_makes_a_best_pizza_the_best/",
        "source": "Reddit · r/Chattanooga",
        "display_link": "20+ comments · 1 year ago",
        "title": "What makes a “best” pizza the “best”? : r/Chattanooga",
        "description": "A good crust, thin, crispy but not too crispy, on the bottom with a good amount of air pockets on the outside ring. A savory sauce with good ...Read more",
        "snippet_highlighted_words": [
          "A good crust, thin, crispy but not too crispy, on the bottom"
        ],
        "icon": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAABwAAA...",
        "rank": 4,
        "global_rank": 26
      },
      {
        "link": "https://thefoodcharlatan.com/homemade-pizza-recipe/",
        "source": "The Food Charlatan",
        "display_link": "https://thefoodcharlatan.com › Recipes for Dinner",
        "title": "Best Homemade Pizza Recipe (1 Hour or Overnight)",
        "description": "I'll give you lots of tips, tricks, and ideas to get the best homemade pizza to ever come out of your wimpy, not-wood-fired oven!Read more",
        "snippet_highlighted_words": [
          "best homemade pizza"
        ],
        "extensions": [
          {
            "type": "rating",
            "rating": 5,
            "reviews_cnt": 85,
            "rank": 1
          }
        ],
        "icon": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAABwAAA...",
        "rank": 5,
        "global_rank": 27
      },
      {
        "link": "https://www.seriouseats.com/essential-tips-for-better-pizza-how-to-make-pizza-at-home",
        "source": "Serious Eats",
        "display_link": "https://www.seriouseats.com › ... › Baking Guides",
        "title": "11 Essential Tips for Better Pizza | The Food Lab",
        "description": "#1: Use a Scale! · #2: Learn How to Use the Metric System and Baker's Percentages · #3: Choose the Right Flour · #4: Pick a Style · #5: No Stand Mixer? No Problem.Read more",
        "snippet_highlighted_words": [
          "Use a Scale"
        ],
        "icon": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAABwAAA...",
        "rank": 6,
        "global_rank": 28
      },
      {
        "link": "https://www.youtube.com/watch?v=Lyh94fDNCr4",
        "source": "YouTube · Vito Iacopelli",
        "display_link": "20.4K+ views · 5 months ago",
        "title": "What Makes the Pizza, The Best!?",
        "description": "This video is about to see all the differences between pizza and pizza because they are totally different products.",
        "icon": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAABAAAA...",
        "image": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcTbAdDLC62143Qi4sj_7Y61QvHPxjMSXzzKoko5lCNmh8sEjTCvT54pVA&s",
        "image_url": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcTbAdDLC62143Qi4sj_7Y61QvHPxjMSXzzKoko5lCNmh8sEjTCvT54pVA&s",
        "duration": "16:29",
        "duration_sec": 989,
        "rank": 7,
        "global_rank": 29
      },
      {
        "link": "https://www.pizzauniversity.org/how-to-identify-good-pizza-in-8-easy-steps/",
        "source": "Pizza University & Culinary Arts Center",
        "display_link": "https://www.pizzauniversity.org › how-to-identify-good...",
        "title": "How to Identify Good Pizza in 8 Easy Steps",
        "description": "First look at the crust and the border of the pizza. If it contains a lot of air – it will be light, crisp and good.Read more",
        "snippet_highlighted_words": [
          "light, crisp and good"
        ],
        "extensions": [
          {
            "inline": true,
            "type": "text",
            "text": "Oct 25, 2019",
            "rank": 1
          }
        ],
        "icon": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQABAAD/2w...",
        "rank": 8,
        "global_rank": 30
      }
    ],
    "perspectives": [
      {
        "title": "The 18 best pizzas in the world, ranked",
        "author": "Liv Kelly · Time Out Worldwide",
        "source": "Travel writer for Time Out",
        "date": "3 weeks ago",
        "link": "https://www.timeout.com/restaurants/worlds-best-pizzas",
        "image": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQABAAD/2w...",
        "image_base64": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQABAAD/2w..."
      },
      {
        "title": "The Secret To Authentic Neapolitan Pizza",
        "author": "Nick's Kitchen · YouTube",
        "source": "American chef and internet personality",
        "date": "538.8K+ views · 3 weeks ago",
        "link": "https://www.youtube.com/watch?v=dsQGMhsvIYY",
        "image": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQABAAD/2w...",
        "image_base64": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQABAAD/2w..."
      },
      {
        "title": "These 13 pizzerias are Pittsburgh’s best, and reflect Western Pa.’s position as a rising pizza powerhouse",
        "author": "Hal B. Klein · Pittsburgh Post-Gazette",
        "source": "Pittsburgh-based food & drinks writer",
        "date": "1 day ago",
        "link": "https://www.post-gazette.com/life/dining/2026/02/24/best-pizza-pittsburgh-1/stories/202602160047",
        "image": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQABAAD/2w...",
        "image_base64": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQABAAD/2w..."
      },
      {
        "title": "Best Pizza in Phoenix Popular comment · Cibo is my favorite patio + pizza date night spot",
        "author": "r/phoenix",
        "source": "Reddit",
        "date": "260+ comments · 2 weeks ago",
        "link": "https://www.reddit.com/r/phoenix/comments/1r12hok/best_pizza_in_phoenix/"
      },
      {
        "title": "Best Pizza in Sonoma County: 16 Editor-Approved Spots for Tasty PiesBest Pizza in Sonoma County: 16 Editor-Approved Spots for Tasty Pies",
        "author": "Heather Irwin · Sonoma MagazineHeather Irwin · Sonoma Magazine",
        "source": "Sonoma County dining writerSonoma County dining writer",
        "date": "3 weeks ago3 weeks ago",
        "link": "https://www.sonomamag.com/best-pizza-in-sonoma-county-favorite-restaurants-for-tasty-pies/",
        "image": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcRKzKYqmgbflEzazf8g_Fnp6r4J6ZIO3t95YB0TFq11OXOKFQ8kMf2TeeEzww&usqp=CAI&s",
        "image_url": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcRKzKYqmgbflEzazf8g_Fnp6r4J6ZIO3t95YB0TFq11OXOKFQ8kMf2TeeEzww&usqp=CAI&s"
      },
      {
        "title": "Top Pizza in the Bay AreaTop Pizza in the Bay Area",
        "author": "Cesar Hernandez, Soleil HoCesar Hernandez, Soleil Ho",
        "source": "San Francisco ChronicleSan Francisco Chronicle",
        "date": "3 weeks ago3 weeks ago",
        "link": "https://www.sfchronicle.com/projects/2023/best-pizza-sf-bay-area/",
        "image": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcSPGyTJpaRNE8ruXgkLdHkPFLVu5T7ykcJezvyYa07SUmrk7T0XaSntO19GBw&usqp=CAI&s",
        "image_url": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcSPGyTJpaRNE8ruXgkLdHkPFLVu5T7ykcJezvyYa07SUmrk7T0XaSntO19GBw&usqp=CAI&s"
      },
      {
        "title": "The 10 Best Pizza Chains in the USA Which pizza chain is your favorite?",
        "author": "ViralNova · Facebook",
        "source": "Curation site for clickbait",
        "date": "3 days ago",
        "link": "https://www.facebook.com/ViralNova/posts/the-10-best-pizza-chains-in-the-usawhich-pizza-chain-is-your-favorite/1241527424749017/",
        "image": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcR0vgx83wQhgnudtPZ1S_caEzWEMf60_Bzx41Laou9ab1ZBtfh1CQkNjUO4zQ&usqp=CAI&s",
        "image_url": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcR0vgx83wQhgnudtPZ1S_caEzWEMf60_Bzx41Laou9ab1ZBtfh1CQkNjUO4zQ&usqp=CAI&s"
      },
      {
        "title": "Where is the best pizza in DC? Popular comment · I mean it’s subjective, but in my opinion it’s Vace (kind of their own style), Andy’s (nyc style), 2Amy’s (Neapolitan style), and Mama Lucia (kind of nyc-ish but it’s nostalgic for me and I think it’s still very good).",
        "author": "r/washingtondc",
        "source": "Reddit",
        "date": "440+ comments · 1 month ago",
        "link": "https://www.reddit.com/r/washingtondc/comments/1qfkcxp/where_is_the_best_pizza_in_dc/"
      },
      {
        "title": "I Finally Made the Perfect Pizza (After Years of Practice)I Finally Made the Perfect Pizza (After Years of Practice)",
        "author": "Wilsons BBQ · YouTubeWilsons BBQ · YouTube",
        "source": "American BBQ in the UKAmerican BBQ in the UK",
        "date": "26.3K+ views · 2 weeks ago26.3K+ views · 2 weeks ago",
        "link": "https://www.youtube.com/watch?v=g5IoSPd4Cgg",
        "image": "https://img.youtube.com/vi/g5IoSPd4Cgg/hqdefault.jpg",
        "image_url": "https://img.youtube.com/vi/g5IoSPd4Cgg/hqdefault.jpg"
      },
      {
        "title": "The Best New York Style Pizza at Home 🍕The Best New York Style Pizza at Home 🍕",
        "author": "Dylan Nobert · YouTubeDylan Nobert · YouTube",
        "source": "Cooking content creatorCooking content creator",
        "date": "59.5K+ views · 3 weeks ago59.5K+ views · 3 weeks ago",
        "link": "https://www.youtube.com/shorts/bndZw1mXa7w",
        "image": "https://img.youtube.com/vi/bndZw1mXa7w/hqdefault.jpg",
        "image_url": "https://img.youtube.com/vi/bndZw1mXa7w/hqdefault.jpg"
      },
      {
        "title": "Best pizza in San Jose Popular comment · It depends what you like. Slice of Homage is Detroit style. A rectangular pie with intentionally burned edges and small, but thick slices. Bibo's and Slice of New York are New York-style. A large, thin pie with an extra cooked, crispy crust.",
        "author": "r/SanJose",
        "source": "Reddit",
        "date": "220+ comments · 1 month ago",
        "link": "https://www.reddit.com/r/SanJose/comments/1qfl93o/best_pizza_in_san_jose/"
      },
      {
        "title": "We Baked 100+ Pizzas to Make 1 Perfect RecipeWe Baked 100+ Pizzas to Make 1 Perfect Recipe",
        "author": "King Arthur Baking Company · YouTubeKing Arthur Baking Company · YouTube",
        "source": "Baking products & recipe providerBaking products & recipe provider",
        "date": "154.1K+ views · 1 month ago154.1K+ views · 1 month ago",
        "link": "https://www.youtube.com/watch?v=EdZ7IO8w69o",
        "image": "https://img.youtube.com/vi/EdZ7IO8w69o/hqdefault.jpg",
        "image_url": "https://img.youtube.com/vi/EdZ7IO8w69o/hqdefault.jpg"
      }
    ],
    "pagination": {
      "pages": [
        {
          "page": 2,
          "start": 10,
          "link": "https://www.google.com/search?q=what+makes+the+best+pizza&sca_esv=206cd4dd954885db&gl=US&hl=en&ei=XL-eaf7LFY76wPAPwMDU8QU&start=10&sa=N&sstk=Af77f_eat-RcaJ38aKFQ2gKZ3ozXL83am_zqevXTsQauRtBUChpa7vRLEpNGFj0NQ9y_zo-1csD5TJvjHaeJp-wF6YtpzlfIWaWjsQ&ved=2ahUKEwj-6bvbqPSSAxUOPRAIHUAgNV4Q8tMDegQIERAE"
        },
        {
          "page": 3,
          "start": 20,
          "link": "https://www.google.com/search?q=what+makes+the+best+pizza&sca_esv=206cd4dd954885db&gl=US&hl=en&ei=XL-eaf7LFY76wPAPwMDU8QU&start=20&sa=N&sstk=Af77f_eat-RcaJ38aKFQ2gKZ3ozXL83am_zqevXTsQauRtBUChpa7vRLEpNGFj0NQ9y_zo-1csD5TJvjHaeJp-wF6YtpzlfIWaWjsQ&ved=2ahUKEwj-6bvbqPSSAxUOPRAIHUAgNV4Q8tMDegQIERAG"
        },
        {
          "page": 4,
          "start": 30,
          "link": "https://www.google.com/search?q=what+makes+the+best+pizza&sca_esv=206cd4dd954885db&gl=US&hl=en&ei=XL-eaf7LFY76wPAPwMDU8QU&start=30&sa=N&sstk=Af77f_eat-RcaJ38aKFQ2gKZ3ozXL83am_zqevXTsQauRtBUChpa7vRLEpNGFj0NQ9y_zo-1csD5TJvjHaeJp-wF6YtpzlfIWaWjsQ&ved=2ahUKEwj-6bvbqPSSAxUOPRAIHUAgNV4Q8tMDegQIERAI"
        }
      ],
      "current_page": 1,
      "next_page": 2,
      "next_page_start": 10,
      "next_page_link": "https://www.google.com/search?q=what+makes+the+best+pizza&sca_esv=206cd4dd954885db&gl=US&hl=en&ei=XL-eaf7LFY76wPAPwMDU8QU&start=10&sa=N&sstk=Af77f_eat-RcaJ38aKFQ2gKZ3ozXL83am_zqevXTsQauRtBUChpa7vRLEpNGFj0NQ9y_zo-1csD5TJvjHaeJp-wF6YtpzlfIWaWjsQ&ved=2ahUKEwj-6bvbqPSSAxUOPRAIHUAgNV4Q8tMDegQIERAE"
    },
    "related": [
      {
        "text": "What is the 3 8 rule for pizza? AI Overview The 3/8 pizza ... - FacebookJan 23, 2026 — OCR: What is the 3 8 rule for pizza? AI Overview The 3/8 pizza rule is a simple guideline for ordering pizza, suggesti...Facebook · Pizzaholics",
        "link": "https://www.facebook.com/groups/742034912983989/posts/2399634517224012/#:~:text=OCR:%20What%20is%20the%203,average%20person%20eats%203%20slices.",
        "image": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcTXkm_xZBvefVGSTakfu7jK7ZbURiVQhVW8QzLQ1Rfwn-TRsIS0UkqbRs7iLA&s",
        "image_url": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcTXkm_xZBvefVGSTakfu7jK7ZbURiVQhVW8QzLQ1Rfwn-TRsIS0UkqbRs7iLA&s",
        "image_base64": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQABAAD/2w...",
        "rank": 1,
        "global_rank": 3
      },
      {
        "text": "How Many Pizzas Do You Need to Order? | Factors to ConsiderJan 29, 2025Green Lantern Pizza",
        "link": "https://greenlanternpizza.com/blog/how-many-pizzas-do-you-need/",
        "image": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcSjYc__HNk2lhZK2rIW38z1fFrOdU2MpkaueFpaJPnXsKbxR-xYsBmi21PWXg&s",
        "image_url": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcSjYc__HNk2lhZK2rIW38z1fFrOdU2MpkaueFpaJPnXsKbxR-xYsBmi21PWXg&s",
        "rank": 2,
        "global_rank": 4
      },
      {
        "text": "How To Host The Perfect Pizza Party - Papa JohnsSep 23, 2025 — Each of your guests will eat 3 slices of pizza. A standard pizza has approximately 8 slices. As an example, if you had...Papa JohnsHow To Host The Perfect Pizza Party - Papa JohnsSep 23, 2025 — Each of your guests will eat 3 slices of pizza. A standard pizza has approximately 8 slices. As an example, if you had...Papa Johns",
        "link": "https://www.papajohns.co.uk/blog/how-to-host-the-perfect-pizza-party#:~:text=Each%20of%20your%20guests%20will,you%20don't%20order%20sides!",
        "image": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcT-y5_Vke6_uqYEq7uFaDV93MAiYYTgxHocRyuFRU_2Dmoih26s6dGERYIh2A&s",
        "image_url": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcT-y5_Vke6_uqYEq7uFaDV93MAiYYTgxHocRyuFRU_2Dmoih26s6dGERYIh2A&s",
        "rank": 3,
        "global_rank": 5
      }
    ],
    "people_also_ask": [
      {
        "question": "What's the secret to making the best pizza?",
        "question_link": "https://www.freethepizza.com/blog/the-secret-pro-tip-for-great-homemade-pizza-unleashing-the-beast-in-your-home-oven#:~:text=The%20secret%20to%20great%20pizza%20is%20high%20heat%20and%20thermal%20mass.&text=You%20turn%20the%20oven%20up,all%20into%20a%20crispy%20crust.",
        "question_type": "featured",
        "answer_html": "<div id=\"XL-eaf7LFY76wPAPwMDU8QU__32\"><div class=\"wDYxhc\" data-md=\"61\" style=\"clear:none\"><div class=\"LGOjhe\" data-attrid=\"wa:/description\" data-hveid=\"CC0QAA\"><span class=\"ILfuVd\" lang=\"en\"><span class=\"hgKElc pOOWX\">The secret to great pizza is <b>high heat and thermal mass</b>.<br><br> You turn the oven up high, you heat the stone or steel, and your oven begins to behave more like a commercial pizza oven. That high-heat stone or steel makes the raw pizza dough pop up, makes the water evaporate quickly, and turns it all into a crispy crust.</span></span><span class=\"kX21rb ZYHQ7e\">Feb 1, 2025</span></div></div></div><div id=\"XL-eaf7LFY76wPAPwMDU8QU__33\"><div class=\"Y6JuXb\"><div data-hveid=\"CCcQAA\" data-ved=\"2ahUKEwj-6bvbqPSSAxUOPRAIHUAgNV4QFSgAegQIJxAA\"><div style=\"position:relative\" class=\"tF2Cxc\"><div class=\"yuRUbf\"><div class=\"b8lM7\"><span class=\"V9tjod\" jsaction=\"trigger.mLt3mc\"><a jsname=\"UWckNb\" class=\"zReHs\" href=\"https://www.freethepizza.com/blog/the-secret-pro-tip-for-great-homemade-pizza-unleashing-the-beast-in-your-home-oven#:~:text=The%20secret%20to%20great%20pizza%20is%20high%20heat%20and%20thermal%20mass.&amp;text=You%20turn%20the%20oven%20up,all%20into%20a%20crispy%20crust.\" data-ved=\"2ahUKEwj-6bvbqPSSAxUOPRAIHUAgNV4QFnoECCcQAw\" ping=\"/url?sa=t&amp;source=web&amp;rct=j&amp;opi=89978449&amp;url=https://www.freethepizza.com/blog/the-secret-pro-tip-for-great-homemade-pizza-unleashing-the-beast-in-your-home-oven%23:~:text%3DThe%2520secret%2520to%2520great%2520pizza%2520is%2520high%2520heat%2520and%2520thermal%2520mass.%26text%3DYou%2520turn%2520the%2520oven%2520up,all%2520into%2520a%2520crispy%2520crust.&amp;ved=2ahUKEwj-6bvbqPSSAxUOPRAIHUAgNV4QFnoECCcQAw\"><h3 class=\"LC20lb MBeuO DKV0Md\" id=\"_XL-eaf7LFY76wPAPwMDU8QU_61\">For great homemade pizza, unleash the beast in your home oven...</h3><br><div class=\"notranslate ESMNde HGLrXd ojE3Fb\"><div class=\"q0vns\"><span class=\"H9lube\"><div class=\"eqA2re NjwKYd Vwoesf\" aria-hidden=\"true\"><img class=\"XNo5Ab\" src=\"data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAABAAAAAQCAMAAAAoLQ9TAAAAz1BMVEWTzPmWz/6Y1f98uN1QiKdAZnpCY3k9X3ZHe5Nro8OW0f+X0/9YkLJHQTuhdUnjrXb9vou+i2BpVypDaYWMyPGDuOBLRz/Ekmr/xpWmiGVZFANqSDjXrH29l26OclHYp3BvVCdgh6Z8r9V3TB9CRyeTAA3yJymZAAvbHB3SExt/AAGJakdDTVopW2fWCw/RIyMABgTDICDrJyjpJid2AACeGh0zDQ5GEQl3FA1XEA1WAACSGh+wAACgAABDBgQAIiQAFhojS1gWO0nwGxlsmbj0bsWQAAAAqElEQVR4AVTFQQsBQRgG4Pf9NmJmxGHd5TCkWM0kWRD+vT+gXLi6qt2EGi2B5/IQ4AdygNAsAEFI5jmbfLmXeCuTJ7afI2Q1Fg5yVA1RShmjtbqHXUbErXOd5JXAbR9lgK4M/GSceO9siidJrbXeJ9OZUSjQzBPn3XCxFAAChBAxALhsA15YHY6c664Eb7K23vZifDDq2EFF40v6mxR/4oUhfqnHXGAaAOuvJMmNnImSAAAAAElFTkSuQmCC\" style=\"height:18px;width:18px\" alt=\"\"></div></span><div class=\"CA5RN\"><div><span class=\"VuuXrf\">Free The Pizza</span></div><div class=\"byrV5b\"><cite class=\"qLRx3b tjvcx GvPZzd cHaqb\" role=\"text\">https://www.freethepizza.com<span class=\"ylgVCe ob9lvb\" role=\"text\"> › blog › the-secret-pro-tip-...</span></cite></div></div></div></div></a></span><div class=\"B6fmyf byrV5b Mg1HEd\"><div class=\"HGLrXd ojE3Fb\"><div class=\"q0vns\"><span class=\"H9lube\"><div class=\"eqA2re NjwKYd\" style=\"height:18px;width:18px\"></div></span><div class=\"CA5RN\"><div><span class=\"VuuXrf\">Free The Pizza</span></div><div class=\"byrV5b\"><cite class=\"qLRx3b tjvcx GvPZzd cHaqb\" role=\"text\">https://www.freethepizza.com<span class=\"ylgVCe ob9lvb\" role=\"text\"> › blog › the-secret-pro-tip-...</span></cite></div></div></div></div></div></div></div></div></div></div></div>",
        "answers": [
          {
            "type": "answer",
            "value": {
              "text": "The secret to great pizza is high heat and thermal mass. You turn the oven up high, you heat the stone or steel, and your oven begins to behave more like a commercial pizza oven. That high-heat stone or steel makes the raw pizza dough pop up, makes the water evaporate quickly, and turns it all into a crispy crust.Feb 1, 2025"
            },
            "rank": 1
          }
        ],
        "rank": 1,
        "global_rank": 2
      },
      {
        "question": "What makes a pizza taste best?",
        "question_link": "https://feastandfield.net/read/bread-and-pasta/why-does-pizza-taste-so-good-we-investigate/article_e61d704e-7fca-11ec-8873-8b24d05c9b9f.html#:~:text=from%20the%201800s.-,Cheese%20and%20tomatoes%20have%20some%20of%20the%20highest%20natural%20levels,delicious%20char%20on%20pizza%20crust.",
        "question_type": "featured",
        "answer_html": "<div id=\"XL-eaf7LFY76wPAPwMDU8QU__41\"><div class=\"wDYxhc\" data-md=\"61\" style=\"clear:none\"><div class=\"LGOjhe\" data-attrid=\"wa:/description\" data-hveid=\"CCwQAA\"><span class=\"ILfuVd\" lang=\"en\"><span class=\"hgKElc pOOWX\">Cheese and tomatoes have some of the highest natural levels of glutamate. <b>Lactic acid developed as dough rises gives pizza a tang that complements its fattiness</b>. The Maillard reaction creates a delicious char on pizza crust.</span></span><span class=\"kX21rb ZYHQ7e\">Feb 7, 2022</span></div></div></div><div id=\"XL-eaf7LFY76wPAPwMDU8QU__42\"><div class=\"Y6JuXb\"><div data-hveid=\"CCUQAA\" data-ved=\"2ahUKEwj-6bvbqPSSAxUOPRAIHUAgNV4QFSgAegQIJRAA\"><div style=\"position:relative\" class=\"tF2Cxc\"><div class=\"yuRUbf\"><div class=\"b8lM7\"><span class=\"V9tjod\" jsaction=\"trigger.mLt3mc\"><a jsname=\"UWckNb\" class=\"zReHs\" href=\"https://feastandfield.net/read/bread-and-pasta/why-does-pizza-taste-so-good-we-investigate/article_e61d704e-7fca-11ec-8873-8b24d05c9b9f.html#:~:text=from%20the%201800s.-,Cheese%20and%20tomatoes%20have%20some%20of%20the%20highest%20natural%20levels,delicious%20char%20on%20pizza%20crust.\" data-ved=\"2ahUKEwj-6bvbqPSSAxUOPRAIHUAgNV4QFnoECCUQAw\" ping=\"/url?sa=t&amp;source=web&amp;rct=j&amp;opi=89978449&amp;url=https://feastandfield.net/read/bread-and-pasta/why-does-pizza-taste-so-good-we-investigate/article_e61d704e-7fca-11ec-8873-8b24d05c9b9f.html%23:~:text%3Dfrom%2520the%25201800s.-,Cheese%2520and%2520tomatoes%2520have%2520some%2520of%2520the%2520highest%2520natural%2520levels,delicious%2520char%2520on%2520pizza%2520crust.&amp;ved=2ahUKEwj-6bvbqPSSAxUOPRAIHUAgNV4QFnoECCUQAw\"><h3 class=\"LC20lb MBeuO DKV0Md\" id=\"_XL-eaf7LFY76wPAPwMDU8QU_60\">Why does pizza taste so good? We investigate | Bread &amp; Pasta</h3><br><div class=\"notranslate ESMNde HGLrXd ojE3Fb\"><div class=\"q0vns\"><span class=\"H9lube\"><div class=\"eqA2re NjwKYd Vwoesf\" aria-hidden=\"true\"><img class=\"XNo5Ab\" src=\"data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQABAAD/2wCEAAkGBwgBBgkIBwEKAQkLDRYPDQEMDRsUFRAWIB0iIiAdHx8kKDQsJCYxJx8fLT0tJTU3Ojo6JSs/RD84Qy05OjcBCgoKDQENGg8PDjclHyU3Nzc3Nzc3LTctNzc3NzU3Kzc3NzUrLSs3NzcsLS03NTArNys1LTcrNys3NzUrLTU1Nf/AABEIABAAEAMBEQACEQEDEQH/xAAXAAADAQAAAAAAAAAAAAAAAAACAwcA/8QAJhAAAQIEBAcBAAAAAAAAAAAAAQMRAgQGBwAIEjEFIUJhkdHwIv/EABcBAAMBAAAAAAAAAAAAAAAAAAECBQD/xAAnEQABAwIEBQUAAAAAAAAAAAABAgMRAGEEByFxEhdBUeEiMYHR8f/aAAwDAQACEQMRAD8AoPFV5q/ysQQu+jSKI2pPWxP6ZziDinHM3lEIdAHmJNV8O2jLcAqbk+J0pfDl5rLaqIlLxp1Qh1UjqJcOBy78x8+Ew7juSyvU7Ke3zGl6Z5DeaY0bhXf7rT8qMtyisKtnoripKqaoaqdmG4APl8bENDJNRlriSddrT0rMuc1gIXBAje9BJojMtEEkbLGiAYoddxSXAhHvAZRztPClqBpJsOm5/aLq+VIkuz7wL1//2Q==\" style=\"height:18px;width:18px\" alt=\"\"></div></span><div class=\"CA5RN\"><div><span class=\"VuuXrf\">Feast and Field</span></div><div class=\"byrV5b\"><cite class=\"qLRx3b tjvcx GvPZzd cHaqb\" role=\"text\">https://feastandfield.net<span class=\"ylgVCe ob9lvb\" role=\"text\"> › read › why-does-pizza-taste-so-...</span></cite></div></div></div></div></a></span><div class=\"B6fmyf byrV5b Mg1HEd\"><div class=\"HGLrXd ojE3Fb\"><div class=\"q0vns\"><span class=\"H9lube\"><div class=\"eqA2re NjwKYd\" style=\"height:18px;width:18px\"></div></span><div class=\"CA5RN\"><div><span class=\"VuuXrf\">Feast and Field</span></div><div class=\"byrV5b\"><cite class=\"qLRx3b tjvcx GvPZzd cHaqb\" role=\"text\">https://feastandfield.net<span class=\"ylgVCe ob9lvb\" role=\"text\"> › read › why-does-pizza-taste-so-...</span></cite></div></div></div></div></div></div></div></div></div></div></div>",
        "answers": [
          {
            "type": "answer",
            "value": {
              "text": "Cheese and tomatoes have some of the highest natural levels of glutamate. Lactic acid developed as dough rises gives pizza a tang that complements its fattiness. The Maillard reaction creates a delicious char on pizza crust.Feb 7, 2022"
            },
            "rank": 1
          }
        ],
        "rank": 2,
        "global_rank": 20
      }
    ],
    "ai_overview": {
      "texts": [
        {
          "type": "paragraph",
          "snippet": "A good pizza is defined by a perfectly balanced, crispy-yet-chewy crust, flavorful sauce, and high-quality cheese, all cooked at high temperatures. Key factors include proper dough fermentation, a, structural balance of toppings to avoid a soggy mess, and a slightly charred crust, creating a harmonious blend of textures and fresh ingredients. Facebook +4",
          "reference_indexes": [
            0,
            1,
            2,
            3,
            8
          ],
          "image": {
            "image": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQABAAD/2w...",
            "image_alt": "The F&W Guide to Homemade Pizza",
            "image_base64": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQABAAD/2w..."
          }
        },
        {
          "type": "paragraph",
          "snippet": "Here are the key components of a good pizza:"
        },
        {
          "type": "list",
          "title": "Crust (The Foundation): A great pizza has a light, airy crust that is neither overcooked (burnt/dry) nor undercooked (soggy). It should have a slightly chewy, airy interior and a crisp, charred exterior.",
          "list": [
            {
              "type": "paragraph",
              "snippet": "Crust (The Foundation): A great pizza has a light, airy crust that is neither overcooked (burnt/dry) nor undercooked (soggy). It should have a slightly chewy, airy interior and a crisp, charred exterior."
            },
            {
              "type": "paragraph",
              "snippet": "Sauce (The Flavor): High-quality, balanced sauce—not too sweet or acidic—is crucial. A simple, fresh sauce allows the flavors of the cheese and dough to shine."
            },
            {
              "type": "paragraph",
              "snippet": "Cheese and Toppings (The Balance): The cheese should be melted, stretchy, and high-quality, not just added in excess. Ingredients should be fresh, and toppings must be balanced with the sauce and cheese to prevent a soggy, unmanageable slice."
            },
            {
              "type": "paragraph",
              "snippet": "Cooking Method: The best pizzas are baked at high temperatures, such as in a wood-fired oven, which provides a fast, intense bake that creates a delicious, slightly charred flavor (the Maillard reaction)."
            },
            {
              "type": "paragraph",
              "snippet": "Structure: A good pizza is not too heavy; it holds its shape when lifted. Pizza University & Culinary Arts Center +6",
              "reference_indexes": [
                0,
                1,
                2,
                3,
                4,
                6,
                7
              ],
              "image": {
                "image": "https://encrypted-tbn1.gstatic.com/faviconV2?url=https://www.pizzauniversity.org&client=AIM&size=128&type=FAVICON&fallback_opts=TYPE,SIZE,URL",
                "image_alt": "Pizza University & Culinary Arts Center",
                "image_url": "https://encrypted-tbn1.gstatic.com/faviconV2?url=https://www.pizzauniversity.org&client=AIM&size=128&type=FAVICON&fallback_opts=TYPE,SIZE,URL"
              }
            }
          ]
        },
        {
          "type": "paragraph",
          "snippet": "Key Takeaway: A great pizza balances fresh, high-quality ingredients on a perfectly baked, light, and airy dough. YouTube +1",
          "reference_indexes": [
            0,
            5
          ],
          "image": {
            "image": "https://encrypted-tbn2.gstatic.com/faviconV2?url=https://www.youtube.com&client=AIM&size=128&type=FAVICON&fallback_opts=TYPE,SIZE,URL",
            "image_alt": "YouTube",
            "image_url": "https://encrypted-tbn2.gstatic.com/faviconV2?url=https://www.youtube.com&client=AIM&size=128&type=FAVICON&fallback_opts=TYPE,SIZE,URL"
          }
        }
      ],
      "references": [
        {
          "href": "https://www.doreenspizzeria.com/doreens-pizzeria-7-qualities-of-a-perfect-pizza-slice/",
          "title": "Doreen's Pizzeria - 7 Qualities of a Perfect Pizza Slice. Opens in new tab.",
          "source": "Doreen's Pizza",
          "index": 0
        },
        {
          "href": "https://www.facebook.com/groups/742034912983989/posts/1885228215331314/",
          "title": "What makes a great pizza? - Facebook. Opens in new tab.",
          "source": "Facebook",
          "index": 1
        },
        {
          "href": "https://www.popuppizzalv.com/the-elements-of-what-makes-pizza-taste-great/#:~:text=There%20are%20three%20fundamental%20elements%20that%20make,adds%20to%20the%20texture%20of%20the%20crust.",
          "title": "The Elements of What Makes Pizza Taste Great. Opens in new tab.",
          "source": "Pop Up Pizza",
          "index": 2
        },
        {
          "href": "https://www.doreenspizzeria.com/discover-the-top-qualities-of-the-perfect-pizza-pie/#:~:text=A%20perfect%20pizza%20is%20a%20combination%20of,a%20hot%20oven%2C%20ideally%20a%20wood%2Dfired%20oven",
          "title": "Discover the Top Qualities of the Perfect Pizza Pie - Doreen's Pizzeria. Opens in new tab.",
          "source": "Doreen's Pizza",
          "index": 3
        },
        {
          "href": "https://www.pizzauniversity.org/how-to-identify-good-pizza-in-8-easy-steps/",
          "title": "How to Identify Good Pizza in 8 Easy Steps. Opens in new tab.",
          "source": "Pizza University & Culinary Arts Center",
          "index": 4
        },
        {
          "href": "https://www.youtube.com/watch?v=mRx_odAj-XQ&t=407",
          "title": "The Best Pizza You'll Ever Make | Epicurious 101. Opens in new tab.",
          "source": "YouTube",
          "index": 5
        },
        {
          "href": "https://www.youtube.com/watch?v=9k3Ky2nn6MY&t=285",
          "title": "How to Make Restaurant Style Pizza At Home | Full Tutorial!. Opens in new tab.",
          "source": "YouTube",
          "index": 6
        },
        {
          "href": "https://thepizzapress.com/blog/pizzeria/what-makes-pizza-delicious/#:~:text=The%20Maillard%20Reaction%2C%20or%20browning%20reaction%2C%20refers,give%20foods%20like%20pizza%20a%20distinct%20flavor.",
          "title": "What Makes Pizza Delicious? - Pizzeria - The Pizza Press. Opens in new tab.",
          "source": "The Pizza Press",
          "index": 7
        },
        {
          "href": "https://www.pmq.com/doughs-and-donts-three-pizza-chefs-share-their-tips-for-achieving-a-delicious-crust/#:~:text=Fermentation%20is%20one%20of%20the%20most%20crucial,shape%2C%20texture%20and%20digestion%20of%20the%20pizza.",
          "title": "Doughs and Don'ts: Three Pizza Chefs Share Their Tips for Achieving a Delicious Crust. Opens in new tab.",
          "source": "PMQ Pizza",
          "index": 8
        }
      ]
    },
    "forums": {
      "items": [
        {
          "title": "How do you get the best pizza?How do you get the best pizza?",
          "source": "Quora",
          "subtitles": [
            "5 answers",
            "5 months ago"
          ],
          "link": "https://www.quora.com/How-do-you-get-the-best-pizza",
          "answers": [
            {
              "link": "https://www.quora.com/How-do-you-get-the-best-pizza?top_ans=1477743849516045",
              "extra": [
                "Top answer",
                "18 votes",
                "11 months ago"
              ],
              "is_top_answer": true
            },
            {
              "link": "https://www.quora.com/How-do-you-get-the-best-pizza?top_ans=1477743884716841",
              "extra": [
                "13 votes",
                "5 months ago"
              ]
            },
            {
              "link": "https://www.quora.com/How-do-you-get-the-best-pizza?top_ans=1477743884280104",
              "extra": [
                "12 votes",
                "5 months ago"
              ]
            },
            {
              "link": "https://www.quora.com/How-do-you-get-the-best-pizza?top_ans=1477743884280104",
              "extra": [
                "12 votes",
                "5 months ago"
              ]
            }
          ],
          "rank": 1,
          "global_rank": 23
        },
        {
          "title": "What makes a great pizza?What makes a great pizza?",
          "source": "Facebook",
          "subtitles": [
            "Pizzaholics",
            "260+ comments",
            "1 year ago"
          ],
          "link": "https://www.facebook.com/groups/742034912983989/posts/1885228215331314/",
          "answers": [
            {
              "link": "https://www.facebook.com/groups/742034912983989/posts/1885228215331314/?comment_id=1885276641993138",
              "extra": [
                "Top answer",
                "15 votes",
                "a year ago"
              ],
              "is_top_answer": true
            },
            {
              "link": "https://www.facebook.com/groups/742034912983989/posts/1885228215331314/?comment_id=1885330211987781",
              "extra": [
                "12 votes",
                "a year ago"
              ]
            },
            {
              "link": "https://www.facebook.com/groups/742034912983989/posts/1885228215331314/?comment_id=1885278108659658",
              "extra": [
                "12 votes",
                "a year ago"
              ]
            },
            {
              "link": "https://www.facebook.com/groups/742034912983989/posts/1885228215331314/?comment_id=1885278108659658",
              "extra": [
                "12 votes",
                "a year ago"
              ]
            },
            {
              "link": "https://www.facebook.com/groups/742034912983989/posts/1885228215331314/?comment_id=1885276641993138",
              "extra": [
                "Top answer",
                "15 votes",
                "a year ago"
              ],
              "is_top_answer": true
            },
            {
              "link": "https://www.facebook.com/groups/742034912983989/posts/1885228215331314/?comment_id=1885330211987781",
              "extra": [
                "12 votes",
                "a year ago"
              ]
            }
          ],
          "rank": 2,
          "global_rank": 24
        },
        {
          "title": "What is the secret to the best pizza?What is the secret to the best pizza?",
          "source": "Quora",
          "subtitles": [
            "2 answers",
            "11 months ago"
          ],
          "link": "https://www.quora.com/What-is-the-secret-to-the-best-pizza",
          "answers": [
            {
              "link": "https://www.quora.com/What-is-the-secret-to-the-best-pizza?top_ans=96565224",
              "extra": [
                "Top answer",
                "136 votes",
                "7 years ago"
              ],
              "is_top_answer": true
            },
            {
              "link": "https://www.quora.com/What-is-the-secret-to-the-best-pizza?top_ans=1477743734124602",
              "extra": [
                "62 votes",
                "2 years ago"
              ]
            },
            {
              "link": "https://www.quora.com/What-is-the-secret-to-the-best-pizza?top_ans=87669523",
              "extra": [
                "27 votes",
                "7 years ago"
              ]
            },
            {
              "link": "https://www.quora.com/What-is-the-secret-to-the-best-pizza?top_ans=87669523",
              "extra": [
                "27 votes",
                "7 years ago"
              ]
            },
            {
              "link": "https://www.quora.com/What-is-the-secret-to-the-best-pizza?top_ans=96565224",
              "extra": [
                "Top answer",
                "136 votes",
                "7 years ago"
              ],
              "is_top_answer": true
            },
            {
              "link": "https://www.quora.com/What-is-the-secret-to-the-best-pizza?top_ans=1477743734124602",
              "extra": [
                "62 votes",
                "2 years ago"
              ]
            }
          ],
          "rank": 3,
          "global_rank": 25
        }
      ]
    },
    "oragnic": [
      {
        "link": "https://www.thekitchn.com/types-of-pizza-23665322",
        "source": "The Kitchn",
        "display_link": "https://www.thekitchn.com › ... › Main Dishes › Pizza",
        "title": "12 Best Types of Pizza Everyone Needs to Know About",
        "description": "New York-style dough frequently has sugar and oil in the recipe, which adds flavor, helps the crust brown, and makes it easier to stretch. The ...Read more",
        "snippet_highlighted_words": [
          "New York-style dough frequently has sugar and oil in the recipe"
        ],
        "extensions": [
          {
            "inline": true,
            "type": "text",
            "text": "Jun 25, 2024",
            "rank": 1
          }
        ],
        "icon": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAABwAAA...",
        "rank": 1,
        "global_rank": 1
      },
      {
        "link": "https://www.bonappetit.com/story/best-homemade-pizza?srsltid=AfmBOoq3vbzR7ZqTK7r8PLxxSkJ0NcgOp_mhKFlgxr8mvrPvIHzsyklg",
        "source": "Bon Appétit",
        "display_link": "https://www.bonappetit.com › Cooking › Pizza",
        "title": "9 Rules for the Best Homemade Pizza OF YOUR LIFE",
        "description": "1. Store-bought Pizza Dough Is Totally Cool—If You Handle It Right · 2. You Need Two Kinds of Mozzarella · 3. Know When to Top · 4. Simple Sauce Is ...Read more",
        "snippet_highlighted_words": [
          "Store-bought Pizza Dough Is Totally Cool—If You Handle It Right"
        ],
        "extensions": [
          {
            "inline": true,
            "type": "text",
            "text": "Mar 28, 2017",
            "rank": 1
          }
        ],
        "icon": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAABwAAA...",
        "rank": 2,
        "global_rank": 21
      },
      {
        "link": "https://www.tastingtable.com/1552373/pizza-styles-ranked-worst-best/",
        "source": "Tasting Table",
        "display_link": "https://www.tastingtable.com › Exclusives › Opinion",
        "title": "14 Pizza Styles, Ranked Worst To Best",
        "description": "The perfect pizza is crisp, not soggy, and can be eaten in a variety of settings. Above all, I want a pizza that will taste the same whether I ...Read more",
        "snippet_highlighted_words": [
          "crisp, not soggy, and can be eaten in a variety of settings"
        ],
        "extensions": [
          {
            "inline": true,
            "type": "text",
            "text": "Apr 2, 2024",
            "rank": 1
          }
        ],
        "icon": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAABwAAA...",
        "rank": 3,
        "global_rank": 22
      }
    ]
  }
  ```
</ResponseExample>


# Asynchronous requests
Source: https://docs.brightdata.com/api-reference/serp/google-search/async





# Browser type
Source: https://docs.brightdata.com/api-reference/serp/google-search/browser

Configure the Bright Data Google Search Browser type parameter to refine queries and return matching results as JSON or HTML. On port 44445.

```http theme={null}
https://www.google.com/search?q=pizza&brd_browser=chrome
```

## Parameters

<ParamField type="string">
  The search query parameter. Specifies the keyword or phrase you want to search for on Google.
</ParamField>

<ParamField type="string">
  Define what browser to be represented in user-agent. Default will provide random browser.

  |           |                                                      |
  | --------- | ---------------------------------------------------- |
  | `chrome`  | Google Chrome                                        |
  | `safari`  | Apple Safari                                         |
  | `firefox` | Mozilla Firefox (not compatible with `brd_mobile=1`) |

  ```http theme={null}
  https://www.google.com/search?q=pizza&brd_browser=chrome
  ```

  <Tip>
    Can be combined with `brd_mobile` to get according mobile browser except for **Firefox**, which is not compatible with `brd_mobile=1`.
  </Tip>
</ParamField>

<RequestExample>
  ```shell cURL highlight={6} theme={null}
    curl -X POST https://api.brightdata.com/request \
    --header "Content-Type: application/json" \
    --header "Authorization: Bearer API_KEY" \
    --data '{
      "zone": "serp_api1",
      "url": "https://www.google.com/search?q=pizza&brd_browser=chrome",
      "format": "raw"
    }'
  ```

  ```shell Native proxy highlight={4} theme={null}
  curl --proxy brd.superproxy.io:44445 \
    --proxy-user CUSTOMER_USERNAME:CUSTOMER_PASSWORD \
    --ssl-no-revoke \
    "https://www.google.com/search?q=pizza&brd_browser=chrome"
  ```

  ```js Node.js highlight={10} theme={null}
  (async () => {
    const response = await fetch('https://api.brightdata.com/request', {
      method: 'POST',
      headers: {
        'Content-Type': 'application/json',
        'Authorization': 'Bearer API_KEY'
      },
      body: JSON.stringify({
        zone: 'serp_api1',
        url: 'https://www.google.com/search?q=pizza&brd_browser=chrome',
        format: 'raw'
      })
    });
    
    const data = await response.text();
    console.log(data);
  })();
  ```

  ```python Python highlight={11} theme={null}
  import requests

  # API Configuration
  headers = {
      'Content-Type': 'application/json',
      'Authorization': 'Bearer API_KEY',
  }

  payload = {
      'zone': 'serp_api1',
      'url': 'https://www.google.com/search?q=pizza&brd_browser=chrome',
      'format': 'raw'
  }

  # Make the request
  response = requests.post(
      'https://api.brightdata.com/request', 
      json=payload, 
      headers=headers
  )

  print(response.text)
  ```
</RequestExample>

<ResponseExample>
  ```json 200 highlight={16} theme={null}
  {
    "general": {
      "search_engine": "google",
      "query": "pizza",
      "results_cnt": 1200000000,
      "search_time": 0.6,
      "language": "en",
      "location": "United States",
      "mobile": false,
      "basic_view": false,
      "search_type": "text",
      "page_title": "pizza - Google Search",
      "timestamp": "2026-02-25T09:17:19.170Z"
    },
    "input": {
      "original_url": "https://www.google.com/search?q=pizza&brd_browser=chrome&brd_json=1",
      "request_id": "hl_xxxxxxxxxxxxxxx"
    },
    "navigation": [
      {
        "title": "AI Mode",
        "href": "https://www.google.com/search?q=pizza&newwindow=1&sca_esv=206cd4dd954885db&gl=US&hl=en&udm=50&fbs=ADc_l-aN0CWEZBOHjofHoaMMDiKpaEWjvZ2Py1XXV8d8KvlI3o6iwGk6Iv1tRbZIBNIVs-4Dki9dynYvfwBVZUSUkihwf6Po1X8vgm-4XqAkWV_U_mSmFfDrYQ3JJnT9pFVWyBg4AncR4kUgE3P9Dn8YQ2qpg4mGYZH3cN0xQoqqXY3iPBHuF6UXBhWnU9Lvfw4ijII1Eq0jCo7w_teMvuVi1Ne_ekoSug&aep=1&ntc=1&sa=X&ved=2ahUKEwiBwrzDp_SSAxV-VUEAHWFRK08Q2J8OegQIChAE"
      },
      {
        "title": "Images",
        "href": "https://www.google.com/search?newwindow=1&sca_esv=206cd4dd954885db&gl=US&hl=en&udm=2&fbs=ADc_l-aN0CWEZBOHjofHoaMMDiKpaEWjvZ2Py1XXV8d8KvlI3o6iwGk6Iv1tRbZIBNIVs-4Dki9dynYvfwBVZUSUkihwf6Po1X8vgm-4XqAkWV_U_mSmFfDrYQ3JJnT9pFVWyBg4AncR4kUgE3P9Dn8YQ2qpg4mGYZH3cN0xQoqqXY3iPBHuF6UXBhWnU9Lvfw4ijII1Eq0jCo7w_teMvuVi1Ne_ekoSug&q=pizza&sa=X&ved=2ahUKEwiBwrzDp_SSAxV-VUEAHWFRK08QtKgLegQIHRAB"
      },
      {
        "title": "Shopping",
        "href": "https://www.google.com/search?newwindow=1&sca_esv=206cd4dd954885db&gl=US&hl=en&udm=28&fbs=ADc_l-aN0CWEZBOHjofHoaMMDiKpaEWjvZ2Py1XXV8d8KvlI3o6iwGk6Iv1tRbZIBNIVs-4Dki9dynYvfwBVZUSUkihwf6Po1X8vgm-4XqAkWV_U_mSmFfDrYQ3JJnT9pFVWyBg4AncR4kUgE3P9Dn8YQ2qpg4mGYZH3cN0xQoqqXY3iPBHuF6UXBhWnU9Lvfw4ijII1Eq0jCo7w_teMvuVi1Ne_ekoSug&q=pizza&ved=1t:220175&ictx=111"
      },
      {
        "title": "Maps",
        "href": "https://maps.google.com/maps?newwindow=1&sca_esv=206cd4dd954885db&gl=US&hl=en&output=search&q=pizza&source=lnms&fbs=ADc_l-aN0CWEZBOHjofHoaMMDiKpaEWjvZ2Py1XXV8d8KvlI3o6iwGk6Iv1tRbZIBNIVs-4Dki9dynYvfwBVZUSUkihwf6Po1X8vgm-4XqAkWV_U_mSmFfDrYQ3JJnT9pFVWyBg4AncR4kUgE3P9Dn8YQ2qpg4mGYZH3cN0xQoqqXY3iPBHuF6UXBhWnU9Lvfw4ijII1Eq0jCo7w_teMvuVi1Ne_ekoSug&entry=mc&ved=1t:200715&ictx=111"
      },
      {
        "title": "Videos",
        "href": "https://www.google.com/search?newwindow=1&sca_esv=206cd4dd954885db&gl=US&hl=en&udm=7&fbs=ADc_l-aN0CWEZBOHjofHoaMMDiKpaEWjvZ2Py1XXV8d8KvlI3o6iwGk6Iv1tRbZIBNIVs-4Dki9dynYvfwBVZUSUkihwf6Po1X8vgm-4XqAkWV_U_mSmFfDrYQ3JJnT9pFVWyBg4AncR4kUgE3P9Dn8YQ2qpg4mGYZH3cN0xQoqqXY3iPBHuF6UXBhWnU9Lvfw4ijII1Eq0jCo7w_teMvuVi1Ne_ekoSug&q=pizza&sa=X&ved=2ahUKEwiBwrzDp_SSAxV-VUEAHWFRK08QtKgLegQIGhAB"
      },
      {
        "title": "Short videos",
        "href": "https://www.google.com/search?newwindow=1&sca_esv=206cd4dd954885db&gl=US&hl=en&udm=39&fbs=ADc_l-aN0CWEZBOHjofHoaMMDiKpaEWjvZ2Py1XXV8d8KvlI3o6iwGk6Iv1tRbZIBNIVs-4Dki9dynYvfwBVZUSUkihwf6Po1X8vgm-4XqAkWV_U_mSmFfDrYQ3JJnT9pFVWyBg4AncR4kUgE3P9Dn8YQ2qpg4mGYZH3cN0xQoqqXY3iPBHuF6UXBhWnU9Lvfw4ijII1Eq0jCo7w_teMvuVi1Ne_ekoSug&q=pizza&sa=X&ved=2ahUKEwiBwrzDp_SSAxV-VUEAHWFRK08Qs6gLegQIFxAB"
      },
      {
        "title": "News",
        "href": "https://www.google.com/search?newwindow=1&sca_esv=206cd4dd954885db&gl=US&hl=en&q=pizza&tbm=nws&source=lnms&fbs=ADc_l-aN0CWEZBOHjofHoaMMDiKpaEWjvZ2Py1XXV8d8KvlI3o6iwGk6Iv1tRbZIBNIVs-4Dki9dynYvfwBVZUSUkihwf6Po1X8vgm-4XqAkWV_U_mSmFfDrYQ3JJnT9pFVWyBg4AncR4kUgE3P9Dn8YQ2qpg4mGYZH3cN0xQoqqXY3iPBHuF6UXBhWnU9Lvfw4ijII1Eq0jCo7w_teMvuVi1Ne_ekoSug&sa=X&ved=2ahUKEwiBwrzDp_SSAxV-VUEAHWFRK08Q0pQJegUI0wEQAQ"
      },
      {
        "title": "Forums",
        "href": "https://www.google.com/search?newwindow=1&sca_esv=206cd4dd954885db&gl=US&hl=en&udm=18&fbs=ADc_l-aN0CWEZBOHjofHoaMMDiKpaEWjvZ2Py1XXV8d8KvlI3o6iwGk6Iv1tRbZIBNIVs-4Dki9dynYvfwBVZUSUkihwf6Po1X8vgm-4XqAkWV_U_mSmFfDrYQ3JJnT9pFVWyBg4AncR4kUgE3P9Dn8YQ2qpg4mGYZH3cN0xQoqqXY3iPBHuF6UXBhWnU9Lvfw4ijII1Eq0jCo7w_teMvuVi1Ne_ekoSug&q=pizza&sa=X&ved=2ahUKEwiBwrzDp_SSAxV-VUEAHWFRK08Qs6gLegUI1AEQAQ"
      },
      {
        "title": "Web",
        "href": "https://www.google.com/search?newwindow=1&sca_esv=206cd4dd954885db&gl=US&hl=en&udm=web&fbs=ADc_l-aN0CWEZBOHjofHoaMMDiKpaEWjvZ2Py1XXV8d8KvlI3o6iwGk6Iv1tRbZIBNIVs-4Dki9dynYvfwBVZUSUkihwf6Po1X8vgm-4XqAkWV_U_mSmFfDrYQ3JJnT9pFVWyBg4AncR4kUgE3P9Dn8YQ2qpg4mGYZH3cN0xQoqqXY3iPBHuF6UXBhWnU9Lvfw4ijII1Eq0jCo7w_teMvuVi1Ne_ekoSug&q=pizza&sa=X&ved=2ahUKEwiBwrzDp_SSAxV-VUEAHWFRK08Qs6gLegUI2QEQAQ"
      },
      {
        "title": "Books",
        "href": "https://www.google.com/search?newwindow=1&sca_esv=206cd4dd954885db&gl=US&hl=en&q=pizza&udm=36&source=lnms&fbs=ADc_l-aN0CWEZBOHjofHoaMMDiKpaEWjvZ2Py1XXV8d8KvlI3o6iwGk6Iv1tRbZIBNIVs-4Dki9dynYvfwBVZUSUkihwf6Po1X8vgm-4XqAkWV_U_mSmFfDrYQ3JJnT9pFVWyBg4AncR4kUgE3P9Dn8YQ2qpg4mGYZH3cN0xQoqqXY3iPBHuF6UXBhWnU9Lvfw4ijII1Eq0jCo7w_teMvuVi1Ne_ekoSug&sa=X&ved=2ahUKEwiBwrzDp_SSAxV-VUEAHWFRK08Q0pQJegUI2gEQAQ"
      },
      {
        "title": "Pizza",
        "href": "https://www.google.com/search?newwindow=1&sca_esv=206cd4dd954885db&gl=US&hl=en&q=Restaurant&uds=ALYpb_ncDc7jTlmw6Mmq7NjuX5c-YkRxG3oIOwBP9pqV8A9knLvLZuH8Ewms8PAcf7ea3t4NPsly-1JiYt9S6VsSRnLf-sxULmbNLebMKQgkhwHc2FSfFXQ&sa=X&ved=2ahUKEwiBwrzDp_SSAxV-VUEAHWFRK08Qkc0JKAB6BAgMEAE&ictx=0"
      }
    ],
    "organic": [
      {
        "link": "https://www.pizzahut.com/",
        "source": "Pizza Hut",
        "display_link": "https://www.pizzahut.com",
        "title": "Pizza Hut | Delivery & Carryout - No One OutPizzas The Hut!",
        "description": "$10 any pizza. Price includes Original Pan, Hand Tossed, Thin 'N Crispy. $10 ANY Large Pizza​. Up to 5 ...Read more",
        "snippet_highlighted_words": [
          "10 any pizza"
        ],
        "icon": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAABwAAA...",
        "image": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQABAAD/2w...",
        "image_alt": "pizza from www.pizzahut.com",
        "image_base64": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQABAAD/2w...",
        "rank": 1,
        "global_rank": 4
      },
      {
        "link": "https://www.dominos.com/",
        "source": "Domino's",
        "display_link": "https://www.dominos.com",
        "title": "Domino's: Pizza Delivery & Carryout, Pasta, Wings & More",
        "description": "Order pizza, pasta, sandwiches & more online for carryout or delivery from Domino's. View menu, find locations, track orders. Sign up for Domino's email ...",
        "snippet_highlighted_words": [
          "Order pizza, pasta, sandwiches & more online for carryout or delivery"
        ],
        "icon": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAABAAAA...",
        "image": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQABAAD/2w...",
        "image_alt": "pizza from www.dominos.com",
        "image_base64": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQABAAD/2w...",
        "rank": 2,
        "global_rank": 5
      },
      {
        "link": "https://www.papajohns.com/",
        "source": "Papa John's",
        "display_link": "https://www.papajohns.com",
        "title": "Papa Johns Pizza Delivery & Carryout - Best Deals on ...",
        "description": "Deals · Pizza · Papadias · Papa Bites · Wings · Sides · Papa Bowls · Desserts · Drinks · Dipping Sauces · Extras. Earn Papa Dough® faster than ever, and redeem ...Read more",
        "snippet_highlighted_words": [
          "Pizza"
        ],
        "icon": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAACAAAA...",
        "image": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQABAAD/2w...",
        "image_alt": "pizza from www.papajohns.com",
        "image_base64": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQABAAD/2w...",
        "rank": 3,
        "global_rank": 6
      },
      {
        "link": "https://www.reddit.com/r/Pizza/",
        "source": "Reddit · r/Pizza",
        "display_link": "1.9M+ followers",
        "title": "r/Pizza",
        "description": "r/Pizza: The home of pizza on reddit. An educational community devoted to the art of pizza making.",
        "snippet_highlighted_words": [
          "The home of pizza on reddit"
        ],
        "icon": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAABwAAA...",
        "image": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcQVF0IXZrsCdj1QZVGBDDYpj5kdwZyQKWtJo2GHJC8AUge29yskSxpE&usqp=CAE&s",
        "image_alt": "pizza from www.reddit.com",
        "image_url": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcQVF0IXZrsCdj1QZVGBDDYpj5kdwZyQKWtJo2GHJC8AUge29yskSxpE&usqp=CAE&s",
        "rank": 4,
        "global_rank": 11
      },
      {
        "link": "https://www.marcos.com/",
        "source": "Marco's Pizza",
        "display_link": "https://www.marcos.com",
        "title": "Marco's Pizza Online Ordering",
        "description": "Marco's Pizza Online Ordering is designed for ease-of-use. It's quick and easy to create an order, purchase, and schedule for delivery. Create an order now!",
        "snippet_highlighted_words": [
          "Marco's Pizza Online Ordering"
        ],
        "icon": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAACAAAA...",
        "rank": 5,
        "global_rank": 12
      },
      {
        "link": "https://www.youtube.com/watch?v=Bz6tlSbN_GA",
        "source": "YouTube · Andy Cooks",
        "display_link": "283.1K+ views · 5 days ago",
        "title": "Recreating The Takeaway Pizza Of My Childhood",
        "description": "Today I'm going to show you how to recreate at least my childhood memories of delicious bad pizza it's easily done at home.",
        "icon": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAABAAAA...",
        "image": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcQawToEk5MRMKlzdRutYRvfJGXtRpWQfVqXSJ2z8EdrkapJcXFUS00qnQ&s",
        "image_url": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcQawToEk5MRMKlzdRutYRvfJGXtRpWQfVqXSJ2z8EdrkapJcXFUS00qnQ&s",
        "duration": "13:55",
        "duration_sec": 835,
        "rank": 6,
        "global_rank": 13
      },
      {
        "link": "https://appizzashop.com/",
        "source": "AP Pizza Shop",
        "display_link": "https://appizzashop.com",
        "title": "Purpose Pizzeria DC — AP Pizza Shop Bethesda MD 20814",
        "description": "Discover AP Pizza in Bethesda, MD – where authentic Italian flavors meet hand-crafted pizzas, fresh ingredients, and a welcoming atmosphere.",
        "snippet_highlighted_words": [
          "authentic Italian flavors meet hand-crafted pizzas"
        ],
        "icon": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAACAAAA...",
        "image": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcSQDSwmOfaPtVZng_x8RcQXSNWy_tA1obBbBi_z8sjzvJtoA94Awbfk&usqp=CAE&s",
        "image_alt": "pizza from appizzashop.com",
        "image_url": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcSQDSwmOfaPtVZng_x8RcQXSNWy_tA1obBbBi_z8sjzvJtoA94Awbfk&usqp=CAE&s",
        "rank": 7,
        "global_rank": 14
      },
      {
        "link": "https://www.thekitchn.com/trader-joes-pizza-trick-podcast-23768950",
        "source": "The Kitchn",
        "display_link": "https://www.thekitchn.com › Groceries › Trader Joes",
        "title": "The Rule-Breaking Tip That Makes Frozen Pizza Taste 10x ...",
        "description": "Why You Should Thaw Your Pizza Before Heating It in the Oven. That's right. The key to making frozen pizzas taste like they just came out of a wood-fired oven ...Read more",
        "snippet_highlighted_words": [
          "Why You Should Thaw Your Pizza Before Heating It in the Oven"
        ],
        "icon": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAABwAAA...",
        "rank": 8,
        "global_rank": 15
      },
      {
        "link": "https://www.youtube.com/watch?v=h3qO7Jii3BE",
        "source": "YouTube · Vito Iacopelli",
        "display_link": "10.3K+ views · 3 days ago",
        "title": "How To Make Frozen Pizza Bases Ready Anytime at Home",
        "description": "We got frozen bases and we made this lovely pizza in 5 minutes and a home oven. It's soft it's crunchy it's lovely.",
        "icon": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAABAAAA...",
        "image": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcQQryZRNTdJCwsZlTiwg7DSFnDrbhpcsQg8yQzkCfnp0U444Br-92t0sQ&s",
        "image_url": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcQQryZRNTdJCwsZlTiwg7DSFnDrbhpcsQg8yQzkCfnp0U444Br-92t0sQ&s",
        "duration": "10:42",
        "duration_sec": 642,
        "rank": 9,
        "global_rank": 16
      }
    ],
    "perspectives": [
      {
        "title": "Barstool Pizza Review - Casey's Pizza (San Francisco, CA)",
        "author": "One Bite Pizza Reviews · YouTube",
        "source": "Pizza reviews & rankings",
        "date": "58.9K+ views · 10 hours ago",
        "link": "https://www.youtube.com/watch?v=wj4vtZ0FR1Y",
        "image": "https://img.youtube.com/vi/wj4vtZ0FR1Y/hqdefault.jpg",
        "image_url": "https://img.youtube.com/vi/wj4vtZ0FR1Y/hqdefault.jpg"
      },
      {
        "title": "Costco: Where to find most perfect slice of cheap cheese pizza. 🍕🙏🤤",
        "author": "r/Costco",
        "source": "Reddit",
        "date": "230+ comments · 7 hours ago",
        "link": "https://www.reddit.com/r/Costco/comments/1rdzzri/costco_where_to_find_most_perfect_slice_of_cheap/",
        "image": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcR56LIOT4XXriPnI8lkdNLieh_vVTIR2bkveJMrspN70Vc83Hvb7BHycWsG_g&usqp=CAI&s",
        "image_url": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcR56LIOT4XXriPnI8lkdNLieh_vVTIR2bkveJMrspN70Vc83Hvb7BHycWsG_g&usqp=CAI&s"
      },
      {
        "title": "Barstool Pizza Review - Casey’s Pizza (San Francisco, CA)",
        "author": "stoolpresidente · Instagram",
        "source": "American businessman",
        "date": "2K+ likes · 9 hours ago",
        "link": "https://www.instagram.com/reel/DVKIeZTlJCR/?hl=en",
        "image": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcQX9LeRL2aFzRhGOpiS2hlaI-MmNlAgUW_rPSWXklkzgSsmzx7R_pbGqtuCPQ&usqp=CAI&s=10",
        "image_url": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcQX9LeRL2aFzRhGOpiS2hlaI-MmNlAgUW_rPSWXklkzgSsmzx7R_pbGqtuCPQ&usqp=CAI&s=10"
      }
    ],
    "knowledge": {
      "name": "Pizza",
      "summary": "Dish",
      "subtitle": "Dish",
      "description": "Pizza is an Italian dish typically consisting of a flat base of leavened wheat-based dough topped with tomato, cheese, and other ingredients, baked at a high temperature, traditionally in a wood-fired oven.",
      "description_source": "Wikipedia",
      "description_link": "https://en.wikipedia.org/wiki/Pizza",
      "images": [
        {
          "image": "data:image/webp;base64,UklGRrYOAABXRUJQVlA4IKoOAACQVA...",
          "image_alt": "Image of Pizza Dough Recipe",
          "image_base64": "data:image/webp;base64,UklGRrYOAABXRUJQVlA4IKoOAACQVA..."
        },
        {
          "image": "data:image/webp;base64,UklGRk4KAABXRUJQVlA4IEIKAACQNg...",
          "image_alt": "Image of Salami, Red Onion and Oregano Pizza - Tillamook",
          "image_base64": "data:image/webp;base64,UklGRk4KAABXRUJQVlA4IEIKAACQNg..."
        },
        {
          "image": "data:image/webp;base64,UklGRmgIAABXRUJQVlA4IFwIAACwMg...",
          "image_alt": "Image of Homemade Pizza Recipe: How to Make It",
          "image_base64": "data:image/webp;base64,UklGRmgIAABXRUJQVlA4IFwIAACwMg..."
        }
      ],
      "facts": [
        {
          "key": "Origin",
          "predicate": "hw:/collection/dishes:origin",
          "value": [
            {
              "text": "Italy",
              "link": "https://www.google.com/search?newwindow=1&sca_esv=206cd4dd954885db&gl=US&hl=en&q=Italy&si=AL3DRZHmwLjWhgnaPB3UTu10R6S5qNLXiQiKMeezfKyB1FMsRgvMc15_a-XCDquvg02EcLVCDOBlFWcyGM1h_GEvApLCUHB4TbGV9DLLN_L5HXDRSM_AM0JjmkKGPEEkyRjAEOMkP_wbp9U4-YKGn63yz0_QGqKXGf1bKFT4vVVVz2XMsjUuOZt4AnSHQk-nDBQE0oBKvh4m&sa=X&ved=2ahUKEwiBwrzDp_SSAxV-VUEAHWFRK08QmxN6BAgWEAI"
            }
          ]
        }
      ],
      "nutrition_facts": {
        "product": "Pizza, 14\" regular crust",
        "source": "USDA",
        "source_link": "https://fdc.nal.usda.gov/food-details/173292/nutrients",
        "calories": "285 Calories",
        "portion": "1 slice (107 g)"
      }
    },
    "overview": {
      "title": "Pizza",
      "kgmid": "/m/0663v"
    },
    "snack_pack_map": {
      "image": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAowAAA...",
      "image_base64": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAowAAA...",
      "link": "https://www.google.com/search?q=pizza&newwindow=1&sca_esv=206cd4dd954885db&gl=US&hl=en&udm=1&lsack=Hb6eacG_JP6qhbIP4aKt-QQ&sa=X&ved=2ahUKEwiBwrzDp_SSAxV-VUEAHWFRK08QtgN6BAgvEAM"
    },
    "snack_pack": [
      {
        "cid": "11325640445402842264",
        "name": "PizzaForno",
        "image": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAFoAAA...",
        "image_base64": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAFoAAA...",
        "reviews_cnt": 4,
        "type": "Pizza",
        "work_status": "\"It's a fully robotic pizza machine that will bake your pizza in 4 minutes!\"\"It's a fully robotic pizza machine that will bake your pizza in 4 minutes!\"",
        "address": "Columbia, SC",
        "rank": 1,
        "global_rank": 1
      },
      {
        "cid": "2036127367591792815",
        "name": "Hunt Brothers Pizza",
        "image": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAFoAAA...",
        "image_base64": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAFoAAA...",
        "reviews_cnt": 1,
        "type": "Pizza",
        "price": "$",
        "work_status": "Pit stop for pizza & chicken wings",
        "address": "Hollister, MO",
        "rank": 2,
        "global_rank": 2
      },
      {
        "cid": "8168786693047694084",
        "name": "Oggi's Pizza & Brewing Co",
        "image": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQABAAD/2w...",
        "image_base64": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQABAAD/2w...",
        "reviews_cnt": 4,
        "type": "Pizza",
        "work_status": "Closed",
        "work_status_details": "Opens 11 AM",
        "address": "Garden Grove, CA",
        "rank": 3,
        "global_rank": 3
      }
    ],
    "pagination": {
      "pages": [
        {
          "page": 2,
          "start": 10,
          "link": "https://www.google.com/search?q=pizza&newwindow=1&sca_esv=206cd4dd954885db&gl=US&hl=en&ei=Hb6eacG_JP6qhbIP4aKt-QQ&start=10&sa=N&sstk=Af77f_fXDWinljh6N1MnT00YW7jFvYxOvFYGWISqzWpzHqImhmauvql47HKcreo0qrAmg9l8zq551x8DlM54zwN2G0HzwZ3jFgb4KQ&ved=2ahUKEwiBwrzDp_SSAxV-VUEAHWFRK08Q8tMDegQICRAE"
        },
        {
          "page": 3,
          "start": 20,
          "link": "https://www.google.com/search?q=pizza&newwindow=1&sca_esv=206cd4dd954885db&gl=US&hl=en&ei=Hb6eacG_JP6qhbIP4aKt-QQ&start=20&sa=N&sstk=Af77f_fXDWinljh6N1MnT00YW7jFvYxOvFYGWISqzWpzHqImhmauvql47HKcreo0qrAmg9l8zq551x8DlM54zwN2G0HzwZ3jFgb4KQ&ved=2ahUKEwiBwrzDp_SSAxV-VUEAHWFRK08Q8tMDegQICRAG"
        },
        {
          "page": 4,
          "start": 30,
          "link": "https://www.google.com/search?q=pizza&newwindow=1&sca_esv=206cd4dd954885db&gl=US&hl=en&ei=Hb6eacG_JP6qhbIP4aKt-QQ&start=30&sa=N&sstk=Af77f_fXDWinljh6N1MnT00YW7jFvYxOvFYGWISqzWpzHqImhmauvql47HKcreo0qrAmg9l8zq551x8DlM54zwN2G0HzwZ3jFgb4KQ&ved=2ahUKEwiBwrzDp_SSAxV-VUEAHWFRK08Q8tMDegQICRAI"
        }
      ],
      "current_page": 1,
      "next_page": 2,
      "next_page_start": 10,
      "next_page_link": "https://www.google.com/search?q=pizza&newwindow=1&sca_esv=206cd4dd954885db&gl=US&hl=en&ei=Hb6eacG_JP6qhbIP4aKt-QQ&start=10&sa=N&sstk=Af77f_fXDWinljh6N1MnT00YW7jFvYxOvFYGWISqzWpzHqImhmauvql47HKcreo0qrAmg9l8zq551x8DlM54zwN2G0HzwZ3jFgb4KQ&ved=2ahUKEwiBwrzDp_SSAxV-VUEAHWFRK08Q8tMDegQICRAE"
    },
    "related": [
      {
        "text": "Pizza Hut near me",
        "link": "https://www.google.com/search?newwindow=1&sca_esv=206cd4dd954885db&gl=US&hl=en&q=Pizza+Hut+near+me&sa=X&ved=2ahUKEwiBwrzDp_SSAxV-VUEAHWFRK08Q1QJ6BAhgEAE",
        "rank": 1,
        "global_rank": 17
      },
      {
        "text": "Pizza Hut menu",
        "link": "https://www.google.com/search?newwindow=1&sca_esv=206cd4dd954885db&gl=US&hl=en&q=Pizza+Hut+menu&sa=X&ved=2ahUKEwiBwrzDp_SSAxV-VUEAHWFRK08Q1QJ6BAh4EAE",
        "rank": 2,
        "global_rank": 18
      },
      {
        "text": "Pizza open",
        "link": "https://www.google.com/search?newwindow=1&sca_esv=206cd4dd954885db&gl=US&hl=en&q=Pizza+open&sa=X&ved=2ahUKEwiBwrzDp_SSAxV-VUEAHWFRK08Q1QJ6BAh2EAE",
        "rank": 3,
        "global_rank": 19
      }
    ],
    "people_also_ask": [
      {
        "question": "What's the 2 hour rule for pizza?",
        "question_type": "featured",
        "answer_source": "Curry Pizza House",
        "answer_link": "https://currypizzahouse.com/georgiadoubleupsocial-com/how-long-does-pizza-last/#:~:text=Pizza%20should%20NEVER%20be%20left,to%20prevent%20rapid%20bacteria%20growth.",
        "answer_display_link": "https://currypizzahouse.com › how-long-does-pizza-lasthttps://currypizzahouse.com › how-long-does-pizza-last",
        "answers": [
          {
            "type": "answer",
            "value": {
              "text": "Pizza should NEVER be left out for more than 2 hours (and just 1 hour if the room is above 90°F/32°C). Hot/Outdoor Events: When it's really warm, the safe window shrinks—refrigerate or ice your pizza within 20–60 minutes to prevent rapid bacteria growth.Jun 29, 2025"
            },
            "rank": 1
          }
        ],
        "rank": 1,
        "global_rank": 7
      }
    ],
    "oragnic": [
      {
        "link": "https://www.pizzahut.com/",
        "source": "Pizza Hut",
        "display_link": "https://www.pizzahut.com",
        "title": "Pizza Hut | Delivery & Carryout - No One OutPizzas The Hut!",
        "description": "$10 any pizza. Price includes Original Pan, Hand Tossed, Thin 'N Crispy. $10 ANY Large Pizza​. Up to 5 ...Read more",
        "snippet_highlighted_words": [
          "10 any pizza"
        ],
        "icon": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAABwAAA...",
        "image": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQABAAD/2w...",
        "image_alt": "pizza from www.pizzahut.com",
        "image_base64": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQABAAD/2w...",
        "rank": 1,
        "global_rank": 4
      },
      {
        "link": "https://www.dominos.com/",
        "source": "Domino's",
        "display_link": "https://www.dominos.com",
        "title": "Domino's: Pizza Delivery & Carryout, Pasta, Wings & More",
        "description": "Order pizza, pasta, sandwiches & more online for carryout or delivery from Domino's. View menu, find locations, track orders. Sign up for Domino's email ...",
        "snippet_highlighted_words": [
          "Order pizza, pasta, sandwiches & more online for carryout or delivery"
        ],
        "icon": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAABAAAA...",
        "image": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQABAAD/2w...",
        "image_alt": "pizza from www.dominos.com",
        "image_base64": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQABAAD/2w...",
        "rank": 2,
        "global_rank": 5
      },
      {
        "link": "https://www.papajohns.com/",
        "source": "Papa John's",
        "display_link": "https://www.papajohns.com",
        "title": "Papa Johns Pizza Delivery & Carryout - Best Deals on ...",
        "description": "Deals · Pizza · Papadias · Papa Bites · Wings · Sides · Papa Bowls · Desserts · Drinks · Dipping Sauces · Extras. Earn Papa Dough® faster than ever, and redeem ...Read more",
        "snippet_highlighted_words": [
          "Pizza"
        ],
        "icon": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAACAAAA...",
        "image": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQABAAD/2w...",
        "image_alt": "pizza from www.papajohns.com",
        "image_base64": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQABAAD/2w...",
        "rank": 3,
        "global_rank": 6
      }
    ]
  }
  ```
</ResponseExample>


# Device (platform)
Source: https://docs.brightdata.com/api-reference/serp/google-search/device-ios

Configure the Bright Data Google Search Device (Platform) parameter to refine queries and return matching results as JSON or HTML. On port 44445.

```http theme={null}
https://www.google.com/search?q=pizza&brd_mobile=ios
```

## Parameters

<ParamField type="string">
  The search query parameter. Specifies the keyword or phrase you want to search for on Google.
</ParamField>

<ParamField type="string">
  Define what device type to be represented in user-agent.

  For specific mobile platform provide one of the following values:

  | Value            | Description       | Usage                                                    |
  | ---------------- | ----------------- | -------------------------------------------------------- |
  | `ios`            | iPhone user-agent | `brd_mobile=ios` <br /> (alias `brd_mobile=iphone`)      |
  | `ipad`           | iPad user-agent   | `brd_mobile=ipad` <br /> (alias `brd_mobile=ios_tablet`) |
  | `android`        | Android phone     | `brd_mobile=android`                                     |
  | `android_tablet` | Android tablet    | `brd_mobile=android_tablet`                              |

  ```http theme={null}
  https://www.google.com/search?q=pizza&brd_mobile=ios
  ```
</ParamField>

<RequestExample>
  ```shell cURL highlight={6} theme={null}
    curl -X POST https://api.brightdata.com/request \
    --header "Content-Type: application/json" \
    --header "Authorization: Bearer API_KEY" \
    --data '{
      "zone": "serp_api1",
      "url": "https://www.google.com/search?q=pizza&brd_mobile=ios",
      "format": "raw"
    }'
  ```

  ```js Node.js highlight={10} theme={null}
  (async () => {
    const response = await fetch('https://api.brightdata.com/request', {
      method: 'POST',
      headers: {
        'Content-Type': 'application/json',
        'Authorization': 'Bearer API_KEY'
      },
      body: JSON.stringify({
        zone: 'serp_api1',
        url: 'https://www.google.com/search?q=pizza&brd_mobile=ios',
        format: 'raw'
      })
    });
    
    const data = await response.text();
    console.log(data);
  })();
  ```

  ```shell Native proxy highlight={4} theme={null}
  curl --proxy brd.superproxy.io:44445 \
    --proxy-user CUSTOMER_USERNAME:CUSTOMER_PASSWORD \
    --ssl-no-revoke \
    "https://www.google.com/search?q=pizza&brd_mobile=ios"
  ```

  ```python Python highlight={11} theme={null}
  import requests

  # API Configuration
  headers = {
      'Content-Type': 'application/json',
      'Authorization': 'Bearer API_KEY',
  }

  payload = {
      'zone': 'serp_api1',
      'url': 'https://www.google.com/search?q=pizza&brd_mobile=ios',
      'format': 'raw'
  }

  # Make the request
  response = requests.post(
      'https://api.brightdata.com/request', 
      json=payload, 
      headers=headers
  )

  print(response.text)
  ```
</RequestExample>

<ResponseExample>
  ```json 200 highlight={7} theme={null}
  {
    "general": {
      "search_engine": "google",
      "query": "pizza",
      "language": "en",
      "location": "United States",
      "mobile": true,
      "basic_view": false,
      "search_type": "text",
      "page_title": "pizza - Google Search",
      "timestamp": "2026-02-25T09:13:58.036Z"
    },
    "input": {
      "original_url": "https://www.google.com/search?q=pizza&brd_mobile=ios&brd_json=1",
      "request_id": "hl_xxxxxxxxxxxxxxx"
    },
    "navigation": [
      {
        "title": "AI Mode",
        "href": "https://www.google.com/search?q=pizza&sca_esv=206cd4dd954885db&gl=US&hl=en&udm=50&aep=1&ntc=1&sa=X&ved=2ahUKEwj0zKzjpvSSAxXfIzQIHdCgKT4Q2J8OegQIBBAX"
      },
      {
        "title": "AI Mode",
        "href": "https://www.google.com/search?q=pizza&sca_esv=206cd4dd954885db&gl=US&hl=en&udm=50&fbs=ADc_l-bZnt6jMmErT-KRarIgXyuyEbgLVbVrL19D752u5Zq1JxsknUc6k2WnAYdF3IRSWkTH3pdQosATZjd3_wJT0jcn1ZGvea0l_Pe81RHnOCa9zKvy8rYGCOaVH6HKJ-v0Fbf3M4pWfq-1w08PlFYboBjESgVjCWuPSKS93yTwhvPbs5RLCAIhZYAj5yDun18lG7HGkbSgcdz0s_2rVuotT_RFlq9E6vh4gSWXTpD9fiMHs21DAcw&aep=1&ntc=1&sa=X&ved=2ahUKEwj0zKzjpvSSAxXfIzQIHdCgKT4Q2J8OegQIDhAE"
      },
      {
        "title": "Images",
        "href": "https://www.google.com/search?sca_esv=206cd4dd954885db&gl=US&hl=en&udm=2&fbs=ADc_l-bZnt6jMmErT-KRarIgXyuyEbgLVbVrL19D752u5Zq1JxsknUc6k2WnAYdF3IRSWkTH3pdQosATZjd3_wJT0jcn1ZGvea0l_Pe81RHnOCa9zKvy8rYGCOaVH6HKJ-v0Fbf3M4pWfq-1w08PlFYboBjESgVjCWuPSKS93yTwhvPbs5RLCAIhZYAj5yDun18lG7HGkbSgcdz0s_2rVuotT_RFlq9E6vh4gSWXTpD9fiMHs21DAcw&q=pizza&sa=X&ved=2ahUKEwj0zKzjpvSSAxXfIzQIHdCgKT4QtKgLegQIFBAB"
      },
      {
        "title": "Shopping",
        "href": "https://www.google.com/search?sca_esv=206cd4dd954885db&gl=US&hl=en&udm=28&fbs=ADc_l-bZnt6jMmErT-KRarIgXyuyEbgLVbVrL19D752u5Zq1JxsknUc6k2WnAYdF3IRSWkTH3pdQosATZjd3_wJT0jcn1ZGvea0l_Pe81RHnOCa9zKvy8rYGCOaVH6HKJ-v0Fbf3M4pWfq-1w08PlFYboBjESgVjCWuPSKS93yTwhvPbs5RLCAIhZYAj5yDun18lG7HGkbSgcdz0s_2rVuotT_RFlq9E6vh4gSWXTpD9fiMHs21DAcw&q=pizza&ved=1t:220175&ictx=111"
      },
      {
        "title": "Maps",
        "href": "https://maps.google.com/maps?sca_esv=206cd4dd954885db&gl=US&hl=en&output=search&q=pizza&source=lnms&fbs=ADc_l-bZnt6jMmErT-KRarIgXyuyEbgLVbVrL19D752u5Zq1JxsknUc6k2WnAYdF3IRSWkTH3pdQosATZjd3_wJT0jcn1ZGvea0l_Pe81RHnOCa9zKvy8rYGCOaVH6HKJ-v0Fbf3M4pWfq-1w08PlFYboBjESgVjCWuPSKS93yTwhvPbs5RLCAIhZYAj5yDun18lG7HGkbSgcdz0s_2rVuotT_RFlq9E6vh4gSWXTpD9fiMHs21DAcw&entry=mc&ved=1t:200715&ictx=111"
      },
      {
        "title": "Videos",
        "href": "https://www.google.com/search?sca_esv=206cd4dd954885db&gl=US&hl=en&udm=7&fbs=ADc_l-bZnt6jMmErT-KRarIgXyuyEbgLVbVrL19D752u5Zq1JxsknUc6k2WnAYdF3IRSWkTH3pdQosATZjd3_wJT0jcn1ZGvea0l_Pe81RHnOCa9zKvy8rYGCOaVH6HKJ-v0Fbf3M4pWfq-1w08PlFYboBjESgVjCWuPSKS93yTwhvPbs5RLCAIhZYAj5yDun18lG7HGkbSgcdz0s_2rVuotT_RFlq9E6vh4gSWXTpD9fiMHs21DAcw&q=pizza&sa=X&ved=2ahUKEwj0zKzjpvSSAxXfIzQIHdCgKT4QtKgLegQIERAB"
      },
      {
        "title": "Short videos",
        "href": "https://www.google.com/search?sca_esv=206cd4dd954885db&gl=US&hl=en&udm=39&fbs=ADc_l-bZnt6jMmErT-KRarIgXyuyEbgLVbVrL19D752u5Zq1JxsknUc6k2WnAYdF3IRSWkTH3pdQosATZjd3_wJT0jcn1ZGvea0l_Pe81RHnOCa9zKvy8rYGCOaVH6HKJ-v0Fbf3M4pWfq-1w08PlFYboBjESgVjCWuPSKS93yTwhvPbs5RLCAIhZYAj5yDun18lG7HGkbSgcdz0s_2rVuotT_RFlq9E6vh4gSWXTpD9fiMHs21DAcw&q=pizza&sa=X&ved=2ahUKEwj0zKzjpvSSAxXfIzQIHdCgKT4Qs6gLegQIEBAB"
      },
      {
        "title": "News",
        "href": "https://www.google.com/search?sca_esv=206cd4dd954885db&gl=US&hl=en&q=pizza&tbm=nws&source=lnms&fbs=ADc_l-bZnt6jMmErT-KRarIgXyuyEbgLVbVrL19D752u5Zq1JxsknUc6k2WnAYdF3IRSWkTH3pdQosATZjd3_wJT0jcn1ZGvea0l_Pe81RHnOCa9zKvy8rYGCOaVH6HKJ-v0Fbf3M4pWfq-1w08PlFYboBjESgVjCWuPSKS93yTwhvPbs5RLCAIhZYAj5yDun18lG7HGkbSgcdz0s_2rVuotT_RFlq9E6vh4gSWXTpD9fiMHs21DAcw&sa=X&ved=2ahUKEwj0zKzjpvSSAxXfIzQIHdCgKT4Q0pQJegUInAIQAQ"
      },
      {
        "title": "Forums",
        "href": "https://www.google.com/search?sca_esv=206cd4dd954885db&gl=US&hl=en&udm=18&fbs=ADc_l-bZnt6jMmErT-KRarIgXyuyEbgLVbVrL19D752u5Zq1JxsknUc6k2WnAYdF3IRSWkTH3pdQosATZjd3_wJT0jcn1ZGvea0l_Pe81RHnOCa9zKvy8rYGCOaVH6HKJ-v0Fbf3M4pWfq-1w08PlFYboBjESgVjCWuPSKS93yTwhvPbs5RLCAIhZYAj5yDun18lG7HGkbSgcdz0s_2rVuotT_RFlq9E6vh4gSWXTpD9fiMHs21DAcw&q=pizza&sa=X&ved=2ahUKEwj0zKzjpvSSAxXfIzQIHdCgKT4Qs6gLegUImwIQAQ"
      },
      {
        "title": "Web",
        "href": "https://www.google.com/search?sca_esv=206cd4dd954885db&gl=US&hl=en&udm=web&fbs=ADc_l-bZnt6jMmErT-KRarIgXyuyEbgLVbVrL19D752u5Zq1JxsknUc6k2WnAYdF3IRSWkTH3pdQosATZjd3_wJT0jcn1ZGvea0l_Pe81RHnOCa9zKvy8rYGCOaVH6HKJ-v0Fbf3M4pWfq-1w08PlFYboBjESgVjCWuPSKS93yTwhvPbs5RLCAIhZYAj5yDun18lG7HGkbSgcdz0s_2rVuotT_RFlq9E6vh4gSWXTpD9fiMHs21DAcw&q=pizza&sa=X&ved=2ahUKEwj0zKzjpvSSAxXfIzQIHdCgKT4Qs6gLegUIqQIQAQ"
      },
      {
        "title": "Books",
        "href": "https://www.google.com/search?sca_esv=206cd4dd954885db&gl=US&hl=en&q=pizza&udm=36&source=lnms&fbs=ADc_l-bZnt6jMmErT-KRarIgXyuyEbgLVbVrL19D752u5Zq1JxsknUc6k2WnAYdF3IRSWkTH3pdQosATZjd3_wJT0jcn1ZGvea0l_Pe81RHnOCa9zKvy8rYGCOaVH6HKJ-v0Fbf3M4pWfq-1w08PlFYboBjESgVjCWuPSKS93yTwhvPbs5RLCAIhZYAj5yDun18lG7HGkbSgcdz0s_2rVuotT_RFlq9E6vh4gSWXTpD9fiMHs21DAcw&sa=X&ved=2ahUKEwj0zKzjpvSSAxXfIzQIHdCgKT4Q0pQJegUIqgIQAQ"
      },
      {
        "title": "Flights",
        "href": "https://www.google.com/travel/flights?sca_esv=206cd4dd954885db&gl=US&hl=en&output=search&q=pizza&source=lnms&fbs=ADc_l-bZnt6jMmErT-KRarIgXyuyEbgLVbVrL19D752u5Zq1JxsknUc6k2WnAYdF3IRSWkTH3pdQosATZjd3_wJT0jcn1ZGvea0l_Pe81RHnOCa9zKvy8rYGCOaVH6HKJ-v0Fbf3M4pWfq-1w08PlFYboBjESgVjCWuPSKS93yTwhvPbs5RLCAIhZYAj5yDun18lG7HGkbSgcdz0s_2rVuotT_RFlq9E6vh4gSWXTpD9fiMHs21DAcw&ved=1t:200715&ictx=111"
      },
      {
        "title": "Finance",
        "href": "https://www.google.com/finance?sca_esv=206cd4dd954885db&gl=US&hl=en&output=search&q=pizza&source=lnms&fbs=ADc_l-bZnt6jMmErT-KRarIgXyuyEbgLVbVrL19D752u5Zq1JxsknUc6k2WnAYdF3IRSWkTH3pdQosATZjd3_wJT0jcn1ZGvea0l_Pe81RHnOCa9zKvy8rYGCOaVH6HKJ-v0Fbf3M4pWfq-1w08PlFYboBjESgVjCWuPSKS93yTwhvPbs5RLCAIhZYAj5yDun18lG7HGkbSgcdz0s_2rVuotT_RFlq9E6vh4gSWXTpD9fiMHs21DAcw&sa=X&ved=2ahUKEwj0zKzjpvSSAxXfIzQIHdCgKT4Q0pQJegUIpwIQAQ"
      }
    ],
    "organic": [
      {
        "link": "https://www.pizzahut.com/",
        "title": "Pizza Hut | Delivery & Carryout - No One OutPizzas The Hut!",
        "description": "$10 any pizza. Price includes Original Pan, Hand Tossed, Thin 'N Crispy. $10 ANY Large Pizza​. Up to 5 ...",
        "rank": 1,
        "global_rank": 5
      },
      {
        "link": "https://www.dominos.com/",
        "title": "Domino's: Pizza Delivery & Carryout, Pasta, Wings & More",
        "description": "Order pizza, pasta, sandwiches & more online for carryout or delivery from Domino's. View menu, find locations, track orders. Sign up for Domino's email ...",
        "image": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcTBMgmhIihdzXKJSaNX2FtUC1cunqgi_Yg-BMi2gscWl4SHC4Zx2-NXdro&usqp=CAE&s",
        "image_alt": "pizza from www.dominos.com",
        "image_url": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcTBMgmhIihdzXKJSaNX2FtUC1cunqgi_Yg-BMi2gscWl4SHC4Zx2-NXdro&usqp=CAE&s",
        "rank": 2,
        "global_rank": 6
      },
      {
        "link": "https://www.papajohns.com/",
        "title": "Papa Johns Pizza Delivery & Carryout - Best Deals on Pizza, Sides & More",
        "description": "Deals · Pizza · Papadias · Papa Bites · Wings · Sides · Papa Bowls · Desserts · Drinks · Dipping Sauces · Extras. Earn Papa Dough® faster than ever, and redeem ...",
        "rank": 3,
        "global_rank": 7
      },
      {
        "link": "https://www.pizzamyheart.com/",
        "title": "Pizza My Heart for pizza by the slice or whole pie",
        "description": "Pizza by the slice or whole pie with a focus on natural locally grown ingredients from California farms. Fresh salads, craft beers and a laid-back surf ...",
        "rank": 4,
        "global_rank": 8
      },
      {
        "link": "https://primepizza.com/",
        "title": "Prime Pizza | Authentic New York–Style Pizza in Los Angeles & Orange County",
        "description": "Discover Prime Pizza — serving the best New York–style pizza in Los Angeles and coming soon to Orange County. Fresh ingredients, housemade dough, ...",
        "image": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcSc78x5sSE2Dq_n5R8zvr0QJw2AWoxBLBQFLnXxUtPUhb0C_asv7_Xv-WE&usqp=CAE&s",
        "image_alt": "pizza from primepizza.com",
        "image_url": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcSc78x5sSE2Dq_n5R8zvr0QJw2AWoxBLBQFLnXxUtPUhb0C_asv7_Xv-WE&usqp=CAE&s",
        "rank": 5,
        "global_rank": 9
      },
      {
        "link": "https://pagliacci.com/",
        "title": "Pagliacci Pizza: Seattle Area Pizza & Delivery | Pagliacci Pizza",
        "description": "Pagliacci Pizza, serving Seattle's best pizza since 1979. Offering pizza by the slice and pizza delivery service to homes and businesses.",
        "rank": 6,
        "global_rank": 13
      },
      {
        "link": "https://www.jetspizza.com/",
        "title": "Jet's Pizza: Pizza, Wings, and Salads",
        "description": "Jet's makes pizza, wings and salads using quality ingredients and has hundreds of locations in 20 states.",
        "image": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcTldmM9Lc9i5UCyD0dDl73aevUz-TXbunV1fmfWC1aYLW9uUzdjli5hOfU&usqp=CAE&s",
        "image_alt": "pizza from www.jetspizza.com",
        "image_url": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcTldmM9Lc9i5UCyD0dDl73aevUz-TXbunV1fmfWC1aYLW9uUzdjli5hOfU&usqp=CAE&s",
        "rank": 7,
        "global_rank": 14
      },
      {
        "link": "https://www.spinatospizzeria.com/",
        "title": "Spinato's Pizzeria: Best Restaurant Near Me - Spinato's Pizzeria",
        "description": "Savor classic Italian flavors at Spinato's Pizzeria, the best restaurant near me. Family-owned, offering delicious pizzas, pastas, and more!",
        "image": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcRGnCOkZk6SizIss5cuiBfaISZqSMGuq_6Yb-XzMxkxS9g9gMXnrRI2jHk&usqp=CAE&s",
        "image_alt": "pizza from www.spinatospizzeria.com",
        "image_url": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcRGnCOkZk6SizIss5cuiBfaISZqSMGuq_6Yb-XzMxkxS9g9gMXnrRI2jHk&usqp=CAE&s",
        "rank": 8,
        "global_rank": 15
      }
    ],
    "videos": [
      {
        "link": "https://www.youtube.com/watch?v=Bz6tlSbN_GA",
        "title": "Recreating The Takeaway Pizza Of My Childhood",
        "author": "5 days ago",
        "rank": 1,
        "global_rank": 10
      },
      {
        "link": "https://www.youtube.com/watch?v=h3qO7Jii3BE",
        "title": "How To Make Frozen Pizza Bases Ready Anytime at Home",
        "author": "3 days ago",
        "rank": 2,
        "global_rank": 11
      },
      {
        "link": "https://www.youtube.com/watch?v=TB5JPppUZpY",
        "title": "LEFTOVER PIZZA WILL NEVER BE THE SAME...",
        "author": "1 day ago",
        "rank": 3,
        "global_rank": 12
      }
    ],
    "overview": {
      "title": "Pizza",
      "kgmid": "/m/0663v"
    },
    "pagination": {
      "next_page_start": 10,
      "next_page_link": "https://www.google.com/search?q=pizza&sca_esv=206cd4dd954885db&gl=US&hl=en&prmd=misvn&ei=VL2eafRS38fQ8Q_QwabxAw&start=10&sa=N"
    },
    "related": [
      {
        "text": "Pizza Hut near me",
        "link": "https://www.google.com/search?sca_esv=206cd4dd954885db&gl=US&hl=en&q=Pizza+Hut+near+me&sa=X&ved=2ahUKEwj0zKzjpvSSAxXfIzQIHdCgKT4Q1QJ6BQisARAB",
        "rank": 1,
        "global_rank": 16
      },
      {
        "text": "Pizza Hut menu",
        "link": "https://www.google.com/search?sca_esv=206cd4dd954885db&gl=US&hl=en&q=Pizza+Hut+menu&sa=X&ved=2ahUKEwj0zKzjpvSSAxXfIzQIHdCgKT4Q1QJ6BQjRARAB",
        "rank": 2,
        "global_rank": 17
      },
      {
        "text": "Pizza definition",
        "link": "https://www.google.com/search?sca_esv=206cd4dd954885db&gl=US&hl=en&q=Pizza+definition&sa=X&ved=2ahUKEwj0zKzjpvSSAxXfIzQIHdCgKT4Q1QJ6BQjNARAB",
        "rank": 3,
        "global_rank": 18
      }
    ],
    "people_also_ask": [
      {
        "question": "What's the 2 hour rule for pizza?",
        "question_type": "featured",
        "answer_link": "https://currypizzahouse.com/georgiadoubleupsocial-com/how-long-does-pizza-last/#:~:text=Pizza%20should%20NEVER%20be%20left,to%20prevent%20rapid%20bacteria%20growth.",
        "answer_display_link": "https://currypizzahouse.com",
        "answers": [
          {
            "type": "answer",
            "value": {
              "text": "Pizza should NEVER be left out for more than 2 hours (and just 1 hour if the room is above 90°F/32°C). Hot/Outdoor Events: When it's really warm, the safe window shrinks—refrigerate or ice your pizza within 20–60 minutes to prevent rapid bacteria growth.Jun 29, 2025"
            },
            "rank": 1
          }
        ],
        "rank": 1,
        "global_rank": 1
      },
      {
        "question": "Who has the $4.99 pizza deal?",
        "question_type": "ai_overview",
        "answers": [
          {
            "texts": [
              {
                "type": "paragraph",
                "snippet": "Little Caesars frequently offers $4.99 pizza deals, often for two large one-topping pizzas or their Detroit-Style Slices-N-Stix combo, available for limited times with online codes like \"PIZZAPIZZA,\" so check their deals page or app for current offers.",
                "snippet_highlighted_words": "Little Caesars"
              },
              {
                "type": "list",
                "list": [
                  {
                    "type": "paragraph",
                    "snippet": "Check Little Caesars' Website/App: Look for limited-time offers and deals sections."
                  },
                  {
                    "type": "paragraph",
                    "snippet": "Look for Codes: They often use codes like \"PIZZAPIZZA\" for online orders."
                  },
                  {
                    "type": "list",
                    "title": "Specific Promotions: Recent examples include:",
                    "list": [
                      {
                        "type": "paragraph",
                        "snippet": "2 Large 1-Topping Pizzas: for $4.99 each (online deal)."
                      },
                      {
                        "type": "paragraph",
                        "snippet": "Detroit-Style Slices-N-Stix Combo: (2 pepperoni slices + Crazy Bread) for $4.99 (lunch special)."
                      },
                      {
                        "type": "paragraph",
                        "snippet": "Sicilian Style Pizza: for $4.99."
                      }
                    ]
                  }
                ],
                "title": "How to find current deals:"
              },
              {
                "type": "list",
                "list": [
                  {
                    "type": "paragraph",
                    "snippet": "These are often limited-time offers and prices can vary by location."
                  },
                  {
                    "type": "paragraph",
                    "snippet": "Some deals require online ordering or specific promo codes."
                  }
                ],
                "title": "Keep in mind:"
              }
            ],
            "references": [
              {
                "href": "https://littlecaesars.com/en-us/deals/#:~:text=Little%20Caesars%C2%AE,Limited%2DTime%20Pizza%20Deals",
                "title": "Little Caesars®| Limited-Time Pizza Deals",
                "subtitle": "Little Caesars® | Limited-Time Pizza Deals.",
                "source": "Little Caesarshttps://littlecaesars.com",
                "index": 0
              },
              {
                "href": "https://www.facebook.com/LittleCaesars/posts/get-2-large-pizzas-for-499-each-online-only-with-promo-code-pizzapizza/1187325250106928/#:~:text=get%202%20large%20pizzas%20for%204.99%20each%20online%20only%20with%20promo%20code%20PIZZAPIZZA",
                "title": "get 2 large pizzas for 4.99 each online only with promo code ...",
                "subtitle": "Aug 26, 2025 — get 2 large pizzas for 4.99 each online only with promo code PIZZAPIZZA.",
                "source": "Facebookhttps://www.facebook.com",
                "index": 1
              },
              {
                "href": "https://www.facebook.com/LittleCaesars/posts/double-the-pizzas-twice-the-yum-get-2-large-1-topping-pizzas-for-just-499-little/1302966938542758/#:~:text=2%20pizzas%20for%20$4.99%20each%20from%20Little%20Caesars%20Code:%20PIZZAPIZZA",
                "title": "Little Caesars - Facebook",
                "subtitle": "Jan 13, 2026 — 2 pizzas for $4.99 each from Little Caesars Code: PIZZAPIZZA.",
                "source": "Facebook · Little Caesarshttps://www.facebook.com",
                "index": 2
              },
              {
                "href": "https://littlecaesars.com/en-us/deals/8389/#:~:text=Little%20Caesars%C2%AE%20%7C%20Limited%2DTime%20Pizza%20Promos",
                "title": "search for local deals! - Little Caesars® Pizza",
                "subtitle": "Little Caesars® | Limited-Time Pizza Promos.",
                "source": "Little Caesarshttps://littlecaesars.com",
                "index": 3
              },
              {
                "href": "https://www.facebook.com/LittleCaesars/posts/double-the-pizzas-twice-the-yum-get-2-large-1-topping-pizzas-for-just-499-little/1286902870149165/",
                "title": "Double the pizzas, twice the yum! Get 2 large 1-topping pizzas for just $4.99 Little Caesars® limited time Pizza!Pizza! Deal!",
                "source": "Facebook · Little Caesarshttps://www.facebook.com",
                "index": 4
              },
              {
                "href": "https://www.youtube.com/watch?v=eKx39t79o2I&t=7",
                "title": "NEW Little Caesars $4.99 Detroit-Style Slices-N-Stix Review!",
                "subtitle": "Jan 14, 2026 — you a little butt cheek laughter y'all was like \"Damn when you going to stop playing games. and pull up on that newoo at Little C's. are they even a...",
                "source": "YouTube · Daym Dropshttps://www.youtube.com",
                "index": 5
              },
              {
                "href": "https://www.instagram.com/reel/DTOGL8bgSLa/#:~:text=OCR,to%20be%20split%20half%20&%20half%20.",
                "title": "$10 will get you 2 LARGE 1-topping pizzas at Little Caesar's ... - Instagram",
                "subtitle": "Jan 7, 2026 — OCR. 2 PIZZAS FOR $10 AT LITTLE CAESAR'S . 2 PIZZAS FOR $10 AT LITTLE CAESAR'S . Get 2 large 1-topping pizzas for $4.99 each online until 1/18 with c...",
                "source": "Instagram · tayloreatsnychttps://www.instagram.com",
                "index": 6
              },
              {
                "href": "https://www.facebook.com/LittleCaesars/videos/new-sicilian-style-pizza-only-499/647195651659750/#:~:text=For%20only%20$4.99?!,4",
                "title": "For only $4.99?! Check out the Sicilian Style Pizza | Little Caesars",
                "subtitle": "Oct 29, 2025 — For only $4.99?! Check out the Sicilian Style Pizza | Little Caesars | Facebook. Video. 󱡘 Little Caesars. Oct 29, 2025󰞋󱘚 New! Sicilian Style Pizza,",
                "source": "Facebook · Little Caesarshttps://www.facebook.com",
                "index": 7
              },
              {
                "href": "https://www.facebook.com/LittleCaesars/posts/double-the-pizzas-twice-the-yum-get-2-large-1-topping-pizzas-for-just-499-little/1302965878542864/#:~:text=Double%20the%20pizzas%2C%20twice%20the,Deal!",
                "title": "Little Caesars - Facebook",
                "subtitle": "Jan 13, 2026 — Double the pizzas, twice the yum! Get 2 large 1-topping pizzas for just $4.99 Little Caesars® limited time Pizza! Pizza! Deal!",
                "source": "Facebookhttps://www.facebook.com",
                "index": 8
              }
            ]
          }
        ],
        "rank": 2,
        "global_rank": 2
      }
    ],
    "oragnic": [
      {
        "link": "https://www.pizzahut.com/",
        "title": "Pizza Hut | Delivery & Carryout - No One OutPizzas The Hut!",
        "description": "$10 any pizza. Price includes Original Pan, Hand Tossed, Thin 'N Crispy. $10 ANY Large Pizza​. Up to 5 ...",
        "rank": 1,
        "global_rank": 5
      },
      {
        "link": "https://www.dominos.com/",
        "title": "Domino's: Pizza Delivery & Carryout, Pasta, Wings & More",
        "description": "Order pizza, pasta, sandwiches & more online for carryout or delivery from Domino's. View menu, find locations, track orders. Sign up for Domino's email ...",
        "image": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcTBMgmhIihdzXKJSaNX2FtUC1cunqgi_Yg-BMi2gscWl4SHC4Zx2-NXdro&usqp=CAE&s",
        "image_alt": "pizza from www.dominos.com",
        "image_url": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcTBMgmhIihdzXKJSaNX2FtUC1cunqgi_Yg-BMi2gscWl4SHC4Zx2-NXdro&usqp=CAE&s",
        "rank": 2,
        "global_rank": 6
      },
      {
        "link": "https://www.papajohns.com/",
        "title": "Papa Johns Pizza Delivery & Carryout - Best Deals on Pizza, Sides & More",
        "description": "Deals · Pizza · Papadias · Papa Bites · Wings · Sides · Papa Bowls · Desserts · Drinks · Dipping Sauces · Extras. Earn Papa Dough® faster than ever, and redeem ...",
        "rank": 3,
        "global_rank": 7
      }
    ]
  }
  ```
</ResponseExample>


# Device (mobile/desktop)
Source: https://docs.brightdata.com/api-reference/serp/google-search/device-mobile

Configure the Bright Data Google Search Device (Mobile/Desktop) parameter to refine queries and return matching results as JSON or HTML. On port 44445.

```http theme={null}
https://www.google.com/search?q=pizza&brd_mobile=1
```

## Parameters

<ParamField type="string">
  The search query parameter. Specifies the keyword or phrase you want to search for on Google.
</ParamField>

<ParamField type="string">
  Define what device type to be represented in user-agent.

  | Value | Description                           | Usage          |
  | :---- | :------------------------------------ | :------------- |
  | `0`   | Random desktop user agent (`Default`) | `brd_mobile=0` |
  | `1`   | Random mobile user agent              | `brd_mobile=1` |

  ```http theme={null}
  https://www.google.com/search?q=pizza&brd_mobile=1
  ```
</ParamField>

<RequestExample>
  ```shell cURL highlight={6} theme={null}
    curl -X POST https://api.brightdata.com/request \
    --header "Content-Type: application/json" \
    --header "Authorization: Bearer API_KEY" \
    --data '{
      "zone": "serp_api1",
      "url": "https://www.google.com/search?q=pizza&brd_mobile=1",
      "format": "raw"
    }'
  ```

  ```shell Native proxy highlight={4} theme={null}
  curl --proxy brd.superproxy.io:44445 \
    --proxy-user CUSTOMER_USERNAME:CUSTOMER_PASSWORD \
    --ssl-no-revoke \
    "https://www.google.com/search?q=pizza&brd_mobile=1"
  ```

  ```js Node.js highlight={10} theme={null}
  (async () => {
    const response = await fetch('https://api.brightdata.com/request', {
      method: 'POST',
      headers: {
        'Content-Type': 'application/json',
        'Authorization': 'Bearer API_KEY'
      },
      body: JSON.stringify({
        zone: 'serp_api1',
        url: 'https://www.google.com/search?q=pizza&brd_mobile=1',
        format: 'raw'
      })
    });
    
    const data = await response.text();
    console.log(data);
  })();
  ```

  ```python Python highlight={11} theme={null}
  import requests

  # API Configuration
  headers = {
      'Content-Type': 'application/json',
      'Authorization': 'Bearer API_KEY',
  }

  payload = {
      'zone': 'serp_api1',
      'url': 'https://www.google.com/search?q=pizza&brd_mobile=1',
      'format': 'raw'
  }

  # Make the request
  response = requests.post(
      'https://api.brightdata.com/request', 
      json=payload, 
      headers=headers
  )

  print(response.text)
  ```
</RequestExample>

<ResponseExample>
  ```json 200 highlight={7} theme={null}
  {
    "general": {
      "search_engine": "google",
      "query": "pizza",
      "language": "en",
      "location": "United States",
      "mobile": true,
      "basic_view": false,
      "search_type": "text",
      "page_title": "pizza - Google Search",
      "timestamp": "2026-02-25T09:08:20.763Z"
    },
    "input": {
      "original_url": "https://www.google.com/search?q=pizza&brd_mobile=1&brd_json=1",
      "request_id": "hl_xxxxxxxxxxxxxxx"
    },
    "navigation": [
      {
        "title": "AI Mode",
        "href": "https://www.google.com/search?q=pizza&sca_esv=206cd4dd954885db&gl=US&hl=en&udm=50&aep=1&ntc=1&sa=X&ved=2ahUKEwif5eihpfSSAxWVMjQIHW0kB2EQ2J8OegQIBBAX"
      },
      {
        "title": "AI Mode",
        "href": "https://www.google.com/search?q=pizza&sca_esv=206cd4dd954885db&gl=US&hl=en&udm=50&fbs=ADc_l-bZnt6jMmErT-KRarIgXyuyEbgLVbVrL19D752u5Zq1JxsknUc6k2WnAYdF3IRSWkTH3pdQosATZjd3_wJT0jcn1ZGvea0l_Pe81RHnOCa9zKvy8rYGCOaVH6HKJ-v0Fbf3M4pWfq-1w08PlFYboBjESgVjCWuPSKS93yTwhvPbs5RLCAIhZYAj5yDun18lG7HGkbSgcdz0s_2rVuotT_RFlq9E6vh4gSWXTpD9fiMHs21DAcw&aep=1&ntc=1&sa=X&ved=2ahUKEwif5eihpfSSAxWVMjQIHW0kB2EQ2J8OegQIDRAE"
      },
      {
        "title": "Images",
        "href": "https://www.google.com/search?sca_esv=206cd4dd954885db&gl=US&hl=en&udm=2&fbs=ADc_l-bZnt6jMmErT-KRarIgXyuyEbgLVbVrL19D752u5Zq1JxsknUc6k2WnAYdF3IRSWkTH3pdQosATZjd3_wJT0jcn1ZGvea0l_Pe81RHnOCa9zKvy8rYGCOaVH6HKJ-v0Fbf3M4pWfq-1w08PlFYboBjESgVjCWuPSKS93yTwhvPbs5RLCAIhZYAj5yDun18lG7HGkbSgcdz0s_2rVuotT_RFlq9E6vh4gSWXTpD9fiMHs21DAcw&q=pizza&sa=X&ved=2ahUKEwif5eihpfSSAxWVMjQIHW0kB2EQtKgLegQIExAB"
      },
      {
        "title": "Shopping",
        "href": "https://www.google.com/search?sca_esv=206cd4dd954885db&gl=US&hl=en&udm=28&fbs=ADc_l-bZnt6jMmErT-KRarIgXyuyEbgLVbVrL19D752u5Zq1JxsknUc6k2WnAYdF3IRSWkTH3pdQosATZjd3_wJT0jcn1ZGvea0l_Pe81RHnOCa9zKvy8rYGCOaVH6HKJ-v0Fbf3M4pWfq-1w08PlFYboBjESgVjCWuPSKS93yTwhvPbs5RLCAIhZYAj5yDun18lG7HGkbSgcdz0s_2rVuotT_RFlq9E6vh4gSWXTpD9fiMHs21DAcw&q=pizza&ved=1t:220175&ictx=111"
      },
      {
        "title": "Maps",
        "href": "https://maps.google.com/maps?sca_esv=206cd4dd954885db&gl=US&hl=en&output=search&q=pizza&source=lnms&fbs=ADc_l-bZnt6jMmErT-KRarIgXyuyEbgLVbVrL19D752u5Zq1JxsknUc6k2WnAYdF3IRSWkTH3pdQosATZjd3_wJT0jcn1ZGvea0l_Pe81RHnOCa9zKvy8rYGCOaVH6HKJ-v0Fbf3M4pWfq-1w08PlFYboBjESgVjCWuPSKS93yTwhvPbs5RLCAIhZYAj5yDun18lG7HGkbSgcdz0s_2rVuotT_RFlq9E6vh4gSWXTpD9fiMHs21DAcw&entry=mc&ved=1t:200715&ictx=111"
      },
      {
        "title": "Videos",
        "href": "https://www.google.com/search?sca_esv=206cd4dd954885db&gl=US&hl=en&udm=7&fbs=ADc_l-bZnt6jMmErT-KRarIgXyuyEbgLVbVrL19D752u5Zq1JxsknUc6k2WnAYdF3IRSWkTH3pdQosATZjd3_wJT0jcn1ZGvea0l_Pe81RHnOCa9zKvy8rYGCOaVH6HKJ-v0Fbf3M4pWfq-1w08PlFYboBjESgVjCWuPSKS93yTwhvPbs5RLCAIhZYAj5yDun18lG7HGkbSgcdz0s_2rVuotT_RFlq9E6vh4gSWXTpD9fiMHs21DAcw&q=pizza&sa=X&ved=2ahUKEwif5eihpfSSAxWVMjQIHW0kB2EQtKgLegQIEBAB"
      },
      {
        "title": "Short videos",
        "href": "https://www.google.com/search?sca_esv=206cd4dd954885db&gl=US&hl=en&udm=39&fbs=ADc_l-bZnt6jMmErT-KRarIgXyuyEbgLVbVrL19D752u5Zq1JxsknUc6k2WnAYdF3IRSWkTH3pdQosATZjd3_wJT0jcn1ZGvea0l_Pe81RHnOCa9zKvy8rYGCOaVH6HKJ-v0Fbf3M4pWfq-1w08PlFYboBjESgVjCWuPSKS93yTwhvPbs5RLCAIhZYAj5yDun18lG7HGkbSgcdz0s_2rVuotT_RFlq9E6vh4gSWXTpD9fiMHs21DAcw&q=pizza&sa=X&ved=2ahUKEwif5eihpfSSAxWVMjQIHW0kB2EQs6gLegQIDxAB"
      },
      {
        "title": "News",
        "href": "https://www.google.com/search?sca_esv=206cd4dd954885db&gl=US&hl=en&q=pizza&tbm=nws&source=lnms&fbs=ADc_l-bZnt6jMmErT-KRarIgXyuyEbgLVbVrL19D752u5Zq1JxsknUc6k2WnAYdF3IRSWkTH3pdQosATZjd3_wJT0jcn1ZGvea0l_Pe81RHnOCa9zKvy8rYGCOaVH6HKJ-v0Fbf3M4pWfq-1w08PlFYboBjESgVjCWuPSKS93yTwhvPbs5RLCAIhZYAj5yDun18lG7HGkbSgcdz0s_2rVuotT_RFlq9E6vh4gSWXTpD9fiMHs21DAcw&sa=X&ved=2ahUKEwif5eihpfSSAxWVMjQIHW0kB2EQ0pQJegUIzwIQAQ"
      },
      {
        "title": "Forums",
        "href": "https://www.google.com/search?sca_esv=206cd4dd954885db&gl=US&hl=en&udm=18&fbs=ADc_l-bZnt6jMmErT-KRarIgXyuyEbgLVbVrL19D752u5Zq1JxsknUc6k2WnAYdF3IRSWkTH3pdQosATZjd3_wJT0jcn1ZGvea0l_Pe81RHnOCa9zKvy8rYGCOaVH6HKJ-v0Fbf3M4pWfq-1w08PlFYboBjESgVjCWuPSKS93yTwhvPbs5RLCAIhZYAj5yDun18lG7HGkbSgcdz0s_2rVuotT_RFlq9E6vh4gSWXTpD9fiMHs21DAcw&q=pizza&sa=X&ved=2ahUKEwif5eihpfSSAxWVMjQIHW0kB2EQs6gLegUI0AIQAQ"
      },
      {
        "title": "Web",
        "href": "https://www.google.com/search?sca_esv=206cd4dd954885db&gl=US&hl=en&udm=web&fbs=ADc_l-bZnt6jMmErT-KRarIgXyuyEbgLVbVrL19D752u5Zq1JxsknUc6k2WnAYdF3IRSWkTH3pdQosATZjd3_wJT0jcn1ZGvea0l_Pe81RHnOCa9zKvy8rYGCOaVH6HKJ-v0Fbf3M4pWfq-1w08PlFYboBjESgVjCWuPSKS93yTwhvPbs5RLCAIhZYAj5yDun18lG7HGkbSgcdz0s_2rVuotT_RFlq9E6vh4gSWXTpD9fiMHs21DAcw&q=pizza&sa=X&ved=2ahUKEwif5eihpfSSAxWVMjQIHW0kB2EQs6gLegUI7AIQAQ"
      },
      {
        "title": "Books",
        "href": "https://www.google.com/search?sca_esv=206cd4dd954885db&gl=US&hl=en&q=pizza&udm=36&source=lnms&fbs=ADc_l-bZnt6jMmErT-KRarIgXyuyEbgLVbVrL19D752u5Zq1JxsknUc6k2WnAYdF3IRSWkTH3pdQosATZjd3_wJT0jcn1ZGvea0l_Pe81RHnOCa9zKvy8rYGCOaVH6HKJ-v0Fbf3M4pWfq-1w08PlFYboBjESgVjCWuPSKS93yTwhvPbs5RLCAIhZYAj5yDun18lG7HGkbSgcdz0s_2rVuotT_RFlq9E6vh4gSWXTpD9fiMHs21DAcw&sa=X&ved=2ahUKEwif5eihpfSSAxWVMjQIHW0kB2EQ0pQJegUI6AIQAQ"
      },
      {
        "title": "Flights",
        "href": "https://www.google.com/travel/flights?sca_esv=206cd4dd954885db&gl=US&hl=en&output=search&q=pizza&source=lnms&fbs=ADc_l-bZnt6jMmErT-KRarIgXyuyEbgLVbVrL19D752u5Zq1JxsknUc6k2WnAYdF3IRSWkTH3pdQosATZjd3_wJT0jcn1ZGvea0l_Pe81RHnOCa9zKvy8rYGCOaVH6HKJ-v0Fbf3M4pWfq-1w08PlFYboBjESgVjCWuPSKS93yTwhvPbs5RLCAIhZYAj5yDun18lG7HGkbSgcdz0s_2rVuotT_RFlq9E6vh4gSWXTpD9fiMHs21DAcw&ved=1t:200715&ictx=111"
      },
      {
        "title": "Finance",
        "href": "https://www.google.com/finance?sca_esv=206cd4dd954885db&gl=US&hl=en&output=search&q=pizza&source=lnms&fbs=ADc_l-bZnt6jMmErT-KRarIgXyuyEbgLVbVrL19D752u5Zq1JxsknUc6k2WnAYdF3IRSWkTH3pdQosATZjd3_wJT0jcn1ZGvea0l_Pe81RHnOCa9zKvy8rYGCOaVH6HKJ-v0Fbf3M4pWfq-1w08PlFYboBjESgVjCWuPSKS93yTwhvPbs5RLCAIhZYAj5yDun18lG7HGkbSgcdz0s_2rVuotT_RFlq9E6vh4gSWXTpD9fiMHs21DAcw&sa=X&ved=2ahUKEwif5eihpfSSAxWVMjQIHW0kB2EQ0pQJegUI5AIQAQ"
      }
    ],
    "organic": [
      {
        "link": "https://www.pizzahut.com/",
        "title": "Pizza Hut | Delivery & Carryout - No One OutPizzas The Hut!",
        "description": "$10 any pizza. Price includes Original Pan, Hand Tossed, Thin 'N Crispy. $10 ANY Large Pizza​. Up to 5 ...",
        "rank": 1,
        "global_rank": 1
      },
      {
        "link": "https://www.dominos.com/",
        "title": "Domino's: Pizza Delivery & Carryout, Pasta, Wings & More",
        "description": "Order pizza, pasta, sandwiches & more online for carryout or delivery from Domino's. View menu, find locations, track orders. Sign up for Domino's email ...",
        "image": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcTBMgmhIihdzXKJSaNX2FtUC1cunqgi_Yg-BMi2gscWl4SHC4Zx2-NXdro&usqp=CAE&s",
        "image_alt": "pizza from www.dominos.com",
        "image_url": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcTBMgmhIihdzXKJSaNX2FtUC1cunqgi_Yg-BMi2gscWl4SHC4Zx2-NXdro&usqp=CAE&s",
        "rank": 2,
        "global_rank": 2
      },
      {
        "link": "https://www.papajohns.com/",
        "title": "Papa Johns Pizza Delivery & Carryout - Best Deals on Pizza, Sides & More",
        "description": "Deals · Pizza · Papadias · Papa Bites · Wings · Sides · Papa Bowls · Desserts · Drinks · Dipping Sauces · Extras. Earn Papa Dough® faster than ever, and redeem ...",
        "rank": 3,
        "global_rank": 7
      },
      {
        "link": "https://www.pizzamyheart.com/",
        "title": "Pizza My Heart for pizza by the slice or whole pie",
        "description": "Pizza by the slice or whole pie with a focus on natural locally grown ingredients from California farms. Fresh salads, craft beers and a laid-back surf ...",
        "rank": 4,
        "global_rank": 8
      },
      {
        "link": "https://www.spinatospizzeria.com/",
        "title": "Spinato's Pizzeria: Best Restaurant Near Me - Spinato's Pizzeria",
        "description": "Savor classic Italian flavors at Spinato's Pizzeria, the best restaurant near me. Family-owned, offering delicious pizzas, pastas, and more!",
        "image": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcRGnCOkZk6SizIss5cuiBfaISZqSMGuq_6Yb-XzMxkxS9g9gMXnrRI2jHk&usqp=CAE&s",
        "image_alt": "pizza from www.spinatospizzeria.com",
        "image_url": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcRGnCOkZk6SizIss5cuiBfaISZqSMGuq_6Yb-XzMxkxS9g9gMXnrRI2jHk&usqp=CAE&s",
        "rank": 5,
        "global_rank": 19
      },
      {
        "link": "https://www.thekitchn.com/trader-joes-pizza-trick-podcast-23768950",
        "title": "The Rule-Breaking Tip That Makes Frozen Pizza Taste 10x Better",
        "description": "Why You Should Thaw Your Pizza Before Heating It in the Oven. That's right. The key to making frozen pizzas taste like they just came out of a wood-fired oven ...",
        "rank": 6,
        "global_rank": 20
      },
      {
        "link": "https://primepizza.com/",
        "title": "Prime Pizza | Authentic New York–Style Pizza in Los Angeles & Orange County",
        "description": "Discover Prime Pizza — serving the best New York–style pizza in Los Angeles and coming soon to Orange County. Fresh ingredients, housemade dough, ...",
        "image": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcSc78x5sSE2Dq_n5R8zvr0QJw2AWoxBLBQFLnXxUtPUhb0C_asv7_Xv-WE&usqp=CAE&s",
        "image_alt": "pizza from primepizza.com",
        "image_url": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcSc78x5sSE2Dq_n5R8zvr0QJw2AWoxBLBQFLnXxUtPUhb0C_asv7_Xv-WE&usqp=CAE&s",
        "rank": 7,
        "global_rank": 21
      }
    ],
    "videos": [
      {
        "link": "https://www.youtube.com/watch?v=Bz6tlSbN_GA",
        "title": "Recreating The Takeaway Pizza Of My Childhood",
        "author": "5 days ago",
        "rank": 1,
        "global_rank": 15
      },
      {
        "link": "https://www.youtube.com/watch?v=h3qO7Jii3BE",
        "title": "How To Make Frozen Pizza Bases Ready Anytime at Home",
        "author": "3 days ago",
        "rank": 2,
        "global_rank": 16
      },
      {
        "link": "https://www.youtube.com/watch?v=jO3oFY_oxOA",
        "title": "I make these mini pizza almost daily! Delicious, inexpensive, and hardly anyone knows about it!",
        "author": "1 day ago",
        "rank": 3,
        "global_rank": 17
      },
      {
        "link": "https://www.youtube.com/watch?v=TB5JPppUZpY",
        "title": "LEFTOVER PIZZA WILL NEVER BE THE SAME...",
        "author": "1 day ago",
        "rank": 4,
        "global_rank": 18
      }
    ],
    "perspectives": [
      {
        "title": "Barstool Pizza Review - Casey's Pizza (San Francisco, CA)",
        "author": "One Bite Pizza Reviews · YouTube",
        "source": "Pizza reviews & rankings",
        "date": "58.9K+ views · 10 hours ago",
        "link": "https://www.youtube.com/watch?v=wj4vtZ0FR1Y",
        "image": "https://img.youtube.com/vi/wj4vtZ0FR1Y/hqdefault.jpg",
        "image_url": "https://img.youtube.com/vi/wj4vtZ0FR1Y/hqdefault.jpg"
      },
      {
        "title": "Costco: Where to find most perfect slice of cheap cheese pizza. 🍕🙏🤤",
        "author": "r/Costco",
        "source": "Reddit",
        "date": "230+ comments · 7 hours ago",
        "link": "https://www.reddit.com/r/Costco/comments/1rdzzri/costco_where_to_find_most_perfect_slice_of_cheap/",
        "image": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcS-1N_u02vK54QYnMTrSSw2WUdR7skvRIYksS2HIZTJHxF7UxHkOK_roqVZhA&usqp=CAI&s",
        "image_url": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcS-1N_u02vK54QYnMTrSSw2WUdR7skvRIYksS2HIZTJHxF7UxHkOK_roqVZhA&usqp=CAI&s"
      }
    ],
    "overview": {
      "title": "Pizza",
      "kgmid": "/m/0663v"
    },
    "pagination": {
      "next_page_start": 10,
      "next_page_link": "https://www.google.com/search?q=pizza&sca_esv=206cd4dd954885db&gl=US&hl=en&prmd=misvn&ei=vrueaZ-OCZXl0PEP7ciciAY&start=10&sa=N"
    },
    "related": [
      {
        "text": "Pizza Hut near me",
        "link": "https://www.google.com/search?sca_esv=206cd4dd954885db&gl=US&hl=en&q=Pizza+Hut+near+me&sa=X&ved=2ahUKEwif5eihpfSSAxWVMjQIHW0kB2EQ1QJ6BQiyAhAB",
        "rank": 1,
        "global_rank": 9
      },
      {
        "text": "Pizza Hut menu",
        "link": "https://www.google.com/search?sca_esv=206cd4dd954885db&gl=US&hl=en&q=Pizza+Hut+menu&sa=X&ved=2ahUKEwif5eihpfSSAxWVMjQIHW0kB2EQ1QJ6BQi4AhAB",
        "rank": 2,
        "global_rank": 10
      },
      {
        "text": "Pizza definition",
        "link": "https://www.google.com/search?sca_esv=206cd4dd954885db&gl=US&hl=en&q=Pizza+definition&sa=X&ved=2ahUKEwif5eihpfSSAxWVMjQIHW0kB2EQ1QJ6BQi-AhAB",
        "rank": 3,
        "global_rank": 11
      }
    ],
    "people_also_ask": [
      {
        "question": "What's the 2 hour rule for pizza?",
        "question_type": "featured",
        "answer_link": "https://currypizzahouse.com/georgiadoubleupsocial-com/how-long-does-pizza-last/#:~:text=Pizza%20should%20NEVER%20be%20left,to%20prevent%20rapid%20bacteria%20growth.",
        "answer_display_link": "https://currypizzahouse.com",
        "answers": [
          {
            "type": "answer",
            "value": {
              "text": "Pizza should NEVER be left out for more than 2 hours (and just 1 hour if the room is above 90°F/32°C). Hot/Outdoor Events: When it's really warm, the safe window shrinks—refrigerate or ice your pizza within 20–60 minutes to prevent rapid bacteria growth.Jun 29, 2025"
            },
            "rank": 1
          }
        ],
        "rank": 1,
        "global_rank": 3
      },
      {
        "question": "Who has the $4.99 pizza deal?",
        "question_type": "ai_overview",
        "answers": [
          {
            "texts": [
              {
                "type": "paragraph",
                "snippet": "Little Caesars frequently offers $4.99 pizza deals, often for two large one-topping pizzas or their Detroit-Style Slices-N-Stix combo, available for limited times with online codes like \"PIZZAPIZZA,\" so check their deals page or app for current offers.",
                "snippet_highlighted_words": "Little Caesars"
              },
              {
                "type": "list",
                "list": [
                  {
                    "type": "paragraph",
                    "snippet": "Check Little Caesars' Website/App: Look for limited-time offers and deals sections."
                  },
                  {
                    "type": "paragraph",
                    "snippet": "Look for Codes: They often use codes like \"PIZZAPIZZA\" for online orders."
                  },
                  {
                    "type": "list",
                    "title": "Specific Promotions: Recent examples include:",
                    "list": [
                      {
                        "type": "paragraph",
                        "snippet": "2 Large 1-Topping Pizzas: for $4.99 each (online deal)."
                      },
                      {
                        "type": "paragraph",
                        "snippet": "Detroit-Style Slices-N-Stix Combo: (2 pepperoni slices + Crazy Bread) for $4.99 (lunch special)."
                      },
                      {
                        "type": "paragraph",
                        "snippet": "Sicilian Style Pizza: for $4.99."
                      }
                    ]
                  }
                ],
                "title": "How to find current deals:"
              },
              {
                "type": "list",
                "list": [
                  {
                    "type": "paragraph",
                    "snippet": "These are often limited-time offers and prices can vary by location."
                  },
                  {
                    "type": "paragraph",
                    "snippet": "Some deals require online ordering or specific promo codes."
                  }
                ],
                "title": "Keep in mind:"
              }
            ],
            "references": [
              {
                "href": "https://littlecaesars.com/en-us/deals/#:~:text=Little%20Caesars%C2%AE,Limited%2DTime%20Pizza%20Deals",
                "title": "Little Caesars®| Limited-Time Pizza Deals",
                "subtitle": "Little Caesars® | Limited-Time Pizza Deals.",
                "source": "Little Caesarshttps://littlecaesars.com",
                "index": 0
              },
              {
                "href": "https://www.facebook.com/LittleCaesars/posts/get-2-large-pizzas-for-499-each-online-only-with-promo-code-pizzapizza/1187325250106928/#:~:text=get%202%20large%20pizzas%20for%204.99%20each%20online%20only%20with%20promo%20code%20PIZZAPIZZA",
                "title": "get 2 large pizzas for 4.99 each online only with promo code ...",
                "subtitle": "Aug 26, 2025 — get 2 large pizzas for 4.99 each online only with promo code PIZZAPIZZA.",
                "source": "Facebookhttps://www.facebook.com",
                "index": 1
              },
              {
                "href": "https://www.facebook.com/LittleCaesars/posts/double-the-pizzas-twice-the-yum-get-2-large-1-topping-pizzas-for-just-499-little/1302966938542758/#:~:text=2%20pizzas%20for%20$4.99%20each%20from%20Little%20Caesars%20Code:%20PIZZAPIZZA",
                "title": "Little Caesars - Facebook",
                "subtitle": "Jan 13, 2026 — 2 pizzas for $4.99 each from Little Caesars Code: PIZZAPIZZA.",
                "source": "Facebook · Little Caesarshttps://www.facebook.com",
                "index": 2
              },
              {
                "href": "https://littlecaesars.com/en-us/deals/8389/#:~:text=Little%20Caesars%C2%AE%20%7C%20Limited%2DTime%20Pizza%20Promos",
                "title": "search for local deals! - Little Caesars® Pizza",
                "subtitle": "Little Caesars® | Limited-Time Pizza Promos.",
                "source": "Little Caesarshttps://littlecaesars.com",
                "index": 3
              },
              {
                "href": "https://www.facebook.com/LittleCaesars/posts/double-the-pizzas-twice-the-yum-get-2-large-1-topping-pizzas-for-just-499-little/1286902870149165/",
                "title": "Double the pizzas, twice the yum! Get 2 large 1-topping pizzas for just $4.99 Little Caesars® limited time Pizza!Pizza! Deal!",
                "source": "Facebook · Little Caesarshttps://www.facebook.com",
                "index": 4
              },
              {
                "href": "https://www.youtube.com/watch?v=eKx39t79o2I&t=7",
                "title": "NEW Little Caesars $4.99 Detroit-Style Slices-N-Stix Review!",
                "subtitle": "Jan 14, 2026 — you a little butt cheek laughter y'all was like \"Damn when you going to stop playing games. and pull up on that newoo at Little C's. are they even a...",
                "source": "YouTube · Daym Dropshttps://www.youtube.com",
                "index": 5
              },
              {
                "href": "https://www.instagram.com/reel/DTOGL8bgSLa/#:~:text=OCR,to%20be%20split%20half%20&%20half%20.",
                "title": "$10 will get you 2 LARGE 1-topping pizzas at Little Caesar's ... - Instagram",
                "subtitle": "Jan 7, 2026 — OCR. 2 PIZZAS FOR $10 AT LITTLE CAESAR'S . 2 PIZZAS FOR $10 AT LITTLE CAESAR'S . Get 2 large 1-topping pizzas for $4.99 each online until 1/18 with c...",
                "source": "Instagram · tayloreatsnychttps://www.instagram.com",
                "index": 6
              },
              {
                "href": "https://www.facebook.com/LittleCaesars/videos/new-sicilian-style-pizza-only-499/647195651659750/#:~:text=For%20only%20$4.99?!,4",
                "title": "For only $4.99?! Check out the Sicilian Style Pizza | Little Caesars",
                "subtitle": "Oct 29, 2025 — For only $4.99?! Check out the Sicilian Style Pizza | Little Caesars | Facebook. Video. 󱡘 Little Caesars. Oct 29, 2025󰞋󱘚 New! Sicilian Style Pizza,",
                "source": "Facebook · Little Caesarshttps://www.facebook.com",
                "index": 7
              },
              {
                "href": "https://www.facebook.com/LittleCaesars/posts/double-the-pizzas-twice-the-yum-get-2-large-1-topping-pizzas-for-just-499-little/1302965878542864/#:~:text=Double%20the%20pizzas%2C%20twice%20the,Deal!",
                "title": "Little Caesars - Facebook",
                "subtitle": "Jan 13, 2026 — Double the pizzas, twice the yum! Get 2 large 1-topping pizzas for just $4.99 Little Caesars® limited time Pizza! Pizza! Deal!",
                "source": "Facebookhttps://www.facebook.com",
                "index": 8
              }
            ]
          }
        ],
        "rank": 2,
        "global_rank": 4
      }
    ],
    "oragnic": [
      {
        "link": "https://www.pizzahut.com/",
        "title": "Pizza Hut | Delivery & Carryout - No One OutPizzas The Hut!",
        "description": "$10 any pizza. Price includes Original Pan, Hand Tossed, Thin 'N Crispy. $10 ANY Large Pizza​. Up to 5 ...",
        "rank": 1,
        "global_rank": 1
      },
      {
        "link": "https://www.dominos.com/",
        "title": "Domino's: Pizza Delivery & Carryout, Pasta, Wings & More",
        "description": "Order pizza, pasta, sandwiches & more online for carryout or delivery from Domino's. View menu, find locations, track orders. Sign up for Domino's email ...",
        "image": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcTBMgmhIihdzXKJSaNX2FtUC1cunqgi_Yg-BMi2gscWl4SHC4Zx2-NXdro&usqp=CAE&s",
        "image_alt": "pizza from www.dominos.com",
        "image_url": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcTBMgmhIihdzXKJSaNX2FtUC1cunqgi_Yg-BMi2gscWl4SHC4Zx2-NXdro&usqp=CAE&s",
        "rank": 2,
        "global_rank": 2
      },
      {
        "link": "https://www.papajohns.com/",
        "title": "Papa Johns Pizza Delivery & Carryout - Best Deals on Pizza, Sides & More",
        "description": "Deals · Pizza · Papadias · Papa Bites · Wings · Sides · Papa Bowls · Desserts · Drinks · Dipping Sauces · Extras. Earn Papa Dough® faster than ever, and redeem ...",
        "rank": 3,
        "global_rank": 7
      }
    ]
  }
  ```
</ResponseExample>


# Geo-location
Source: https://docs.brightdata.com/api-reference/serp/google-search/geo-location

Configure the Bright Data Google Search Geo-Location parameter to refine queries and return matching results as JSON or HTML. On port 44445.

```txt wrap theme={null}
https://www.google.com/search?q=pizza&uule=w+CAIQICINVW5pdGVkK1N0YXRlcw
```

## Parameters

<ParamField type="string">
  The search query parameter. Specifies the keyword or phrase you want to search for on Google.
</ParamField>

<ParamField type="string">
  Stands for the encoded location you want to use for your search and will be used to change geo-location.

  ```http theme={null}
  https://www.google.com/search?q=pizza&uule=w+CAIQICINVW5pdGVkK1N0YXRlcw
  ```

  <Tip>
    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`
  </Tip>
</ParamField>

<RequestExample>
  ```shell cURL highlight={6} theme={null}
    curl -X POST https://api.brightdata.com/request \
    --header "Content-Type: application/json" \
    --header "Authorization: Bearer API_KEY" \
    --data '{
      "zone": "serp_api1",
      "url": "https://www.google.com/search?q=pizza&uule=w+CAIQICINVW5pdGVkK1N0YXRlcw",
      "format": "raw"
    }'
  ```

  ```shell Native proxy highlight={4} theme={null}
  curl --proxy brd.superproxy.io:44445 \
    --proxy-user CUSTOMER_USERNAME:CUSTOMER_PASSWORD \
    --ssl-no-revoke \
    "https://www.google.com/search?q=pizza&uule=w+CAIQICINVW5pdGVkK1N0YXRlcw"
  ```

  ```js Node.js highlight={10} theme={null}
  (async () => {
    const response = await fetch('https://api.brightdata.com/request', {
      method: 'POST',
      headers: {
        'Content-Type': 'application/json',
        'Authorization': 'Bearer API_KEY'
      },
      body: JSON.stringify({
        zone: 'serp_api1',
        url: 'https://www.google.com/search?q=pizza&uule=w+CAIQICINVW5pdGVkK1N0YXRlcw',
        format: 'raw'
      })
    });
    
    const data = await response.text();
    console.log(data);
  })();
  ```

  ```python Python highlight={11} theme={null}
  import requests

  # API Configuration
  headers = {
      'Content-Type': 'application/json',
      'Authorization': 'Bearer API_KEY',
  }

  payload = {
      'zone': 'serp_api1',
      'url': 'https://www.google.com/search?q=pizza&uule=w+CAIQICINVW5pdGVkK1N0YXRlcw',
      'format': 'raw'
  }

  # Make the request
  response = requests.post(
      'https://api.brightdata.com/request', 
      json=payload, 
      headers=headers
  )

  print(response.text)
  ```
</RequestExample>

<ResponseExample>
  ```json 200 highlight={8} theme={null}
  {
    "general": {
      "search_engine": "google",
      "query": "pizza",
      "results_cnt": 1200000000,
      "search_time": 0.46,
      "language": "en",
      "location": "United States",
      "mobile": false,
      "basic_view": false,
      "search_type": "text",
      "page_title": "pizza - Google Search",
      "timestamp": "2026-02-25T08:55:57.015Z"
    },
    "input": {
      "original_url": "https://www.google.com/search?q=pizza&uule=w+CAIQICINVW5pdGVkK1N0YXRlcw&brd_json=1",
      "request_id": "hl_xxxxxxxxxxxxxxx"
    },
    "navigation": [
      {
        "title": "AI Mode",
        "href": "https://www.google.com/search?q=pizza&sca_esv=206cd4dd954885db&gl=US&hl=en&udm=50&fbs=ADc_l-aN0CWEZBOHjofHoaMMDiKpaEWjvZ2Py1XXV8d8KvlI3o6iwGk6Iv1tRbZIBNIVs-4Dki9dynYvfwBVZUSUkihwf6Po1X8vgm-4XqAkWV_U_mSmFfDrYQ3JJnT9pFVWyBg4AncR4kUgE3P9Dn8YQ2qpg4mGYZH3cN0xQoqqXY3iPBHuF6UXBhWnU9Lvfw4ijII1Eq0jCo7w_teMvuVi1Ne_ekoSug&aep=1&ntc=1&sa=X&ved=2ahUKEwiat_PfovSSAxXJ2AIHHSx3FwUQ2J8OegQIBxAE"
      },
      {
        "title": "Images",
        "href": "https://www.google.com/search?sca_esv=206cd4dd954885db&gl=US&hl=en&udm=2&fbs=ADc_l-aN0CWEZBOHjofHoaMMDiKpaEWjvZ2Py1XXV8d8KvlI3o6iwGk6Iv1tRbZIBNIVs-4Dki9dynYvfwBVZUSUkihwf6Po1X8vgm-4XqAkWV_U_mSmFfDrYQ3JJnT9pFVWyBg4AncR4kUgE3P9Dn8YQ2qpg4mGYZH3cN0xQoqqXY3iPBHuF6UXBhWnU9Lvfw4ijII1Eq0jCo7w_teMvuVi1Ne_ekoSug&q=pizza&sa=X&ved=2ahUKEwiat_PfovSSAxXJ2AIHHSx3FwUQtKgLegQIGxAB"
      },
      {
        "title": "Shopping",
        "href": "https://www.google.com/search?sca_esv=206cd4dd954885db&gl=US&hl=en&udm=28&fbs=ADc_l-aN0CWEZBOHjofHoaMMDiKpaEWjvZ2Py1XXV8d8KvlI3o6iwGk6Iv1tRbZIBNIVs-4Dki9dynYvfwBVZUSUkihwf6Po1X8vgm-4XqAkWV_U_mSmFfDrYQ3JJnT9pFVWyBg4AncR4kUgE3P9Dn8YQ2qpg4mGYZH3cN0xQoqqXY3iPBHuF6UXBhWnU9Lvfw4ijII1Eq0jCo7w_teMvuVi1Ne_ekoSug&q=pizza&ved=1t:220175&ictx=111"
      },
      {
        "title": "Maps",
        "href": "https://maps.google.com/maps?sca_esv=206cd4dd954885db&gl=US&hl=en&output=search&q=pizza&source=lnms&fbs=ADc_l-aN0CWEZBOHjofHoaMMDiKpaEWjvZ2Py1XXV8d8KvlI3o6iwGk6Iv1tRbZIBNIVs-4Dki9dynYvfwBVZUSUkihwf6Po1X8vgm-4XqAkWV_U_mSmFfDrYQ3JJnT9pFVWyBg4AncR4kUgE3P9Dn8YQ2qpg4mGYZH3cN0xQoqqXY3iPBHuF6UXBhWnU9Lvfw4ijII1Eq0jCo7w_teMvuVi1Ne_ekoSug&entry=mc&ved=1t:200715&ictx=111"
      },
      {
        "title": "Videos",
        "href": "https://www.google.com/search?sca_esv=206cd4dd954885db&gl=US&hl=en&udm=7&fbs=ADc_l-aN0CWEZBOHjofHoaMMDiKpaEWjvZ2Py1XXV8d8KvlI3o6iwGk6Iv1tRbZIBNIVs-4Dki9dynYvfwBVZUSUkihwf6Po1X8vgm-4XqAkWV_U_mSmFfDrYQ3JJnT9pFVWyBg4AncR4kUgE3P9Dn8YQ2qpg4mGYZH3cN0xQoqqXY3iPBHuF6UXBhWnU9Lvfw4ijII1Eq0jCo7w_teMvuVi1Ne_ekoSug&q=pizza&sa=X&ved=2ahUKEwiat_PfovSSAxXJ2AIHHSx3FwUQtKgLegQIERAB"
      },
      {
        "title": "Short videos",
        "href": "https://www.google.com/search?sca_esv=206cd4dd954885db&gl=US&hl=en&udm=39&fbs=ADc_l-aN0CWEZBOHjofHoaMMDiKpaEWjvZ2Py1XXV8d8KvlI3o6iwGk6Iv1tRbZIBNIVs-4Dki9dynYvfwBVZUSUkihwf6Po1X8vgm-4XqAkWV_U_mSmFfDrYQ3JJnT9pFVWyBg4AncR4kUgE3P9Dn8YQ2qpg4mGYZH3cN0xQoqqXY3iPBHuF6UXBhWnU9Lvfw4ijII1Eq0jCo7w_teMvuVi1Ne_ekoSug&q=pizza&sa=X&ved=2ahUKEwiat_PfovSSAxXJ2AIHHSx3FwUQs6gLegQIDxAB"
      },
      {
        "title": "News",
        "href": "https://www.google.com/search?sca_esv=206cd4dd954885db&gl=US&hl=en&q=pizza&tbm=nws&source=lnms&fbs=ADc_l-aN0CWEZBOHjofHoaMMDiKpaEWjvZ2Py1XXV8d8KvlI3o6iwGk6Iv1tRbZIBNIVs-4Dki9dynYvfwBVZUSUkihwf6Po1X8vgm-4XqAkWV_U_mSmFfDrYQ3JJnT9pFVWyBg4AncR4kUgE3P9Dn8YQ2qpg4mGYZH3cN0xQoqqXY3iPBHuF6UXBhWnU9Lvfw4ijII1Eq0jCo7w_teMvuVi1Ne_ekoSug&sa=X&ved=2ahUKEwiat_PfovSSAxXJ2AIHHSx3FwUQ0pQJegUI0QEQAQ"
      },
      {
        "title": "Forums",
        "href": "https://www.google.com/search?sca_esv=206cd4dd954885db&gl=US&hl=en&udm=18&fbs=ADc_l-aN0CWEZBOHjofHoaMMDiKpaEWjvZ2Py1XXV8d8KvlI3o6iwGk6Iv1tRbZIBNIVs-4Dki9dynYvfwBVZUSUkihwf6Po1X8vgm-4XqAkWV_U_mSmFfDrYQ3JJnT9pFVWyBg4AncR4kUgE3P9Dn8YQ2qpg4mGYZH3cN0xQoqqXY3iPBHuF6UXBhWnU9Lvfw4ijII1Eq0jCo7w_teMvuVi1Ne_ekoSug&q=pizza&sa=X&ved=2ahUKEwiat_PfovSSAxXJ2AIHHSx3FwUQs6gLegUI0AEQAQ"
      },
      {
        "title": "Web",
        "href": "https://www.google.com/search?sca_esv=206cd4dd954885db&gl=US&hl=en&udm=web&fbs=ADc_l-aN0CWEZBOHjofHoaMMDiKpaEWjvZ2Py1XXV8d8KvlI3o6iwGk6Iv1tRbZIBNIVs-4Dki9dynYvfwBVZUSUkihwf6Po1X8vgm-4XqAkWV_U_mSmFfDrYQ3JJnT9pFVWyBg4AncR4kUgE3P9Dn8YQ2qpg4mGYZH3cN0xQoqqXY3iPBHuF6UXBhWnU9Lvfw4ijII1Eq0jCo7w_teMvuVi1Ne_ekoSug&q=pizza&sa=X&ved=2ahUKEwiat_PfovSSAxXJ2AIHHSx3FwUQs6gLegUI3QEQAQ"
      },
      {
        "title": "Books",
        "href": "https://www.google.com/search?sca_esv=206cd4dd954885db&gl=US&hl=en&q=pizza&udm=36&source=lnms&fbs=ADc_l-aN0CWEZBOHjofHoaMMDiKpaEWjvZ2Py1XXV8d8KvlI3o6iwGk6Iv1tRbZIBNIVs-4Dki9dynYvfwBVZUSUkihwf6Po1X8vgm-4XqAkWV_U_mSmFfDrYQ3JJnT9pFVWyBg4AncR4kUgE3P9Dn8YQ2qpg4mGYZH3cN0xQoqqXY3iPBHuF6UXBhWnU9Lvfw4ijII1Eq0jCo7w_teMvuVi1Ne_ekoSug&sa=X&ved=2ahUKEwiat_PfovSSAxXJ2AIHHSx3FwUQ0pQJegUI0gEQAQ"
      },
      {
        "title": "Pizza",
        "href": "https://www.google.com/search?sca_esv=206cd4dd954885db&gl=US&hl=en&q=Restaurant&uds=ALYpb_ncDc7jTlmw6Mmq7NjuX5c-YkRxG3oIOwBP9pqV8A9knLvLZuH8Ewms8PAcf7ea3t4NPsly-1JiYt9S6VsSRnLf-sxULmbNLebMKQgkhwHc2FSfFXQ&sa=X&ved=2ahUKEwiat_PfovSSAxXJ2AIHHSx3FwUQkc0JKAB6BAgQEAE&ictx=0"
      }
    ],
    "organic": [
      {
        "link": "https://www.pizzahut.com/",
        "source": "Pizza Hut",
        "display_link": "https://www.pizzahut.com",
        "title": "Pizza Hut | Delivery & Carryout - No One OutPizzas The Hut!",
        "description": "$10 any pizza. Price includes Original Pan, Hand Tossed, Thin 'N Crispy. $10 ANY Large Pizza​. Up to 5 ...Read more",
        "snippet_highlighted_words": [
          "10 any pizza"
        ],
        "icon": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAABwAAA...",
        "image": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQABAAD/2w...",
        "image_alt": "pizza from www.pizzahut.com",
        "image_base64": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQABAAD/2w...",
        "rank": 1,
        "global_rank": 4
      },
      {
        "link": "https://www.dominos.com/",
        "source": "Domino's",
        "display_link": "https://www.dominos.com",
        "title": "Domino's: Pizza Delivery & Carryout, Pasta, Wings & More",
        "description": "Order pizza, pasta, sandwiches & more online for carryout or delivery from Domino's. View menu, find locations, track orders. Sign up for Domino's email ...",
        "snippet_highlighted_words": [
          "Order pizza, pasta, sandwiches & more online for carryout or delivery"
        ],
        "icon": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAABAAAA...",
        "image": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQABAAD/2w...",
        "image_alt": "pizza from www.dominos.com",
        "image_base64": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQABAAD/2w...",
        "rank": 2,
        "global_rank": 5
      },
      {
        "link": "https://www.papajohns.com/",
        "source": "Papa John's",
        "display_link": "https://www.papajohns.com",
        "title": "Papa Johns Pizza Delivery & Carryout - Best Deals on Pizza ...",
        "description": "Deals · Pizza · Papadias · Papa Bites · Wings · Sides · Papa Bowls · Desserts · Drinks · Dipping Sauces · Extras. Earn Papa Dough® faster than ever, and redeem ...Read more",
        "snippet_highlighted_words": [
          "Pizza"
        ],
        "icon": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAACAAAA...",
        "rank": 3,
        "global_rank": 10
      },
      {
        "link": "https://www.pizzamyheart.com/",
        "source": "Pizza My Heart",
        "display_link": "https://www.pizzamyheart.com",
        "title": "Pizza My Heart for pizza by the slice or whole pie",
        "description": "Pizza by the slice or whole pie with a focus on natural locally grown ingredients from California farms. Fresh salads, craft beers and a laid-back surf ...",
        "snippet_highlighted_words": [
          "Pizza by the slice or whole pie"
        ],
        "icon": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAABwAAA...",
        "rank": 4,
        "global_rank": 11
      },
      {
        "link": "https://primepizza.com/",
        "source": "Prime Pizza",
        "display_link": "https://primepizza.com",
        "title": "Prime Pizza | Authentic New York–Style Pizza in Los Angeles ...",
        "description": "Discover Prime Pizza — serving the best New York–style pizza in Los Angeles and coming soon to Orange County. Fresh ingredients, housemade dough, ...",
        "snippet_highlighted_words": [
          "serving the best New York–style pizza in Los Angeles"
        ],
        "icon": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAABwAAA...",
        "rank": 5,
        "global_rank": 12
      },
      {
        "link": "https://pagliacci.com/",
        "source": "Pagliacci Pizza",
        "display_link": "https://pagliacci.com",
        "title": "Pagliacci Pizza: Seattle Area Pizza & Delivery | Pagliacci Pizza",
        "description": "Pagliacci Pizza, serving Seattle's best pizza since 1979. Offering pizza by the slice and pizza delivery service to homes and businesses.",
        "snippet_highlighted_words": [
          "Seattle's best pizza since 1979"
        ],
        "icon": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAABwAAA...",
        "rank": 6,
        "global_rank": 13
      },
      {
        "link": "https://littlecaesars.com/",
        "source": "Little Caesars",
        "display_link": "https://littlecaesars.com",
        "title": "Little Caesars® Pizza | Best Value Delivery & Carryout",
        "description": "Order HOT-N-READY® pizzas, Crazy Bread®, and more from Little Caesars® online for delivery or carryout.",
        "snippet_highlighted_words": [
          "Order HOT-N-READY® pizzas"
        ],
        "icon": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAACAAAA...",
        "rank": 7,
        "global_rank": 14
      },
      {
        "link": "https://www.youtube.com/watch?v=Bz6tlSbN_GA",
        "source": "YouTube · Andy Cooks",
        "display_link": "283.1K+ views · 5 days ago",
        "title": "Recreating The Takeaway Pizza Of My Childhood",
        "description": "Today I'm going to show you how to recreate at least my childhood memories of delicious bad pizza it's easily done at home.",
        "icon": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAABAAAA...",
        "image": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcQawToEk5MRMKlzdRutYRvfJGXtRpWQfVqXSJ2z8EdrkapJcXFUS00qnQ&s",
        "image_url": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcQawToEk5MRMKlzdRutYRvfJGXtRpWQfVqXSJ2z8EdrkapJcXFUS00qnQ&s",
        "duration": "13:55",
        "duration_sec": 835,
        "rank": 8,
        "global_rank": 15
      },
      {
        "link": "https://www.extremepizza.com/",
        "source": "Extreme Pizza",
        "display_link": "https://www.extremepizza.com",
        "title": "Extreme Pizza | Freshly Made Gourmet Pizza | Pizza Delivery",
        "description": "Extreme Pizza is your go-to store for fresh gourmet pizzas that will satisfy your cravings. Explore our menu for our exciting flavors.",
        "snippet_highlighted_words": [
          "fresh gourmet pizzas that will satisfy your cravings"
        ],
        "icon": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAABwAAA...",
        "rank": 9,
        "global_rank": 16
      }
    ],
    "perspectives": [
      {
        "title": "Barstool Pizza Review - Casey's Pizza (San Francisco, CA)",
        "author": "One Bite Pizza Reviews · YouTube",
        "source": "Pizza reviews & rankings",
        "date": "58.9K+ views · 10 hours ago",
        "link": "https://www.youtube.com/watch?v=wj4vtZ0FR1Y",
        "image": "https://img.youtube.com/vi/wj4vtZ0FR1Y/hqdefault.jpg",
        "image_url": "https://img.youtube.com/vi/wj4vtZ0FR1Y/hqdefault.jpg"
      },
      {
        "title": "Costco: Where to find most perfect slice of cheap cheese pizza. 🍕🙏🤤",
        "author": "r/Costco",
        "source": "Reddit",
        "date": "230+ comments · 7 hours ago",
        "link": "https://www.reddit.com/r/Costco/comments/1rdzzri/costco_where_to_find_most_perfect_slice_of_cheap/",
        "image": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcR56LIOT4XXriPnI8lkdNLieh_vVTIR2bkveJMrspN70Vc83Hvb7BHycWsG_g&usqp=CAI&s",
        "image_url": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcR56LIOT4XXriPnI8lkdNLieh_vVTIR2bkveJMrspN70Vc83Hvb7BHycWsG_g&usqp=CAI&s"
      },
      {
        "title": "Barstool Pizza Review - Casey’s Pizza (San Francisco, CA)",
        "author": "stoolpresidente · Instagram",
        "source": "American businessman",
        "date": "2K+ likes · 8 hours ago",
        "link": "https://www.instagram.com/reel/DVKIeZTlJCR/?hl=en",
        "image": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcQX9LeRL2aFzRhGOpiS2hlaI-MmNlAgUW_rPSWXklkzgSsmzx7R_pbGqtuCPQ&usqp=CAI&s=10",
        "image_url": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcQX9LeRL2aFzRhGOpiS2hlaI-MmNlAgUW_rPSWXklkzgSsmzx7R_pbGqtuCPQ&usqp=CAI&s=10"
      }
    ],
    "knowledge": {
      "name": "Pizza",
      "summary": "Dish",
      "subtitle": "Dish",
      "description": "Pizza is an Italian dish typically consisting of a flat base of leavened wheat-based dough topped with tomato, cheese, and other ingredients, baked at a high temperature, traditionally in a wood-fired oven.",
      "description_source": "Wikipedia",
      "description_link": "https://en.wikipedia.org/wiki/Pizza",
      "images": [
        {
          "image": "data:image/webp;base64,UklGRrYOAABXRUJQVlA4IKoOAACQVA...",
          "image_alt": "Image of Pizza Dough Recipe",
          "image_base64": "data:image/webp;base64,UklGRrYOAABXRUJQVlA4IKoOAACQVA..."
        },
        {
          "image": "data:image/webp;base64,UklGRk4KAABXRUJQVlA4IEIKAACQNg...",
          "image_alt": "Image of Salami, Red Onion and Oregano Pizza - Tillamook",
          "image_base64": "data:image/webp;base64,UklGRk4KAABXRUJQVlA4IEIKAACQNg..."
        },
        {
          "image": "data:image/webp;base64,UklGRmgIAABXRUJQVlA4IFwIAACwMg...",
          "image_alt": "Image of Homemade Pizza Recipe: How to Make It",
          "image_base64": "data:image/webp;base64,UklGRmgIAABXRUJQVlA4IFwIAACwMg..."
        }
      ],
      "facts": [
        {
          "key": "Origin",
          "predicate": "hw:/collection/dishes:origin",
          "value": [
            {
              "text": "Italy",
              "link": "https://www.google.com/search?sca_esv=206cd4dd954885db&gl=US&hl=en&q=Italy&si=AL3DRZHmwLjWhgnaPB3UTu10R6S5qNLXiQiKMeezfKyB1FMsRgvMc15_a-XCDquvg02EcLVCDOBlFWcyGM1h_GEvApLCUHB4TbGV9DLLN_L5HXDRSM_AM0JjmkKGPEEkyRjAEOMkP_wbp9U4-YKGn63yz0_QGqKXGf1bKFT4vVVVz2XMsjUuOZt4AnSHQk-nDBQE0oBKvh4m&sa=X&ved=2ahUKEwiat_PfovSSAxXJ2AIHHSx3FwUQmxN6BAgNEAI"
            }
          ]
        }
      ],
      "nutrition_facts": {
        "product": "Pizza, 14\" regular crust",
        "source": "USDA",
        "source_link": "https://fdc.nal.usda.gov/food-details/173292/nutrients",
        "calories": "285 Calories",
        "portion": "1 slice (107 g)"
      }
    },
    "overview": {
      "title": "Popular Toppings",
      "kgmid": "/m/0663v"
    },
    "snack_pack_map": {
      "image": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAowAAA...",
      "image_base64": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAowAAA...",
      "link": "https://www.google.com/search?q=pizza&sca_esv=206cd4dd954885db&gl=US&hl=en&udm=1&lsack=G7meadq9Asmxi-gPrO7dKA&sa=X&ved=2ahUKEwiat_PfovSSAxXJ2AIHHSx3FwUQtgN6BAg-EAM"
    },
    "snack_pack": [
      {
        "cid": "13570545686572397234",
        "name": "Sicilian Pizza",
        "image": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQABAAD/2w...",
        "image_base64": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQABAAD/2w...",
        "reviews_cnt": 3,
        "type": "Pizza",
        "work_status": "\"Pizza was prepared quickly, the products were all of high quality and fresh.\"\"Pizza was prepared quickly, the products were all of high quality and fresh.\"",
        "address": "Nashville, TN",
        "rank": 1,
        "global_rank": 1
      },
      {
        "cid": "14742264573553154910",
        "name": "327 Pizza Company",
        "image": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAFoAAA...",
        "image_base64": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAFoAAA...",
        "reviews_cnt": 3,
        "type": "Pizza",
        "work_status": "\"Ordered a gluten free, and a regular Hawaiian pizza- flavour is fantastic!\"\"Ordered a gluten free, and a regular Hawaiian pizza- flavour is fantastic!\"",
        "address": "Nashville, TN",
        "rank": 2,
        "global_rank": 2
      },
      {
        "cid": "11325640445402842264",
        "name": "PizzaForno",
        "image": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAFoAAA...",
        "image_base64": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAFoAAA...",
        "reviews_cnt": 4,
        "type": "Pizza",
        "work_status": "\"It's a fully robotic pizza machine that will bake your pizza in 4 minutes!\"\"It's a fully robotic pizza machine that will bake your pizza in 4 minutes!\"",
        "address": "Columbia, SC",
        "rank": 3,
        "global_rank": 3
      }
    ],
    "pagination": {
      "pages": [
        {
          "page": 2,
          "start": 10,
          "link": "https://www.google.com/search?q=pizza&sca_esv=206cd4dd954885db&gl=US&hl=en&ei=G7meadq9Asmxi-gPrO7dKA&start=10&sa=N&sstk=Af77f_fJ7Wgh6eItfEwoCb_2t0G8CuvwOrSZ6TONEKuDyawmmNMPWUUVHKH1zLB6ENb15HPlr67qq80L4RkoL1jJrvuFJT9BhMhFdg&ved=2ahUKEwiat_PfovSSAxXJ2AIHHSx3FwUQ8tMDegQIFxAE"
        },
        {
          "page": 3,
          "start": 20,
          "link": "https://www.google.com/search?q=pizza&sca_esv=206cd4dd954885db&gl=US&hl=en&ei=G7meadq9Asmxi-gPrO7dKA&start=20&sa=N&sstk=Af77f_fJ7Wgh6eItfEwoCb_2t0G8CuvwOrSZ6TONEKuDyawmmNMPWUUVHKH1zLB6ENb15HPlr67qq80L4RkoL1jJrvuFJT9BhMhFdg&ved=2ahUKEwiat_PfovSSAxXJ2AIHHSx3FwUQ8tMDegQIFxAG"
        },
        {
          "page": 4,
          "start": 30,
          "link": "https://www.google.com/search?q=pizza&sca_esv=206cd4dd954885db&gl=US&hl=en&ei=G7meadq9Asmxi-gPrO7dKA&start=30&sa=N&sstk=Af77f_fJ7Wgh6eItfEwoCb_2t0G8CuvwOrSZ6TONEKuDyawmmNMPWUUVHKH1zLB6ENb15HPlr67qq80L4RkoL1jJrvuFJT9BhMhFdg&ved=2ahUKEwiat_PfovSSAxXJ2AIHHSx3FwUQ8tMDegQIFxAI"
        }
      ],
      "current_page": 1,
      "next_page": 2,
      "next_page_start": 10,
      "next_page_link": "https://www.google.com/search?q=pizza&sca_esv=206cd4dd954885db&gl=US&hl=en&ei=G7meadq9Asmxi-gPrO7dKA&start=10&sa=N&sstk=Af77f_fJ7Wgh6eItfEwoCb_2t0G8CuvwOrSZ6TONEKuDyawmmNMPWUUVHKH1zLB6ENb15HPlr67qq80L4RkoL1jJrvuFJT9BhMhFdg&ved=2ahUKEwiat_PfovSSAxXJ2AIHHSx3FwUQ8tMDegQIFxAE"
    },
    "related": [
      {
        "text": "Pizza Hut near me",
        "link": "https://www.google.com/search?sca_esv=206cd4dd954885db&gl=US&hl=en&q=Pizza+Hut+near+me&sa=X&ved=2ahUKEwiat_PfovSSAxXJ2AIHHSx3FwUQ1QJ6BAhiEAE",
        "rank": 1,
        "global_rank": 17
      },
      {
        "text": "Pizza Hut menu",
        "link": "https://www.google.com/search?sca_esv=206cd4dd954885db&gl=US&hl=en&q=Pizza+Hut+menu&sa=X&ved=2ahUKEwiat_PfovSSAxXJ2AIHHSx3FwUQ1QJ6BAhnEAE",
        "rank": 2,
        "global_rank": 18
      },
      {
        "text": "Pizza definition",
        "link": "https://www.google.com/search?sca_esv=206cd4dd954885db&gl=US&hl=en&q=Pizza+definition&sa=X&ved=2ahUKEwiat_PfovSSAxXJ2AIHHSx3FwUQ1QJ6BAhmEAE",
        "rank": 3,
        "global_rank": 19
      }
    ],
    "people_also_ask": [
      {
        "question": "What's the 2 hour rule for pizza?",
        "question_type": "featured",
        "answer_source": "Curry Pizza House",
        "answer_link": "https://currypizzahouse.com/georgiadoubleupsocial-com/how-long-does-pizza-last/#:~:text=Pizza%20should%20NEVER%20be%20left,to%20prevent%20rapid%20bacteria%20growth.",
        "answer_display_link": "https://currypizzahouse.com › how-long-does-pizza-lasthttps://currypizzahouse.com › how-long-does-pizza-last",
        "answers": [
          {
            "type": "answer",
            "value": {
              "text": "Pizza should NEVER be left out for more than 2 hours (and just 1 hour if the room is above 90°F/32°C). Hot/Outdoor Events: When it's really warm, the safe window shrinks—refrigerate or ice your pizza within 20–60 minutes to prevent rapid bacteria growth.Jun 29, 2025"
            },
            "rank": 1
          }
        ],
        "rank": 1,
        "global_rank": 6
      }
    ],
    "oragnic": [
      {
        "link": "https://www.pizzahut.com/",
        "source": "Pizza Hut",
        "display_link": "https://www.pizzahut.com",
        "title": "Pizza Hut | Delivery & Carryout - No One OutPizzas The Hut!",
        "description": "$10 any pizza. Price includes Original Pan, Hand Tossed, Thin 'N Crispy. $10 ANY Large Pizza​. Up to 5 ...Read more",
        "snippet_highlighted_words": [
          "10 any pizza"
        ],
        "icon": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAABwAAA...",
        "image": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQABAAD/2w...",
        "image_alt": "pizza from www.pizzahut.com",
        "image_base64": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQABAAD/2w...",
        "rank": 1,
        "global_rank": 4
      },
      {
        "link": "https://www.dominos.com/",
        "source": "Domino's",
        "display_link": "https://www.dominos.com",
        "title": "Domino's: Pizza Delivery & Carryout, Pasta, Wings & More",
        "description": "Order pizza, pasta, sandwiches & more online for carryout or delivery from Domino's. View menu, find locations, track orders. Sign up for Domino's email ...",
        "snippet_highlighted_words": [
          "Order pizza, pasta, sandwiches & more online for carryout or delivery"
        ],
        "icon": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAABAAAA...",
        "image": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQABAAD/2w...",
        "image_alt": "pizza from www.dominos.com",
        "image_base64": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQABAAD/2w...",
        "rank": 2,
        "global_rank": 5
      },
      {
        "link": "https://www.papajohns.com/",
        "source": "Papa John's",
        "display_link": "https://www.papajohns.com",
        "title": "Papa Johns Pizza Delivery & Carryout - Best Deals on Pizza ...",
        "description": "Deals · Pizza · Papadias · Papa Bites · Wings · Sides · Papa Bowls · Desserts · Drinks · Dipping Sauces · Extras. Earn Papa Dough® faster than ever, and redeem ...Read more",
        "snippet_highlighted_words": [
          "Pizza"
        ],
        "icon": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAACAAAA...",
        "rank": 3,
        "global_rank": 10
      }
    ]
  }
  ```
</ResponseExample>


# Hotel
Source: https://docs.brightdata.com/api-reference/serp/google-search/hotel

Reference for the Bright Data Google Search Hotel parameter. Refines queries and returns matching results as JSON or HTML. On port 44445.

```http theme={null}
https://www.google.com/search?q=pizza&hotel_occupancy=4
```

<Tip>
  See `brd_occupancy` parameter of [Hotels](/api-reference/serp/google-hotels/occupancy) which provides more flexibility.
</Tip>

## Parameters

<ParamField type="string">
  The search query parameter. Specifies the keyword or phrase you want to search for on Google.
</ParamField>

<ParamField type="string">
  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` - for 2 persons (`default`)  \
  > `brd_occupancy=3` - for 3 persons, etc.

  ```txt wrap theme={null}
  https://www.google.com/search?q=pizza&hotel_occupancy=4
  ```
</ParamField>

<ParamField type="string">
  Check-in date and check-out date, separated by comma.

  > **Format**: `YYYY-MM-DD,YYYY-MM-DD`\
  > **Example**: `2026-04-03,2026-04-10`

  ```txt wrap theme={null}
  https://www.google.com/search?q=pizza&hotel_dates=2023-05-01%2C2023-05-03
  ```
</ParamField>

<RequestExample>
  ```shell cURL highlight={6} theme={null}
    curl -X POST https://api.brightdata.com/request \
    --header "Content-Type: application/json" \
    --header "Authorization: Bearer API_KEY" \
    --data '{
      "zone": "serp_api1",
      "url": "https://www.google.com/search?q=pizza&hotel_occupancy=4",
      "format": "raw"
    }'
  ```

  ```shell Native proxy highlight={4} theme={null}
  curl --proxy brd.superproxy.io:44445 \
    --proxy-user CUSTOMER_USERNAME:CUSTOMER_PASSWORD \
    --ssl-no-revoke \
    "https://www.google.com/search?q=pizza&hotel_occupancy=4"
  ```

  ```js Node.js highlight={10} theme={null}
  (async () => {
    const response = await fetch('https://api.brightdata.com/request', {
      method: 'POST',
      headers: {
        'Content-Type': 'application/json',
        'Authorization': 'Bearer API_KEY'
      },
      body: JSON.stringify({
        zone: 'serp_api1',
        url: 'https://www.google.com/search?q=pizza&hotel_occupancy=4',
        format: 'raw'
      })
    });
    
    const data = await response.text();
    console.log(data);
  })();
  ```

  ```python Python highlight={11} theme={null}
  import requests

  # API Configuration
  headers = {
      'Content-Type': 'application/json',
      'Authorization': 'Bearer API_KEY',
  }

  payload = {
      'zone': 'serp_api1',
      'url': 'https://www.google.com/search?q=pizza&hotel_occupancy=4',
      'format': 'raw'
  }

  # Make the request
  response = requests.post(
      'https://api.brightdata.com/request', 
      json=payload, 
      headers=headers
  )

  print(response.text)
  ```
</RequestExample>

<ResponseExample>
  ```json 200 highlight={13} theme={null}
  {
    "general": {
      "search_engine": "google",
      "query": "pizza",
      "language": "en",
      "mobile": false,
      "basic_view": false,
      "search_type": "text",
      "page_title": "pizza - Google Search",
      "timestamp": "2026-03-06T18:52:27.595Z"
    },
    "input": {
      "original_url": "https://www.google.com/search?q=pizza&hotel_occupancy=4",
      "request_id": "hl_xxxxxxxxxxxxxxx"
    },
    "navigation": [
      {
        "title": "AI Mode",
        "href": "https://www.google.com/search?q=pizza&sca_esv=173855d81f8ceba4&hotel_occupancy=4&gl=us&hl=en&udm=50&fbs=ADc_l-aN0CWEZBOHjofHoaMMDiKpaEWjvZ2Py1XXV8d8KvlI3o6iwGk6Iv1tRbZIBNIVs-4Dki9dynYvfwBVZUSUkihwf6Po1X8vgm-4XqAkWV_U_nEWDW6jSORACXpMnd172rhLzUI8cHh7a3WdrUa4STZi6DJP1PQVlodXI5fi6VycfM2fw28lhfWz323yxTcZ-fbjC5Yh0xzt6OfmbOYOjs4XIa7mEA&aep=1&ntc=1&sa=X&ved=2ahUKEwjeut_u-IuTAxWta_EDHaoGBS4Q2J8OegQIDhAE"
      },
      {
        "title": "Images",
        "href": "https://www.google.com/search?sca_esv=173855d81f8ceba4&hotel_occupancy=4&gl=us&hl=en&udm=2&fbs=ADc_l-aN0CWEZBOHjofHoaMMDiKpaEWjvZ2Py1XXV8d8KvlI3o6iwGk6Iv1tRbZIBNIVs-4Dki9dynYvfwBVZUSUkihwf6Po1X8vgm-4XqAkWV_U_nEWDW6jSORACXpMnd172rhLzUI8cHh7a3WdrUa4STZi6DJP1PQVlodXI5fi6VycfM2fw28lhfWz323yxTcZ-fbjC5Yh0xzt6OfmbOYOjs4XIa7mEA&q=pizza&sa=X&ved=2ahUKEwjeut_u-IuTAxWta_EDHaoGBS4QtKgLegQIFBAB"
      },
      {
        "title": "Shopping",
        "href": "https://www.google.com/search?sca_esv=173855d81f8ceba4&hotel_occupancy=4&gl=us&hl=en&udm=28&fbs=ADc_l-aN0CWEZBOHjofHoaMMDiKpaEWjvZ2Py1XXV8d8KvlI3o6iwGk6Iv1tRbZIBNIVs-4Dki9dynYvfwBVZUSUkihwf6Po1X8vgm-4XqAkWV_U_nEWDW6jSORACXpMnd172rhLzUI8cHh7a3WdrUa4STZi6DJP1PQVlodXI5fi6VycfM2fw28lhfWz323yxTcZ-fbjC5Yh0xzt6OfmbOYOjs4XIa7mEA&q=pizza&ved=1t:220175&ictx=111"
      },
      {
        "title": "Maps",
        "href": "https://maps.google.com/maps?sca_esv=173855d81f8ceba4&hotel_occupancy=4&gl=us&hl=en&output=search&q=pizza&source=lnms&fbs=ADc_l-aN0CWEZBOHjofHoaMMDiKpaEWjvZ2Py1XXV8d8KvlI3o6iwGk6Iv1tRbZIBNIVs-4Dki9dynYvfwBVZUSUkihwf6Po1X8vgm-4XqAkWV_U_nEWDW6jSORACXpMnd172rhLzUI8cHh7a3WdrUa4STZi6DJP1PQVlodXI5fi6VycfM2fw28lhfWz323yxTcZ-fbjC5Yh0xzt6OfmbOYOjs4XIa7mEA&entry=mc&ved=1t:200715&ictx=111"
      },
      {
        "title": "Videos",
        "href": "https://www.google.com/search?sca_esv=173855d81f8ceba4&hotel_occupancy=4&gl=us&hl=en&udm=7&fbs=ADc_l-aN0CWEZBOHjofHoaMMDiKpaEWjvZ2Py1XXV8d8KvlI3o6iwGk6Iv1tRbZIBNIVs-4Dki9dynYvfwBVZUSUkihwf6Po1X8vgm-4XqAkWV_U_nEWDW6jSORACXpMnd172rhLzUI8cHh7a3WdrUa4STZi6DJP1PQVlodXI5fi6VycfM2fw28lhfWz323yxTcZ-fbjC5Yh0xzt6OfmbOYOjs4XIa7mEA&q=pizza&sa=X&ved=2ahUKEwjeut_u-IuTAxWta_EDHaoGBS4QtKgLegQIEhAB"
      },
      {
        "title": "Short videos",
        "href": "https://www.google.com/search?sca_esv=173855d81f8ceba4&hotel_occupancy=4&gl=us&hl=en&udm=39&fbs=ADc_l-aN0CWEZBOHjofHoaMMDiKpaEWjvZ2Py1XXV8d8KvlI3o6iwGk6Iv1tRbZIBNIVs-4Dki9dynYvfwBVZUSUkihwf6Po1X8vgm-4XqAkWV_U_nEWDW6jSORACXpMnd172rhLzUI8cHh7a3WdrUa4STZi6DJP1PQVlodXI5fi6VycfM2fw28lhfWz323yxTcZ-fbjC5Yh0xzt6OfmbOYOjs4XIa7mEA&q=pizza&sa=X&ved=2ahUKEwjeut_u-IuTAxWta_EDHaoGBS4Qs6gLegQIERAB"
      },
      {
        "title": "Forums",
        "href": "https://www.google.com/search?sca_esv=173855d81f8ceba4&hotel_occupancy=4&gl=us&hl=en&udm=18&fbs=ADc_l-aN0CWEZBOHjofHoaMMDiKpaEWjvZ2Py1XXV8d8KvlI3o6iwGk6Iv1tRbZIBNIVs-4Dki9dynYvfwBVZUSUkihwf6Po1X8vgm-4XqAkWV_U_nEWDW6jSORACXpMnd172rhLzUI8cHh7a3WdrUa4STZi6DJP1PQVlodXI5fi6VycfM2fw28lhfWz323yxTcZ-fbjC5Yh0xzt6OfmbOYOjs4XIa7mEA&q=pizza&sa=X&ved=2ahUKEwjeut_u-IuTAxWta_EDHaoGBS4Qs6gLegUI0gEQAQ"
      },
      {
        "title": "News",
        "href": "https://www.google.com/search?sca_esv=173855d81f8ceba4&hotel_occupancy=4&gl=us&hl=en&q=pizza&tbm=nws&source=lnms&fbs=ADc_l-aN0CWEZBOHjofHoaMMDiKpaEWjvZ2Py1XXV8d8KvlI3o6iwGk6Iv1tRbZIBNIVs-4Dki9dynYvfwBVZUSUkihwf6Po1X8vgm-4XqAkWV_U_nEWDW6jSORACXpMnd172rhLzUI8cHh7a3WdrUa4STZi6DJP1PQVlodXI5fi6VycfM2fw28lhfWz323yxTcZ-fbjC5Yh0xzt6OfmbOYOjs4XIa7mEA&sa=X&ved=2ahUKEwjeut_u-IuTAxWta_EDHaoGBS4Q0pQJegUI0wEQAQ"
      },
      {
        "title": "Web",
        "href": "https://www.google.com/search?sca_esv=173855d81f8ceba4&hotel_occupancy=4&gl=us&hl=en&udm=web&fbs=ADc_l-aN0CWEZBOHjofHoaMMDiKpaEWjvZ2Py1XXV8d8KvlI3o6iwGk6Iv1tRbZIBNIVs-4Dki9dynYvfwBVZUSUkihwf6Po1X8vgm-4XqAkWV_U_nEWDW6jSORACXpMnd172rhLzUI8cHh7a3WdrUa4STZi6DJP1PQVlodXI5fi6VycfM2fw28lhfWz323yxTcZ-fbjC5Yh0xzt6OfmbOYOjs4XIa7mEA&q=pizza&sa=X&ved=2ahUKEwjeut_u-IuTAxWta_EDHaoGBS4Qs6gLegUI2QEQAQ"
      },
      {
        "title": "Books",
        "href": "https://www.google.com/search?sca_esv=173855d81f8ceba4&hotel_occupancy=4&gl=us&hl=en&q=pizza&udm=36&source=lnms&fbs=ADc_l-aN0CWEZBOHjofHoaMMDiKpaEWjvZ2Py1XXV8d8KvlI3o6iwGk6Iv1tRbZIBNIVs-4Dki9dynYvfwBVZUSUkihwf6Po1X8vgm-4XqAkWV_U_nEWDW6jSORACXpMnd172rhLzUI8cHh7a3WdrUa4STZi6DJP1PQVlodXI5fi6VycfM2fw28lhfWz323yxTcZ-fbjC5Yh0xzt6OfmbOYOjs4XIa7mEA&sa=X&ved=2ahUKEwjeut_u-IuTAxWta_EDHaoGBS4Q0pQJegUI1wEQAQ"
      },
      {
        "title": "Pizza",
        "href": "https://www.google.com/search?sca_esv=173855d81f8ceba4&hotel_occupancy=4&gl=us&hl=en&q=Restaurant&uds=ALYpb_ncDc7jTlmw6Mmq7NjuX5c-YkRxG3oIOwBP9pqV8A9knLvLZuH8Ewms8PAcf7ea3t4NPsly-1JiYt9S6VsSRnLf-sxULmbNLebMKQgkhwHc2FSfFXQ&sa=X&ved=2ahUKEwjeut_u-IuTAxWta_EDHaoGBS4Qkc0JKAB6BAgVEAE&ictx=0"
      }
    ],
    "organic": [
      {
        "link": "https://www.pizzahut.com/",
        "source": "Pizza Hut",
        "display_link": "https://www.pizzahut.com",
        "title": "Pizza Hut | Delivery & Carryout - No One OutPizzas The Hut!",
        "description": "$10 any pizza. Price includes Original Pan, Hand Tossed, Thin 'N Crispy. $10 ANY Large Pizza​. Up to 5 ...Read more",
        "snippet_highlighted_words": [
          "10 any pizza"
        ],
        "icon": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAABwAAA...",
        "image": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQABAAD/2w...",
        "image_alt": "pizza from www.pizzahut.com",
        "image_base64": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQABAAD/2w...",
        "rank": 1,
        "global_rank": 4
      },
      {
        "link": "https://en.wikipedia.org/wiki/Pizza",
        "source": "Wikipedia",
        "display_link": "https://en.wikipedia.org › wiki › Pizza",
        "title": "Pizza",
        "description": "Pizza is an Italian dish typically consisting of a flat base of leavened wheat-based dough topped with tomato, cheese, and other ingredients, baked at a ...Read more",
        "snippet_highlighted_words": [
          "an Italian dish typically consisting of a flat base of leavened wheat-based dough"
        ],
        "icon": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAABwAAA...",
        "image": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQABAAD/2w...",
        "image_alt": "pizza from en.wikipedia.org",
        "image_base64": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQABAAD/2w...",
        "rank": 2,
        "global_rank": 5
      },
      {
        "link": "https://www.dominos.com/",
        "source": "Domino's Pizza",
        "display_link": "https://www.dominos.com",
        "title": "Domino's: Pizza Delivery & Carryout, Pasta, Wings & More",
        "description": "Order pizza, pasta, sandwiches & more online for carryout or delivery from Domino's. View menu ... Any pizza. Any toppings. $9.99 each. Choose your crust ...Read more",
        "snippet_highlighted_words": [
          "Order pizza, pasta, sandwiches & more online for carryout or delivery"
        ],
        "icon": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAABAAAA...",
        "rank": 3,
        "global_rank": 6
      },
      {
        "link": "https://www.papajohns.com/",
        "source": "Papa John's",
        "display_link": "https://www.papajohns.com",
        "title": "Papa Johns Pizza Delivery & Carryout - Best Deals on Pizza ...",
        "description": "Enjoy the ease of ordering delicious pizza for delivery or carryout from a Papa Johns near you. Start tracking the speed of your delivery and earn rewards ...",
        "snippet_highlighted_words": [
          "Enjoy the ease of ordering delicious pizza for delivery or carryout"
        ],
        "icon": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAACAAAA...",
        "rank": 4,
        "global_rank": 7
      },
      {
        "link": "https://www.hellopizza.com/",
        "source": "Hello Pizza",
        "display_link": "https://www.hellopizza.com",
        "title": "Home | Hello Pizza in Edina, MN",
        "description": "Hello Pizza in Minneapolis offers dine in, takeaway and delivery.",
        "snippet_highlighted_words": [
          "Hello Pizza in Minneapolis"
        ],
        "icon": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAABwAAA...",
        "image": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcT2K0fe4r_e0X_q3ijPJKuQWN-LaKhDS1ZS3q8z-c-YBKR5jV6GYSLB&usqp=CAE&s",
        "image_alt": "pizza from www.hellopizza.com",
        "image_url": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcT2K0fe4r_e0X_q3ijPJKuQWN-LaKhDS1ZS3q8z-c-YBKR5jV6GYSLB&usqp=CAE&s",
        "rank": 5,
        "global_rank": 8
      },
      {
        "link": "https://www.facebook.com/stoolpresidente/videos/i-found-great-chicago-style-pizza-in-atlanta-with-an-incredible-story-too/925930907057728/",
        "source": "Facebook · David Portnoy - El Presidente",
        "display_link": "350+ reactions · 1 hour ago",
        "title": "I Found GREAT Chicago Style Pizza In Atlanta With An ...",
        "description": "Alberta Lozi's Pizzeria. Chicago style. I already forgot. It's named after his mother. It's a tribute to my mom who passed away from cancer so ...",
        "icon": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAABwAAA...",
        "image": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcR5c2hDx_iSKy6EZsP9xZs8QiiWeJTFvLCieUWpTGrisX2C_ftYCYejdA&s",
        "image_url": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcR5c2hDx_iSKy6EZsP9xZs8QiiWeJTFvLCieUWpTGrisX2C_ftYCYejdA&s",
        "duration": "1:02",
        "duration_sec": 62,
        "rank": 6,
        "global_rank": 9
      },
      {
        "link": "https://www.nytimes.com/2026/03/03/dining/pizza-hut.html",
        "source": "The New York Times",
        "display_link": "https://www.nytimes.com › 2026/03/03 › dining › pizz...",
        "title": "Pizza Hut Take Fans on a Trip to the Past",
        "description": "The deep-dish pan pizza dates back to the beginning of Pizza Hut. The deep-dish pan pizza has been a Pizza Hut signature from the beginning.Read more",
        "snippet_highlighted_words": [
          "deep-dish pan pizza"
        ],
        "extensions": [
          {
            "inline": true,
            "type": "text",
            "text": "3 days ago",
            "rank": 1
          }
        ],
        "icon": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAABwAAA...",
        "rank": 7,
        "global_rank": 10
      },
      {
        "link": "https://littlecaesars.com/",
        "source": "Little Caesars",
        "display_link": "https://littlecaesars.com",
        "title": "Little Caesars® Pizza | Best Value Delivery & Carryout",
        "description": "Order HOT-N-READY® pizzas, Crazy Bread®, and more from Little Caesars® online for delivery or carryout.",
        "snippet_highlighted_words": [
          "Order HOT-N-READY® pizzas"
        ],
        "icon": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAACAAAA...",
        "rank": 8,
        "global_rank": 11
      },
      {
        "link": "https://www.reddit.com/r/AskLosAngeles/comments/1rm1wui/who_has_the_best_pizza_in_la/",
        "source": "Reddit · r/AskLosAngeles",
        "display_link": "350+ comments · 16 hours ago",
        "title": "Who has the best pizza in LA? : r/AskLosAngeles",
        "description": "Desano is good, but there is better Neapolitan pizza around (Pizzeria Sei is probably the gold standard in LA). Quarter Sheets is fantastic ...Read more",
        "snippet_highlighted_words": [
          "pizza",
          "Pizzeria"
        ],
        "icon": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAABwAAA...",
        "rank": 9,
        "global_rank": 12
      }
    ],
    "perspectives": [
      {
        "title": "Who has the best pizza in LA? Popular comment · Pizzeria Sei for Neapolitan. Then Bianco, Pizzana.",
        "author": "r/AskLosAngeles",
        "source": "Reddit",
        "date": "350+ comments · 16 hours ago",
        "link": "https://www.reddit.com/r/AskLosAngeles/comments/1rm1wui/who_has_the_best_pizza_in_la/"
      },
      {
        "title": "I Ate In America's Pizza Capital To Find The Best Pizza",
        "author": "sir yacht · YouTube",
        "source": "TikTok star & Food Network contestant",
        "date": "275.7K+ views · 4 days ago",
        "link": "https://www.youtube.com/watch?v=gCalAS4SlaM",
        "image": "https://img.youtube.com/vi/gCalAS4SlaM/hqdefault.jpg",
        "image_url": "https://img.youtube.com/vi/gCalAS4SlaM/hqdefault.jpg"
      },
      {
        "title": "I Found GREAT Chicago Style Pizza In Atlanta With An Incredible Story Too",
        "author": "stoolpresidente · Facebook",
        "source": "American businessman",
        "date": "350+ reactions · 2 hours ago",
        "link": "https://www.facebook.com/stoolpresidente/videos/i-found-great-chicago-style-pizza-in-atlanta-with-an-incredible-story-too/925930907057728/",
        "image": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcSlVOtYpEd8y0JpkiNMhy51ybHS8Vt_dBgXfZOghf-HYebs5Io7KC1EQIa8CQ&usqp=CAI&s=10",
        "image_url": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcSlVOtYpEd8y0JpkiNMhy51ybHS8Vt_dBgXfZOghf-HYebs5Io7KC1EQIa8CQ&usqp=CAI&s=10"
      },
      {
        "title": "Barstool Pizza Review - Glide Pizza (Decatur, GA)",
        "author": "One Bite Pizza Reviews · YouTube",
        "source": "Pizza reviews & rankings",
        "date": "96.8K+ views · 3 days ago",
        "link": "https://www.youtube.com/watch?v=5IVjXnV15cE",
        "image": "https://img.youtube.com/vi/5IVjXnV15cE/hqdefault.jpg",
        "image_url": "https://img.youtube.com/vi/5IVjXnV15cE/hqdefault.jpg"
      },
      {
        "title": "Where can I find a pizza like this?",
        "author": "r/SanJose",
        "source": "Reddit",
        "date": "60+ comments · 19 hours ago",
        "link": "https://www.reddit.com/r/SanJose/comments/1rlxx81/where_can_i_find_a_pizza_like_this/",
        "image": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcSOgiaOW0FYTVRHJqNFtVAhux6nSpnvNr6w1epX8AvZykRiZR5ZGLpje07b_g&usqp=CAI&s",
        "image_url": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcSOgiaOW0FYTVRHJqNFtVAhux6nSpnvNr6w1epX8AvZykRiZR5ZGLpje07b_g&usqp=CAI&s"
      },
      {
        "title": "Easy Homemade Pizza That Beats Takeout",
        "author": "In The Kitchen With Gina Young · YouTube",
        "source": "Cooking channel",
        "date": "490+ views · 20 hours ago",
        "link": "https://www.youtube.com/watch?v=CVFKdARKonI",
        "image": "https://img.youtube.com/vi/CVFKdARKonI/hqdefault.jpg",
        "image_url": "https://img.youtube.com/vi/CVFKdARKonI/hqdefault.jpg"
      },
      {
        "title": "Best pizza in Port St Lucie Fla?",
        "author": "Pizzaholics · Facebook",
        "source": "Pizza enthusiast",
        "date": "29 minutes ago",
        "link": "https://www.facebook.com/groups/742034912983989/posts/2439433803244083/",
        "image": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcTAPzkwKJX8rct5LhEtAN6p-ypb5UjDiHn0aZ8e9S6nS8tPmROY_1E2gFxXeus&usqp=CAI&s",
        "image_url": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcTAPzkwKJX8rct5LhEtAN6p-ypb5UjDiHn0aZ8e9S6nS8tPmROY_1E2gFxXeus&usqp=CAI&s"
      },
      {
        "title": "Friday pizza night",
        "author": "r/80s",
        "source": "Reddit",
        "date": "300+ comments · 7 hours ago",
        "link": "https://www.reddit.com/r/80s/comments/1rmbv8y/friday_pizza_night/",
        "image": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcSOjE6TPBJKWHgNAjhsCCUJcO1rt2p_P-UcmzHUdys7bLeSQdacHm3Zs-7FIQ&usqp=CAI&s",
        "image_url": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcSOjE6TPBJKWHgNAjhsCCUJcO1rt2p_P-UcmzHUdys7bLeSQdacHm3Zs-7FIQ&usqp=CAI&s"
      },
      {
        "title": "Only the best at Krispy Pizza! 🍕💯 #KRISPYPIZZA",
        "author": "krispypizza · Instagram",
        "source": "Brooklyn-based pizza parlor",
        "date": "1.1K+ likes · 3 hours ago",
        "link": "https://www.instagram.com/reel/DVjJxy-Dt4U/",
        "image": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcSurMetfUkGZYejKARlaFBojMWqZxMT-oU92H8yOzKMaTVd2dQdaohonHumBw&usqp=CAI&s=10",
        "image_url": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcSurMetfUkGZYejKARlaFBojMWqZxMT-oU92H8yOzKMaTVd2dQdaohonHumBw&usqp=CAI&s=10"
      },
      {
        "title": "Homemade Pepperoni Pizza Rolls That Are Ridiculously Easy",
        "author": "allthingsbbq · YouTube",
        "source": "BBQ store",
        "date": "4.8K+ views · 1 day ago",
        "link": "https://www.youtube.com/watch?v=u5cOPjwKobM",
        "image": "https://img.youtube.com/vi/u5cOPjwKobM/hqdefault.jpg",
        "image_url": "https://img.youtube.com/vi/u5cOPjwKobM/hqdefault.jpg"
      },
      {
        "title": "Top Pizza in the Bay Area",
        "author": "Cesar Hernandez, Soleil Ho",
        "source": "San Francisco Chronicle",
        "date": "1 month ago",
        "link": "https://www.sfchronicle.com/projects/2023/best-pizza-sf-bay-area/",
        "image": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcSPGyTJpaRNE8ruXgkLdHkPFLVu5T7ykcJezvyYa07SUmrk7T0XaSntO19GBw&usqp=CAI&s",
        "image_url": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcSPGyTJpaRNE8ruXgkLdHkPFLVu5T7ykcJezvyYa07SUmrk7T0XaSntO19GBw&usqp=CAI&s"
      },
      {
        "title": "Best Pizza in Sonoma County: 16 Editor-Approved Spots for Tasty Pies",
        "author": "Heather Irwin · Sonoma Magazine",
        "source": "Sonoma County dining writer",
        "date": "1 month ago",
        "link": "https://www.sonomamag.com/best-pizza-in-sonoma-county-favorite-restaurants-for-tasty-pies/",
        "image": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcRKzKYqmgbflEzazf8g_Fnp6r4J6ZIO3t95YB0TFq11OXOKFQ8kMf2TeeEzww&usqp=CAI&s",
        "image_url": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcRKzKYqmgbflEzazf8g_Fnp6r4J6ZIO3t95YB0TFq11OXOKFQ8kMf2TeeEzww&usqp=CAI&s"
      }
    ],
    "knowledge": {
      "name": "Pizza",
      "summary": "Dish",
      "subtitle": "Dish",
      "nutrition_facts": {
        "product": "Pizza, 14\" regular crust",
        "source": "USDA",
        "source_link": "https://fdc.nal.usda.gov/food-details/173292/nutrients",
        "calories": "285 Calories",
        "portion": "1 slice (107 g)"
      }
    },
    "overview": {
      "title": "Pizza",
      "kgmid": "/m/0663v"
    },
    "snack_pack_map": {
      "image": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAowAAA...",
      "image_base64": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAowAAA...",
      "link": "https://www.google.com/search?q=pizza&sca_esv=173855d81f8ceba4&hotel_occupancy=4&gl=us&hl=en&udm=1&lsack=aSKraZ7iJK3Xxc8Pqo2U8AI&sa=X&ved=2ahUKEwjeut_u-IuTAxWta_EDHaoGBS4QtgN6BAgaEAM"
    },
    "snack_pack": [
      {
        "cid": "17310745698520163861",
        "name": "Vito Lucco Pizza Co.",
        "image": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQABAAD/2w...",
        "image_base64": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQABAAD/2w...",
        "reviews_cnt": 5,
        "type": "Pizza Takeout",
        "work_status": "Takeout·Takeout·No-contact deliveryNo-contact delivery",
        "address": "Fridley, MN",
        "rank": 1,
        "global_rank": 1
      },
      {
        "cid": "6845281105756624082",
        "name": "Market Street Pizza",
        "image": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQABAAD/2w...",
        "image_base64": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQABAAD/2w...",
        "reviews_cnt": 4,
        "type": "Pizza",
        "work_status": "Opens soon",
        "work_status_details": "11 AM",
        "address": "Spokane, WA",
        "rank": 2,
        "global_rank": 2
      },
      {
        "cid": "12478441968863339846",
        "name": "Best Pizza & Brew",
        "image": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQABAAD/4Q...",
        "image_base64": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQABAAD/4Q...",
        "reviews_cnt": 4,
        "type": "Pizza",
        "work_status": "Opens soon",
        "work_status_details": "11 AM",
        "address": "Oceanside, CA",
        "rank": 3,
        "global_rank": 3
      }
    ],
    "pagination": {
      "pages": [
        {
          "page": 2,
          "start": 10,
          "link": "https://www.google.com/search?q=pizza&sca_esv=173855d81f8ceba4&hotel_occupancy=4&gl=us&hl=en&ei=aSKraZ7iJK3Xxc8Pqo2U8AI&start=10&sa=N&sstk=Af77f_e5v5TopL795qiozhhU5eJn4iwBi5glMnBqhjrpgSsD85n-Zjv1OCUpsxqxJjRLcAjTe6I5pFI3UdNBkjvPwf4WrFeN_AE87g&ved=2ahUKEwjeut_u-IuTAxWta_EDHaoGBS4Q8tMDegQIChAE"
        },
        {
          "page": 3,
          "start": 20,
          "link": "https://www.google.com/search?q=pizza&sca_esv=173855d81f8ceba4&hotel_occupancy=4&gl=us&hl=en&ei=aSKraZ7iJK3Xxc8Pqo2U8AI&start=20&sa=N&sstk=Af77f_e5v5TopL795qiozhhU5eJn4iwBi5glMnBqhjrpgSsD85n-Zjv1OCUpsxqxJjRLcAjTe6I5pFI3UdNBkjvPwf4WrFeN_AE87g&ved=2ahUKEwjeut_u-IuTAxWta_EDHaoGBS4Q8tMDegQIChAG"
        },
        {
          "page": 4,
          "start": 30,
          "link": "https://www.google.com/search?q=pizza&sca_esv=173855d81f8ceba4&hotel_occupancy=4&gl=us&hl=en&ei=aSKraZ7iJK3Xxc8Pqo2U8AI&start=30&sa=N&sstk=Af77f_e5v5TopL795qiozhhU5eJn4iwBi5glMnBqhjrpgSsD85n-Zjv1OCUpsxqxJjRLcAjTe6I5pFI3UdNBkjvPwf4WrFeN_AE87g&ved=2ahUKEwjeut_u-IuTAxWta_EDHaoGBS4Q8tMDegQIChAI"
        },
        {
          "page": 5,
          "start": 40,
          "link": "https://www.google.com/search?q=pizza&sca_esv=173855d81f8ceba4&hotel_occupancy=4&gl=us&hl=en&ei=aSKraZ7iJK3Xxc8Pqo2U8AI&start=40&sa=N&sstk=Af77f_e5v5TopL795qiozhhU5eJn4iwBi5glMnBqhjrpgSsD85n-Zjv1OCUpsxqxJjRLcAjTe6I5pFI3UdNBkjvPwf4WrFeN_AE87g&ved=2ahUKEwjeut_u-IuTAxWta_EDHaoGBS4Q8tMDegQIChAK"
        },
        {
          "page": 6,
          "start": 50,
          "link": "https://www.google.com/search?q=pizza&sca_esv=173855d81f8ceba4&hotel_occupancy=4&gl=us&hl=en&ei=aSKraZ7iJK3Xxc8Pqo2U8AI&start=50&sa=N&sstk=Af77f_e5v5TopL795qiozhhU5eJn4iwBi5glMnBqhjrpgSsD85n-Zjv1OCUpsxqxJjRLcAjTe6I5pFI3UdNBkjvPwf4WrFeN_AE87g&ved=2ahUKEwjeut_u-IuTAxWta_EDHaoGBS4Q8tMDegQIChAM"
        },
        {
          "page": 7,
          "start": 60,
          "link": "https://www.google.com/search?q=pizza&sca_esv=173855d81f8ceba4&hotel_occupancy=4&gl=us&hl=en&ei=aSKraZ7iJK3Xxc8Pqo2U8AI&start=60&sa=N&sstk=Af77f_e5v5TopL795qiozhhU5eJn4iwBi5glMnBqhjrpgSsD85n-Zjv1OCUpsxqxJjRLcAjTe6I5pFI3UdNBkjvPwf4WrFeN_AE87g&ved=2ahUKEwjeut_u-IuTAxWta_EDHaoGBS4Q8tMDegQIChAO"
        },
        {
          "page": 8,
          "start": 70,
          "link": "https://www.google.com/search?q=pizza&sca_esv=173855d81f8ceba4&hotel_occupancy=4&gl=us&hl=en&ei=aSKraZ7iJK3Xxc8Pqo2U8AI&start=70&sa=N&sstk=Af77f_e5v5TopL795qiozhhU5eJn4iwBi5glMnBqhjrpgSsD85n-Zjv1OCUpsxqxJjRLcAjTe6I5pFI3UdNBkjvPwf4WrFeN_AE87g&ved=2ahUKEwjeut_u-IuTAxWta_EDHaoGBS4Q8tMDegQIChAQ"
        },
        {
          "page": 9,
          "start": 80,
          "link": "https://www.google.com/search?q=pizza&sca_esv=173855d81f8ceba4&hotel_occupancy=4&gl=us&hl=en&ei=aSKraZ7iJK3Xxc8Pqo2U8AI&start=80&sa=N&sstk=Af77f_e5v5TopL795qiozhhU5eJn4iwBi5glMnBqhjrpgSsD85n-Zjv1OCUpsxqxJjRLcAjTe6I5pFI3UdNBkjvPwf4WrFeN_AE87g&ved=2ahUKEwjeut_u-IuTAxWta_EDHaoGBS4Q8tMDegQIChAS"
        },
        {
          "page": 10,
          "start": 90,
          "link": "https://www.google.com/search?q=pizza&sca_esv=173855d81f8ceba4&hotel_occupancy=4&gl=us&hl=en&ei=aSKraZ7iJK3Xxc8Pqo2U8AI&start=90&sa=N&sstk=Af77f_e5v5TopL795qiozhhU5eJn4iwBi5glMnBqhjrpgSsD85n-Zjv1OCUpsxqxJjRLcAjTe6I5pFI3UdNBkjvPwf4WrFeN_AE87g&ved=2ahUKEwjeut_u-IuTAxWta_EDHaoGBS4Q8tMDegQIChAU"
        }
      ],
      "current_page": 1,
      "next_page": 2,
      "next_page_start": 10,
      "next_page_link": "https://www.google.com/search?q=pizza&sca_esv=173855d81f8ceba4&hotel_occupancy=4&gl=us&hl=en&ei=aSKraZ7iJK3Xxc8Pqo2U8AI&start=10&sa=N&sstk=Af77f_e5v5TopL795qiozhhU5eJn4iwBi5glMnBqhjrpgSsD85n-Zjv1OCUpsxqxJjRLcAjTe6I5pFI3UdNBkjvPwf4WrFeN_AE87g&ved=2ahUKEwjeut_u-IuTAxWta_EDHaoGBS4Q8tMDegQIChAE"
    },
    "related": [
      {
        "text": "Pizza wiki",
        "link": "https://www.google.com/search?sca_esv=173855d81f8ceba4&hotel_occupancy=4&gl=us&hl=en&q=Pizza+wiki&sa=X&ved=2ahUKEwjeut_u-IuTAxWta_EDHaoGBS4Q1QJ6BQjHARAB",
        "rank": 1,
        "global_rank": 13
      },
      {
        "text": "Pizza Hut near me",
        "link": "https://www.google.com/search?sca_esv=173855d81f8ceba4&hotel_occupancy=4&gl=us&hl=en&q=Pizza+Hut+near+me&sa=X&ved=2ahUKEwjeut_u-IuTAxWta_EDHaoGBS4Q1QJ6BQjNARAB",
        "rank": 2,
        "global_rank": 14
      },
      {
        "text": "Pizza open",
        "link": "https://www.google.com/search?sca_esv=173855d81f8ceba4&hotel_occupancy=4&gl=us&hl=en&q=Pizza+open&sa=X&ved=2ahUKEwjeut_u-IuTAxWta_EDHaoGBS4Q1QJ6BQjPARAB",
        "rank": 3,
        "global_rank": 15
      },
      {
        "text": "Pizza Hut menu",
        "link": "https://www.google.com/search?sca_esv=173855d81f8ceba4&hotel_occupancy=4&gl=us&hl=en&q=Pizza+Hut+menu&sa=X&ved=2ahUKEwjeut_u-IuTAxWta_EDHaoGBS4Q1QJ6BQjIARAB",
        "rank": 4,
        "global_rank": 16
      },
      {
        "text": "Pizza drawing",
        "link": "https://www.google.com/search?sca_esv=173855d81f8ceba4&hotel_occupancy=4&gl=us&hl=en&q=Pizza+drawing&sa=X&ved=2ahUKEwjeut_u-IuTAxWta_EDHaoGBS4Q1QJ6BQjLARAB",
        "rank": 5,
        "global_rank": 17
      },
      {
        "text": "Pizza picture",
        "link": "https://www.google.com/search?sca_esv=173855d81f8ceba4&hotel_occupancy=4&gl=us&hl=en&q=Pizza+picture&sa=X&ved=2ahUKEwjeut_u-IuTAxWta_EDHaoGBS4Q1QJ6BQjJARAB",
        "rank": 6,
        "global_rank": 18
      },
      {
        "text": "Pizza Movie",
        "link": "https://www.google.com/search?sca_esv=173855d81f8ceba4&hotel_occupancy=4&gl=us&hl=en&q=Pizza+Movie&sa=X&ved=2ahUKEwjeut_u-IuTAxWta_EDHaoGBS4Q1QJ6BQjKARAB",
        "rank": 7,
        "global_rank": 19
      },
      {
        "text": "Pizza recipe",
        "link": "https://www.google.com/search?sca_esv=173855d81f8ceba4&hotel_occupancy=4&gl=us&hl=en&q=Pizza+recipe&sa=X&ved=2ahUKEwjeut_u-IuTAxWta_EDHaoGBS4Q1QJ6BQjOARAB",
        "rank": 8,
        "global_rank": 20
      }
    ]
  }
  ```
</ResponseExample>


# Image search
Source: https://docs.brightdata.com/api-reference/serp/google-search/images

Configure the Bright Data Google Search Image Search parameter to refine queries and return matching results as JSON or HTML. On port 44445.

```http theme={null}
https://www.google.com/search?q=pizza&tbm=isch
```

## Parameters

<ParamField type="string">
  The search query parameter. Specifies the keyword or phrase you want to search for on Google.
</ParamField>

<ParamField type="string">
  Define search type. For Image search, set `tbm` value to `isch`

  ```http theme={null}
  https://www.google.com/search?q=pizza&tbm=isch
  ```
</ParamField>

<RequestExample>
  ```shell cURL highlight={6} theme={null}
    curl -X POST https://api.brightdata.com/request \
    --header "Content-Type: application/json" \
    --header "Authorization: Bearer API_KEY" \
    --data '{
      "zone": "serp_api1",
      "url": "https://www.google.com/search?q=pizza&tbm=isch",
      "format": "raw"
    }'
  ```

  ```shell Native proxy highlight={4} theme={null}
  curl --proxy brd.superproxy.io:44445 \
    --proxy-user CUSTOMER_USERNAME:CUSTOMER_PASSWORD \
    --ssl-no-revoke \
    "https://www.google.com/search?q=pizza&tbm=isch"
  ```

  ```js Node.js highlight={10} theme={null}
  (async () => {
    const response = await fetch('https://api.brightdata.com/request', {
      method: 'POST',
      headers: {
        'Content-Type': 'application/json',
        'Authorization': 'Bearer API_KEY'
      },
      body: JSON.stringify({
        zone: 'serp_api1',
        url: 'https://www.google.com/search?q=pizza&tbm=isch',
        format: 'raw'
      })
    });
    
    const data = await response.text();
    console.log(data);
  })();
  ```

  ```python Python highlight={11} theme={null}
  import requests

  # API Configuration
  headers = {
      'Content-Type': 'application/json',
      'Authorization': 'Bearer API_KEY',
  }

  payload = {
      'zone': 'serp_api1',
      'url': 'https://www.google.com/search?q=pizza&tbm=isch',
      'format': 'raw'
  }

  # Make the request
  response = requests.post(
      'https://api.brightdata.com/request', 
      json=payload, 
      headers=headers
  )

  print(response.text)
  ```
</RequestExample>

<ResponseExample>
  ```json 200 highlight={14} theme={null}
  {
    "general": {
      "search_engine": "google",
      "query": "pizza",
      "results_cnt": 656000000,
      "search_time": 0.28,
      "language": "en-CO",
      "country": "Colombia",
      "country_code": "CO",
      "location": "United States",
      "gl": "CO",
      "mobile": false,
      "basic_view": false,
      "search_type": "image_output",
      "page_title": "pizza - Google Search",
      "timestamp": "2026-02-24T20:28:05.271Z"
    },
    "input": {
      "original_url": "https://www.google.com/search?q=pizza&tbm=isch&brd_json=1",
      "request_id": "hl_xxxxxxxxxxxxxxx"
    },
    "navigation": [
      {
        "title": "AI Mode",
        "href": "https://www.google.com/search?q=pizza&sca_esv=62b03b7345eac9c6&hl=en&udm=50&fbs=ADc_l-aN0CWEZBOHjofHoaMMDiKpUrv6YeyJhXfuYqj4Fj6c1Tg5t_ufWNUvD2V-uX26AFmzd3PgOqQPiZGQbkKtfgZKjRVM-fWbSp27mOZd-VNrvsbfJifTcov-iKLq_qwKGsmICHQsDRnG2LrYhoqkYhIypqPFo4FOivgbAwMhEGvaBpiHBPZ7uoGgmnRvbGb63LsPIFEs5NpsiXI1a_RIDq28fxm4tQ&aep=1&ntc=1&sa=X&ved=2ahUKEwi9pfzK-_KSAxVOe_UHHXz3CLAQ2J8OegQICRAD"
      },
      {
        "title": "All",
        "href": "https://www.google.com/search?sca_esv=62b03b7345eac9c6&hl=en&q=pizza&source=lnms&fbs=ADc_l-aN0CWEZBOHjofHoaMMDiKpUrv6YeyJhXfuYqj4Fj6c1Tg5t_ufWNUvD2V-uX26AFmzd3PgOqQPiZGQbkKtfgZKjRVM-fWbSp27mOZd-VNrvsbfJifTcov-iKLq_qwKGsmICHQsDRnG2LrYhoqkYhIypqPFo4FOivgbAwMhEGvaBpiHBPZ7uoGgmnRvbGb63LsPIFEs5NpsiXI1a_RIDq28fxm4tQ&sa=X&ved=2ahUKEwi9pfzK-_KSAxVOe_UHHXz3CLAQ0pQJegQICxAB"
      },
      {
        "title": "Maps",
        "href": "https://maps.google.com/maps?sca_esv=62b03b7345eac9c6&hl=en&output=search&q=pizza&source=lnms&fbs=ADc_l-aN0CWEZBOHjofHoaMMDiKpUrv6YeyJhXfuYqj4Fj6c1Tg5t_ufWNUvD2V-uX26AFmzd3PgOqQPiZGQbkKtfgZKjRVM-fWbSp27mOZd-VNrvsbfJifTcov-iKLq_qwKGsmICHQsDRnG2LrYhoqkYhIypqPFo4FOivgbAwMhEGvaBpiHBPZ7uoGgmnRvbGb63LsPIFEs5NpsiXI1a_RIDq28fxm4tQ&entry=mc&ved=1t:200715&ictx=111"
      },
      {
        "title": "Shopping",
        "href": "https://www.google.com/search?sca_esv=62b03b7345eac9c6&hl=en&udm=28&fbs=ADc_l-aN0CWEZBOHjofHoaMMDiKpUrv6YeyJhXfuYqj4Fj6c1Tg5t_ufWNUvD2V-uX26AFmzd3PgOqQPiZGQbkKtfgZKjRVM-fWbSp27mOZd-VNrvsbfJifTcov-iKLq_qwKGsmICHQsDRnG2LrYhoqkYhIypqPFo4FOivgbAwMhEGvaBpiHBPZ7uoGgmnRvbGb63LsPIFEs5NpsiXI1a_RIDq28fxm4tQ&q=pizza&ved=1t:220175&ictx=111"
      },
      {
        "title": "Videos",
        "href": "https://www.google.com/search?sca_esv=62b03b7345eac9c6&hl=en&udm=7&fbs=ADc_l-aN0CWEZBOHjofHoaMMDiKpUrv6YeyJhXfuYqj4Fj6c1Tg5t_ufWNUvD2V-uX26AFmzd3PgOqQPiZGQbkKtfgZKjRVM-fWbSp27mOZd-VNrvsbfJifTcov-iKLq_qwKGsmICHQsDRnG2LrYhoqkYhIypqPFo4FOivgbAwMhEGvaBpiHBPZ7uoGgmnRvbGb63LsPIFEs5NpsiXI1a_RIDq28fxm4tQ&q=pizza&sa=X&ved=2ahUKEwi9pfzK-_KSAxVOe_UHHXz3CLAQtKgLegQIDxAB"
      },
      {
        "title": "News",
        "href": "https://www.google.com/search?sca_esv=62b03b7345eac9c6&hl=en&q=pizza&tbm=nws&source=lnms&fbs=ADc_l-aN0CWEZBOHjofHoaMMDiKpUrv6YeyJhXfuYqj4Fj6c1Tg5t_ufWNUvD2V-uX26AFmzd3PgOqQPiZGQbkKtfgZKjRVM-fWbSp27mOZd-VNrvsbfJifTcov-iKLq_qwKGsmICHQsDRnG2LrYhoqkYhIypqPFo4FOivgbAwMhEGvaBpiHBPZ7uoGgmnRvbGb63LsPIFEs5NpsiXI1a_RIDq28fxm4tQ&sa=X&ved=2ahUKEwi9pfzK-_KSAxVOe_UHHXz3CLAQ0pQJegQIDhAB"
      }
    ],
    "images": [
      {
        "link": "https://www.tasteofhome.com/recipes/homemade-pizza/",
        "original_image": "https://www.tasteofhome.com/wp-content/uploads/2018/01/Homemade-Pizza_EXPS_FT23_376_EC_120123_3.jpg",
        "title": "Homemade Pizza Recipe: How to Make It",
        "source": "Taste of Home",
        "image": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQABAAD/2w...",
        "image_alt": "Homemade Pizza Recipe: How to Make It",
        "image_base64": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQABAAD/2w...",
        "rank": 1,
        "global_rank": 1
      },
      {
        "link": "https://en.wikipedia.org/wiki/Pizza",
        "original_image": "https://upload.wikimedia.org/wikipedia/commons/9/91/Pizza-3007395.jpg",
        "title": "Pizza - Wikipedia",
        "source": "Wikipedia",
        "image": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQABAAD/2w...",
        "image_alt": "Pizza - Wikipedia",
        "image_base64": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQABAAD/2w...",
        "rank": 2,
        "global_rank": 2
      },
      {
        "link": "https://www.tillamook.com/recipes/salami-red-onion-and-oregano-pizza",
        "original_image": "https://images.ctfassets.net/j8tkpy1gjhi5/5OvVmigx6VIUsyoKz1EHUs/b8173b7dcfbd6da341ce11bcebfa86ea/Salami-pizza-hero.jpg",
        "title": "Red Onion and Oregano Pizza - Tillamook",
        "source": "Tillamook",
        "image": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQABAAD/2w...",
        "image_alt": "Red Onion and Oregano Pizza - Tillamook",
        "image_base64": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQABAAD/2w...",
        "rank": 3,
        "global_rank": 3
      },
      {
        "link": "https://www.sortirambnens.com/es/recetas/que-hacemos-en-casa/cocinar-con-ninos/segundos-platos/la-receta-de-la-pizza-de-pepperoni/",
        "original_image": "https://www.sortirambnens.com/wp-content/uploads/2019/02/pizza-de-peperoni.jpg",
        "title": "LA RECETA DE LA PIZZA DE PEPPERONI ...",
        "source": "Sortir amb nens",
        "image": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQABAAD/2w...",
        "image_alt": "LA RECETA DE LA PIZZA DE PEPPERONI ...",
        "image_base64": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQABAAD/2w...",
        "rank": 4,
        "global_rank": 4
      },
      {
        "link": "https://www.surlatable.com/recipe/perfect-pizza-dough/REC-283110?srsltid=AfmBOoqF1hpSQid6DabYdImjWsYMX5hG3GgUcdnDPSK7X0qP9Wtu-c7y",
        "original_image": "https://assets.surlatable.com/m/15a89c2d9c6c1345/72_dpi_webp-REC-283110_Pizza-jpg",
        "title": "Perfect Pizza Dough | Sur La Table",
        "source": "Sur La table",
        "image": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQABAAD/2w...",
        "image_alt": "Perfect Pizza Dough | Sur La Table",
        "image_base64": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQABAAD/2w...",
        "rank": 5,
        "global_rank": 5
      }
    ],
    "pagination": {
      "next_page_start": 10,
      "next_page_link": "https://www.google.com/search?q=pizza&sca_esv=62b03b7345eac9c6&hl=en&udm=2&ei=0gmeab30Gc721e8P_O6jgAs&start=10&sa=N"
    }
  }
  ```
</ResponseExample>


# Job search
Source: https://docs.brightdata.com/api-reference/serp/google-search/jobs

Configure the Bright Data Google Search Job Search parameter to refine queries and return matching results as JSON or HTML. On port 44445.

```http theme={null}
https://www.google.com/search?q=pizza&ibp=htl%3Bjobs
```

## Parameters

<ParamField type="string">
  The search query parameter. Specifies the keyword or phrase you want to search for on Google.
</ParamField>

<ParamField type="string">
  Use the `ibp` parameter for Jobs search type. i.e. `ibp=htl;jobs`

  ```http theme={null}
  https://www.google.com/search?q=pizza&ibp=htl%3Bjobs
  ```
</ParamField>

<RequestExample>
  ```shell cURL highlight={6} theme={null}
    curl -X POST https://api.brightdata.com/request \
    --header "Content-Type: application/json" \
    --header "Authorization: Bearer API_KEY" \
    --data '{
      "zone": "serp_api1",
      "url": "https://www.google.com/search?q=pizza&ibp=htl%3Bjobs",
      "format": "raw"
    }'
  ```

  ```shell Native proxy highlight={4} theme={null}
  curl --proxy brd.superproxy.io:44445 \
    --proxy-user CUSTOMER_USERNAME:CUSTOMER_PASSWORD \
    --ssl-no-revoke \
    "https://www.google.com/search?q=pizza&ibp=htl%3Bjobs"
  ```

  ```js Node.js highlight={10} theme={null}
  (async () => {
    const response = await fetch('https://api.brightdata.com/request', {
      method: 'POST',
      headers: {
        'Content-Type': 'application/json',
        'Authorization': 'Bearer API_KEY'
      },
      body: JSON.stringify({
        zone: 'serp_api1',
        url: 'https://www.google.com/search?q=pizza&ibp=htl%3Bjobs',
        format: 'raw'
      })
    });
    
    const data = await response.text();
    console.log(data);
  })();
  ```

  ```python Python highlight={11} theme={null}
  import requests

  # API Configuration
  headers = {
      'Content-Type': 'application/json',
      'Authorization': 'Bearer API_KEY',
  }

  payload = {
      'zone': 'serp_api1',
      'url': 'https://www.google.com/search?q=pizza&ibp=htl%3Bjobs',
      'format': 'raw'
  }

  # Make the request
  response = requests.post(
      'https://api.brightdata.com/request', 
      json=payload, 
      headers=headers
  )

  print(response.text)
  ```
</RequestExample>

<ResponseExample>
  ```json 200 highlight={11} theme={null}
  {
    "general": {
      "search_engine": "google",
      "query": "pizza",
      "results_cnt": 0,
      "search_time": 0.31,
      "language": "en",
      "location": "Montgomery County, Texas",
      "mobile": false,
      "basic_view": false,
      "search_type": "jobs",
      "page_title": "pizza - Google Search",
      "timestamp": "2026-02-25T08:43:34.614Z"
    },
    "input": {
      "original_url": "https://www.google.com/search?q=pizza&ibp=htl%3Bjobs&brd_json=1",
      "request_id": "hl_xxxxxxxxxxxxxxx"
    },
    "navigation": [
      {
        "title": "AI Mode",
        "href": "https://www.google.com/search?q=pizza&sca_esv=206cd4dd954885db&gl=US&hl=en&udm=50&fbs=ADc_l-aN0CWEZBOHjofHoaMMDiKpUrv6YeyJhXfuYqj4Fj6c1Tg5t_ufWNUvD2V-uX26AFlqeVA_8cCiKkQH-MFQemrtPKh5DXjDm8xDum7A4wYDWFbKVVilxndHi5Wmmk7zyv03Mys_YyBP4ugQ98ij9I0KKsP0Cu165bWlMKbYdlbOsIY961jqcRx3YqPBajY3XBKmZnjo68pJ_p3Acf3Ma5IASVQq8A&aep=1&ntc=1&sa=X&ved=2ahUKEwiWusv4n_SSAxWR4skDHfyGN7UQ2J8OegQICxAD"
      },
      {
        "title": "All",
        "href": "https://www.google.com/search?sca_esv=206cd4dd954885db&gl=US&hl=en&q=pizza&source=lnms&fbs=ADc_l-aN0CWEZBOHjofHoaMMDiKpUrv6YeyJhXfuYqj4Fj6c1Tg5t_ufWNUvD2V-uX26AFlqeVA_8cCiKkQH-MFQemrtPKh5DXjDm8xDum7A4wYDWFbKVVilxndHi5Wmmk7zyv03Mys_YyBP4ugQ98ij9I0KKsP0Cu165bWlMKbYdlbOsIY961jqcRx3YqPBajY3XBKmZnjo68pJ_p3Acf3Ma5IASVQq8A&sa=X&ved=2ahUKEwiWusv4n_SSAxWR4skDHfyGN7UQ0pQJegQIDBAB"
      },
      {
        "title": "Maps",
        "href": "https://maps.google.com/maps?sca_esv=206cd4dd954885db&gl=US&hl=en&output=search&q=pizza&source=lnms&fbs=ADc_l-aN0CWEZBOHjofHoaMMDiKpUrv6YeyJhXfuYqj4Fj6c1Tg5t_ufWNUvD2V-uX26AFlqeVA_8cCiKkQH-MFQemrtPKh5DXjDm8xDum7A4wYDWFbKVVilxndHi5Wmmk7zyv03Mys_YyBP4ugQ98ij9I0KKsP0Cu165bWlMKbYdlbOsIY961jqcRx3YqPBajY3XBKmZnjo68pJ_p3Acf3Ma5IASVQq8A&entry=mc&ved=1t:200715&ictx=111"
      },
      {
        "title": "Images",
        "href": "https://www.google.com/search?sca_esv=206cd4dd954885db&gl=US&hl=en&udm=2&fbs=ADc_l-aN0CWEZBOHjofHoaMMDiKpUrv6YeyJhXfuYqj4Fj6c1Tg5t_ufWNUvD2V-uX26AFlqeVA_8cCiKkQH-MFQemrtPKh5DXjDm8xDum7A4wYDWFbKVVilxndHi5Wmmk7zyv03Mys_YyBP4ugQ98ij9I0KKsP0Cu165bWlMKbYdlbOsIY961jqcRx3YqPBajY3XBKmZnjo68pJ_p3Acf3Ma5IASVQq8A&q=pizza&sa=X&ved=2ahUKEwiWusv4n_SSAxWR4skDHfyGN7UQtKgLegQIDxAB"
      },
      {
        "title": "Shopping",
        "href": "https://www.google.com/search?sca_esv=206cd4dd954885db&gl=US&hl=en&udm=28&fbs=ADc_l-aN0CWEZBOHjofHoaMMDiKpUrv6YeyJhXfuYqj4Fj6c1Tg5t_ufWNUvD2V-uX26AFlqeVA_8cCiKkQH-MFQemrtPKh5DXjDm8xDum7A4wYDWFbKVVilxndHi5Wmmk7zyv03Mys_YyBP4ugQ98ij9I0KKsP0Cu165bWlMKbYdlbOsIY961jqcRx3YqPBajY3XBKmZnjo68pJ_p3Acf3Ma5IASVQq8A&q=pizza&ved=1t:220175&ictx=111"
      },
      {
        "title": "News",
        "href": "https://www.google.com/search?sca_esv=206cd4dd954885db&gl=US&hl=en&q=pizza&tbm=nws&source=lnms&fbs=ADc_l-aN0CWEZBOHjofHoaMMDiKpUrv6YeyJhXfuYqj4Fj6c1Tg5t_ufWNUvD2V-uX26AFlqeVA_8cCiKkQH-MFQemrtPKh5DXjDm8xDum7A4wYDWFbKVVilxndHi5Wmmk7zyv03Mys_YyBP4ugQ98ij9I0KKsP0Cu165bWlMKbYdlbOsIY961jqcRx3YqPBajY3XBKmZnjo68pJ_p3Acf3Ma5IASVQq8A&sa=X&ved=2ahUKEwiWusv4n_SSAxWR4skDHfyGN7UQ0pQJegQIERAB"
      },
      {
        "title": "Videos",
        "href": "https://www.google.com/search?sca_esv=206cd4dd954885db&gl=US&hl=en&udm=7&fbs=ADc_l-aN0CWEZBOHjofHoaMMDiKpUrv6YeyJhXfuYqj4Fj6c1Tg5t_ufWNUvD2V-uX26AFlqeVA_8cCiKkQH-MFQemrtPKh5DXjDm8xDum7A4wYDWFbKVVilxndHi5Wmmk7zyv03Mys_YyBP4ugQ98ij9I0KKsP0Cu165bWlMKbYdlbOsIY961jqcRx3YqPBajY3XBKmZnjo68pJ_p3Acf3Ma5IASVQq8A&q=pizza&sa=X&ved=2ahUKEwiWusv4n_SSAxWR4skDHfyGN7UQtKgLegQIJxAB"
      },
      {
        "title": "Forums",
        "href": "https://www.google.com/search?sca_esv=206cd4dd954885db&gl=US&hl=en&udm=18&fbs=ADc_l-aN0CWEZBOHjofHoaMMDiKpUrv6YeyJhXfuYqj4Fj6c1Tg5t_ufWNUvD2V-uX26AFlqeVA_8cCiKkQH-MFQemrtPKh5DXjDm8xDum7A4wYDWFbKVVilxndHi5Wmmk7zyv03Mys_YyBP4ugQ98ij9I0KKsP0Cu165bWlMKbYdlbOsIY961jqcRx3YqPBajY3XBKmZnjo68pJ_p3Acf3Ma5IASVQq8A&q=pizza&sa=X&ved=2ahUKEwiWusv4n_SSAxWR4skDHfyGN7UQs6gLegQIJRAB"
      },
      {
        "title": "Short videos",
        "href": "https://www.google.com/search?sca_esv=206cd4dd954885db&gl=US&hl=en&udm=39&fbs=ADc_l-aN0CWEZBOHjofHoaMMDiKpUrv6YeyJhXfuYqj4Fj6c1Tg5t_ufWNUvD2V-uX26AFlqeVA_8cCiKkQH-MFQemrtPKh5DXjDm8xDum7A4wYDWFbKVVilxndHi5Wmmk7zyv03Mys_YyBP4ugQ98ij9I0KKsP0Cu165bWlMKbYdlbOsIY961jqcRx3YqPBajY3XBKmZnjo68pJ_p3Acf3Ma5IASVQq8A&q=pizza&sa=X&ved=2ahUKEwiWusv4n_SSAxWR4skDHfyGN7UQs6gLegQIKBAB"
      },
      {
        "title": "Web",
        "href": "https://www.google.com/search?sca_esv=206cd4dd954885db&gl=US&hl=en&udm=web&fbs=ADc_l-aN0CWEZBOHjofHoaMMDiKpUrv6YeyJhXfuYqj4Fj6c1Tg5t_ufWNUvD2V-uX26AFlqeVA_8cCiKkQH-MFQemrtPKh5DXjDm8xDum7A4wYDWFbKVVilxndHi5Wmmk7zyv03Mys_YyBP4ugQ98ij9I0KKsP0Cu165bWlMKbYdlbOsIY961jqcRx3YqPBajY3XBKmZnjo68pJ_p3Acf3Ma5IASVQq8A&q=pizza&sa=X&ved=2ahUKEwiWusv4n_SSAxWR4skDHfyGN7UQs6gLegQIJhAB"
      },
      {
        "title": "Remote",
        "href": "https://www.google.com/search?sca_esv=206cd4dd954885db&gl=US&hl=en&q=pizza+remote&uds=ALYpb_ncDc7jTlmw6Mmq7NjuX5c-YV-lRKgxbXFUKPzYPZyKeILNvm73fF0fEZBdNGAU-CIo-G2v151xiOXgGNzzbT8u0ut-v67slmYRTRP9OMBvE6aLADbcd5B0FzMBs3wPbXiTQ9cGYyEEe3yA_qDdNJCOx4BWAA&udm=8&sa=X&ved=2ahUKEwiWusv4n_SSAxWR4skDHfyGN7UQxKsJKAB6BAgSEAE&ictx=0"
      },
      {
        "title": "No degree",
        "href": "https://www.google.com/search?sca_esv=206cd4dd954885db&gl=US&hl=en&q=pizza+no+degree&uds=ALYpb_ncDc7jTlmw6Mmq7NjuX5c-T4emPHvteFlrAH19mCmukosX52MC87I2751Bq-nSNFe7KZu5GoL88oPZl2yYAEhJ5Ut6RNtgvVIk39OnIMwpuh_fG1KeQuQxDw35P9FvGPNubTFpsIhiLd_WkNV_t83o5qdj4CrIjGYdMFylvoWcqY5aT_Q&udm=8&sa=X&ved=2ahUKEwiWusv4n_SSAxWR4skDHfyGN7UQxKsJKAF6BAgUEAE&ictx=0"
      },
      {
        "title": "Remote",
        "href": "https://www.google.com/search?sca_esv=206cd4dd954885db&gl=US&hl=en&q=pizza+remote&uds=ALYpb_ncDc7jTlmw6Mmq7NjuX5c-YV-lRKgxbXFUKPzYPZyKeILNvm73fF0fEZBdNGAU-CIo-G2v151xiOXgGNzzbT8u0ut-v67slmYRTRP9OMBvE6aLADbcd5B0FzMBs3wPbXiTQ9cGYyEEe3yA_qDdNJCOx4BWAA&udm=8&sa=X&ved=2ahUKEwiWusv4n_SSAxWR4skDHfyGN7UQxKsJKAJ6BAgWEAE&ictx=0"
      },
      {
        "title": "No degree",
        "href": "https://www.google.com/search?sca_esv=206cd4dd954885db&gl=US&hl=en&q=pizza+no+degree&uds=ALYpb_ncDc7jTlmw6Mmq7NjuX5c-T4emPHvteFlrAH19mCmukosX52MC87I2751Bq-nSNFe7KZu5GoL88oPZl2yYAEhJ5Ut6RNtgvVIk39OnIMwpuh_fG1KeQuQxDw35P9FvGPNubTFpsIhiLd_WkNV_t83o5qdj4CrIjGYdMFylvoWcqY5aT_Q&udm=8&sa=X&ved=2ahUKEwiWusv4n_SSAxWR4skDHfyGN7UQxKsJKAN6BAgTEAE&ictx=0"
      }
    ],
    "jobs": {
      "items": [
        {
          "title": "Cook",
          "company": "Pizza Hut",
          "location": "Splendora, TX",
          "source": "via Pizza Hut",
          "link": "https://www.google.com/search?ibp=htl;jobs&q=pizza&htidocid=6_16nT4f27lf3OouAAAAAA%3D%3D&hl=en-US&shem=epsd1&shndl=37&shmd=H4sIAAAAAAAA_xXEsQrCMBAA0L2fUJebRRMRXHR0UJwEHdzKJR5JasyF3CmlXy--4XXfbnFkfsEaLuxACJuPwAVOzCFTf4iqVfbWimQTRFGTN57flgs5nuzITv4NErFRzag0bHebydQSlv01zTPC-aOQCtxqpvLkhiu4P36bVsuPeAAAAA&shmds=v1_ATWGeeNVkvz2LAq4sD_AMOtS0LznF37q0WDx9Hcs2z8KYOPDOQ&source=sh/x/job/li/m1/1#fpstate=tldetail&htivrt=jobs&htiq=pizza&htidocid=6_16nT4f27lf3OouAAAAAA%3D%3D",
          "postings": [
            {
              "link": "https://jobs.pizzahut.com/job/cook/splendora-TX/9ed4898e-f0bc-4748-83c7-a5f700204a97-s1/?utm_campaign=google_jobs_apply&utm_source=google_jobs_apply&utm_medium=organic",
              "source": "Pizza Hut"
            },
            {
              "link": "https://www.indeed.com/viewjob?jk=ecd1a619eee2659b&utm_campaign=google_jobs_apply&utm_source=google_jobs_apply&utm_medium=organic",
              "site": "indeed.com",
              "source": "Indeed"
            },
            {
              "link": "https://careers.sonicdrivein.com/cook/job/01789E60CB4B75CC3271CD641023DC6D?utm_campaign=google_jobs_apply&utm_source=google_jobs_apply&utm_medium=organic",
              "site": "sonicdrivein.com",
              "source": "Sonic Careers"
            },
            {
              "link": "https://www.breakroom.cc/en-us/jobs/listing/2967571-sonic-drive-in-cook-14685-us-59-splendora-texas-77372-united?utm_campaign=google_jobs_apply&utm_source=google_jobs_apply&utm_medium=organic",
              "site": "breakroom.cc",
              "source": "Breakroom"
            },
            {
              "link": "https://www.simplyhired.com/job/g_EzjTnQ7_MlIl5f1_sMb0Q7lqcWzZth-2Po_Xgbx0waxxOq5RQ1-Q?utm_campaign=google_jobs_apply&utm_source=google_jobs_apply&utm_medium=organic",
              "site": "simplyhired.com",
              "source": "SimplyHired"
            },
            {
              "link": "https://earnbetter.com/app/job/01K1YHEFHJCCV87HTJ0BVTSBQN/?utm_campaign=google_jobs_apply&utm_source=google_jobs_apply&utm_medium=organic",
              "site": "earnbetter.com",
              "source": "EarnBetter"
            },
            {
              "link": "https://us.bebee.com/job/fbf20584e76c867fed8c9a86abc0838a?utm_campaign=google_jobs_apply&utm_source=google_jobs_apply&utm_medium=organic",
              "site": "bebee.com",
              "source": "BeBee"
            },
            {
              "link": "https://www.learn4good.com/jobs/texas/restaurant_and_food_service/4885221513/e/?utm_campaign=google_jobs_apply&utm_source=google_jobs_apply&utm_medium=organic",
              "site": "learn4good.com",
              "source": "Learn4Good"
            }
          ],
          "original_image": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcRwnb5TyY9xtYb1GAz0Dl7oSudGQ00CkPqAgHOr&s=0",
          "date": "2 days ago",
          "employment_type": "Full-time",
          "description": "Under daily supervision of the General Manager, the position of the Cook/Dishwasher is responsible for preparing all food items in an expedient manner to specifications; and cleaning dishes, pots. pans, and public areas of the building. He/she is also responsible for keeping the floor dry and free of debris.\n\nEssential Functions:\n1. Prepare: food in accordance lo specifications.\n\n2. Keep station. stocked before, during and after shifts.\n\n3. Set up stations\n\n4. Keep floors at work area free of debris and spills.\n\nS. Maintain cleanliness in the work station.\n\n6. Wash dishes and take trash out to the dumpster.\n\n7. Prep dough and other products for upcoming shifts.\n\nRequirements\n\nPhysical Requirements:\nl. Have constant need (66%- 100% of time) to stand without the benefit of support while cooking and cleaning.\n\n2. Haw frequent need (33%-66% of time) to walk around the kitchen.\n\n3. Have frequent need (33%-66% of time) to bend/stop/squat while taking items off bottom shelves;\ncleaning floors and walls; and lading shelves.\n\n4. Have frequent need (33%-66t% of time) to push and pull equipment while performing cleaning duties.\n\n5. Have frequent need (33%-66% of time) to reach above shoulders when reaching for items stored above\nthe shoulder level and while changing light bulbs.\n\n6. Have frequent need (33%-66% of time) to grasp/grip glasses, serving plates, trays, and utensils; and while\npreparing food.\n\n7. Have frequent need (33%-66% of time) for finger dexterity for such things as writing, gripping, cleaning,\nand turning off and on lights.\n\n8. Have occasional need (1%\n• 33% of time) to operate dishwasher.\n\n9. Have occasional need (1%- 33% of time) to lift/carry object weighing between 75 and 51 pounds and\nfrequent need (33%- 66% of time) to handle objects weighing 50 pounds or less.\n\nVision Requirements:\nl . Rave frequent need (33%-66% of time) to be able to see detail while cooking and preparing food; and\nwhile cleaning dishes.\n\nl. Have constant Need (66%-100% of time) to be able to see beyond arms length in order to see personnel\nand cleaning area.\n\nHearing Requirements:\n1. Have constant need (66%\n• 100% of time) to be able to hear other personnel in order to communicate\neffectively.\n\nSpeaking Requirements:\nl. Have constant need (66%-100% of time) to be able to speak with other personnel in order to\ncommunicate effectively.",
          "highlights": [
            {
              "name": "Qualifications",
              "list": [
                "Have constant need (66%- 100% of time) to stand without the benefit of support while cooking and cleaning",
                "Have occasional need (1%",
                "frequent need (33%- 66% of time) to handle objects weighing 50 pounds or less",
                "Rave frequent need (33%-66% of time) to be able to see detail while cooking and preparing food; and",
                "Have constant Need (66%-100% of time) to be able to see beyond arms length in order to see personnel",
                "Have constant need (66%",
                "100% of time) to be able to hear other personnel in order to communicate",
                "Have constant need (66%-100% of time) to be able to speak with other personnel in order to",
                "communicate effectively"
              ]
            },
            {
              "name": "Benefits",
              "list": [
                "Set up stations"
              ]
            },
            {
              "name": "Responsibilities",
              "list": [
                "Under daily supervision of the General Manager, the position of the Cook/Dishwasher is responsible for preparing all food items in an expedient manner to specifications; and cleaning dishes, pots",
                "pans, and public areas of the building",
                "He/she is also responsible for keeping the floor dry and free of debris",
                "Prepare: food in accordance lo specifications",
                "Keep station",
                "stocked before, during and after shifts",
                "Keep floors at work area free of debris and spills",
                "Maintain cleanliness in the work station",
                "Wash dishes and take trash out to the dumpster",
                "Prep dough and other products for upcoming shifts",
                "Haw frequent need (33%-66% of time) to walk around the kitchen",
                "Have frequent need (33%-66% of time) to bend/stop/squat while taking items off bottom shelves;",
                "cleaning floors and walls; and lading shelves",
                "Have frequent need (33%-66t% of time) to push and pull equipment while performing cleaning duties",
                "Have frequent need (33%-66% of time) to reach above shoulders when reaching for items stored above",
                "the shoulder level and while changing light bulbs",
                "Have frequent need (33%-66% of time) to grasp/grip glasses, serving plates, trays, and utensils; and while",
                "preparing food",
                "Have frequent need (33%-66% of time) for finger dexterity for such things as writing, gripping, cleaning,",
                "and turning off and on lights",
                "33% of time) to operate dishwasher",
                "Have occasional need (1%- 33% of time) to lift/carry object weighing between 75 and 51 pounds and"
              ]
            }
          ],
          "tags": [
            {
              "name": "Posted",
              "value": "2 days ago"
            },
            {
              "name": "Employment Type",
              "value": "Full-time"
            },
            {
              "name": "Qualification",
              "value": "No degree mentioned"
            }
          ],
          "rank": 1,
          "global_rank": 1
        },
        {
          "title": "Pizza Crew Member",
          "company": "Marco's Pizza",
          "location": "Spring, TX",
          "source": "via Indeed",
          "link": "https://www.google.com/search?ibp=htl;jobs&q=pizza&htidocid=iaF8mrghlWO4rIUZAAAAAA%3D%3D&hl=en-US&shem=epsd1&shndl=37&shmd=H4sIAAAAAAAA_yXNsQrCMBCAYVz7CLrcpogmIrjU0UEQCoIObiUJRxJJc-EuYOnsg6u4_OP3N-9Zs7rGaTJwYnxBh4NFhi1cyIKgYReAMpyJfML5MdRapNVaJCkv1dTolKNBU0ZLo36SlV96CYaxJFOx3x92oyrZrxfdV6OlwH8XM9wKx-w3cH98AOUDRe6HAAAA&shmds=v1_ATWGeePt9xuCWrUfWX5IQQKOF5SjzMvMdpiQrvexRSN54JOBfg&source=sh/x/job/li/m1/1#fpstate=tldetail&htivrt=jobs&htiq=pizza&htidocid=iaF8mrghlWO4rIUZAAAAAA%3D%3D",
          "postings": [
            {
              "link": "https://www.indeed.com/viewjob?jk=d900ec075453de28&utm_campaign=google_jobs_apply&utm_source=google_jobs_apply&utm_medium=organic",
              "source": "Indeed"
            },
            {
              "link": "https://www.ziprecruiter.com/c/Marcos-Pizza/Job/Pizza-Crew-Member/-in-Spring,TX?jid=1368cf35ed2a0cef&utm_campaign=google_jobs_apply&utm_source=google_jobs_apply&utm_medium=organic",
              "site": "ziprecruiter.com",
              "source": "ZipRecruiter"
            },
            {
              "link": "https://www.glassdoor.com/job-listing/pizza-crew-member-marco-s-pizza-JV_IC1140222_KO0,17_KE18,31.htm?jl=1009785317988&utm_campaign=google_jobs_apply&utm_source=google_jobs_apply&utm_medium=organic",
              "site": "glassdoor.com",
              "source": "Glassdoor"
            },
            {
              "link": "https://www.snagajob.com/jobs/831020036?utm_campaign=google_jobs_apply&utm_source=google_jobs_apply&utm_medium=organic",
              "site": "snagajob.com",
              "source": "Snagajob"
            },
            {
              "link": "https://www.simplyhired.com/job/aOMTcyJItD5qv5C3tmyq-Nlf19s0LADGFB387R6o4Oj8KF44Y5WkGA?utm_campaign=google_jobs_apply&utm_source=google_jobs_apply&utm_medium=organic",
              "site": "simplyhired.com",
              "source": "SimplyHired"
            },
            {
              "link": "https://www.career.com/job/sizemore-organization/pizza-crew-member/j202211141724175481797?utm_campaign=google_jobs_apply&utm_source=google_jobs_apply&utm_medium=organic",
              "site": "career.com",
              "source": "Career.com"
            },
            {
              "link": "https://www.learn4good.com/jobs/spring/texas/restaurant_and_food_service/4848557952/e/?utm_campaign=google_jobs_apply&utm_source=google_jobs_apply&utm_medium=organic",
              "site": "learn4good.com",
              "source": "Learn4Good"
            }
          ],
          "original_image": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcSyN2IgTP8Y9A9OPucp18Spzc6bketz_KYnU8SS&s=0",
          "employment_type": "Part-time",
          "description": "Positions inside the store include:\n\nPizza Maker: In a recent poll customers stated the top three reasons they love Marco’s is quality, great taste, and great pizza. Trained by the best, you could be slapping dough and joining the best pizza makers in the business in no time. As a pizza maker you will learn how to make and stretch fresh dough, generously sauce and cheese each pizza, and add only the best, freshest possible ingredients to your great pizzas.\n\nCut Table: A key position in all Marco’s stores, the cut table keeps the whole pizza process moving with the crew counting on you. You’ll be the one to take pizzas from the oven to the cut table, slice and box them, and make sure each order gets it’s important sides and salads.\n\nCounter: As the first impression of Marco’s to walk-in and phone customers, excellent customer service delivered with a smiling attitude is key for the counter position.\n\nPrep: Because Marco’s offers only the freshest, best ingredients, we need prep employees who take pride in setting up the whole system for success. You will be trained on best practices for making fresh dough, slicing fresh, crispy veggies, and the most efficient way to stock product. Prep work sets up the store to handle “the rush” which is crucial.\n\nWhether you are looking for part-time add a little money to the budget job, or to start a career, apply now and see if you and Marco’s are a good match.\n\nThriving in fast-paced “rush” periods with an attitude of accountability are great qualities to have on at Marco’s, whether you are interested in part-time work or a career. Apply now and find out if you and Marco’s are a good match.\n\nBrand: Marco's Pizza\nAddress: 21630 Kuykendahl Rd. Suite 430 Spring, TX - 77388\nProperty Description: 1-21630 Kuykendahl Rd. Spring, TX\nProperty Number: 5136",
          "highlights": [
            {
              "name": "Qualifications",
              "list": [
                "Trained by the best, you could be slapping dough and joining the best pizza makers in the business in no time",
                "As a pizza maker you will learn how to make and stretch fresh dough, generously sauce and cheese each pizza, and add only the best, freshest possible ingredients to your great pizzas",
                "Thriving in fast-paced “rush” periods with an attitude of accountability are great qualities to have on at Marco’s, whether you are interested in part-time work or a career"
              ]
            },
            {
              "name": "Benefits"
            },
            {
              "name": "Responsibilities",
              "list": [
                "Cut Table: A key position in all Marco’s stores, the cut table keeps the whole pizza process moving with the crew counting on you",
                "You’ll be the one to take pizzas from the oven to the cut table, slice and box them, and make sure each order gets it’s important sides and salads",
                "Counter: As the first impression of Marco’s to walk-in and phone customers, excellent customer service delivered with a smiling attitude is key for the counter position",
                "You will be trained on best practices for making fresh dough, slicing fresh, crispy veggies, and the most efficient way to stock product",
                "Prep work sets up the store to handle “the rush” which is crucial"
              ]
            }
          ],
          "tags": [
            {
              "name": "Employment Type",
              "value": "Part-time"
            },
            {
              "name": "Qualification",
              "value": "No degree mentioned"
            }
          ],
          "rank": 2,
          "global_rank": 2
        },
        {
          "title": "Driver",
          "company": "Pizza Hut",
          "location": "Conroe, TX",
          "source": "via Pizza Hut",
          "link": "https://www.google.com/search?ibp=htl;jobs&q=pizza&htidocid=41Pgt-dTdcKNgdXaAAAAAA%3D%3D&hl=en-US&shem=epsd1&shndl=37&shmd=H4sIAAAAAAAA_xXEsQrCMBAA0L0_IAjCzWITEVx0VKg4OTi4lSQcSSTehdxVSr9efMPrpm5zbfmLDXq4swdB10ICJhiYY8H1OalWOVkrUkwUdZqDCfyxTOh5tm_28m-U5BrW4hTHw3E_m0pxu3rkZXFwmxQywYWpMe7g-foBKmxJ6XcAAAA&shmds=v1_ATWGeeOr095xwTHlZaGNHK27qHwwOzKgkq09Mk3fjAidMqci9g&source=sh/x/job/li/m1/1#fpstate=tldetail&htivrt=jobs&htiq=pizza&htidocid=41Pgt-dTdcKNgdXaAAAAAA%3D%3D",
          "postings": [
            {
              "link": "https://jobs.pizzahut.com/job/driver/conroe-TX/a27d3d1a-d936-4723-af1d-a5ee00cd45f6-s1/?utm_campaign=google_jobs_apply&utm_source=google_jobs_apply&utm_medium=organic",
              "source": "Pizza Hut"
            },
            {
              "link": "https://www.indeed.com/viewjob?jk=65df9c4c0181032a&utm_campaign=google_jobs_apply&utm_source=google_jobs_apply&utm_medium=organic",
              "site": "indeed.com",
              "source": "Indeed"
            },
            {
              "link": "https://careers.staffing-texas.com/jb/Driver-Jobs-in-Conroe-TX/13689519?utm_campaign=google_jobs_apply&utm_source=google_jobs_apply&utm_medium=organic",
              "site": "staffing-texas.com",
              "source": "Staffing Texas, LLC"
            },
            {
              "link": "https://www.ziprecruiter.com/c/Four-PZ-Pizza,-Inc./Job/Driver/-in-Conroe,TX?jid=962e2c563fcb65ab&utm_campaign=google_jobs_apply&utm_source=google_jobs_apply&utm_medium=organic",
              "site": "ziprecruiter.com",
              "source": "ZipRecruiter"
            },
            {
              "link": "https://www.glassdoor.com/job-listing/driver-frontier-waste-solutions-JV_IC1140144_KO0,6_KE7,31.htm?jl=1010020427521&utm_campaign=google_jobs_apply&utm_source=google_jobs_apply&utm_medium=organic",
              "site": "glassdoor.com",
              "source": "Glassdoor"
            },
            {
              "link": "https://www.simplyhired.com/job/EFVGrw1yWYOKztBggb46CEoX5y1AYN5EICu-J4t8bUqr6MLANZ6icQ?utm_campaign=google_jobs_apply&utm_source=google_jobs_apply&utm_medium=organic",
              "site": "simplyhired.com",
              "source": "SimplyHired"
            },
            {
              "link": "https://hertzrentacar.betterteam.com/driver-%2837692%29?utm_campaign=google_jobs_apply&utm_source=google_jobs_apply&utm_medium=organic",
              "site": "betterteam.com",
              "source": "Hertz Careers"
            },
            {
              "link": "https://us.bebee.com/job/2dac24fce7790f56df6017b7ba9782f6?utm_campaign=google_jobs_apply&utm_source=google_jobs_apply&utm_medium=organic",
              "site": "bebee.com",
              "source": "BeBee"
            }
          ],
          "original_image": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcRwnb5TyY9xtYb1GAz0Dl7oSudGQ00CkPqAgHOr&s=0",
          "date": "12 days ago",
          "employment_type": "Full-time",
          "description": "Job Brief:\nUnder daily supervision of the Manager: To be hired as a Pizza Hut delivery driver in Texas, you must be at least 18 years old, have a valid driver's license, and possess a clean driving record with at least two years of driving experience. You also need a reliable vehicle, proof of insurance (where you are a listed driver), a keen sense of direction, and a friendly attitude, the position of the Driver is responsible for the safe and prompt delivery of pizzas to customers in their homes or business, must follow all traffic laws (DO NOT SPEED). He/she is also responsible for assisting in pizza preparation and clean up and taking phone orders.\n\nEssential Functions:\n1. Deliver pizza to customer and collect monies.\n\n2. Take phone orders.\n\n3. Prepare pizzas.\n\n4. Perform closing duties involving cleaning duties, e.g. washing dishes.\n\n5. Empty trash end clean the parking lot.",
          "highlights": [
            {
              "name": "Qualifications",
              "list": [
                "Under daily supervision of the Manager: To be hired as a Pizza Hut delivery driver in Texas, you must be at least 18 years old, have a valid driver's license, and possess a clean driving record with at least two years of driving experience",
                "You also need a reliable vehicle, proof of insurance (where you are a listed driver), a keen sense of direction, and a friendly attitude, the position of the Driver is responsible for the safe and prompt delivery of pizzas to customers in their homes or business, must follow all traffic laws (DO NOT SPEED)"
              ]
            },
            {
              "name": "Benefits"
            },
            {
              "name": "Responsibilities",
              "list": [
                "He/she is also responsible for assisting in pizza preparation and clean up and taking phone orders",
                "Deliver pizza to customer and collect monies",
                "Take phone orders",
                "Prepare pizzas",
                "Perform closing duties involving cleaning duties, e.g. washing dishes",
                "Empty trash end clean the parking lot"
              ]
            }
          ],
          "tags": [
            {
              "name": "Posted",
              "value": "12 days ago"
            },
            {
              "name": "Employment Type",
              "value": "Full-time"
            },
            {
              "name": "Qualification",
              "value": "No degree mentioned"
            }
          ],
          "rank": 3,
          "global_rank": 3
        }
      ]
    }
  }
  ```
</ResponseExample>


# Google Search localization
Source: https://docs.brightdata.com/api-reference/serp/google-search/localization

Configure the Bright Data Google Search Google Search localization parameter to refine queries and return matching results as JSON or HTML. On port 44445.

```http theme={null}
https://www.google.com/search?q=pizza&gl=fr&hl=fr
```

## Parameters

<ParamField type="string">
  The search query parameter. Specifies the keyword or phrase you want to search for on Google.
</ParamField>

<ParamField type="string">
  Two-letter country code used to define the country of search

  ```http theme={null}
  https://www.google.com/search?q=pizza&gl=fr
  ```
</ParamField>

<ParamField type="string">
  Two-letter language code used to define the page languages

  ```http theme={null}
  https://www.google.com/search?q=pizza&hl=fr
  ```
</ParamField>

<RequestExample>
  ```shell cURL highlight={6} theme={null}
    curl -X POST https://api.brightdata.com/request \
    --header "Content-Type: application/json" \
    --header "Authorization: Bearer API_KEY" \
    --data '{
      "zone": "serp_api1",
      "url": "https://www.google.com/search?q=pizza&gl=fr&hl=fr",
      "format": "raw"
    }'
  ```

  ```shell Native proxy highlight={4} theme={null}
  curl --proxy brd.superproxy.io:44445 \
    --proxy-user CUSTOMER_USERNAME:CUSTOMER_PASSWORD \
    --ssl-no-revoke \
    "https://www.google.com/search?q=pizza&gl=fr&hl=fr"
  ```

  ```js Node.js highlight={10} theme={null}
  (async () => {
    const response = await fetch('https://api.brightdata.com/request', {
      method: 'POST',
      headers: {
        'Content-Type': 'application/json',
        'Authorization': 'Bearer API_KEY'
      },
      body: JSON.stringify({
        zone: 'serp_api1',
        url: 'https://www.google.com/search?q=pizza&gl=fr&hl=fr',
        format: 'raw'
      })
    });
    
    const data = await response.text();
    console.log(data);
  })();
  ```

  ```python Python highlight={11} theme={null}
  import requests

  # API Configuration
  headers = {
      'Content-Type': 'application/json',
      'Authorization': 'Bearer API_KEY',
  }

  payload = {
      'zone': 'serp_api1',
      'url': 'https://www.google.com/search?q=pizza&gl=fr&hl=fr',
      'format': 'raw'
  }

  # Make the request
  response = requests.post(
      'https://api.brightdata.com/request', 
      json=payload, 
      headers=headers
  )

  print(response.text)
  ```
</RequestExample>

<ResponseExample>
  ```json 200 highlight={7, 8} theme={null}
  {
    "general": {
      "search_engine": "google",
      "query": "pizza",
      "results_cnt": 973000000,
      "search_time": 0.41,
      "language": "fr",
      "country": "France",
      "country_code": "FR",
      "location": "France",
      "gl": "FR",
      "mobile": false,
      "basic_view": false,
      "search_type": "text",
      "page_title": "pizza - Recherche Google",
      "timestamp": "2026-02-24T20:23:18.752Z"
    },
    "input": {
      "original_url": "https://www.google.com/search?q=pizza&brd_json=1&gl=fr&hl=fr",
      "request_id": "hl_xxxxxxxxxxxxxxx"
    },
    "navigation": [
      {
        "title": "Images",
        "href": "https://www.google.com/search?sca_esv=62b03b7345eac9c6&gl=fr&hl=fr&udm=2&fbs=ADc_l-bpk8W4E-qsVlOvbGJcDwpnHC5OJXXTJvmMu2n9YYx-G8xzgQk24aW1N_FyIND5zVDd4bb14119C8nZHL5l4Fe3xClku41MXRAvxO93q4ubY1l9Hk1FiCr1bfzSXqh4O7o8B1sqrSvZ-w516qcDYmxC9v7HcBaL83oJPMyLdm5H5rNhNEUKI9qKs2vP6Ws5dn2NWKQ4EexSa_t63AI4j321NjMYlQ&q=pizza&sa=X&ved=2ahUKEwjxws_C-vKSAxV_jpUCHW6uFOIQtKgLegQIFhAB"
      },
      {
        "title": "Vidéos",
        "href": "https://www.google.com/search?sca_esv=62b03b7345eac9c6&gl=fr&hl=fr&udm=7&fbs=ADc_l-bpk8W4E-qsVlOvbGJcDwpnHC5OJXXTJvmMu2n9YYx-G8xzgQk24aW1N_FyIND5zVDd4bb14119C8nZHL5l4Fe3xClku41MXRAvxO93q4ubY1l9Hk1FiCr1bfzSXqh4O7o8B1sqrSvZ-w516qcDYmxC9v7HcBaL83oJPMyLdm5H5rNhNEUKI9qKs2vP6Ws5dn2NWKQ4EexSa_t63AI4j321NjMYlQ&q=pizza&sa=X&ved=2ahUKEwjxws_C-vKSAxV_jpUCHW6uFOIQtKgLegQIGBAB"
      },
      {
        "title": "Vidéos courtes",
        "href": "https://www.google.com/search?sca_esv=62b03b7345eac9c6&gl=fr&hl=fr&udm=39&fbs=ADc_l-bpk8W4E-qsVlOvbGJcDwpnHC5OJXXTJvmMu2n9YYx-G8xzgQk24aW1N_FyIND5zVDd4bb14119C8nZHL5l4Fe3xClku41MXRAvxO93q4ubY1l9Hk1FiCr1bfzSXqh4O7o8B1sqrSvZ-w516qcDYmxC9v7HcBaL83oJPMyLdm5H5rNhNEUKI9qKs2vP6Ws5dn2NWKQ4EexSa_t63AI4j321NjMYlQ&q=pizza&sa=X&ved=2ahUKEwjxws_C-vKSAxV_jpUCHW6uFOIQs6gLegQIERAB"
      },
      {
        "title": "Lieux",
        "href": "https://www.google.com/search?sca_esv=62b03b7345eac9c6&gl=fr&hl=fr&udm=1&lsack=tAieafGYHf-c1sQP7tzSkA4&fbs=ADc_l-bpk8W4E-qsVlOvbGJcDwpnHC5OJXXTJvmMu2n9YYx-G8xzgQk24aW1N_FyIND5zVDd4bb14119C8nZHL5l4Fe3xClku41MXRAvxO93q4ubY1l9Hk1FiCr1bfzSXqh4O7o8B1sqrSvZ-w516qcDYmxC9v7HcBaL83oJPMyLdm5H5rNhNEUKI9qKs2vP6Ws5dn2NWKQ4EexSa_t63AI4j321NjMYlQ&q=pizza&sa=X&ved=2ahUKEwjxws_C-vKSAxV_jpUCHW6uFOIQs6gLegQIExAB"
      },
      {
        "title": "Sites de lieux",
        "href": "https://www.google.com/search?sca_esv=62b03b7345eac9c6&gl=fr&hl=fr&udm=11&fbs=ADc_l-bpk8W4E-qsVlOvbGJcDwpnHC5OJXXTJvmMu2n9YYx-G8xzgQk24aW1N_FyIND5zVDd4bb14119C8nZHL5l4Fe3xClku41MXRAvxO93q4ubY1l9Hk1FiCr1bfzSXqh4O7o8B1sqrSvZ-w516qcDYmxC9v7HcBaL83oJPMyLdm5H5rNhNEUKI9qKs2vP6Ws5dn2NWKQ4EexSa_t63AI4j321NjMYlQ&q=pizza&sa=X&ved=2ahUKEwjxws_C-vKSAxV_jpUCHW6uFOIQs6gLegQIEBAB"
      },
      {
        "title": "Actualités",
        "href": "https://www.google.com/search?sca_esv=62b03b7345eac9c6&gl=fr&hl=fr&q=pizza&tbm=nws&source=lnms&fbs=ADc_l-bpk8W4E-qsVlOvbGJcDwpnHC5OJXXTJvmMu2n9YYx-G8xzgQk24aW1N_FyIND5zVDd4bb14119C8nZHL5l4Fe3xClku41MXRAvxO93q4ubY1l9Hk1FiCr1bfzSXqh4O7o8B1sqrSvZ-w516qcDYmxC9v7HcBaL83oJPMyLdm5H5rNhNEUKI9qKs2vP6Ws5dn2NWKQ4EexSa_t63AI4j321NjMYlQ&sa=X&ved=2ahUKEwjxws_C-vKSAxV_jpUCHW6uFOIQ0pQJegQIDhAB"
      },
      {
        "title": "Web",
        "href": "https://www.google.com/search?sca_esv=62b03b7345eac9c6&gl=fr&hl=fr&udm=web&fbs=ADc_l-bpk8W4E-qsVlOvbGJcDwpnHC5OJXXTJvmMu2n9YYx-G8xzgQk24aW1N_FyIND5zVDd4bb14119C8nZHL5l4Fe3xClku41MXRAvxO93q4ubY1l9Hk1FiCr1bfzSXqh4O7o8B1sqrSvZ-w516qcDYmxC9v7HcBaL83oJPMyLdm5H5rNhNEUKI9qKs2vP6Ws5dn2NWKQ4EexSa_t63AI4j321NjMYlQ&q=pizza&sa=X&ved=2ahUKEwjxws_C-vKSAxV_jpUCHW6uFOIQs6gLegUIhgEQAQ"
      },
      {
        "title": "Livres",
        "href": "https://www.google.com/search?sca_esv=62b03b7345eac9c6&gl=fr&hl=fr&q=pizza&udm=36&source=lnms&fbs=ADc_l-bpk8W4E-qsVlOvbGJcDwpnHC5OJXXTJvmMu2n9YYx-G8xzgQk24aW1N_FyIND5zVDd4bb14119C8nZHL5l4Fe3xClku41MXRAvxO93q4ubY1l9Hk1FiCr1bfzSXqh4O7o8B1sqrSvZ-w516qcDYmxC9v7HcBaL83oJPMyLdm5H5rNhNEUKI9qKs2vP6Ws5dn2NWKQ4EexSa_t63AI4j321NjMYlQ&sa=X&ved=2ahUKEwjxws_C-vKSAxV_jpUCHW6uFOIQ0pQJegUIhwEQAQ"
      }
    ],
    "organic": [
      {
        "link": "https://fr.wikipedia.org/wiki/Pizza",
        "source": "Wikipédia",
        "display_link": "https://fr.wikipedia.org › wiki › Pizza",
        "title": "Pizza",
        "description": "La pizza est une recette de cuisine traditionnelle de la cuisine italienne, originaire de Naples à base de galette de pâte à pain, garnie principalement d'huile ...",
        "snippet_highlighted_words": [
          "une recette de cuisine traditionnelle de la cuisine italienne"
        ],
        "icon": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAABwAAA...",
        "image": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcT3LHIkhBM9Js037FoYdKk9hSCK8Lz1EB0RxeyS6EExOQjLb9qLPsZ3&usqp=CAE&s",
        "image_alt": "pizza sur fr.wikipedia.org",
        "image_url": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcT3LHIkhBM9Js037FoYdKk9hSCK8Lz1EB0RxeyS6EExOQjLb9qLPsZ3&usqp=CAE&s",
        "rank": 1,
        "global_rank": 18
      },
      {
        "link": "https://www.marmiton.org/recettes/recette_pizza-maison_313213.aspx",
        "source": "Marmiton",
        "display_link": "https://www.marmiton.org › ... › pizza",
        "title": "Recette de Pizza maison",
        "description": "Préparation de la pizza. Mettez votre four à préchauffer à 220°C. Sur votre plan de travail, étalez un peu de farine afin que la boule de colle pas.",
        "snippet_highlighted_words": [
          "Mettez votre four à préchauffer à 220°C"
        ],
        "extensions": [
          {
            "type": "rating",
            "rating": 5,
            "reviews_cnt": 23,
            "rank": 1
          }
        ],
        "icon": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAABwAAA...",
        "image": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcSGNL56si-nVFxs_zeTO6q7XwUjiet_MAnn7sKNYYmjYzDOYxYm7WIc&usqp=CAE&s",
        "image_alt": "pizza sur www.marmiton.org",
        "image_url": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcSGNL56si-nVFxs_zeTO6q7XwUjiet_MAnn7sKNYYmjYzDOYxYm7WIc&usqp=CAE&s",
        "rank": 2,
        "global_rank": 19
      },
      {
        "link": "https://www.dominos.fr/",
        "source": "Domino's Pizza",
        "display_link": "https://www.dominos.fr",
        "title": "Domino's Pizza, livraison et à emporter, commande en ligne",
        "description": "Commandez vos pizzas en ligne en livraison ou à emporter dans votre pizzeria Domino's la plus proche et dégustez-les en famille ou avec vos amis.",
        "snippet_highlighted_words": [
          "Commandez vos pizzas en ligne en livraison ou à emporter"
        ],
        "icon": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAABAAAA...",
        "image": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcTCf5qNZRvb7AOasK4bkZVf43P-y-6lDa_eBaxgXGw3BuqKmU5ictBb&usqp=CAE&s",
        "image_alt": "pizza sur www.dominos.fr",
        "image_url": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcTCf5qNZRvb7AOasK4bkZVf43P-y-6lDa_eBaxgXGw3BuqKmU5ictBb&usqp=CAE&s",
        "rank": 3,
        "global_rank": 20
      },
      {
        "link": "https://www.youtube.com/watch?v=WVrdUC-92-w",
        "source": "YouTube · Julie Andrieu - Chaîne officielle",
        "display_link": "Plus de 60 k vues · il y a 2 ans",
        "title": "Pizza maison - 10 leçons pour la réussir",
        "description": "00:00 - Introduction 00:30 - Leçon 1 : Choisir les bons ingrédients : farine, eau, levure fraîche 01:57 - Leçon 2 : Préparez un levain ...",
        "icon": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAABAAAA...",
        "image": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcTSNUtVRdhbjy1RctOwPWDoIcBixJcr0uIZ585eJyl0lkTLyhUXGt7gXA&s",
        "image_url": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcTSNUtVRdhbjy1RctOwPWDoIcBixJcr0uIZ585eJyl0lkTLyhUXGt7gXA&s",
        "duration": "8:51",
        "duration_sec": 531,
        "rank": 4,
        "global_rank": 24
      },
      {
        "link": "https://cuisine.journaldesfemmes.fr/recette-pizza",
        "source": "Journal des Femmes",
        "display_link": "https://cuisine.journaldesfemmes.fr › recette-pizza",
        "title": "Pizza maison : recettes faciles et savoureuses",
        "description": "Pizza : Meilleures recettes · Pizza chèvre, figues, pistaches et miel · Pizza blanche au saumon fumé et à la cancoillotte · Pizza au salami de Milano et chorizo.",
        "snippet_highlighted_words": [
          "Pizza : Meilleures recettes"
        ],
        "extensions": [
          {
            "type": "rating",
            "rating": 4.3,
            "reviews_cnt": 96,
            "rank": 1
          }
        ],
        "icon": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAABwAAA...",
        "rank": 5,
        "global_rank": 25
      },
      {
        "link": "https://www.pizzahut.fr/",
        "source": "Pizza Hut",
        "display_link": "https://www.pizzahut.fr",
        "title": "Pizza Hut Livraison, vente à emporter | Commande en ligne ...",
        "description": "Pizza Hut Livraison, vente à emporter | Commande en ligne | Coupons, Promos.",
        "snippet_highlighted_words": [
          "Pizza Hut Livraison, vente à emporter"
        ],
        "icon": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAABwAAA...",
        "rank": 6,
        "global_rank": 26
      },
      {
        "link": "https://www.youtube.com/@lafrenchpizza",
        "source": "YouTube · La French Pizza",
        "display_link": "Plus de 39,6 k abonnés",
        "title": "La French Pizza",
        "description": "Recette · HOW TO MAKE NEAPOLITAN PIZZA DOUGH? | Special for beginners and without equipment · HOW TO ROLL OUT PIZZA DOUGH? By hand, without a rolling pin!",
        "snippet_highlighted_words": [
          "HOW TO MAKE NEAPOLITAN PIZZA DOUGH"
        ],
        "icon": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAABAAAA...",
        "rank": 7,
        "global_rank": 27
      },
      {
        "link": "https://www.picard.fr/rayons/pizzas-et-tartes",
        "source": "Picard",
        "display_link": "https://www.picard.fr › rayons › pizzas-et-tartes",
        "title": "Pizzas et tartes",
        "description": "Picard vous propose un assortiment de pizzas et de tartes salées pour toute la famille. Elles se déclinent en formats ronds, carrés, individuels ou à partager.",
        "snippet_highlighted_words": [
          "Picard vous propose un assortiment de pizzas et de tartes salées pour toute la famille"
        ],
        "icon": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAABwAAA...",
        "rank": 8,
        "global_rank": 28
      },
      {
        "link": "https://www.la-bella-pizza.fr/",
        "source": "LA BELLA PIZZA MARSEILLE",
        "display_link": "https://www.la-bella-pizza.fr",
        "title": "LA BELLA PIZZA MARSEILLE",
        "description": "26, PLACE NOTRE-DAME-DU-MONT MARSEILLE 6E ... C'EST LE GOÛT AUTHENTIQUE DE LA PIZZA AU FEU DE BOIS D'ANTAN, À LA TOMATE FRAÎCHE AU HACHOIR, À L'AIL ET À L'ORIGAN.",
        "snippet_highlighted_words": [
          "26, PLACE NOTRE-DAME-DU-MONT MARSEILLE 6E"
        ],
        "icon": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAABwAAA...",
        "image": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcTld-I-7kBDNQ_svH12luxlkSyqHjYidZJcEsTO9qcE3nFKWsFZU9vS&usqp=CAE&s",
        "image_alt": "pizza sur www.la-bella-pizza.fr",
        "image_url": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcTld-I-7kBDNQ_svH12luxlkSyqHjYidZJcEsTO9qcE3nFKWsFZU9vS&usqp=CAE&s",
        "rank": 9,
        "global_rank": 29
      },
      {
        "link": "https://www.hervecuisine.com/recette/recette-de-pizzas-facile/",
        "source": "Hervé Cuisine",
        "display_link": "https://www.hervecuisine.com › Recettes",
        "title": "Recette de pizza italienne maison facile en vidéo",
        "description": "Liste des ingrédients · 2 Oignons · 2 gousses d'ail · 300 ml de passata ou coulis de tomate · 1 cuil. à café d'herbes de Provence (thym, origan, ...",
        "snippet_highlighted_words": [
          "Liste des ingrédients"
        ],
        "extensions": [
          {
            "inline": true,
            "type": "text",
            "text": "24 mars 2020",
            "rank": 1
          },
          {
            "type": "rating",
            "rating": 4.5,
            "reviews_cnt": 122,
            "rank": 2
          }
        ],
        "icon": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAABwAAA...",
        "image": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcTgPFVxX3bZycyrJXnGa-6STq-fY-jdqukKprM7EZCuJgEIq1Cm7CvS&usqp=CAE&s",
        "image_alt": "pizza sur www.hervecuisine.com",
        "image_url": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcTgPFVxX3bZycyrJXnGa-6STq-fY-jdqukKprM7EZCuJgEIq1Cm7CvS&usqp=CAE&s",
        "rank": 10,
        "global_rank": 30
      }
    ],
    "knowledge": {
      "name": "Pizza",
      "summary": "Pain",
      "subtitle": "Pain",
      "description": "La pizza est une recette de cuisine traditionnelle de la cuisine italienne, originaire de Naples à base de galette de pâte à pain, garnie principalement d'huile d'olive, de sauce tomate, de mozzarella et d'autres ingrédients et cuite au four.",
      "description_source": "Wikipédia",
      "description_link": "https://fr.wikipedia.org/wiki/Pizza",
      "images": [
        {
          "image": "data:image/webp;base64,UklGRuQWAABXRUJQVlA4INgWAACwag...",
          "image_alt": "Image de Pizza maison à la friteuse à air – Parfaitement ...",
          "image_base64": "data:image/webp;base64,UklGRuQWAABXRUJQVlA4INgWAACwag..."
        },
        {
          "image": "data:image/webp;base64,UklGRkAIAABXRUJQVlA4IDQIAAAwLw...",
          "image_alt": "Image de Pizza Parma",
          "image_base64": "data:image/webp;base64,UklGRkAIAABXRUJQVlA4IDQIAAAwLw..."
        },
        {
          "image": "data:image/webp;base64,UklGRgoKAABXRUJQVlA4IP4JAADwNg...",
          "image_alt": "Image de Pizza Piccante | Oil & Vinegar",
          "image_base64": "data:image/webp;base64,UklGRgoKAABXRUJQVlA4IP4JAADwNg..."
        }
      ],
      "facts": [
        {
          "key": "Origine",
          "predicate": "hw:/collection/dishes:origin",
          "value": [
            {
              "text": "Italie",
              "link": "https://www.google.com/search?sca_esv=62b03b7345eac9c6&gl=fr&hl=fr&q=Italie&si=AL3DRZHmwLjWhgnaPB3UTu10R6S5qNLXiQiKMeezfKyB1FMsRh4OGAJvOSklPiUalZSIgao4QqW76hqPIFuzQ7v7azf6k5fxmXNe-rtMqCs_t8NhvbAYJTVcpsAfehVTA_xRncYUE2DOj4YepnYp33la15xAXe361JXX31pqgLu0p6tOh_lc4hCW414ZieHhjAACQXtdol9-&sa=X&ved=2ahUKEwjxws_C-vKSAxV_jpUCHW6uFOIQmxN6BAgbEAI"
            }
          ]
        }
      ],
      "nutrition_facts": {
        "product": "Pizza, 36 cm, pâte moyenne",
        "source": "USDA",
        "source_link": "https://fdc.nal.usda.gov/food-details/173292/nutrients",
        "calories": "266 Calories",
        "portion": "100 grammes"
      }
    },
    "overview": {
      "title": "Pizza",
      "kgmid": "/m/0663v"
    },
    "snack_pack_map": {
      "image": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAowAAA...",
      "image_base64": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAowAAA..."
    },
    "snack_pack": [
      {
        "name": "Pizza Time® Amiens",
        "image": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAFoAAA...",
        "image_base64": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAFoAAA...",
        "reviews_cnt": 45,
        "type": "Pizza",
        "address": "Repas sur place ⋅ Vente à emporter ⋅ Livraison sans contact ⋅ Site Web",
        "tags": [
          "Amiens"
        ],
        "site": "https://pizzatime.fr/",
        "rank": 1,
        "global_rank": 1
      },
      {
        "name": "La Maison des Pizzas",
        "image": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQABAAD/4Q...",
        "image_base64": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQABAAD/4Q...",
        "reviews_cnt": 44,
        "type": "Pizza",
        "address": "Repas sur place ⋅ Vente à emporter ⋅ Pas de livraison ⋅ Site Web",
        "tags": [
          "Saint-Florent"
        ],
        "site": "https://webshop.fulleapps.io/s/maison-des-pizzas/mja1ntcyxzy2ngm",
        "rank": 2,
        "global_rank": 2
      },
      {
        "name": "Allo Pizza",
        "image": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQABAAD/4Q...",
        "image_base64": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQABAAD/4Q...",
        "reviews_cnt": 47,
        "type": "Pizza",
        "address": "Repas sur place ⋅ Vente à emporter ⋅ Livraison ⋅ Site Web",
        "tags": [
          "Gannat"
        ],
        "site": "https://allo-pizza-gannat.fr/",
        "rank": 3,
        "global_rank": 3
      },
      {
        "name": "La Casa Del Pizz 🍕",
        "image": "https://lh3.googleusercontent.com/gps-cs-s/AHVAwepv8l9gqqDsx5bJ1Yk4RjzllN-XMC5FlN5EV88fS4WI1lp9VQwuWKl9lNNWy-UOv8ui5DMS7t3klKtc1yiEUrIcny1EJ-sv1CFKZhQczZEW8AelbUOs3w8frO5pTKzZ_PMZCUFTndzLsC0=w92-h92-n-k-no",
        "image_url": "https://lh3.googleusercontent.com/gps-cs-s/AHVAwepv8l9gqqDsx5bJ1Yk4RjzllN-XMC5FlN5EV88fS4WI1lp9VQwuWKl9lNNWy-UOv8ui5DMS7t3klKtc1yiEUrIcny1EJ-sv1CFKZhQczZEW8AelbUOs3w8frO5pTKzZ_PMZCUFTndzLsC0=w92-h92-n-k-no",
        "reviews_cnt": 50,
        "type": "Pizza",
        "work_status": "Ferme bientôt",
        "work_status_details": "21:30",
        "address": "Saint-Julien-le-Pèlerin",
        "rank": 4,
        "global_rank": 21
      },
      {
        "name": "Pizzeria \"The Giorgi's\"",
        "image": "https://lh3.googleusercontent.com/gps-cs-s/AHVAwerlK7DGPIKCqOf0elgQc9JiIsxJeCtJVaFt-gOZ2zSlfivqjQAcszTvwu6XgBo88huXlmG9tfzAE69IA2ENFTjT0hGzZzd51EAGe7xqa6E9PrmPohuS10jw_e1_iSPkBbYBdss=w92-h92-n-k-no",
        "image_url": "https://lh3.googleusercontent.com/gps-cs-s/AHVAwerlK7DGPIKCqOf0elgQc9JiIsxJeCtJVaFt-gOZ2zSlfivqjQAcszTvwu6XgBo88huXlmG9tfzAE69IA2ENFTjT0hGzZzd51EAGe7xqa6E9PrmPohuS10jw_e1_iSPkBbYBdss=w92-h92-n-k-no",
        "reviews_cnt": 49,
        "type": "Pizza",
        "work_status": "Ferme bientôt",
        "work_status_details": "22:00",
        "address": "La Bourboule, Repas sur place ⋅ Vente à emporter ⋅ Pas de livraison ⋅ Site Web",
        "site": "https://m.facebook.com/p/The-Giorgis-100079622973292/",
        "rank": 5,
        "global_rank": 22
      },
      {
        "name": "Mister Pizza -Nice Barla",
        "image": "https://lh3.googleusercontent.com/gps-cs-s/AHVAwepbbc8H391PfVftgmxxarUE5zevNpL3rBmT7PR1qqdlj9SS51tirt2LfZ-m6_kWnFxPOL81twrspJ1to64UUyv5FrofE4qFT20rXLa3VjH8IIgfJ_ej9LHxF4JYfNM4n9ESf9Q=w92-h92-n-k-no",
        "image_url": "https://lh3.googleusercontent.com/gps-cs-s/AHVAwepbbc8H391PfVftgmxxarUE5zevNpL3rBmT7PR1qqdlj9SS51tirt2LfZ-m6_kWnFxPOL81twrspJ1to64UUyv5FrofE4qFT20rXLa3VjH8IIgfJ_ej9LHxF4JYfNM4n9ESf9Q=w92-h92-n-k-no",
        "reviews_cnt": 40,
        "type": "Pizza",
        "address": "Repas sur place ⋅ Vente à emporter ⋅ Livraison ⋅ Site Web",
        "tags": [
          "Nice"
        ],
        "site": "http://www.mister-pizza.com/",
        "rank": 6,
        "global_rank": 23
      }
    ],
    "pagination": [
      {
        "page": 2,
        "start": 10,
        "link": "https://www.google.com/search?q=pizza&sca_esv=62b03b7345eac9c6&gl=fr&hl=fr&ei=tAieafGYHf-c1sQP7tzSkA4&start=10&sa=N&sstk=Af77f_cmD63hekmmnSSJPoXn1kdGehHJb1HbjLnOhIejeXAmILfZ4CiNxm-7n1A1lx7ZmrOJOMny3zsTqoN1okjJiF0_OWJ7ioddcg&ved=2ahUKEwjxws_C-vKSAxV_jpUCHW6uFOIQ8tMDegQICRAE"
      },
      {
        "page": 3,
        "start": 20,
        "link": "https://www.google.com/search?q=pizza&sca_esv=62b03b7345eac9c6&gl=fr&hl=fr&ei=tAieafGYHf-c1sQP7tzSkA4&start=20&sa=N&sstk=Af77f_cmD63hekmmnSSJPoXn1kdGehHJb1HbjLnOhIejeXAmILfZ4CiNxm-7n1A1lx7ZmrOJOMny3zsTqoN1okjJiF0_OWJ7ioddcg&ved=2ahUKEwjxws_C-vKSAxV_jpUCHW6uFOIQ8tMDegQICRAG"
      },
      {
        "page": 4,
        "start": 30,
        "link": "https://www.google.com/search?q=pizza&sca_esv=62b03b7345eac9c6&gl=fr&hl=fr&ei=tAieafGYHf-c1sQP7tzSkA4&start=30&sa=N&sstk=Af77f_cmD63hekmmnSSJPoXn1kdGehHJb1HbjLnOhIejeXAmILfZ4CiNxm-7n1A1lx7ZmrOJOMny3zsTqoN1okjJiF0_OWJ7ioddcg&ved=2ahUKEwjxws_C-vKSAxV_jpUCHW6uFOIQ8tMDegQICRAI"
      }
    ],
    "related": [
      {
        "text": "Pizzas : Pizzas, Quiches et Tartes pas cher en Livraison et Drive",
        "link": "https://www.carrefour.fr/r/surgeles/pizzas-quiches-tartes/pizzas",
        "image": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQABAAD/2w...",
        "image_base64": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQABAAD/2w...",
        "rank": 1,
        "global_rank": 4
      },
      {
        "text": "Super Recettes. . Pizza maison aux petits pains : recette facile pour ne plus en acheter",
        "link": "https://www.facebook.com/superrecettess/videos/pizza-maison-aux-petits-pains-recette-facile-pour-ne-plus-en-acheter/919698497110327/",
        "image": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQABAAD/2w...",
        "image_base64": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQABAAD/2w...",
        "rank": 2,
        "global_rank": 5
      },
      {
        "text": "Pizzas à Emporter et en Livraison à Domicile à Saint-Étienne",
        "link": "https://www.ubereats.com/fr/category/saint-%C3%A9tienne-ara/pizza",
        "image": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQABAAD/2w...",
        "image_base64": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQABAAD/2w...",
        "rank": 3,
        "global_rank": 6
      }
    ],
    "people_also_ask": [
      {
        "question": "Quel ingrédient mettre sur une pizza ?",
        "question_link": "https://www.jesuisgastronome.fr/actu/273/la-liste-des-quinze-meilleurs-ingredients-pour-une-pizza",
        "question_type": "featured",
        "answer_source": "JeSuisGastronome.fr",
        "answer_link": "https://www.jesuisgastronome.fr/actu/273/la-liste-des-quinze-meilleurs-ingredients-pour-une-pizza",
        "answer_display_link": "https://www.jesuisgastronome.fr › actu › la-liste-des-quin...https://www.jesuisgastronome.fr › actu › la-liste-des-quin...",
        "answers": [
          {
            "type": "unordered_list",
            "title": "La liste des quinze meilleurs ingrédients pour une pizza",
            "items": [
              {
                "value": "- Le mozzarella fondant.",
                "rank": 1
              },
              {
                "value": "- La fraîcheur du basilic.",
                "rank": 2
              },
              {
                "value": "- L'authentique jambon de Parme.",
                "rank": 3
              },
              {
                "value": "- Le piquant des olives noires.",
                "rank": 4
              },
              {
                "value": "- Apprécier l'anchois salé",
                "rank": 5
              },
              {
                "value": "- Déguster les champignons frais.",
                "rank": 6
              },
              {
                "value": "- Aimer la roquette croquante.",
                "rank": 7
              },
              {
                "value": "- Savourer le saucisson épicé",
                "rank": 8
              }
            ],
            "rank": 1
          }
        ],
        "rank": 1,
        "global_rank": 14
      },
      {
        "question": "Quelle est la pizza la plus digeste ?",
        "question_type": "featured",
        "answer_source": "Ducreux",
        "answer_link": "https://www.ducreux-cfi.com/quest-ce-que-la-pinsa-romana/#:~:text=Pourquoi%20la%20pinsa%20est%2Delle,rendant%20la%20p%C3%A2te%20plus%20tol%C3%A9rable.",
        "answer_display_link": "https://www.ducreux-cfi.com › quest-ce-que-la-pinsa-ro...https://www.ducreux-cfi.com › quest-ce-que-la-pinsa-ro...",
        "answers": [
          {
            "type": "exact_answer",
            "title": "pinsa",
            "rank": 1
          },
          {
            "type": "answer",
            "value": {
              "text": "Pourquoi la pinsa est-elle plus digeste que la pizza traditionnelle ? La haute digestibilité de la pinsa repose sur plusieurs facteurs : La fermentation longue permet de prédigérer les sucres complexes, rendant la pâte plus tolérable."
            },
            "rank": 2
          }
        ],
        "rank": 2,
        "global_rank": 15
      },
      {
        "question": "Quel ordre pour garnir une pizza ?",
        "question_type": "featured",
        "answer_source": "Envie de Bien Manger",
        "answer_link": "https://www.enviedebienmanger.fr/conseils-cuisine/comment-faire-les-pizzas-maison-de-la-pate-a-la-cuisson-de-la-pizza#:~:text=Quelques%20conseils%20pour%20garnir%20votre%20pizza%20%3A&text=Prenez%20%C3%A9galement%20soin%20de%20respecter,et%20ensuite%20les%20autres%20ingr%C3%A9dients.",
        "answer_display_link": "https://www.enviedebienmanger.fr › conseils-cuisine › c...https://www.enviedebienmanger.fr › conseils-cuisine › c...",
        "answers": [
          {
            "type": "answer",
            "value": {
              "text": "Quelques conseils pour garnir votre pizza : Prenez également soin de respecter l'ordre des ingrédients : d'abord la base (coulis de tomates, crème fraiche, ou huile d'olive) puis la mozzarella (de vache) ou du provolone, et ensuite les autres ingrédients."
            },
            "rank": 1
          }
        ],
        "rank": 3,
        "global_rank": 16
      },
      {
        "question": "Quelle est la meilleure pâte pour faire une pizza ?",
        "question_type": "featured",
        "answer_source": "Pizza Papa",
        "answer_link": "https://www.pizzapapa.fr/blog/quelle-pate-a-pizza-choisir/#:~:text=La%20p%C3%A2te%20feuillet%C3%A9e%20pour%20innover,pizzas%20pour%20un%20ap%C3%A9ritif%20dinatoire.",
        "answer_display_link": "https://www.pizzapapa.fr › blog › quelle-pate-a-pizza-ch...https://www.pizzapapa.fr › blog › quelle-pate-a-pizza-ch...",
        "answers": [
          {
            "type": "answer",
            "value": {
              "text": "La pâte feuilletée pour innover La pâte feuilletée est idéale pour réaliser une pizza plus originale. Elle apporte une touche de légèreté et croustille bien. Elle est recommandée si vous préparez des pizzas pour un apéritif dinatoire.11 juil. 2025"
            },
            "rank": 1
          }
        ],
        "rank": 4,
        "global_rank": 17
      }
    ],
    "oragnic": [
      {
        "link": "https://fr.wikipedia.org/wiki/Pizza",
        "source": "Wikipédia",
        "display_link": "https://fr.wikipedia.org › wiki › Pizza",
        "title": "Pizza",
        "description": "La pizza est une recette de cuisine traditionnelle de la cuisine italienne, originaire de Naples à base de galette de pâte à pain, garnie principalement d'huile ...",
        "snippet_highlighted_words": [
          "une recette de cuisine traditionnelle de la cuisine italienne"
        ],
        "icon": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAABwAAA...",
        "image": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcT3LHIkhBM9Js037FoYdKk9hSCK8Lz1EB0RxeyS6EExOQjLb9qLPsZ3&usqp=CAE&s",
        "image_alt": "pizza sur fr.wikipedia.org",
        "image_url": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcT3LHIkhBM9Js037FoYdKk9hSCK8Lz1EB0RxeyS6EExOQjLb9qLPsZ3&usqp=CAE&s",
        "rank": 1,
        "global_rank": 18
      },
      {
        "link": "https://www.marmiton.org/recettes/recette_pizza-maison_313213.aspx",
        "source": "Marmiton",
        "display_link": "https://www.marmiton.org › ... › pizza",
        "title": "Recette de Pizza maison",
        "description": "Préparation de la pizza. Mettez votre four à préchauffer à 220°C. Sur votre plan de travail, étalez un peu de farine afin que la boule de colle pas.",
        "snippet_highlighted_words": [
          "Mettez votre four à préchauffer à 220°C"
        ],
        "extensions": [
          {
            "type": "rating",
            "rating": 5,
            "reviews_cnt": 23,
            "rank": 1
          }
        ],
        "icon": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAABwAAA...",
        "image": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcSGNL56si-nVFxs_zeTO6q7XwUjiet_MAnn7sKNYYmjYzDOYxYm7WIc&usqp=CAE&s",
        "image_alt": "pizza sur www.marmiton.org",
        "image_url": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcSGNL56si-nVFxs_zeTO6q7XwUjiet_MAnn7sKNYYmjYzDOYxYm7WIc&usqp=CAE&s",
        "rank": 2,
        "global_rank": 19
      },
      {
        "link": "https://www.dominos.fr/",
        "source": "Domino's Pizza",
        "display_link": "https://www.dominos.fr",
        "title": "Domino's Pizza, livraison et à emporter, commande en ligne",
        "description": "Commandez vos pizzas en ligne en livraison ou à emporter dans votre pizzeria Domino's la plus proche et dégustez-les en famille ou avec vos amis.",
        "snippet_highlighted_words": [
          "Commandez vos pizzas en ligne en livraison ou à emporter"
        ],
        "icon": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAABAAAA...",
        "image": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcTCf5qNZRvb7AOasK4bkZVf43P-y-6lDa_eBaxgXGw3BuqKmU5ictBb&usqp=CAE&s",
        "image_alt": "pizza sur www.dominos.fr",
        "image_url": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcTCf5qNZRvb7AOasK4bkZVf43P-y-6lDa_eBaxgXGw3BuqKmU5ictBb&usqp=CAE&s",
        "rank": 3,
        "global_rank": 20
      }
    ]
  }
  ```
</ResponseExample>


# Multiple requests
Source: https://docs.brightdata.com/api-reference/serp/google-search/multiple-requests

Configure the Bright Data Google Search multiple requests parameter (31 languages) to refine queries and return matching results as JSON or HTML.

```json theme={null}
"multi":[
  {
    "query":{"q":"pizza","num":20}},
    {"query":{"q":"pizza","num":100}
  }
]
```

<Note>
  Please note that parallel requests work only with async mode.
</Note>

## Parameters

<ParamField type="string">
  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

  <CodeGroup>
    ```js Same Keywords with different num theme={null}
    multi=[
      {"query":{"q":"pizza","num":20}},
      {"query":{"q":"pizza","num":100}}
    ]
    ```

    ```js Different Keywords theme={null}
    multi=[
      {"query":{"q":"pizza"}},
      {"query":{"q":"burger"}}
    ]
    ```
  </CodeGroup>
</ParamField>

<RequestExample>
  ```shell cURL highlight={5} theme={null}
  curl --request POST \
    --url https://api.brightdata.com/serp/req?zone=serp_api1 \
    --header 'Authorization: Bearer <token>' \
    --header 'Content-Type: application/json' \
    --data '{"country": "US","multi":[{"query":{"q":"pizza","num":20}},{"query":{"q":"pizza","num":100}}]}'
  ```

  ```shell Native proxy highlight={4} theme={null}
  curl -i --silent --compressed \
    -H "Content-Type: application/json"
    -H "Authorization: Bearer API_KEY" \
    -d $'{"country":"us","multi":[{"query":{"q":"pizza","num":20}},{"query":{"q":"pizza","num":100}}]}'
    "https://api.brightdata.com/serp/req?customer=CUSTOMER_USERNAME&zone=ZONE_NAME"
  ```

  ```js Node.js highlight={10} theme={null}
  const options = {
    method: 'POST',
    headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
    body: JSON.stringify({
      query: {q: 'pizza', gl: 'au', hl: 'en', start: 20},
      country: 'US',
      multi: [{"query":{"q":"pizza","num":20}},{"query":{"q":"pizza","num":100}}]
    })
  };

  fetch('https://api.brightdata.com/serp/req?zone=serp_api1', options)
    .then(res => res.json())
    .then(res => console.log(res))
    .catch(err => console.error(err));
  ```

  ```python Python highlight={11} theme={null}
  import requests

  url = "https://api.brightdata.com/serp/req?zone=serp_api1"

  payload = {
      "multi": [{"query":{"q":"pizza","num":20}},{"query":{"q":"pizza","num":100}}],
      "country": "US",
      "brd_json": "json"
  }

  headers = {
      "Authorization": "Bearer <token>",
      "Content-Type": "application/json"
  }

  response = requests.post(url, json=payload, headers=headers)

  print(response.text)
  ```
</RequestExample>


# News search
Source: https://docs.brightdata.com/api-reference/serp/google-search/news

Configure the Bright Data Google Search News Search parameter to refine queries and return matching results as JSON or HTML. On port 44445.

```http theme={null}
https://www.google.com/search?q=pizza&tbm=nws
```

## Parameters

<ParamField type="string">
  The search query parameter. Specifies the keyword or phrase you want to search for on Google.
</ParamField>

<ParamField type="string">
  Define search type. For News search, set `tbm` value to `nws`.

  ```http theme={null}
  https://www.google.com/search?q=pizza&tbm=nws
  ```
</ParamField>

<RequestExample>
  ```shell cURL highlight={6} theme={null}
    curl -X POST https://api.brightdata.com/request \
    --header "Content-Type: application/json" \
    --header "Authorization: Bearer API_KEY" \
    --data '{
      "zone": "serp_api1",
      "url": "https://www.google.com/search?q=pizza&tbm=nws",
      "format": "raw"
    }'
  ```

  ```shell Native proxy highlight={4} theme={null}
  curl --proxy brd.superproxy.io:44445 \
    --proxy-user CUSTOMER_USERNAME:CUSTOMER_PASSWORD \
    --ssl-no-revoke \
    "https://www.google.com/search?q=pizza&tbm=nws"
  ```

  ```js Node.js highlight={10} theme={null}
  (async () => {
    const response = await fetch('https://api.brightdata.com/request', {
      method: 'POST',
      headers: {
        'Content-Type': 'application/json',
        'Authorization': 'Bearer API_KEY'
      },
      body: JSON.stringify({
        zone: 'serp_api1',
        url: 'https://www.google.com/search?q=pizza&tbm=nws',
        format: 'raw'
      })
    });
    
    const data = await response.text();
    console.log(data);
  })();
  ```

  ```python Python highlight={11} theme={null}
  import requests

  # API Configuration
  headers = {
      'Content-Type': 'application/json',
      'Authorization': 'Bearer API_KEY',
  }

  payload = {
      'zone': 'serp_api1',
      'url': 'https://www.google.com/search?q=pizza&tbm=nws',
      'format': 'raw'
  }

  # Make the request
  response = requests.post(
      'https://api.brightdata.com/request', 
      json=payload, 
      headers=headers
  )

  print(response.text)
  ```
</RequestExample>

<ResponseExample>
  ```json 200 highlight={11} theme={null}
  {
    "general": {
      "search_engine": "google",
      "query": "pizza",
      "results_cnt": 1110000,
      "search_time": 0.25,
      "language": "en",
      "location": "United States",
      "mobile": false,
      "basic_view": false,
      "search_type": "news",
      "page_title": "pizza - Google Search",
      "timestamp": "2026-02-25T08:21:53.400Z"
    },
    "input": {
      "original_url": "https://www.google.com/search?q=pizza&tbm=nws&brd_json=1",
      "request_id": "hl_xxxxxxxxxxxxxxx"
    },
    "navigation": [
      {
        "title": "All",
        "href": "https://www.google.com/search?q=pizza&sca_esv=206cd4dd954885db&gl=US&hl=en&source=lnms&sa=X&ved=2ahUKEwi98L2Km_SSAxV6lZUCHTpMKbEQ0pQJegQIAhAE"
      },
      {
        "title": "Images",
        "href": "https://www.google.com/search?q=pizza&sca_esv=206cd4dd954885db&gl=US&hl=en&udm=2&source=lnms&sa=X&ved=2ahUKEwi98L2Km_SSAxV6lZUCHTpMKbEQ0pQJegQIAhAG"
      },
      {
        "title": "Videos",
        "href": "https://www.google.com/search?q=pizza&sca_esv=206cd4dd954885db&gl=US&hl=en&udm=7&source=lnms&sa=X&ved=2ahUKEwi98L2Km_SSAxV6lZUCHTpMKbEQ0pQJegQIAhAI"
      },
      {
        "title": "Shopping",
        "href": "https://www.google.com/search?q=pizza&sca_esv=206cd4dd954885db&gl=US&hl=en&udm=28&source=lnms&ved=1t:200715&ictx=111"
      },
      {
        "title": "Maps",
        "href": "https://maps.google.com/maps?q=pizza&gl=US&hl=en&um=1&ie=UTF-8&ved=1t:200715&ictx=111"
      }
    ],
    "news": [
      {
        "title": "Hegseth says he’ll order random pizzas to throw off monitoring app",
        "link": "https://thehill.com/policy/defense/5750716-pentagon-pizza-report-hegseth/",
        "source": "The Hill",
        "source_logo": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAABAAAA...",
        "date": "1 day ago",
        "image": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQABAAD/2w...",
        "image_base64": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQABAAD/2w...",
        "rank": 1,
        "global_rank": 1
      },
      {
        "title": "Pentagon Pizza Index ties pizza spikes to military action",
        "link": "https://www.jpost.com/international/article-887543",
        "source": "The Jerusalem Post",
        "source_logo": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAABAAAA...",
        "date": "2 days ago",
        "image": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQABAAD/2w...",
        "image_base64": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQABAAD/2w...",
        "rank": 2,
        "global_rank": 2
      },
      {
        "title": "Domino's Pizza® Announces Fourth Quarter and Fiscal 2025 Financial Results",
        "link": "https://ir.dominos.com/news-releases/news-release-details/dominos-pizzar-announces-fourth-quarter-and-fiscal-2025",
        "source": "Domino's Pizza",
        "source_logo": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAABAAAA...",
        "description": "Global retail sales growth (excluding foreign currency impact) of 4.9% for the fourth quarter; 5.4% growth for fiscal 2025.",
        "date": "1 day ago",
        "image": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQABAAD/2w...",
        "image_base64": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQABAAD/2w...",
        "rank": 3,
        "global_rank": 3
      },
      {
        "title": "How Domino's is trying to double its business during a rough patch for big pizza rivals",
        "link": "https://www.cnbc.com/2026/02/23/dominos-ceo-i-think-we-can-double-this-business.html",
        "source": "CNBC",
        "source_logo": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAABAAAA...",
        "description": "On the heels of a better-than-expected quarter, Domino's Pizza shares rose on Monday. CEO Russell Weiner told CNBC in an interview Monday...",
        "date": "1 day ago",
        "image": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQABAAD/2w...",
        "image_base64": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQABAAD/2w...",
        "rank": 4,
        "global_rank": 4
      },
      {
        "title": "These 13 pizzerias are Pittsburgh’s best, and reflect Western Pa.’s position as a rising pizza powerhouse",
        "link": "https://www.post-gazette.com/life/dining/2026/02/24/best-pizza-pittsburgh-1/stories/202602160047",
        "source": "Pittsburgh Post-Gazette",
        "source_logo": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAABAAAA...",
        "description": "Pittsburgh is in the midst of its most consequential pizza boom since the mass market expansion of the now all-American staple in the...",
        "date": "23 hours ago",
        "image": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQABAAD/2w...",
        "image_base64": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQABAAD/2w...",
        "rank": 5,
        "global_rank": 5
      },
      {
        "title": "Domino's Responds After US Family Orders Pizza At Airport Terminal To Save Money",
        "link": "https://www.ndtv.com/offbeat/dominos-responds-after-us-family-orders-pizza-at-airport-terminal-to-save-money-11132755",
        "source": "NDTV",
        "source_logo": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAABAAAA...",
        "description": "The video of the family receiving their Domino's order at the airport sparked debate on bringing food to the flight.",
        "date": "6 hours ago",
        "image": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQABAAD/2w...",
        "image_base64": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQABAAD/2w...",
        "rank": 6,
        "global_rank": 6
      },
      {
        "title": "Savvy Sliders, Fat Boy’s Pizza co-branded restaurant set to open this week",
        "link": "https://www.21alivenews.com/2026/02/24/savvy-sliders-fat-boys-pizza-co-branded-restaurant-set-open-this-week/",
        "source": "WPTA | 21Alive | Fort Wayne, IN",
        "source_logo": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAABAAAA...",
        "description": "A new co-branded restaurant, featuring Savvy Sliders and Fat Boy's Pizza, is coming to Fort Wayne soon.",
        "date": "9 hours ago",
        "image": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQABAAD/2w...",
        "image_base64": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQABAAD/2w...",
        "rank": 7,
        "global_rank": 7
      },
      {
        "title": "Tasting Table names top 15 pizzerias in Connecticut. Seven of them are in New Haven.",
        "link": "https://www.ctinsider.com/food/article/tasting-table-connecticut-pizza-new-haven-21849051.php",
        "source": "CT Insider",
        "source_logo": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAABAAAA...",
        "description": "Frank Pepe's, Zuppardi's Apizza, Sally's Apizza, Modern Apizza and The Little Rendezvous all made Tasting Table's list of the top 15 pizza...",
        "date": "1 day ago",
        "image": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQABAAD/2w...",
        "image_base64": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQABAAD/2w...",
        "rank": 9,
        "global_rank": 9
      },
      {
        "title": "Lakewood pizza shop closes for good",
        "link": "https://fox8.com/news/lakewood-pizza-shop-closes-for-good/",
        "source": "FOX 8 News",
        "source_logo": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAABAAAA...",
        "description": "LAKEWOOD, Ohio (WJW) – Another Lakewood restaurant has closed shop. Roman Fountain Pizza announced they had served up customers' last slice...",
        "date": "1 day ago",
        "image": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQABAAD/2w...",
        "image_base64": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQABAAD/2w...",
        "rank": 10,
        "global_rank": 10
      },
      {
        "title": "Big Oven Pizza restaurant in Kearny Mesa shot up three times in one week",
        "link": "https://www.10news.com/news/local-news/big-oven-pizza-shot-up-three-times-in-one-week",
        "source": "10News.com",
        "source_logo": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAABAAAA...",
        "description": "SAN DIEGO (KGTV) — Two doors at the front of Big Oven Pizza are boarded up and conspicuous duct tape patches are stuck over bullet holes in...",
        "date": "1 day ago",
        "image": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQABAAD/2w...",
        "image_base64": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQABAAD/2w...",
        "rank": 11,
        "global_rank": 11
      }
    ],
    "pagination": {
      "pages": [
        {
          "page": 2,
          "start": 10,
          "link": "https://www.google.com/search?q=pizza&sca_esv=206cd4dd954885db&gl=US&hl=en&tbm=nws&ei=ELGeab2oNPqq1sQPupiliQs&start=10&sa=N&ved=2ahUKEwi98L2Km_SSAxV6lZUCHTpMKbEQ8tMDegQIBRAE"
        },
        {
          "page": 3,
          "start": 20,
          "link": "https://www.google.com/search?q=pizza&sca_esv=206cd4dd954885db&gl=US&hl=en&tbm=nws&ei=ELGeab2oNPqq1sQPupiliQs&start=20&sa=N&ved=2ahUKEwi98L2Km_SSAxV6lZUCHTpMKbEQ8tMDegQIBRAG"
        },
        {
          "page": 4,
          "start": 30,
          "link": "https://www.google.com/search?q=pizza&sca_esv=206cd4dd954885db&gl=US&hl=en&tbm=nws&ei=ELGeab2oNPqq1sQPupiliQs&start=30&sa=N&ved=2ahUKEwi98L2Km_SSAxV6lZUCHTpMKbEQ8tMDegQIBRAI"
        },
        {
          "page": 5,
          "start": 40,
          "link": "https://www.google.com/search?q=pizza&sca_esv=206cd4dd954885db&gl=US&hl=en&tbm=nws&ei=ELGeab2oNPqq1sQPupiliQs&start=40&sa=N&ved=2ahUKEwi98L2Km_SSAxV6lZUCHTpMKbEQ8tMDegQIBRAK"
        },
        {
          "page": 6,
          "start": 50,
          "link": "https://www.google.com/search?q=pizza&sca_esv=206cd4dd954885db&gl=US&hl=en&tbm=nws&ei=ELGeab2oNPqq1sQPupiliQs&start=50&sa=N&ved=2ahUKEwi98L2Km_SSAxV6lZUCHTpMKbEQ8tMDegQIBRAM"
        },
        {
          "page": 7,
          "start": 60,
          "link": "https://www.google.com/search?q=pizza&sca_esv=206cd4dd954885db&gl=US&hl=en&tbm=nws&ei=ELGeab2oNPqq1sQPupiliQs&start=60&sa=N&ved=2ahUKEwi98L2Km_SSAxV6lZUCHTpMKbEQ8tMDegQIBRAO"
        },
        {
          "page": 8,
          "start": 70,
          "link": "https://www.google.com/search?q=pizza&sca_esv=206cd4dd954885db&gl=US&hl=en&tbm=nws&ei=ELGeab2oNPqq1sQPupiliQs&start=70&sa=N&ved=2ahUKEwi98L2Km_SSAxV6lZUCHTpMKbEQ8tMDegQIBRAQ"
        },
        {
          "page": 9,
          "start": 80,
          "link": "https://www.google.com/search?q=pizza&sca_esv=206cd4dd954885db&gl=US&hl=en&tbm=nws&ei=ELGeab2oNPqq1sQPupiliQs&start=80&sa=N&ved=2ahUKEwi98L2Km_SSAxV6lZUCHTpMKbEQ8tMDegQIBRAS"
        },
        {
          "page": 10,
          "start": 90,
          "link": "https://www.google.com/search?q=pizza&sca_esv=206cd4dd954885db&gl=US&hl=en&tbm=nws&ei=ELGeab2oNPqq1sQPupiliQs&start=90&sa=N&ved=2ahUKEwi98L2Km_SSAxV6lZUCHTpMKbEQ8tMDegQIBRAU"
        }
      ],
      "current_page": 1,
      "next_page": 2,
      "next_page_start": 10,
      "next_page_link": "https://www.google.com/search?q=pizza&sca_esv=206cd4dd954885db&gl=US&hl=en&tbm=nws&ei=ELGeab2oNPqq1sQPupiliQs&start=10&sa=N&ved=2ahUKEwi98L2Km_SSAxV6lZUCHTpMKbEQ8tMDegQIBRAE"
    }
  }
  ```
</ResponseExample>


# Google Search pagination
Source: https://docs.brightdata.com/api-reference/serp/google-search/pagination

Configure the Bright Data Google Search Google Search pagination parameter to refine queries and return matching results as JSON or HTML. On port 44445.

```txt wrap theme={null}
https://www.google.com/search?q=pizza&start=20
```

## Parameters

<ParamField type="string">
  The search query parameter. Specifies the keyword or phrase you want to search for on Google.
</ParamField>

<ParamField type="string">
  Define the result offset - results to start from the selected value. Used for managing pagination.

  ```http theme={null}
  https://www.google.com/search?q=pizza&start=20
  ```
</ParamField>

<ParamField type="string">
  <Warning>
    **Deprecated As of September 11, 2025 by Google**

    * The Number of results to return is usually 10, results' set size may vary.
    * The `start` parameters can be used to paginate within results' set. 
    * To get top 100 results, Bright Data offes a Web Scraping API. Read more here: [Get top google 100 results in one API call](/scraping-automation/serp-api/get-top-100-google-results)
  </Warning>
</ParamField>

<RequestExample>
  ```shell cURL highlight={6} theme={null}
    curl -X POST https://api.brightdata.com/request \
    --header "Content-Type: application/json" \
    --header "Authorization: Bearer API_KEY" \
    --data '{
      "zone": "serp_api1",
      "url": "https://www.google.com/search?q=pizza&start=20",
      "format": "raw"
    }'
  ```

  ```shell Native proxy highlight={4} theme={null}
  curl --proxy brd.superproxy.io:44445 \
    --proxy-user CUSTOMER_USERNAME:CUSTOMER_PASSWORD \
    --ssl-no-revoke \
    "https://www.google.com/search?q=pizza&start=20"
  ```

  ```js Node.js highlight={10} theme={null}
  (async () => {
    const response = await fetch('https://api.brightdata.com/request', {
      method: 'POST',
      headers: {
        'Content-Type': 'application/json',
        'Authorization': 'Bearer API_KEY'
      },
      body: JSON.stringify({
        zone: 'serp_api1',
        url: 'https://www.google.com/search?q=pizza&start=20',
        format: 'raw'
      })
    });
    
    const data = await response.text();
    console.log(data);
  })();
  ```

  ```python Python highlight={11} theme={null}
  import requests

  # API Configuration
  headers = {
      'Content-Type': 'application/json',
      'Authorization': 'Bearer API_KEY',
  }

  payload = {
      'zone': 'serp_api1',
      'url': 'https://www.google.com/search?q=pizza&start=20',
      'format': 'raw'
  }

  # Make the request
  response = requests.post(
      'https://api.brightdata.com/request', 
      json=payload, 
      headers=headers
  )

  print(response.text)
  ```
</RequestExample>

<ResponseExample>
  ```json 200 highlight={16} theme={null}
  {
    "general": {
      "search_engine": "google",
      "query": "pizza",
      "results_cnt": 1190000000,
      "search_time": 0.44,
      "language": "en",
      "location": "United States",
      "mobile": false,
      "basic_view": false,
      "search_type": "text",
      "page_title": "pizza - Google Search",
      "timestamp": "2026-02-25T08:51:55.402Z"
    },
    "input": {
      "original_url": "https://www.google.com/search?q=pizza&start=20&brd_json=1",
      "request_id": "hl_xxxxxxxxxxxxxxx"
    },
    "navigation": [
      {
        "title": "AI Mode",
        "href": "https://www.google.com/search?q=pizza&sca_esv=206cd4dd954885db&gl=US&hl=en&udm=50&fbs=ADc_l-aN0CWEZBOHjofHoaMMDiKpaEWjvZ2Py1XXV8d8KvlI3o6iwGk6Iv1tRbZIBNIVs-4Dki9dynYvfwBVZUSUkihwf6Po1X8vgm-4XqAkWV_U_mSmFfDrYQ3JJnT9pFVWyBg4AncR4kUgE3P9Dn8YQ2qpg4mGYZH3cN0xQoqqXY3iPBHuF6UXBhWnU9Lvfw4ijII1Eq0jCo7w_teMvuVi1Ne_ekoSug&aep=1&ntc=1&sa=X&ved=2ahUKEwiKmo3tofSSAxVF5skDHVHiJsk4FBDYnw56BAgJEAQ"
      },
      {
        "title": "Images",
        "href": "https://www.google.com/search?sca_esv=206cd4dd954885db&gl=US&hl=en&udm=2&fbs=ADc_l-aN0CWEZBOHjofHoaMMDiKpaEWjvZ2Py1XXV8d8KvlI3o6iwGk6Iv1tRbZIBNIVs-4Dki9dynYvfwBVZUSUkihwf6Po1X8vgm-4XqAkWV_U_mSmFfDrYQ3JJnT9pFVWyBg4AncR4kUgE3P9Dn8YQ2qpg4mGYZH3cN0xQoqqXY3iPBHuF6UXBhWnU9Lvfw4ijII1Eq0jCo7w_teMvuVi1Ne_ekoSug&q=pizza&sa=X&ved=2ahUKEwiKmo3tofSSAxVF5skDHVHiJsk4FBC0qAt6BAgLEAE"
      },
      {
        "title": "Shopping",
        "href": "https://www.google.com/search?sca_esv=206cd4dd954885db&gl=US&hl=en&udm=28&fbs=ADc_l-aN0CWEZBOHjofHoaMMDiKpaEWjvZ2Py1XXV8d8KvlI3o6iwGk6Iv1tRbZIBNIVs-4Dki9dynYvfwBVZUSUkihwf6Po1X8vgm-4XqAkWV_U_mSmFfDrYQ3JJnT9pFVWyBg4AncR4kUgE3P9Dn8YQ2qpg4mGYZH3cN0xQoqqXY3iPBHuF6UXBhWnU9Lvfw4ijII1Eq0jCo7w_teMvuVi1Ne_ekoSug&q=pizza&ved=1t:220175&ictx=111"
      },
      {
        "title": "Maps",
        "href": "https://maps.google.com/maps?sca_esv=206cd4dd954885db&gl=US&hl=en&output=search&q=pizza&source=lnms&fbs=ADc_l-aN0CWEZBOHjofHoaMMDiKpaEWjvZ2Py1XXV8d8KvlI3o6iwGk6Iv1tRbZIBNIVs-4Dki9dynYvfwBVZUSUkihwf6Po1X8vgm-4XqAkWV_U_mSmFfDrYQ3JJnT9pFVWyBg4AncR4kUgE3P9Dn8YQ2qpg4mGYZH3cN0xQoqqXY3iPBHuF6UXBhWnU9Lvfw4ijII1Eq0jCo7w_teMvuVi1Ne_ekoSug&entry=mc&ved=1t:200715&ictx=111"
      },
      {
        "title": "Videos",
        "href": "https://www.google.com/search?sca_esv=206cd4dd954885db&gl=US&hl=en&udm=7&fbs=ADc_l-aN0CWEZBOHjofHoaMMDiKpaEWjvZ2Py1XXV8d8KvlI3o6iwGk6Iv1tRbZIBNIVs-4Dki9dynYvfwBVZUSUkihwf6Po1X8vgm-4XqAkWV_U_mSmFfDrYQ3JJnT9pFVWyBg4AncR4kUgE3P9Dn8YQ2qpg4mGYZH3cN0xQoqqXY3iPBHuF6UXBhWnU9Lvfw4ijII1Eq0jCo7w_teMvuVi1Ne_ekoSug&q=pizza&sa=X&ved=2ahUKEwiKmo3tofSSAxVF5skDHVHiJsk4FBC0qAt6BAgQEAE"
      },
      {
        "title": "Short videos",
        "href": "https://www.google.com/search?sca_esv=206cd4dd954885db&gl=US&hl=en&udm=39&fbs=ADc_l-aN0CWEZBOHjofHoaMMDiKpaEWjvZ2Py1XXV8d8KvlI3o6iwGk6Iv1tRbZIBNIVs-4Dki9dynYvfwBVZUSUkihwf6Po1X8vgm-4XqAkWV_U_mSmFfDrYQ3JJnT9pFVWyBg4AncR4kUgE3P9Dn8YQ2qpg4mGYZH3cN0xQoqqXY3iPBHuF6UXBhWnU9Lvfw4ijII1Eq0jCo7w_teMvuVi1Ne_ekoSug&q=pizza&sa=X&ved=2ahUKEwiKmo3tofSSAxVF5skDHVHiJsk4FBCzqAt6BAgOEAE"
      },
      {
        "title": "News",
        "href": "https://www.google.com/search?sca_esv=206cd4dd954885db&gl=US&hl=en&q=pizza&tbm=nws&source=lnms&fbs=ADc_l-aN0CWEZBOHjofHoaMMDiKpaEWjvZ2Py1XXV8d8KvlI3o6iwGk6Iv1tRbZIBNIVs-4Dki9dynYvfwBVZUSUkihwf6Po1X8vgm-4XqAkWV_U_mSmFfDrYQ3JJnT9pFVWyBg4AncR4kUgE3P9Dn8YQ2qpg4mGYZH3cN0xQoqqXY3iPBHuF6UXBhWnU9Lvfw4ijII1Eq0jCo7w_teMvuVi1Ne_ekoSug&sa=X&ved=2ahUKEwiKmo3tofSSAxVF5skDHVHiJsk4FBDSlAl6BAg_EAE"
      },
      {
        "title": "Forums",
        "href": "https://www.google.com/search?sca_esv=206cd4dd954885db&gl=US&hl=en&udm=18&fbs=ADc_l-aN0CWEZBOHjofHoaMMDiKpaEWjvZ2Py1XXV8d8KvlI3o6iwGk6Iv1tRbZIBNIVs-4Dki9dynYvfwBVZUSUkihwf6Po1X8vgm-4XqAkWV_U_mSmFfDrYQ3JJnT9pFVWyBg4AncR4kUgE3P9Dn8YQ2qpg4mGYZH3cN0xQoqqXY3iPBHuF6UXBhWnU9Lvfw4ijII1Eq0jCo7w_teMvuVi1Ne_ekoSug&q=pizza&sa=X&ved=2ahUKEwiKmo3tofSSAxVF5skDHVHiJsk4FBCzqAt6BAg-EAE"
      },
      {
        "title": "Web",
        "href": "https://www.google.com/search?sca_esv=206cd4dd954885db&gl=US&hl=en&udm=web&fbs=ADc_l-aN0CWEZBOHjofHoaMMDiKpaEWjvZ2Py1XXV8d8KvlI3o6iwGk6Iv1tRbZIBNIVs-4Dki9dynYvfwBVZUSUkihwf6Po1X8vgm-4XqAkWV_U_mSmFfDrYQ3JJnT9pFVWyBg4AncR4kUgE3P9Dn8YQ2qpg4mGYZH3cN0xQoqqXY3iPBHuF6UXBhWnU9Lvfw4ijII1Eq0jCo7w_teMvuVi1Ne_ekoSug&q=pizza&sa=X&ved=2ahUKEwiKmo3tofSSAxVF5skDHVHiJsk4FBCzqAt6BAhJEAE"
      },
      {
        "title": "Books",
        "href": "https://www.google.com/search?sca_esv=206cd4dd954885db&gl=US&hl=en&q=pizza&udm=36&source=lnms&fbs=ADc_l-aN0CWEZBOHjofHoaMMDiKpaEWjvZ2Py1XXV8d8KvlI3o6iwGk6Iv1tRbZIBNIVs-4Dki9dynYvfwBVZUSUkihwf6Po1X8vgm-4XqAkWV_U_mSmFfDrYQ3JJnT9pFVWyBg4AncR4kUgE3P9Dn8YQ2qpg4mGYZH3cN0xQoqqXY3iPBHuF6UXBhWnU9Lvfw4ijII1Eq0jCo7w_teMvuVi1Ne_ekoSug&sa=X&ved=2ahUKEwiKmo3tofSSAxVF5skDHVHiJsk4FBDSlAl6BAhKEAE"
      },
      {
        "title": "Pizza",
        "href": "https://www.google.com/search?sca_esv=206cd4dd954885db&gl=US&hl=en&q=Restaurant&uds=ALYpb_ncDc7jTlmw6Mmq7NjuX5c-YkRxG3oIOwBP9pqV8A9knLvLZuH8Ewms8PAcf7ea3t7vBPQw4wVHVJjcROFSOKtHXRR2H_BfQe33fsQJwZ7aPDC6-ok&sa=X&ved=2ahUKEwiKmo3tofSSAxVF5skDHVHiJsk4FBCRzQkoAHoECCYQAQ&ictx=0"
      },
      {
        "title": "Open now",
        "href": "https://www.google.com/search?sca_esv=206cd4dd954885db&gl=US&hl=en&q=pizza+open+now&uds=ALYpb_ncDc7jTlmw6Mmq7NjuX5c-wuWIuHbR2VDKv6da3f4aDvN8AZxA4LGRgSO9dgIm2PykXMFDjhzUYFwURhZ_B2a58YFCPUHvqd_5dUYo1wRb0NtooGKtRpGUYuY9zpbRZ-ECkonaxdRgZHsQ3XflvCSBiBCh_HbnzwOVJT-6OwuTvkFnr4XZJ6m8RkC2Fm5NGv2sorw8NbG_kFTWumCMT5jNTI_TVBcLXVF_mk39-SWhfTOYHMWr9FknOPOs0q-crIBxIW9i8mduwjXgtuXbqR1QMCgDOg&sa=X&ved=2ahUKEwiKmo3tofSSAxVF5skDHVHiJsk4FBDEqwkoAHoECBkQAQ&ictx=0"
      },
      {
        "title": "Top rated",
        "href": "https://www.google.com/search?sca_esv=206cd4dd954885db&gl=US&hl=en&q=top+rated+pizza&uds=ALYpb_ncDc7jTlmw6Mmq7NjuX5c-wuWIuHbR2VDKv6da3f4aDvN8AZxA4LGRgSO9dgIm2PykXMFDjhzUYFwURhZ_B2a58YFCPUHvqd_5dUYo1wRb0NtooGKtRpGUYuY9zpbRZ-FC0ik9p7W40OH-Q3jP-vf-5Mtff03iEnPSzoqB-QNRky0asQGe19T-rLo3j4dKwg9K03-l4Y0aGnO5tf1a_6vVc4NodbwRxARhOPxmdDeRSTUQeoqj_oWiIGPXSF5xIVnZgbShI3syWAnARvf5cPjQCB4EzA&sa=X&ved=2ahUKEwiKmo3tofSSAxVF5skDHVHiJsk4FBDEqwkoAXoECBoQAQ&ictx=0"
      },
      {
        "title": "Cheap",
        "href": "https://www.google.com/search?sca_esv=206cd4dd954885db&gl=US&hl=en&q=cheap+pizza&uds=ALYpb_ncDc7jTlmw6Mmq7NjuX5c-wuWIuHbR2VDKv6da3f4aDvN8AZxA4LGRgSO9dgIm2PykXMFDjhzUYFwURhZ_B2a58YFCPUHvqd_5dUYo1wRb0NtooGKtRpGUYuY9zpbRZ-FwR7YC2iiNfesR7EhVUJV4xMiq-wqZuzQNTXo-ei19eUztSjfyDI5PzqsPvQFzzonTDVZ-bd4RknDhFOA54OC2GPMi_GEtlOI7zpzC12JGNdw2XWsoCTtJOYv0RTO-jC4snE34&sa=X&ved=2ahUKEwiKmo3tofSSAxVF5skDHVHiJsk4FBDEqwkoAnoECB0QAQ&ictx=0"
      },
      {
        "title": "Upscale",
        "href": "https://www.google.com/search?sca_esv=206cd4dd954885db&gl=US&hl=en&q=upscale+pizza&uds=ALYpb_ncDc7jTlmw6Mmq7NjuX5c-wuWIuHbR2VDKv6da3f4aDvN8AZxA4LGRgSO9dgIm2PykXMFDjhzUYFwURhZ_B2a58YFCPUHvqd_5dUYo1wRb0NtooGKtRpGUYuY9zpbRZ-GyVBFHuURJ5r9dsjmlxShj9gOY566k6M_Z8ryTQ2ujcSQU4pktDVdWE_wWsXLjwuvZZ8TWpZWz2H8h3MebldMJbySKoSw54dGEJ1i9mqukLXDANGElFaJbH8b4tFukAHLOpOGZjycO5ZBmhnbyEiUxIH9eqw&sa=X&ved=2ahUKEwiKmo3tofSSAxVF5skDHVHiJsk4FBDEqwkoA3oECCUQAQ&ictx=0"
      },
      {
        "title": "Beer",
        "href": "https://www.google.com/search?sca_esv=206cd4dd954885db&gl=US&hl=en&q=beer+pizza&uds=ALYpb_ncDc7jTlmw6Mmq7NjuX5c-wuWIuHbR2VDKv6da3f4aDvN8AZxA4LGRgSO9dgIm2PykXMFDjhzUYFwURhZ_B2a58YFCPUHvqd_5dUYo1wRb0NtooGKtRpGUYuY9zpbRZ-GvIbMixB_SE227_SwtA5frifagUSkZ0lE6Js6dSDDrQTmZhal5fHlZ1KJQ-Mp1q-L4mcOVynCgmIxX1fMQA9L4RmDQ8bsKHxOYOmHoM4hZveKOVn6PPiwDEUaV7aVpawvkplCMkqhe4z9Yzjko4u_mzkySyvO0VyUpykyhmgMk2t4r7aOjg94bn4YtOsJvg8NW3_Zb&sa=X&ved=2ahUKEwiKmo3tofSSAxVF5skDHVHiJsk4FBDEqwkoBHoECCIQAQ&ictx=0"
      },
      {
        "title": "Wine",
        "href": "https://www.google.com/search?sca_esv=206cd4dd954885db&gl=US&hl=en&q=wine+pizza&uds=ALYpb_ncDc7jTlmw6Mmq7NjuX5c-wuWIuHbR2VDKv6da3f4aDvN8AZxA4LGRgSO9dgIm2PykXMFDjhzUYFwURhZ_B2a58YFCPUHvqd_5dUYo1wRb0NtooGKtRpGUYuY9zpbRZ-Et6sGWmPCsL1NN9TXZF-w4uoXfsF7BGyzoGjhtHxEjJ4rXzxPV3_hCOKn2gcAgKmc_ErzdSBd0areMK5vdiDTt66NSCYOVInN9iNM_T0WxY-J6lQ78Inc5bxYMwpY-xfsdrGuy-BxJc0GPHDESJONClZg0qOkkmSh3jLXVu2QrbUdkyoizZd-qhlWfr2WhaPQtq9yr&sa=X&ved=2ahUKEwiKmo3tofSSAxVF5skDHVHiJsk4FBDEqwkoBXoECEgQAQ&ictx=0"
      },
      {
        "title": "Recently opened",
        "href": "https://www.google.com/search?sca_esv=206cd4dd954885db&gl=US&hl=en&q=recently+opened+pizza&uds=ALYpb_ncDc7jTlmw6Mmq7NjuX5c-wuWIuHbR2VDKv6da3f4aDvN8AZxA4LGRgSO9dgIm2PykXMFDjhzUYFwURhZ_B2a58YFCPUHvqd_5dUYo1wRb0NtooGKtRpGUYuY9zpbRZ-GJ7jIxfTxsLLGw6QUgqkQg1iOvOgLdeSbCK8T9BCWkfYPhP7j3SncII5eeAhM_kso9Q4KSoodhFrjRhpUF01tWJi3v4rElzOAjlMX6CiXuc4UaAvR2BDnWaiT0WsBCdl1PaZc3cX1O_HgkpAqTviw7NVj_aQ&sa=X&ved=2ahUKEwiKmo3tofSSAxVF5skDHVHiJsk4FBDEqwkoBnoECEQQAQ&ictx=0"
      }
    ],
    "organic": [
      {
        "link": "https://www.reddit.com/r/Pizza/comments/1rbx2ud/day_97_of_making_pizza_every_day/",
        "source": "Reddit · r/Pizza",
        "display_link": "90+ comments · 2 days ago",
        "title": "Day 97 of making pizza every day. : r/Pizza",
        "description": "The home of pizza on reddit. An educational community devoted to the art of pizza making. 173K Weekly visitors 4.6K ...",
        "icon": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAABwAAA...",
        "image": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQABAAD/2w...",
        "image_base64": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQABAAD/2w...",
        "duration": "0:40",
        "duration_sec": 40,
        "rank": 1,
        "global_rank": 1
      },
      {
        "link": "https://www.youtube.com/watch?v=h3qO7Jii3BE",
        "source": "YouTube · Vito Iacopelli",
        "display_link": "10.3K+ views · 3 days ago",
        "title": "How To Make Frozen Pizza Bases Ready Anytime at Home",
        "description": "We got frozen bases and we made this lovely pizza in 5 minutes and a home oven. It's soft it's crunchy it's lovely.",
        "icon": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAABAAAA...",
        "image": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQABAAD/2w...",
        "image_base64": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQABAAD/2w...",
        "duration": "10:42",
        "duration_sec": 642,
        "rank": 2,
        "global_rank": 2
      },
      {
        "link": "https://deweyspizza.com/",
        "source": "Dewey's Pizza",
        "display_link": "https://deweyspizza.com",
        "title": "Dewey's Pizza: Home",
        "description": "Bobby Boucher. Cajun Red Sauce, Mozzarella, Caramelized Red Onions, Diced Green Bell Peppers, Andouille Sausage, Blackened Chicken, Celery, Cajun Seasoning, and ...Read more",
        "icon": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAACAAAA...",
        "rank": 3,
        "global_rank": 3
      },
      {
        "link": "https://www.instagram.com/reel/DVJmnFYke-i/",
        "source": "Instagram · calebwsimpson",
        "display_link": "54K+ likes · 1 hour ago",
        "title": "Pizza Review #39 @iansomerhalder",
        "description": "And favorite pizza in New York? I'm going to happier grocery. It is ridiculous. Oh yeah? Could I buy you a slice right now?",
        "icon": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAABwAAA...",
        "image": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQABAAD/2w...",
        "image_base64": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQABAAD/2w...",
        "duration": "2:04",
        "duration_sec": 124,
        "rank": 4,
        "global_rank": 4
      },
      {
        "link": "https://www.reddit.com/r/Costco/comments/1rdzzri/costco_where_to_find_most_perfect_slice_of_cheap/",
        "source": "Reddit · r/Costco",
        "display_link": "230+ comments · 6 hours ago",
        "title": "Costco: Where to find most perfect slice of cheap cheese ...",
        "description": "$1.99 slice of Costco pepperoni pizza is my go-to guilty pleasure lunch. Usually shared with my kids.Read more",
        "snippet_highlighted_words": [
          "Costco pepperoni pizza"
        ],
        "icon": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAABwAAA...",
        "rank": 5,
        "global_rank": 5
      },
      {
        "link": "https://businessinthornton.com/best-of/pizza-restaurants/",
        "source": "businessinthornton.com",
        "display_link": "https://businessinthornton.com › Best of Thornton",
        "title": "Where to get good pizza in Thornton",
        "description": "Whether you're looking for NY-style pizza to go, personalized pan pizzas or specialty pizza with a beer in a pub setting, Thornton has enough variety to let ...Read more",
        "snippet_highlighted_words": [
          "NY-style pizza to go, personalized pan pizzas or specialty pizza with a beer in a pub setting"
        ],
        "extensions": [
          {
            "inline": true,
            "type": "text",
            "text": "Nov 19, 2019",
            "rank": 1
          }
        ],
        "icon": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAABwAAA...",
        "rank": 6,
        "global_rank": 6
      },
      {
        "link": "https://pizzaluce.com/",
        "source": "Pizza Luce",
        "display_link": "https://pizzaluce.com",
        "title": "Pizza Luce: Minnesota's Best Pizza",
        "description": "Handmade gourmet pizza made from fresh ingredients. Vegan, Vegetarian and Gluten Free options. Free Pizza luce delivery, curbside pickup and online ordering ...",
        "snippet_highlighted_words": [
          "Handmade gourmet pizza made from fresh ingredients"
        ],
        "icon": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAABwAAA...",
        "rank": 7,
        "global_rank": 7
      },
      {
        "link": "https://professorpizza.com/",
        "source": "Professor Pizza",
        "display_link": "https://professorpizza.com",
        "title": "Professor Pizza | Chicago's Award Winning Pizza",
        "description": "Professor Pizza brings authentic, chef-crafted Chicago Pizza to life with bold flavors, creative toppings, and classic styles you'll love.",
        "snippet_highlighted_words": [
          "Pizza",
          "Pizza"
        ],
        "icon": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAACAAAA...",
        "rank": 8,
        "global_rank": 8
      },
      {
        "link": "https://pizzarocklasvegas.com/",
        "source": "Pizza Rock Las Vegas",
        "display_link": "https://pizzarocklasvegas.com",
        "title": "Pizza Rock Las Vegas – Gourmet pizzas, hand-crafted artisan ...",
        "description": "Pizza Rock Las Vegas restaurant pairs delicious gourmet pizzas with specialty cocktails from our full-service bar, and an extensive beer & wine menu to ...",
        "snippet_highlighted_words": [
          "Pizza Rock Las Vegas restaurant"
        ],
        "icon": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAABAAAA...",
        "rank": 9,
        "global_rank": 9
      }
    ],
    "images": [
      {
        "original_image": "https://cdn.jwplayer.com/v2/media/1znN8BBx/thumbnails/WmRQ08C1.jpg?width=1280",
        "link": "https://www.allrecipes.com/recipe/20171/quick-and-easy-pizza-crust/",
        "title": "Easy Homemade Pizza Dough",
        "source": "Allrecipes",
        "source_logo": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAABgAAA...",
        "recipe": {
          "rating": 4.7,
          "reviews_cnt": 4141,
          "title": "Easy Homemade Pizza Dough",
          "ingredients": [
            "1 cup warm water (110 degrees F/45 degrees C)",
            "1 (.25 ounce) package active dry yeast",
            "1 teaspoon white sugar",
            "2.5 cups bread flour",
            "2 tablespoons olive oil"
          ],
          "summary": "An easy pizza crust recipe that will hold all your favorite toppings is  simple to make with basic ...",
          "duration": "45 min",
          "duration_sec": 2700,
          "volume": "8"
        },
        "image": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQABAAD/2w...",
        "image_alt": "Easy Homemade Pizza Dough",
        "image_base64": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQABAAD/2w...",
        "rank": 1,
        "global_rank": 10
      },
      {
        "original_image": "https://www.recipetineats.com/tachyon/2023/05/Garlic-cheese-pizza_9.jpg",
        "link": "https://www.recipetineats.com/garlic-cheese-pizza/",
        "title": "Garlic cheese pizza",
        "source": "RecipeTin Eats",
        "source_logo": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAABgAAA...",
        "recipe": {
          "rating": 5,
          "reviews_cnt": 10,
          "title": "Garlic cheese pizza",
          "ingredients": [
            "1 classic pizza dough ((wood-fired Italian style))",
            "1 fast no-yeast pizza dough ((this is excellent!))",
            "1 Store bought",
            "2 tbsp extra virgin olive oil",
            "2 tsp garlic ((2 - 3 large cloves), crushed using garlic press or make  paste using side of knife - Note 2))"
          ],
          "summary": "Recipe video above. No visit to your favourite pizzeria start without  garlic cheese pizza! My best ...",
          "duration": "18 min",
          "duration_sec": 1080,
          "volume": "1"
        },
        "image": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQABAAD/2w...",
        "image_alt": "Garlic cheese pizza",
        "image_base64": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQABAAD/2w...",
        "rank": 2,
        "global_rank": 11
      },
      {
        "original_image": "https://i1.wp.com/colorfulrecipes.com/wp-content/uploads/2020/08/best-pepperoni-pizza-recipe-10.jpg?fit=1200%2C1800&ssl=1",
        "link": "https://colorfulrecipes.com/classic-pepperoni-pizza-recipe/",
        "title": "Classic Pepperoni Pizza Recipe",
        "source": "Colorful Recipes",
        "source_logo": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAABAAAA...",
        "recipe": {
          "title": "Classic Pepperoni Pizza Recipe",
          "ingredients": [
            "Pizza dough",
            "Pizza sauce, 1/2 cup",
            "Mozzarella cheese, 2/3 cup",
            "Dried basil, 1 tsp",
            "Dried oregano, 1 tsp"
          ],
          "summary": "We made this classic pepperoni pizza recipe for the first time a couple of  days ago. Everyone loved ...",
          "duration": "19 min",
          "duration_sec": 1140,
          "volume": "8"
        },
        "image": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQABAAD/2w...",
        "image_alt": "Classic Pepperoni Pizza Recipe",
        "image_base64": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQABAAD/2w...",
        "rank": 3,
        "global_rank": 12
      }
    ],
    "pagination": {
      "pages": [
        {
          "page": 1,
          "start": 0,
          "link": "https://www.google.com/search?q=pizza&sca_esv=206cd4dd954885db&gl=US&hl=en&ei=KrieaYrdEcXMp84P0cSbyQw&start=0&sa=N&ved=2ahUKEwiKmo3tofSSAxVF5skDHVHiJsk4FBDy0wN6BAgMEAQ"
        },
        {
          "page": 2,
          "start": 10,
          "link": "https://www.google.com/search?q=pizza&sca_esv=206cd4dd954885db&gl=US&hl=en&ei=KrieaYrdEcXMp84P0cSbyQw&start=10&sa=N&ved=2ahUKEwiKmo3tofSSAxVF5skDHVHiJsk4FBDy0wN6BAgMEAY"
        },
        {
          "page": 4,
          "start": 30,
          "link": "https://www.google.com/search?q=pizza&sca_esv=206cd4dd954885db&gl=US&hl=en&ei=KrieaYrdEcXMp84P0cSbyQw&start=30&sa=N&ved=2ahUKEwiKmo3tofSSAxVF5skDHVHiJsk4FBDy0wN6BAgMEAk"
        }
      ],
      "current_page": 3,
      "next_page": 4,
      "next_page_start": 30,
      "next_page_link": "https://www.google.com/search?q=pizza&sca_esv=206cd4dd954885db&gl=US&hl=en&ei=KrieaYrdEcXMp84P0cSbyQw&start=30&sa=N&ved=2ahUKEwiKmo3tofSSAxVF5skDHVHiJsk4FBDy0wN6BAgMEAk"
    },
    "related": [
      {
        "text": "Pizza Hut near me",
        "link": "https://www.google.com/search?sca_esv=206cd4dd954885db&gl=US&hl=en&q=Pizza+Hut+near+me&sa=X&ved=2ahUKEwiKmo3tofSSAxVF5skDHVHiJsk4FBDVAnoECDEQAQ",
        "rank": 1,
        "global_rank": 13
      },
      {
        "text": "Pizza Hut menu",
        "link": "https://www.google.com/search?sca_esv=206cd4dd954885db&gl=US&hl=en&q=Pizza+Hut+menu&sa=X&ved=2ahUKEwiKmo3tofSSAxVF5skDHVHiJsk4FBDVAnoECDYQAQ",
        "rank": 2,
        "global_rank": 14
      },
      {
        "text": "Pizza definition",
        "link": "https://www.google.com/search?sca_esv=206cd4dd954885db&gl=US&hl=en&q=Pizza+definition&sa=X&ved=2ahUKEwiKmo3tofSSAxVF5skDHVHiJsk4FBDVAnoECDUQAQ",
        "rank": 3,
        "global_rank": 15
      },
      {
        "text": "Pizza open",
        "link": "https://www.google.com/search?sca_esv=206cd4dd954885db&gl=US&hl=en&q=Pizza+open&sa=X&ved=2ahUKEwiKmo3tofSSAxVF5skDHVHiJsk4FBDVAnoECDAQAQ",
        "rank": 4,
        "global_rank": 16
      },
      {
        "text": "Pizza Boys",
        "link": "https://www.google.com/search?sca_esv=206cd4dd954885db&gl=US&hl=en&q=Pizza+Boys&sa=X&ved=2ahUKEwiKmo3tofSSAxVF5skDHVHiJsk4FBDVAnoECDQQAQ",
        "rank": 5,
        "global_rank": 17
      },
      {
        "text": "Pizza delivery",
        "link": "https://www.google.com/search?sca_esv=206cd4dd954885db&gl=US&hl=en&q=Pizza+delivery&sa=X&ved=2ahUKEwiKmo3tofSSAxVF5skDHVHiJsk4FBDVAnoECDIQAQ",
        "rank": 6,
        "global_rank": 18
      },
      {
        "text": "Pizza Papa Johns",
        "link": "https://www.google.com/search?sca_esv=206cd4dd954885db&gl=US&hl=en&q=Pizza+Papa+Johns&sa=X&ved=2ahUKEwiKmo3tofSSAxVF5skDHVHiJsk4FBDVAnoECDMQAQ",
        "rank": 7,
        "global_rank": 19
      },
      {
        "text": "Pizza Marco's",
        "link": "https://www.google.com/search?sca_esv=206cd4dd954885db&gl=US&hl=en&q=Pizza+Marco%27s&sa=X&ved=2ahUKEwiKmo3tofSSAxVF5skDHVHiJsk4FBDVAnoECC8QAQ",
        "rank": 8,
        "global_rank": 20
      }
    ],
    "oragnic": [
      {
        "link": "https://www.reddit.com/r/Pizza/comments/1rbx2ud/day_97_of_making_pizza_every_day/",
        "source": "Reddit · r/Pizza",
        "display_link": "90+ comments · 2 days ago",
        "title": "Day 97 of making pizza every day. : r/Pizza",
        "description": "The home of pizza on reddit. An educational community devoted to the art of pizza making. 173K Weekly visitors 4.6K ...",
        "icon": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAABwAAA...",
        "image": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQABAAD/2w...",
        "image_base64": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQABAAD/2w...",
        "duration": "0:40",
        "duration_sec": 40,
        "rank": 1,
        "global_rank": 1
      },
      {
        "link": "https://www.youtube.com/watch?v=h3qO7Jii3BE",
        "source": "YouTube · Vito Iacopelli",
        "display_link": "10.3K+ views · 3 days ago",
        "title": "How To Make Frozen Pizza Bases Ready Anytime at Home",
        "description": "We got frozen bases and we made this lovely pizza in 5 minutes and a home oven. It's soft it's crunchy it's lovely.",
        "icon": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAABAAAA...",
        "image": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQABAAD/2w...",
        "image_base64": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQABAAD/2w...",
        "duration": "10:42",
        "duration_sec": 642,
        "rank": 2,
        "global_rank": 2
      },
      {
        "link": "https://deweyspizza.com/",
        "source": "Dewey's Pizza",
        "display_link": "https://deweyspizza.com",
        "title": "Dewey's Pizza: Home",
        "description": "Bobby Boucher. Cajun Red Sauce, Mozzarella, Caramelized Red Onions, Diced Green Bell Peppers, Andouille Sausage, Blackened Chicken, Celery, Cajun Seasoning, and ...Read more",
        "icon": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAACAAAA...",
        "rank": 3,
        "global_rank": 3
      }
    ]
  }
  ```
</ResponseExample>


# Google Search parsed JSON
Source: https://docs.brightdata.com/api-reference/serp/google-search/parsed-json

Configure the Bright Data Google Search Google Search parsed JSON parameter to refine queries and return matching results as JSON or HTML. On port 44445.

```txt wrap theme={null}
https://www.google.com/search?q=pizza&brd_json=json
```

## Parameters

<ParamField type="string">
  The search query parameter. Specifies the keyword or phrase you want to search for on Google.
</ParamField>

<ParamField type="string">
  Set the `brd_json` parameter to `json` to get the results in JSON format.

  ```txt wrap theme={null}
  https://www.google.com/search?q=pizza&brd_json=json
  ```

  | value            | description                                                                                                         |
  | ---------------- | ------------------------------------------------------------------------------------------------------------------- |
  | `html` (default) | Returns the standard HTML response from Google Maps.                                                                |
  | `json`           | Returns the search results in a structured JSON format, making it easier to parse and extract specific data points. |
</ParamField>

<RequestExample>
  ```shell cURL highlight={6} theme={null}
    curl -X POST https://api.brightdata.com/request \
    --header "Content-Type: application/json" \
    --header "Authorization: Bearer API_KEY" \
    --data '{
      "zone": "serp_api1",
      "url": "https://www.google.com/search?q=pizza&brd_json=json",
      "format": "raw"
    }'
  ```

  ```shell Native proxy highlight={4} theme={null}
  curl --proxy brd.superproxy.io:44445 \
    --proxy-user CUSTOMER_USERNAME:CUSTOMER_PASSWORD \
    --ssl-no-revoke \
    "https://www.google.com/search?q=pizza&brd_json=json"
  ```

  ```js Node.js highlight={10} theme={null}
  (async () => {
    const response = await fetch('https://api.brightdata.com/request', {
      method: 'POST',
      headers: {
        'Content-Type': 'application/json',
        'Authorization': 'Bearer API_KEY'
      },
      body: JSON.stringify({
        zone: 'serp_api1',
        url: 'https://www.google.com/search?q=pizza&brd_json=json',
        format: 'raw'
      })
    });
    
    const data = await response.text();
    console.log(data);
  })();
  ```

  ```python Python highlight={11} theme={null}
  import requests

  # API Configuration
  headers = {
      'Content-Type': 'application/json',
      'Authorization': 'Bearer API_KEY',
  }

  payload = {
      'zone': 'serp_api1',
      'url': 'https://www.google.com/search?q=pizza&brd_json=json',
      'format': 'raw'
  }

  # Make the request
  response = requests.post(
      'https://api.brightdata.com/request', 
      json=payload, 
      headers=headers
  )

  print(response.text)
  ```
</RequestExample>

<ResponseExample>
  ```json 200 highlight={4} theme={null}
  {
    "general": {
      "search_engine": "google",
      "query": "pizza",
      "results_cnt": 973000000,
      "search_time": 0.46,
      "language": "en-FR",
      "country": "France",
      "country_code": "FR",
      "location": "United States",
      "gl": "FR",
      "mobile": false,
      "basic_view": false,
      "search_type": "text",
      "page_title": "pizza - Google Search",
      "timestamp": "2026-02-24T20:05:07.171Z"
    },
    "input": {
      "original_url": "https://www.google.com/search?q=pizza&brd_json=1",
      "request_id": "hl_xxxxxxxxxxxxxxx"
    },
    "navigation": [
      {
        "title": "Images",
        "href": "https://www.google.com/search?sca_esv=016f34706b28a015&hl=en&udm=2&fbs=ADc_l-aN0CWEZBOHjofHoaMMDiKpaEWjvZ2Py1XXV8d8KvlI3vWUtYx0DZdicpfE1faGYenqWn-q4MFiFFtvJjTKeAVxZj_-zzAfU38gMel7zJW-zoNwHG-ArsO6TrTEJcFsob0pdGO2ABo8o_HC5yJWwFB_-GDw4ME9hn952oqoD4-m1e6t3rE&q=pizza&sa=X&ved=2ahUKEwjh3oW59vKSAxV4bKQEHd32ALEQtKgLegQIHxAB"
      },
      {
        "title": "Videos",
        "href": "https://www.google.com/search?sca_esv=016f34706b28a015&hl=en&udm=7&fbs=ADc_l-aN0CWEZBOHjofHoaMMDiKpaEWjvZ2Py1XXV8d8KvlI3vWUtYx0DZdicpfE1faGYenqWn-q4MFiFFtvJjTKeAVxZj_-zzAfU38gMel7zJW-zoNwHG-ArsO6TrTEJcFsob0pdGO2ABo8o_HC5yJWwFB_-GDw4ME9hn952oqoD4-m1e6t3rE&q=pizza&sa=X&ved=2ahUKEwjh3oW59vKSAxV4bKQEHd32ALEQtKgLegQIHhAB"
      },
      {
        "title": "Short videos",
        "href": "https://www.google.com/search?sca_esv=016f34706b28a015&hl=en&udm=39&fbs=ADc_l-aN0CWEZBOHjofHoaMMDiKpaEWjvZ2Py1XXV8d8KvlI3vWUtYx0DZdicpfE1faGYenqWn-q4MFiFFtvJjTKeAVxZj_-zzAfU38gMel7zJW-zoNwHG-ArsO6TrTEJcFsob0pdGO2ABo8o_HC5yJWwFB_-GDw4ME9hn952oqoD4-m1e6t3rE&q=pizza&sa=X&ved=2ahUKEwjh3oW59vKSAxV4bKQEHd32ALEQs6gLegQIGhAB"
      },
      {
        "title": "News",
        "href": "https://www.google.com/search?sca_esv=016f34706b28a015&hl=en&q=pizza&tbm=nws&source=lnms&fbs=ADc_l-aN0CWEZBOHjofHoaMMDiKpaEWjvZ2Py1XXV8d8KvlI3vWUtYx0DZdicpfE1faGYenqWn-q4MFiFFtvJjTKeAVxZj_-zzAfU38gMel7zJW-zoNwHG-ArsO6TrTEJcFsob0pdGO2ABo8o_HC5yJWwFB_-GDw4ME9hn952oqoD4-m1e6t3rE&sa=X&ved=2ahUKEwjh3oW59vKSAxV4bKQEHd32ALEQ0pQJegQIGBAB"
      },
      {
        "title": "Web",
        "href": "https://www.google.com/search?sca_esv=016f34706b28a015&hl=en&udm=web&fbs=ADc_l-aN0CWEZBOHjofHoaMMDiKpaEWjvZ2Py1XXV8d8KvlI3vWUtYx0DZdicpfE1faGYenqWn-q4MFiFFtvJjTKeAVxZj_-zzAfU38gMel7zJW-zoNwHG-ArsO6TrTEJcFsob0pdGO2ABo8o_HC5yJWwFB_-GDw4ME9hn952oqoD4-m1e6t3rE&q=pizza&sa=X&ved=2ahUKEwjh3oW59vKSAxV4bKQEHd32ALEQs6gLegQIFxAB"
      },
      {
        "title": "Books",
        "href": "https://www.google.com/search?sca_esv=016f34706b28a015&hl=en&q=pizza&udm=36&source=lnms&fbs=ADc_l-aN0CWEZBOHjofHoaMMDiKpaEWjvZ2Py1XXV8d8KvlI3vWUtYx0DZdicpfE1faGYenqWn-q4MFiFFtvJjTKeAVxZj_-zzAfU38gMel7zJW-zoNwHG-ArsO6TrTEJcFsob0pdGO2ABo8o_HC5yJWwFB_-GDw4ME9hn952oqoD4-m1e6t3rE&sa=X&ved=2ahUKEwjh3oW59vKSAxV4bKQEHd32ALEQ0pQJegQIFhAB"
      },
      {
        "title": "Finance",
        "href": "https://www.google.com/finance?sca_esv=016f34706b28a015&hl=en&output=search&q=pizza&source=lnms&fbs=ADc_l-aN0CWEZBOHjofHoaMMDiKpaEWjvZ2Py1XXV8d8KvlI3vWUtYx0DZdicpfE1faGYenqWn-q4MFiFFtvJjTKeAVxZj_-zzAfU38gMel7zJW-zoNwHG-ArsO6TrTEJcFsob0pdGO2ABo8o_HC5yJWwFB_-GDw4ME9hn952oqoD4-m1e6t3rE&sa=X&ved=2ahUKEwjh3oW59vKSAxV4bKQEHd32ALEQ0pQJegQIexAB"
      }
    ],
    "organic": [
      {
        "link": "https://fr.wikipedia.org/wiki/Pizza",
        "source": "Wikipédia",
        "display_link": "https://fr.wikipedia.org › wiki › Pi...",
        "title": "Pizza",
        "description": "La pizza est une recette de cuisine traditionnelle de la cuisine italienne, originaire de Naples à base de galette de pâte à pain, garnie principalement ...Read more",
        "snippet_highlighted_words": [
          "pizza"
        ],
        "icon": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAABwAAA...",
        "image": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQABAAD/2w...",
        "image_alt": "pizza from fr.wikipedia.org",
        "image_base64": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQABAAD/2w...",
        "rank": 1,
        "global_rank": 1
      },
      {
        "link": "https://www.marmiton.org/recettes/recette_pizza-maison_313213.aspx",
        "source": "Marmiton",
        "display_link": "https://www.marmiton.org › recettes",
        "title": "Recette de Pizza maison",
        "description": "Partager la recette · Étape 1. Dans un saladier, placez les 300 g de farine, puis la levure, puis le bicarbonate de soude, la pincée de sel et celle de poivre.Read more",
        "extensions": [
          {
            "type": "rating",
            "rating": 5,
            "reviews_cnt": 23,
            "rank": 1
          }
        ],
        "icon": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAABwAAA...",
        "rank": 2,
        "global_rank": 2
      },
      {
        "link": "https://cuisine.journaldesfemmes.fr/recette-pizza",
        "source": "Journal des Femmes",
        "display_link": "https://cuisine.journaldesfemmes.fr › ...",
        "title": "Pizza maison : recettes faciles et savoureuses",
        "description": "Pizza : Meilleures recettes · Pizza chèvre, figues, pistaches et miel · Pizza blanche au saumon fumé et à la cancoillotte · Pizza au salami de Milano et chorizo.Read more",
        "snippet_highlighted_words": [
          "Pizza",
          "Pizza",
          "Pizza",
          "Pizza"
        ],
        "extensions": [
          {
            "type": "rating",
            "rating": 4.3,
            "reviews_cnt": 96,
            "rank": 1
          }
        ],
        "icon": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAABwAAA...",
        "rank": 3,
        "global_rank": 3
      },
      {
        "link": "https://www.pizzahut.fr/",
        "source": "Pizza Hut",
        "display_link": "https://www.pizzahut.fr",
        "title": "Pizza Hut Livraison, vente à emporter | Commande en ligne ...",
        "description": "Pizza Hut Livraison, vente à emporter | Commande en ligne | Coupons, Promos.",
        "snippet_highlighted_words": [
          "Pizza"
        ],
        "icon": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAABwAAA...",
        "rank": 4,
        "global_rank": 4
      },
      {
        "link": "https://www.dominos.fr/",
        "source": "Domino's Pizza",
        "display_link": "https://www.dominos.fr",
        "title": "Domino's Pizza, livraison et à emporter, commande en ligne",
        "description": "Commandez vos pizzas en ligne en livraison ou à emporter dans votre pizzeria Domino's la plus proche et dégustez-les en famille ou avec vos amis.",
        "snippet_highlighted_words": [
          "pizzas",
          "pizzeria"
        ],
        "icon": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAABAAAA...",
        "image": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcTCf5qNZRvb7AOasK4bkZVf43P-y-6lDa_eBaxgXGw3BuqKmU5ictBb&usqp=CAE&s",
        "image_alt": "pizza from www.dominos.fr",
        "image_url": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcTCf5qNZRvb7AOasK4bkZVf43P-y-6lDa_eBaxgXGw3BuqKmU5ictBb&usqp=CAE&s",
        "rank": 5,
        "global_rank": 9
      },
      {
        "link": "https://www.galbani.fr/recettes/pizza",
        "source": "Galbani",
        "display_link": "https://www.galbani.fr › recettes",
        "title": "Recettes de Pizza à l'italienne et revisitées",
        "description": "Choisissez parmi nos nombreuses recettes de pizza vos préférées et savourez en famille ou entre amis de délicieux plat à l'italienne. Simple, rapide et bon ...",
        "snippet_highlighted_words": [
          "pizza"
        ],
        "icon": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAABwAAA...",
        "rank": 6,
        "global_rank": 10
      },
      {
        "link": "https://www.pizzapapa.fr/blog/origine-pizza/",
        "source": "pizzapapa.fr",
        "display_link": "https://www.pizzapapa.fr › blog",
        "title": "Qui a inventé la pizza ? Histoire & origine de la pizza",
        "description": "Actuellement, la pizza est une recette emblématique de la cuisine italienne qui s'est internationalisée avec l'immigration.Read more",
        "snippet_highlighted_words": [
          "pizza"
        ],
        "extensions": [
          {
            "inline": true,
            "type": "text",
            "text": "26 Sept 2025",
            "rank": 1
          }
        ],
        "icon": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAACAAAA...",
        "rank": 7,
        "global_rank": 11
      },
      {
        "link": "https://lacuisinedannie.20minutes.fr/recette-pate-a-pizza-234.html",
        "source": "La Cuisine d'Annie",
        "display_link": "https://lacuisinedannie.20minutes.fr › ...",
        "title": "Recette Pâte à pizza",
        "description": "Recette Pâte à pizza. Recette de Pains et pâtes de base, Pâtes de base pour 6 personnes. Le temps de préparation est de 15 min. La Cuisine d'Annie regroupe ...",
        "snippet_highlighted_words": [
          "pizza"
        ],
        "extensions": [
          {
            "type": "rating",
            "rating": 5,
            "reviews_cnt": 381,
            "rank": 1
          }
        ],
        "icon": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAABwAAA...",
        "rank": 8,
        "global_rank": 12
      },
      {
        "link": "https://www.picard.fr/rayons/pizzas-et-tartes/pizzas",
        "source": "Picard",
        "display_link": "https://www.picard.fr › rayons › p...",
        "title": "Livraison de Pizzas surgelées à domicile",
        "description": "Découvrez toutes nos pizzas surgelées Picard : les pizzas traditionnelles, bio ou végétariennes sont disponibles dans tous les magasins Picard, ...",
        "snippet_highlighted_words": [
          "pizzas",
          "pizzas"
        ],
        "icon": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAABwAAA...",
        "rank": 9,
        "global_rank": 13
      }
    ],
    "knowledge": {
      "name": "Pizza",
      "summary": "Dish",
      "subtitle": "Dish",
      "description": "Pizza is an Italian dish typically consisting of a flat base of leavened wheat-based dough topped with tomato, cheese, and other ingredients, baked at a high temperature, traditionally in a wood-fired oven.",
      "description_source": "Wikipedia",
      "description_link": "https://en.wikipedia.org/wiki/Pizza",
      "images": [
        {
          "image": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQABAAD/2w...",
          "image_alt": "Image of Homemade Pizza Recipe: How to Make It",
          "image_base64": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQABAAD/2w..."
        },
        {
          "image": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQABAAD/2w...",
          "image_alt": "Image of Pizza maison à la friteuse à air – Parfaitement ...",
          "image_base64": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQABAAD/2w..."
        },
        {
          "image": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQABAAD/2w...",
          "image_alt": "Image of Tomato and Mozzarella Pizza Recipe",
          "image_base64": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQABAAD/2w..."
        }
      ],
      "facts": [
        {
          "key": "Origin",
          "predicate": "hw:/collection/dishes:origin",
          "value": [
            {
              "text": "Italy",
              "link": "https://www.google.com/search?sca_esv=016f34706b28a015&hl=en&q=Italy&si=AL3DRZHmwLjWhgnaPB3UTu10R6S5qNLXiQiKMeezfKyB1FMsRgvMc15_a-XCDquvg02EcLVCDOBlFWcyGM1h_GEvApLCUHB4TbGV9DLLN_L5HXDRSM_AM0JjmkKGPEEkyRjAEOMkP_wbp9U4-YKGn63yz0_QGqKXGf1bKFT4vVVVz2XMsjUuOZt4AnSHQk-nDBQE0oBKvh4m&sa=X&ved=2ahUKEwjh3oW59vKSAxV4bKQEHd32ALEQmxN6BAgQEAI"
            }
          ]
        }
      ],
      "nutrition_facts": {
        "product": "Pizza, 14\" regular crust",
        "source": "USDA",
        "source_link": "https://fdc.nal.usda.gov/food-details/173292/nutrients",
        "calories": "266 Calories",
        "portion": "100 grams"
      }
    },
    "overview": {
      "title": "Pizza",
      "kgmid": "/m/0663v"
    },
    "pagination": [
      {
        "page": 2,
        "start": 10,
        "link": "https://www.google.com/search?q=pizza&sca_esv=016f34706b28a015&hl=en&ei=bgSeaeHvJ_jYkdUP3e2DiAs&start=10&sa=N&sstk=Af77f_f_V2-MUys3284KigNlKSrRMuK2FycXBqPmoWealtPGblbQ6fG6nmOOnuTsIXX5La3IjQVKZgmp72693C-TVdrhH0fPkJks7A&ved=2ahUKEwjh3oW59vKSAxV4bKQEHd32ALEQ8tMDegQICBAE"
      },
      {
        "page": 3,
        "start": 20,
        "link": "https://www.google.com/search?q=pizza&sca_esv=016f34706b28a015&hl=en&ei=bgSeaeHvJ_jYkdUP3e2DiAs&start=20&sa=N&sstk=Af77f_f_V2-MUys3284KigNlKSrRMuK2FycXBqPmoWealtPGblbQ6fG6nmOOnuTsIXX5La3IjQVKZgmp72693C-TVdrhH0fPkJks7A&ved=2ahUKEwjh3oW59vKSAxV4bKQEHd32ALEQ8tMDegQICBAG"
      },
      {
        "page": 4,
        "start": 30,
        "link": "https://www.google.com/search?q=pizza&sca_esv=016f34706b28a015&hl=en&ei=bgSeaeHvJ_jYkdUP3e2DiAs&start=30&sa=N&sstk=Af77f_f_V2-MUys3284KigNlKSrRMuK2FycXBqPmoWealtPGblbQ6fG6nmOOnuTsIXX5La3IjQVKZgmp72693C-TVdrhH0fPkJks7A&ved=2ahUKEwjh3oW59vKSAxV4bKQEHd32ALEQ8tMDegQICBAI"
      }
    ],
    "related": [
      {
        "text": "Pizza recette",
        "link": "https://www.google.com/search?sca_esv=016f34706b28a015&hl=en&q=Pizza+recette&sa=X&ved=2ahUKEwjh3oW59vKSAxV4bKQEHd32ALEQ1QJ6BAhLEAE",
        "rank": 1,
        "global_rank": 14
      },
      {
        "text": "Pizza Hut",
        "link": "https://www.google.com/search?sca_esv=016f34706b28a015&hl=en&q=Pizza+Hut&sa=X&ved=2ahUKEwjh3oW59vKSAxV4bKQEHd32ALEQ1QJ6BAhhEAE",
        "rank": 2,
        "global_rank": 15
      },
      {
        "text": "Pizza Yolo",
        "link": "https://www.google.com/search?sca_esv=016f34706b28a015&hl=en&q=Pizza+Yolo&sa=X&ved=2ahUKEwjh3oW59vKSAxV4bKQEHd32ALEQ1QJ6BAhgEAE",
        "rank": 3,
        "global_rank": 16
      }
    ],
    "people_also_ask": [
      {
        "question": "Quel ingrédient mettre sur une pizza ?",
        "question_link": "https://www.jesuisgastronome.fr/actu/273/la-liste-des-quinze-meilleurs-ingredients-pour-une-pizza",
        "question_type": "featured",
        "answer_source": "JeSuisGastronome.fr",
        "answer_link": "https://www.jesuisgastronome.fr/actu/273/la-liste-des-quinze-meilleurs-ingredients-pour-une-pizza",
        "answer_display_link": "https://www.jesuisgastronome.fr › actu › la-liste-des-quin...https://www.jesuisgastronome.fr › actu › la-liste-des-quin...",
        "answers": [
          {
            "type": "unordered_list",
            "title": "La liste des quinze meilleurs ingrédients pour une pizza",
            "items": [
              {
                "value": "- Le mozzarella fondant.",
                "rank": 1
              },
              {
                "value": "- La fraîcheur du basilic.",
                "rank": 2
              },
              {
                "value": "- L'authentique jambon de Parme.",
                "rank": 3
              },
              {
                "value": "- Le piquant des olives noires.",
                "rank": 4
              },
              {
                "value": "- Apprécier l'anchois salé",
                "rank": 5
              },
              {
                "value": "- Déguster les champignons frais.",
                "rank": 6
              },
              {
                "value": "- Aimer la roquette croquante.",
                "rank": 7
              },
              {
                "value": "- Savourer le saucisson épicé",
                "rank": 8
              }
            ],
            "rank": 1
          }
        ],
        "rank": 1,
        "global_rank": 5
      }
    ],
    "oragnic": [
      {
        "link": "https://fr.wikipedia.org/wiki/Pizza",
        "source": "Wikipédia",
        "display_link": "https://fr.wikipedia.org › wiki › Pi...",
        "title": "Pizza",
        "description": "La pizza est une recette de cuisine traditionnelle de la cuisine italienne, originaire de Naples à base de galette de pâte à pain, garnie principalement ...Read more",
        "snippet_highlighted_words": [
          "pizza"
        ],
        "icon": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAABwAAA...",
        "image": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQABAAD/2w...",
        "image_alt": "pizza from fr.wikipedia.org",
        "image_base64": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQABAAD/2w...",
        "rank": 1,
        "global_rank": 1
      },
      {
        "link": "https://www.marmiton.org/recettes/recette_pizza-maison_313213.aspx",
        "source": "Marmiton",
        "display_link": "https://www.marmiton.org › recettes",
        "title": "Recette de Pizza maison",
        "description": "Partager la recette · Étape 1. Dans un saladier, placez les 300 g de farine, puis la levure, puis le bicarbonate de soude, la pincée de sel et celle de poivre.Read more",
        "extensions": [
          {
            "type": "rating",
            "rating": 5,
            "reviews_cnt": 23,
            "rank": 1
          }
        ],
        "icon": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAABwAAA...",
        "rank": 2,
        "global_rank": 2
      },
      {
        "link": "https://cuisine.journaldesfemmes.fr/recette-pizza",
        "source": "Journal des Femmes",
        "display_link": "https://cuisine.journaldesfemmes.fr › ...",
        "title": "Pizza maison : recettes faciles et savoureuses",
        "description": "Pizza : Meilleures recettes · Pizza chèvre, figues, pistaches et miel · Pizza blanche au saumon fumé et à la cancoillotte · Pizza au salami de Milano et chorizo.Read more",
        "snippet_highlighted_words": [
          "Pizza",
          "Pizza",
          "Pizza",
          "Pizza"
        ],
        "extensions": [
          {
            "type": "rating",
            "rating": 4.3,
            "reviews_cnt": 96,
            "rank": 1
          }
        ],
        "icon": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAABwAAA...",
        "rank": 3,
        "global_rank": 3
      }
    ]
  }
  ```
</ResponseExample>


# Search by image
Source: https://docs.brightdata.com/api-reference/serp/google-search/search-by-image

Configure the Bright Data Google Search Search by Image parameter to refine queries and return matching results as JSON or HTML. On port 44445.

```txt wrap theme={null}
https://www.google.com/searchbyimage?image_url=https%3A%2F%2Flive.staticflickr.com%2F213%2F491726079_4f46636859_w.jpg&download=1
```

## Parameters

<ParamField type="string">
  The URL of the image to use for the reverse image search.

  ```txt wrap theme={null}
  https://www.google.com/searchbyimage?image_url=https%3A%2F%2Flive.staticflickr.com%2F213%2F491726079_4f46636859_w.jpg
  ```
</ParamField>

<ParamField type="string">
  Download image on the proxy side and post it to google using POST request

  > **Default behavior:** download-and-post if google isn't able to download the image

  | Value        | Description                            |
  | ------------ | -------------------------------------- |
  | `download=1` | Force download-and-post image          |
  | `download=0` | Use regular GET request with image URL |

  ```txt wrap theme={null}
  https://www.google.com/searchbyimage?image_url=https%3A%2F%2Flive.staticflickr.com%2F213%2F491726079_4f46636859_w.jpg&download=1
  ```
</ParamField>

<RequestExample>
  ```shell cURL highlight={6} theme={null}
    curl -X POST https://api.brightdata.com/request \
    --header "Content-Type: application/json" \
    --header "Authorization: Bearer API_KEY" \
    --data '{
      "zone": "serp_api1",
      "url": "https://www.google.com/searchbyimage?image_url=https%3A%2F%2Flive.staticflickr.com%2F213%2F491726079_4f46636859_w.jpg&download=1",
      "format": "raw"
    }'
  ```

  ```shell Native proxy highlight={4} theme={null}
  curl --proxy brd.superproxy.io:44445 \
    --proxy-user CUSTOMER_USERNAME:CUSTOMER_PASSWORD \
    --ssl-no-revoke \
    "https://www.google.com/searchbyimage?image_url=https%3A%2F%2Flive.staticflickr.com%2F213%2F491726079_4f46636859_w.jpg&download=1"
  ```

  ```js Node.js highlight={10} theme={null}
  (async () => {
    const response = await fetch('https://api.brightdata.com/request', {
      method: 'POST',
      headers: {
        'Content-Type': 'application/json',
        'Authorization': 'Bearer API_KEY'
      },
      body: JSON.stringify({
        zone: 'serp_api1',
        url: 'https://www.google.com/searchbyimage?image_url=https%3A%2F%2Flive.staticflickr.com%2F213%2F491726079_4f46636859_w.jpg&download=1',
        format: 'raw'
      })
    });
    
    const data = await response.text();
    console.log(data);
  })();
  ```

  ```python Python highlight={11} theme={null}
  import requests

  # API Configuration
  headers = {
      'Content-Type': 'application/json',
      'Authorization': 'Bearer API_KEY',
  }

  payload = {
      'zone': 'serp_api1',
      'url': 'https://www.google.com/searchbyimage?image_url=https%3A%2F%2Flive.staticflickr.com%2F213%2F491726079_4f46636859_w.jpg&download=1',
      'format': 'raw'
  }

  # Make the request
  response = requests.post(
      'https://api.brightdata.com/request', 
      json=payload, 
      headers=headers
  )

  print(response.text)
  ```
</RequestExample>


# Shopping search
Source: https://docs.brightdata.com/api-reference/serp/google-search/shopping

Configure the Bright Data Google Search Shopping Search parameter to refine queries and return matching results as JSON or HTML. On port 44445.

```http theme={null}
https://www.google.com/search?q=pizza&tbm=shop
```

## Parameters

<ParamField type="string">
  The search query parameter. Specifies the keyword or phrase you want to search for on Google.
</ParamField>

<ParamField type="string">
  Define search type. For Shopping search, set `tbm` value to `shop`.

  ```http theme={null}
  https://www.google.com/search?q=pizza&tbm=shop
  ```
</ParamField>

<RequestExample>
  ```shell cURL highlight={6} theme={null}
    curl -X POST https://api.brightdata.com/request \
    --header "Content-Type: application/json" \
    --header "Authorization: Bearer API_KEY" \
    --data '{
      "zone": "serp_api1",
      "url": "https://www.google.com/search?q=pizza&tbm=shop",
      "format": "raw"
    }'
  ```

  ```shell Native proxy highlight={4} theme={null}
  curl --proxy brd.superproxy.io:44445 \
    --proxy-user CUSTOMER_USERNAME:CUSTOMER_PASSWORD \
    --ssl-no-revoke \
    "https://www.google.com/search?q=pizza&tbm=shop"
  ```

  ```js Node.js highlight={10} theme={null}
  (async () => {
    const response = await fetch('https://api.brightdata.com/request', {
      method: 'POST',
      headers: {
        'Content-Type': 'application/json',
        'Authorization': 'Bearer API_KEY'
      },
      body: JSON.stringify({
        zone: 'serp_api1',
        url: 'https://www.google.com/search?q=pizza&tbm=shop',
        format: 'raw'
      })
    });
    
    const data = await response.text();
    console.log(data);
  })();
  ```

  ```python Python highlight={11} theme={null}
  import requests

  # API Configuration
  headers = {
      'Content-Type': 'application/json',
      'Authorization': 'Bearer API_KEY',
  }

  payload = {
      'zone': 'serp_api1',
      'url': 'https://www.google.com/search?q=pizza&tbm=shop',
      'format': 'raw'
  }

  # Make the request
  response = requests.post(
      'https://api.brightdata.com/request', 
      json=payload, 
      headers=headers
  )

  print(response.text)
  ```
</RequestExample>

<ResponseExample>
  ```json 200 highlight={9} theme={null}
  {
    "general": {
      "search_engine": "google",
      "query": "pizza",
      "language": "en",
      "location": "United States",
      "mobile": false,
      "basic_view": false,
      "search_type": "shopping",
      "page_title": "pizza - Google Shopping",
      "timestamp": "2026-02-24T20:34:04.313Z"
    },
    "input": {
      "original_url": "https://www.google.com/search?q=pizza&tbm=shop&brd_json=1",
      "request_id": "hl_xxxxxxxxxxxxxxx"
    },
    "navigation": [
      {
        "title": "Nearby",
        "href": "https://www.google.com/search?q=pizza+nearby&gl=US&hl=en&udm=28&shoprs=CAEYAyoFcGl6emEyDAgDEgZOZWFyYnkYAli7miFgAg&sa=X&ved=2ahUKEwjF6IXp_PKSAxU6GLkGHan3NQgQ268JKAB6BAgXEAQ"
      },
      {
        "title": "On sale",
        "href": "https://www.google.com/search?q=pizza+sale&gl=US&hl=en&udm=28&shoprs=CAESBEoCGAEYBioFcGl6emEyEwgGEgdPbiBzYWxlGAIiBEoCGAFYu5ohYAI&sa=X&ved=2ahUKEwjF6IXp_PKSAxU6GLkGHan3NQgQ268JKAF6BAgXEAU"
      },
      {
        "title": "Get it fast",
        "href": "https://www.google.com/search?q=pizza&gl=US&hl=en&udm=28&shoprs=CAESDZoBCgoIEAM4AUAFSAEYFCoFcGl6emEyJAgUEgtHZXQgaXQgZmFzdCINmgEKCggQAzgBQAVIASoEEAEYAWAC&sa=X&ved=2ahUKEwjF6IXp_PKSAxU6GLkGHan3NQgQ268JKAJ6BAgXEAY"
      },
      {
        "title": "Small business",
        "href": "https://www.google.com/search?q=pizza&gl=US&hl=en&udm=28&shoprs=CAESAmoAGBYqBXBpenphMhwIFhIOU21hbGwgYnVzaW5lc3MiAmoAKgQQARgBYAI&sa=X&ved=2ahUKEwjF6IXp_PKSAxU6GLkGHan3NQgQ268JKAN6BAgXEAc"
      },
      {
        "title": "Bread & Pastry Dough",
        "href": "https://www.google.com/search?q=bread+%26+pastry+dough+pizza&gl=US&hl=en&udm=28&shoprs=CAEYCSoFcGl6emEyGAgJEhRCcmVhZCAmIFBhc3RyeSBEb3VnaGAC&sa=X&ved=2ahUKEwjF6IXp_PKSAxU6GLkGHan3NQgQ268JKAB6BAgXEAs"
      },
      {
        "title": "Pizza Sauce",
        "href": "https://www.google.com/search?q=pizza+sauce+&gl=US&hl=en&udm=28&shoprs=CAEYCSoFcGl6emEyDwgJEgtQaXp6YSBTYXVjZWAC&sa=X&ved=2ahUKEwjF6IXp_PKSAxU6GLkGHan3NQgQ268JKAF6BAgXEAw"
      },
      {
        "title": "Cheese",
        "href": "https://www.google.com/search?q=cheese+pizza&gl=US&hl=en&udm=28&shoprs=CAEYCSoFcGl6emEyCggJEgZDaGVlc2VgAg&sa=X&ved=2ahUKEwjF6IXp_PKSAxU6GLkGHan3NQgQ268JKAJ6BAgXEA0"
      },
      {
        "title": "Pizza Pans & Stones",
        "href": "https://www.google.com/search?q=pizza+pans+%26+stones+&gl=US&hl=en&udm=28&shoprs=CAEYCSoFcGl6emEyFwgJEhNQaXp6YSBQYW5zICYgU3RvbmVzYAI&sa=X&ved=2ahUKEwjF6IXp_PKSAxU6GLkGHan3NQgQ268JKAN6BAgXEA4"
      },
      {
        "title": "Pizza Crust Mixes",
        "href": "https://www.google.com/search?q=pizza+crust+mixes+&gl=US&hl=en&udm=28&shoprs=CAEYCSoFcGl6emEyFQgJEhFQaXp6YSBDcnVzdCBNaXhlc2AC&sa=X&ved=2ahUKEwjF6IXp_PKSAxU6GLkGHan3NQgQ268JKAR6BAgXEA8"
      },
      {
        "title": "4 and up",
        "href": "https://www.google.com/search?q=pizza&gl=US&hl=en&udm=28&shoprs=CAESBWIDCJADGB4qBXBpenphMhUIHhIINCBhbmQgdXAiBWIDCJADQARgAg&sa=X&ved=2ahUKEwjF6IXp_PKSAxU6GLkGHan3NQgQ268JKAB6BAgXEBM"
      },
      {
        "title": "Chicken",
        "href": "https://www.google.com/search?q=chicken+pizza&gl=US&hl=en&udm=28&shoprs=CAEYASoFcGl6emEyGQgBEgdDaGlja2VuOgwImM-mAhCaz6YCMAJYu5ohYAI&sa=X&ved=2ahUKEwjF6IXp_PKSAxU6GLkGHan3NQgQ268JKAB6BAgXEBg"
      },
      {
        "title": "Turkey",
        "href": "https://www.google.com/search?q=turkey+pizza&gl=US&hl=en&udm=28&shoprs=CAEYASoFcGl6emEyGAgBEgZUdXJrZXk6DAiYz6YCEJ_PpgIwAli7miFgAg&sa=X&ved=2ahUKEwjF6IXp_PKSAxU6GLkGHan3NQgQ268JKAF6BAgXEBk"
      },
      {
        "title": "Fish",
        "href": "https://www.google.com/search?q=fish+pizza&gl=US&hl=en&udm=28&shoprs=CAEYASoFcGl6emEyFggBEgRGaXNoOgwImM-mAhCbz6YCMAJYu5ohYAI&sa=X&ved=2ahUKEwjF6IXp_PKSAxU6GLkGHan3NQgQ268JKAJ6BAgXEBo"
      },
      {
        "title": "Vegetable Protein",
        "href": "https://www.google.com/search?q=vegetable+protein+pizza&gl=US&hl=en&udm=28&shoprs=CAEYASoFcGl6emEyIwgBEhFWZWdldGFibGUgUHJvdGVpbjoMCJjPpgIQoM-mAjACWLuaIWAC&sa=X&ved=2ahUKEwjF6IXp_PKSAxU6GLkGHan3NQgQ268JKAN6BAgXEBs"
      },
      {
        "title": "Walmart",
        "href": "https://www.google.com/search?q=walmart+pizza&gl=US&hl=en&udm=28&shoprs=CAEYAioFcGl6emEyCwgCEgdXYWxtYXJ0WLuaIWAC&sa=X&ved=2ahUKEwjF6IXp_PKSAxU6GLkGHan3NQgQ268JKAB6BAgXEB8"
      },
      {
        "title": "Target",
        "href": "https://www.google.com/search?q=target+pizza&gl=US&hl=en&udm=28&shoprs=CAEYAioFcGl6emEyCggCEgZUYXJnZXRYu5ohYAI&sa=X&ved=2ahUKEwjF6IXp_PKSAxU6GLkGHan3NQgQ268JKAF6BAgXECA"
      },
      {
        "title": "Home Depot",
        "href": "https://www.google.com/search?q=home+depot+pizza&gl=US&hl=en&udm=28&shoprs=CAEYAioFcGl6emEyDggCEgpIb21lIERlcG90WLuaIWAC&sa=X&ved=2ahUKEwjF6IXp_PKSAxU6GLkGHan3NQgQ268JKAJ6BAgXECE"
      },
      {
        "title": "Food Depot",
        "href": "https://www.google.com/search?q=food+depot+pizza&gl=US&hl=en&udm=28&shoprs=CAEYAioFcGl6emEyDggCEgpGb29kIERlcG90WLuaIWAC&sa=X&ved=2ahUKEwjF6IXp_PKSAxU6GLkGHan3NQgQ268JKAN6BAgXECI"
      },
      {
        "title": "Under $5",
        "href": "https://www.google.com/search?q=pizza+under+$5&gl=US&hl=en&udm=28&shoprs=CAESDRILEQAAAADQElNBGAEYBSoFcGl6emEyIQgFEghVbmRlciAkNRgCIg0SCxEAAAAA0BJTQRgBKgIYAVi7miFgAg&sa=X&ved=2ahUKEwjF6IXp_PKSAxU6GLkGHan3NQgQ268JKAB6BAgXECg"
      },
      {
        "title": "$5 - $9",
        "href": "https://www.google.com/search?q=pizza+between+$5+and+$9&gl=US&hl=en&udm=28&shoprs=CAESFhIUCQAAAADQElNBEQAAAACIKmFBGAEYBSoFcGl6emEyKQgFEgckNSAtICQ5GAIiFhIUCQAAAADQElNBEQAAAACIKmFBGAEqAhgBWLuaIWAC&sa=X&ved=2ahUKEwjF6IXp_PKSAxU6GLkGHan3NQgQ268JKAF6BAgXECk"
      },
      {
        "title": "$9 - $20",
        "href": "https://www.google.com/search?q=pizza+between+$9+and+$20&gl=US&hl=en&udm=28&shoprs=CAESFhIUCQAAAACIKmFBEQAAAADQEnNBGAEYBSoFcGl6emEyKggFEggkOSAtICQyMBgCIhYSFAkAAAAAiCphQREAAAAA0BJzQRgBKgIYAVi7miFgAg&sa=X&ved=2ahUKEwjF6IXp_PKSAxU6GLkGHan3NQgQ268JKAJ6BAgXECo"
      },
      {
        "title": "Over $20",
        "href": "https://www.google.com/search?q=pizza+over+$20&gl=US&hl=en&udm=28&shoprs=CAESDRILCQAAAADQEnNBGAEYBSoFcGl6emEyIQgFEghPdmVyICQyMBgCIg0SCwkAAAAA0BJzQRgBKgIYAVi7miFgAg&sa=X&ved=2ahUKEwjF6IXp_PKSAxU6GLkGHan3NQgQ268JKAN6BAgXECs"
      },
      {
        "title": "Lunch",
        "href": "https://www.google.com/search?q=lunch+pizza&gl=US&hl=en&udm=28&shoprs=CAEYASoFcGl6emEyFwgBEgVMdW5jaDoMCI3PpgIQj8-mAjACWLuaIWAC&sa=X&ved=2ahUKEwjF6IXp_PKSAxU6GLkGHan3NQgQ268JKAB6BAgXEDI"
      },
      {
        "title": "Breakfast",
        "href": "https://www.google.com/search?q=breakfast+pizza&gl=US&hl=en&udm=28&shoprs=CAEYASoFcGl6emEyGwgBEglCcmVha2Zhc3Q6DAiNz6YCEI7PpgIwAli7miFgAg&sa=X&ved=2ahUKEwjF6IXp_PKSAxU6GLkGHan3NQgQ268JKAF6BAgXEDM"
      },
      {
        "title": "Entree",
        "href": "https://www.google.com/search?q=entree+pizza&gl=US&hl=en&udm=28&shoprs=CAEYASoFcGl6emEyGAgBEgZFbnRyZWU6DAiJz6YCEIvPpgIwAli7miFgAg&sa=X&ved=2ahUKEwjF6IXp_PKSAxU6GLkGHan3NQgQ268JKAB6BAgXEDc"
      },
      {
        "title": "Appetizer",
        "href": "https://www.google.com/search?q=appetizer+pizza&gl=US&hl=en&udm=28&shoprs=CAEYASoFcGl6emEyGwgBEglBcHBldGl6ZXI6DAiJz6YCEIrPpgIwAli7miFgAg&sa=X&ved=2ahUKEwjF6IXp_PKSAxU6GLkGHan3NQgQ268JKAF6BAgXEDg"
      },
      {
        "title": "Kosher",
        "href": "https://www.google.com/search?q=kosher+pizza&gl=US&hl=en&udm=28&shoprs=CAEYASoFcGl6emEyGAgBEgZLb3NoZXI6DAjx34cBEPLfhwEwA1i7miFgAg&sa=X&ved=2ahUKEwjF6IXp_PKSAxU6GLkGHan3NQgQ268JKAB6BAgXEDw"
      },
      {
        "title": "Organic",
        "href": "https://www.google.com/search?q=organic+pizza&gl=US&hl=en&udm=28&shoprs=CAEYASoFcGl6emEyGQgBEgdPcmdhbmljOgwIvvmHARC_-YcBMANYu5ohYAI&sa=X&ved=2ahUKEwjF6IXp_PKSAxU6GLkGHan3NQgQ268JKAF6BAgXED0"
      },
      {
        "title": "Low Carb",
        "href": "https://www.google.com/search?q=low+carb+pizza&gl=US&hl=en&udm=28&shoprs=CAEYASoFcGl6emEyGggBEghMb3cgQ2FyYjoMCLr4hwEQu_iHATADWLuaIWAC&sa=X&ved=2ahUKEwjF6IXp_PKSAxU6GLkGHan3NQgQ268JKAJ6BAgXED4"
      },
      {
        "title": "Pasta",
        "href": "https://www.google.com/search?q=pasta+pizza&gl=US&hl=en&udm=28&shoprs=CAEYASoFcGl6emEyFwgBEgVQYXN0YToMCPWzxAIQ9rPEAjAAWLuaIWAC&sa=X&ved=2ahUKEwjF6IXp_PKSAxU6GLkGHan3NQgQ268JKAB6BAgXEEI"
      },
      {
        "title": "Rice",
        "href": "https://www.google.com/search?q=rice+pizza&gl=US&hl=en&udm=28&shoprs=CAEYASoFcGl6emEyFggBEgRSaWNlOgwI9bPEAhDrrMYCMABYu5ohYAI&sa=X&ved=2ahUKEwjF6IXp_PKSAxU6GLkGHan3NQgQ268JKAF6BAgXEEM"
      },
      {
        "title": "Free shipping",
        "href": "https://www.google.com/search?q=pizza+free+shipping&gl=US&hl=en&udm=28&shoprs=CAESBFICEAEYGSoFcGl6emEyFwgZEg1GcmVlIHNoaXBwaW5nIgRSAhABYAI&sa=X&ved=2ahUKEwjF6IXp_PKSAxU6GLkGHan3NQgQ268JKAB6BAgXEEc"
      },
      {
        "title": "DiGiorno",
        "href": "https://www.google.com/search?q=digiorno+pizza&gl=US&hl=en&udm=28&shoprs=CAEYASoFcGl6emEyGAgBEghEaUdpb3JubzoKCIPzPBDS5UgwAVi7miFgAg&sa=X&ved=2ahUKEwjF6IXp_PKSAxU6GLkGHan3NQgQ268JKAB6BAgXEEs"
      },
      {
        "title": "Red Baron",
        "href": "https://www.google.com/search?q=red+baron+pizza&gl=US&hl=en&udm=28&shoprs=CAEYASoFcGl6emEyGQgBEglSZWQgQmFyb246CgiD8zwQ1uJIMAFYu5ohYAI&sa=X&ved=2ahUKEwjF6IXp_PKSAxU6GLkGHan3NQgQ268JKAF6BAgXEEw"
      },
      {
        "title": "Jack's",
        "href": "https://www.google.com/search?q=jack's+pizza&gl=US&hl=en&udm=28&shoprs=CAEYASoFcGl6emEyFwgBEgZKYWNrJ3M6CwiD8zwQmp6YAjABWLuaIWAC&sa=X&ved=2ahUKEwjF6IXp_PKSAxU6GLkGHan3NQgQ268JKAJ6BAgXEE0"
      },
      {
        "title": "TombStone",
        "href": "https://www.google.com/search?q=tombstone+pizza&gl=US&hl=en&udm=28&shoprs=CAEYASoFcGl6emEyGQgBEglUb21iU3RvbmU6CgiD8zwQ0eZIMAFYu5ohYAI&sa=X&ved=2ahUKEwjF6IXp_PKSAxU6GLkGHan3NQgQ268JKAN6BAgXEE4"
      },
      {
        "title": "Nearby",
        "href": "https://www.google.com/search?q=pizza+nearby&gl=US&hl=en&udm=28&shoprs=CAEYAyoFcGl6emEyDAgDEgZOZWFyYnkYAli7miFgAQ&sa=X&ved=2ahUKEwjF6IXp_PKSAxU6GLkGHan3NQgQip4GKAJ6BAgXEFc"
      },
      {
        "title": "Bread & Pastry Dough",
        "href": "https://www.google.com/search?q=bread+%26+pastry+dough+pizza&gl=US&hl=en&udm=28&shoprs=CAEYCSoFcGl6emEyGAgJEhRCcmVhZCAmIFBhc3RyeSBEb3VnaGAB&sa=X&ved=2ahUKEwjF6IXp_PKSAxU6GLkGHan3NQgQip4GKAR6BAgXEFk"
      },
      {
        "title": "School",
        "href": "https://www.google.com/search?q=school+pizza&gl=US&hl=en&udm=28&shoprs=CAEYEioFcGl6emEyCggSEgZTY2hvb2xgAQ&sa=X&ved=2ahUKEwjF6IXp_PKSAxU6GLkGHan3NQgQip4GKAZ6BAgXEFs"
      },
      {
        "title": "Chicken",
        "href": "https://www.google.com/search?q=chicken+pizza&gl=US&hl=en&udm=28&shoprs=CAEYASoFcGl6emEyGQgBEgdDaGlja2VuOgwImM-mAhCaz6YCMAJYu5ohYAE&sa=X&ved=2ahUKEwjF6IXp_PKSAxU6GLkGHan3NQgQip4GKAh6BAgXEF0"
      },
      {
        "title": "On sale",
        "href": "https://www.google.com/search?q=pizza+sale&gl=US&hl=en&udm=28&shoprs=CAESBEoCGAEYBioFcGl6emEyEwgGEgdPbiBzYWxlGAIiBEoCGAFYu5ohYAE&sa=X&ved=2ahUKEwjF6IXp_PKSAxU6GLkGHan3NQgQip4GKAp6BAgXEF8"
      },
      {
        "title": "Pizza Sauce",
        "href": "https://www.google.com/search?q=pizza+sauce+&gl=US&hl=en&udm=28&shoprs=CAEYCSoFcGl6emEyDwgJEgtQaXp6YSBTYXVjZWAB&sa=X&ved=2ahUKEwjF6IXp_PKSAxU6GLkGHan3NQgQip4GKAx6BAgXEGE"
      },
      {
        "title": "Get it fast",
        "href": "https://www.google.com/search?q=pizza&gl=US&hl=en&udm=28&shoprs=CAESDZoBCgoIEAM4AUAFSAEYFCoFcGl6emEyJAgUEgtHZXQgaXQgZmFzdCINmgEKCggQAzgBQAVIASoEEAEYAWAB&sa=X&ved=2ahUKEwjF6IXp_PKSAxU6GLkGHan3NQgQip4GKA56BAgXEGM"
      },
      {
        "title": "Cheese",
        "href": "https://www.google.com/search?q=cheese+pizza&gl=US&hl=en&udm=28&shoprs=CAEYCSoFcGl6emEyCggJEgZDaGVlc2VgAQ&sa=X&ved=2ahUKEwjF6IXp_PKSAxU6GLkGHan3NQgQip4GKBB6BAgXEGU"
      },
      {
        "title": "Frozen",
        "href": "https://www.google.com/search?q=frozen+pizza&gl=US&hl=en&udm=28&shoprs=CAEYEioFcGl6emEyCggSEgZGcm96ZW5gAQ&sa=X&ved=2ahUKEwjF6IXp_PKSAxU6GLkGHan3NQgQip4GKBR6BAgXEGo"
      },
      {
        "title": "Under $5",
        "href": "https://www.google.com/search?q=pizza+under+$5&gl=US&hl=en&udm=28&shoprs=CAESDRILEQAAAADQElNBGAEYBSoFcGl6emEyIQgFEghVbmRlciAkNRgCIg0SCxEAAAAA0BJTQRgBKgIYAVi7miFgAQ&sa=X&ved=2ahUKEwjF6IXp_PKSAxU6GLkGHan3NQgQip4GKBZ6BAgXEGw"
      },
      {
        "title": "Pizza Crust",
        "href": "https://www.google.com/search?q=pizza+crust+&gl=US&hl=en&udm=28&shoprs=CAEYASoFcGl6emEyGwgBEgtQaXp6YSBDcnVzdDoKCIXhORCM4TkwAFi7miFgAQ&sa=X&ved=2ahUKEwjF6IXp_PKSAxU6GLkGHan3NQgQip4GKBh6BAgXEG4"
      },
      {
        "title": "Pizza Pans & Stones",
        "href": "https://www.google.com/search?q=pizza+pans+%26+stones+&gl=US&hl=en&udm=28&shoprs=CAEYCSoFcGl6emEyFwgJEhNQaXp6YSBQYW5zICYgU3RvbmVzYAE&sa=X&ved=2ahUKEwjF6IXp_PKSAxU6GLkGHan3NQgQip4GKBp6BAgXEHA"
      },
      {
        "title": "Lunch",
        "href": "https://www.google.com/search?q=lunch+pizza&gl=US&hl=en&udm=28&shoprs=CAEYASoFcGl6emEyFwgBEgVMdW5jaDoMCI3PpgIQj8-mAjACWLuaIWAB&sa=X&ved=2ahUKEwjF6IXp_PKSAxU6GLkGHan3NQgQip4GKBx6BAgXEHI"
      },
      {
        "title": "Entree",
        "href": "https://www.google.com/search?q=entree+pizza&gl=US&hl=en&udm=28&shoprs=CAEYASoFcGl6emEyGAgBEgZFbnRyZWU6DAiJz6YCEIvPpgIwAli7miFgAQ&sa=X&ved=2ahUKEwjF6IXp_PKSAxU6GLkGHan3NQgQip4GKB56BAgXEHQ"
      },
      {
        "title": "Pizza Crust Mixes",
        "href": "https://www.google.com/search?q=pizza+crust+mixes+&gl=US&hl=en&udm=28&shoprs=CAEYCSoFcGl6emEyFQgJEhFQaXp6YSBDcnVzdCBNaXhlc2AB&sa=X&ved=2ahUKEwjF6IXp_PKSAxU6GLkGHan3NQgQip4GKCJ6BAgXEHk"
      },
      {
        "title": "Small",
        "href": "https://www.google.com/search?q=small+pizza&gl=US&hl=en&udm=28&shoprs=CAEYEioFcGl6emEyCQgSEgVTbWFsbGAB&sa=X&ved=2ahUKEwjF6IXp_PKSAxU6GLkGHan3NQgQip4GKCR6BAgXEHs"
      },
      {
        "title": "Large",
        "href": "https://www.google.com/search?q=large+pizza&gl=US&hl=en&udm=28&shoprs=CAEYEioFcGl6emEyCQgSEgVMYXJnZWAB&sa=X&ved=2ahUKEwjF6IXp_PKSAxU6GLkGHan3NQgQip4GKCZ6BAgXEH0"
      },
      {
        "title": "Breakfast",
        "href": "https://www.google.com/search?q=breakfast+pizza&gl=US&hl=en&udm=28&shoprs=CAEYASoFcGl6emEyGwgBEglCcmVha2Zhc3Q6DAiNz6YCEI7PpgIwAli7miFgAQ&sa=X&ved=2ahUKEwjF6IXp_PKSAxU6GLkGHan3NQgQip4GKCh6BAgXEH8"
      },
      {
        "title": "Fresh",
        "href": "https://www.google.com/search?q=fresh+pizza&gl=US&hl=en&udm=28&shoprs=CAEYASoFcGl6emEyFwgBEgVGcmVzaDoMCNCTiAEQ0ZOIATACWLuaIWAB&sa=X&ved=2ahUKEwjF6IXp_PKSAxU6GLkGHan3NQgQip4GKCx6BQgXEIQB"
      },
      {
        "title": "Kosher",
        "href": "https://www.google.com/search?q=kosher+pizza&gl=US&hl=en&udm=28&shoprs=CAEYASoFcGl6emEyGAgBEgZLb3NoZXI6DAjx34cBEPLfhwEwA1i7miFgAQ&sa=X&ved=2ahUKEwjF6IXp_PKSAxU6GLkGHan3NQgQip4GKC56BQgXEIYB"
      },
      {
        "title": "Pasta",
        "href": "https://www.google.com/search?q=pasta+pizza&gl=US&hl=en&udm=28&shoprs=CAEYASoFcGl6emEyFwgBEgVQYXN0YToMCPWzxAIQ9rPEAjAAWLuaIWAB&sa=X&ved=2ahUKEwjF6IXp_PKSAxU6GLkGHan3NQgQip4GKDB6BQgXEIgB"
      },
      {
        "title": "Appetizer",
        "href": "https://www.google.com/search?q=appetizer+pizza&gl=US&hl=en&udm=28&shoprs=CAEYASoFcGl6emEyGwgBEglBcHBldGl6ZXI6DAiJz6YCEIrPpgIwAli7miFgAQ&sa=X&ved=2ahUKEwjF6IXp_PKSAxU6GLkGHan3NQgQip4GKDJ6BQgXEIoB"
      },
      {
        "title": "Organic",
        "href": "https://www.google.com/search?q=organic+pizza&gl=US&hl=en&udm=28&shoprs=CAEYASoFcGl6emEyGQgBEgdPcmdhbmljOgwIvvmHARC_-YcBMANYu5ohYAE&sa=X&ved=2ahUKEwjF6IXp_PKSAxU6GLkGHan3NQgQip4GKDR6BQgXEIwB"
      }
    ],
    "shopping": [
      {
        "title": "Red Baron Classic Crust Pepperoni Pizza",
        "price": "$6.99",
        "shop_logo": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAACAAAA...",
        "shop": "walgreens.com",
        "rating": 4.5,
        "reviews_cnt": 2100,
        "image": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQABAAD/2w...",
        "image_base64": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQABAAD/2w...",
        "rank": 1,
        "global_rank": 1
      },
      {
        "title": "Screamin' Sicilian Supremus Maximus Supreme Pizza",
        "price": "$5.99",
        "shop_logo": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAACAAAA...",
        "shop": "Giant Food",
        "shipping": "Free delivery by Sat",
        "rating": 4.4,
        "reviews_cnt": 548,
        "image": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQABAAD/2w...",
        "image_base64": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQABAAD/2w...",
        "rank": 2,
        "global_rank": 2
      },
      {
        "title": "DiGiorno Original Rising Crust Pizza",
        "price": "$7.99",
        "shop_logo": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAACAAAA...",
        "shop": "CVS Pharmacy",
        "shipping": "Free delivery on $35+",
        "rating": 4.4,
        "reviews_cnt": 9800,
        "image": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQABAAD/2w...",
        "image_base64": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQABAAD/2w...",
        "rank": 3,
        "global_rank": 3
      },
      {
        "title": "Giordano's Stuffed Chicago Deep Dish Frozen Pizza 10",
        "price": "$84.99",
        "shop_logo": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAACAAAA...",
        "shop": "Walmart - Giordanos",
        "shipping": "Free delivery",
        "rating": 1,
        "reviews_cnt": 3,
        "image": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQABAAD/2w...",
        "image_base64": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQABAAD/2w...",
        "rank": 4,
        "global_rank": 4
      },
      {
        "title": "Jack's Original Thin Crust Pepperoni Pizza",
        "price": "$3.99",
        "shop_logo": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAACAAAA...",
        "shop": "walgreens.com",
        "rating": 4.3,
        "reviews_cnt": 3400,
        "image": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQABAAD/2w...",
        "image_base64": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQABAAD/2w...",
        "rank": 5,
        "global_rank": 5
      },
      {
        "title": "Totino's Party Pepperoni Pizza",
        "price": "$2.14",
        "shop_logo": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAACAAAA...",
        "shop": "Food Depot",
        "rating": 4.4,
        "reviews_cnt": 5700,
        "image": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQABAAD/2w...",
        "image_base64": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQABAAD/2w...",
        "rank": 6,
        "global_rank": 6
      },
      {
        "title": "Red Baron Pepperoni Deep Dish Personal Pizza",
        "price": "$42.99",
        "shop_logo": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAACAAAA...",
        "shop": "WebstaurantStore.com",
        "rating": 4.6,
        "reviews_cnt": 1400,
        "image": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQABAAD/2w...",
        "image_base64": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQABAAD/2w...",
        "rank": 7,
        "global_rank": 7
      },
      {
        "title": "Red Baron Deep Dish Pepperoni Pizza",
        "price": "$4.29",
        "shop_logo": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAACAAAA...",
        "shop": "Busch's Fresh Food Market",
        "rating": 4.3,
        "reviews_cnt": 1000,
        "image": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQABAAD/2w...",
        "image_base64": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQABAAD/2w...",
        "rank": 8,
        "global_rank": 8
      },
      {
        "title": "Capone Foods Pepperino Pizza",
        "price": "$8.95",
        "shop_logo": "https://encrypted-tbn1.gstatic.com/favicon-tbn?q=tbn%3AANd9GcRDy4dgbuTUCJn7ipuj_V6Dxf3kw1R4G9oH29ofpdUzcdMld70VNTNuTPBV8ifFe8Wo1B-xiXMT8nCw1lqGZJRSEkjm-ONXbVg",
        "shop": "Capone Foods",
        "image": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQABAAD/2w...",
        "image_base64": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQABAAD/2w...",
        "rank": 9,
        "global_rank": 9
      },
      {
        "title": "Tombstone Original Crust Pizza",
        "price": "$2.00",
        "shop_logo": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAB0AAA...",
        "shop": "Food Rite",
        "image": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQABAAD/2w...",
        "image_base64": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQABAAD/2w...",
        "rank": 10,
        "global_rank": 10
      }
    ],
    "pagination": {
      "next_page_start": 10,
      "next_page_link": "https://www.google.com/search?q=pizza&sca_esv=62b03b7345eac9c6&gl=US&hl=en&udm=28&prmd=ivnsmb&ei=HQueaYXmOLqw5OUPqe_XQQ&start=10&sa=N"
    }
  }
  ```
</ResponseExample>


# Short videos
Source: https://docs.brightdata.com/api-reference/serp/google-search/short-videos

Configure the Bright Data Google Search Short Videos parameter to refine queries and return matching results as JSON or HTML. On port 44445.

```http theme={null}
https://www.google.com/search?q=pizza&udm=39
```

## Parameters

<ParamField type="string">
  The search query parameter. Specifies the keyword or phrase you want to search for on Google.
</ParamField>

<ParamField type="string">
  For searching short videos, use `udm=39` to get results.

  ```http theme={null}
  https://www.google.com/search?q=pizza&udm=39
  ```
</ParamField>

<RequestExample>
  ```shell cURL highlight={6} theme={null}
    curl -X POST https://api.brightdata.com/request \
    --header "Content-Type: application/json" \
    --header "Authorization: Bearer API_KEY" \
    --data '{
      "zone": "serp_api1",
      "url": "https://www.google.com/search?q=pizza&udm=39",
      "format": "raw"
    }'
  ```

  ```shell Native proxy highlight={4} theme={null}
  curl --proxy brd.superproxy.io:44445 \
    --proxy-user CUSTOMER_USERNAME:CUSTOMER_PASSWORD \
    --ssl-no-revoke \
    "https://www.google.com/search?q=pizza&udm=39"
  ```

  ```js Node.js highlight={10} theme={null}
  (async () => {
    const response = await fetch('https://api.brightdata.com/request', {
      method: 'POST',
      headers: {
        'Content-Type': 'application/json',
        'Authorization': 'Bearer API_KEY'
      },
      body: JSON.stringify({
        zone: 'serp_api1',
        url: 'https://www.google.com/search?q=pizza&udm=39',
        format: 'raw'
      })
    });
    
    const data = await response.text();
    console.log(data);
  })();
  ```

  ```python Python highlight={11} theme={null}
  import requests

  # API Configuration
  headers = {
      'Content-Type': 'application/json',
      'Authorization': 'Bearer API_KEY',
  }

  payload = {
      'zone': 'serp_api1',
      'url': 'https://www.google.com/search?q=pizza&udm=39',
      'format': 'raw'
  }

  # Make the request
  response = requests.post(
      'https://api.brightdata.com/request', 
      json=payload, 
      headers=headers
  )

  print(response.text)
  ```
</RequestExample>

<ResponseExample>
  ```json 200 highlight={11} theme={null}
  {
    "general": {
      "search_engine": "google",
      "query": "pizza",
      "results_cnt": 142000000,
      "search_time": 0.26,
      "language": "en",
      "location": "United States",
      "mobile": false,
      "basic_view": false,
      "search_type": "short_videos",
      "page_title": "pizza - Google Search",
      "timestamp": "2026-02-25T08:40:29.129Z"
    },
    "input": {
      "original_url": "https://www.google.com/search?q=pizza&udm=39&brd_json=1",
      "request_id": "hl_xxxxxxxxxxxxxxx"
    },
    "navigation": [
      {
        "title": "AI Mode",
        "href": "https://www.google.com/search?q=pizza&num=12&sca_esv=206cd4dd954885db&gl=US&hl=en&udm=50&fbs=ADc_l-aN0CWEZBOHjofHoaMMDiKpUrv6YeyJhXfuYqj4Fj6c1Tg5t_ufWNUvD2V-uX26AFlqeVA_8cCiKkQH-MFQemrtPKh5DXjDm8xDum7A4wYDWJgscQ2OVXNkKTqqlx9HCssMrDWQeoEQBO4dwrtGUJY4Oy-Z14dRBjPQpDok7I-4oduRsCNHRrO_G3ovy1C5_HZK3cFUgyvFUoxX8cqnfGbb7mjGvQ&aep=1&ntc=1&sa=X&ved=2ahUKEwjS7Nmjn_SSAxUyQ_EDHVIbGwEQ2J8OegQIERAD"
      },
      {
        "title": "All",
        "href": "https://www.google.com/search?num=12&sca_esv=206cd4dd954885db&gl=US&hl=en&q=pizza&source=lnms&fbs=ADc_l-aN0CWEZBOHjofHoaMMDiKpUrv6YeyJhXfuYqj4Fj6c1Tg5t_ufWNUvD2V-uX26AFlqeVA_8cCiKkQH-MFQemrtPKh5DXjDm8xDum7A4wYDWJgscQ2OVXNkKTqqlx9HCssMrDWQeoEQBO4dwrtGUJY4Oy-Z14dRBjPQpDok7I-4oduRsCNHRrO_G3ovy1C5_HZK3cFUgyvFUoxX8cqnfGbb7mjGvQ&sa=X&ved=2ahUKEwjS7Nmjn_SSAxUyQ_EDHVIbGwEQ0pQJegQIFxAB"
      },
      {
        "title": "Maps",
        "href": "https://maps.google.com/maps?num=12&sca_esv=206cd4dd954885db&gl=US&hl=en&output=search&q=pizza&source=lnms&fbs=ADc_l-aN0CWEZBOHjofHoaMMDiKpUrv6YeyJhXfuYqj4Fj6c1Tg5t_ufWNUvD2V-uX26AFlqeVA_8cCiKkQH-MFQemrtPKh5DXjDm8xDum7A4wYDWJgscQ2OVXNkKTqqlx9HCssMrDWQeoEQBO4dwrtGUJY4Oy-Z14dRBjPQpDok7I-4oduRsCNHRrO_G3ovy1C5_HZK3cFUgyvFUoxX8cqnfGbb7mjGvQ&entry=mc&ved=1t:200715&ictx=111"
      },
      {
        "title": "Images",
        "href": "https://www.google.com/search?num=12&sca_esv=206cd4dd954885db&gl=US&hl=en&udm=2&fbs=ADc_l-aN0CWEZBOHjofHoaMMDiKpUrv6YeyJhXfuYqj4Fj6c1Tg5t_ufWNUvD2V-uX26AFlqeVA_8cCiKkQH-MFQemrtPKh5DXjDm8xDum7A4wYDWJgscQ2OVXNkKTqqlx9HCssMrDWQeoEQBO4dwrtGUJY4Oy-Z14dRBjPQpDok7I-4oduRsCNHRrO_G3ovy1C5_HZK3cFUgyvFUoxX8cqnfGbb7mjGvQ&q=pizza&sa=X&ved=2ahUKEwjS7Nmjn_SSAxUyQ_EDHVIbGwEQtKgLegQIGxAB"
      },
      {
        "title": "Shopping",
        "href": "https://www.google.com/search?num=12&sca_esv=206cd4dd954885db&gl=US&hl=en&udm=28&fbs=ADc_l-aN0CWEZBOHjofHoaMMDiKpUrv6YeyJhXfuYqj4Fj6c1Tg5t_ufWNUvD2V-uX26AFlqeVA_8cCiKkQH-MFQemrtPKh5DXjDm8xDum7A4wYDWJgscQ2OVXNkKTqqlx9HCssMrDWQeoEQBO4dwrtGUJY4Oy-Z14dRBjPQpDok7I-4oduRsCNHRrO_G3ovy1C5_HZK3cFUgyvFUoxX8cqnfGbb7mjGvQ&q=pizza&ved=1t:220175&ictx=111"
      },
      {
        "title": "News",
        "href": "https://www.google.com/search?num=12&sca_esv=206cd4dd954885db&gl=US&hl=en&q=pizza&tbm=nws&source=lnms&fbs=ADc_l-aN0CWEZBOHjofHoaMMDiKpUrv6YeyJhXfuYqj4Fj6c1Tg5t_ufWNUvD2V-uX26AFlqeVA_8cCiKkQH-MFQemrtPKh5DXjDm8xDum7A4wYDWJgscQ2OVXNkKTqqlx9HCssMrDWQeoEQBO4dwrtGUJY4Oy-Z14dRBjPQpDok7I-4oduRsCNHRrO_G3ovy1C5_HZK3cFUgyvFUoxX8cqnfGbb7mjGvQ&sa=X&ved=2ahUKEwjS7Nmjn_SSAxUyQ_EDHVIbGwEQ0pQJegQIGRAB"
      },
      {
        "title": "Videos",
        "href": "https://www.google.com/search?num=12&sca_esv=206cd4dd954885db&gl=US&hl=en&udm=7&fbs=ADc_l-aN0CWEZBOHjofHoaMMDiKpUrv6YeyJhXfuYqj4Fj6c1Tg5t_ufWNUvD2V-uX26AFlqeVA_8cCiKkQH-MFQemrtPKh5DXjDm8xDum7A4wYDWJgscQ2OVXNkKTqqlx9HCssMrDWQeoEQBO4dwrtGUJY4Oy-Z14dRBjPQpDok7I-4oduRsCNHRrO_G3ovy1C5_HZK3cFUgyvFUoxX8cqnfGbb7mjGvQ&q=pizza&sa=X&ved=2ahUKEwjS7Nmjn_SSAxUyQ_EDHVIbGwEQtKgLegQIHRAB"
      },
      {
        "title": "Forums",
        "href": "https://www.google.com/search?num=12&sca_esv=206cd4dd954885db&gl=US&hl=en&udm=18&fbs=ADc_l-aN0CWEZBOHjofHoaMMDiKpUrv6YeyJhXfuYqj4Fj6c1Tg5t_ufWNUvD2V-uX26AFlqeVA_8cCiKkQH-MFQemrtPKh5DXjDm8xDum7A4wYDWJgscQ2OVXNkKTqqlx9HCssMrDWQeoEQBO4dwrtGUJY4Oy-Z14dRBjPQpDok7I-4oduRsCNHRrO_G3ovy1C5_HZK3cFUgyvFUoxX8cqnfGbb7mjGvQ&q=pizza&sa=X&ved=2ahUKEwjS7Nmjn_SSAxUyQ_EDHVIbGwEQs6gLegQIHxAB"
      },
      {
        "title": "Web",
        "href": "https://www.google.com/search?num=12&sca_esv=206cd4dd954885db&gl=US&hl=en&udm=web&fbs=ADc_l-aN0CWEZBOHjofHoaMMDiKpUrv6YeyJhXfuYqj4Fj6c1Tg5t_ufWNUvD2V-uX26AFlqeVA_8cCiKkQH-MFQemrtPKh5DXjDm8xDum7A4wYDWJgscQ2OVXNkKTqqlx9HCssMrDWQeoEQBO4dwrtGUJY4Oy-Z14dRBjPQpDok7I-4oduRsCNHRrO_G3ovy1C5_HZK3cFUgyvFUoxX8cqnfGbb7mjGvQ&q=pizza&sa=X&ved=2ahUKEwjS7Nmjn_SSAxUyQ_EDHVIbGwEQs6gLegQIHhAB"
      },
      {
        "title": "Flights",
        "href": "https://www.google.com/travel/flights?num=12&sca_esv=206cd4dd954885db&gl=US&hl=en&output=search&q=pizza&source=lnms&fbs=ADc_l-aN0CWEZBOHjofHoaMMDiKpUrv6YeyJhXfuYqj4Fj6c1Tg5t_ufWNUvD2V-uX26AFlqeVA_8cCiKkQH-MFQemrtPKh5DXjDm8xDum7A4wYDWJgscQ2OVXNkKTqqlx9HCssMrDWQeoEQBO4dwrtGUJY4Oy-Z14dRBjPQpDok7I-4oduRsCNHRrO_G3ovy1C5_HZK3cFUgyvFUoxX8cqnfGbb7mjGvQ&ved=1t:200715&ictx=111"
      }
    ],
    "short_videos": [
      {
        "link": "https://www.youtube.com/shorts/kuqbckh8dxo",
        "title": "PIZZA RECIPE WITH BIGA🍕🔥 #pizza #adv",
        "source": "YouTube · Malati di Pizza",
        "duration": "2:26",
        "duration_sec": 146,
        "thumbnail": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQABAAD/2w...",
        "rank": 1,
        "global_rank": 1
      },
      {
        "link": "https://www.youtube.com/shorts/cpW38_oZG3Q",
        "title": "Taco Bell Mexican Pizza Hack",
        "source": "YouTube · Allrecipes",
        "duration": "0:41",
        "duration_sec": 41,
        "thumbnail": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQABAAD/2w...",
        "rank": 2,
        "global_rank": 2
      },
      {
        "link": "https://www.instagram.com/reel/DVKP3BMDUjt/",
        "title": "Rita🍝 | Let’s make pizza with potatoes and rosemary!",
        "source": "Instagram · Rita🍝",
        "duration": "2:57",
        "duration_sec": 177,
        "thumbnail": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQABAAD/2w...",
        "rank": 3,
        "global_rank": 3
      },
      {
        "link": "https://www.facebook.com/chefjackiebakula/videos/i-first-had-chicken-parm-pizza-qualityitalian-in-nyc-it-was-fantastic-i-learned-/851228973898172/",
        "title": "I first had chicken parm pizza @qualityitalian in NYC. It was ...",
        "source": "Facebook · Jackie Bakula",
        "duration": "1:20",
        "duration_sec": 80,
        "thumbnail": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQABAAD/2w...",
        "rank": 4,
        "global_rank": 4
      },
      {
        "link": "https://www.youtube.com/shorts/-A7SldGQ6vU",
        "title": "Trader Joe's NY Style Pizza",
        "source": "YouTube · Dough Guy",
        "duration": "1:30",
        "duration_sec": 90,
        "thumbnail": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQABAAD/2w...",
        "rank": 5,
        "global_rank": 5
      },
      {
        "link": "https://www.tiktok.com/@williamhansonetiquette/video/7601586210062093590",
        "title": "The Joy of Eating Pizza Without Utensils",
        "source": "TikTok · williamhansonetiquette",
        "duration": "0:14",
        "duration_sec": 14,
        "thumbnail": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQABAAD/2w...",
        "rank": 6,
        "global_rank": 6
      },
      {
        "link": "https://www.instagram.com/reel/DVHjUeNkfXT/",
        "title": "Roasted Garlic Butter Pizza Bread",
        "source": "Instagram · Sam Schnur",
        "duration": "0:36",
        "duration_sec": 36,
        "thumbnail": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQABAAD/2w...",
        "rank": 7,
        "global_rank": 7
      },
      {
        "link": "https://www.youtube.com/shorts/0y8KHv40K9s",
        "title": "Nothing Beats Nonna's Homemade Pizza!",
        "source": "YouTube · The Spicy Nonna",
        "duration": "2:43",
        "duration_sec": 163,
        "thumbnail": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQABAAD/2w...",
        "rank": 8,
        "global_rank": 8
      },
      {
        "link": "https://www.youtube.com/shorts/xTj8l8Vi7rg",
        "title": "Rating and Ranking Thin and Crispy Frozen Pizzas #Pizza ...",
        "source": "YouTube · Diff Family Reviews",
        "duration": "2:28",
        "duration_sec": 148,
        "thumbnail": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQABAAD/2w...",
        "rank": 9,
        "global_rank": 9
      },
      {
        "link": "https://www.youtube.com/shorts/F7MK8uqFVF8",
        "title": "NYCS BEST PIZZA",
        "source": "YouTube · CALEB SIMPSON",
        "duration": "2:05",
        "duration_sec": 125,
        "thumbnail": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQABAAD/2w...",
        "rank": 10,
        "global_rank": 10
      },
      {
        "link": "https://www.youtube.com/shorts/bndZw1mXa7w",
        "title": "The Best New York Style Pizza at Home",
        "source": "YouTube · Dylan Nobert",
        "duration": "0:45",
        "duration_sec": 45,
        "thumbnail": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQABAAD/2w...",
        "rank": 11,
        "global_rank": 11
      },
      {
        "link": "https://www.youtube.com/shorts/CCawQUAJ-6Y",
        "title": "The Best Detroit Pizza is in NYC?!",
        "source": "YouTube · Jeremy Jacobowitz",
        "duration": "1:35",
        "duration_sec": 95,
        "thumbnail": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQABAAD/2w...",
        "rank": 12,
        "global_rank": 12
      }
    ],
    "pagination": {
      "next_page_start": 12,
      "next_page_link": "https://www.google.com/search?q=pizza&num=12&sca_esv=206cd4dd954885db&udm=39&gl=US&hl=en&ei=d7WeaZLVHbKGxc8P0rbsCA&start=12&sa=N"
    }
  }
  ```
</ResponseExample>


# Google Search text search
Source: https://docs.brightdata.com/api-reference/serp/google-search/text-search

Configure the Bright Data Google Search Google Search text search parameter to refine queries and return matching results as JSON or HTML. On port 44445.

```Example theme={null}
https://www.google.com/search?q=pizza
```

## Parameters

<ParamField type="string">
  The search query parameter. Specifies the keyword or phrase you want to search for on Google.

  ```Example theme={null}
  https://www.google.com/search?q=pizza
  ```
</ParamField>

<RequestExample>
  ```shell cURL highlight={6} theme={null}
    curl -X POST https://api.brightdata.com/request \
    --header "Content-Type: application/json" \
    --header "Authorization: Bearer API_KEY" \
    --data '{
      "zone": "serp_api1",
      "url": "https://www.google.com/search?q=pizza",
      "format": "raw"
    }'
  ```

  ```shell Native proxy highlight={4} theme={null}
  curl --proxy brd.superproxy.io:44445 \
    --proxy-user CUSTOMER_USERNAME:CUSTOMER_PASSWORD \
    --ssl-no-revoke \
    "https://www.google.com/search?q=pizza"
  ```

  ```js Node.js highlight={10} theme={null}
  (async () => {
    const response = await fetch('https://api.brightdata.com/request', {
      method: 'POST',
      headers: {
        'Content-Type': 'application/json',
        'Authorization': 'Bearer API_KEY'
      },
      body: JSON.stringify({
        zone: 'serp_api1',
        url: 'https://www.google.com/search?q=pizza',
        format: 'raw'
      })
    });
    
    const data = await response.text();
    console.log(data);
  })();
  ```

  ```python Python highlight={11} theme={null}
  import requests

  # API Configuration
  headers = {
      'Content-Type': 'application/json',
      'Authorization': 'Bearer API_KEY',
  }

  payload = {
      'zone': 'serp_api1',
      'url': 'https://www.google.com/search?q=pizza',
      'format': 'raw'
  }

  # Make the request
  response = requests.post(
      'https://api.brightdata.com/request', 
      json=payload, 
      headers=headers
  )

  print(response.text)
  ```
</RequestExample>

<ResponseExample>
  ```json 200 highlight={4} theme={null}
  {
    "general": {
      "search_engine": "google",
      "query": "pizza",
      "results_cnt": 973000000,
      "search_time": 0.46,
      "language": "en-FR",
      "country": "France",
      "country_code": "FR",
      "location": "United States",
      "gl": "FR",
      "mobile": false,
      "basic_view": false,
      "search_type": "text",
      "page_title": "pizza - Google Search",
      "timestamp": "2026-02-24T20:05:07.171Z"
    },
    "input": {
      "original_url": "https://www.google.com/search?q=pizza&brd_json=1",
      "request_id": "hl_xxxxxxxxxxxxxxx"
    },
    "navigation": [
      {
        "title": "Images",
        "href": "https://www.google.com/search?sca_esv=016f34706b28a015&hl=en&udm=2&fbs=ADc_l-aN0CWEZBOHjofHoaMMDiKpaEWjvZ2Py1XXV8d8KvlI3vWUtYx0DZdicpfE1faGYenqWn-q4MFiFFtvJjTKeAVxZj_-zzAfU38gMel7zJW-zoNwHG-ArsO6TrTEJcFsob0pdGO2ABo8o_HC5yJWwFB_-GDw4ME9hn952oqoD4-m1e6t3rE&q=pizza&sa=X&ved=2ahUKEwjh3oW59vKSAxV4bKQEHd32ALEQtKgLegQIHxAB"
      },
      {
        "title": "Videos",
        "href": "https://www.google.com/search?sca_esv=016f34706b28a015&hl=en&udm=7&fbs=ADc_l-aN0CWEZBOHjofHoaMMDiKpaEWjvZ2Py1XXV8d8KvlI3vWUtYx0DZdicpfE1faGYenqWn-q4MFiFFtvJjTKeAVxZj_-zzAfU38gMel7zJW-zoNwHG-ArsO6TrTEJcFsob0pdGO2ABo8o_HC5yJWwFB_-GDw4ME9hn952oqoD4-m1e6t3rE&q=pizza&sa=X&ved=2ahUKEwjh3oW59vKSAxV4bKQEHd32ALEQtKgLegQIHhAB"
      },
      {
        "title": "Short videos",
        "href": "https://www.google.com/search?sca_esv=016f34706b28a015&hl=en&udm=39&fbs=ADc_l-aN0CWEZBOHjofHoaMMDiKpaEWjvZ2Py1XXV8d8KvlI3vWUtYx0DZdicpfE1faGYenqWn-q4MFiFFtvJjTKeAVxZj_-zzAfU38gMel7zJW-zoNwHG-ArsO6TrTEJcFsob0pdGO2ABo8o_HC5yJWwFB_-GDw4ME9hn952oqoD4-m1e6t3rE&q=pizza&sa=X&ved=2ahUKEwjh3oW59vKSAxV4bKQEHd32ALEQs6gLegQIGhAB"
      },
      {
        "title": "News",
        "href": "https://www.google.com/search?sca_esv=016f34706b28a015&hl=en&q=pizza&tbm=nws&source=lnms&fbs=ADc_l-aN0CWEZBOHjofHoaMMDiKpaEWjvZ2Py1XXV8d8KvlI3vWUtYx0DZdicpfE1faGYenqWn-q4MFiFFtvJjTKeAVxZj_-zzAfU38gMel7zJW-zoNwHG-ArsO6TrTEJcFsob0pdGO2ABo8o_HC5yJWwFB_-GDw4ME9hn952oqoD4-m1e6t3rE&sa=X&ved=2ahUKEwjh3oW59vKSAxV4bKQEHd32ALEQ0pQJegQIGBAB"
      },
      {
        "title": "Web",
        "href": "https://www.google.com/search?sca_esv=016f34706b28a015&hl=en&udm=web&fbs=ADc_l-aN0CWEZBOHjofHoaMMDiKpaEWjvZ2Py1XXV8d8KvlI3vWUtYx0DZdicpfE1faGYenqWn-q4MFiFFtvJjTKeAVxZj_-zzAfU38gMel7zJW-zoNwHG-ArsO6TrTEJcFsob0pdGO2ABo8o_HC5yJWwFB_-GDw4ME9hn952oqoD4-m1e6t3rE&q=pizza&sa=X&ved=2ahUKEwjh3oW59vKSAxV4bKQEHd32ALEQs6gLegQIFxAB"
      },
      {
        "title": "Books",
        "href": "https://www.google.com/search?sca_esv=016f34706b28a015&hl=en&q=pizza&udm=36&source=lnms&fbs=ADc_l-aN0CWEZBOHjofHoaMMDiKpaEWjvZ2Py1XXV8d8KvlI3vWUtYx0DZdicpfE1faGYenqWn-q4MFiFFtvJjTKeAVxZj_-zzAfU38gMel7zJW-zoNwHG-ArsO6TrTEJcFsob0pdGO2ABo8o_HC5yJWwFB_-GDw4ME9hn952oqoD4-m1e6t3rE&sa=X&ved=2ahUKEwjh3oW59vKSAxV4bKQEHd32ALEQ0pQJegQIFhAB"
      },
      {
        "title": "Finance",
        "href": "https://www.google.com/finance?sca_esv=016f34706b28a015&hl=en&output=search&q=pizza&source=lnms&fbs=ADc_l-aN0CWEZBOHjofHoaMMDiKpaEWjvZ2Py1XXV8d8KvlI3vWUtYx0DZdicpfE1faGYenqWn-q4MFiFFtvJjTKeAVxZj_-zzAfU38gMel7zJW-zoNwHG-ArsO6TrTEJcFsob0pdGO2ABo8o_HC5yJWwFB_-GDw4ME9hn952oqoD4-m1e6t3rE&sa=X&ved=2ahUKEwjh3oW59vKSAxV4bKQEHd32ALEQ0pQJegQIexAB"
      }
    ],
    "organic": [
      {
        "link": "https://fr.wikipedia.org/wiki/Pizza",
        "source": "Wikipédia",
        "display_link": "https://fr.wikipedia.org › wiki › Pi...",
        "title": "Pizza",
        "description": "La pizza est une recette de cuisine traditionnelle de la cuisine italienne, originaire de Naples à base de galette de pâte à pain, garnie principalement ...Read more",
        "snippet_highlighted_words": [
          "pizza"
        ],
        "icon": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAABwAAA...",
        "image": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQABAAD/2w...",
        "image_alt": "pizza from fr.wikipedia.org",
        "image_base64": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQABAAD/2w...",
        "rank": 1,
        "global_rank": 1
      },
      {
        "link": "https://www.marmiton.org/recettes/recette_pizza-maison_313213.aspx",
        "source": "Marmiton",
        "display_link": "https://www.marmiton.org › recettes",
        "title": "Recette de Pizza maison",
        "description": "Partager la recette · Étape 1. Dans un saladier, placez les 300 g de farine, puis la levure, puis le bicarbonate de soude, la pincée de sel et celle de poivre.Read more",
        "extensions": [
          {
            "type": "rating",
            "rating": 5,
            "reviews_cnt": 23,
            "rank": 1
          }
        ],
        "icon": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAABwAAA...",
        "rank": 2,
        "global_rank": 2
      },
      {
        "link": "https://cuisine.journaldesfemmes.fr/recette-pizza",
        "source": "Journal des Femmes",
        "display_link": "https://cuisine.journaldesfemmes.fr › ...",
        "title": "Pizza maison : recettes faciles et savoureuses",
        "description": "Pizza : Meilleures recettes · Pizza chèvre, figues, pistaches et miel · Pizza blanche au saumon fumé et à la cancoillotte · Pizza au salami de Milano et chorizo.Read more",
        "snippet_highlighted_words": [
          "Pizza",
          "Pizza",
          "Pizza",
          "Pizza"
        ],
        "extensions": [
          {
            "type": "rating",
            "rating": 4.3,
            "reviews_cnt": 96,
            "rank": 1
          }
        ],
        "icon": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAABwAAA...",
        "rank": 3,
        "global_rank": 3
      },
      {
        "link": "https://www.pizzahut.fr/",
        "source": "Pizza Hut",
        "display_link": "https://www.pizzahut.fr",
        "title": "Pizza Hut Livraison, vente à emporter | Commande en ligne ...",
        "description": "Pizza Hut Livraison, vente à emporter | Commande en ligne | Coupons, Promos.",
        "snippet_highlighted_words": [
          "Pizza"
        ],
        "icon": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAABwAAA...",
        "rank": 4,
        "global_rank": 4
      },
      {
        "link": "https://www.dominos.fr/",
        "source": "Domino's Pizza",
        "display_link": "https://www.dominos.fr",
        "title": "Domino's Pizza, livraison et à emporter, commande en ligne",
        "description": "Commandez vos pizzas en ligne en livraison ou à emporter dans votre pizzeria Domino's la plus proche et dégustez-les en famille ou avec vos amis.",
        "snippet_highlighted_words": [
          "pizzas",
          "pizzeria"
        ],
        "icon": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAABAAAA...",
        "image": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcTCf5qNZRvb7AOasK4bkZVf43P-y-6lDa_eBaxgXGw3BuqKmU5ictBb&usqp=CAE&s",
        "image_alt": "pizza from www.dominos.fr",
        "image_url": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcTCf5qNZRvb7AOasK4bkZVf43P-y-6lDa_eBaxgXGw3BuqKmU5ictBb&usqp=CAE&s",
        "rank": 5,
        "global_rank": 9
      },
      {
        "link": "https://www.galbani.fr/recettes/pizza",
        "source": "Galbani",
        "display_link": "https://www.galbani.fr › recettes",
        "title": "Recettes de Pizza à l'italienne et revisitées",
        "description": "Choisissez parmi nos nombreuses recettes de pizza vos préférées et savourez en famille ou entre amis de délicieux plat à l'italienne. Simple, rapide et bon ...",
        "snippet_highlighted_words": [
          "pizza"
        ],
        "icon": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAABwAAA...",
        "rank": 6,
        "global_rank": 10
      },
      {
        "link": "https://www.pizzapapa.fr/blog/origine-pizza/",
        "source": "pizzapapa.fr",
        "display_link": "https://www.pizzapapa.fr › blog",
        "title": "Qui a inventé la pizza ? Histoire & origine de la pizza",
        "description": "Actuellement, la pizza est une recette emblématique de la cuisine italienne qui s'est internationalisée avec l'immigration.Read more",
        "snippet_highlighted_words": [
          "pizza"
        ],
        "extensions": [
          {
            "inline": true,
            "type": "text",
            "text": "26 Sept 2025",
            "rank": 1
          }
        ],
        "icon": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAACAAAA...",
        "rank": 7,
        "global_rank": 11
      },
      {
        "link": "https://lacuisinedannie.20minutes.fr/recette-pate-a-pizza-234.html",
        "source": "La Cuisine d'Annie",
        "display_link": "https://lacuisinedannie.20minutes.fr › ...",
        "title": "Recette Pâte à pizza",
        "description": "Recette Pâte à pizza. Recette de Pains et pâtes de base, Pâtes de base pour 6 personnes. Le temps de préparation est de 15 min. La Cuisine d'Annie regroupe ...",
        "snippet_highlighted_words": [
          "pizza"
        ],
        "extensions": [
          {
            "type": "rating",
            "rating": 5,
            "reviews_cnt": 381,
            "rank": 1
          }
        ],
        "icon": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAABwAAA...",
        "rank": 8,
        "global_rank": 12
      },
      {
        "link": "https://www.picard.fr/rayons/pizzas-et-tartes/pizzas",
        "source": "Picard",
        "display_link": "https://www.picard.fr › rayons › p...",
        "title": "Livraison de Pizzas surgelées à domicile",
        "description": "Découvrez toutes nos pizzas surgelées Picard : les pizzas traditionnelles, bio ou végétariennes sont disponibles dans tous les magasins Picard, ...",
        "snippet_highlighted_words": [
          "pizzas",
          "pizzas"
        ],
        "icon": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAABwAAA...",
        "rank": 9,
        "global_rank": 13
      }
    ],
    "knowledge": {
      "name": "Pizza",
      "summary": "Dish",
      "subtitle": "Dish",
      "description": "Pizza is an Italian dish typically consisting of a flat base of leavened wheat-based dough topped with tomato, cheese, and other ingredients, baked at a high temperature, traditionally in a wood-fired oven.",
      "description_source": "Wikipedia",
      "description_link": "https://en.wikipedia.org/wiki/Pizza",
      "images": [
        {
          "image": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQABAAD/2w...",
          "image_alt": "Image of Homemade Pizza Recipe: How to Make It",
          "image_base64": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQABAAD/2w..."
        },
        {
          "image": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQABAAD/2w...",
          "image_alt": "Image of Pizza maison à la friteuse à air – Parfaitement ...",
          "image_base64": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQABAAD/2w..."
        },
        {
          "image": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQABAAD/2w...",
          "image_alt": "Image of Tomato and Mozzarella Pizza Recipe",
          "image_base64": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQABAAD/2w..."
        }
      ],
      "facts": [
        {
          "key": "Origin",
          "predicate": "hw:/collection/dishes:origin",
          "value": [
            {
              "text": "Italy",
              "link": "https://www.google.com/search?sca_esv=016f34706b28a015&hl=en&q=Italy&si=AL3DRZHmwLjWhgnaPB3UTu10R6S5qNLXiQiKMeezfKyB1FMsRgvMc15_a-XCDquvg02EcLVCDOBlFWcyGM1h_GEvApLCUHB4TbGV9DLLN_L5HXDRSM_AM0JjmkKGPEEkyRjAEOMkP_wbp9U4-YKGn63yz0_QGqKXGf1bKFT4vVVVz2XMsjUuOZt4AnSHQk-nDBQE0oBKvh4m&sa=X&ved=2ahUKEwjh3oW59vKSAxV4bKQEHd32ALEQmxN6BAgQEAI"
            }
          ]
        }
      ],
      "nutrition_facts": {
        "product": "Pizza, 14\" regular crust",
        "source": "USDA",
        "source_link": "https://fdc.nal.usda.gov/food-details/173292/nutrients",
        "calories": "266 Calories",
        "portion": "100 grams"
      }
    },
    "overview": {
      "title": "Pizza",
      "kgmid": "/m/0663v"
    },
    "pagination": [
      {
        "page": 2,
        "start": 10,
        "link": "https://www.google.com/search?q=pizza&sca_esv=016f34706b28a015&hl=en&ei=bgSeaeHvJ_jYkdUP3e2DiAs&start=10&sa=N&sstk=Af77f_f_V2-MUys3284KigNlKSrRMuK2FycXBqPmoWealtPGblbQ6fG6nmOOnuTsIXX5La3IjQVKZgmp72693C-TVdrhH0fPkJks7A&ved=2ahUKEwjh3oW59vKSAxV4bKQEHd32ALEQ8tMDegQICBAE"
      },
      {
        "page": 3,
        "start": 20,
        "link": "https://www.google.com/search?q=pizza&sca_esv=016f34706b28a015&hl=en&ei=bgSeaeHvJ_jYkdUP3e2DiAs&start=20&sa=N&sstk=Af77f_f_V2-MUys3284KigNlKSrRMuK2FycXBqPmoWealtPGblbQ6fG6nmOOnuTsIXX5La3IjQVKZgmp72693C-TVdrhH0fPkJks7A&ved=2ahUKEwjh3oW59vKSAxV4bKQEHd32ALEQ8tMDegQICBAG"
      },
      {
        "page": 4,
        "start": 30,
        "link": "https://www.google.com/search?q=pizza&sca_esv=016f34706b28a015&hl=en&ei=bgSeaeHvJ_jYkdUP3e2DiAs&start=30&sa=N&sstk=Af77f_f_V2-MUys3284KigNlKSrRMuK2FycXBqPmoWealtPGblbQ6fG6nmOOnuTsIXX5La3IjQVKZgmp72693C-TVdrhH0fPkJks7A&ved=2ahUKEwjh3oW59vKSAxV4bKQEHd32ALEQ8tMDegQICBAI"
      }
    ],
    "related": [
      {
        "text": "Pizza recette",
        "link": "https://www.google.com/search?sca_esv=016f34706b28a015&hl=en&q=Pizza+recette&sa=X&ved=2ahUKEwjh3oW59vKSAxV4bKQEHd32ALEQ1QJ6BAhLEAE",
        "rank": 1,
        "global_rank": 14
      },
      {
        "text": "Pizza Hut",
        "link": "https://www.google.com/search?sca_esv=016f34706b28a015&hl=en&q=Pizza+Hut&sa=X&ved=2ahUKEwjh3oW59vKSAxV4bKQEHd32ALEQ1QJ6BAhhEAE",
        "rank": 2,
        "global_rank": 15
      },
      {
        "text": "Pizza Yolo",
        "link": "https://www.google.com/search?sca_esv=016f34706b28a015&hl=en&q=Pizza+Yolo&sa=X&ved=2ahUKEwjh3oW59vKSAxV4bKQEHd32ALEQ1QJ6BAhgEAE",
        "rank": 3,
        "global_rank": 16
      }
    ],
    "people_also_ask": [
      {
        "question": "Quel ingrédient mettre sur une pizza ?",
        "question_link": "https://www.jesuisgastronome.fr/actu/273/la-liste-des-quinze-meilleurs-ingredients-pour-une-pizza",
        "question_type": "featured",
        "answer_source": "JeSuisGastronome.fr",
        "answer_link": "https://www.jesuisgastronome.fr/actu/273/la-liste-des-quinze-meilleurs-ingredients-pour-une-pizza",
        "answer_display_link": "https://www.jesuisgastronome.fr › actu › la-liste-des-quin...https://www.jesuisgastronome.fr › actu › la-liste-des-quin...",
        "answers": [
          {
            "type": "unordered_list",
            "title": "La liste des quinze meilleurs ingrédients pour une pizza",
            "items": [
              {
                "value": "- Le mozzarella fondant.",
                "rank": 1
              },
              {
                "value": "- La fraîcheur du basilic.",
                "rank": 2
              },
              {
                "value": "- L'authentique jambon de Parme.",
                "rank": 3
              },
              {
                "value": "- Le piquant des olives noires.",
                "rank": 4
              },
              {
                "value": "- Apprécier l'anchois salé",
                "rank": 5
              },
              {
                "value": "- Déguster les champignons frais.",
                "rank": 6
              },
              {
                "value": "- Aimer la roquette croquante.",
                "rank": 7
              },
              {
                "value": "- Savourer le saucisson épicé",
                "rank": 8
              }
            ],
            "rank": 1
          }
        ],
        "rank": 1,
        "global_rank": 5
      }
    ],
    "oragnic": [
      {
        "link": "https://fr.wikipedia.org/wiki/Pizza",
        "source": "Wikipédia",
        "display_link": "https://fr.wikipedia.org › wiki › Pi...",
        "title": "Pizza",
        "description": "La pizza est une recette de cuisine traditionnelle de la cuisine italienne, originaire de Naples à base de galette de pâte à pain, garnie principalement ...Read more",
        "snippet_highlighted_words": [
          "pizza"
        ],
        "icon": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAABwAAA...",
        "image": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQABAAD/2w...",
        "image_alt": "pizza from fr.wikipedia.org",
        "image_base64": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQABAAD/2w...",
        "rank": 1,
        "global_rank": 1
      },
      {
        "link": "https://www.marmiton.org/recettes/recette_pizza-maison_313213.aspx",
        "source": "Marmiton",
        "display_link": "https://www.marmiton.org › recettes",
        "title": "Recette de Pizza maison",
        "description": "Partager la recette · Étape 1. Dans un saladier, placez les 300 g de farine, puis la levure, puis le bicarbonate de soude, la pincée de sel et celle de poivre.Read more",
        "extensions": [
          {
            "type": "rating",
            "rating": 5,
            "reviews_cnt": 23,
            "rank": 1
          }
        ],
        "icon": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAABwAAA...",
        "rank": 2,
        "global_rank": 2
      },
      {
        "link": "https://cuisine.journaldesfemmes.fr/recette-pizza",
        "source": "Journal des Femmes",
        "display_link": "https://cuisine.journaldesfemmes.fr › ...",
        "title": "Pizza maison : recettes faciles et savoureuses",
        "description": "Pizza : Meilleures recettes · Pizza chèvre, figues, pistaches et miel · Pizza blanche au saumon fumé et à la cancoillotte · Pizza au salami de Milano et chorizo.Read more",
        "snippet_highlighted_words": [
          "Pizza",
          "Pizza",
          "Pizza",
          "Pizza"
        ],
        "extensions": [
          {
            "type": "rating",
            "rating": 4.3,
            "reviews_cnt": 96,
            "rank": 1
          }
        ],
        "icon": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAABwAAA...",
        "rank": 3,
        "global_rank": 3
      }
    ]
  }
  ```
</ResponseExample>


# Video search
Source: https://docs.brightdata.com/api-reference/serp/google-search/videos

Configure the Bright Data Google Search Video Search parameter to refine queries and return matching results as JSON or HTML. On port 44445.

```http theme={null}
https://www.google.com/search?q=pizza&tbm=vid
```

## Parameters

<ParamField type="string">
  The search query parameter. Specifies the keyword or phrase you want to search for on Google.
</ParamField>

<ParamField type="string">
  Define search type. For Video search, set `tbm` value to `vid`.

  ```http theme={null}
  https://www.google.com/search?q=pizza&tbm=vid
  ```
</ParamField>

<RequestExample>
  ```shell cURL highlight={6} theme={null}
    curl -X POST https://api.brightdata.com/request \
    --header "Content-Type: application/json" \
    --header "Authorization: Bearer API_KEY" \
    --data '{
      "zone": "serp_api1",
      "url": "https://www.google.com/search?q=pizza&tbm=vid",
      "format": "raw"
    }'
  ```

  ```shell Native proxy highlight={4} theme={null}
  curl --proxy brd.superproxy.io:44445 \
    --proxy-user CUSTOMER_USERNAME:CUSTOMER_PASSWORD \
    --ssl-no-revoke \
    "https://www.google.com/search?q=pizza&tbm=vid"
  ```

  ```js Node.js highlight={10} theme={null}
  (async () => {
    const response = await fetch('https://api.brightdata.com/request', {
      method: 'POST',
      headers: {
        'Content-Type': 'application/json',
        'Authorization': 'Bearer API_KEY'
      },
      body: JSON.stringify({
        zone: 'serp_api1',
        url: 'https://www.google.com/search?q=pizza&tbm=vid',
        format: 'raw'
      })
    });
    
    const data = await response.text();
    console.log(data);
  })();
  ```

  ```python Python highlight={11} theme={null}
  import requests

  # API Configuration
  headers = {
      'Content-Type': 'application/json',
      'Authorization': 'Bearer API_KEY',
  }

  payload = {
      'zone': 'serp_api1',
      'url': 'https://www.google.com/search?q=pizza&tbm=vid',
      'format': 'raw'
  }

  # Make the request
  response = requests.post(
      'https://api.brightdata.com/request', 
      json=payload, 
      headers=headers
  )

  print(response.text)
  ```
</RequestExample>

<ResponseExample>
  ```json 200 highlight={11} theme={null}
  {
    "general": {
      "search_engine": "google",
      "query": "pizza",
      "results_cnt": 275000000,
      "search_time": 0.2,
      "language": "en",
      "location": "United States",
      "mobile": false,
      "basic_view": false,
      "search_type": "videos",
      "page_title": "pizza - Google Search",
      "timestamp": "2026-02-25T08:37:05.282Z"
    },
    "input": {
      "original_url": "https://www.google.com/search?q=pizza&tbm=vid&brd_json=1",
      "request_id": "hl_xxxxxxxxxxxxxxx"
    },
    "navigation": [
      {
        "title": "All",
        "href": "https://www.google.com/search?sca_esv=206cd4dd954885db&gl=US&hl=en&q=pizza&source=lnms&fbs=ADc_l-aN0CWEZBOHjofHoaMMDiKpUrv6YeyJhXfuYqj4Fj6c1Tg5t_ufWNUvD2V-uX26AFlqeVA_8cCiKkQH-MFQemrtPKh5DXjDm8xDum7A4wYDWJgscQ2OVXNkKTqqlx9HCssMrDWQeoEQBO4dwrtGUJY4Oy-Z14dRBjPQpDok7I-4oduRsCNHRrO_G3ovy1C5_HZK3cFUgyvFUoxX8cqnfGbb7mjGvQ&sa=X&ved=2ahUKEwjswOPEnvSSAxUTwskDHaQxOJEQ0pQJegQIChAB"
      },
      {
        "title": "Maps",
        "href": "https://maps.google.com/maps?sca_esv=206cd4dd954885db&gl=US&hl=en&output=search&q=pizza&source=lnms&fbs=ADc_l-aN0CWEZBOHjofHoaMMDiKpUrv6YeyJhXfuYqj4Fj6c1Tg5t_ufWNUvD2V-uX26AFlqeVA_8cCiKkQH-MFQemrtPKh5DXjDm8xDum7A4wYDWJgscQ2OVXNkKTqqlx9HCssMrDWQeoEQBO4dwrtGUJY4Oy-Z14dRBjPQpDok7I-4oduRsCNHRrO_G3ovy1C5_HZK3cFUgyvFUoxX8cqnfGbb7mjGvQ&entry=mc&ved=1t:200715&ictx=111"
      },
      {
        "title": "Images",
        "href": "https://www.google.com/search?sca_esv=206cd4dd954885db&gl=US&hl=en&udm=2&fbs=ADc_l-aN0CWEZBOHjofHoaMMDiKpUrv6YeyJhXfuYqj4Fj6c1Tg5t_ufWNUvD2V-uX26AFlqeVA_8cCiKkQH-MFQemrtPKh5DXjDm8xDum7A4wYDWJgscQ2OVXNkKTqqlx9HCssMrDWQeoEQBO4dwrtGUJY4Oy-Z14dRBjPQpDok7I-4oduRsCNHRrO_G3ovy1C5_HZK3cFUgyvFUoxX8cqnfGbb7mjGvQ&q=pizza&sa=X&ved=2ahUKEwjswOPEnvSSAxUTwskDHaQxOJEQtKgLegQIDBAB"
      },
      {
        "title": "Shopping",
        "href": "https://www.google.com/search?sca_esv=206cd4dd954885db&gl=US&hl=en&udm=28&fbs=ADc_l-aN0CWEZBOHjofHoaMMDiKpUrv6YeyJhXfuYqj4Fj6c1Tg5t_ufWNUvD2V-uX26AFlqeVA_8cCiKkQH-MFQemrtPKh5DXjDm8xDum7A4wYDWJgscQ2OVXNkKTqqlx9HCssMrDWQeoEQBO4dwrtGUJY4Oy-Z14dRBjPQpDok7I-4oduRsCNHRrO_G3ovy1C5_HZK3cFUgyvFUoxX8cqnfGbb7mjGvQ&q=pizza&ved=1t:220175&ictx=111"
      },
      {
        "title": "News",
        "href": "https://www.google.com/search?sca_esv=206cd4dd954885db&gl=US&hl=en&q=pizza&tbm=nws&source=lnms&fbs=ADc_l-aN0CWEZBOHjofHoaMMDiKpUrv6YeyJhXfuYqj4Fj6c1Tg5t_ufWNUvD2V-uX26AFlqeVA_8cCiKkQH-MFQemrtPKh5DXjDm8xDum7A4wYDWJgscQ2OVXNkKTqqlx9HCssMrDWQeoEQBO4dwrtGUJY4Oy-Z14dRBjPQpDok7I-4oduRsCNHRrO_G3ovy1C5_HZK3cFUgyvFUoxX8cqnfGbb7mjGvQ&sa=X&ved=2ahUKEwjswOPEnvSSAxUTwskDHaQxOJEQ0pQJegQIDxAB"
      },
      {
        "title": "Forums",
        "href": "https://www.google.com/search?sca_esv=206cd4dd954885db&gl=US&hl=en&udm=18&fbs=ADc_l-aN0CWEZBOHjofHoaMMDiKpUrv6YeyJhXfuYqj4Fj6c1Tg5t_ufWNUvD2V-uX26AFlqeVA_8cCiKkQH-MFQemrtPKh5DXjDm8xDum7A4wYDWJgscQ2OVXNkKTqqlx9HCssMrDWQeoEQBO4dwrtGUJY4Oy-Z14dRBjPQpDok7I-4oduRsCNHRrO_G3ovy1C5_HZK3cFUgyvFUoxX8cqnfGbb7mjGvQ&q=pizza&sa=X&ved=2ahUKEwjswOPEnvSSAxUTwskDHaQxOJEQs6gLegQICxAB"
      },
      {
        "title": "Short videos",
        "href": "https://www.google.com/search?sca_esv=206cd4dd954885db&gl=US&hl=en&udm=39&fbs=ADc_l-aN0CWEZBOHjofHoaMMDiKpUrv6YeyJhXfuYqj4Fj6c1Tg5t_ufWNUvD2V-uX26AFlqeVA_8cCiKkQH-MFQemrtPKh5DXjDm8xDum7A4wYDWJgscQ2OVXNkKTqqlx9HCssMrDWQeoEQBO4dwrtGUJY4Oy-Z14dRBjPQpDok7I-4oduRsCNHRrO_G3ovy1C5_HZK3cFUgyvFUoxX8cqnfGbb7mjGvQ&q=pizza&sa=X&ved=2ahUKEwjswOPEnvSSAxUTwskDHaQxOJEQs6gLegQIJhAB"
      },
      {
        "title": "Web",
        "href": "https://www.google.com/search?sca_esv=206cd4dd954885db&gl=US&hl=en&udm=web&fbs=ADc_l-aN0CWEZBOHjofHoaMMDiKpUrv6YeyJhXfuYqj4Fj6c1Tg5t_ufWNUvD2V-uX26AFlqeVA_8cCiKkQH-MFQemrtPKh5DXjDm8xDum7A4wYDWJgscQ2OVXNkKTqqlx9HCssMrDWQeoEQBO4dwrtGUJY4Oy-Z14dRBjPQpDok7I-4oduRsCNHRrO_G3ovy1C5_HZK3cFUgyvFUoxX8cqnfGbb7mjGvQ&q=pizza&sa=X&ved=2ahUKEwjswOPEnvSSAxUTwskDHaQxOJEQs6gLegQIJxAB"
      },
      {
        "title": "Flights",
        "href": "https://www.google.com/travel/flights?sca_esv=206cd4dd954885db&gl=US&hl=en&output=search&q=pizza&source=lnms&fbs=ADc_l-aN0CWEZBOHjofHoaMMDiKpUrv6YeyJhXfuYqj4Fj6c1Tg5t_ufWNUvD2V-uX26AFlqeVA_8cCiKkQH-MFQemrtPKh5DXjDm8xDum7A4wYDWJgscQ2OVXNkKTqqlx9HCssMrDWQeoEQBO4dwrtGUJY4Oy-Z14dRBjPQpDok7I-4oduRsCNHRrO_G3ovy1C5_HZK3cFUgyvFUoxX8cqnfGbb7mjGvQ&ved=1t:200715&ictx=111"
      }
    ],
    "organic": [
      {
        "link": "https://www.youtube.com/watch?v=h3qO7Jii3BE",
        "source": "www.youtube.com › watch",
        "display_link": "www.youtube.com › watch",
        "title": "How To Make Frozen Pizza Bases Ready Anytime at Home",
        "description": "SUBSCRIBE https://www.youtube.com/user/maestrovitoiacopelli MY MASTER CLASS PIZZA: https://www.master-class.pizza/ Check out ,my new brand ...",
        "image": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQABAAD/2w...",
        "image_base64": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQABAAD/2w...",
        "duration": "10:42",
        "duration_sec": 642,
        "rank": 1,
        "global_rank": 1
      },
      {
        "link": "https://www.youtube.com/watch?v=Bz6tlSbN_GA",
        "source": "www.youtube.com › watch",
        "display_link": "www.youtube.com › watch",
        "title": "Recreating The Takeaway Pizza Of My Childhood",
        "description": "Do you think pizzas have shrunk? The takeaway pizza of my childhood was 100% better than it is now. But we have no proof!",
        "image": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQABAAD/2w...",
        "image_base64": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQABAAD/2w...",
        "duration": "13:55",
        "duration_sec": 835,
        "rank": 2,
        "global_rank": 2
      },
      {
        "link": "https://www.youtube.com/shorts/cpW38_oZG3Q",
        "source": "www.youtube.com › shorts",
        "display_link": "www.youtube.com › shorts",
        "title": "Taco Bell Mexican Pizza Hack",
        "description": "Level up your Taco Tuesdays with this Taco Bell Mexican Pizza! The trick here is to use this simple tortilla hack: fold the tortilla halves ...",
        "image": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQABAAD/2w...",
        "image_base64": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQABAAD/2w...",
        "duration": "0:41",
        "duration_sec": 41,
        "rank": 3,
        "global_rank": 3
      },
      {
        "link": "https://www.youtube.com/watch?v=dsQGMhsvIYY",
        "source": "www.youtube.com › watch",
        "display_link": "www.youtube.com › watch",
        "title": "The Secret To Authentic Neapolitan Pizza",
        "description": "Melt-in-your mouth pizza with fresh, flavorful toppings: this is Neapolitan pizza like an Italian chef would make it. COOK the full recipe ...",
        "image": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQABAAD/2w...",
        "image_base64": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQABAAD/2w...",
        "duration": "12:56",
        "duration_sec": 776,
        "rank": 4,
        "global_rank": 4
      },
      {
        "link": "https://www.youtube.com/watch?v=pT7WRxzK_Og",
        "source": "www.youtube.com › watch",
        "display_link": "www.youtube.com › watch",
        "title": "Family Pizza Night at Its Most Crispy & Cheesy",
        "description": "I made this twice in the last 3 weeks. I have the Lodge 10.25\" cast iron from Amazon that I'll put on a baking steel for 18 minutes. Take the ...",
        "image": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQABAAD/2w...",
        "image_base64": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQABAAD/2w...",
        "duration": "11:51",
        "duration_sec": 711,
        "rank": 5,
        "global_rank": 5
      },
      {
        "link": "https://www.youtube.com/watch?v=m2Uezalybwg",
        "source": "www.youtube.com › watch",
        "display_link": "www.youtube.com › watch",
        "title": "Puff Pastry Pizza Poppers | Crispy One-Bite Party Pizza | Food ...",
        "description": "These easy-to-make, bite-sized puff pastry pizza poppers are the best way (probably the only way?) to enjoy a proper puff pastry pizza.",
        "image": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQABAAD/2w...",
        "image_base64": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQABAAD/2w...",
        "duration": "8:03",
        "duration_sec": 483,
        "rank": 6,
        "global_rank": 6
      },
      {
        "link": "https://www.youtube.com/watch?v=7iWWdSsTI0I",
        "source": "www.youtube.com › watch",
        "display_link": "www.youtube.com › watch",
        "title": "Barstool Pizza Review - Flour + Water Pizzeria (San Francisco ...",
        "description": "Dave tries a pizza place with the rare exception of him like the Neapolitan more than the cheese. Download The One Bite App to see more and ...",
        "image": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQABAAD/2w...",
        "image_base64": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQABAAD/2w...",
        "duration": "4:07",
        "duration_sec": 247,
        "rank": 7,
        "global_rank": 7
      },
      {
        "link": "https://www.youtube.com/watch?v=_5sYXU4QZEU",
        "source": "www.youtube.com › watch",
        "display_link": "www.youtube.com › watch",
        "title": "Barstool Pizza Review - Hi Hat (San Francisco, CA) Bonus ...",
        "description": "Dave tries the highly recommended Hi Hat, and runs into an accidental chocolate chip cookie review that blows his mind.",
        "image": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcRwKpcn5tEt_rbLcahdOAKkvcZFqHlaiZ1BCA5GytAUSt09nwmQpabnKQ&s",
        "image_url": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcRwKpcn5tEt_rbLcahdOAKkvcZFqHlaiZ1BCA5GytAUSt09nwmQpabnKQ&s",
        "duration": "6:58",
        "duration_sec": 418,
        "rank": 8,
        "global_rank": 8
      },
      {
        "link": "https://www.youtube.com/watch?v=wZRdDG2K_mg",
        "source": "www.youtube.com › watch",
        "display_link": "www.youtube.com › watch",
        "title": "School Cafeteria Pizza For Grown-Ups",
        "description": "Thank you Helix Sleep for sponsoring! Visit https://helixsleep.com/emmymade to take advantage of their New Year Final Hours Sale and get 20% ...",
        "image": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcQe5ownYLe3x_j74iBFfxZA2PgliRpMe2l3zyGhZhTkWGN-HEKmPjZRTw&s",
        "image_url": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcQe5ownYLe3x_j74iBFfxZA2PgliRpMe2l3zyGhZhTkWGN-HEKmPjZRTw&s",
        "duration": "19:18",
        "duration_sec": 1158,
        "rank": 9,
        "global_rank": 9
      },
      {
        "link": "https://www.youtube.com/watch?v=zS18jl621yk",
        "source": "www.youtube.com › watch",
        "display_link": "www.youtube.com › watch",
        "title": "Tracy Morgan, Daniel Radcliffe and Erika Alexander: The ...",
        "description": "Welcome back to The Pizza Interview, a series from The New York Times Cooking where the Q&A has a catch: Our guests have to make pizza while ...",
        "image": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcTYvH9JlfVXjhw-Wvd3Lh346VtdK1Az8xHEP9gcKRU8owmDuzplX243PA&s",
        "image_url": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcTYvH9JlfVXjhw-Wvd3Lh346VtdK1Az8xHEP9gcKRU8owmDuzplX243PA&s",
        "duration": "12:41",
        "duration_sec": 761,
        "rank": 10,
        "global_rank": 10
      }
    ],
    "pagination": {
      "next_page_start": 10,
      "next_page_link": "https://www.google.com/search?q=pizza&sca_esv=206cd4dd954885db&gl=US&hl=en&udm=7&ei=sLSeaeyoGZOEp84PpOPgiQk&start=10&sa=N"
    },
    "related": [
      {
        "text": "youtube pizza",
        "link": "https://www.google.com/search?sca_esv=206cd4dd954885db&gl=US&hl=en&udm=7&q=Youtube+Pizza&sa=X&ved=2ahUKEwjswOPEnvSSAxUTwskDHaQxOJEQ1QJ6BAgdEAE",
        "rank": 1,
        "global_rank": 11
      },
      {
        "text": "pizza dough youtube",
        "link": "https://www.google.com/search?sca_esv=206cd4dd954885db&gl=US&hl=en&udm=7&q=Pizza+dough+youtube&sa=X&ved=2ahUKEwjswOPEnvSSAxUTwskDHaQxOJEQ1QJ6BAgeEAE",
        "rank": 2,
        "global_rank": 12
      },
      {
        "text": "nick's kitchen pizza",
        "link": "https://www.google.com/search?sca_esv=206cd4dd954885db&gl=US&hl=en&udm=7&q=Nick%27s+Kitchen+pizza&sa=X&ved=2ahUKEwjswOPEnvSSAxUTwskDHaQxOJEQ1QJ6BAggEAE",
        "rank": 3,
        "global_rank": 13
      },
      {
        "text": "how you make pizza",
        "link": "https://www.google.com/search?sca_esv=206cd4dd954885db&gl=US&hl=en&udm=7&q=How+you+make+pizza&sa=X&ved=2ahUKEwjswOPEnvSSAxUTwskDHaQxOJEQ1QJ6BAghEAE",
        "rank": 4,
        "global_rank": 14
      },
      {
        "text": "new york pizza youtube",
        "link": "https://www.google.com/search?sca_esv=206cd4dd954885db&gl=US&hl=en&udm=7&q=New+York+pizza+youtube&sa=X&ved=2ahUKEwjswOPEnvSSAxUTwskDHaQxOJEQ1QJ6BAgjEAE",
        "rank": 5,
        "global_rank": 15
      },
      {
        "text": "neapolitan pizza dough recipe",
        "link": "https://www.google.com/search?sca_esv=206cd4dd954885db&gl=US&hl=en&udm=7&q=Neapolitan+pizza+dough+recipe&sa=X&ved=2ahUKEwjswOPEnvSSAxUTwskDHaQxOJEQ1QJ6BAgiEAE",
        "rank": 6,
        "global_rank": 16
      },
      {
        "text": "nick's kitchen videos",
        "link": "https://www.google.com/search?sca_esv=206cd4dd954885db&gl=US&hl=en&udm=7&q=Nick%27s+Kitchen+videos&sa=X&ved=2ahUKEwjswOPEnvSSAxUTwskDHaQxOJEQ1QJ6BAgfEAE",
        "rank": 7,
        "global_rank": 17
      },
      {
        "text": "more nick youtube",
        "link": "https://www.google.com/search?sca_esv=206cd4dd954885db&gl=US&hl=en&udm=7&q=More+nick+youtube&sa=X&ved=2ahUKEwjswOPEnvSSAxUTwskDHaQxOJEQ1QJ6BAgcEAE",
        "rank": 8,
        "global_rank": 18
      }
    ]
  }
  ```
</ResponseExample>


# Google Trends async request
Source: https://docs.brightdata.com/api-reference/serp/google-trends/async

Use the Bright Data Google Trends async endpoint (31 languages). Submit a request, poll the job ID and retrieve results as JSON with 200 OK on success.

```txt wrap theme={null}
https://trends.google.com/trends/explore?q=pizza&brd_trends=timeseries,geo_map&brd_json=1
```

<ParamField type="boolean">
  Set `async=true` in the request URL to enable asynchronous requests.

  ```txt wrap theme={null}
  https://api.brightdata.com/request?async=true
  ```
</ParamField>

<Warning>
  Trends supports parsed results only i.e. `brd_json=1`
</Warning>

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

## Parameters

<ParamField type="string">
  The search query parameter. Specifies the keyword or phrase you want to search for on Google.

  ```Example theme={null}
  https://trends.google.com/trends/explore?q=pizza
  ```
</ParamField>

<ParamField type="string">
  To display specific widget data within your Google Trends results, use one of the following widget parameters:

  * `timeseries`: Retrieves the time series widget data.
  * `geo_map`: Retrieves the geo map widget data.

  ```txt wrap theme={null}
  https://trends.google.com/trends/explore?q=pizza&brd_trends=timeseries,geo_map&brd_json=1
  ```

  <Tip>
    **For multiple widgets:** Separate them with a comma. e.g. `timeseries,geo_map`
  </Tip>
</ParamField>

<RequestExample>
  ```shell cURL highlight={1} theme={null}
    curl -X POST https://api.brightdata.com/request?async=true \
    --header "Content-Type: application/json" \
    --header "Authorization: Bearer API_KEY" \
    --data '{
      "zone": "serp_api1",
      "url": "https://trends.google.com/trends/explore?q=pizza&brd_trends=timeseries,geo_map&brd_json=1",
      "format": "raw"
    }'
  ```

  ```shell Native proxy highlight={4} theme={null}
  curl -i --silent --compressed \
    -H "Content-Type: application/json"
    -H "Authorization: Bearer API_KEY" \
    -d $'{"country":"us","query":{"q":"pizza"}}'
    "https://api.brightdata.com/serp/req?customer=CUSTOMER_USERNAME&zone=ZONE_NAME"
  ```

  ```js Node.js highlight={2} theme={null}
  (async () => {
    const response = await fetch('https://api.brightdata.com/request?async=true', {
      method: 'POST',
      headers: {
        'Content-Type': 'application/json',
        'Authorization': 'Bearer API_KEY'
      },
      body: JSON.stringify({
        zone: 'serp_api1',
        url: 'https://trends.google.com/trends/explore?q=pizza&brd_trends=timeseries,geo_map&brd_json=1',
        format: 'raw'
      })
    });
    
    const data = await response.text();
    console.log(data);
  })();
  ```

  ```python Python highlight={17} theme={null}
  import requests

  # API Configuration
  headers = {
      'Content-Type': 'application/json',
      'Authorization': 'Bearer API_KEY',
  }

  payload = {
      'zone': 'serp_api1',
      'url': 'https://trends.google.com/trends/explore?q=pizza&brd_trends=timeseries,geo_map&brd_json=1',
      'format': 'raw'
  }

  # Make the request
  response = requests.post(
      'https://api.brightdata.com/request?async=true', 
      json=payload, 
      headers=headers
  )

  print(response.text)
  ```
</RequestExample>

<ResponseExample>
  ```json 200 theme={null}
  {
    "widgets": [
      {
        "data": {
          "default": {
            "timelineData": [
              {
                "time": "1740268800",
                "formattedTime": "Feb 23 – Mar 1, 2025",
                "formattedAxisTime": "Feb 23, 2025",
                "value": [
                  73
                ],
                "hasData": [
                  true
                ],
                "formattedValue": [
                  "73"
                ]
              },
              {
                "time": "1740873600",
                "formattedTime": "Mar 2 – 8, 2025",
                "formattedAxisTime": "Mar 2, 2025",
                "value": [
                  68
                ],
                "hasData": [
                  true
                ],
                "formattedValue": [
                  "68"
                ]
              },
              {
                "time": "1741478400",
                "formattedTime": "Mar 9 – 15, 2025",
                "formattedAxisTime": "Mar 9, 2025",
                "value": [
                  69
                ],
                "hasData": [
                  true
                ],
                "formattedValue": [
                  "69"
                ]
              },
              {
                "time": "1742083200",
                "formattedTime": "Mar 16 – 22, 2025",
                "formattedAxisTime": "Mar 16, 2025",
                "value": [
                  70
                ],
                "hasData": [
                  true
                ],
                "formattedValue": [
                  "70"
                ]
              },
              {
                "time": "1742688000",
                "formattedTime": "Mar 23 – 29, 2025",
                "formattedAxisTime": "Mar 23, 2025",
                "value": [
                  69
                ],
                "hasData": [
                  true
                ],
                "formattedValue": [
                  "69"
                ]
              },
              {
                "time": "1743292800",
                "formattedTime": "Mar 30 – Apr 5, 2025",
                "formattedAxisTime": "Mar 30, 2025",
                "value": [
                  73
                ],
                "hasData": [
                  true
                ],
                "formattedValue": [
                  "73"
                ]
              },
              {
                "time": "1743897600",
                "formattedTime": "Apr 6 – 12, 2025",
                "formattedAxisTime": "Apr 6, 2025",
                "value": [
                  67
                ],
                "hasData": [
                  true
                ],
                "formattedValue": [
                  "67"
                ]
              },
              {
                "time": "1744502400",
                "formattedTime": "Apr 13 – 19, 2025",
                "formattedAxisTime": "Apr 13, 2025",
                "value": [
                  71
                ],
                "hasData": [
                  true
                ],
                "formattedValue": [
                  "71"
                ]
              },
              {
                "time": "1745107200",
                "formattedTime": "Apr 20 – 26, 2025",
                "formattedAxisTime": "Apr 20, 2025",
                "value": [
                  71
                ],
                "hasData": [
                  true
                ],
                "formattedValue": [
                  "71"
                ]
              },
              {
                "time": "1745712000",
                "formattedTime": "Apr 27 – May 3, 2025",
                "formattedAxisTime": "Apr 27, 2025",
                "value": [
                  67
                ],
                "hasData": [
                  true
                ],
                "formattedValue": [
                  "67"
                ]
              }
            ],
            "averages": []
          }
        },
        "id": "TIMESERIES",
        "type": "fe_line_chart",
        "title": "Interest over time"
      },
      {
        "data": {
          "default": {
            "geoMapData": [
              {
                "geoCode": "PR",
                "geoName": "Puerto Rico",
                "value": [
                  100
                ],
                "formattedValue": [
                  "100"
                ],
                "maxValueIndex": 0,
                "hasData": [
                  true
                ]
              },
              {
                "geoCode": "IE",
                "geoName": "Ireland",
                "value": [
                  89
                ],
                "formattedValue": [
                  "89"
                ],
                "maxValueIndex": 0,
                "hasData": [
                  true
                ]
              },
              {
                "geoCode": "MF",
                "geoName": "St. Martin",
                "value": [
                  0
                ],
                "formattedValue": [
                  ""
                ],
                "maxValueIndex": 0,
                "hasData": [
                  false
                ]
              },
              {
                "geoCode": "VI",
                "geoName": "U.S. Virgin Islands",
                "value": [
                  0
                ],
                "formattedValue": [
                  ""
                ],
                "maxValueIndex": 0,
                "hasData": [
                  false
                ]
              },
              {
                "geoCode": "CA",
                "geoName": "Canada",
                "value": [
                  78
                ],
                "formattedValue": [
                  "78"
                ],
                "maxValueIndex": 0,
                "hasData": [
                  true
                ]
              },
              {
                "geoCode": "US",
                "geoName": "United States",
                "value": [
                  73
                ],
                "formattedValue": [
                  "73"
                ],
                "maxValueIndex": 0,
                "hasData": [
                  true
                ]
              },
              {
                "geoCode": "SX",
                "geoName": "Sint Maarten",
                "value": [
                  0
                ],
                "formattedValue": [
                  ""
                ],
                "maxValueIndex": 0,
                "hasData": [
                  false
                ]
              },
              {
                "geoCode": "BL",
                "geoName": "St. Barthélemy",
                "value": [
                  0
                ],
                "formattedValue": [
                  ""
                ],
                "maxValueIndex": 0,
                "hasData": [
                  false
                ]
              },
              {
                "geoCode": "AG",
                "geoName": "Antigua & Barbuda",
                "value": [
                  0
                ],
                "formattedValue": [
                  ""
                ],
                "maxValueIndex": 0,
                "hasData": [
                  false
                ]
              },
              {
                "geoCode": "MQ",
                "geoName": "Martinique",
                "value": [
                  0
                ],
                "formattedValue": [
                  ""
                ],
                "maxValueIndex": 0,
                "hasData": [
                  false
                ]
              }
            ]
          }
        },
        "id": "GEO_MAP",
        "type": "fe_geo_chart_explore",
        "title": "Interest by region"
      },
      {
        "data": {
          "default": {
            "rankedList": [
              {
                "rankedKeyword": [
                  {
                    "query": "pizza hut",
                    "value": 100,
                    "formattedValue": "100",
                    "hasData": true,
                    "link": "/trends/explore?q=pizza+hut&date=today+12-m"
                  },
                  {
                    "query": "pizza near me",
                    "value": 85,
                    "formattedValue": "85",
                    "hasData": true,
                    "link": "/trends/explore?q=pizza+near+me&date=today+12-m"
                  },
                  {
                    "query": "dominos pizza",
                    "value": 31,
                    "formattedValue": "31",
                    "hasData": true,
                    "link": "/trends/explore?q=dominos+pizza&date=today+12-m"
                  },
                  {
                    "query": "dominos",
                    "value": 30,
                    "formattedValue": "30",
                    "hasData": true,
                    "link": "/trends/explore?q=dominos&date=today+12-m"
                  },
                  {
                    "query": "domino's pizza",
                    "value": 24,
                    "formattedValue": "24",
                    "hasData": true,
                    "link": "/trends/explore?q=domino's+pizza&date=today+12-m"
                  },
                  {
                    "query": "pizza oven",
                    "value": 17,
                    "formattedValue": "17",
                    "hasData": true,
                    "link": "/trends/explore?q=pizza+oven&date=today+12-m"
                  },
                  {
                    "query": "pizza dough",
                    "value": 17,
                    "formattedValue": "17",
                    "hasData": true,
                    "link": "/trends/explore?q=pizza+dough&date=today+12-m"
                  },
                  {
                    "query": "pizza delivery",
                    "value": 15,
                    "formattedValue": "15",
                    "hasData": true,
                    "link": "/trends/explore?q=pizza+delivery&date=today+12-m"
                  },
                  {
                    "query": "city pizza",
                    "value": 12,
                    "formattedValue": "12",
                    "hasData": true,
                    "link": "/trends/explore?q=city+pizza&date=today+12-m"
                  },
                  {
                    "query": "pizza house",
                    "value": 12,
                    "formattedValue": "12",
                    "hasData": true,
                    "link": "/trends/explore?q=pizza+house&date=today+12-m"
                  },
                  {
                    "query": "best pizza near me",
                    "value": 12,
                    "formattedValue": "12",
                    "hasData": true,
                    "link": "/trends/explore?q=best+pizza+near+me&date=today+12-m"
                  },
                  {
                    "query": "crust pizza",
                    "value": 12,
                    "formattedValue": "12",
                    "hasData": true,
                    "link": "/trends/explore?q=crust+pizza&date=today+12-m"
                  },
                  {
                    "query": "pizza time",
                    "value": 11,
                    "formattedValue": "11",
                    "hasData": true,
                    "link": "/trends/explore?q=pizza+time&date=today+12-m"
                  },
                  {
                    "query": "pizza place",
                    "value": 10,
                    "formattedValue": "10",
                    "hasData": true,
                    "link": "/trends/explore?q=pizza+place&date=today+12-m"
                  },
                  {
                    "query": "express pizza",
                    "value": 9,
                    "formattedValue": "9",
                    "hasData": true,
                    "link": "/trends/explore?q=express+pizza&date=today+12-m"
                  },
                  {
                    "query": "new york pizza",
                    "value": 9,
                    "formattedValue": "9",
                    "hasData": true,
                    "link": "/trends/explore?q=new+york+pizza&date=today+12-m"
                  },
                  {
                    "query": "pizza places",
                    "value": 8,
                    "formattedValue": "8",
                    "hasData": true,
                    "link": "/trends/explore?q=pizza+places&date=today+12-m"
                  },
                  {
                    "query": "chicago pizza",
                    "value": 7,
                    "formattedValue": "7",
                    "hasData": true,
                    "link": "/trends/explore?q=chicago+pizza&date=today+12-m"
                  },
                  {
                    "query": "boston pizza",
                    "value": 7,
                    "formattedValue": "7",
                    "hasData": true,
                    "link": "/trends/explore?q=boston+pizza&date=today+12-m"
                  },
                  {
                    "query": "papa johns pizza",
                    "value": 7,
                    "formattedValue": "7",
                    "hasData": true,
                    "link": "/trends/explore?q=papa+johns+pizza&date=today+12-m"
                  },
                  {
                    "query": "pizza hut near me",
                    "value": 7,
                    "formattedValue": "7",
                    "hasData": true,
                    "link": "/trends/explore?q=pizza+hut+near+me&date=today+12-m"
                  },
                  {
                    "query": "pizza sauce",
                    "value": 7,
                    "formattedValue": "7",
                    "hasData": true,
                    "link": "/trends/explore?q=pizza+sauce&date=today+12-m"
                  },
                  {
                    "query": "pizza shop",
                    "value": 7,
                    "formattedValue": "7",
                    "hasData": true,
                    "link": "/trends/explore?q=pizza+shop&date=today+12-m"
                  },
                  {
                    "query": "pizza company",
                    "value": 7,
                    "formattedValue": "7",
                    "hasData": true,
                    "link": "/trends/explore?q=pizza+company&date=today+12-m"
                  },
                  {
                    "query": "little caesars pizza",
                    "value": 6,
                    "formattedValue": "6",
                    "hasData": true,
                    "link": "/trends/explore?q=little+caesars+pizza&date=today+12-m"
                  }
                ]
              },
              {
                "rankedKeyword": [
                  {
                    "query": "pentagon pizza index",
                    "value": 2650,
                    "formattedValue": "+2,650%",
                    "link": "/trends/explore?q=pentagon+pizza+index&date=today+12-m"
                  },
                  {
                    "query": "pizza napoletana near me",
                    "value": 2600,
                    "formattedValue": "+2,600%",
                    "link": "/trends/explore?q=pizza+napoletana+near+me&date=today+12-m"
                  },
                  {
                    "query": "how to make pizza dough at home",
                    "value": 2450,
                    "formattedValue": "+2,450%",
                    "link": "/trends/explore?q=how+to+make+pizza+dough+at+home&date=today+12-m"
                  },
                  {
                    "query": "what is a pizza stone",
                    "value": 1800,
                    "formattedValue": "+1,800%",
                    "link": "/trends/explore?q=what+is+a+pizza+stone&date=today+12-m"
                  },
                  {
                    "query": "best pizza near me open now",
                    "value": 1750,
                    "formattedValue": "+1,750%",
                    "link": "/trends/explore?q=best+pizza+near+me+open+now&date=today+12-m"
                  },
                  {
                    "query": "pizza calzone near me",
                    "value": 1450,
                    "formattedValue": "+1,450%",
                    "link": "/trends/explore?q=pizza+calzone+near+me&date=today+12-m"
                  },
                  {
                    "query": "gluten free pizza crust recipe",
                    "value": 1450,
                    "formattedValue": "+1,450%",
                    "link": "/trends/explore?q=gluten+free+pizza+crust+recipe&date=today+12-m"
                  },
                  {
                    "query": "pizza margherita near me",
                    "value": 1000,
                    "formattedValue": "+1,000%",
                    "link": "/trends/explore?q=pizza+margherita+near+me&date=today+12-m"
                  },
                  {
                    "query": "best deep dish pizza in chicago",
                    "value": 900,
                    "formattedValue": "+900%",
                    "link": "/trends/explore?q=best+deep+dish+pizza+in+chicago&date=today+12-m"
                  },
                  {
                    "query": "best pizza near me",
                    "value": 350,
                    "formattedValue": "+350%",
                    "link": "/trends/explore?q=best+pizza+near+me&date=today+12-m"
                  },
                  {
                    "query": "pizza delivered",
                    "value": 250,
                    "formattedValue": "+250%",
                    "link": "/trends/explore?q=pizza+delivered&date=today+12-m"
                  },
                  {
                    "query": "how to reheat pizza",
                    "value": 160,
                    "formattedValue": "+160%",
                    "link": "/trends/explore?q=how+to+reheat+pizza&date=today+12-m"
                  },
                  {
                    "query": "order pizza near me",
                    "value": 60,
                    "formattedValue": "+60%",
                    "link": "/trends/explore?q=order+pizza+near+me&date=today+12-m"
                  },
                  {
                    "query": "pizza time",
                    "value": 60,
                    "formattedValue": "+60%",
                    "link": "/trends/explore?q=pizza+time&date=today+12-m"
                  },
                  {
                    "query": "pizza company",
                    "value": 50,
                    "formattedValue": "+50%",
                    "link": "/trends/explore?q=pizza+company&date=today+12-m"
                  },
                  {
                    "query": "pizza takeaway",
                    "value": 50,
                    "formattedValue": "+50%",
                    "link": "/trends/explore?q=pizza+takeaway&date=today+12-m"
                  },
                  {
                    "query": "pepperoni pizza",
                    "value": 40,
                    "formattedValue": "+40%",
                    "link": "/trends/explore?q=pepperoni+pizza&date=today+12-m"
                  },
                  {
                    "query": "pizza deals near me",
                    "value": 40,
                    "formattedValue": "+40%",
                    "link": "/trends/explore?q=pizza+deals+near+me&date=today+12-m"
                  },
                  {
                    "query": "order pizza",
                    "value": 40,
                    "formattedValue": "+40%",
                    "link": "/trends/explore?q=order+pizza&date=today+12-m"
                  }
                ]
              }
            ]
          }
        },
        "id": "RELATED_QUERIES",
        "type": "fe_related_searches",
        "title": "Related queries"
      }
    ],
    "keywords": [
      {
        "keyword": "pizza",
        "name": "pizza",
        "type": "Search term"
      }
    ]
  }
  ```
</ResponseExample>


# Category
Source: https://docs.brightdata.com/api-reference/serp/google-trends/category

Configure the Bright Data Google Trends Category parameter to refine queries and return matching results as JSON or HTML. On port 44445.

```txt wrap theme={null}
https://trends.google.com/trends/explore?q=pizza&cat=3&brd_trends=timeseries,geo_map&brd_json=1
```

## Parameters

<ParamField type="string">
  The search query parameter. Specifies the keyword or phrase you want to search for on Google.
</ParamField>

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

  ```txt wrap theme={null}
  https://trends.google.com/trends/explore?q=pizza&cat=3&brd_trends=timeseries,geo_map&brd_json=1
  ```
</ParamField>

<RequestExample>
  ```shell cURL highlight={6} theme={null}
    curl -X POST https://api.brightdata.com/request \
    --header "Content-Type: application/json" \
    --header "Authorization: Bearer API_KEY" \
    --data '{
      "zone": "serp_api1",
      "url": "https://trends.google.com/trends/explore?q=pizza&cat=3&brd_trends=timeseries,geo_map&brd_json=1",
      "format": "raw"
    }'
  ```

  ```shell Native proxy highlight={4} theme={null}
  curl --proxy brd.superproxy.io:44445 \
    --proxy-user CUSTOMER_USERNAME:CUSTOMER_PASSWORD \
    --ssl-no-revoke \
    "https://trends.google.com/trends/explore?q=pizza&cat=3&brd_trends=timeseries,geo_map&brd_json=1"
  ```

  ```js Node.js highlight={10} theme={null}
  (async () => {
    const response = await fetch('https://api.brightdata.com/request', {
      method: 'POST',
      headers: {
        'Content-Type': 'application/json',
        'Authorization': 'Bearer API_KEY'
      },
      body: JSON.stringify({
        zone: 'serp_api1',
        url: 'https://trends.google.com/trends/explore?q=pizza&cat=3&brd_trends=timeseries,geo_map&brd_json=1',
        format: 'raw'
      })
    });
    
    const data = await response.text();
    console.log(data);
  })();
  ```

  ```python Python highlight={11} theme={null}
  import requests

  # API Configuration
  headers = {
      'Content-Type': 'application/json',
      'Authorization': 'Bearer API_KEY',
  }

  payload = {
      'zone': 'serp_api1',
      'url': 'https://trends.google.com/trends/explore?q=pizza&cat=3&brd_trends=timeseries,geo_map&brd_json=1',
      'format': 'raw'
  }

  # Make the request
  response = requests.post(
      'https://api.brightdata.com/request', 
      json=payload, 
      headers=headers
  )

  print(response.text)
  ```
</RequestExample>

<ResponseExample>
  ```json 200 theme={null}
  {
    "widgets": [
      {
        "data": {
          "default": {
            "timelineData": [
              {
                "time": "1740268800",
                "formattedTime": "Feb 23 – Mar 1, 2025",
                "formattedAxisTime": "Feb 23, 2025",
                "value": [
                  72
                ],
                "hasData": [
                  true
                ],
                "formattedValue": [
                  "72"
                ]
              },
              {
                "time": "1740873600",
                "formattedTime": "Mar 2 – 8, 2025",
                "formattedAxisTime": "Mar 2, 2025",
                "value": [
                  74
                ],
                "hasData": [
                  true
                ],
                "formattedValue": [
                  "74"
                ]
              },
              {
                "time": "1741478400",
                "formattedTime": "Mar 9 – 15, 2025",
                "formattedAxisTime": "Mar 9, 2025",
                "value": [
                  74
                ],
                "hasData": [
                  true
                ],
                "formattedValue": [
                  "74"
                ]
              },
              {
                "time": "1742083200",
                "formattedTime": "Mar 16 – 22, 2025",
                "formattedAxisTime": "Mar 16, 2025",
                "value": [
                  74
                ],
                "hasData": [
                  true
                ],
                "formattedValue": [
                  "74"
                ]
              },
              {
                "time": "1742688000",
                "formattedTime": "Mar 23 – 29, 2025",
                "formattedAxisTime": "Mar 23, 2025",
                "value": [
                  74
                ],
                "hasData": [
                  true
                ],
                "formattedValue": [
                  "74"
                ]
              },
              {
                "time": "1743292800",
                "formattedTime": "Mar 30 – Apr 5, 2025",
                "formattedAxisTime": "Mar 30, 2025",
                "value": [
                  78
                ],
                "hasData": [
                  true
                ],
                "formattedValue": [
                  "78"
                ]
              },
              {
                "time": "1743897600",
                "formattedTime": "Apr 6 – 12, 2025",
                "formattedAxisTime": "Apr 6, 2025",
                "value": [
                  77
                ],
                "hasData": [
                  true
                ],
                "formattedValue": [
                  "77"
                ]
              },
              {
                "time": "1744502400",
                "formattedTime": "Apr 13 – 19, 2025",
                "formattedAxisTime": "Apr 13, 2025",
                "value": [
                  77
                ],
                "hasData": [
                  true
                ],
                "formattedValue": [
                  "77"
                ]
              },
              {
                "time": "1745107200",
                "formattedTime": "Apr 20 – 26, 2025",
                "formattedAxisTime": "Apr 20, 2025",
                "value": [
                  73
                ],
                "hasData": [
                  true
                ],
                "formattedValue": [
                  "73"
                ]
              },
              {
                "time": "1745712000",
                "formattedTime": "Apr 27 – May 3, 2025",
                "formattedAxisTime": "Apr 27, 2025",
                "value": [
                  79
                ],
                "hasData": [
                  true
                ],
                "formattedValue": [
                  "79"
                ]
              }
            ],
            "averages": []
          }
        },
        "id": "TIMESERIES",
        "type": "fe_line_chart",
        "title": "Interest over time"
      },
      {
        "data": {
          "default": {
            "geoMapData": [
              {
                "geoCode": "AS",
                "geoName": "American Samoa",
                "value": [
                  0
                ],
                "formattedValue": [
                  ""
                ],
                "maxValueIndex": 0,
                "hasData": [
                  false
                ]
              },
              {
                "geoCode": "GF",
                "geoName": "French Guiana",
                "value": [
                  0
                ],
                "formattedValue": [
                  ""
                ],
                "maxValueIndex": 0,
                "hasData": [
                  false
                ]
              },
              {
                "geoCode": "BL",
                "geoName": "St. Barthélemy",
                "value": [
                  0
                ],
                "formattedValue": [
                  ""
                ],
                "maxValueIndex": 0,
                "hasData": [
                  false
                ]
              },
              {
                "geoCode": "GP",
                "geoName": "Guadeloupe",
                "value": [
                  0
                ],
                "formattedValue": [
                  ""
                ],
                "maxValueIndex": 0,
                "hasData": [
                  false
                ]
              },
              {
                "geoCode": "VI",
                "geoName": "U.S. Virgin Islands",
                "value": [
                  0
                ],
                "formattedValue": [
                  ""
                ],
                "maxValueIndex": 0,
                "hasData": [
                  false
                ]
              },
              {
                "geoCode": "AG",
                "geoName": "Antigua & Barbuda",
                "value": [
                  0
                ],
                "formattedValue": [
                  ""
                ],
                "maxValueIndex": 0,
                "hasData": [
                  false
                ]
              },
              {
                "geoCode": "SK",
                "geoName": "Slovakia",
                "value": [
                  100
                ],
                "formattedValue": [
                  "100"
                ],
                "maxValueIndex": 0,
                "hasData": [
                  true
                ]
              },
              {
                "geoCode": "YT",
                "geoName": "Mayotte",
                "value": [
                  0
                ],
                "formattedValue": [
                  ""
                ],
                "maxValueIndex": 0,
                "hasData": [
                  false
                ]
              },
              {
                "geoCode": "BM",
                "geoName": "Bermuda",
                "value": [
                  0
                ],
                "formattedValue": [
                  ""
                ],
                "maxValueIndex": 0,
                "hasData": [
                  false
                ]
              },
              {
                "geoCode": "SM",
                "geoName": "San Marino",
                "value": [
                  0
                ],
                "formattedValue": [
                  ""
                ],
                "maxValueIndex": 0,
                "hasData": [
                  false
                ]
              }
            ]
          }
        },
        "id": "GEO_MAP",
        "type": "fe_geo_chart_explore",
        "title": "Interest by region"
      }
    ],
    "keywords": [
      {
        "keyword": "pizza",
        "name": "pizza",
        "type": "Search term"
      }
    ]
  }
  ```
</ResponseExample>


# Geo
Source: https://docs.brightdata.com/api-reference/serp/google-trends/geo

Reference for the Bright Data Google Trends Geo parameter. Refines queries and returns matching results as JSON or HTML. On port 44445.

```txt wrap theme={null}
https://trends.google.com/trends/explore?q=pizza&geo=us&brd_trends=timeseries,geo_map&brd_json=1
```

## Parameters

<ParamField type="string">
  The search query parameter. Specifies the keyword or phrase you want to search for on Google.
</ParamField>

<ParamField type="string">
  Location of interest, two-letter country code

  ```txt wrap theme={null}
  https://trends.google.com/trends/explore?q=pizza&geo=us&brd_trends=timeseries,geo_map&brd_json=1
  ```
</ParamField>

<RequestExample>
  ```shell cURL highlight={6} theme={null}
    curl -X POST https://api.brightdata.com/request \
    --header "Content-Type: application/json" \
    --header "Authorization: Bearer API_KEY" \
    --data '{
      "zone": "serp_api1",
      "url": "https://trends.google.com/trends/explore?q=pizza&geo=us&brd_trends=timeseries,geo_map&brd_json=1",
      "format": "raw"
    }'
  ```

  ```shell Native proxy highlight={4} theme={null}
  curl --proxy brd.superproxy.io:44445 \
    --proxy-user CUSTOMER_USERNAME:CUSTOMER_PASSWORD \
    --ssl-no-revoke \
    "https://trends.google.com/trends/explore?q=pizza&geo=us&brd_trends=timeseries,geo_map&brd_json=1"
  ```

  ```js Node.js highlight={10} theme={null}
  (async () => {
    const response = await fetch('https://api.brightdata.com/request', {
      method: 'POST',
      headers: {
        'Content-Type': 'application/json',
        'Authorization': 'Bearer API_KEY'
      },
      body: JSON.stringify({
        zone: 'serp_api1',
        url: 'https://trends.google.com/trends/explore?q=pizza&geo=us&brd_trends=timeseries,geo_map&brd_json=1',
        format: 'raw'
      })
    });
    
    const data = await response.text();
    console.log(data);
  })();
  ```

  ```python Python highlight={11} theme={null}
  import requests

  # API Configuration
  headers = {
      'Content-Type': 'application/json',
      'Authorization': 'Bearer API_KEY',
  }

  payload = {
      'zone': 'serp_api1',
      'url': 'https://trends.google.com/trends/explore?q=pizza&geo=us&brd_trends=timeseries,geo_map&brd_json=1',
      'format': 'raw'
  }

  # Make the request
  response = requests.post(
      'https://api.brightdata.com/request', 
      json=payload, 
      headers=headers
  )

  print(response.text)
  ```
</RequestExample>

<ResponseExample>
  ```json 200 theme={null}
  {
    "widgets": [
      {
        "data": {
          "default": {
            "timelineData": [
              {
                "time": "1740268800",
                "formattedTime": "Feb 23 – Mar 1, 2025",
                "formattedAxisTime": "Feb 23, 2025",
                "value": [
                  80
                ],
                "hasData": [
                  true
                ],
                "formattedValue": [
                  "80"
                ]
              },
              {
                "time": "1740873600",
                "formattedTime": "Mar 2 – 8, 2025",
                "formattedAxisTime": "Mar 2, 2025",
                "value": [
                  75
                ],
                "hasData": [
                  true
                ],
                "formattedValue": [
                  "75"
                ]
              },
              {
                "time": "1741478400",
                "formattedTime": "Mar 9 – 15, 2025",
                "formattedAxisTime": "Mar 9, 2025",
                "value": [
                  83
                ],
                "hasData": [
                  true
                ],
                "formattedValue": [
                  "83"
                ]
              },
              {
                "time": "1742083200",
                "formattedTime": "Mar 16 – 22, 2025",
                "formattedAxisTime": "Mar 16, 2025",
                "value": [
                  79
                ],
                "hasData": [
                  true
                ],
                "formattedValue": [
                  "79"
                ]
              },
              {
                "time": "1742688000",
                "formattedTime": "Mar 23 – 29, 2025",
                "formattedAxisTime": "Mar 23, 2025",
                "value": [
                  79
                ],
                "hasData": [
                  true
                ],
                "formattedValue": [
                  "79"
                ]
              },
              {
                "time": "1743292800",
                "formattedTime": "Mar 30 – Apr 5, 2025",
                "formattedAxisTime": "Mar 30, 2025",
                "value": [
                  81
                ],
                "hasData": [
                  true
                ],
                "formattedValue": [
                  "81"
                ]
              },
              {
                "time": "1743897600",
                "formattedTime": "Apr 6 – 12, 2025",
                "formattedAxisTime": "Apr 6, 2025",
                "value": [
                  76
                ],
                "hasData": [
                  true
                ],
                "formattedValue": [
                  "76"
                ]
              },
              {
                "time": "1744502400",
                "formattedTime": "Apr 13 – 19, 2025",
                "formattedAxisTime": "Apr 13, 2025",
                "value": [
                  79
                ],
                "hasData": [
                  true
                ],
                "formattedValue": [
                  "79"
                ]
              },
              {
                "time": "1745107200",
                "formattedTime": "Apr 20 – 26, 2025",
                "formattedAxisTime": "Apr 20, 2025",
                "value": [
                  76
                ],
                "hasData": [
                  true
                ],
                "formattedValue": [
                  "76"
                ]
              },
              {
                "time": "1745712000",
                "formattedTime": "Apr 27 – May 3, 2025",
                "formattedAxisTime": "Apr 27, 2025",
                "value": [
                  77
                ],
                "hasData": [
                  true
                ],
                "formattedValue": [
                  "77"
                ]
              }
            ],
            "averages": []
          }
        },
        "id": "TIMESERIES",
        "type": "fe_line_chart",
        "title": "Interest over time"
      },
      {
        "data": {
          "default": {
            "geoMapData": [
              {
                "geoCode": "US-RI",
                "geoName": "Rhode Island",
                "value": [
                  100
                ],
                "formattedValue": [
                  "100"
                ],
                "maxValueIndex": 0,
                "hasData": [
                  true
                ]
              },
              {
                "geoCode": "US-CT",
                "geoName": "Connecticut",
                "value": [
                  99
                ],
                "formattedValue": [
                  "99"
                ],
                "maxValueIndex": 0,
                "hasData": [
                  true
                ]
              },
              {
                "geoCode": "US-DE",
                "geoName": "Delaware",
                "value": [
                  99
                ],
                "formattedValue": [
                  "99"
                ],
                "maxValueIndex": 0,
                "hasData": [
                  true
                ]
              },
              {
                "geoCode": "US-PA",
                "geoName": "Pennsylvania",
                "value": [
                  96
                ],
                "formattedValue": [
                  "96"
                ],
                "maxValueIndex": 0,
                "hasData": [
                  true
                ]
              },
              {
                "geoCode": "US-MA",
                "geoName": "Massachusetts",
                "value": [
                  93
                ],
                "formattedValue": [
                  "93"
                ],
                "maxValueIndex": 0,
                "hasData": [
                  true
                ]
              },
              {
                "geoCode": "US-OH",
                "geoName": "Ohio",
                "value": [
                  91
                ],
                "formattedValue": [
                  "91"
                ],
                "maxValueIndex": 0,
                "hasData": [
                  true
                ]
              },
              {
                "geoCode": "US-NH",
                "geoName": "New Hampshire",
                "value": [
                  91
                ],
                "formattedValue": [
                  "91"
                ],
                "maxValueIndex": 0,
                "hasData": [
                  true
                ]
              },
              {
                "geoCode": "US-MI",
                "geoName": "Michigan",
                "value": [
                  84
                ],
                "formattedValue": [
                  "84"
                ],
                "maxValueIndex": 0,
                "hasData": [
                  true
                ]
              },
              {
                "geoCode": "US-IN",
                "geoName": "Indiana",
                "value": [
                  82
                ],
                "formattedValue": [
                  "82"
                ],
                "maxValueIndex": 0,
                "hasData": [
                  true
                ]
              },
              {
                "geoCode": "US-WV",
                "geoName": "West Virginia",
                "value": [
                  79
                ],
                "formattedValue": [
                  "79"
                ],
                "maxValueIndex": 0,
                "hasData": [
                  true
                ]
              }
            ]
          }
        },
        "id": "GEO_MAP",
        "type": "fe_geo_chart_explore",
        "title": "Interest by subregion"
      },
      {
        "data": {
          "default": {
            "rankedList": [
              {
                "rankedKeyword": []
              },
              {
                "rankedKeyword": []
              }
            ]
          }
        },
        "id": "RELATED_QUERIES",
        "type": "fe_related_searches",
        "title": "Related queries"
      }
    ],
    "keywords": [
      {
        "keyword": "pizza",
        "name": "pizza",
        "type": "Search term"
      }
    ]
  }
  ```
</ResponseExample>


# Google Trends localization
Source: https://docs.brightdata.com/api-reference/serp/google-trends/localization

Configure the Bright Data Google Trends Google Trends localization parameter to refine queries and return matching results as JSON or HTML. On port 44445.

```txt wrap theme={null}
https://trends.google.com/trends/explore?q=pizza&hl=de&brd_trends=timeseries,geo_map&brd_json=1
```

## Parameters

<ParamField type="string">
  The search query parameter. Specifies the keyword or phrase you want to search for on Google.
</ParamField>

<ParamField type="string">
  Two-letter language code used to define the page languages

  ```txt wrap theme={null}
  https://trends.google.com/trends/explore?q=pizza&hl=de&brd_trends=timeseries,geo_map&brd_json=1
  ```
</ParamField>

<RequestExample>
  ```shell cURL highlight={6} theme={null}
    curl -X POST https://api.brightdata.com/request \
    --header "Content-Type: application/json" \
    --header "Authorization: Bearer API_KEY" \
    --data '{
      "zone": "serp_api1",
      "url": "https://trends.google.com/trends/explore?q=pizza&hl=de&brd_trends=timeseries,geo_map&brd_json=1",
      "format": "raw"
    }'
  ```

  ```shell Native proxy highlight={4} theme={null}
  curl --proxy brd.superproxy.io:44445 \
    --proxy-user CUSTOMER_USERNAME:CUSTOMER_PASSWORD \
    --ssl-no-revoke \
    "https://trends.google.com/trends/explore?q=pizza&hl=de&brd_trends=timeseries,geo_map&brd_json=1"
  ```

  ```js Node.js highlight={10} theme={null}
  (async () => {
    const response = await fetch('https://api.brightdata.com/request', {
      method: 'POST',
      headers: {
        'Content-Type': 'application/json',
        'Authorization': 'Bearer API_KEY'
      },
      body: JSON.stringify({
        zone: 'serp_api1',
        url: 'https://trends.google.com/trends/explore?q=pizza&hl=de&brd_trends=timeseries,geo_map&brd_json=1',
        format: 'raw'
      })
    });
    
    const data = await response.text();
    console.log(data);
  })();
  ```

  ```python Python highlight={11} theme={null}
  import requests

  # API Configuration
  headers = {
      'Content-Type': 'application/json',
      'Authorization': 'Bearer API_KEY',
  }

  payload = {
      'zone': 'serp_api1',
      'url': 'https://trends.google.com/trends/explore?q=pizza&hl=de&brd_trends=timeseries,geo_map&brd_json=1',
      'format': 'raw'
  }

  # Make the request
  response = requests.post(
      'https://api.brightdata.com/request', 
      json=payload, 
      headers=headers
  )

  print(response.text)
  ```
</RequestExample>

<ResponseExample>
  ```json 200 theme={null}
  {
    "widgets": [
      {
        "data": {
          "default": {
            "timelineData": [
              {
                "time": "1740268800",
                "formattedTime": "23. Feb. – 1. März 2025",
                "formattedAxisTime": "23.02.2025",
                "value": [
                  73
                ],
                "hasData": [
                  true
                ],
                "formattedValue": [
                  "73"
                ]
              },
              {
                "time": "1740873600",
                "formattedTime": "2.–8. März 2025",
                "formattedAxisTime": "02.03.2025",
                "value": [
                  68
                ],
                "hasData": [
                  true
                ],
                "formattedValue": [
                  "68"
                ]
              },
              {
                "time": "1741478400",
                "formattedTime": "9.–15. März 2025",
                "formattedAxisTime": "09.03.2025",
                "value": [
                  69
                ],
                "hasData": [
                  true
                ],
                "formattedValue": [
                  "69"
                ]
              },
              {
                "time": "1742083200",
                "formattedTime": "16.–22. März 2025",
                "formattedAxisTime": "16.03.2025",
                "value": [
                  70
                ],
                "hasData": [
                  true
                ],
                "formattedValue": [
                  "70"
                ]
              },
              {
                "time": "1742688000",
                "formattedTime": "23.–29. März 2025",
                "formattedAxisTime": "23.03.2025",
                "value": [
                  69
                ],
                "hasData": [
                  true
                ],
                "formattedValue": [
                  "69"
                ]
              },
              {
                "time": "1743292800",
                "formattedTime": "30. März – 5. Apr. 2025",
                "formattedAxisTime": "30.03.2025",
                "value": [
                  73
                ],
                "hasData": [
                  true
                ],
                "formattedValue": [
                  "73"
                ]
              },
              {
                "time": "1743897600",
                "formattedTime": "6.–12. Apr. 2025",
                "formattedAxisTime": "06.04.2025",
                "value": [
                  67
                ],
                "hasData": [
                  true
                ],
                "formattedValue": [
                  "67"
                ]
              },
              {
                "time": "1744502400",
                "formattedTime": "13.–19. Apr. 2025",
                "formattedAxisTime": "13.04.2025",
                "value": [
                  71
                ],
                "hasData": [
                  true
                ],
                "formattedValue": [
                  "71"
                ]
              },
              {
                "time": "1745107200",
                "formattedTime": "20.–26. Apr. 2025",
                "formattedAxisTime": "20.04.2025",
                "value": [
                  71
                ],
                "hasData": [
                  true
                ],
                "formattedValue": [
                  "71"
                ]
              },
              {
                "time": "1745712000",
                "formattedTime": "27. Apr. – 3. Mai 2025",
                "formattedAxisTime": "27.04.2025",
                "value": [
                  67
                ],
                "hasData": [
                  true
                ],
                "formattedValue": [
                  "67"
                ]
              }
            ],
            "averages": []
          }
        },
        "id": "TIMESERIES",
        "type": "fe_line_chart",
        "title": "Interesse im zeitlichen Verlauf"
      },
      {
        "data": {
          "default": {
            "geoMapData": [
              {
                "geoCode": "PR",
                "geoName": "Puerto Rico",
                "value": [
                  100
                ],
                "formattedValue": [
                  "100"
                ],
                "maxValueIndex": 0,
                "hasData": [
                  true
                ]
              },
              {
                "geoCode": "IE",
                "geoName": "Irland",
                "value": [
                  89
                ],
                "formattedValue": [
                  "89"
                ],
                "maxValueIndex": 0,
                "hasData": [
                  true
                ]
              },
              {
                "geoCode": "MF",
                "geoName": "St. Martin",
                "value": [
                  0
                ],
                "formattedValue": [
                  ""
                ],
                "maxValueIndex": 0,
                "hasData": [
                  false
                ]
              },
              {
                "geoCode": "VI",
                "geoName": "Amerikanische Jungferninseln",
                "value": [
                  0
                ],
                "formattedValue": [
                  ""
                ],
                "maxValueIndex": 0,
                "hasData": [
                  false
                ]
              },
              {
                "geoCode": "CA",
                "geoName": "Kanada",
                "value": [
                  78
                ],
                "formattedValue": [
                  "78"
                ],
                "maxValueIndex": 0,
                "hasData": [
                  true
                ]
              },
              {
                "geoCode": "US",
                "geoName": "Vereinigte Staaten",
                "value": [
                  73
                ],
                "formattedValue": [
                  "73"
                ],
                "maxValueIndex": 0,
                "hasData": [
                  true
                ]
              },
              {
                "geoCode": "SX",
                "geoName": "Sint Maarten",
                "value": [
                  0
                ],
                "formattedValue": [
                  ""
                ],
                "maxValueIndex": 0,
                "hasData": [
                  false
                ]
              },
              {
                "geoCode": "BL",
                "geoName": "St. Barthélemy",
                "value": [
                  0
                ],
                "formattedValue": [
                  ""
                ],
                "maxValueIndex": 0,
                "hasData": [
                  false
                ]
              },
              {
                "geoCode": "AG",
                "geoName": "Antigua und Barbuda",
                "value": [
                  0
                ],
                "formattedValue": [
                  ""
                ],
                "maxValueIndex": 0,
                "hasData": [
                  false
                ]
              },
              {
                "geoCode": "MQ",
                "geoName": "Martinique",
                "value": [
                  0
                ],
                "formattedValue": [
                  ""
                ],
                "maxValueIndex": 0,
                "hasData": [
                  false
                ]
              }
            ]
          }
        },
        "id": "GEO_MAP",
        "type": "fe_geo_chart_explore",
        "title": "Interesse nach Region"
      },
      {
        "data": {
          "default": {
            "rankedList": [
              {
                "rankedKeyword": [
                  {
                    "query": "pizza hut",
                    "value": 100,
                    "formattedValue": "100",
                    "hasData": true,
                    "link": "/trends/explore?q=pizza+hut&date=today+12-m"
                  },
                  {
                    "query": "pizza near me",
                    "value": 85,
                    "formattedValue": "85",
                    "hasData": true,
                    "link": "/trends/explore?q=pizza+near+me&date=today+12-m"
                  },
                  {
                    "query": "pizza pizza near me",
                    "value": 78,
                    "formattedValue": "78",
                    "hasData": true,
                    "link": "/trends/explore?q=pizza+pizza+near+me&date=today+12-m"
                  },
                  {
                    "query": "dominos pizza",
                    "value": 31,
                    "formattedValue": "31",
                    "hasData": true,
                    "link": "/trends/explore?q=dominos+pizza&date=today+12-m"
                  },
                  {
                    "query": "dominos",
                    "value": 30,
                    "formattedValue": "30",
                    "hasData": true,
                    "link": "/trends/explore?q=dominos&date=today+12-m"
                  },
                  {
                    "query": "domino's pizza",
                    "value": 24,
                    "formattedValue": "24",
                    "hasData": true,
                    "link": "/trends/explore?q=domino's+pizza&date=today+12-m"
                  },
                  {
                    "query": "pizza oven",
                    "value": 17,
                    "formattedValue": "17",
                    "hasData": true,
                    "link": "/trends/explore?q=pizza+oven&date=today+12-m"
                  },
                  {
                    "query": "pizza dough",
                    "value": 17,
                    "formattedValue": "17",
                    "hasData": true,
                    "link": "/trends/explore?q=pizza+dough&date=today+12-m"
                  },
                  {
                    "query": "pizza delivery",
                    "value": 15,
                    "formattedValue": "15",
                    "hasData": true,
                    "link": "/trends/explore?q=pizza+delivery&date=today+12-m"
                  },
                  {
                    "query": "city pizza",
                    "value": 12,
                    "formattedValue": "12",
                    "hasData": true,
                    "link": "/trends/explore?q=city+pizza&date=today+12-m"
                  },
                  {
                    "query": "pizza house",
                    "value": 12,
                    "formattedValue": "12",
                    "hasData": true,
                    "link": "/trends/explore?q=pizza+house&date=today+12-m"
                  },
                  {
                    "query": "crust pizza",
                    "value": 12,
                    "formattedValue": "12",
                    "hasData": true,
                    "link": "/trends/explore?q=crust+pizza&date=today+12-m"
                  },
                  {
                    "query": "best pizza near me",
                    "value": 12,
                    "formattedValue": "12",
                    "hasData": true,
                    "link": "/trends/explore?q=best+pizza+near+me&date=today+12-m"
                  },
                  {
                    "query": "pizza time",
                    "value": 11,
                    "formattedValue": "11",
                    "hasData": true,
                    "link": "/trends/explore?q=pizza+time&date=today+12-m"
                  },
                  {
                    "query": "pizza place",
                    "value": 10,
                    "formattedValue": "10",
                    "hasData": true,
                    "link": "/trends/explore?q=pizza+place&date=today+12-m"
                  },
                  {
                    "query": "express pizza",
                    "value": 9,
                    "formattedValue": "9",
                    "hasData": true,
                    "link": "/trends/explore?q=express+pizza&date=today+12-m"
                  },
                  {
                    "query": "new york pizza",
                    "value": 9,
                    "formattedValue": "9",
                    "hasData": true,
                    "link": "/trends/explore?q=new+york+pizza&date=today+12-m"
                  },
                  {
                    "query": "pizza places",
                    "value": 8,
                    "formattedValue": "8",
                    "hasData": true,
                    "link": "/trends/explore?q=pizza+places&date=today+12-m"
                  },
                  {
                    "query": "chicago pizza",
                    "value": 7,
                    "formattedValue": "7",
                    "hasData": true,
                    "link": "/trends/explore?q=chicago+pizza&date=today+12-m"
                  },
                  {
                    "query": "boston pizza",
                    "value": 7,
                    "formattedValue": "7",
                    "hasData": true,
                    "link": "/trends/explore?q=boston+pizza&date=today+12-m"
                  },
                  {
                    "query": "papa johns pizza",
                    "value": 7,
                    "formattedValue": "7",
                    "hasData": true,
                    "link": "/trends/explore?q=papa+johns+pizza&date=today+12-m"
                  },
                  {
                    "query": "pizza hut near me",
                    "value": 7,
                    "formattedValue": "7",
                    "hasData": true,
                    "link": "/trends/explore?q=pizza+hut+near+me&date=today+12-m"
                  },
                  {
                    "query": "pizza sauce",
                    "value": 7,
                    "formattedValue": "7",
                    "hasData": true,
                    "link": "/trends/explore?q=pizza+sauce&date=today+12-m"
                  },
                  {
                    "query": "pizza shop",
                    "value": 7,
                    "formattedValue": "7",
                    "hasData": true,
                    "link": "/trends/explore?q=pizza+shop&date=today+12-m"
                  },
                  {
                    "query": "pizza company",
                    "value": 7,
                    "formattedValue": "7",
                    "hasData": true,
                    "link": "/trends/explore?q=pizza+company&date=today+12-m"
                  }
                ]
              },
              {
                "rankedKeyword": [
                  {
                    "query": "pentagon pizza index",
                    "value": 2650,
                    "formattedValue": "+ 2.650 %",
                    "link": "/trends/explore?q=pentagon+pizza+index&date=today+12-m"
                  },
                  {
                    "query": "pizza napoletana near me",
                    "value": 2550,
                    "formattedValue": "+ 2.550 %",
                    "link": "/trends/explore?q=pizza+napoletana+near+me&date=today+12-m"
                  },
                  {
                    "query": "how to make pizza dough at home",
                    "value": 2400,
                    "formattedValue": "+ 2.400 %",
                    "link": "/trends/explore?q=how+to+make+pizza+dough+at+home&date=today+12-m"
                  },
                  {
                    "query": "what is a pizza stone",
                    "value": 1800,
                    "formattedValue": "+ 1.800 %",
                    "link": "/trends/explore?q=what+is+a+pizza+stone&date=today+12-m"
                  },
                  {
                    "query": "best pizza near me open now",
                    "value": 1700,
                    "formattedValue": "+ 1.700 %",
                    "link": "/trends/explore?q=best+pizza+near+me+open+now&date=today+12-m"
                  },
                  {
                    "query": "pizza calzone near me",
                    "value": 1400,
                    "formattedValue": "+ 1.400 %",
                    "link": "/trends/explore?q=pizza+calzone+near+me&date=today+12-m"
                  },
                  {
                    "query": "gluten free pizza crust recipe",
                    "value": 1400,
                    "formattedValue": "+ 1.400 %",
                    "link": "/trends/explore?q=gluten+free+pizza+crust+recipe&date=today+12-m"
                  },
                  {
                    "query": "pizza margherita near me",
                    "value": 950,
                    "formattedValue": "+ 950 %",
                    "link": "/trends/explore?q=pizza+margherita+near+me&date=today+12-m"
                  },
                  {
                    "query": "best deep dish pizza in chicago",
                    "value": 900,
                    "formattedValue": "+ 900 %",
                    "link": "/trends/explore?q=best+deep+dish+pizza+in+chicago&date=today+12-m"
                  },
                  {
                    "query": "best pizza near me",
                    "value": 350,
                    "formattedValue": "+ 350 %",
                    "link": "/trends/explore?q=best+pizza+near+me&date=today+12-m"
                  },
                  {
                    "query": "pizza delivered",
                    "value": 250,
                    "formattedValue": "+ 250 %",
                    "link": "/trends/explore?q=pizza+delivered&date=today+12-m"
                  },
                  {
                    "query": "how to reheat pizza",
                    "value": 150,
                    "formattedValue": "+ 150 %",
                    "link": "/trends/explore?q=how+to+reheat+pizza&date=today+12-m"
                  },
                  {
                    "query": "pizza time",
                    "value": 60,
                    "formattedValue": "+ 60 %",
                    "link": "/trends/explore?q=pizza+time&date=today+12-m"
                  },
                  {
                    "query": "pizza company",
                    "value": 50,
                    "formattedValue": "+ 50 %",
                    "link": "/trends/explore?q=pizza+company&date=today+12-m"
                  },
                  {
                    "query": "pizza takeaway",
                    "value": 40,
                    "formattedValue": "+ 40 %",
                    "link": "/trends/explore?q=pizza+takeaway&date=today+12-m"
                  },
                  {
                    "query": "pepperoni pizza",
                    "value": 40,
                    "formattedValue": "+ 40 %",
                    "link": "/trends/explore?q=pepperoni+pizza&date=today+12-m"
                  },
                  {
                    "query": "order pizza",
                    "value": 40,
                    "formattedValue": "+ 40 %",
                    "link": "/trends/explore?q=order+pizza&date=today+12-m"
                  }
                ]
              }
            ]
          }
        },
        "id": "RELATED_QUERIES",
        "type": "fe_related_searches",
        "title": "Ähnliche Suchanfragen"
      }
    ],
    "keywords": [
      {
        "keyword": "pizza",
        "name": "pizza",
        "type": "Suchbegriff"
      }
    ]
  }
  ```
</ResponseExample>


# Search type
Source: https://docs.brightdata.com/api-reference/serp/google-trends/search-type

Configure the Bright Data Google Trends Search Type parameter to refine queries and return matching results as JSON or HTML. On port 44445.

```txt wrap theme={null}
https://trends.google.com/trends/explore?q=pizza&gprop=images&brd_trends=timeseries,geo_map&brd_json=1
```

## Parameters

<ParamField type="string">
  The search query parameter. Specifies the keyword or phrase you want to search for on Google.
</ParamField>

<ParamField type="string">
  Google property to filter on. Defaults to web search.\\

  Possible values are: `images`, `news`, `froogle` (for Google Shopping), `youtube`

  ```txt wrap theme={null}
  https://trends.google.com/trends/explore?q=pizza&gprop=images&brd_trends=timeseries,geo_map&brd_json=1
  ```
</ParamField>

<RequestExample>
  ```shell cURL highlight={6} theme={null}
    curl -X POST https://api.brightdata.com/request \
    --header "Content-Type: application/json" \
    --header "Authorization: Bearer API_KEY" \
    --data '{
      "zone": "serp_api1",
      "url": "https://trends.google.com/trends/explore?q=pizza&gprop=images&brd_trends=timeseries,geo_map&brd_json=1",
      "format": "raw"
    }'
  ```

  ```shell Native proxy highlight={4} theme={null}
  curl --proxy brd.superproxy.io:44445 \
    --proxy-user CUSTOMER_USERNAME:CUSTOMER_PASSWORD \
    --ssl-no-revoke \
    "https://trends.google.com/trends/explore?q=pizza&gprop=images&brd_trends=timeseries,geo_map&brd_json=1"
  ```

  ```js Node.js highlight={10} theme={null}
  (async () => {
    const response = await fetch('https://api.brightdata.com/request', {
      method: 'POST',
      headers: {
        'Content-Type': 'application/json',
        'Authorization': 'Bearer API_KEY'
      },
      body: JSON.stringify({
        zone: 'serp_api1',
        url: 'https://trends.google.com/trends/explore?q=pizza&gprop=images&brd_trends=timeseries,geo_map&brd_json=1',
        format: 'raw'
      })
    });
    
    const data = await response.text();
    console.log(data);
  })();
  ```

  ```python Python highlight={11} theme={null}
  import requests

  # API Configuration
  headers = {
      'Content-Type': 'application/json',
      'Authorization': 'Bearer API_KEY',
  }

  payload = {
      'zone': 'serp_api1',
      'url': 'https://trends.google.com/trends/explore?q=pizza&gprop=images&brd_trends=timeseries,geo_map&brd_json=1',
      'format': 'raw'
  }

  # Make the request
  response = requests.post(
      'https://api.brightdata.com/request', 
      json=payload, 
      headers=headers
  )

  print(response.text)
  ```
</RequestExample>

<ResponseExample>
  ```json 200 theme={null}
  {
    "widgets": [
      {
        "data": {
          "default": {
            "timelineData": [
              {
                "time": "1740268800",
                "formattedTime": "Feb 23 – Mar 1, 2025",
                "formattedAxisTime": "Feb 23, 2025",
                "value": [
                  54
                ],
                "hasData": [
                  true
                ],
                "formattedValue": [
                  "54"
                ]
              },
              {
                "time": "1740873600",
                "formattedTime": "Mar 2 – 8, 2025",
                "formattedAxisTime": "Mar 2, 2025",
                "value": [
                  54
                ],
                "hasData": [
                  true
                ],
                "formattedValue": [
                  "54"
                ]
              },
              {
                "time": "1741478400",
                "formattedTime": "Mar 9 – 15, 2025",
                "formattedAxisTime": "Mar 9, 2025",
                "value": [
                  48
                ],
                "hasData": [
                  true
                ],
                "formattedValue": [
                  "48"
                ]
              },
              {
                "time": "1742083200",
                "formattedTime": "Mar 16 – 22, 2025",
                "formattedAxisTime": "Mar 16, 2025",
                "value": [
                  47
                ],
                "hasData": [
                  true
                ],
                "formattedValue": [
                  "47"
                ]
              },
              {
                "time": "1742688000",
                "formattedTime": "Mar 23 – 29, 2025",
                "formattedAxisTime": "Mar 23, 2025",
                "value": [
                  56
                ],
                "hasData": [
                  true
                ],
                "formattedValue": [
                  "56"
                ]
              },
              {
                "time": "1743292800",
                "formattedTime": "Mar 30 – Apr 5, 2025",
                "formattedAxisTime": "Mar 30, 2025",
                "value": [
                  62
                ],
                "hasData": [
                  true
                ],
                "formattedValue": [
                  "62"
                ]
              },
              {
                "time": "1743897600",
                "formattedTime": "Apr 6 – 12, 2025",
                "formattedAxisTime": "Apr 6, 2025",
                "value": [
                  54
                ],
                "hasData": [
                  true
                ],
                "formattedValue": [
                  "54"
                ]
              },
              {
                "time": "1744502400",
                "formattedTime": "Apr 13 – 19, 2025",
                "formattedAxisTime": "Apr 13, 2025",
                "value": [
                  55
                ],
                "hasData": [
                  true
                ],
                "formattedValue": [
                  "55"
                ]
              },
              {
                "time": "1745107200",
                "formattedTime": "Apr 20 – 26, 2025",
                "formattedAxisTime": "Apr 20, 2025",
                "value": [
                  60
                ],
                "hasData": [
                  true
                ],
                "formattedValue": [
                  "60"
                ]
              },
              {
                "time": "1745712000",
                "formattedTime": "Apr 27 – May 3, 2025",
                "formattedAxisTime": "Apr 27, 2025",
                "value": [
                  48
                ],
                "hasData": [
                  true
                ],
                "formattedValue": [
                  "48"
                ]
              }
            ],
            "averages": []
          }
        },
        "id": "TIMESERIES",
        "type": "fe_line_chart",
        "title": "Interest over time"
      },
      {
        "data": {
          "default": {
            "geoMapData": [
              {
                "geoCode": "PK",
                "geoName": "Pakistan",
                "value": [
                  100
                ],
                "formattedValue": [
                  "100"
                ],
                "maxValueIndex": 0,
                "hasData": [
                  true
                ]
              },
              {
                "geoCode": "PR",
                "geoName": "Puerto Rico",
                "value": [
                  84
                ],
                "formattedValue": [
                  "84"
                ],
                "maxValueIndex": 0,
                "hasData": [
                  true
                ]
              },
              {
                "geoCode": "JE",
                "geoName": "Jersey",
                "value": [
                  0
                ],
                "formattedValue": [
                  ""
                ],
                "maxValueIndex": 0,
                "hasData": [
                  false
                ]
              },
              {
                "geoCode": "GP",
                "geoName": "Guadeloupe",
                "value": [
                  0
                ],
                "formattedValue": [
                  ""
                ],
                "maxValueIndex": 0,
                "hasData": [
                  false
                ]
              },
              {
                "geoCode": "BL",
                "geoName": "St. Barthélemy",
                "value": [
                  0
                ],
                "formattedValue": [
                  ""
                ],
                "maxValueIndex": 0,
                "hasData": [
                  false
                ]
              },
              {
                "geoCode": "MP",
                "geoName": "Northern Mariana Islands",
                "value": [
                  0
                ],
                "formattedValue": [
                  ""
                ],
                "maxValueIndex": 0,
                "hasData": [
                  false
                ]
              },
              {
                "geoCode": "SX",
                "geoName": "Sint Maarten",
                "value": [
                  0
                ],
                "formattedValue": [
                  ""
                ],
                "maxValueIndex": 0,
                "hasData": [
                  false
                ]
              },
              {
                "geoCode": "MT",
                "geoName": "Malta",
                "value": [
                  0
                ],
                "formattedValue": [
                  ""
                ],
                "maxValueIndex": 0,
                "hasData": [
                  false
                ]
              },
              {
                "geoCode": "MQ",
                "geoName": "Martinique",
                "value": [
                  0
                ],
                "formattedValue": [
                  ""
                ],
                "maxValueIndex": 0,
                "hasData": [
                  false
                ]
              },
              {
                "geoCode": "KM",
                "geoName": "Comoros",
                "value": [
                  0
                ],
                "formattedValue": [
                  ""
                ],
                "maxValueIndex": 0,
                "hasData": [
                  false
                ]
              }
            ]
          }
        },
        "id": "GEO_MAP",
        "type": "fe_geo_chart_explore",
        "title": "Interest by region"
      },
      {
        "data": {
          "default": {
            "rankedList": [
              {
                "rankedKeyword": [
                  {
                    "query": "pizza hut",
                    "value": 100,
                    "formattedValue": "100",
                    "hasData": true,
                    "link": "/trends/explore?q=pizza+hut&date=today+12-m"
                  },
                  {
                    "query": "pizza cheese",
                    "value": 50,
                    "formattedValue": "50",
                    "hasData": true,
                    "link": "/trends/explore?q=pizza+cheese&date=today+12-m"
                  },
                  {
                    "query": "chicken pizza",
                    "value": 38,
                    "formattedValue": "38",
                    "hasData": true,
                    "link": "/trends/explore?q=chicken+pizza&date=today+12-m"
                  },
                  {
                    "query": "pizza dominos",
                    "value": 36,
                    "formattedValue": "36",
                    "hasData": true,
                    "link": "/trends/explore?q=pizza+dominos&date=today+12-m"
                  },
                  {
                    "query": "dominos",
                    "value": 35,
                    "formattedValue": "35",
                    "hasData": true,
                    "link": "/trends/explore?q=dominos&date=today+12-m"
                  },
                  {
                    "query": "food",
                    "value": 32,
                    "formattedValue": "32",
                    "hasData": true,
                    "link": "/trends/explore?q=food&date=today+12-m"
                  },
                  {
                    "query": "pizza logo",
                    "value": 31,
                    "formattedValue": "31",
                    "hasData": true,
                    "link": "/trends/explore?q=pizza+logo&date=today+12-m"
                  },
                  {
                    "query": "domino's pizza",
                    "value": 29,
                    "formattedValue": "29",
                    "hasData": true,
                    "link": "/trends/explore?q=domino's+pizza&date=today+12-m"
                  },
                  {
                    "query": "burger",
                    "value": 27,
                    "formattedValue": "27",
                    "hasData": true,
                    "link": "/trends/explore?q=burger&date=today+12-m"
                  },
                  {
                    "query": "pizza burger",
                    "value": 26,
                    "formattedValue": "26",
                    "hasData": true,
                    "link": "/trends/explore?q=pizza+burger&date=today+12-m"
                  },
                  {
                    "query": "pepperoni pizza",
                    "value": 24,
                    "formattedValue": "24",
                    "hasData": true,
                    "link": "/trends/explore?q=pepperoni+pizza&date=today+12-m"
                  },
                  {
                    "query": "pizza png",
                    "value": 23,
                    "formattedValue": "23",
                    "hasData": true,
                    "link": "/trends/explore?q=pizza+png&date=today+12-m"
                  },
                  {
                    "query": "pizza tower",
                    "value": 22,
                    "formattedValue": "22",
                    "hasData": true,
                    "link": "/trends/explore?q=pizza+tower&date=today+12-m"
                  },
                  {
                    "query": "pepperoni",
                    "value": 22,
                    "formattedValue": "22",
                    "hasData": true,
                    "link": "/trends/explore?q=pepperoni&date=today+12-m"
                  },
                  {
                    "query": "pizza oven",
                    "value": 21,
                    "formattedValue": "21",
                    "hasData": true,
                    "link": "/trends/explore?q=pizza+oven&date=today+12-m"
                  },
                  {
                    "query": "pizza box",
                    "value": 20,
                    "formattedValue": "20",
                    "hasData": true,
                    "link": "/trends/explore?q=pizza+box&date=today+12-m"
                  },
                  {
                    "query": "pasta",
                    "value": 19,
                    "formattedValue": "19",
                    "hasData": true,
                    "link": "/trends/explore?q=pasta&date=today+12-m"
                  },
                  {
                    "query": "pizza slice",
                    "value": 17,
                    "formattedValue": "17",
                    "hasData": true,
                    "link": "/trends/explore?q=pizza+slice&date=today+12-m"
                  },
                  {
                    "query": "italian pizza",
                    "value": 14,
                    "formattedValue": "14",
                    "hasData": true,
                    "link": "/trends/explore?q=italian+pizza&date=today+12-m"
                  },
                  {
                    "query": "margherita pizza",
                    "value": 14,
                    "formattedValue": "14",
                    "hasData": true,
                    "link": "/trends/explore?q=margherita+pizza&date=today+12-m"
                  },
                  {
                    "query": "little caesars pizza",
                    "value": 14,
                    "formattedValue": "14",
                    "hasData": true,
                    "link": "/trends/explore?q=little+caesars+pizza&date=today+12-m"
                  },
                  {
                    "query": "little caesars",
                    "value": 14,
                    "formattedValue": "14",
                    "hasData": true,
                    "link": "/trends/explore?q=little+caesars&date=today+12-m"
                  },
                  {
                    "query": "pizza drawing",
                    "value": 14,
                    "formattedValue": "14",
                    "hasData": true,
                    "link": "/trends/explore?q=pizza+drawing&date=today+12-m"
                  },
                  {
                    "query": "pizza near me",
                    "value": 14,
                    "formattedValue": "14",
                    "hasData": true,
                    "link": "/trends/explore?q=pizza+near+me&date=today+12-m"
                  },
                  {
                    "query": "pizza roblox",
                    "value": 13,
                    "formattedValue": "13",
                    "hasData": true,
                    "link": "/trends/explore?q=pizza+roblox&date=today+12-m"
                  }
                ]
              },
              {
                "rankedKeyword": [
                  {
                    "query": "work at a pizza place",
                    "value": 200,
                    "formattedValue": "+200%",
                    "link": "/trends/explore?q=work+at+a+pizza+place&date=today+12-m"
                  },
                  {
                    "query": "halloween pizza",
                    "value": 140,
                    "formattedValue": "+140%",
                    "link": "/trends/explore?q=halloween+pizza&date=today+12-m"
                  },
                  {
                    "query": "marco's pizza",
                    "value": 120,
                    "formattedValue": "+120%",
                    "link": "/trends/explore?q=marco's+pizza&date=today+12-m"
                  },
                  {
                    "query": "pizza hut near me",
                    "value": 120,
                    "formattedValue": "+120%",
                    "link": "/trends/explore?q=pizza+hut+near+me&date=today+12-m"
                  },
                  {
                    "query": "pizza roblox",
                    "value": 110,
                    "formattedValue": "+110%",
                    "link": "/trends/explore?q=pizza+roblox&date=today+12-m"
                  },
                  {
                    "query": "pizza near me",
                    "value": 90,
                    "formattedValue": "+90%",
                    "link": "/trends/explore?q=pizza+near+me&date=today+12-m"
                  },
                  {
                    "query": "angel's pizza",
                    "value": 80,
                    "formattedValue": "+80%",
                    "link": "/trends/explore?q=angel's+pizza&date=today+12-m"
                  },
                  {
                    "query": "pizza tarifi",
                    "value": 60,
                    "formattedValue": "+60%",
                    "link": "/trends/explore?q=pizza+tarifi&date=today+12-m"
                  },
                  {
                    "query": "little caesars pizza",
                    "value": 40,
                    "formattedValue": "+40%",
                    "link": "/trends/explore?q=little+caesars+pizza&date=today+12-m"
                  },
                  {
                    "query": "little caesars",
                    "value": 40,
                    "formattedValue": "+40%",
                    "link": "/trends/explore?q=little+caesars&date=today+12-m"
                  }
                ]
              }
            ]
          }
        },
        "id": "RELATED_QUERIES",
        "type": "fe_related_searches",
        "title": "Related queries"
      }
    ],
    "keywords": [
      {
        "keyword": "pizza",
        "name": "pizza",
        "type": "Search term"
      }
    ]
  }
  ```
</ResponseExample>


# Google Trends text search
Source: https://docs.brightdata.com/api-reference/serp/google-trends/text-search

Configure the Bright Data Google Trends Google Trends text search parameter to refine queries and return matching results as JSON or HTML. On port 44445.

```txt wrap theme={null}
https://trends.google.com/trends/explore?q=pizza&brd_trends=timeseries,geo_map&brd_json=1
```

<Warning>
  Trends supports parsed results only i.e. `brd_json=1`
</Warning>

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

## Parameters

<ParamField type="string">
  The search query parameter. Specifies the keyword or phrase you want to search for on Google.

  ```Example theme={null}
  https://trends.google.com/trends/explore?q=pizza
  ```
</ParamField>

<ParamField type="string">
  To display specific widget data within your Google Trends results, use one of the following widget parameters:

  * `timeseries`: Retrieves the time series widget data.
  * `geo_map`: Retrieves the geo map widget data.

  ```txt wrap theme={null}
  https://trends.google.com/trends/explore?q=pizza&brd_trends=timeseries,geo_map&brd_json=1
  ```

  <Tip>
    **For multiple widgets:** Separate them with a comma. e.g. `timeseries,geo_map`
  </Tip>
</ParamField>

<RequestExample>
  ```shell cURL highlight={6} theme={null}
    curl -X POST https://api.brightdata.com/request \
    --header "Content-Type: application/json" \
    --header "Authorization: Bearer API_KEY" \
    --data '{
      "zone": "serp_api1",
      "url": "https://trends.google.com/trends/explore?q=pizza&brd_trends=timeseries,geo_map&brd_json=1",
      "format": "raw"
    }'
  ```

  ```shell Native proxy highlight={4} theme={null}
  curl --proxy brd.superproxy.io:44445 \
    --proxy-user CUSTOMER_USERNAME:CUSTOMER_PASSWORD \
    --ssl-no-revoke \
    "https://trends.google.com/trends/explore?q=pizza&brd_trends=timeseries,geo_map&brd_json=1"
  ```

  ```js Node.js highlight={10} theme={null}
  (async () => {
    const response = await fetch('https://api.brightdata.com/request', {
      method: 'POST',
      headers: {
        'Content-Type': 'application/json',
        'Authorization': 'Bearer API_KEY'
      },
      body: JSON.stringify({
        zone: 'serp_api1',
        url: 'https://trends.google.com/trends/explore?q=pizza&brd_trends=timeseries,geo_map&brd_json=1',
        format: 'raw'
      })
    });
    
    const data = await response.text();
    console.log(data);
  })();
  ```

  ```python Python highlight={11} theme={null}
  import requests

  # API Configuration
  headers = {
      'Content-Type': 'application/json',
      'Authorization': 'Bearer API_KEY',
  }

  payload = {
      'zone': 'serp_api1',
      'url': 'https://trends.google.com/trends/explore?q=pizza&brd_trends=timeseries,geo_map&brd_json=1',
      'format': 'raw'
  }

  # Make the request
  response = requests.post(
      'https://api.brightdata.com/request', 
      json=payload, 
      headers=headers
  )

  print(response.text)
  ```
</RequestExample>

<ResponseExample>
  ```json 200 theme={null}
  {
    "widgets": [
      {
        "data": {
          "default": {
            "timelineData": [
              {
                "time": "1740268800",
                "formattedTime": "Feb 23 – Mar 1, 2025",
                "formattedAxisTime": "Feb 23, 2025",
                "value": [
                  73
                ],
                "hasData": [
                  true
                ],
                "formattedValue": [
                  "73"
                ]
              },
              {
                "time": "1740873600",
                "formattedTime": "Mar 2 – 8, 2025",
                "formattedAxisTime": "Mar 2, 2025",
                "value": [
                  68
                ],
                "hasData": [
                  true
                ],
                "formattedValue": [
                  "68"
                ]
              },
              {
                "time": "1741478400",
                "formattedTime": "Mar 9 – 15, 2025",
                "formattedAxisTime": "Mar 9, 2025",
                "value": [
                  69
                ],
                "hasData": [
                  true
                ],
                "formattedValue": [
                  "69"
                ]
              },
              {
                "time": "1742083200",
                "formattedTime": "Mar 16 – 22, 2025",
                "formattedAxisTime": "Mar 16, 2025",
                "value": [
                  70
                ],
                "hasData": [
                  true
                ],
                "formattedValue": [
                  "70"
                ]
              },
              {
                "time": "1742688000",
                "formattedTime": "Mar 23 – 29, 2025",
                "formattedAxisTime": "Mar 23, 2025",
                "value": [
                  69
                ],
                "hasData": [
                  true
                ],
                "formattedValue": [
                  "69"
                ]
              },
              {
                "time": "1743292800",
                "formattedTime": "Mar 30 – Apr 5, 2025",
                "formattedAxisTime": "Mar 30, 2025",
                "value": [
                  73
                ],
                "hasData": [
                  true
                ],
                "formattedValue": [
                  "73"
                ]
              },
              {
                "time": "1743897600",
                "formattedTime": "Apr 6 – 12, 2025",
                "formattedAxisTime": "Apr 6, 2025",
                "value": [
                  67
                ],
                "hasData": [
                  true
                ],
                "formattedValue": [
                  "67"
                ]
              },
              {
                "time": "1744502400",
                "formattedTime": "Apr 13 – 19, 2025",
                "formattedAxisTime": "Apr 13, 2025",
                "value": [
                  71
                ],
                "hasData": [
                  true
                ],
                "formattedValue": [
                  "71"
                ]
              },
              {
                "time": "1745107200",
                "formattedTime": "Apr 20 – 26, 2025",
                "formattedAxisTime": "Apr 20, 2025",
                "value": [
                  71
                ],
                "hasData": [
                  true
                ],
                "formattedValue": [
                  "71"
                ]
              },
              {
                "time": "1745712000",
                "formattedTime": "Apr 27 – May 3, 2025",
                "formattedAxisTime": "Apr 27, 2025",
                "value": [
                  67
                ],
                "hasData": [
                  true
                ],
                "formattedValue": [
                  "67"
                ]
              }
            ],
            "averages": []
          }
        },
        "id": "TIMESERIES",
        "type": "fe_line_chart",
        "title": "Interest over time"
      },
      {
        "data": {
          "default": {
            "geoMapData": [
              {
                "geoCode": "PR",
                "geoName": "Puerto Rico",
                "value": [
                  100
                ],
                "formattedValue": [
                  "100"
                ],
                "maxValueIndex": 0,
                "hasData": [
                  true
                ]
              },
              {
                "geoCode": "IE",
                "geoName": "Ireland",
                "value": [
                  89
                ],
                "formattedValue": [
                  "89"
                ],
                "maxValueIndex": 0,
                "hasData": [
                  true
                ]
              },
              {
                "geoCode": "MF",
                "geoName": "St. Martin",
                "value": [
                  0
                ],
                "formattedValue": [
                  ""
                ],
                "maxValueIndex": 0,
                "hasData": [
                  false
                ]
              },
              {
                "geoCode": "VI",
                "geoName": "U.S. Virgin Islands",
                "value": [
                  0
                ],
                "formattedValue": [
                  ""
                ],
                "maxValueIndex": 0,
                "hasData": [
                  false
                ]
              },
              {
                "geoCode": "CA",
                "geoName": "Canada",
                "value": [
                  78
                ],
                "formattedValue": [
                  "78"
                ],
                "maxValueIndex": 0,
                "hasData": [
                  true
                ]
              },
              {
                "geoCode": "US",
                "geoName": "United States",
                "value": [
                  73
                ],
                "formattedValue": [
                  "73"
                ],
                "maxValueIndex": 0,
                "hasData": [
                  true
                ]
              },
              {
                "geoCode": "SX",
                "geoName": "Sint Maarten",
                "value": [
                  0
                ],
                "formattedValue": [
                  ""
                ],
                "maxValueIndex": 0,
                "hasData": [
                  false
                ]
              },
              {
                "geoCode": "BL",
                "geoName": "St. Barthélemy",
                "value": [
                  0
                ],
                "formattedValue": [
                  ""
                ],
                "maxValueIndex": 0,
                "hasData": [
                  false
                ]
              },
              {
                "geoCode": "AG",
                "geoName": "Antigua & Barbuda",
                "value": [
                  0
                ],
                "formattedValue": [
                  ""
                ],
                "maxValueIndex": 0,
                "hasData": [
                  false
                ]
              },
              {
                "geoCode": "MQ",
                "geoName": "Martinique",
                "value": [
                  0
                ],
                "formattedValue": [
                  ""
                ],
                "maxValueIndex": 0,
                "hasData": [
                  false
                ]
              }
            ]
          }
        },
        "id": "GEO_MAP",
        "type": "fe_geo_chart_explore",
        "title": "Interest by region"
      },
      {
        "data": {
          "default": {
            "rankedList": [
              {
                "rankedKeyword": [
                  {
                    "query": "pizza hut",
                    "value": 100,
                    "formattedValue": "100",
                    "hasData": true,
                    "link": "/trends/explore?q=pizza+hut&date=today+12-m"
                  },
                  {
                    "query": "pizza near me",
                    "value": 85,
                    "formattedValue": "85",
                    "hasData": true,
                    "link": "/trends/explore?q=pizza+near+me&date=today+12-m"
                  },
                  {
                    "query": "dominos pizza",
                    "value": 31,
                    "formattedValue": "31",
                    "hasData": true,
                    "link": "/trends/explore?q=dominos+pizza&date=today+12-m"
                  },
                  {
                    "query": "dominos",
                    "value": 30,
                    "formattedValue": "30",
                    "hasData": true,
                    "link": "/trends/explore?q=dominos&date=today+12-m"
                  },
                  {
                    "query": "domino's pizza",
                    "value": 24,
                    "formattedValue": "24",
                    "hasData": true,
                    "link": "/trends/explore?q=domino's+pizza&date=today+12-m"
                  },
                  {
                    "query": "pizza oven",
                    "value": 17,
                    "formattedValue": "17",
                    "hasData": true,
                    "link": "/trends/explore?q=pizza+oven&date=today+12-m"
                  },
                  {
                    "query": "pizza dough",
                    "value": 17,
                    "formattedValue": "17",
                    "hasData": true,
                    "link": "/trends/explore?q=pizza+dough&date=today+12-m"
                  },
                  {
                    "query": "pizza delivery",
                    "value": 15,
                    "formattedValue": "15",
                    "hasData": true,
                    "link": "/trends/explore?q=pizza+delivery&date=today+12-m"
                  },
                  {
                    "query": "city pizza",
                    "value": 12,
                    "formattedValue": "12",
                    "hasData": true,
                    "link": "/trends/explore?q=city+pizza&date=today+12-m"
                  },
                  {
                    "query": "pizza house",
                    "value": 12,
                    "formattedValue": "12",
                    "hasData": true,
                    "link": "/trends/explore?q=pizza+house&date=today+12-m"
                  },
                  {
                    "query": "best pizza near me",
                    "value": 12,
                    "formattedValue": "12",
                    "hasData": true,
                    "link": "/trends/explore?q=best+pizza+near+me&date=today+12-m"
                  },
                  {
                    "query": "crust pizza",
                    "value": 12,
                    "formattedValue": "12",
                    "hasData": true,
                    "link": "/trends/explore?q=crust+pizza&date=today+12-m"
                  },
                  {
                    "query": "pizza time",
                    "value": 11,
                    "formattedValue": "11",
                    "hasData": true,
                    "link": "/trends/explore?q=pizza+time&date=today+12-m"
                  },
                  {
                    "query": "pizza place",
                    "value": 10,
                    "formattedValue": "10",
                    "hasData": true,
                    "link": "/trends/explore?q=pizza+place&date=today+12-m"
                  },
                  {
                    "query": "express pizza",
                    "value": 9,
                    "formattedValue": "9",
                    "hasData": true,
                    "link": "/trends/explore?q=express+pizza&date=today+12-m"
                  },
                  {
                    "query": "new york pizza",
                    "value": 9,
                    "formattedValue": "9",
                    "hasData": true,
                    "link": "/trends/explore?q=new+york+pizza&date=today+12-m"
                  },
                  {
                    "query": "pizza places",
                    "value": 8,
                    "formattedValue": "8",
                    "hasData": true,
                    "link": "/trends/explore?q=pizza+places&date=today+12-m"
                  },
                  {
                    "query": "chicago pizza",
                    "value": 7,
                    "formattedValue": "7",
                    "hasData": true,
                    "link": "/trends/explore?q=chicago+pizza&date=today+12-m"
                  },
                  {
                    "query": "boston pizza",
                    "value": 7,
                    "formattedValue": "7",
                    "hasData": true,
                    "link": "/trends/explore?q=boston+pizza&date=today+12-m"
                  },
                  {
                    "query": "papa johns pizza",
                    "value": 7,
                    "formattedValue": "7",
                    "hasData": true,
                    "link": "/trends/explore?q=papa+johns+pizza&date=today+12-m"
                  },
                  {
                    "query": "pizza hut near me",
                    "value": 7,
                    "formattedValue": "7",
                    "hasData": true,
                    "link": "/trends/explore?q=pizza+hut+near+me&date=today+12-m"
                  },
                  {
                    "query": "pizza sauce",
                    "value": 7,
                    "formattedValue": "7",
                    "hasData": true,
                    "link": "/trends/explore?q=pizza+sauce&date=today+12-m"
                  },
                  {
                    "query": "pizza shop",
                    "value": 7,
                    "formattedValue": "7",
                    "hasData": true,
                    "link": "/trends/explore?q=pizza+shop&date=today+12-m"
                  },
                  {
                    "query": "pizza company",
                    "value": 7,
                    "formattedValue": "7",
                    "hasData": true,
                    "link": "/trends/explore?q=pizza+company&date=today+12-m"
                  },
                  {
                    "query": "little caesars pizza",
                    "value": 6,
                    "formattedValue": "6",
                    "hasData": true,
                    "link": "/trends/explore?q=little+caesars+pizza&date=today+12-m"
                  }
                ]
              },
              {
                "rankedKeyword": [
                  {
                    "query": "pentagon pizza index",
                    "value": 2650,
                    "formattedValue": "+2,650%",
                    "link": "/trends/explore?q=pentagon+pizza+index&date=today+12-m"
                  },
                  {
                    "query": "pizza napoletana near me",
                    "value": 2600,
                    "formattedValue": "+2,600%",
                    "link": "/trends/explore?q=pizza+napoletana+near+me&date=today+12-m"
                  },
                  {
                    "query": "how to make pizza dough at home",
                    "value": 2450,
                    "formattedValue": "+2,450%",
                    "link": "/trends/explore?q=how+to+make+pizza+dough+at+home&date=today+12-m"
                  },
                  {
                    "query": "what is a pizza stone",
                    "value": 1800,
                    "formattedValue": "+1,800%",
                    "link": "/trends/explore?q=what+is+a+pizza+stone&date=today+12-m"
                  },
                  {
                    "query": "best pizza near me open now",
                    "value": 1750,
                    "formattedValue": "+1,750%",
                    "link": "/trends/explore?q=best+pizza+near+me+open+now&date=today+12-m"
                  },
                  {
                    "query": "pizza calzone near me",
                    "value": 1450,
                    "formattedValue": "+1,450%",
                    "link": "/trends/explore?q=pizza+calzone+near+me&date=today+12-m"
                  },
                  {
                    "query": "gluten free pizza crust recipe",
                    "value": 1450,
                    "formattedValue": "+1,450%",
                    "link": "/trends/explore?q=gluten+free+pizza+crust+recipe&date=today+12-m"
                  },
                  {
                    "query": "pizza margherita near me",
                    "value": 1000,
                    "formattedValue": "+1,000%",
                    "link": "/trends/explore?q=pizza+margherita+near+me&date=today+12-m"
                  },
                  {
                    "query": "best deep dish pizza in chicago",
                    "value": 900,
                    "formattedValue": "+900%",
                    "link": "/trends/explore?q=best+deep+dish+pizza+in+chicago&date=today+12-m"
                  },
                  {
                    "query": "best pizza near me",
                    "value": 350,
                    "formattedValue": "+350%",
                    "link": "/trends/explore?q=best+pizza+near+me&date=today+12-m"
                  },
                  {
                    "query": "pizza delivered",
                    "value": 250,
                    "formattedValue": "+250%",
                    "link": "/trends/explore?q=pizza+delivered&date=today+12-m"
                  },
                  {
                    "query": "how to reheat pizza",
                    "value": 160,
                    "formattedValue": "+160%",
                    "link": "/trends/explore?q=how+to+reheat+pizza&date=today+12-m"
                  },
                  {
                    "query": "order pizza near me",
                    "value": 60,
                    "formattedValue": "+60%",
                    "link": "/trends/explore?q=order+pizza+near+me&date=today+12-m"
                  },
                  {
                    "query": "pizza time",
                    "value": 60,
                    "formattedValue": "+60%",
                    "link": "/trends/explore?q=pizza+time&date=today+12-m"
                  },
                  {
                    "query": "pizza company",
                    "value": 50,
                    "formattedValue": "+50%",
                    "link": "/trends/explore?q=pizza+company&date=today+12-m"
                  },
                  {
                    "query": "pizza takeaway",
                    "value": 50,
                    "formattedValue": "+50%",
                    "link": "/trends/explore?q=pizza+takeaway&date=today+12-m"
                  },
                  {
                    "query": "pepperoni pizza",
                    "value": 40,
                    "formattedValue": "+40%",
                    "link": "/trends/explore?q=pepperoni+pizza&date=today+12-m"
                  },
                  {
                    "query": "pizza deals near me",
                    "value": 40,
                    "formattedValue": "+40%",
                    "link": "/trends/explore?q=pizza+deals+near+me&date=today+12-m"
                  },
                  {
                    "query": "order pizza",
                    "value": 40,
                    "formattedValue": "+40%",
                    "link": "/trends/explore?q=order+pizza&date=today+12-m"
                  }
                ]
              }
            ]
          }
        },
        "id": "RELATED_QUERIES",
        "type": "fe_related_searches",
        "title": "Related queries"
      }
    ],
    "keywords": [
      {
        "keyword": "pizza",
        "name": "pizza",
        "type": "Search term"
      }
    ]
  }
  ```
</ResponseExample>


# Time range
Source: https://docs.brightdata.com/api-reference/serp/google-trends/time-range

Configure the Bright Data Google Trends Time Range parameter to refine queries and return matching results as JSON or HTML. On port 44445.

```txt wrap theme={null}
https://trends.google.com/trends/explore?q=pizza&date=now+1-d&brd_trends=timeseries,geo_map&brd_json=1
```

## Parameters

<ParamField type="string">
  Time range to search.

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

  ```txt wrap theme={null}
  https://trends.google.com/trends/explore?q=pizza&date=now+1-d&brd_trends=timeseries,geo_map&brd_json=1
  ```
</ParamField>

<RequestExample>
  ```shell cURL highlight={6} theme={null}
    curl -X POST https://api.brightdata.com/request \
    --header "Content-Type: application/json" \
    --header "Authorization: Bearer API_KEY" \
    --data '{
      "zone": "serp_api1",
      "url": "https://trends.google.com/trends/explore?q=pizza&date=now+1-d&brd_trends=timeseries,geo_map&brd_json=1",
      "format": "raw"
    }'
  ```

  ```shell Native proxy highlight={4} theme={null}
  curl --proxy brd.superproxy.io:44445 \
    --proxy-user CUSTOMER_USERNAME:CUSTOMER_PASSWORD \
    --ssl-no-revoke \
    "https://trends.google.com/trends/explore?q=pizza&date=now+1-d&brd_trends=timeseries,geo_map&brd_json=1"
  ```

  ```js Node.js highlight={10} theme={null}
  (async () => {
    const response = await fetch('https://api.brightdata.com/request', {
      method: 'POST',
      headers: {
        'Content-Type': 'application/json',
        'Authorization': 'Bearer API_KEY'
      },
      body: JSON.stringify({
        zone: 'serp_api1',
        url: 'https://trends.google.com/trends/explore?q=pizza&date=now+1-d&brd_trends=timeseries,geo_map&brd_json=1',
        format: 'raw'
      })
    });
    
    const data = await response.text();
    console.log(data);
  })();
  ```

  ```python Python highlight={11} theme={null}
  import requests

  # API Configuration
  headers = {
      'Content-Type': 'application/json',
      'Authorization': 'Bearer API_KEY',
  }

  payload = {
      'zone': 'serp_api1',
      'url': 'https://trends.google.com/trends/explore?q=pizza&date=now+1-d&brd_trends=timeseries,geo_map&brd_json=1',
      'format': 'raw'
  }

  # Make the request
  response = requests.post(
      'https://api.brightdata.com/request', 
      json=payload, 
      headers=headers
  )

  print(response.text)
  ```
</RequestExample>

<ResponseExample>
  ```json 200 theme={null}
  {
    "widgets": [
      {
        "data": {
          "default": {
            "timelineData": [
              {
                "time": "1771948800",
                "formattedTime": "Feb 24, 2026 at 11:00 AM",
                "formattedAxisTime": "Feb 24 at 11:00 AM",
                "value": [
                  59
                ],
                "hasData": [
                  true
                ],
                "formattedValue": [
                  "59"
                ]
              },
              {
                "time": "1771949280",
                "formattedTime": "Feb 24, 2026 at 11:08 AM",
                "formattedAxisTime": "Feb 24 at 11:08 AM",
                "value": [
                  63
                ],
                "hasData": [
                  true
                ],
                "formattedValue": [
                  "63"
                ]
              },
              {
                "time": "1771949760",
                "formattedTime": "Feb 24, 2026 at 11:16 AM",
                "formattedAxisTime": "Feb 24 at 11:16 AM",
                "value": [
                  61
                ],
                "hasData": [
                  true
                ],
                "formattedValue": [
                  "61"
                ]
              },
              {
                "time": "1771950240",
                "formattedTime": "Feb 24, 2026 at 11:24 AM",
                "formattedAxisTime": "Feb 24 at 11:24 AM",
                "value": [
                  62
                ],
                "hasData": [
                  true
                ],
                "formattedValue": [
                  "62"
                ]
              },
              {
                "time": "1771950720",
                "formattedTime": "Feb 24, 2026 at 11:32 AM",
                "formattedAxisTime": "Feb 24 at 11:32 AM",
                "value": [
                  62
                ],
                "hasData": [
                  true
                ],
                "formattedValue": [
                  "62"
                ]
              },
              {
                "time": "1771951200",
                "formattedTime": "Feb 24, 2026 at 11:40 AM",
                "formattedAxisTime": "Feb 24 at 11:40 AM",
                "value": [
                  65
                ],
                "hasData": [
                  true
                ],
                "formattedValue": [
                  "65"
                ]
              },
              {
                "time": "1771951680",
                "formattedTime": "Feb 24, 2026 at 11:48 AM",
                "formattedAxisTime": "Feb 24 at 11:48 AM",
                "value": [
                  69
                ],
                "hasData": [
                  true
                ],
                "formattedValue": [
                  "69"
                ]
              },
              {
                "time": "1771952160",
                "formattedTime": "Feb 24, 2026 at 11:56 AM",
                "formattedAxisTime": "Feb 24 at 11:56 AM",
                "value": [
                  64
                ],
                "hasData": [
                  true
                ],
                "formattedValue": [
                  "64"
                ]
              },
              {
                "time": "1771952640",
                "formattedTime": "Feb 24, 2026 at 12:04 PM",
                "formattedAxisTime": "Feb 24 at 12:04 PM",
                "value": [
                  86
                ],
                "hasData": [
                  true
                ],
                "formattedValue": [
                  "86"
                ]
              },
              {
                "time": "1771953120",
                "formattedTime": "Feb 24, 2026 at 12:12 PM",
                "formattedAxisTime": "Feb 24 at 12:12 PM",
                "value": [
                  70
                ],
                "hasData": [
                  true
                ],
                "formattedValue": [
                  "70"
                ]
              }
            ],
            "averages": []
          }
        },
        "id": "TIMESERIES",
        "type": "fe_line_chart",
        "title": "Interest over time"
      },
      {
        "data": {
          "default": {
            "geoMapData": [
              {
                "geoCode": "KP",
                "geoName": "North Korea",
                "value": [
                  0
                ],
                "formattedValue": [
                  ""
                ],
                "maxValueIndex": 0,
                "hasData": [
                  false
                ]
              },
              {
                "geoCode": "BL",
                "geoName": "St. Barthélemy",
                "value": [
                  0
                ],
                "formattedValue": [
                  ""
                ],
                "maxValueIndex": 0,
                "hasData": [
                  false
                ]
              },
              {
                "geoCode": "PR",
                "geoName": "Puerto Rico",
                "value": [
                  100
                ],
                "formattedValue": [
                  "100"
                ],
                "maxValueIndex": 0,
                "hasData": [
                  true
                ]
              },
              {
                "geoCode": "CK",
                "geoName": "Cook Islands",
                "value": [
                  0
                ],
                "formattedValue": [
                  ""
                ],
                "maxValueIndex": 0,
                "hasData": [
                  false
                ]
              },
              {
                "geoCode": "GU",
                "geoName": "Guam",
                "value": [
                  0
                ],
                "formattedValue": [
                  ""
                ],
                "maxValueIndex": 0,
                "hasData": [
                  false
                ]
              },
              {
                "geoCode": "VI",
                "geoName": "U.S. Virgin Islands",
                "value": [
                  0
                ],
                "formattedValue": [
                  ""
                ],
                "maxValueIndex": 0,
                "hasData": [
                  false
                ]
              },
              {
                "geoCode": "US",
                "geoName": "United States",
                "value": [
                  81
                ],
                "formattedValue": [
                  "81"
                ],
                "maxValueIndex": 0,
                "hasData": [
                  true
                ]
              },
              {
                "geoCode": "CA",
                "geoName": "Canada",
                "value": [
                  80
                ],
                "formattedValue": [
                  "80"
                ],
                "maxValueIndex": 0,
                "hasData": [
                  true
                ]
              },
              {
                "geoCode": "AL",
                "geoName": "Albania",
                "value": [
                  0
                ],
                "formattedValue": [
                  ""
                ],
                "maxValueIndex": 0,
                "hasData": [
                  false
                ]
              },
              {
                "geoCode": "XK",
                "geoName": "Kosovo",
                "value": [
                  0
                ],
                "formattedValue": [
                  ""
                ],
                "maxValueIndex": 0,
                "hasData": [
                  false
                ]
              }
            ]
          }
        },
        "id": "GEO_MAP",
        "type": "fe_geo_chart_explore",
        "title": "Interest by region"
      },
      {
        "data": {
          "default": {
            "rankedList": [
              {
                "rankedKeyword": [
                  {
                    "query": "pizza near me",
                    "value": 100,
                    "formattedValue": "100",
                    "hasData": true,
                    "link": "/trends/explore?q=pizza+near+me&date=now+1-d"
                  },
                  {
                    "query": "best pizza near me",
                    "value": 40,
                    "formattedValue": "40",
                    "hasData": true,
                    "link": "/trends/explore?q=best+pizza+near+me&date=now+1-d"
                  },
                  {
                    "query": "pizza hut",
                    "value": 40,
                    "formattedValue": "40",
                    "hasData": true,
                    "link": "/trends/explore?q=pizza+hut&date=now+1-d"
                  },
                  {
                    "query": "dominos",
                    "value": 18,
                    "formattedValue": "18",
                    "hasData": true,
                    "link": "/trends/explore?q=dominos&date=now+1-d"
                  },
                  {
                    "query": "dominos pizza",
                    "value": 18,
                    "formattedValue": "18",
                    "hasData": true,
                    "link": "/trends/explore?q=dominos+pizza&date=now+1-d"
                  },
                  {
                    "query": "pizza dough",
                    "value": 11,
                    "formattedValue": "11",
                    "hasData": true,
                    "link": "/trends/explore?q=pizza+dough&date=now+1-d"
                  },
                  {
                    "query": "crust pizza",
                    "value": 9,
                    "formattedValue": "9",
                    "hasData": true,
                    "link": "/trends/explore?q=crust+pizza&date=now+1-d"
                  },
                  {
                    "query": "domino's pizza",
                    "value": 8,
                    "formattedValue": "8",
                    "hasData": true,
                    "link": "/trends/explore?q=domino's+pizza&date=now+1-d"
                  },
                  {
                    "query": "pizza oven",
                    "value": 7,
                    "formattedValue": "7",
                    "hasData": true,
                    "link": "/trends/explore?q=pizza+oven&date=now+1-d"
                  },
                  {
                    "query": "chicago pizza",
                    "value": 6,
                    "formattedValue": "6",
                    "hasData": true,
                    "link": "/trends/explore?q=chicago+pizza&date=now+1-d"
                  },
                  {
                    "query": "pizza margherita",
                    "value": 6,
                    "formattedValue": "6",
                    "hasData": true,
                    "link": "/trends/explore?q=pizza+margherita&date=now+1-d"
                  },
                  {
                    "query": "pizza delivery",
                    "value": 6,
                    "formattedValue": "6",
                    "hasData": true,
                    "link": "/trends/explore?q=pizza+delivery&date=now+1-d"
                  },
                  {
                    "query": "deep dish pizza",
                    "value": 5,
                    "formattedValue": "5",
                    "hasData": true,
                    "link": "/trends/explore?q=deep+dish+pizza&date=now+1-d"
                  },
                  {
                    "query": "pizza house",
                    "value": 5,
                    "formattedValue": "5",
                    "hasData": true,
                    "link": "/trends/explore?q=pizza+house&date=now+1-d"
                  },
                  {
                    "query": "pizza time",
                    "value": 4,
                    "formattedValue": "4",
                    "hasData": true,
                    "link": "/trends/explore?q=pizza+time&date=now+1-d"
                  },
                  {
                    "query": "how to reheat pizza",
                    "value": 4,
                    "formattedValue": "4",
                    "hasData": true,
                    "link": "/trends/explore?q=how+to+reheat+pizza&date=now+1-d"
                  },
                  {
                    "query": "best pizza near me open now",
                    "value": 4,
                    "formattedValue": "4",
                    "hasData": true,
                    "link": "/trends/explore?q=best+pizza+near+me+open+now&date=now+1-d"
                  },
                  {
                    "query": "what is a pizza stone",
                    "value": 4,
                    "formattedValue": "4",
                    "hasData": true,
                    "link": "/trends/explore?q=what+is+a+pizza+stone&date=now+1-d"
                  },
                  {
                    "query": "how to make pizza dough at home",
                    "value": 4,
                    "formattedValue": "4",
                    "hasData": true,
                    "link": "/trends/explore?q=how+to+make+pizza+dough+at+home&date=now+1-d"
                  },
                  {
                    "query": "pizza calzone near me",
                    "value": 4,
                    "formattedValue": "4",
                    "hasData": true,
                    "link": "/trends/explore?q=pizza+calzone+near+me&date=now+1-d"
                  },
                  {
                    "query": "gluten free pizza crust recipe",
                    "value": 4,
                    "formattedValue": "4",
                    "hasData": true,
                    "link": "/trends/explore?q=gluten+free+pizza+crust+recipe&date=now+1-d"
                  },
                  {
                    "query": "pizza margherita near me",
                    "value": 4,
                    "formattedValue": "4",
                    "hasData": true,
                    "link": "/trends/explore?q=pizza+margherita+near+me&date=now+1-d"
                  },
                  {
                    "query": "best deep dish pizza in chicago",
                    "value": 4,
                    "formattedValue": "4",
                    "hasData": true,
                    "link": "/trends/explore?q=best+deep+dish+pizza+in+chicago&date=now+1-d"
                  },
                  {
                    "query": "pizza napoletana near me",
                    "value": 4,
                    "formattedValue": "4",
                    "hasData": true,
                    "link": "/trends/explore?q=pizza+napoletana+near+me&date=now+1-d"
                  },
                  {
                    "query": "debonairs pizza",
                    "value": 1,
                    "formattedValue": "1",
                    "hasData": true,
                    "link": "/trends/explore?q=debonairs+pizza&date=now+1-d"
                  }
                ]
              },
              {
                "rankedKeyword": [
                  {
                    "query": "pizza hut all you can eat",
                    "value": 250,
                    "formattedValue": "+250%",
                    "link": "/trends/explore?q=pizza+hut+all+you+can+eat&date=now+1-d"
                  },
                  {
                    "query": "best pizza near me open now",
                    "value": 60,
                    "formattedValue": "+60%",
                    "link": "/trends/explore?q=best+pizza+near+me+open+now&date=now+1-d"
                  },
                  {
                    "query": "best pizza near me",
                    "value": 60,
                    "formattedValue": "+60%",
                    "link": "/trends/explore?q=best+pizza+near+me&date=now+1-d"
                  },
                  {
                    "query": "how to make pizza dough at home",
                    "value": 60,
                    "formattedValue": "+60%",
                    "link": "/trends/explore?q=how+to+make+pizza+dough+at+home&date=now+1-d"
                  },
                  {
                    "query": "what is a pizza stone",
                    "value": 50,
                    "formattedValue": "+50%",
                    "link": "/trends/explore?q=what+is+a+pizza+stone&date=now+1-d"
                  },
                  {
                    "query": "pizza calzone near me",
                    "value": 50,
                    "formattedValue": "+50%",
                    "link": "/trends/explore?q=pizza+calzone+near+me&date=now+1-d"
                  },
                  {
                    "query": "gluten free pizza crust recipe",
                    "value": 50,
                    "formattedValue": "+50%",
                    "link": "/trends/explore?q=gluten+free+pizza+crust+recipe&date=now+1-d"
                  },
                  {
                    "query": "pizza margherita near me",
                    "value": 50,
                    "formattedValue": "+50%",
                    "link": "/trends/explore?q=pizza+margherita+near+me&date=now+1-d"
                  },
                  {
                    "query": "best deep dish pizza in chicago",
                    "value": 50,
                    "formattedValue": "+50%",
                    "link": "/trends/explore?q=best+deep+dish+pizza+in+chicago&date=now+1-d"
                  },
                  {
                    "query": "pizza napoletana near me",
                    "value": 50,
                    "formattedValue": "+50%",
                    "link": "/trends/explore?q=pizza+napoletana+near+me&date=now+1-d"
                  },
                  {
                    "query": "how to reheat pizza",
                    "value": 40,
                    "formattedValue": "+40%",
                    "link": "/trends/explore?q=how+to+reheat+pizza&date=now+1-d"
                  },
                  {
                    "query": "licorice pizza",
                    "value": 40,
                    "formattedValue": "+40%",
                    "link": "/trends/explore?q=licorice+pizza&date=now+1-d"
                  }
                ]
              }
            ]
          }
        },
        "id": "RELATED_QUERIES",
        "type": "fe_related_searches",
        "title": "Related queries"
      }
    ],
    "keywords": [
      {
        "keyword": "pizza",
        "name": "pizza",
        "type": "Search term"
      }
    ]
  }
  ```
</ResponseExample>


# Choose a delivery type on request level
Source: https://docs.brightdata.com/api-reference/scraper-studio-api/Choose_a_delivery_type_on_request_level

Pick a Bright Data Scraper Studio API collection mode: batch, async real-time or sync real-time, and match delivery preferences to each endpoint.

Instead of creating duplicate scrapers for each delivery type, you can choose a delivery type per job using API.

<Frame>
  <img alt="hero-image.png" />
</Frame>

Scraper Studio supports three API collection modes:

* **Batch collection**: runs one or more inputs in the background and returns a collection\_id.
* **Asynchronous real-time collection**: runs one input in the background and returns a response\_id.
* **Synchronous real-time collection**: runs one input and returns the collected data directly in the same API response, if the request completes within the timeout.

The scraper’s **Delivery preferences** in the control panel affect which API modes can be used. A scraper configured for Batch delivery can still be triggered with the real-time API endpoints. However, a scraper configured for Real-time delivery cannot be triggered with the batch endpoint.

<Frame>
  <img alt="Delivery preferences tab in the Scraper Studio control panel, showing the &#x22;Choose when to get the data&#x22; options: &#x22;On a job completion (batch)&#x22; selected, &#x22;Realtime (single request)&#x22; and &#x22;Split delivery to small batches&#x22;" />
</Frame>

## **Delivery preference compatibility**

Before triggering a scraper by API, check its Delivery preferences in the control panel.

| Delivery preference in control panel | Batch endpoint | Real-time endpoints |
| :----------------------------------- | :------------- | :------------------ |
| Batch / On job completion            | Supported      | Supported           |
| Real-time                            | Not supported  | Supported           |

If you call the batch endpoint for a scraper configured as real-time, the API returns an error:

```json theme={null}
"error": "Cannot trigger a batch job with a real-time scraper. Use /trigger_immediate endpoint instead"
```

## **Choose a collection mode**

| Mode            | Endpoint                      | Input shape                 | Response                                     | Use when                                                                |
| :-------------- | :---------------------------- | :-------------------------- | :------------------------------------------- | :---------------------------------------------------------------------- |
| Batch           | `POST /dca/trigger`           | JSON array of input objects | collection\_id                               | You need to process one or more inputs in a background job.             |
| Async real-time | `POST /dca/trigger_immediate` | Single JSON input object    | response\_id                                 | You need to run one input in the background and retrieve results later. |
| Sync real-time  | `POST /dca/crawl`             | Single JSON input object    | Collected data, or 202 if timeout is reached | You need the result in the same API request.                            |

## **Batch collection**

Use batch collection when you want to run one or more inputs in the background.

Batch collection is best for:

* Multiple URLs, keywords or input rows
* Large jobs
* Scheduled or recurring data collection
* Jobs where results can be retrieved later

Batch collection is available only when the scraper is not configured as Real-time in Delivery preferences.

See [Trigger batch collection](/api-reference/scraper-studio-api/Trigger_a_scraper_for_batch_collection_method) for request parameters and examples.

## **Asynchronous real-time collection**

Use asynchronous real-time collection when you want to run a single input in the background and retrieve the result later.

Async real-time is best for:

* One input per request
* Low-latency workflows where the client should not keep the HTTP request open
* Applications that prefer to trigger now and retrieve results later

A scraper configured for Batch delivery in the control panel can still be triggered with the async real-time endpoint.

See [Trigger async real-time collection](/api-reference/scraper-studio-api/initiate-a-realtime-job/async-realtime-job) for request parameters and examples.

## **Synchronous real-time collection**

Use synchronous real-time collection when you want the API request to wait for the scraper result and return the collected data directly.

Sync real-time is best for:

* One input per request
* Applications that need an immediate response
* Scrapers that usually complete within the configured timeout

A scraper configured for Batch delivery in the control panel can still be triggered with the sync real-time endpoint.

Synchronous real-time requests use the timeout query parameter. The timeout must be between 25s and 50s.

If the scraper finishes within the timeout, the API returns 200 OK with the collected data. If the scraper is still running when the timeout is reached, the API may return 202 Accepted with a response\_id. Use this response\_id with the real-time data endpoint to retrieve the result asynchronously.

See [Trigger sync real-time collection](/api-reference/scraper-studio-api/initiate-a-realtime-job/sync-realtime-job) for request parameters and examples.

## **Delivery behavior**

Collection mode controls how the scraper runs. Delivery preferences control default delivery behavior configured in the control panel.

Depending on your scraper configuration, results can be retrieved by API or delivered to a configured destination, such as:

* API download
* Webhook
* Amazon S3
* Google Cloud Storage
* Azure Blob Storage
* SFTP / FTP
* Email

**Important behavior:**

* A scraper configured for Batch delivery can be triggered by either batch or real-time API endpoints.
* A scraper configured for Real-time delivery can be triggered only by real-time API endpoints.
* Batch endpoint calls return a collection\_id.
* Async real-time endpoint calls return a response\_id.
* Sync real-time endpoint calls return collected data directly, unless the timeout is reached.

<Note>
  Batch responses begin with `j_****` and real-time responses begin with `d****`
</Note>


# Receive batch data
Source: https://docs.brightdata.com/api-reference/scraper-studio-api/Receive_batch_data

api-reference/web-scraper-ide-rest-api GET /dca/dataset
Use GET /dca/dataset?id=<collection_id> to fetch results of an async Scraper Studio batch job. Returns a status object while running, a JSON array when ready.

Use `GET /dca/dataset?id=<collection_id>` to retrieve the results of an asynchronous Bright Data Scraper Studio batch collection. While the collection is still running, the endpoint returns a status object. When the collection is ready, it returns a JSON array of records.

For the full trigger, poll and parse walkthrough in cURL, Python and Node.js, see the [Quickstart](./Getting_started_with_the_API).

<Note>
  Use the `collection_id` returned by [POST /dca/trigger](./Trigger_a_scraper_for_batch_collection_method) as the `id` query parameter in this endpoint.
</Note>

<Note>
  Batch collection results are available for download for 16 days after collection. To avoid expiration, download the data within 16 days or configure a [push delivery method](./Choose_a_delivery_type_on_request_level) to send it to your storage automatically.
</Note>

## Request

<CodeGroup>
  ```bash cURL theme={null}
  curl "https://api.brightdata.com/dca/dataset?id=$COLLECTION_ID" \
    -H "Authorization: Bearer $BRIGHT_DATA_API_TOKEN"
  ```

  ```python Python theme={null}
  response = requests.get(
      "https://api.brightdata.com/dca/dataset",
      params={"id": collection_id},
      headers={"Authorization": f"Bearer {API_TOKEN}"},
  )
  ```

  ```js Node.js theme={null}
  const response = await fetch(
    `https://api.brightdata.com/dca/dataset?id=${collectionId}`,
    { headers: { Authorization: `Bearer ${process.env.BRIGHT_DATA_API_TOKEN}` } }
  );
  ```
</CodeGroup>

## Response

While the collection is still building (HTTP 202):

```json theme={null}
{
  "status": "building",
  "message": "Dataset is not ready yet, try again in XXs"
}
```

When the collection is ready (HTTP 200):

```json theme={null}
[
  {
    "url": "https://www.dm.de/p/d/3133774/babylove-teller-silikon-mit-trennschale-regenbogen-orange-creme",
    "title": "babylove Teller Silikon mit Trennschale Regenbogen orange/creme",
    "price": 8.45,
    "availability": "in stock",
    "input": {
      "url": "https://www.dm.de/p/d/3133774/babylove-teller-silikon-mit-trennschale-regenbogen-orange-creme"
    }
  }
]
```

The exact field set depends on the output schema you defined when you built the collector. One row per successful input by default.

## Retrieving results

While the collection is still running, the endpoint returns `202 Accepted` with a status object. When the collection is ready, it returns `200 OK` with a JSON array of records.

For long-running collections, which can take minutes or hours, avoid frequent polling. Use one of these options instead:

* Check the collection status periodically with longer intervals.
* Configure a [push delivery method](./Choose_a_delivery_type_on_request_level), such as webhook, Amazon S3, Google Cloud Storage, Azure Blob Storage, SFTP/FTP or email.
* Use the [dashboard](https://brightdata.com/cp/scrapers) to monitor run progress.

Batch collection results are retained for 16 days. Download the data within the retention window or configure push delivery to store results automatically.

The [Node.js](https://github.com/brightdata/bright-data-scraper-studio-nodejs-project/blob/main/index.js) and [Python](https://github.com/brightdata/bright-data-scraper-studio-python-project/blob/main/index.py) starters implement status checks with exponential-backoff retry on transient errors.

## Errors

| Status             | Cause                                                              | Fix                                                                             |
| ------------------ | ------------------------------------------------------------------ | ------------------------------------------------------------------------------- |
| `401 Unauthorized` | Token missing, malformed or revoked                                | Re-copy from [Account Settings → API Tokens](https://brightdata.com/cp/setting) |
| `404 Not Found`    | Collection ID does not exist, was deleted or has expired (16 days) | Re-trigger the collector if the data is still needed                            |
| `[]` (empty array) | Collection completed but produced no rows                          | Check the input URLs and the collector's output schema                          |
| `5xx`              | Transient Bright Data API error                                    | Retry with exponential backoff, for example 1s, 2s, 4s                          |

## Related

* [Trigger async batch collection](./Trigger_a_scraper_for_batch_collection_method): the endpoint that creates the collection
* [Job data](./job-data): job-level metadata (status, page counts, error counts)
* [Get errors for a job](./get-errors-for-job): per-input error details
* [Choose a delivery type](./Choose_a_delivery_type_on_request_level): alternative to polling (webhook, S3, GCS, etc.)


# Receive data from real-time work scraper
Source: https://docs.brightdata.com/api-reference/scraper-studio-api/Receive_data_from_real_time_work_scraper

api-reference/web-scraper-ide-rest-api GET /dca/get_result
Use the Bright Data Scraper Studio API to receive data from a real-time scraper. Triggers a custom collector job; returns 200 OK with JSON results.

<Tip>
  **Recommended:** We strongly recommend using the `timeout` parameter on polling requests to reduce unnecessary API calls and help avoid rate limits.
</Tip>

<Note>
  Result data is available for download for 7 days after collection. To avoid expiration, make sure to download the data within 7 days or configure a delivery method to get it automatically to your storage.
</Note>

## Rate limits

* 165,000 requests per minute


# Trigger async batch collection
Source: https://docs.brightdata.com/api-reference/scraper-studio-api/Trigger_a_scraper_for_batch_collection_method

api-reference/web-scraper-ide-rest-api POST /dca/trigger
Use POST /dca/trigger to start an async batch collection for a Scraper Studio collector. Send a JSON array of inputs; returns a collection_id to fetch results.

Use `POST /dca/trigger` to start an asynchronous batch collection for a published Bright Data Scraper Studio collector. The request body is a JSON array of input objects, and each object must match the collector's input schema.

The endpoint returns a `collection_id` immediately. Use that ID with the [Receive batch data](./Receive_batch_data) endpoint (`GET /dca/dataset`) to retrieve the results when the collection is complete.

For the full happy-path walkthrough (auth, trigger, poll, parse) in cURL, Python and Node.js, see the [Quickstart](./Getting_started_with_the_API). This page is the parameter and error reference.

## Request

The request body is a JSON array of input objects. Each object must match the input schema defined for the collector in [Scraper Studio](https://brightdata.com/cp/scrapers). A URL-based collector may require a `url` field, while other collectors may require fields such as `keyword`, `location`, `country` or custom input fields.

The body must be a JSON array. For a single input, send an array with one object.

<CodeGroup>
  ```bash cURL theme={null}
  curl --request POST \
    --url 'https://api.brightdata.com/dca/trigger?collector=YOUR_COLLECTOR_ID&queue_next=1' \
    --header 'Authorization: Bearer YOUR_API_KEY' \
    --header 'Content-Type: application/json' \
    --data '[
      { "url": "https://example.com/product/1" },
      { "url": "https://example.com/product/2" }
    ]'
  ```

  ```python Python theme={null}
  import os, requests

  response = requests.post(
      "https://api.brightdata.com/dca/trigger",
      params={"collector": os.environ["BRIGHT_DATA_COLLECTOR_ID"], "queue_next": 1},
      headers={
          "Authorization": f"Bearer {os.environ['BRIGHT_DATA_API_TOKEN']}",
          "Content-Type": "application/json",
      },
      json=[
          {"url": "https://example.com/product/1"},
          {"url": "https://example.com/product/2"},
      ],
  )
  collection_id = response.json()["collection_id"]
  ```

  ```js Node.js theme={null}
  const url = new URL("https://api.brightdata.com/dca/trigger");
  url.searchParams.set("collector", process.env.BRIGHT_DATA_COLLECTOR_ID);
  url.searchParams.set("queue_next", "1");

  const response = await fetch(url, {
    method: "POST",
    headers: {
      Authorization: `Bearer ${process.env.BRIGHT_DATA_API_TOKEN}`,
      "Content-Type": "application/json",
    },
    body: JSON.stringify([
      { url: "https://example.com/product/1" },
      { url: "https://example.com/product/2" },
    ]),
  });
  const { collection_id } = await response.json();
  ```
</CodeGroup>

## Response

```json theme={null}
{
  "collection_id": "j_abc123def456",
  "start_eta": "2026-05-22T13:26:22.702Z"
}
```

The `collection_id` identifies this collection run. Use it as the `id` value when calling `GET /dca/dataset` to retrieve the results.

```bash theme={null}
curl --request GET \
  --url 'https://api.brightdata.com/dca/dataset?id=j_abc123def456' \
  --header 'Authorization: Bearer YOUR_API_KEY'
```

| Field           | Type   | Description                                                                           |
| --------------- | ------ | ------------------------------------------------------------------------------------- |
| `collection_id` | string | ID of the collection run. Use this value to retrieve results from `GET /dca/dataset`. |
| `start_eta`     | string | Estimated start time for the collection, in ISO 8601 format.                          |

See the [Quickstart](./Getting_started_with_the_API#what-do-the-ids-mean) for how the IDs relate to one another.

## When to use batch collection

Use batch collection (`POST /dca/trigger`) when:

* You need to process multiple inputs in one run.
* You can wait until the collection finishes before receiving results.
* You want to retrieve results later by `collection_id`.
* You are building a dataset or a scheduled collection workflow.

Use [real-time collection](./initiate-a-realtime-job/sync-realtime-job) when you need a result for a single input immediately or within a short request window.

## Errors

| Status                     | Cause                                                                      | Fix                                                                                           |
| -------------------------- | -------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------- |
| `401 Unauthorized`         | Token missing, malformed or revoked                                        | Re-copy from [Account Settings → API Tokens](https://brightdata.com/cp/setting)               |
| `404 Not Found`            | Collector ID does not exist or your account does not have access           | Open the collector in [Scraper Studio](https://brightdata.com/cp/scrapers) and re-copy the ID |
| `422 Unprocessable Entity` | The objects in your request body do not match the collector's input schema | Confirm field names against the **Inputs** tab of your collector                              |
| `5xx`                      | Transient Bright Data API error                                            | Retry with exponential backoff, for example 1s, 2s, 4s                                        |

## Retry behavior

Re-triggering the same inputs creates a new collection with a new `collection_id`. The endpoint is not idempotent and does not deduplicate inputs across runs. To retry only the failed inputs, use [Get errors for a job](./get-errors-for-job) to identify the failed inputs from the run, then trigger a new collection with only those inputs.

## Related

* [Quickstart](./Getting_started_with_the_API): full trigger, poll and parse walkthrough in cURL, Python and Node.js
* [Receive batch data](./Receive_batch_data): poll for the dataset
* [Node.js starter](https://github.com/brightdata/bright-data-scraper-studio-nodejs-project): production-grade client that calls this endpoint
* [Python starter](https://github.com/brightdata/bright-data-scraper-studio-python-project): same, in Python


# Cancel a Scraper Studio job
Source: https://docs.brightdata.com/api-reference/scraper-studio-api/cancel-job

api-reference/web-scraper-ide-rest-api POST /dca/jobs/{job_id}/cancel
POST /dca/jobs/{job_id}/cancel permanently stops a Bright Data Scraper Studio job. The job moves to canceled and cannot be resumed afterward.

Permanently stop a Bright Data Scraper Studio job. The job moves to `canceled` and stops processing its remaining inputs.

This endpoint takes no request body and returns the plain text body `OK` on success, not JSON. Read the response as text rather than calling a JSON parser on it.

<Warning>
  Canceling is permanent. A canceled job cannot be resumed. Data already collected may still be available, depending on the run status and delivery settings. To stop a job temporarily instead, use [Pause a Scraper Studio job](./pause-job).
</Warning>

## Job state behavior

| Action | Use when                                   | Result                      |
| ------ | ------------------------------------------ | --------------------------- |
| Pause  | You want to temporarily stop a running job | Job moves to `paused`       |
| Resume | You want to continue a paused job          | Job moves back to `running` |
| Cancel | You want to stop a job permanently         | Job moves to `canceled`     |

Completed jobs cannot be paused, resumed or canceled.

## How to find a job ID

Use the jobs list endpoint to find the ID of the job you want to cancel:

```bash theme={null}
curl "https://api.brightdata.com/dca/collector/jobs?from_date=2026-06-01&to_date=2026-07-13" \
  -H "Authorization: Bearer $BRIGHT_DATA_API_TOKEN"
```

Use the returned `id` value as the `job_id` path parameter. See [List Scraper Studio jobs](./list-jobs) for the full parameter list.

## When to use this endpoint

* Stop a job triggered with the wrong input set instead of paying for the full run
* Cancel a runaway job generating far more child pages than expected, rather than waiting for a `too_many_pages` error
* Clear a stuck job before triggering a corrected run of the same scraper

Pages that were still queued when the job was canceled report the `aborted_page` error code. See [Scraper Studio error codes](/datasets/scraper-studio/error-codes) for the full catalog.

## Related

* [Pause a Scraper Studio job](./pause-job): stop a job temporarily instead of permanently
* [Resume a Scraper Studio job](./resume-job): restart a paused job, which is not possible after canceling
* [Get job metadata](./job-data): confirm the job status after canceling
* [Trigger async batch collection](./Trigger_a_scraper_for_batch_collection_method): start a corrected run


# Get errors for a job
Source: https://docs.brightdata.com/api-reference/scraper-studio-api/get-errors-for-job

api-reference/web-scraper-ide-rest-api GET /dca/jobs/{job_id}/hp_errors
GET /dca/jobs/{job_id}/hp_errors returns per-input error details for a Bright Data Scraper Studio batch job. Identify which inputs failed and why.

Retrieve per-input error details for a Bright Data Scraper Studio batch job. Use this endpoint to identify which inputs in a batch failed, what the error code was and how to remediate.

<Note>
  Per the OpenAPI spec, the `job_id` for this endpoint is the one returned by the `/dca/trigger_hp` (high-priority) endpoint. Jobs created via the regular `/dca/trigger` endpoint may use a different error-retrieval path. If the response is empty for a regular trigger job, contact [Bright Data support](https://brightdata.com/contact-us) to confirm the right endpoint for your workflow.
</Note>

## Request

<CodeGroup>
  ```bash cURL theme={null}
  curl "https://api.brightdata.com/dca/jobs/$JOB_ID/hp_errors" \
    -H "Authorization: Bearer $BRIGHT_DATA_API_TOKEN"
  ```

  ```python Python theme={null}
  response = requests.get(
      f"https://api.brightdata.com/dca/jobs/{job_id}/hp_errors",
      headers={"Authorization": f"Bearer {API_TOKEN}"},
  )
  errors = response.json()
  ```

  ```js Node.js theme={null}
  const response = await fetch(
    `https://api.brightdata.com/dca/jobs/${jobId}/hp_errors`,
    { headers: { Authorization: `Bearer ${process.env.BRIGHT_DATA_API_TOKEN}` } }
  );
  const errors = await response.json();
  ```
</CodeGroup>

### Query parameters

| Name             | Type    | Required | Description                                                                                |
| ---------------- | ------- | -------- | ------------------------------------------------------------------------------------------ |
| `skip_normalize` | boolean | No       | When `true`, returns full non-normalized error details. Default returns normalized errors. |

## Errors

| Status            | Cause                                                   | Fix                                                                        |
| ----------------- | ------------------------------------------------------- | -------------------------------------------------------------------------- |
| `400 Bad Request` | Invalid job ID format                                   | Verify the job ID matches the `j_` prefix returned by the trigger endpoint |
| `404 Not Found`   | Job does not exist or your account does not have access | Confirm the job ID is current and from a job you triggered                 |
| `500`             | Internal server error                                   | Retry with exponential backoff, for example 1s, 2s, 4s                     |

## When to use this endpoint

* Build a re-trigger workflow that retries only the failed inputs from a previous batch
* Surface user-actionable error messages in a UI or admin console
* Track failure trends over time (which collectors fail most often, which input shapes cause 422s)

## Related

* [Trigger async batch collection](./Trigger_a_scraper_for_batch_collection_method): the endpoint that creates the job
* [Job data](./job-data): job-level metadata (status, fails count, etc.)
* [Receive batch data](./Receive_batch_data): download the successful records


# Trigger async real-time scrape
Source: https://docs.brightdata.com/api-reference/scraper-studio-api/initiate-a-realtime-job/async-realtime-job

api-reference/web-scraper-ide-rest-api POST /dca/trigger_immediate
Trigger an async real-time Scraper Studio scrape. POST /dca/trigger_immediate returns a response_id to fetch the result from the Real-time data endpoint.

<Note>
  This endpoint does not return the scrape data. It returns a `response_id`. Use that `response_id` with the [Realtime Data endpoint](/api-reference/scraper-studio-api/Receive_data_from_real_time_work_scraper) to retrieve the result when the scrape is complete.
</Note>


# Trigger sync real-time scrape
Source: https://docs.brightdata.com/api-reference/scraper-studio-api/initiate-a-realtime-job/sync-realtime-job

api-reference/web-scraper-ide-rest-api POST /dca/crawl
Trigger a synchronous real-time Scraper Studio scrape. POST /dca/crawl holds the request open until the scraper finishes or times out, then returns JSON.

The synchronous real-time endpoint keeps the HTTP request open until the scraper finishes or the `timeout` is reached, then returns the collected data directly as JSON. This is the difference from the [async real-time endpoint](/api-reference/scraper-studio-api/initiate-a-realtime-job/async-realtime-job), which returns a `response_id` immediately.

<Warning>
  You can trigger only **single-input** APIs. Make sure the payload is **an object, not an array of objects**.
</Warning>

## Timeout behavior

The `timeout` query parameter must be between `25s` and `50s`.

* If the scraper finishes within the timeout, the response returns `200 OK` with the collected data.
* If the scraper is still running when the timeout is reached, the response returns `202 Accepted` with a `response_id`. Use that `response_id` with the [Realtime Data endpoint](/api-reference/scraper-studio-api/Receive_data_from_real_time_work_scraper) to retrieve the result asynchronously.

## When to use synchronous real-time

Use **synchronous real-time** (`POST /dca/crawl`) when:

* You need the result in the same HTTP request.
* You are sending a single input.
* Your client can keep the request open until the scrape finishes.
* The scrape normally completes within the configured timeout.

Use [**async real-time**](/api-reference/scraper-studio-api/initiate-a-realtime-job/async-realtime-job) (`POST /dca/trigger_immediate`) when:

* You want to trigger the scrape and retrieve the result later.
* You do not want to keep the HTTP request open.

Use [**batch collection**](/api-reference/scraper-studio-api/Trigger_a_scraper_for_batch_collection_method) when:

* You need to process multiple inputs in one run.


# Get job metadata
Source: https://docs.brightdata.com/api-reference/scraper-studio-api/job-data

api-reference/web-scraper-ide-rest-api GET /dca/log/{job_id}
GET /dca/log/{job_id} returns metadata for a Bright Data Scraper Studio job: status, input counts, output line counts, failures and run timestamps.

Retrieve metadata for a [triggered](./Trigger_a_scraper_for_batch_collection_method) Bright Data Scraper Studio job: status, input counts, success and failure counts, page counts and run timestamps. Use this endpoint when you need observability into a job, for example to track how many inputs succeeded, how many failed or how long the job took.

This endpoint returns metadata only. To download the actual scraped data, use [Receive batch data](./Receive_batch_data).

## Request

The `job_id` is the `collection_id` returned by [POST /dca/trigger](./Trigger_a_scraper_for_batch_collection_method).

<CodeGroup>
  ```bash cURL theme={null}
  curl "https://api.brightdata.com/dca/log/$JOB_ID" \
    -H "Authorization: Bearer $BRIGHT_DATA_API_TOKEN"
  ```

  ```python Python theme={null}
  response = requests.get(
      f"https://api.brightdata.com/dca/log/{job_id}",
      headers={"Authorization": f"Bearer {API_TOKEN}"},
  )
  metadata = response.json()
  ```

  ```js Node.js theme={null}
  const response = await fetch(
    `https://api.brightdata.com/dca/log/${jobId}`,
    { headers: { Authorization: `Bearer ${process.env.BRIGHT_DATA_API_TOKEN}` } }
  );
  const metadata = await response.json();
  ```
</CodeGroup>

## Response

```json theme={null}
{
  "Id": "j_ma13y9ay1piehrso8r",
  "Status": "done",
  "Collector": "c_m9im5n7v82p2y35la",
  "Template": "t_m9jty150kxgwtzcgi.3",
  "Inputs": 1,
  "dup_inputs": 0,
  "Lines": 60,
  "Fails": 0,
  "Pages": 1,
  "Pages_left": 0,
  "Success": 1,
  "Navigations": 2,
  "created": "2026-05-22T13:22:16.857Z",
  "started": "2026-05-22T13:22:18.123Z"
}
```

Common `Status` values: `building`, `running`, `done`, `failed`, `cancelled`.

## When to use this endpoint

* Track job progress for a dashboard or monitor
* Compute a success rate: `Success / Inputs`
* Identify which jobs deduplicated inputs (`dup_inputs > 0`)
* Measure job duration: compare `started` to the response timestamp

For the actual scraped records, see [Receive batch data](./Receive_batch_data). For per-input error details, see [Get errors for a job](./get-errors-for-job).

## Errors

| Status             | Cause                                | Fix                                                                             |
| ------------------ | ------------------------------------ | ------------------------------------------------------------------------------- |
| `401 Unauthorized` | Token missing, malformed or revoked  | Re-copy from [Account Settings → API Tokens](https://brightdata.com/cp/setting) |
| `404 Not Found`    | Job ID does not exist or has expired | Confirm the ID matches a recent `collection_id` from `/dca/trigger`             |
| `5xx`              | Transient Bright Data API error      | Retry with exponential backoff, for example 1s, 2s, 4s                          |

## Related

* [Trigger async batch collection](./Trigger_a_scraper_for_batch_collection_method): the endpoint that creates the job
* [Receive batch data](./Receive_batch_data): download the dataset itself, not metadata
* [Get errors for a job](./get-errors-for-job): per-input error details for debugging


# Pause a Scraper Studio job
Source: https://docs.brightdata.com/api-reference/scraper-studio-api/pause-job

api-reference/web-scraper-ide-rest-api POST /dca/jobs/{job_id}/pause
POST /dca/jobs/{job_id}/pause temporarily stops a running Bright Data Scraper Studio job. The job moves to paused and returns the plain text response OK.

Temporarily stop a running Bright Data Scraper Studio job. The job stops processing new inputs and moves to `paused`, and you can restart it later with [Resume a Scraper Studio job](./resume-job).

This endpoint takes no request body and returns the plain text body `OK` on success, not JSON. Read the response as text rather than calling a JSON parser on it.

## Job state behavior

| Action | Use when                                   | Result                      |
| ------ | ------------------------------------------ | --------------------------- |
| Pause  | You want to temporarily stop a running job | Job moves to `paused`       |
| Resume | You want to continue a paused job          | Job moves back to `running` |
| Cancel | You want to stop a job permanently         | Job moves to `canceled`     |

Completed jobs cannot be paused, resumed or canceled.

## How to find a job ID

Use the jobs list endpoint to find the ID of the job you want to pause:

```bash theme={null}
curl "https://api.brightdata.com/dca/collector/jobs?from_date=2026-06-01&to_date=2026-07-13" \
  -H "Authorization: Bearer $BRIGHT_DATA_API_TOKEN"
```

Use the returned `id` value as the `job_id` path parameter. See [List Scraper Studio jobs](./list-jobs) for the full parameter list.

## When to use this endpoint

* Hold a large batch during a target site incident, then resume once the site recovers
* Free concurrency for higher-priority work during a maintenance window
* Stop a job that is returning a high rate of `blocked` or `detect_block` errors while you adjust country, session or rate settings

To stop a job permanently instead, use [Cancel a Scraper Studio job](./cancel-job).

## Related

* [Resume a Scraper Studio job](./resume-job): restart a job paused with this endpoint
* [Cancel a Scraper Studio job](./cancel-job): stop a job permanently instead of temporarily
* [List Scraper Studio jobs](./list-jobs): find the `job_id` to pass to this endpoint
* [Get job metadata](./job-data): confirm the job status after pausing


# Rerun a Scraper Studio job
Source: https://docs.brightdata.com/api-reference/scraper-studio-api/rerun-job

api-reference/web-scraper-ide-rest-api POST /dca/jobs/{job_id}/rerun
POST /dca/jobs/{job_id}/rerun starts a new run from an existing Bright Data Scraper Studio job. Rerun everything, or send failed_only to retry failures.

Start a new run from an existing Bright Data Scraper Studio job. Send no request body to rerun the full job from the beginning, or send `failed_only: 1` to rerun only the steps that failed.

A successful request starts a **new** job and returns its `collection_id`. The original job is left untouched.

<Warning>
  Only jobs whose data has not expired can be rerun. Check the job's `expired` timestamp in [List Scraper Studio jobs](./list-jobs) or [Get job metadata](./job-data) before calling this endpoint. If the data has expired, the rerun fails and you must trigger a new job with the original inputs.

  Scraper Studio retains batch collection results for 16 days and real-time results for 7 days. See [Scraper Studio specifications](/datasets/scraper-studio/specifications).
</Warning>

## Rerun behavior

| Request body           | Behavior                                           | Use when                                                               |
| ---------------------- | -------------------------------------------------- | ---------------------------------------------------------------------- |
| No body                | Reruns the full job from the beginning             | You want to collect all inputs again                                   |
| `{ "failed_only": 1 }` | Reruns only the failed steps from the selected job | The job completed with failures and you want to retry just those parts |

## Request

Send the request without a body to rerun everything:

<CodeGroup>
  ```bash cURL theme={null}
  curl -X POST "https://api.brightdata.com/dca/jobs/$JOB_ID/rerun" \
    -H "Authorization: Bearer $BRIGHT_DATA_API_TOKEN"
  ```

  ```python Python theme={null}
  response = requests.post(
      f"https://api.brightdata.com/dca/jobs/{job_id}/rerun",
      headers={"Authorization": f"Bearer {API_TOKEN}"},
  )
  rerun = response.json()
  print(rerun["collection_id"])
  ```

  ```js Node.js theme={null}
  const response = await fetch(
    `https://api.brightdata.com/dca/jobs/${jobId}/rerun`,
    {
      method: 'POST',
      headers: { Authorization: `Bearer ${process.env.BRIGHT_DATA_API_TOKEN}` },
    }
  );
  const rerun = await response.json();
  console.log(rerun.collection_id);
  ```
</CodeGroup>

Add `failed_only: 1` to retry only the failed steps:

<CodeGroup>
  ```bash cURL theme={null}
  curl -X POST "https://api.brightdata.com/dca/jobs/$JOB_ID/rerun" \
    -H "Authorization: Bearer $BRIGHT_DATA_API_TOKEN" \
    -H "Content-Type: application/json" \
    -d '{"failed_only": 1}'
  ```

  ```python Python theme={null}
  response = requests.post(
      f"https://api.brightdata.com/dca/jobs/{job_id}/rerun",
      headers={
          "Authorization": f"Bearer {API_TOKEN}",
          "Content-Type": "application/json",
      },
      json={"failed_only": 1},
  )
  rerun = response.json()
  ```

  ```js Node.js theme={null}
  const response = await fetch(
    `https://api.brightdata.com/dca/jobs/${jobId}/rerun`,
    {
      method: 'POST',
      headers: {
        Authorization: `Bearer ${process.env.BRIGHT_DATA_API_TOKEN}`,
        'Content-Type': 'application/json',
      },
      body: JSON.stringify({ failed_only: 1 }),
    }
  );
  const rerun = await response.json();
  ```
</CodeGroup>

## Response

```json theme={null}
{
  "collection_id": "j_mdb7x2kq93nfytra1",
  "start_eta": "2026-07-20T12:10:12.301Z"
}
```

Use the returned `collection_id` as the `job_id` for [Get job metadata](./job-data) and [Receive batch data](./Receive_batch_data). It identifies the new rerun job, not the original one.

## How to find a job ID

Use the jobs list endpoint to find the ID of the job you want to rerun:

```bash theme={null}
curl "https://api.brightdata.com/dca/collector/jobs?from_date=2026-06-01&to_date=2026-07-13" \
  -H "Authorization: Bearer $BRIGHT_DATA_API_TOKEN"
```

Use the returned `id` value as the `job_id` path parameter. See [List Scraper Studio jobs](./list-jobs) for the full parameter list.

## When to use this endpoint

* Retry the failed inputs from a batch after fixing a selector or parser, without recollecting the inputs that already succeeded
* Recollect a full job on a schedule to refresh data that changes over time
* Rerun after a target site incident that caused a burst of `blocked` or `detect_block` errors

To see which inputs failed and why before deciding between a full rerun and `failed_only`, use [Get errors for a job](./get-errors-for-job).

## Related

* [Get errors for a job](./get-errors-for-job): identify which inputs failed before rerunning
* [Get job metadata](./job-data): check the `expired` timestamp and failure count of the original job
* [List Scraper Studio jobs](./list-jobs): find the `job_id` to pass to this endpoint
* [Cancel a Scraper Studio job](./cancel-job): stop a rerun that was started by mistake


# Resume a Scraper Studio job
Source: https://docs.brightdata.com/api-reference/scraper-studio-api/resume-job

api-reference/web-scraper-ide-rest-api POST /dca/jobs/{job_id}/resume
POST /dca/jobs/{job_id}/resume restarts a paused Bright Data Scraper Studio job. The job moves back to running and returns the plain text response OK.

Restart a paused Bright Data Scraper Studio job. The job continues processing its remaining inputs and moves back to `running`.

This endpoint takes no request body and returns the plain text body `OK` on success, not JSON. Read the response as text rather than calling a JSON parser on it.

<Note>
  Resume works only on a job in the `paused` state, which means a job stopped with [Pause a Scraper Studio job](./pause-job). A canceled job cannot be resumed, and neither can a completed one.
</Note>

## Job state behavior

| Action | Use when                                   | Result                      |
| ------ | ------------------------------------------ | --------------------------- |
| Pause  | You want to temporarily stop a running job | Job moves to `paused`       |
| Resume | You want to continue a paused job          | Job moves back to `running` |
| Cancel | You want to stop a job permanently         | Job moves to `canceled`     |

Completed jobs cannot be paused, resumed or canceled.

## How to find a job ID

Use the jobs list endpoint to find the ID of the job you want to resume:

```bash theme={null}
curl "https://api.brightdata.com/dca/collector/jobs?from_date=2026-06-01&to_date=2026-07-13" \
  -H "Authorization: Bearer $BRIGHT_DATA_API_TOKEN"
```

Use the returned `id` value as the `job_id` path parameter. See [List Scraper Studio jobs](./list-jobs) for the full parameter list.

## When to use this endpoint

* Continue a batch you paused during a target site incident, once the site is stable again
* Restart paused jobs at the end of a maintenance window
* Resume after adjusting country, session or concurrency settings in response to blocking

## Related

* [Pause a Scraper Studio job](./pause-job): the endpoint that puts a job into the `paused` state
* [Cancel a Scraper Studio job](./cancel-job): stop a paused job permanently instead of resuming it
* [List Scraper Studio jobs](./list-jobs): find the `job_id` to pass to this endpoint
* [Get job metadata](./job-data): confirm the job returned to `running`


# Search by prompt
Source: https://docs.brightdata.com/api-reference/scrapers/ai-search-apis/chatgpt-search-by-prompt

api-reference/sdk-specs/chatgpt-search-by-prompt POST /datasets/v3/scrape
Use the Bright Data AI Search API to search by Prompt. POST /datasets/v3/scrape triggers a job that returns structured AI search results as JSON.

## Query Parameters

<ParamField type="string">
  The dataset ID used for this request.

  <Warning>
    Must be set to `gd_m7aof0k82r803d5bjm` to collect **ChatGPT Search - Search by Prompt** data.
  </Warning>
</ParamField>

<ParamField type="boolean">
  Whether to send notifications when the request is completed.
</ParamField>

<ParamField type="boolean">
  Whether to include errors in the response.
</ParamField>

## Request Body

<ParamField type="object[]">
  An array of input objects.

  <Expandable title="properties">
    <ParamField type="string">
      The ChatGPT page URL. Must be set to `https://chatgpt.com/`.
    </ParamField>

    <ParamField type="string">
      The search prompt. Each prompt triggers a separate ChatGPT search query. Maximum 4,096 characters.
    </ParamField>

    <ParamField type="string">
      Country from which to perform the search.
    </ParamField>

    <ParamField type="number">
      Unique ID for tracking each crawl request.
    </ParamField>

    <ParamField type="boolean">
      If set to `true` and sources are not found in the page, an error message is returned instead of the record.
    </ParamField>

    <ParamField type="string">
      A follow-up input sent after receiving the first answer, aiming to clarify, expand, or refine the initial response. The result is returned as `additional_answer_text`.
    </ParamField>

    <ParamField type="boolean">
      Permission to run an external web search during the run. If set to `true` (default), the Web Search button is enabled and the model may click it. If `false`, the button is never clicked and the model will not trigger a web search. This field is a **permission, not a guarantee**: setting `true` does not mean a search will happen. Read `web_search_triggered` in the response to know whether a search actually ran. See [Query fan-out and web search control](/datasets/scrapers/concepts/query-fan-out).
    </ParamField>
  </Expandable>

  #### Example

  ```json wrap theme={null}
  {
    "input": [
      {"url": "https://chatgpt.com/", "prompt": "Top hotels in New York", "country": "us", "web_search": true},
      {"url": "https://chatgpt.com/", "prompt": "What are the biggest business trends to watch in the next five years?"}
    ]
  }
  ```
</ParamField>

<ResponseExample>
  ```json 200 theme={null}
  [
    {
      "url": "https://chatgpt.com/?q=Top%20hotels%20in%20New%20York",
      "prompt": "Top hotels in New York",
      "answer_text": "Here are some of the top-rated hotels in New York City...",
      "answer_text_markdown": "## Top Hotels in New York City\n\n1. **The Plaza** - Iconic luxury...",
      "answer_html": "<div>...</div>",
      "model": "gpt-4o",
      "web_search_triggered": true,
      "citations": [
        {
          "title": "Best Hotels in NYC 2024",
          "url": "https://www.travelandleisure.com/best-hotels-nyc",
          "position": 1
        }
      ],
      "search_sources": [
        {
          "url": "https://www.travelandleisure.com/best-hotels-nyc",
          "title": "Best Hotels in NYC",
          "favicon": "https://www.travelandleisure.com/favicon.ico"
        }
      ],
      "links_attached": [
        {
          "url": "https://www.theplazany.com",
          "text": "The Plaza",
          "position": 0
        }
      ],
      "recommendations": [],
      "references": [],
      "country": "us",
      "is_map": true,
      "shopping_visible": false,
      "prompt_sent_at": "2024-12-15T10:30:00.000Z",
      "index": null
    }
  ]
  ```
</ResponseExample>


# Collect products by URL
Source: https://docs.brightdata.com/api-reference/scrapers/e-commerce-apis/amazon-products-collect-by-url

api-reference/sdk-specs/amazon-products-collect-by-url POST /datasets/v3/scrape
Use the Bright Data Web Scraper API to collect Products by URL. POST /datasets/v3/scrape starts a job that returns structured product records as JSON.

## Query Parameters

<ParamField type="string">
  The dataset ID used for this request.

  <Warning>
    Must be set to `gd_l7q7dkf244hwjntr0` to collect **Products by URL** data.
  </Warning>
</ParamField>

<ParamField type="boolean">
  Whether to send notifications when the request is completed.
</ParamField>

<ParamField type="boolean">
  Whether to include errors in the response.
</ParamField>

## Request Body

<ParamField type="object[]">
  An array of input objects.

  <Expandable title="properties">
    <ParamField type="string">
      The URL of the Amazon product to collect.
    </ParamField>

    <ParamField type="number">
      Filter by the number of units bought in the past month.
    </ParamField>
  </Expandable>

  #### Example

  ```json wrap theme={null}
  {
    "input": [
      {"url": "https://www.amazon.com/dp/B0CHHSFMRL"},
      {"url": "https://www.amazon.com/dp/B09V3KXJPB"}
    ]
  }
  ```
</ParamField>

<ResponseExample>
  ```json 200 theme={null}
  [
    {
      "title": "Wireless Noise Cancelling Headphones",
      "url": "https://www.amazon.com/dp/B0CHHSFMRL",
      "asin": "B0CHHSFMRL",
      "price": 249.99,
      "currency": "USD",
      "rating": 4.6,
      "reviews_count": 12450,
      "seller_name": "Electronics Hub",
      "brand": "SoundTech",
      "availability": "In Stock",
      "main_image": "https://m.media-amazon.com/images/I/example-product.jpg",
      "description": "Premium wireless headphones with active noise cancellation and 40-hour battery life.",
      "category": "Electronics > Headphones > Over-Ear"
    }
  ]
  ```
</ResponseExample>


# Discover by best sellers URL
Source: https://docs.brightdata.com/api-reference/scrapers/e-commerce-apis/amazon-products-discover-by-best-sellers-url

POST https://api.brightdata.com/datasets/v3/scrape
Use the Bright Data Web Scraper API to discover by Best Sellers URL. POST /datasets/v3/scrape starts a job that returns structured product records as JSON.

## Query Parameters

<ParamField type="string">
  The dataset ID used for this request.

  <Warning>
    Must be set to `gd_l7q7dkf244hwjntr0` to collect **Discover by Best Sellers URL** data.
  </Warning>
</ParamField>

<ParamField type="string">
  Must be set to `discover_new`.
</ParamField>

<ParamField type="string">
  Must be set to `best_sellers_url`.
</ParamField>

<ParamField type="boolean">
  Whether to send notifications when the request is completed.
</ParamField>

<ParamField type="boolean">
  Whether to include errors in the response.
</ParamField>

## Request Body

<ParamField type="object[]">
  An array of input objects.

  <Expandable title="properties">
    <ParamField type="string">
      The URL of the Amazon best sellers page.
    </ParamField>
  </Expandable>

  #### Example

  ```json wrap theme={null}
  {
    "input": [
      {"url": "https://www.amazon.com/Best-Sellers-Electronics/zgbs/electronics"}
    ]
  }
  ```
</ParamField>

<ResponseExample>
  ```json 200 theme={null}
  [
    {
      "title": "Portable Bluetooth Speaker",
      "url": "https://www.amazon.com/dp/B09XY1234Z",
      "asin": "B09XY1234Z",
      "price": 39.99,
      "currency": "USD",
      "rating": 4.7,
      "reviews_count": 85200,
      "seller_name": "AudioTech Direct",
      "brand": "AudioTech",
      "availability": "In Stock",
      "main_image": "https://m.media-amazon.com/images/I/example-bestseller.jpg",
      "description": "Compact portable speaker with 20-hour battery and waterproof design.",
      "category": "Electronics > Portable Audio > Speakers"
    }
  ]
  ```
</ResponseExample>


# Discover Amazon products by category URL
Source: https://docs.brightdata.com/api-reference/scrapers/e-commerce-apis/amazon-products-discover-by-category-url

POST https://api.brightdata.com/datasets/v3/scrape
Use the Bright Data Web Scraper API to discover Amazon products by category URL. Calls the POST /datasets/v3/scrape endpoint.

## Query Parameters

<ParamField type="string">
  The dataset ID used for this request.

  <Warning>
    Must be set to `gd_l7q7dkf244hwjntr0` to collect **Discover by Category URL** data.
  </Warning>
</ParamField>

<ParamField type="string">
  Must be set to `discover_new`.
</ParamField>

<ParamField type="string">
  Must be set to `category_url`.
</ParamField>

<ParamField type="boolean">
  Whether to send notifications when the request is completed.
</ParamField>

<ParamField type="boolean">
  Whether to include errors in the response.
</ParamField>

## Request Body

<ParamField type="object[]">
  An array of input objects.

  <Expandable title="properties">
    <ParamField type="string">
      The URL of the Amazon category page.
    </ParamField>
  </Expandable>

  #### Example

  ```json wrap theme={null}
  {
    "input": [
      {"url": "https://www.amazon.com/s?bbn=172282&rh=n%3A172282"}
    ]
  }
  ```
</ParamField>

<ResponseExample>
  ```json 200 theme={null}
  [
    {
      "title": "USB-C Fast Charging Cable 6ft",
      "url": "https://www.amazon.com/dp/B0B12345AB",
      "asin": "B0B12345AB",
      "price": 12.99,
      "currency": "USD",
      "rating": 4.5,
      "reviews_count": 34500,
      "seller_name": "CablePro",
      "brand": "CablePro",
      "availability": "In Stock",
      "main_image": "https://m.media-amazon.com/images/I/example-category.jpg",
      "description": "Durable braided USB-C cable with fast charging support up to 100W.",
      "category": "Electronics > Accessories > Cables"
    }
  ]
  ```
</ResponseExample>


# Discover Amazon products by keyword
Source: https://docs.brightdata.com/api-reference/scrapers/e-commerce-apis/amazon-products-discover-by-keyword

POST https://api.brightdata.com/datasets/v3/scrape
Use the Bright Data Web Scraper API to discover Amazon products by keyword. Calls the POST /datasets/v3/scrape endpoint.

## Query Parameters

<ParamField type="string">
  The dataset ID used for this request.

  <Warning>
    Must be set to `gd_l7q7dkf244hwjntr0` to collect **Discover by Keyword** data.
  </Warning>
</ParamField>

<ParamField type="string">
  Must be set to `discover_new`.
</ParamField>

<ParamField type="string">
  Must be set to `keyword`.
</ParamField>

<ParamField type="boolean">
  Whether to send notifications when the request is completed.
</ParamField>

<ParamField type="boolean">
  Whether to include errors in the response.
</ParamField>

## Request Body

<ParamField type="object[]">
  An array of input objects.

  <Expandable title="properties">
    <ParamField type="string">
      The keyword to search for Amazon products.
    </ParamField>

    <ParamField type="string">
      The ZIP code to use for location-based results.
    </ParamField>
  </Expandable>

  #### Example

  ```json wrap theme={null}
  {
    "input": [
      {
        "keyword": "wireless mouse",
        "zipcode": "10001"
      }
    ]
  }
  ```
</ParamField>

<ResponseExample>
  ```json 200 theme={null}
  [
    {
      "title": "Ergonomic Wireless Mouse with USB Receiver",
      "url": "https://www.amazon.com/dp/B0C98765XY",
      "asin": "B0C98765XY",
      "price": 24.99,
      "currency": "USD",
      "rating": 4.4,
      "reviews_count": 18700,
      "seller_name": "PeripheralsDirect",
      "brand": "ErgoClick",
      "availability": "In Stock",
      "main_image": "https://m.media-amazon.com/images/I/example-mouse.jpg",
      "description": "Lightweight ergonomic wireless mouse with adjustable DPI and silent clicks.",
      "category": "Electronics > Computers > Mice"
    }
  ]
  ```
</ResponseExample>


# Discover Amazon products by UPC
Source: https://docs.brightdata.com/api-reference/scrapers/e-commerce-apis/amazon-products-discover-by-upc

POST https://api.brightdata.com/datasets/v3/scrape
Use the Bright Data Web Scraper API to discover by UPC. POST /datasets/v3/scrape starts a job that returns structured product records as JSON.

## Query Parameters

<ParamField type="string">
  The dataset ID used for this request.

  <Warning>
    Must be set to `gd_l7q7dkf244hwjntr0` to collect **Discover by UPC** data.
  </Warning>
</ParamField>

<ParamField type="string">
  Must be set to `discover_new`.
</ParamField>

<ParamField type="string">
  Must be set to `upc`.
</ParamField>

<ParamField type="boolean">
  Whether to send notifications when the request is completed.
</ParamField>

<ParamField type="boolean">
  Whether to include errors in the response.
</ParamField>

## Request Body

<ParamField type="object[]">
  An array of input objects.

  <Expandable title="properties">
    <ParamField type="string">
      The UPC code of the product to look up.
    </ParamField>
  </Expandable>

  #### Example

  ```json wrap theme={null}
  {
    "input": [
      {"upc": "012345678901"},
      {"upc": "098765432109"}
    ]
  }
  ```
</ParamField>

<ResponseExample>
  ```json 200 theme={null}
  [
    {
      "title": "Stainless Steel Water Bottle 32oz",
      "url": "https://www.amazon.com/dp/B0D11223AB",
      "asin": "B0D11223AB",
      "price": 19.99,
      "currency": "USD",
      "rating": 4.8,
      "reviews_count": 42300,
      "seller_name": "HydroGear",
      "brand": "HydroGear",
      "availability": "In Stock",
      "main_image": "https://m.media-amazon.com/images/I/example-bottle.jpg",
      "description": "Double-wall vacuum insulated water bottle that keeps drinks cold for 24 hours.",
      "category": "Sports & Outdoors > Water Bottles"
    }
  ]
  ```
</ResponseExample>


# Collect products global by URL
Source: https://docs.brightdata.com/api-reference/scrapers/e-commerce-apis/amazon-products-global-collect-by-url

POST https://api.brightdata.com/datasets/v3/scrape
Use the Bright Data Web Scraper API to collect Products Global by URL. POST /datasets/v3/scrape starts a job that returns structured product records as JSON.

## Query Parameters

<ParamField type="string">
  The dataset ID used for this request.

  <Warning>
    Must be set to `gd_lwhideng15g8jg63s7` to collect **Products Global by URL** data.
  </Warning>
</ParamField>

<ParamField type="boolean">
  Whether to send notifications when the request is completed.
</ParamField>

<ParamField type="boolean">
  Whether to include errors in the response.
</ParamField>

## Request Body

<ParamField type="object[]">
  An array of input objects.

  <Expandable title="properties">
    <ParamField type="string">
      The URL of the Amazon product from any country domain.
    </ParamField>

    <ParamField type="number">
      Filter by the number of units bought in the past month.
    </ParamField>
  </Expandable>

  #### Example

  ```json wrap theme={null}
  {
    "input": [
      {"url": "https://www.amazon.de/-/en/dp/B078TNNZK3"},
      {"url": "https://www.amazon.co.jp/dp/B0CWV9YTLV"}
    ]
  }
  ```
</ParamField>

<ResponseExample>
  ```json 200 theme={null}
  [
    {
      "title": "Bluetooth Portable Speaker Waterproof",
      "url": "https://www.amazon.de/-/en/dp/B078TNNZK3",
      "asin": "B078TNNZK3",
      "price": 59.99,
      "currency": "EUR",
      "rating": 4.5,
      "reviews_count": 23400,
      "seller_name": "AudioWorld DE",
      "brand": "SoundMax",
      "availability": "In Stock",
      "main_image": "https://m.media-amazon.com/images/I/example-global.jpg",
      "description": "Waterproof portable speaker with 360-degree sound and 12-hour battery.",
      "category": "Electronics > Audio > Speakers",
      "country_domain": "amazon.de"
    }
  ]
  ```
</ResponseExample>


# Discover by brand
Source: https://docs.brightdata.com/api-reference/scrapers/e-commerce-apis/amazon-products-global-discover-by-brand

POST https://api.brightdata.com/datasets/v3/scrape
Use the Bright Data Web Scraper API to discover by Brand. POST /datasets/v3/scrape starts a job that returns structured product records as JSON.

## Query Parameters

<ParamField type="string">
  The dataset ID used for this request.

  <Warning>
    Must be set to `gd_lwhideng15g8jg63s7` to collect **Discover by Brand** data.
  </Warning>
</ParamField>

<ParamField type="string">
  Must be set to `discover_new`.
</ParamField>

<ParamField type="string">
  Must be set to `brand`.
</ParamField>

<ParamField type="boolean">
  Whether to send notifications when the request is completed.
</ParamField>

<ParamField type="boolean">
  Whether to include errors in the response.
</ParamField>

## Request Body

<ParamField type="object[]">
  An array of input objects.

  <Expandable title="properties">
    <ParamField type="string">
      The URL of the Amazon brand page.
    </ParamField>

    <ParamField type="number">
      The number of products to collect. Missing value indicates no limit.
    </ParamField>
  </Expandable>

  #### Example

  ```json wrap theme={null}
  {
    "input": [
      {
        "brand_url": "https://www.amazon.com/stores/BrandName/page/12345678-ABCD-1234-EFGH-123456789012",
        "num_of_products": 20
      }
    ]
  }
  ```
</ParamField>

<ResponseExample>
  ```json 200 theme={null}
  [
    {
      "title": "Smart Fitness Tracker with Heart Rate Monitor",
      "url": "https://www.amazon.com/dp/B0D55667AB",
      "asin": "B0D55667AB",
      "price": 49.99,
      "currency": "USD",
      "rating": 4.3,
      "reviews_count": 9800,
      "seller_name": "FitTech Official",
      "brand": "FitTech",
      "availability": "In Stock",
      "main_image": "https://m.media-amazon.com/images/I/example-brand.jpg",
      "description": "Slim fitness tracker with continuous heart rate monitoring and sleep tracking.",
      "category": "Electronics > Wearables > Fitness Trackers",
      "country_domain": "amazon.com"
    }
  ]
  ```
</ResponseExample>


# Discover Amazon global by category URL
Source: https://docs.brightdata.com/api-reference/scrapers/e-commerce-apis/amazon-products-global-discover-by-category-url

POST https://api.brightdata.com/datasets/v3/scrape
Use the Bright Data Web Scraper API to discover Amazon global by category URL. Calls the POST /datasets/v3/scrape endpoint.

## Query Parameters

<ParamField type="string">
  The dataset ID used for this request.

  <Warning>
    Must be set to `gd_lwhideng15g8jg63s7` to collect **Discover by Category URL** data.
  </Warning>
</ParamField>

<ParamField type="string">
  Must be set to `discover_new`.
</ParamField>

<ParamField type="string">
  Must be set to `category_url`.
</ParamField>

<ParamField type="boolean">
  Whether to send notifications when the request is completed.
</ParamField>

<ParamField type="boolean">
  Whether to include errors in the response.
</ParamField>

## Request Body

<ParamField type="object[]">
  An array of input objects.

  <Expandable title="properties">
    <ParamField type="string">
      The URL of the Amazon category page.
    </ParamField>

    <ParamField type="number">
      The number of products to collect. Missing value indicates no limit.
    </ParamField>
  </Expandable>

  #### Example

  ```json wrap theme={null}
  {
    "input": [
      {
        "category_url": "https://www.amazon.de/-/en/b?node=340843031",
        "num_of_products": 25
      }
    ]
  }
  ```
</ParamField>

<ResponseExample>
  ```json 200 theme={null}
  [
    {
      "title": "Mechanical Gaming Keyboard RGB Backlit",
      "url": "https://www.amazon.de/dp/B0C44556CD",
      "asin": "B0C44556CD",
      "price": 79.99,
      "currency": "EUR",
      "rating": 4.6,
      "reviews_count": 5600,
      "seller_name": "GamerGear EU",
      "brand": "KeyMaster",
      "availability": "In Stock",
      "main_image": "https://m.media-amazon.com/images/I/example-keyboard.jpg",
      "description": "Full-size mechanical keyboard with customizable RGB and hot-swappable switches.",
      "category": "Computers & Accessories > Keyboards",
      "country_domain": "amazon.de"
    }
  ]
  ```
</ResponseExample>


# Discover by keywords
Source: https://docs.brightdata.com/api-reference/scrapers/e-commerce-apis/amazon-products-global-discover-by-keywords

POST https://api.brightdata.com/datasets/v3/scrape
Use the Bright Data Web Scraper API to discover by Keywords. POST /datasets/v3/scrape starts a job that returns structured product records as JSON.

## Query Parameters

<ParamField type="string">
  The dataset ID used for this request.

  <Warning>
    Must be set to `gd_lwhideng15g8jg63s7` to collect **Discover by Keywords** data.
  </Warning>
</ParamField>

<ParamField type="string">
  Must be set to `discover_new`.
</ParamField>

<ParamField type="string">
  Must be set to `keyword`.
</ParamField>

<ParamField type="boolean">
  Whether to send notifications when the request is completed.
</ParamField>

<ParamField type="boolean">
  Whether to include errors in the response.
</ParamField>

## Request Body

<ParamField type="object[]">
  An array of input objects.

  <Expandable title="properties">
    <ParamField type="string">
      The keyword to search for products.
    </ParamField>

    <ParamField type="string">
      The Amazon domain to search on (e.g. [https://www.amazon.com](https://www.amazon.com)).
    </ParamField>

    <ParamField type="number">
      The number of search result pages to collect.
    </ParamField>
  </Expandable>

  #### Example

  ```json wrap theme={null}
  {
    "input": [
      {
        "keyword": "laptop stand",
        "url": "https://www.amazon.com",
        "pages_to_search": 3
      }
    ]
  }
  ```
</ParamField>

<ResponseExample>
  ```json 200 theme={null}
  [
    {
      "title": "Adjustable Laptop Stand for Desk",
      "url": "https://www.amazon.com/dp/B0B77889EF",
      "asin": "B0B77889EF",
      "price": 34.99,
      "currency": "USD",
      "rating": 4.7,
      "reviews_count": 15200,
      "seller_name": "DeskPro Accessories",
      "brand": "DeskPro",
      "availability": "In Stock",
      "main_image": "https://m.media-amazon.com/images/I/example-stand.jpg",
      "description": "Ergonomic aluminum laptop stand with adjustable height and angle.",
      "category": "Office Products > Desk Accessories > Laptop Stands",
      "country_domain": "amazon.com"
    }
  ]
  ```
</ResponseExample>


# Discover by seller
Source: https://docs.brightdata.com/api-reference/scrapers/e-commerce-apis/amazon-products-global-discover-by-seller

POST https://api.brightdata.com/datasets/v3/scrape
Use the Bright Data Web Scraper API to discover by Seller. POST /datasets/v3/scrape starts a job that returns structured product records as JSON.

## Query Parameters

<ParamField type="string">
  The dataset ID used for this request.

  <Warning>
    Must be set to `gd_lwhideng15g8jg63s7` to collect **Discover by Seller** data.
  </Warning>
</ParamField>

<ParamField type="string">
  Must be set to `discover_new`.
</ParamField>

<ParamField type="string">
  Must be set to `seller`.
</ParamField>

<ParamField type="boolean">
  Whether to send notifications when the request is completed.
</ParamField>

<ParamField type="boolean">
  Whether to include errors in the response.
</ParamField>

## Request Body

<ParamField type="object[]">
  An array of input objects.

  <Expandable title="properties">
    <ParamField type="string">
      The URL of the Amazon seller page.
    </ParamField>

    <ParamField type="number">
      The number of products to collect. Missing value indicates no limit.
    </ParamField>
  </Expandable>

  #### Example

  ```json wrap theme={null}
  {
    "input": [
      {
        "seller_url": "https://www.amazon.com/sp?ie=UTF8&seller=A2FE2Y3KEQLBV7",
        "num_of_products": 30
      }
    ]
  }
  ```
</ParamField>

<ResponseExample>
  ```json 200 theme={null}
  [
    {
      "title": "Wireless Charging Pad 15W Fast Charge",
      "url": "https://www.amazon.com/dp/B0C99887GH",
      "asin": "B0C99887GH",
      "price": 18.99,
      "currency": "USD",
      "rating": 4.4,
      "reviews_count": 7300,
      "seller_name": "Electronics Hub",
      "brand": "ChargeFast",
      "availability": "In Stock",
      "main_image": "https://m.media-amazon.com/images/I/example-charger.jpg",
      "description": "Slim wireless charging pad compatible with all Qi-enabled devices.",
      "category": "Electronics > Accessories > Chargers",
      "country_domain": "amazon.com"
    }
  ]
  ```
</ResponseExample>


# Collect products search by URL
Source: https://docs.brightdata.com/api-reference/scrapers/e-commerce-apis/amazon-products-search-collect-by-url

POST https://api.brightdata.com/datasets/v3/scrape
Use the Bright Data Web Scraper API to collect Products Search by URL. POST /datasets/v3/scrape starts a job that returns structured product records as JSON.

## Query Parameters

<ParamField type="string">
  The dataset ID used for this request.

  <Warning>
    Must be set to `gd_lwdb4vjm1ehb499uxs` to collect **Products Search by URL** data.
  </Warning>
</ParamField>

<ParamField type="boolean">
  Whether to send notifications when the request is completed.
</ParamField>

<ParamField type="boolean">
  Whether to include errors in the response.
</ParamField>

## Request Body

<ParamField type="object[]">
  An array of input objects.

  <Expandable title="properties">
    <ParamField type="string">
      The keyword to search for products.
    </ParamField>

    <ParamField type="string">
      The Amazon domain to search on (e.g. [https://www.amazon.com](https://www.amazon.com)).
    </ParamField>

    <ParamField type="number">
      The number of search result pages to collect.
    </ParamField>
  </Expandable>

  #### Example

  ```json wrap theme={null}
  {
    "input": [
      {
        "keyword": "X-box",
        "url": "https://www.amazon.com",
        "pages_to_search": 2
      }
    ]
  }
  ```
</ParamField>

<ResponseExample>
  ```json 200 theme={null}
  [
    {
      "title": "Wireless Gaming Controller for Console",
      "url": "https://www.amazon.com/dp/B0D22334IJ",
      "asin": "B0D22334IJ",
      "price": 59.99,
      "currency": "USD",
      "rating": 4.6,
      "reviews_count": 28400,
      "seller_name": "GameTech Store",
      "brand": "GameTech",
      "availability": "In Stock",
      "main_image": "https://m.media-amazon.com/images/I/example-controller.jpg",
      "description": "Ergonomic wireless controller with custom button mapping and vibration feedback.",
      "category": "Video Games > Accessories > Controllers"
    }
  ]
  ```
</ResponseExample>


# Collect reviews by URL
Source: https://docs.brightdata.com/api-reference/scrapers/e-commerce-apis/amazon-reviews-collect-by-url

api-reference/sdk-specs/amazon-reviews-collect-by-url POST /datasets/v3/scrape
Use the Bright Data Web Scraper API to collect Reviews by URL. POST /datasets/v3/scrape starts a job that returns structured product records as JSON.

## Query Parameters

<ParamField type="string">
  The dataset ID used for this request.

  <Warning>
    Must be set to `gd_le8e811kzy4ggddlq` to collect **Reviews by URL** data.
  </Warning>
</ParamField>

<ParamField type="boolean">
  Whether to send notifications when the request is completed.
</ParamField>

<ParamField type="boolean">
  Whether to include errors in the response.
</ParamField>

## Request Body

<ParamField type="object[]">
  An array of input objects.

  <Expandable title="properties">
    <ParamField type="string">
      The URL of the Amazon product to collect reviews from.
    </ParamField>

    <ParamField type="string[]">
      An array of review IDs to exclude from the results.
    </ParamField>
  </Expandable>

  #### Example

  ```json wrap theme={null}
  {
    "input": [
      {"url": "https://www.amazon.com/dp/B0CHHSFMRL"}
    ]
  }
  ```
</ParamField>

<ResponseExample>
  ```json 200 theme={null}
  [
    {
      "url": "https://www.amazon.com/dp/B0CHHSFMRL",
      "asin": "B0CHHSFMRL",
      "reviewer_name": "John D.",
      "rating": 5,
      "review_title": "Best headphones I have ever owned",
      "review_text": "Incredible sound quality and the noise cancellation is top-notch. Battery lasts for days on a single charge.",
      "review_date": "2025-01-15T00:00:00.000Z",
      "verified_purchase": true
    }
  ]
  ```
</ResponseExample>


# Collect sellers info by URL
Source: https://docs.brightdata.com/api-reference/scrapers/e-commerce-apis/amazon-sellers-info-collect-by-url

api-reference/sdk-specs/amazon-sellers-info-collect-by-url POST /datasets/v3/scrape
Use the Bright Data Web Scraper API to collect Sellers Info by URL. POST /datasets/v3/scrape starts a job that returns structured product records as JSON.

## Query Parameters

<ParamField type="string">
  The dataset ID used for this request.

  <Warning>
    Must be set to `gd_lhotzucw1etoe5iw1k` to collect **Sellers Info by URL** data.
  </Warning>
</ParamField>

<ParamField type="boolean">
  Whether to send notifications when the request is completed.
</ParamField>

<ParamField type="boolean">
  Whether to include errors in the response.
</ParamField>

## Request Body

<ParamField type="object[]">
  An array of input objects.

  <Expandable title="properties">
    <ParamField type="string">
      The URL of the Amazon seller page to collect.
    </ParamField>
  </Expandable>

  #### Example

  ```json wrap theme={null}
  {
    "input": [
      {"url": "https://www.amazon.com/sp?ie=UTF8&seller=A2FE2Y3KEQLBV7"}
    ]
  }
  ```
</ParamField>

<ResponseExample>
  ```json 200 theme={null}
  [
    {
      "seller_name": "Electronics Hub",
      "seller_url": "https://www.amazon.com/sp?ie=UTF8&seller=A2FE2Y3KEQLBV7",
      "seller_id": "A2FE2Y3KEQLBV7",
      "rating": 4.5,
      "reviews_count": 8920,
      "business_name": "Electronics Hub LLC",
      "business_address": "123 Commerce St, Seattle, WA 98101"
    }
  ]
  ```
</ResponseExample>


# Cancel snapshot
Source: https://docs.brightdata.com/api-reference/scrapers/management-apis/cancel-snapshot

api-reference/dca-api post /datasets/v3/snapshot/{snapshot_id}/cancel
Use Bright Data Web Scraper API management endpoints to cancel Snapshot. POST /datasets/v3/snapshot/{id}/cancel returns snapshot or job status as JSON.



# Get snapshot delivery parts
Source: https://docs.brightdata.com/api-reference/scrapers/management-apis/get-snapshot-delivery-parts

api-reference/dca-api get /datasets/v3/snapshot/{snapshot_id}/parts
Use Bright Data Web Scraper API management endpoints to get Snapshot Delivery Parts. Endpoint: POST /datasets/v3/snapshot.



# Get snapshot input
Source: https://docs.brightdata.com/api-reference/scrapers/management-apis/get-snapshot-input

api-reference/dca-api get /datasets/v3/snapshot/{snapshot_id}/input
Use Bright Data Web Scraper API management endpoints to get Snapshot Input. GET /datasets/v3/snapshot/{id}/input returns snapshot or job status as JSON.



# Monitor delivery
Source: https://docs.brightdata.com/api-reference/scrapers/management-apis/monitor-delivery

api-reference/dca-api get /datasets/v3/delivery/{delivery_id}
Use Bright Data Web Scraper API management endpoints to monitor Delivery. GET /datasets/v3/delivery/{delivery_id} returns snapshot or job status as JSON.



# Rerun snapshot
Source: https://docs.brightdata.com/api-reference/scrapers/management-apis/rerun-snapshot

api-reference/dca-api post /datasets/v3/snapshot/{snapshot_id}/rerun
Use Bright Data Web Scraper API management endpoints to rerun Snapshot. POST /datasets/v3/snapshot/{id}/rerun returns snapshot or job status as JSON.



# Get snapshot data
Source: https://docs.brightdata.com/api-reference/scrapers/management-apis/snapshot-data

api-reference/dca-api get /datasets/v3/log/{snapshot_id}
Use Bright Data Web Scraper API management endpoints to get Snapshot Data. GET /datasets/v3/log/{id} returns snapshot or job status as JSON.



# Collect Facebook comments by URL
Source: https://docs.brightdata.com/api-reference/scrapers/social-media-apis/facebook-comments-collect-by-url

api-reference/sdk-specs/facebook-comments-collect-by-url POST /datasets/v3/scrape
Use the Bright Data Web Scraper API to collect Facebook comments by URL. Calls the POST /datasets/v3/scrape endpoint and returns a snapshot ID.

## Query Parameters

<ParamField type="string">
  The dataset ID used for this request.

  <Warning>
    Must be set to `gd_lkay758p1eanlolqw8` to collect **Facebook comments** data.
  </Warning>
</ParamField>

<ParamField type="boolean">
  Whether to send notifications when the request is completed.
</ParamField>

<ParamField type="boolean">
  Whether to include errors in the response.
</ParamField>

## Request Body

<ParamField type="object[]">
  An array of input objects.

  <Expandable title="properties">
    <ParamField type="string">
      The URL of the Facebook post to collect comments from.
    </ParamField>
  </Expandable>

  #### Example

  ```json wrap theme={null}
  {
    "input": [
      {"url": "https://www.facebook.com/NASA/posts/1234567890"},
      {"url": "https://www.facebook.com/Meta/posts/9876543210"}
    ]
  }
  ```
</ParamField>

<ResponseExample>
  ```json 200 theme={null}
  [
    {
      "url": "https://www.facebook.com/Pagina12ok/posts/pfbid0...",
      "post_id": "1287876623560800",
      "post_url": "https://www.facebook.com/Pagina12ok/posts/pfbid0...",
      "comment_id": "Y29tbWVudDox...",
      "user_name": "Norma Ester Mercado",
      "user_id": "pfbid0...",
      "user_url": "https://www.facebook.com/normaester.mercado.1",
      "date_created": "2026-04-02T23:46:29.000Z",
      "comment_text": "Great post, thanks for sharing!",
      "num_likes": 1,
      "num_replies": 0,
      "attached_files": null,
      "type": "Comment",
      "reply": true,
      "parent_comment_id": "Y29tbWVudDox..."
    }
  ]
  ```
</ResponseExample>


# Collect company reviews by URL
Source: https://docs.brightdata.com/api-reference/scrapers/social-media-apis/facebook-company-reviews-collect-by-url

POST https://api.brightdata.com/datasets/v3/scrape
Use the Bright Data Web Scraper API to collect Company Reviews by URL. Calls the POST /datasets/v3/scrape endpoint and returns a snapshot ID.

## Query Parameters

<ParamField type="string">
  The dataset ID used for this request.

  <Warning>
    Must be set to `gd_m0dtqpiu1mbcyc2g86` to collect **Facebook company reviews** data.
  </Warning>
</ParamField>

<ParamField type="boolean">
  Whether to send notifications when the request is completed.
</ParamField>

<ParamField type="boolean">
  Whether to include errors in the response.
</ParamField>

## Request Body

<ParamField type="object[]">
  An array of input objects.

  <Expandable title="properties">
    <ParamField type="string">
      The URL of the Facebook page reviews to collect.
    </ParamField>

    <ParamField type="number">
      The number of reviews to collect. Missing value indicates no limit.
    </ParamField>
  </Expandable>

  #### Example

  ```json wrap theme={null}
  {
    "input": [
      {"url": "https://www.facebook.com/PepsiCo/reviews/", "num_of_reviews": 50},
      {"url": "https://www.facebook.com/CocaCola/reviews/"}
    ]
  }
  ```
</ParamField>

<ResponseExample>
  ```json 200 theme={null}
  [
    {
      "url": "https://www.facebook.com/PepsiCo/reviews/",
      "review_id": "pfbid02abc123def456",
      "reviewer_name": "John Smith",
      "reviewer_url": "https://www.facebook.com/john.smith.123",
      "rating": 5,
      "review_text": "Great company with excellent products and customer service.",
      "date_posted": "2026-03-15T14:30:00.000Z",
      "num_likes": 3,
      "company_name": "PepsiCo",
      "company_url": "https://www.facebook.com/PepsiCo",
      "company_rating": 4.2,
      "total_reviews": 1250
    }
  ]
  ```
</ResponseExample>


# Collect events by URL
Source: https://docs.brightdata.com/api-reference/scrapers/social-media-apis/facebook-events-collect-by-url

POST https://api.brightdata.com/datasets/v3/scrape
Use the Bright Data Web Scraper API to collect Events by URL. POST /datasets/v3/scrape starts a scraping job that returns the data as structured JSON records.

## Query Parameters

<ParamField type="string">
  The dataset ID used for this request.

  <Warning>
    Must be set to `gd_m14sd0to1jz48ppm51` to collect **Facebook events** data.
  </Warning>
</ParamField>

<ParamField type="boolean">
  Whether to send notifications when the request is completed.
</ParamField>

<ParamField type="boolean">
  Whether to include errors in the response.
</ParamField>

## Request Body

<ParamField type="object[]">
  An array of input objects.

  <Expandable title="properties">
    <ParamField type="string">
      The URL of the Facebook event to collect.
    </ParamField>
  </Expandable>

  #### Example

  ```json wrap theme={null}
  {
    "input": [
      {"url": "https://www.facebook.com/events/1546764716269782"},
      {"url": "https://www.facebook.com/events/9876543210123456"}
    ]
  }
  ```
</ParamField>

<ResponseExample>
  ```json 200 theme={null}
  [
    {
      "url": "https://www.facebook.com/events/1546764716269782",
      "event_id": "1546764716269782",
      "name": "Tech Innovation Summit 2026",
      "description": "Join us for a day of innovation and networking...",
      "start_date": "2026-06-15T09:00:00.000Z",
      "end_date": "2026-06-15T17:00:00.000Z",
      "location": "San Francisco Convention Center",
      "address": "747 Howard St, San Francisco, CA 94103",
      "organizer": "TechEvents Inc.",
      "organizer_url": "https://www.facebook.com/techevents",
      "attendees_count": 1250,
      "interested_count": 3400,
      "is_online": false,
      "ticket_url": "https://techsummit2026.eventbrite.com",
      "cover_photo": "https://...",
      "category": "Science & Technology"
    }
  ]
  ```
</ResponseExample>


# Discover events by URL
Source: https://docs.brightdata.com/api-reference/scrapers/social-media-apis/facebook-events-discover-by-url

POST https://api.brightdata.com/datasets/v3/scrape
Use the Bright Data Web Scraper API to discover Events by URL. POST /datasets/v3/scrape starts a scraping job that returns the data as structured JSON records.

## Query Parameters

<ParamField type="string">
  The dataset ID used for this request.

  <Warning>
    Must be set to `gd_m14sd0to1jz48ppm51` to collect **Facebook events** data.
  </Warning>
</ParamField>

<ParamField type="boolean">
  Whether to send notifications when the request is completed.
</ParamField>

<ParamField type="boolean">
  Whether to include errors in the response.
</ParamField>

## Request Body

<ParamField type="object[]">
  An array of input objects.

  <Expandable title="properties">
    <ParamField type="string">
      The Facebook events page URL to discover events from.
    </ParamField>
  </Expandable>

  #### Example

  ```json wrap theme={null}
  {
    "input": [
      {"url": "https://www.facebook.com/events/search/?q=tech+conference"},
      {"url": "https://www.facebook.com/events/search/?q=music+festival"}
    ]
  }
  ```
</ParamField>

<ResponseExample>
  ```json 200 theme={null}
  [
    {
      "url": "https://www.facebook.com/events/1546764716269782",
      "event_id": "1546764716269782",
      "name": "Tech Innovation Summit 2026",
      "description": "Join us for a day of innovation and networking...",
      "start_date": "2026-06-15T09:00:00.000Z",
      "end_date": "2026-06-15T17:00:00.000Z",
      "location": "San Francisco Convention Center",
      "address": "747 Howard St, San Francisco, CA 94103",
      "organizer": "TechEvents Inc.",
      "organizer_url": "https://www.facebook.com/techevents",
      "attendees_count": 1250,
      "interested_count": 3400,
      "is_online": false,
      "ticket_url": "https://techsummit2026.eventbrite.com",
      "cover_photo": "https://...",
      "category": "Science & Technology"
    }
  ]
  ```
</ResponseExample>


# Discover events by venue
Source: https://docs.brightdata.com/api-reference/scrapers/social-media-apis/facebook-events-discover-by-venue

POST https://api.brightdata.com/datasets/v3/scrape
Use the Bright Data Web Scraper API to discover Events by Venue. Calls the POST /datasets/v3/scrape endpoint and returns a snapshot ID.

## Query Parameters

<ParamField type="string">
  The dataset ID used for this request.

  <Warning>
    Must be set to `gd_m14sd0to1jz48ppm51` to collect **Facebook events** data.
  </Warning>
</ParamField>

<ParamField type="boolean">
  Whether to send notifications when the request is completed.
</ParamField>

<ParamField type="boolean">
  Whether to include errors in the response.
</ParamField>

## Request Body

<ParamField type="object[]">
  An array of input objects.

  <Expandable title="properties">
    <ParamField type="string">
      The venue name or ID to discover events for.
    </ParamField>
  </Expandable>

  #### Example

  ```json wrap theme={null}
  {
    "input": [
      {"venue": "Madison Square Garden"},
      {"venue": "Staples Center"}
    ]
  }
  ```
</ParamField>

<ResponseExample>
  ```json 200 theme={null}
  [
    {
      "url": "https://www.facebook.com/events/1546764716269782",
      "event_id": "1546764716269782",
      "name": "Tech Innovation Summit 2026",
      "description": "Join us for a day of innovation and networking...",
      "start_date": "2026-06-15T09:00:00.000Z",
      "end_date": "2026-06-15T17:00:00.000Z",
      "location": "San Francisco Convention Center",
      "address": "747 Howard St, San Francisco, CA 94103",
      "organizer": "TechEvents Inc.",
      "organizer_url": "https://www.facebook.com/techevents",
      "attendees_count": 1250,
      "interested_count": 3400,
      "is_online": false,
      "ticket_url": "https://techsummit2026.eventbrite.com",
      "cover_photo": "https://...",
      "category": "Science & Technology"
    }
  ]
  ```
</ResponseExample>


# Collect Marketplace listings by URL
Source: https://docs.brightdata.com/api-reference/scrapers/social-media-apis/facebook-marketplace-collect-by-url

POST https://api.brightdata.com/datasets/v3/scrape
Use the Bright Data Web Scraper API to collect Marketplace Listings by URL. Calls the POST /datasets/v3/scrape endpoint.

## Query Parameters

<ParamField type="string">
  The dataset ID used for this request.

  <Warning>
    Must be set to `gd_lvt9iwuh6fbcwmx1a` to collect **Facebook Marketplace listings** data.
  </Warning>
</ParamField>

<ParamField type="boolean">
  Whether to send notifications when the request is completed.
</ParamField>

<ParamField type="boolean">
  Whether to include errors in the response.
</ParamField>

## Request Body

<ParamField type="object[]">
  An array of input objects.

  <Expandable title="properties">
    <ParamField type="string">
      The URL of the Facebook Marketplace listing to collect.
    </ParamField>
  </Expandable>

  #### Example

  ```json wrap theme={null}
  {
    "input": [
      {"url": "https://www.facebook.com/marketplace/item/1234567890"},
      {"url": "https://www.facebook.com/marketplace/item/9876543210"}
    ]
  }
  ```
</ParamField>

<ResponseExample>
  ```json 200 theme={null}
  [
    {
      "url": "https://www.facebook.com/marketplace/item/1259177466401495",
      "title": "2018 Mercedes-Benz C 300 Convertible 27k miles",
      "initial_price": 35995,
      "final_price": 35995,
      "currency": "USD",
      "product_id": "1259177466401495",
      "condition": "USED",
      "description": "1 owner, 2.0 turbo all wheel drive, leather seating pkg...",
      "location": "Knoxville, TN",
      "country_code": "US",
      "images": ["https://..."],
      "seller_description": "1 owner, 2.0 turbo...",
      "color": "grey",
      "brand": null,
      "videos": null,
      "profile_id": "34591790377134943",
      "listing_date": "2026-04-02T11:25:00.000Z"
    }
  ]
  ```
</ResponseExample>


# Discover Marketplace listings by keyword
Source: https://docs.brightdata.com/api-reference/scrapers/social-media-apis/facebook-marketplace-discover-by-keyword

POST https://api.brightdata.com/datasets/v3/scrape
Use the Bright Data Web Scraper API to discover Facebook Marketplace listings by keyword. Endpoint: POST /datasets/v3/scrape.

## Query Parameters

<ParamField type="string">
  The dataset ID used for this request.

  <Warning>
    Must be set to `gd_lvt9iwuh6fbcwmx1a` to collect **Facebook Marketplace listings** data.
  </Warning>
</ParamField>

<ParamField type="boolean">
  Whether to send notifications when the request is completed.
</ParamField>

<ParamField type="boolean">
  Whether to include errors in the response.
</ParamField>

## Request Body

<ParamField type="object[]">
  An array of input objects.

  <Expandable title="properties">
    <ParamField type="string">
      The search keyword for discovering Marketplace listings.
    </ParamField>
  </Expandable>

  #### Example

  ```json wrap theme={null}
  {
    "input": [
      {"keyword": "used iPhone"},
      {"keyword": "vintage furniture"}
    ]
  }
  ```
</ParamField>

<ResponseExample>
  ```json 200 theme={null}
  [
    {
      "url": "https://www.facebook.com/marketplace/item/1259177466401495",
      "title": "2018 Mercedes-Benz C 300 Convertible 27k miles",
      "initial_price": 35995,
      "final_price": 35995,
      "currency": "USD",
      "product_id": "1259177466401495",
      "condition": "USED",
      "description": "1 owner, 2.0 turbo all wheel drive, leather seating pkg...",
      "location": "Knoxville, TN",
      "country_code": "US",
      "images": ["https://..."],
      "seller_description": "1 owner, 2.0 turbo...",
      "color": "grey",
      "brand": null,
      "videos": null,
      "profile_id": "34591790377134943",
      "listing_date": "2026-04-02T11:25:00.000Z"
    }
  ]
  ```
</ResponseExample>


# Discover Marketplace listings by URL
Source: https://docs.brightdata.com/api-reference/scrapers/social-media-apis/facebook-marketplace-discover-by-url

POST https://api.brightdata.com/datasets/v3/scrape
Use the Bright Data Web Scraper API to discover Facebook Marketplace listings by URL. Endpoint: POST /datasets/v3/scrape.

## Query Parameters

<ParamField type="string">
  The dataset ID used for this request.

  <Warning>
    Must be set to `gd_lvt9iwuh6fbcwmx1a` to collect **Facebook Marketplace listings** data.
  </Warning>
</ParamField>

<ParamField type="boolean">
  Whether to send notifications when the request is completed.
</ParamField>

<ParamField type="boolean">
  Whether to include errors in the response.
</ParamField>

## Request Body

<ParamField type="object[]">
  An array of input objects.

  <Expandable title="properties">
    <ParamField type="string">
      The Facebook Marketplace search URL to discover listings from.
    </ParamField>
  </Expandable>

  #### Example

  ```json wrap theme={null}
  {
    "input": [
      {"url": "https://www.facebook.com/marketplace/category/electronics"},
      {"url": "https://www.facebook.com/marketplace/category/vehicles"}
    ]
  }
  ```
</ParamField>

<ResponseExample>
  ```json 200 theme={null}
  [
    {
      "url": "https://www.facebook.com/marketplace/item/1259177466401495",
      "title": "2018 Mercedes-Benz C 300 Convertible 27k miles",
      "initial_price": 35995,
      "final_price": 35995,
      "currency": "USD",
      "product_id": "1259177466401495",
      "condition": "USED",
      "description": "1 owner, 2.0 turbo all wheel drive, leather seating pkg...",
      "location": "Knoxville, TN",
      "country_code": "US",
      "images": ["https://..."],
      "seller_description": "1 owner, 2.0 turbo...",
      "color": "grey",
      "brand": null,
      "videos": null,
      "profile_id": "34591790377134943",
      "listing_date": "2026-04-02T11:25:00.000Z"
    }
  ]
  ```
</ResponseExample>


# Collect pages and profiles by URL
Source: https://docs.brightdata.com/api-reference/scrapers/social-media-apis/facebook-pages-and-profiles-collect-by-url

POST https://api.brightdata.com/datasets/v3/scrape
Use the Bright Data Web Scraper API to collect Pages and Profiles by URL. Calls the POST /datasets/v3/scrape endpoint and returns a snapshot ID.

## Query Parameters

<ParamField type="string">
  The dataset ID used for this request.

  <Warning>
    Must be set to `gd_mf124a0511bauquyow` to collect **Facebook pages and profiles** data.
  </Warning>
</ParamField>

<ParamField type="boolean">
  Whether to send notifications when the request is completed.
</ParamField>

<ParamField type="boolean">
  Whether to include errors in the response.
</ParamField>

## Request Body

<ParamField type="object[]">
  An array of input objects.

  <Expandable title="properties">
    <ParamField type="string">
      The URL of the Facebook page or profile to collect.
    </ParamField>
  </Expandable>

  #### Example

  ```json wrap theme={null}
  {
    "input": [
      {"url": "https://www.facebook.com/zuck"},
      {"url": "https://www.facebook.com/NASA"}
    ]
  }
  ```
</ParamField>

<ResponseExample>
  ```json 200 theme={null}
  [
    {
      "id": "100063743733252",
      "url": "https://www.facebook.com/tgfightsport",
      "page_name": "TG-Fight Sport",
      "username": "tgfightsport",
      "entity_type": "PAGE",
      "summary_text": "Martial arts training for all levels...",
      "primary_category": "Martial Arts School",
      "address": { "formatted": "Alleestrasse 1, Beckum, Germany" },
      "phones": ["+49 176 68576249"],
      "emails": ["tg-fightsport@hotmail.com"],
      "websites": null,
      "rating": null,
      "contact_and_basic_info": {
        "basic_info": {
          "hours": { "open_now": true },
          "rating": { "count": 4, "value": 0 }
        },
        "categories": ["Martial Arts School"],
        "contact_info": {
          "address": { "formatted": "Alleestrasse 1, Beckum, Germany, 59269" },
          "emails": ["tg-fightsport@hotmail.com"],
          "websites": ["https://www.tg-fightsport.com/"]
        }
      },
      "followers": 870,
      "logo": "https://...",
      "is_verified": false
    }
  ]
  ```
</ResponseExample>


# Collect page posts by URL
Source: https://docs.brightdata.com/api-reference/scrapers/social-media-apis/facebook-pages-posts-collect-by-url

api-reference/sdk-specs/facebook-pages-posts-collect-by-url POST /datasets/v3/scrape
Use the Bright Data Web Scraper API to collect Page Posts by URL. Calls the POST /datasets/v3/scrape endpoint and returns a snapshot ID.

## Query Parameters

<ParamField type="string">
  The dataset ID used for this request.

  <Warning>
    Must be set to `gd_lkaxegm826bjpoo9m5` to collect **Facebook page posts** data.
  </Warning>
</ParamField>

<ParamField type="boolean">
  Whether to send notifications when the request is completed.
</ParamField>

<ParamField type="boolean">
  Whether to include errors in the response.
</ParamField>

## Request Body

<ParamField type="object[]">
  An array of input objects.

  <Expandable title="properties">
    <ParamField type="string">
      The URL of the Facebook page to collect posts from.
    </ParamField>
  </Expandable>

  #### Example

  ```json wrap theme={null}
  {
    "input": [
      {"url": "https://www.facebook.com/NASA"},
      {"url": "https://www.facebook.com/Meta"}
    ]
  }
  ```
</ParamField>

<ResponseExample>
  ```json 200 theme={null}
  [
    {
      "url": "https://www.facebook.com/reel/1417029756382510/",
      "post_id": "1325707186087218",
      "user_url": "https://www.facebook.com/delish",
      "user_username_raw": "delish",
      "content": "Sweet niblets! This just unlocked a childhood memory",
      "date_posted": "2026-03-21T19:01:34.000Z",
      "hashtags": null,
      "num_comments": 1,
      "num_shares": 2,
      "num_likes_type": { "num": 34, "type": "Like" },
      "page_name": "Delish",
      "profile_id": "100059438474191",
      "page_intro": "Fun eats every day of the week.",
      "page_category": "News & media website",
      "page_logo": "https://...",
      "page_external_website": "likeshop.me/delish",
      "page_likes": null,
      "page_followers": 21000000,
      "page_is_verified": true,
      "original_post": { "user_avatar_image": null },
      "attachments": [
        {
          "attachment_url": "https://...",
          "id": "1417029756382510",
          "thumbnail_url": "https://...",
          "type": "Video",
          "url": "https://...",
          "video_length": "15509",
          "video_url": "https://..."
        }
      ],
      "page_url": "https://www.facebook.com/delish",
      "header_image": "https://...",
      "avatar_image_url": "https://...",
      "profile_handle": "delish",
      "is_sponsored": false,
      "shortcode": "1325707186087218",
      "video_view_count": 24093,
      "likes": 39,
      "post_type": "Reel",
      "following": 19,
      "count_reactions_type": [
        { "reaction_count": 34, "type": "Like" },
        { "reaction_count": 4, "type": "Haha" }
      ],
      "is_page": true,
      "play_count": 45717
    }
  ]
  ```
</ResponseExample>


# Discover page posts by username
Source: https://docs.brightdata.com/api-reference/scrapers/social-media-apis/facebook-pages-posts-discover-by-username

POST https://api.brightdata.com/datasets/v3/scrape
Use the Bright Data Web Scraper API to discover Page Posts by Username. Calls the POST /datasets/v3/scrape endpoint and returns a snapshot ID.

## Query Parameters

<ParamField type="string">
  The dataset ID used for this request.

  <Warning>
    Must be set to `gd_lkaxegm826bjpoo9m5` to collect **Facebook page posts** data.
  </Warning>
</ParamField>

<ParamField type="boolean">
  Whether to send notifications when the request is completed.
</ParamField>

<ParamField type="boolean">
  Whether to include errors in the response.
</ParamField>

## Request Body

<ParamField type="object[]">
  An array of input objects.

  <Expandable title="properties">
    <ParamField type="string">
      The Facebook page username.
    </ParamField>
  </Expandable>

  #### Example

  ```json wrap theme={null}
  {
    "input": [
      {"user_name": "NASA"},
      {"user_name": "Meta"}
    ]
  }
  ```
</ParamField>

<ResponseExample>
  ```json 200 theme={null}
  [
    {
      "url": "https://www.facebook.com/reel/1417029756382510/",
      "post_id": "1325707186087218",
      "user_url": "https://www.facebook.com/delish",
      "user_username_raw": "delish",
      "content": "Sweet niblets! This just unlocked a childhood memory",
      "date_posted": "2026-03-21T19:01:34.000Z",
      "hashtags": null,
      "num_comments": 1,
      "num_shares": 2,
      "num_likes_type": { "num": 34, "type": "Like" },
      "page_name": "Delish",
      "profile_id": "100059438474191",
      "page_intro": "Fun eats every day of the week.",
      "page_category": "News & media website",
      "page_logo": "https://...",
      "page_external_website": "likeshop.me/delish",
      "page_likes": null,
      "page_followers": 21000000,
      "page_is_verified": true,
      "original_post": { "user_avatar_image": null },
      "attachments": [
        {
          "attachment_url": "https://...",
          "id": "1417029756382510",
          "thumbnail_url": "https://...",
          "type": "Video",
          "url": "https://...",
          "video_length": "15509",
          "video_url": "https://..."
        }
      ],
      "page_url": "https://www.facebook.com/delish",
      "header_image": "https://...",
      "avatar_image_url": "https://...",
      "profile_handle": "delish",
      "is_sponsored": false,
      "shortcode": "1325707186087218",
      "video_view_count": 24093,
      "likes": 39,
      "post_type": "Reel",
      "following": 19,
      "count_reactions_type": [
        { "reaction_count": 34, "type": "Like" },
        { "reaction_count": 4, "type": "Haha" }
      ],
      "is_page": true,
      "play_count": 45717
    }
  ]
  ```
</ResponseExample>


# Collect posts by group URL
Source: https://docs.brightdata.com/api-reference/scrapers/social-media-apis/facebook-posts-by-group-collect-by-url

api-reference/sdk-specs/facebook-posts-by-group-collect-by-url POST /datasets/v3/scrape
Use the Bright Data Web Scraper API to collect Posts by Group URL. Calls the POST /datasets/v3/scrape endpoint and returns a snapshot ID.

## Query Parameters

<ParamField type="string">
  The dataset ID used for this request.

  <Warning>
    Must be set to `gd_lz11l67o2cb3r0lkj3` to collect **Facebook posts by group** data.
  </Warning>
</ParamField>

<ParamField type="boolean">
  Whether to send notifications when the request is completed.
</ParamField>

<ParamField type="boolean">
  Whether to include errors in the response.
</ParamField>

## Request Body

<ParamField type="object[]">
  An array of input objects.

  <Expandable title="properties">
    <ParamField type="string">
      The URL of the Facebook group to collect posts from.
    </ParamField>
  </Expandable>

  #### Example

  ```json wrap theme={null}
  {
    "input": [
      {"url": "https://www.facebook.com/groups/123456789"},
      {"url": "https://www.facebook.com/groups/987654321"}
    ]
  }
  ```
</ParamField>

<ResponseExample>
  ```json 200 theme={null}
  [
    {
      "url": "https://www.facebook.com/groups/532855527252024/posts/2189486054922288/",
      "post_id": "2189486054922288",
      "user_url": "https://www.facebook.com/people/User/61557299394534/",
      "user_username_raw": "EnhleNandie Mhlutshwa",
      "content": null,
      "date_posted": "2026-03-26T19:05:20.000Z",
      "num_comments": 0,
      "num_shares": 0,
      "group_name": "Job Seekers Community",
      "group_id": "532855527252024",
      "group_url": "https://www.facebook.com/groups/532855527252024/",
      "group_category": "Public group",
      "group_logo": "https://...",
      "group_members": 226500,
      "group_created_at": "2019-07-17T07:27:18.000Z",
      "user_is_verified": false,
      "attachments": [],
      "post_type": "Post",
      "likes": null,
      "profile_id": "61557299394534"
    }
  ]
  ```
</ResponseExample>


# Collect Facebook posts by URL
Source: https://docs.brightdata.com/api-reference/scrapers/social-media-apis/facebook-posts-collect-by-url

api-reference/sdk-specs/facebook-posts-collect-by-url POST /datasets/v3/scrape
Use the Bright Data Web Scraper API to collect Facebook posts by URL. Calls the POST /datasets/v3/scrape endpoint and returns a snapshot ID.

## Query Parameters

<ParamField type="string">
  The dataset ID used for this request.

  <Warning>
    Must be set to `gd_lyclm1571iy3mv57zw` to collect **Facebook posts** data.
  </Warning>
</ParamField>

<ParamField type="boolean">
  Whether to send notifications when the request is completed.
</ParamField>

<ParamField type="boolean">
  Whether to include errors in the response.
</ParamField>

## Request Body

<ParamField type="object[]">
  An array of input objects.

  <Expandable title="properties">
    <ParamField type="string">
      The URL of the Facebook post to collect.
    </ParamField>
  </Expandable>

  #### Example

  ```json wrap theme={null}
  {
    "input": [
      {"url": "https://www.facebook.com/NASA/posts/1234567890"},
      {"url": "https://www.facebook.com/Meta/posts/9876543210"}
    ]
  }
  ```
</ParamField>

<ResponseExample>
  ```json 200 theme={null}
  [
    {
      "url": "https://www.facebook.com/share/v/17yf2ZfpHp/",
      "post_id": "1528075055988555",
      "user_url": "https://www.facebook.com/thetoyinsider",
      "user_username_raw": "The Toy Insider",
      "content": "Hatchin' Yoshi is our whole personality until further notice. Hitting stores next month!",
      "date_posted": "2026-02-14T21:28:45.000Z",
      "num_comments": 966,
      "num_shares": 3500,
      "num_likes_type": [{ "num": 23800, "type": "Like" }],
      "profile_id": "100063582250570",
      "page_logo": "https://...",
      "page_likes": null,
      "page_followers": 36000,
      "page_is_verified": false,
      "attachments": [
        {
          "attachment_url": "https://...",
          "id": "1473877017491895",
          "type": "video",
          "url": "https://www.facebook.com/reel/1473877017491895",
          "video_length": "125767",
          "video_url": "https://..."
        }
      ],
      "page_url": "https://www.facebook.com/thetoyinsider",
      "profile_handle": "thetoyinsider",
      "is_sponsored": false,
      "video_view_count": 2300000,
      "likes": 23800,
      "post_type": "Post",
      "play_count": null
    }
  ]
  ```
</ResponseExample>


# Collect Facebook profiles by URL
Source: https://docs.brightdata.com/api-reference/scrapers/social-media-apis/facebook-profiles-collect-by-url

POST https://api.brightdata.com/datasets/v3/scrape
Use the Bright Data Web Scraper API to collect Facebook profiles by URL. Calls the POST /datasets/v3/scrape endpoint and returns a snapshot ID.

## Query Parameters

<ParamField type="string">
  The dataset ID used for this request.

  <Warning>
    Must be set to `gd_mf0urb782734ik94dz` to collect **Facebook profiles** data.
  </Warning>
</ParamField>

<ParamField type="boolean">
  Whether to send notifications when the request is completed.
</ParamField>

<ParamField type="boolean">
  Whether to include errors in the response.
</ParamField>

## Request Body

<ParamField type="object[]">
  An array of input objects.

  <Expandable title="properties">
    <ParamField type="string">
      The URL of the Facebook profile to collect.
    </ParamField>
  </Expandable>

  #### Example

  ```json wrap theme={null}
  {
    "input": [
      {"url": "https://www.facebook.com/zuck"},
      {"url": "https://www.facebook.com/sheryl"}
    ]
  }
  ```
</ParamField>

<ResponseExample>
  ```json 200 theme={null}
  [
    {
      "url": "https://www.facebook.com/GoramHomes/mentions/",
      "name": "Goram Homes",
      "id": "100090557460648",
      "profile_photo": "https://...",
      "cover_photo": "https://...",
      "work": null,
      "college": null,
      "high_school": null,
      "photos": null
    }
  ]
  ```
</ResponseExample>


# Collect reels by profile URL
Source: https://docs.brightdata.com/api-reference/scrapers/social-media-apis/facebook-reels-collect-by-url

api-reference/sdk-specs/facebook-reels-collect-by-url POST /datasets/v3/scrape
Use the Bright Data Web Scraper API to collect Reels by Profile URL. Calls the POST /datasets/v3/scrape endpoint and returns a snapshot ID.

## Query Parameters

<ParamField type="string">
  The dataset ID used for this request.

  <Warning>
    Must be set to `gd_lyclm3ey2q6rww027t` to collect **Facebook reels** data.
  </Warning>
</ParamField>

<ParamField type="boolean">
  Whether to send notifications when the request is completed.
</ParamField>

<ParamField type="boolean">
  Whether to include errors in the response.
</ParamField>

## Request Body

<ParamField type="object[]">
  An array of input objects.

  <Expandable title="properties">
    <ParamField type="string">
      The URL of the Facebook profile to collect reels from.
    </ParamField>

    <ParamField type="number">
      The number of recent reels to collect. Missing value indicates no limit.
    </ParamField>

    <ParamField type="string[]">
      Post IDs not to include.
    </ParamField>

    <ParamField type="string">
      Start date filter `MM-DD-YYYY` (should be earlier than "end\_date").
    </ParamField>

    <ParamField type="string">
      End date filter `MM-DD-YYYY` (should be later than "start\_date").
    </ParamField>
  </Expandable>

  #### Example

  ```json wrap theme={null}
  {
    "input": [
      {"url": "https://www.facebook.com/MrBeast6000", "num_of_posts": 10},
      {"url": "https://www.facebook.com/NASA", "start_date": "01-01-2025", "end_date": "03-01-2025"}
    ]
  }
  ```
</ParamField>

<ResponseExample>
  ```json 200 theme={null}
  [
    {
      "url": "https://www.facebook.com/reel/2128461008004479",
      "post_id": "1417440860423673",
      "user_url": "https://www.facebook.com/tmcnewsbr",
      "user_username_raw": "Radio Transamerica FM",
      "content": "Increase in US-Iran tensions...",
      "date_posted": "2026-04-06T00:00:00.000Z",
      "hashtags": ["#guerra", "#eua"],
      "num_comments": 2,
      "num_shares": 0,
      "video_view_count": 582,
      "likes": 3,
      "page_name": "Radio Transamerica FM",
      "profile_id": "100064733164731",
      "page_logo": "https://...",
      "page_likes": 0,
      "page_followers": 1200000,
      "thumbnail": "https://...",
      "page_url": "https://www.facebook.com/tmcnewsbr",
      "profile_handle": "tmcnewsbr",
      "shortcode": "2128461008004479",
      "length": 13.888,
      "audio": "AVAILABLE",
      "video_url": "https://..."
    }
  ]
  ```
</ResponseExample>


# Collect Instagram comments by URL
Source: https://docs.brightdata.com/api-reference/scrapers/social-media-apis/instagram-comments-collect-by-url

api-reference/sdk-specs/instagram-comments-collect-by-url POST /datasets/v3/scrape
Use the Bright Data Web Scraper API to collect Instagram comments by URL. Calls the POST /datasets/v3/scrape endpoint and returns a snapshot ID.

## Query Parameters

<ParamField type="string">
  The dataset ID used for this request.

  <Warning>
    Must be set to `gd_ltppn085pokosxh13` to collect **Comments by URL** data.
  </Warning>
</ParamField>

<ParamField type="boolean">
  Whether to send notifications when the request is completed.
</ParamField>

<ParamField type="boolean">
  Whether to include errors in the response.
</ParamField>

## Request Body

<ParamField type="object[]">
  An array of input objects.

  <Expandable title="properties">
    <ParamField type="string">
      Input specific post url to get the latest 15 comments
    </ParamField>
  </Expandable>

  #### Example

  ```json wrap theme={null}
  {
    "input": [
      {"url":"https://www.instagram.com/cats_of_instagram/reel/C4GLo_eLO2e/"},
      {"url":"https://www.instagram.com/catsofinstagram/p/CesFC7JLyFl/?img_index=1"},
      {"url":"https://www.instagram.com/cats_of_instagram/reel/C2TmNOVMSbG/"}
    ]
  }
  ```
</ParamField>

<ResponseExample>
  ```json 200 theme={null}
  [
    {
      "url": "https://www.instagram.com/nato",
      "comment_user": "met***han***r",
      "comment_user_url": "https://www.instagram.com/metlushanigor",
      "comment_date": "2026-03-14T01:13:08.000Z",
      "comment": "В реальних бойових діях ці танки за 5 хвилин будуть знищені,а солдати ще менше проживуть. Ви відстає НАТО на пʼять років",
      "likes_number": 0,
      "replies_number": 0,
      "replies": null,
      "hashtag_comment": null,
      "tagged_users_in_comment": null,
      "post_url": "https://www.instagram.com/p/DVyB2KkjS07/",
      "post_user": "******",
      "comment_id": "18168596065410257",
      "post_id": "3851148751604100411_985168596"
    }
  ]
  ```
</ResponseExample>


# Collect Instagram posts by URL
Source: https://docs.brightdata.com/api-reference/scrapers/social-media-apis/instagram-posts-collect-by-url

api-reference/sdk-specs/instagram-posts-collect-by-url POST /datasets/v3/scrape
Use the Bright Data Web Scraper API to collect Instagram posts by URL. Calls the POST /datasets/v3/scrape endpoint and returns a snapshot ID.

## Query Parameters

<ParamField type="string">
  The dataset ID used for this request.

  <Warning>
    Must be set to `gd_lk5ns7kz21pck8jpis` to collect **Posts by URL** data.
  </Warning>
</ParamField>

<ParamField type="boolean">
  Whether to send notifications when the request is completed.
</ParamField>

<ParamField type="boolean">
  Whether to include errors in the response.
</ParamField>

## Request Body

<ParamField type="object[]">
  An array of input objects.

  <Expandable title="properties">
    <ParamField type="string">
      The URL of the Instagram posts to collect.
    </ParamField>
  </Expandable>

  #### Example

  ```json wrap theme={null}
  {
    "input": [
      {"url":"https://www.instagram.com/p/Cuf4s0MNqNr"},
      {"url":"https://www.instagram.com/p/DP861NijuwE"}
    ]
  }
  ```
</ParamField>

<ResponseExample>
  ```json 200 theme={null}
  [
    {
      "url": "https://www.instagram.com/p/DIWPWGpsUQX",
      "user_posted": "limabijus",
      "description": "Coleção Laços 💝 Argolinhas cravejadas com micro zircônias em cores R$35,00\n\nParcelamos suas compras em até 12x no cartão \n\nFRETE FIXO PARA TODO PARÁ R$13,00 FRETE FIXO PARA TODO O BRASIL R$27,00\n\nCatálogo no link da bio.\n\n*Aceitamos todos os cartões\n*Pix\n\nLoja aberta das 08:00 as 18:30 Trav. Oriental do mercado. Rua ao lado da antiga Big Ben\n\n#açoinoxidável #açocirurgico #colarfolheado #joia",
      "hashtags": [
        "#a",
        "#a",
        "#colarfolheado",
        "#joia"
      ],
      "num_comments": 0,
      "date_posted": "2025-04-12T13:03:14.000Z",
      "likes": 51,
      "photos": [
        "https://scontent-dfw5-2.cdninstagram.com/v/t51.2885-15/489610375_18494864488028192_2686112351885091669_n.jpg?stp=dst-jpg_e35_p1080x1080_sh0.08_tt6&_nc_ht=scontent-dfw5-2.cdninstagram.com&_nc_cat=108&_nc_oc=Q6cZ2QGaMKgfOzjq0wPKSDzaCmtVKzedbmcC6K7R8nhooYRtxVg3ff27v7SxrDXsxdo2W7k&_nc_ohc=0MufbR7woQgQ7kNvwFygZL-&_nc_gid=nqIS79fttxt1Dm7FA1KvtA&edm=ANTKIIoBAAAA&ccb=7-5&oh=00_AfzNULCN5FUuEctA0H8JoRjWCeySVi7on4V_3tyVANwEgA&oe=69BD2DFE&_nc_sid=d885a2",
        "https://scontent-dfw5-2.cdninstagram.com/v/t51.2885-15/490407159_18494864497028192_459288836599671444_n.jpg?stp=dst-jpg_e35_p1080x1080_sh0.08_tt6&_nc_ht=scontent-dfw5-2.cdninstagram.com&_nc_cat=108&_nc_oc=Q6cZ2QGaMKgfOzjq0wPKSDzaCmtVKzedbmcC6K7R8nhooYRtxVg3ff27v7SxrDXsxdo2W7k&_nc_ohc=8c3OWbQMg_UQ7kNvwGA-4tO&_nc_gid=nqIS79fttxt1Dm7FA1KvtA&edm=ANTKIIoBAAAA&ccb=7-5&oh=00_AfzoD8Lfn2JLSIGWOpgggWRS0lM_Nq-kBOJbsWniZW1-Pg&oe=69BD36E2&_nc_sid=d885a2",
        "https://scontent-dfw5-2.cdninstagram.com/v/t51.2885-15/489022963_18494864506028192_5811983443590937317_n.jpg?stp=dst-jpg_e35_p1080x1080_sh0.08_tt6&_nc_ht=scontent-dfw5-2.cdninstagram.com&_nc_cat=108&_nc_oc=Q6cZ2QGaMKgfOzjq0wPKSDzaCmtVKzedbmcC6K7R8nhooYRtxVg3ff27v7SxrDXsxdo2W7k&_nc_ohc=dmtlFzwSrRAQ7kNvwF3cFW1&_nc_gid=nqIS79fttxt1Dm7FA1KvtA&edm=ANTKIIoBAAAA&ccb=7-5&oh=00_AfxkO5-J0PJ3blG-0l-j2FfZ8JbfvEFMNlkjuFfGyTcbDw&oe=69BD411D&_nc_sid=d885a2",
        "https://scontent-dfw5-2.cdninstagram.com/v/t51.2885-15/490092032_18494864515028192_1690521244685472282_n.jpg?stp=dst-jpg_e35_p1080x1080_sh0.08_tt6&_nc_ht=scontent-dfw5-2.cdninstagram.com&_nc_cat=108&_nc_oc=Q6cZ2QGaMKgfOzjq0wPKSDzaCmtVKzedbmcC6K7R8nhooYRtxVg3ff27v7SxrDXsxdo2W7k&_nc_ohc=qBpqqD5ZCl0Q7kNvwEDczAS&_nc_gid=nqIS79fttxt1Dm7FA1KvtA&edm=ANTKIIoBAAAA&ccb=7-5&oh=00_AfxTqMfbDWwQY0NuZGyko_XxDlqKSGGZhgNQiSpZOjQnTA&oe=69BD3BB2&_nc_sid=d885a2"
      ],
      "videos": null,
      "location": [
        "Capanema",
        "Pará",
        "Brasil"
      ],
      "latest_comments": null,
      "post_id": "3609139641052120087",
      "discovery_input": null,
      "has_handshake": null,
      "shortcode": "DIWPWGpsUQX",
      "content_type": "Carousel",
      "pk": "3609139641052120087",
      "content_id": "DIWPWGpsUQX",
      "engagement_score_view": null,
      "thumbnail": "https://scontent-dfw5-2.cdninstagram.com/v/t51.2885-15/489610375_18494864488028192_2686112351885091669_n.jpg?stp=c0.147.1284.1284a_dst-jpg_e35_s640x640_sh0.08_tt6&_nc_ht=scontent-dfw5-2.cdninstagram.com&_nc_cat=108&_nc_oc=Q6cZ2QGaMKgfOzjq0wPKSDzaCmtVKzedbmcC6K7R8nhooYRtxVg3ff27v7SxrDXsxdo2W7k&_nc_ohc=0MufbR7woQgQ7kNvwFygZL-&_nc_gid=nqIS79fttxt1Dm7FA1KvtA&edm=ANTKIIoBAAAA&ccb=7-5&oh=00_AfxVSxvfL2zQbtGYyRFK9C75gO2TcK0jY6bsl6Xo1WM0dA&oe=69BD2DFE&_nc_sid=d885a2",
      "video_view_count": null,
      "product_type": null,
      "coauthor_producers": null,
      "tagged_users": null,
      "video_play_count": null,
      "followers": 20674,
      "posts_count": 9676,
      "profile_image_link": "https://scontent-dfw5-2.cdninstagram.com/v/t51.82787-19/637167000_18562755475028192_7282452674783054648_n.jpg?stp=dst-jpg_s150x150_tt6&efg=eyJ2ZW5jb2RlX3RhZyI6InByb2ZpbGVfcGljLmRqYW5nby4xMDgwLmMyIn0&_nc_ht=scontent-dfw5-2.cdninstagram.com&_nc_cat=108&_nc_oc=Q6cZ2QGaMKgfOzjq0wPKSDzaCmtVKzedbmcC6K7R8nhooYRtxVg3ff27v7SxrDXsxdo2W7k&_nc_ohc=w2D-l-4t3yAQ7kNvwG5fhmo&_nc_gid=nqIS79fttxt1Dm7FA1KvtA&edm=ANTKIIoBAAAA&ccb=7-5&oh=00_AfwK9IApnYM8GUqE3WY6EC9TiyKRaRbL6JS9314NMLywrQ&oe=69BD3DFE&_nc_sid=d885a2",
      "is_verified": true,
      "is_paid_partnership": false,
      "partnership_details": {
        "profile_id": null,
        "profile_url": null,
        "username": null
      },
      "user_posted_id": "312860191",
      "post_content": [
        {
          "alt_text": "Photo by Lima Bijus on April 12, 2025.",
          "id": "3609139634257469948",
          "index": 0,
          "type": "Photo",
          "url": "https://scontent-dfw5-2.cdninstagram.com/v/t51.2885-15/489610375_18494864488028192_2686112351885091669_n.jpg?stp=dst-jpg_e35_p1080x1080_sh0.08_tt6&_nc_ht=scontent-dfw5-2.cdninstagram.com&_nc_cat=108&_nc_oc=Q6cZ2QGaMKgfOzjq0wPKSDzaCmtVKzedbmcC6K7R8nhooYRtxVg3ff27v7SxrDXsxdo2W7k&_nc_ohc=0MufbR7woQgQ7kNvwFygZL-&_nc_gid=nqIS79fttxt1Dm7FA1KvtA&edm=ANTKIIoBAAAA&ccb=7-5&oh=00_AfzNULCN5FUuEctA0H8JoRjWCeySVi7on4V_3tyVANwEgA&oe=69BD2DFE&_nc_sid=d885a2"
        },
        {
          "alt_text": "Photo by Lima Bijus on April 12, 2025.",
          "id": "3609139634265835747",
          "index": 1,
          "type": "Photo",
          "url": "https://scontent-dfw5-2.cdninstagram.com/v/t51.2885-15/490407159_18494864497028192_459288836599671444_n.jpg?stp=dst-jpg_e35_p1080x1080_sh0.08_tt6&_nc_ht=scontent-dfw5-2.cdninstagram.com&_nc_cat=108&_nc_oc=Q6cZ2QGaMKgfOzjq0wPKSDzaCmtVKzedbmcC6K7R8nhooYRtxVg3ff27v7SxrDXsxdo2W7k&_nc_ohc=8c3OWbQMg_UQ7kNvwGA-4tO&_nc_gid=nqIS79fttxt1Dm7FA1KvtA&edm=ANTKIIoBAAAA&ccb=7-5&oh=00_AfzoD8Lfn2JLSIGWOpgggWRS0lM_Nq-kBOJbsWniZW1-Pg&oe=69BD36E2&_nc_sid=d885a2"
        },
        {
          "alt_text": "Photo by Lima Bijus on April 12, 2025.",
          "id": "3609139634257389672",
          "index": 2,
          "type": "Photo",
          "url": "https://scontent-dfw5-2.cdninstagram.com/v/t51.2885-15/489022963_18494864506028192_5811983443590937317_n.jpg?stp=dst-jpg_e35_p1080x1080_sh0.08_tt6&_nc_ht=scontent-dfw5-2.cdninstagram.com&_nc_cat=108&_nc_oc=Q6cZ2QGaMKgfOzjq0wPKSDzaCmtVKzedbmcC6K7R8nhooYRtxVg3ff27v7SxrDXsxdo2W7k&_nc_ohc=dmtlFzwSrRAQ7kNvwF3cFW1&_nc_gid=nqIS79fttxt1Dm7FA1KvtA&edm=ANTKIIoBAAAA&ccb=7-5&oh=00_AfxkO5-J0PJ3blG-0l-j2FfZ8JbfvEFMNlkjuFfGyTcbDw&oe=69BD411D&_nc_sid=d885a2"
        },
        {
          "alt_text": "Photo by Lima Bijus on April 12, 2025.",
          "id": "3609139634257475832",
          "index": 3,
          "type": "Photo",
          "url": "https://scontent-dfw5-2.cdninstagram.com/v/t51.2885-15/490092032_18494864515028192_1690521244685472282_n.jpg?stp=dst-jpg_e35_p1080x1080_sh0.08_tt6&_nc_ht=scontent-dfw5-2.cdninstagram.com&_nc_cat=108&_nc_oc=Q6cZ2QGaMKgfOzjq0wPKSDzaCmtVKzedbmcC6K7R8nhooYRtxVg3ff27v7SxrDXsxdo2W7k&_nc_ohc=qBpqqD5ZCl0Q7kNvwEDczAS&_nc_gid=nqIS79fttxt1Dm7FA1KvtA&edm=ANTKIIoBAAAA&ccb=7-5&oh=00_AfxTqMfbDWwQY0NuZGyko_XxDlqKSGGZhgNQiSpZOjQnTA&oe=69BD3BB2&_nc_sid=d885a2"
        }
      ],
      "audio": {
        "audio_asset_id": null,
        "ig_artist_id": null,
        "ig_artist_username": null,
        "original_audio_title": null
      },
      "profile_url": "https://www.instagram.com/limabijus",
      "videos_duration": null,
      "images": [
        {
          "id": "360***963***746******",
          "url": "htt***//s***ten*********cdn*********************885************************************************************************************************************************************************************************************************************************************************************************************************************************************************************************************************************"
        },
        {
          "id": "360***963***583******",
          "url": "htt***//s***ten*********cdn*********************885************************************************************************************************************************************************************************************************************************************************************************************************************************************************************************************************************"
        },
        {
          "id": "360***963***738******",
          "url": "htt***//s***ten*********cdn*********************885************************************************************************************************************************************************************************************************************************************************************************************************************************************************************************************************************"
        },
        {
          "id": "360***963***747******",
          "url": "htt***//s***ten*********cdn*********************885************************************************************************************************************************************************************************************************************************************************************************************************************************************************************************************************************"
        }
      ],
      "alt_text": "Photo by Lima Bijus on April 12, 2025.",
      "photos_number": 4,
      "audio_url": null
    }
  ]
  ```
</ResponseExample>


# Discover Instagram posts by URL
Source: https://docs.brightdata.com/api-reference/scrapers/social-media-apis/instagram-posts-discover-by-url

POST https://api.brightdata.com/datasets/v3/scrape
Use the Bright Data Web Scraper API to discover Instagram posts by URL. Calls the POST /datasets/v3/scrape endpoint and returns a snapshot ID.

## Query Parameters

<ParamField type="string">
  The dataset ID used for this request.

  <Warning>
    Must be set to `gd_lk5ns7kz21pck8jpis` to collect **Discover by URL** data.
  </Warning>
</ParamField>

<ParamField type="string">
  Must be set to `discover_new`.
</ParamField>

<ParamField type="string">
  Must be set to `url`.
</ParamField>

<ParamField type="boolean">
  Whether to send notifications when the request is completed.
</ParamField>

<ParamField type="boolean">
  Whether to include errors in the response.
</ParamField>

## Request Body

<ParamField type="object[]">
  An array of input objects.

  <Expandable title="properties">
    <ParamField type="string">
      The URL of the Instagram profile.
    </ParamField>

    <ParamField type="number">
      The number of recent posts to collect, missing value indicates no limit.
    </ParamField>

    <ParamField type="string[]">
      Post IDs not to include
    </ParamField>

    <ParamField type="integer">
      Start date filter `MM-DD-YYYY` (should be earlier than "end\_date")
    </ParamField>

    <ParamField type="integer">
      End date filter `MM-DD-YYYY` (should be later than "start\_date")
    </ParamField>

    <ParamField type="string">
      Posts to collect by type.

      One of: `post`, `reel`
    </ParamField>
  </Expandable>

  #### Example

  ```json wrap theme={null}
  {
    "input": [
      {
        "url": "https://www.instagram.com/marcusfaberfdp",
        "num_of_posts": 10,
        "start_date": "01-01-2025",
        "end_date": "03-01-2025",
        "post_type": "Post"
      },
      {
        "url": "https://www.instagram.com/meta/",
        "num_of_posts": "",
        "posts_to_not_include": [
          "3529568342229145484"
        ],
        "start_date": "03-01-2025",
        "end_date": "03-17-2025",
        "post_type": "Reel"
      },
      {
        "url": "https://instagram.com/tips_-_-_",
        "start_date": "",
        "end_date": "",
        "post_type": ""
      },
      {
        "url": "https://www.instagram.com/_blakegreiner_/",
        "start_date": "",
        "end_date": "",
        "post_type": ""
      }
    ]
  }
  ```
</ParamField>

## Response

<ResponseExample>
  ```json 200 theme={null}
  [
    {
      "account": "jen***ell***72",
      "fbid": "17841405188025881",
      "id": "5087052934",
      "followers": 7938,
      "posts_count": 835,
      "is_business_account": false,
      "is_professional_account": false,
      "is_verified": false,
      "avg_engagement": 0.0582,
      "external_url": null,
      "biography": "Pod: @raydarcydaily \nemail: jenny@darcydaily.com",
      "business_category_name": null,
      "category_name": null,
      "post_hashtags": null,
      "following": 2520,
      "posts": [
        {
          "caption": "BEING HUMAN - A six part series where Ray chats to 6 well known Irish people about what it means to be human. \n\nFirst episode Wednesday 18th March, and every Wednesday after.\n\nA What Next Production\nPresented by Ray D’Arcy\nProduced by Jenny Kelly\n\n#beinghuman \n#podcast \n#irishpodcast",
          "comments": 2,
          "content_type": "Video",
          "datetime": "2026-03-12T11:52:08.000Z",
          "id": "3851176228498036124",
          "image_url": "https://scontent-dfw5-2.cdninstagram.com/v/t51.82787-15/651142041_18334056292172935_8112879477358850984_n.jpg?stp=dst-jpg_e15_tt6&_nc_ht=scontent-dfw5-2.cdninstagram.com&_nc_cat=107&_nc_oc=Q6cZ2QH-MUSe6C4PkyFc8saG_6IRC_V3hZ9c7StCViUw-zl5K7a2Qh7u0q29i7etbbV1SI4&_nc_ohc=W4Jy7OhEd8MQ7kNvwFBSQNv&_nc_gid=f8NLMHfSvJHjKW7CNjdR5w&edm=AOQ1c0wBAAAA&ccb=7-5&oh=00_Afwe_S8Bh8FtoL_RtvxoQ6RF2c20beQzWeLfJfizNBlciQ&oe=69BCEC94&_nc_sid=8b3546",
          "is_pinned": false,
          "likes": 36,
          "location": {
            "has_public_page": null,
            "id": null,
            "name": null,
            "slug": null
          },
          "post_hashtags": [
            "beinghuman",
            "podcast",
            "irishpodcast"
          ],
          "url": "https://www.instagram.com/p/DVyIGAbDdWc",
          "video_url": "https://scontent-dfw6-1.cdninstagram.com/o1/v/t16/f2/m69/AQMSgH9bCDeY_VmVFTYEzrv9RMglEw0prtVd_QFRgC21aFXJ10hPg07pPxQ6VZdxe1vFeVnYABQlz2zcpXVrQqfV.mp4?strext=1&_nc_cat=103&_nc_sid=5e9851&_nc_ht=scontent-dfw6-1.cdninstagram.com&_nc_ohc=F9Tybdk82ZQQ7kNvwGJ2sbT&efg=eyJ2ZW5jb2RlX3RhZyI6Inhwdl9wcm9ncmVzc2l2ZS5JTlNUQUdSQU0uQ0xJUFMuQzMuNDgwLmRhc2hfYmFzZWxpbmVfMV92MSIsInhwdl9hc3NldF9pZCI6MTgzMzQwNTU2MDgxNzI5MzUsImFzc2V0X2FnZV9kYXlzIjozLCJ2aV91c2VjYXNlX2lkIjoxMDA5OSwiZHVyYXRpb25fcyI6MTE3LCJ1cmxnZW5fc291cmNlIjoid3d3In0%3D&ccb=17-1&_nc_gid=f8NLMHfSvJHjKW7CNjdR5w&_nc_ss=8&_nc_zt=28&vs=672fccf82fe0dcbe&_nc_vs=HBksFQIYOnBhc3N0aHJvdWdoX2V2ZXJzdG9yZS9HUGlMdHlhY29GUzFoRFFEQU9udTlRZ1ByVDFKYnNwVEFRQUYVAALIARIAFQIYUWlnX3hwdl9wbGFjZW1lbnRfcGVybWFuZW50X3YyL0E5NEZGMjZCMjU0OTFERkZBNzYzQjU2NDhBOUM5QThGX2F1ZGlvX2Rhc2hpbml0Lm1wNBUCAsgBEgAoABgAGwKIB3VzZV9vaWwBMRJwcm9ncmVzc2l2ZV9yZWNpcGUBMRUAACaOhor9vq6RQRUCKAJDMywXQF1AAAAAAAAYEmRhc2hfYmFzZWxpbmVfMV92MREAdf4HZeadAQA&oh=00_AfyDY32lp2KMgYLDKEK7Wx7ocPFPwwhGkiuWvBKwB_joLg&oe=69BCCEE9"
        },
        {
          "caption": "Our brand new daily podcast is starting tomorrow \n\nRay D’Arcy Daily \n\nWherever you get your podcasts.\n\nEmail us ray@darcydaily.com\n#podcast #irishpodcast",
          "comments": 86,
          "content_type": "Video",
          "datetime": "2026-03-08T16:21:04.000Z",
          "id": "3848412628930911784",
          "image_url": "https://scontent-dfw5-1.cdninstagram.com/v/t51.71878-15/649327000_1860456074651243_3014167701283875235_n.jpg?stp=dst-jpg_e15_tt6&_nc_ht=scontent-dfw5-1.cdninstagram.com&_nc_cat=111&_nc_oc=Q6cZ2QH-MUSe6C4PkyFc8saG_6IRC_V3hZ9c7StCViUw-zl5K7a2Qh7u0q29i7etbbV1SI4&_nc_ohc=b0EoQkmauKkQ7kNvwGZzfjq&_nc_gid=f8NLMHfSvJHjKW7CNjdR5w&edm=AOQ1c0wBAAAA&ccb=7-5&oh=00_AfxQfU7Ocg9M26vOgYlA3m4oy4cpmvDY9859u4P35lUqng&oe=69BCEFC3&_nc_sid=8b3546",
          "is_pinned": false,
          "likes": 992,
          "location": {
            "has_public_page": null,
            "id": null,
            "name": null,
            "slug": null
          },
          "post_hashtags": [
            "podcast",
            "irishpodcast"
          ],
          "url": "https://www.instagram.com/p/DVoTuVwjd4o",
          "video_url": "https://scontent-dfw5-2.cdninstagram.com/o1/v/t16/f2/m69/AQNqwbuRAKLUvBo_BRm3bnGbIV2EPYfXffZLw2f3swiqVgfVNN31xLUjJYzBUmk31ks69X_8_c7EKmCelHv_buYH.mp4?strext=1&_nc_cat=104&_nc_sid=5e9851&_nc_ht=scontent-dfw5-2.cdninstagram.com&_nc_ohc=iuf2XH_4eaAQ7kNvwGQqv3J&efg=eyJ2ZW5jb2RlX3RhZyI6Inhwdl9wcm9ncmVzc2l2ZS5JTlNUQUdSQU0uQ0xJUFMuQzMuNzIwLmRhc2hfYmFzZWxpbmVfMV92MSIsInhwdl9hc3NldF9pZCI6MTgzMzM2MzkxNzIxNzI5MzUsImFzc2V0X2FnZV9kYXlzIjo3LCJ2aV91c2VjYXNlX2lkIjoxMDA5OSwiZHVyYXRpb25fcyI6NjAsInVybGdlbl9zb3VyY2UiOiJ3d3cifQ%3D%3D&ccb=17-1&_nc_gid=f8NLMHfSvJHjKW7CNjdR5w&_nc_ss=8&_nc_zt=28&vs=ce88cc19b1c12270&_nc_vs=HBksFQIYOnBhc3N0aHJvdWdoX2V2ZXJzdG9yZS9HSVhrcWlhdEZTUTBGLTBFQUNGU2oydVRFWlZ4YnNwVEFRQUYVAALIARIAFQIYUWlnX3hwdl9wbGFjZW1lbnRfcGVybWFuZW50X3YyLzIwNEVCQTgxMTJEMkM2ODRBNzFEREU0RTQwNTBFQThDX2F1ZGlvX2Rhc2hpbml0Lm1wNBUCAsgBEgAoABgAGwKIB3VzZV9vaWwBMRJwcm9ncmVzc2l2ZV9yZWNpcGUBMRUAACaOsuGkoJaRQRUCKAJDMywXQE464UeuFHsYEmRhc2hfYmFzZWxpbmVfMV92MREAdf4HZeadAQA&oh=00_AfzE-98jZ3zhfaRZuLxlWwz5GmrjBpxgERbFaOjPj7UIrw&oe=69BCCCA4"
        },
        {
          "caption": "We have some news! \n\nRAY D’ARCY DAILY - your daily podcast. \n\nThis five day a week show is nothing new, and yet ALL NEW. It’s Monday to Friday with Ray giving his own world view while surrounded by friends of the show, Jenny Kelly (that’s me 🤪), Mairead Ronan and Bernard O’Shea to name a few. \n\nWe hope you’ll join us. \nStarting Monday 9th. \n\nFollow the show now to make sure you never miss an episode. \n\nListen wherever you get your Podcasts #irishpodcast #podcast \n@cocomairead @bernardo.oshea @acast",
          "comments": 166,
          "content_type": "Video",
          "datetime": "2026-03-02T13:25:41.000Z",
          "id": "3843977898726623596",
          "image_url": "https://scontent-dfw5-1.cdninstagram.com/v/t51.71878-15/641425914_1446430403853586_8943556578413069821_n.jpg?stp=dst-jpg_e15_tt6&_nc_ht=scontent-dfw5-1.cdninstagram.com&_nc_cat=110&_nc_oc=Q6cZ2QH-MUSe6C4PkyFc8saG_6IRC_V3hZ9c7StCViUw-zl5K7a2Qh7u0q29i7etbbV1SI4&_nc_ohc=j-4QNAsV4yEQ7kNvwEWKOeO&_nc_gid=f8NLMHfSvJHjKW7CNjdR5w&edm=AOQ1c0wBAAAA&ccb=7-5&oh=00_Afy2MQCg7ccEpt8gZNJowsCxi2k7fkX141C5dFU-dvfEfg&oe=69BCC84E&_nc_sid=8b3546",
          "is_pinned": false,
          "likes": 1158,
          "location": {
            "has_public_page": null,
            "id": null,
            "name": null,
            "slug": null
          },
          "post_hashtags": [
            "irishpodcast",
            "podcast"
          ],
          "url": "https://www.instagram.com/p/DVYjYhaDYls",
          "video_url": "https://scontent-dfw6-1.cdninstagram.com/o1/v/t16/f2/m69/AQM_D-LpDwCPxPZrnXzoyfkknE8jP_GwRpGwtEvjefP4KUFo7dAEFZ51YD7Nn6-NLnnVLm3sIF5e7jbT_ImFtRri.mp4?strext=1&_nc_cat=103&_nc_sid=5e9851&_nc_ht=scontent-dfw6-1.cdninstagram.com&_nc_ohc=-FdPzVISP18Q7kNvwEcVVkv&efg=eyJ2ZW5jb2RlX3RhZyI6Inhwdl9wcm9ncmVzc2l2ZS5JTlNUQUdSQU0uQ0xJUFMuQzMuNzIwLmRhc2hfYmFzZWxpbmVfMV92MSIsInhwdl9hc3NldF9pZCI6MTgzMzMwNTA3OTExNzI5MzUsImFzc2V0X2FnZV9kYXlzIjoxMywidmlfdXNlY2FzZV9pZCI6MTAwOTksImR1cmF0aW9uX3MiOjE0MSwidXJsZ2VuX3NvdXJjZSI6Ind3dyJ9&ccb=17-1&_nc_gid=f8NLMHfSvJHjKW7CNjdR5w&_nc_ss=8&_nc_zt=28&vs=54251b7443d07334&_nc_vs=HBksFQIYOnBhc3N0aHJvdWdoX2V2ZXJzdG9yZS9HSnlFZHlhaTdRb2U1SmtFQURXYkJFSjd5XzEwYnNwVEFRQUYVAALIARIAFQIYUWlnX3hwdl9wbGFjZW1lbnRfcGVybWFuZW50X3YyLzEyNEU2RjhEQkU4M0NCQ0Y3NEU5Njk2Q0I0NTJDRkIxX2F1ZGlvX2Rhc2hpbml0Lm1wNBUCAsgBEgAoABgAGwKIB3VzZV9vaWwBMRJwcm9ncmVzc2l2ZV9yZWNpcGUBMRUAACaO7fTAgPSQQRUCKAJDMywXQGGqp--dsi0YEmRhc2hfYmFzZWxpbmVfMV92MREAdf4HZeadAQA&oh=00_AfxknzHbQifAj5YoGVzxwXn2cPKeVRcRrdXbooIhlD8ZBQ&oe=69BCDC41"
        },
        {
          "caption": "PODCAST NEWS 📢\n\nAfter 3 years we have made the decision to hang up our ‘Jenny and Mairéad NOW' mics. \n\nWe have LOVED doing it. 💕\n\nWe re-connected with so many listeners from our radio days and got lots of new listeners along the way. We want to thank you for all the laughs and life stories you’ve shared with us. \n\nWe both have new commitments that we are diving into, so for today, we'll say ‘so long for now’ 💫 \n\nLots of love, \nJenny and Mairéad \nXx \n\nPS..leave your lips alone, buy a spray mop and remember… \"you’ll be dead forever”",
          "comments": 158,
          "content_type": "Image",
          "datetime": "2025-09-24T17:50:53.000Z",
          "id": "3728872417469969396",
          "image_url": "https://scontent-dfw5-2.cdninstagram.com/v/t51.82787-15/553161422_17973649637947844_5055340064665934469_n.webp?stp=dst-jpg_e35_s1080x1080_sh0.08_tt6&_nc_ht=scontent-dfw5-2.cdninstagram.com&_nc_cat=108&_nc_oc=Q6cZ2QH-MUSe6C4PkyFc8saG_6IRC_V3hZ9c7StCViUw-zl5K7a2Qh7u0q29i7etbbV1SI4&_nc_ohc=0IDMJZLADZgQ7kNvwGBZl2R&_nc_gid=f8NLMHfSvJHjKW7CNjdR5w&edm=AOQ1c0wBAAAA&ccb=7-5&oh=00_AfxVGERnGo1gjS9N7F4Hvi14Ek0zIbXq_m_2vnk8p1c0mQ&oe=69BCDBC8&_nc_sid=8b3546",
          "is_pinned": false,
          "likes": 1572,
          "location": {
            "has_public_page": null,
            "id": null,
            "name": null,
            "slug": null
          },
          "post_hashtags": null,
          "url": "https://www.instagram.com/p/DO_nbUQDLP0",
          "video_url": null
        },
        {
          "caption": "I COULD have been a camogie player (never played in my life 🤣), and @cocomairead COULD have been a pop star … what COULD you have been? \n\nPodcast out tomorrow 6am #irishpodcast #podcast #jennyandmaireadnow",
          "comments": null,
          "content_type": "Video",
          "datetime": "2025-04-29T21:44:06.000Z",
          "id": "3621719997521697568",
          "image_url": "https://scontent-dfw6-1.cdninstagram.com/v/t51.71878-15/491461907_976222424658362_5118993394906495251_n.jpg?stp=dst-jpg_e15_tt6&_nc_ht=scontent-dfw6-1.cdninstagram.com&_nc_cat=102&_nc_oc=Q6cZ2QH-MUSe6C4PkyFc8saG_6IRC_V3hZ9c7StCViUw-zl5K7a2Qh7u0q29i7etbbV1SI4&_nc_ohc=fdEBmapVjIYQ7kNvwH9d2ns&_nc_gid=f8NLMHfSvJHjKW7CNjdR5w&edm=AOQ1c0wBAAAA&ccb=7-5&oh=00_Afz4h2HLZTuYioO61W7aDIMzXCHL34Tv_SD_q5TYfJ99iA&oe=69BCBEDC&_nc_sid=8b3546",
          "is_pinned": false,
          "likes": 62,
          "location": {
            "has_public_page": null,
            "id": null,
            "name": null,
            "slug": null
          },
          "post_hashtags": [
            "irishpodcast",
            "podcast",
            "jennyandmaireadnow"
          ],
          "url": "https://www.instagram.com/p/DJC7yYoNZsg",
          "video_url": "https://scontent-dfw5-2.cdninstagram.com/o1/v/t2/f2/m367/AQNdTe3n8U7HJAUZPYQ2IKytrTScEjIa2LVv7p-gcs7bfH2WDHkU1GuQ63tg4BxPEIFCVKgn-k9soAiz09MH_R_ORdQFWDf5N2MPRLY.mp4?_nc_cat=104&_nc_sid=5e9851&_nc_ht=scontent-dfw5-2.cdninstagram.com&_nc_ohc=Syer777RuQMQ7kNvwEmKdhm&efg=eyJ2ZW5jb2RlX3RhZyI6Inhwdl9wcm9ncmVzc2l2ZS5JTlNUQUdSQU0uQ0xJUFMuQzMuNDgwLmRhc2hfYmFzZWxpbmVfMV92MSIsInhwdl9hc3NldF9pZCI6MTU5NDc3ODcyNzg2ODYyNywiYXNzZXRfYWdlX2RheXMiOjMxOSwidmlfdXNlY2FzZV9pZCI6MTAwOTksImR1cmF0aW9uX3MiOjY5LCJ1cmxnZW5fc291cmNlIjoid3d3In0%3D&ccb=17-1&_nc_gid=f8NLMHfSvJHjKW7CNjdR5w&_nc_ss=8&_nc_zt=28&vs=1d3eb966c62b0ed0&_nc_vs=HBksFQIYQGlnX2VwaGVtZXJhbC8zMTRBRkNEOTM4NTM5NjI2MzhBMUQwQ0QxNDk2QzE4QV92aWRlb19kYXNoaW5pdC5tcDQVAALIARIAFQIYRmlnX3hwdl9yZWVsc19wZXJtYW5lbnRfc3JfcHJvZC8xMjE3ODU0OTYzMjg1ODY0Xzk0ODMzNjE1ODI3NjU5Njg3OC5tcDQVAgLIARIAKAAYABsCiAd1c2Vfb2lsATEScHJvZ3Jlc3NpdmVfcmVjaXBlATEVAAAmpqOPuauc1QUVAigCQzMsF0BRUQYk3S8bGBJkYXNoX2Jhc2VsaW5lXzFfdjERAHX-B2XmnQEA&oh=00_AfxYnVqq-YPFAKEW8CVj-CJBIvyL0qQSOxuzTNCksnr_Sg&oe=69BCE24D"
        },
        {
          "caption": "Podcast @jennyandmaireadnow out tomorrow 6am \n\n✨Mairead needs help\n✨Netflix Doc: Buy Now!\n✨2025 Manifesto\n✨Colour and word of the year \n✨Debutant Balls and Feis\n\nThanks to our sponsor @vhi_ie \n#irishpodcast #podcast #friendship",
          "comments": null,
          "content_type": "Video",
          "datetime": "2024-12-10T21:36:11.000Z",
          "id": "3520245279648780747",
          "image_url": "https://scontent-dfw5-2.cdninstagram.com/v/t51.2885-15/469729187_18286176577172935_8198072792922023263_n.jpg?stp=dst-jpg_e15_tt6&_nc_ht=scontent-dfw5-2.cdninstagram.com&_nc_cat=107&_nc_oc=Q6cZ2QH-MUSe6C4PkyFc8saG_6IRC_V3hZ9c7StCViUw-zl5K7a2Qh7u0q29i7etbbV1SI4&_nc_ohc=skhiJmD75-kQ7kNvwEeKZA6&_nc_gid=f8NLMHfSvJHjKW7CNjdR5w&edm=AOQ1c0wBAAAA&ccb=7-5&oh=00_AfzWsdPI0aqqm2_IHDtzlIqHu2mL76RyRwvUBMetthP-hg&oe=69BCCDF6&_nc_sid=8b3546",
          "is_pinned": false,
          "likes": 64,
          "location": {
            "has_public_page": null,
            "id": null,
            "name": null,
            "slug": null
          },
          "post_hashtags": [
            "irishpodcast",
            "podcast",
            "friendship"
          ],
          "url": "https://www.instagram.com/p/DDabG5HthHL",
          "video_url": "https://scontent-dfw5-1.cdninstagram.com/o1/v/t2/f2/m367/AQMy1Odi0RhpjgXggsSeeNNxmcDcNt0_X6IYxlCD21k4z4h46ndGKxoNjJIRjVg94CuujC1j-CiG89HT8-O9C-XPAl_3C_7p3GqzZ5M.mp4?_nc_cat=109&_nc_sid=5e9851&_nc_ht=scontent-dfw5-1.cdninstagram.com&_nc_ohc=zEKeRBdP2mAQ7kNvwENzKpk&efg=eyJ2ZW5jb2RlX3RhZyI6Inhwdl9wcm9ncmVzc2l2ZS5JTlNUQUdSQU0uQ0xJUFMuQzMuNzIwLmRhc2hfYmFzZWxpbmVfMV92MSIsInhwdl9hc3NldF9pZCI6MTIzMzY5MjkwNzcxNjE1MSwiYXNzZXRfYWdlX2RheXMiOjQ1OSwidmlfdXNlY2FzZV9pZCI6MTAwOTksImR1cmF0aW9uX3MiOjUxLCJ1cmxnZW5fc291cmNlIjoid3d3In0%3D&ccb=17-1&_nc_gid=f8NLMHfSvJHjKW7CNjdR5w&_nc_ss=8&_nc_zt=28&vs=be7ed278cb04ea95&_nc_vs=HBksFQIYQGlnX2VwaGVtZXJhbC9BQjQyNThCNTU0QTJGNEIxODg3NjlBQUJFMDNDMzU4Q192aWRlb19kYXNoaW5pdC5tcDQVAALIARIAFQIYRmlnX3hwdl9yZWVsc19wZXJtYW5lbnRfc3JfcHJvZC8xNTAyMTIxNTUwNzQwNjE0Xzc5ODkxODI2NzE3NDU1MDEwNy5tcDQVAgLIARIAKAAYABsCiAd1c2Vfb2lsATEScHJvZ3Jlc3NpdmVfcmVjaXBlATEVAAAm7vi1uLCCsQQVAigCQzMsF0BJmZmZmZmaGBJkYXNoX2Jhc2VsaW5lXzFfdjERAHX-B2XmnQEA&oh=00_Afzvy10txzkdt9h08tJs_9VMlJicQjSggsPEZ61LEdGYmA&oe=69BCC63E"
        },
        {
          "caption": "This book took me a few weeks to read and it’s only 136 pages long. I could quite easily go back now and start it all over again. One of the most beautiful books I’ve read. It tells the story of 24 hours in the lives of 6 astronauts on the international space station. Each of the 16 chapters takes in one orbit of earth. It’s difficult to describe just how profound and touching this small book is. A love letter to Earth. It made me feel both sad and hopeful at the same time. I read that the author Samantha Harvey stopped writing half way through because she felt she didn’t have the right to write a book like this, so removed was it from her real life. I’m so glad she ignored that voice in her head because this book is something we will read for years and years to come. Stunning.",
          "comments": 6,
          "content_type": "Image",
          "datetime": "2024-12-04T19:34:23.000Z",
          "id": "3515840447256809542",
          "image_url": "https://scontent-dfw6-1.cdninstagram.com/v/t51.82787-15/623407206_17991231980916798_8528601805505725054_n.jpg?stp=dst-jpg_e35_p1080x1080_sh0.08_tt6&_nc_ht=scontent-dfw6-1.cdninstagram.com&_nc_cat=106&_nc_oc=Q6cZ2QH-MUSe6C4PkyFc8saG_6IRC_V3hZ9c7StCViUw-zl5K7a2Qh7u0q29i7etbbV1SI4&_nc_ohc=1jkbYPze7PIQ7kNvwFhqTAc&_nc_gid=f8NLMHfSvJHjKW7CNjdR5w&edm=AOQ1c0wBAAAA&ccb=7-5&oh=00_Afzg1e_fEK30evjHAzSP597UW_USGzLTBIj1k-EIjQQMfA&oe=69BCCA41&_nc_sid=8b3546",
          "is_pinned": false,
          "likes": 109,
          "location": {
            "has_public_page": null,
            "id": null,
            "name": null,
            "slug": null
          },
          "post_hashtags": null,
          "url": "https://www.instagram.com/p/DDKxkJRsVBG",
          "video_url": null
        },
        {
          "caption": "Pod out Wednesday 6am\n\n✨Kissing 💋\n✨Christmas Movies 🎬\n✨family traditions 🏡\n✨Nits 🦗\n\nThanks to our sponsor @vhi_ie",
          "comments": 1,
          "content_type": "Video",
          "datetime": "2024-12-03T21:00:59.000Z",
          "id": "3515158122554635287",
          "image_url": "https://scontent-dfw5-2.cdninstagram.com/v/t51.71878-15/503975082_1908008223345944_5512368651421990898_n.jpg?stp=dst-jpg_e15_tt6&_nc_ht=scontent-dfw5-2.cdninstagram.com&_nc_cat=108&_nc_oc=Q6cZ2QH-MUSe6C4PkyFc8saG_6IRC_V3hZ9c7StCViUw-zl5K7a2Qh7u0q29i7etbbV1SI4&_nc_ohc=LBreF5ALN2IQ7kNvwE_RtAb&_nc_gid=f8NLMHfSvJHjKW7CNjdR5w&edm=AOQ1c0wBAAAA&ccb=7-5&oh=00_AfzmTzT-OfgwVOhOYS62CUgEdWcUX2YsW20KyaTEXiv3Gg&oe=69BCD350&_nc_sid=8b3546",
          "is_pinned": false,
          "likes": 27,
          "location": {
            "has_public_page": null,
            "id": null,
            "name": null,
            "slug": null
          },
          "post_hashtags": null,
          "url": "https://www.instagram.com/p/DDIWbA4MrQX",
          "video_url": "https://scontent-dfw5-2.cdninstagram.com/o1/v/t2/f2/m367/AQNO52R4NspLq6_HyhxNcCLUQtKiP7dXhYXNEIO3IjvmzKdyZMS_YYgB2zRkbZs4SLFVBOdJpB3L19p9-zxxOyqHp9Lk-fOum-vlUa4.mp4?_nc_cat=107&_nc_sid=5e9851&_nc_ht=scontent-dfw5-2.cdninstagram.com&_nc_ohc=eyaMjy3BLs8Q7kNvwFAQ_2h&efg=eyJ2ZW5jb2RlX3RhZyI6Inhwdl9wcm9ncmVzc2l2ZS5JTlNUQUdSQU0uQ0xJUFMuQzMuNzIwLmRhc2hfYmFzZWxpbmVfMV92MSIsInhwdl9hc3NldF9pZCI6MTc3MTU2NjI2MDMyMzQ3NSwiYXNzZXRfYWdlX2RheXMiOjQ2NiwidmlfdXNlY2FzZV9pZCI6MTAwOTksImR1cmF0aW9uX3MiOjQ5LCJ1cmxnZW5fc291cmNlIjoid3d3In0%3D&ccb=17-1&_nc_gid=f8NLMHfSvJHjKW7CNjdR5w&_nc_ss=8&_nc_zt=28&vs=4e62294db6b90ea0&_nc_vs=HBksFQIYQGlnX2VwaGVtZXJhbC82NTRENUM0OTczREYzNDQ0MzFDQTExRDQxRTY0RUI5Rl92aWRlb19kYXNoaW5pdC5tcDQVAALIARIAFQIYRmlnX3hwdl9yZWVsc19wZXJtYW5lbnRfc3JfcHJvZC8xMTYwODk0Nzg1Mzk1ODg1XzgyNDkxMDM2OTY3NjU4NTg4MS5tcDQVAgLIARIAKAAYABsCiAd1c2Vfb2lsATEScHJvZ3Jlc3NpdmVfcmVjaXBlATEVAAAmppKkmt3OpQYVAigCQzMsF0BI7tkWhysCGBJkYXNoX2Jhc2VsaW5lXzFfdjERAHX-B2XmnQEA&oh=00_AfxxoxyLQuVwyz2uioRVM08hneqBb3CfGndyLkviQkDqVw&oe=69BCE6C8"
        },
        {
          "caption": "Podcast out NOW ✨\n\nWe really enjoyed our chat with @michealmartintd \n\n✨telepathy between him and his wife\n✨the ingredients to his perfect salad\n✨book club inspiration \n✨what he REALLY wanted to be when he grew up \n\n#jennyandmaireadnow #whatweknownow #irishpodcasts #friendship #collabrativestudio",
          "comments": 29,
          "content_type": "Video",
          "datetime": "2024-11-13T11:36:18.000Z",
          "id": "3500373609463083880",
          "image_url": "https://scontent-dfw5-2.cdninstagram.com/v/t51.2885-15/466773911_17936241830947844_3117143642697548716_n.jpg?stp=dst-jpg_e15_tt6&_nc_ht=scontent-dfw5-2.cdninstagram.com&_nc_cat=108&_nc_oc=Q6cZ2QH-MUSe6C4PkyFc8saG_6IRC_V3hZ9c7StCViUw-zl5K7a2Qh7u0q29i7etbbV1SI4&_nc_ohc=1pwaOyShnGoQ7kNvwGsRorU&_nc_gid=f8NLMHfSvJHjKW7CNjdR5w&edm=AOQ1c0wBAAAA&ccb=7-5&oh=00_AfxMIFfgprmdzKi-AErgzTmN3E-gzqKmuT2QhUQC1TC7NQ&oe=69BCD28B&_nc_sid=8b3546",
          "is_pinned": false,
          "likes": 197,
          "location": {
            "has_public_page": null,
            "id": null,
            "name": null,
            "slug": null
          },
          "post_hashtags": [
            "jennyandmaireadnow",
            "whatweknownow",
            "irishpodcasts",
            "friendship",
            "collabrativestudio"
          ],
          "url": "https://www.instagram.com/p/DCT00CFMvNo",
          "video_url": "https://scontent-dfw5-1.cdninstagram.com/o1/v/t2/f2/m367/AQNLvylMFRY6P74zmh9wwvuEJ7rtO-sItj8FJLT2nSb_PeMIpJmOm8SkfRH64lOCNztgBnZpZ-XoKhrc8CItJtQKS1Mut4lfPZFXbj8.mp4?_nc_cat=110&_nc_sid=5e9851&_nc_ht=scontent-dfw5-1.cdninstagram.com&_nc_ohc=qIweWDr6GKEQ7kNvwHO-YZz&efg=eyJ2ZW5jb2RlX3RhZyI6Inhwdl9wcm9ncmVzc2l2ZS5JTlNUQUdSQU0uQ0xJUFMuQzMuNzIwLmRhc2hfYmFzZWxpbmVfMV92MSIsInhwdl9hc3NldF9pZCI6MzkwMzA5NDY3MzI4MjA3MiwiYXNzZXRfYWdlX2RheXMiOjQ4NywidmlfdXNlY2FzZV9pZCI6MTAwOTksImR1cmF0aW9uX3MiOjQzLCJ1cmxnZW5fc291cmNlIjoid3d3In0%3D&ccb=17-1&_nc_gid=f8NLMHfSvJHjKW7CNjdR5w&_nc_ss=8&_nc_zt=28&vs=15624de47fd39130&_nc_vs=HBksFQIYQGlnX2VwaGVtZXJhbC8yOTQ3MDYwMDcyNEI5QTQ4Njk2RDIzNUNCQjZGNzI5MV92aWRlb19kYXNoaW5pdC5tcDQVAALIARIAFQIYR2lnX3hwdl9yZWVsc19wZXJtYW5lbnRfc3JfcHJvZC8xMzIyMTQ3MTEyNDk4NDU0Xzg1NDM2NTk1NDU5NDg0NjEyNjYubXA0FQICyAESACgAGAAbAogHdXNlX29pbAExEnByb2dyZXNzaXZlX3JlY2lwZQExFQAAJrDQtLiB9u4NFQIoAkMzLBdARfMzMzMzMxgSZGFzaF9iYXNlbGluZV8xX3YxEQB1_gdl5p0BAA&oh=00_Afx5DWMCHEDJoObUP3-Lb7Hu9-RkPZteuaVDucxzxkaVtg&oe=69BCD8B3"
        },
        {
          "caption": "🎙️Bit of a different podcast for you this week! \n\nWe sat down with Tánaiste @michealmartintd and asked him ‘What He Knows Now.\n\n✨Life lessons that have got him this far. \n✨Friendships, family & grief\n✨Sea swimming, dry robes & switching off\n\n Full episode drops tomorrow at 6am wherever you get your podcasts. \n\nJ & M\n\nThank you to our sponsor @vhi_ie \n\n#jennyandmaireadnow #lifelessons #dryrobe  #seaswimming",
          "comments": 25,
          "content_type": "Video",
          "datetime": "2024-11-12T22:26:31.000Z",
          "id": "3499981808361075522",
          "image_url": "https://scontent-dfw5-2.cdninstagram.com/v/t51.71878-15/466690817_552614564296939_1070270335390837149_n.jpg?stp=dst-jpg_e15_tt6&_nc_ht=scontent-dfw5-2.cdninstagram.com&_nc_cat=107&_nc_oc=Q6cZ2QH-MUSe6C4PkyFc8saG_6IRC_V3hZ9c7StCViUw-zl5K7a2Qh7u0q29i7etbbV1SI4&_nc_ohc=4Pn0CaGAEAwQ7kNvwGgi0OG&_nc_gid=f8NLMHfSvJHjKW7CNjdR5w&edm=AOQ1c0wBAAAA&ccb=7-5&oh=00_Afy31s1gWLZgx-uRpeh_veSBHwycbYIjHaSe6e6ghEjJug&oe=69BCCA2F&_nc_sid=8b3546",
          "is_pinned": false,
          "likes": 367,
          "location": {
            "has_public_page": null,
            "id": null,
            "name": null,
            "slug": null
          },
          "post_hashtags": [
            "jennyandmaireadnow",
            "lifelessons",
            "dryrobe",
            "seaswimming"
          ],
          "url": "https://www.instagram.com/p/DCSbuk3sPNC",
          "video_url": "https://scontent-dfw6-1.cdninstagram.com/o1/v/t2/f2/m367/AQOQyKg3hXP5Vbemc9YXLsURych3495OTaZ-k5hA5Ud_bPJkecOs-XoiZXj14XHIu3zOfYzZrFmrf4xdztvyIdI8ID29tB2UCIKdGKQ.mp4?_nc_cat=106&_nc_sid=5e9851&_nc_ht=scontent-dfw6-1.cdninstagram.com&_nc_ohc=xQB7AZzudfwQ7kNvwFSfvDS&efg=eyJ2ZW5jb2RlX3RhZyI6Inhwdl9wcm9ncmVzc2l2ZS5JTlNUQUdSQU0uQ0xJUFMuQzMuNDgwLmRhc2hfYmFzZWxpbmVfMV92MSIsInhwdl9hc3NldF9pZCI6MTEwMzM1MzI5Nzg3MDA1NCwiYXNzZXRfYWdlX2RheXMiOjQ4NywidmlfdXNlY2FzZV9pZCI6MTAwOTksImR1cmF0aW9uX3MiOjM2LCJ1cmxnZW5fc291cmNlIjoid3d3In0%3D&ccb=17-1&vs=52ef0882b0559893&_nc_vs=HBksFQIYQGlnX2VwaGVtZXJhbC9BMzQxREExQUVBNTJCQUUzNDNCMUEyNzNCQ0FFMzNCQl92aWRlb19kYXNoaW5pdC5tcDQVAALIARIAFQIYRmlnX3hwdl9yZWVsc19wZXJtYW5lbnRfc3JfcHJvZC80NTE4MzkyMTEzNTQwNTNfMjIyNDI2NDEzOTg0ODkxMDcwOC5tcDQVAgLIARIAKAAYABsCiAd1c2Vfb2lsATEScHJvZ3Jlc3NpdmVfcmVjaXBlATEVAAAmzPOM1s7f9QMVAigCQzMsF0BB92yLQ5WBGBJkYXNoX2Jhc2VsaW5lXzFfdjERAHX-B2XmnQEA&_nc_gid=f8NLMHfSvJHjKW7CNjdR5w&_nc_ss=8&_nc_zt=28&oh=00_Afxh28JyyPy9AVGT2wQv9pVAJuU58mjJPkCKFeb6f4Oh8w&oe=69BCE4E7"
        },
        {
          "caption": "Did a photoshoot with Stan because he’s just back from the hairdressers and looking so floofy and smelling beautiful 😍 I needed to document his clean smelling look as he will be rolling in some dirt/fox smell/ muck very soon 🤪 #dogsofinstagram #goldenretriever",
          "comments": 12,
          "content_type": "Carousel",
          "datetime": "2024-11-12T15:25:04.000Z",
          "id": "3499769896973330029",
          "image_url": "https://scontent-dfw5-2.cdninstagram.com/v/t51.29350-15/466995326_990526599761200_5153153982064132557_n.jpg?stp=dst-jpg_e35_p1080x1080_tt6&_nc_ht=scontent-dfw5-2.cdninstagram.com&_nc_cat=104&_nc_oc=Q6cZ2QH-MUSe6C4PkyFc8saG_6IRC_V3hZ9c7StCViUw-zl5K7a2Qh7u0q29i7etbbV1SI4&_nc_ohc=UxLUkZuUog8Q7kNvwEC_RWC&_nc_gid=f8NLMHfSvJHjKW7CNjdR5w&edm=AOQ1c0wBAAAA&ccb=7-5&oh=00_AfyUh-GMDlDzUu9nBtb6d8zt0aKqVnKXwgO24rSu4kLSnw&oe=69BCECBC&_nc_sid=8b3546",
          "is_pinned": false,
          "likes": 432,
          "location": {
            "has_public_page": null,
            "id": null,
            "name": null,
            "slug": null
          },
          "post_hashtags": [
            "dogsofinstagram",
            "goldenretriever"
          ],
          "url": "https://www.instagram.com/p/DCRri3As2Zt",
          "video_url": null
        },
        {
          "caption": "Behind the scenes brain melt during podcast recording @jennyandmaireadnow 😆 #irishpodcast #brainmelt",
          "comments": 5,
          "content_type": "Video",
          "datetime": "2024-11-06T13:01:12.000Z",
          "id": "3495348313982605954",
          "image_url": "https://scontent-dfw5-1.cdninstagram.com/v/t51.71878-15/504211000_1111075530847029_6819244619431359412_n.jpg?stp=dst-jpg_e15_tt6&_nc_ht=scontent-dfw5-1.cdninstagram.com&_nc_cat=109&_nc_oc=Q6cZ2QH-MUSe6C4PkyFc8saG_6IRC_V3hZ9c7StCViUw-zl5K7a2Qh7u0q29i7etbbV1SI4&_nc_ohc=heyO9GE4JlsQ7kNvwFGOhvN&_nc_gid=f8NLMHfSvJHjKW7CNjdR5w&edm=AOQ1c0wBAAAA&ccb=7-5&oh=00_AfyNVgaEmlBsmZcJ8ZLetflfbX0IbHpSFLa21YNcV-oLoA&oe=69BCE5A5&_nc_sid=8b3546",
          "is_pinned": false,
          "likes": 47,
          "location": {
            "has_public_page": null,
            "id": null,
            "name": null,
            "slug": null
          },
          "post_hashtags": [
            "irishpodcast",
            "brainmelt"
          ],
          "url": "https://www.instagram.com/p/DCB-MW9MZqC",
          "video_url": "https://scontent-dfw6-1.cdninstagram.com/o1/v/t2/f2/m367/AQNC9pTSh_sqrA-fhRMmhTUPsv-xrcuqgUEQScc1hUi7SBjj25GcbBoVf_NhjuetkQJhS0LduAJJfqz_Me4Kk3z5CX3qqgUtF3K282A.mp4?_nc_cat=101&_nc_sid=5e9851&_nc_ht=scontent-dfw6-1.cdninstagram.com&_nc_ohc=fKCWP4nLTc4Q7kNvwGRtcmn&efg=eyJ2ZW5jb2RlX3RhZyI6Inhwdl9wcm9ncmVzc2l2ZS5JTlNUQUdSQU0uQ0xJUFMuQzMuNzIwLmRhc2hfYmFzZWxpbmVfMV92MSIsInhwdl9hc3NldF9pZCI6OTY1MDc1OTg4NzgwMzE4LCJhc3NldF9hZ2VfZGF5cyI6NDk0LCJ2aV91c2VjYXNlX2lkIjoxMDA5OSwiZHVyYXRpb25fcyI6MjMsInVybGdlbl9zb3VyY2UiOiJ3d3cifQ%3D%3D&ccb=17-1&_nc_gid=f8NLMHfSvJHjKW7CNjdR5w&_nc_ss=8&_nc_zt=28&vs=ed3daf27ab696a71&_nc_vs=HBksFQIYQGlnX2VwaGVtZXJhbC8xMzQzOTZBRTEyMDg4RDg2MTYzQjIxQkEyMTM0MUVBOV92aWRlb19kYXNoaW5pdC5tcDQVAALIARIAFQIYR2lnX3hwdl9yZWVsc19wZXJtYW5lbnRfc3JfcHJvZC8xMDk1MDkzODgyMTI2MTkyXzg4Njc1NDA2NTc4NDE0MDA5NzMubXA0FQICyAESACgAGAAbAogHdXNlX29pbAExEnByb2dyZXNzaXZlX3JlY2lwZQExFQAAJrzU8Lfo7rYDFQIoAkMzLBdAN7MzMzMzMxgSZGFzaF9iYXNlbGluZV8xX3YxEQB1_gdl5p0BAA&oh=00_AfzX-ow_DcwGwG-N-wJRo2wUhFiBQWG9HH74zasp7_xKdg&oe=69BCE9BA"
        }
      ],
      "profile_image_link": "htt***//s***ten*********cdn*********************885************************************************************************************************************************************************************************************************************************************************************************************************************************************************************************************************************************************************************",
      "profile_url": "htt***//i***agr*********nny************",
      "profile_name": "Jenny K***y",
      "highlights_count": 1,
      "highlights": [
        {
          "highlight_url": "https://www.instagram.com/stories/highlights/18026550763647585",
          "id": "18026550763647585",
          "image": "https://scontent-atl3-3.cdninstagram.com/v/t51.82787-15/573732645_18127616266495367_3673315206062571981_n.jpg?stp=c0.455.1170.1170a_dst-jpg_e15_s150x150_tt6&_nc_ht=scontent-atl3-3.cdninstagram.com&_nc_cat=111&_nc_oc=Q6cZ2QEE4OreRXzcQ2CqfikRW1dKnGrkuowmELfFxSlLCv0wKApkCk_6Wcbln6C2erPd-Xo&_nc_ohc=pr5PJJAmFYkQ7kNvwGad141&_nc_gid=uQYUd6X3lmUi--ZasXrx5A&edm=AGXveE0BAAAA&ccb=7-5&oh=00_AfxIP7Y-MDVbXrKf1PFIq3qOQemwInWjCDquh1v-Zuc0qQ&oe=69BCC45C&_nc_sid=522435",
          "owner": "jennykelly1972",
          "title": "📚"
        }
      ],
      "full_name": "Jenny K***y",
      "is_private": false,
      "bio_hashtags": null,
      "url": "https://www.instagram.com/jennykelly1972/",
      "is_joined_recently": false,
      "has_channel": false,
      "partner_id": "5087052934",
      "business_address": null,
      "related_accounts": [],
      "email_address": "jen***dar***ail******",
      "external_url_title": {
        "title": null,
        "url": null
      },
      "pronouns": null
    }
  ]
  ```
</ResponseExample>


# Collect Instagram profiles by URL
Source: https://docs.brightdata.com/api-reference/scrapers/social-media-apis/instagram-profiles-collect-by-url

api-reference/sdk-specs/instagram-profiles-collect-by-url POST /datasets/v3/scrape
Use the Bright Data Web Scraper API to collect Instagram profiles by URL. Calls the POST /datasets/v3/scrape endpoint and returns a snapshot ID.

## Query Parameters

<ParamField type="string">
  The dataset ID used for this request.

  <Warning>
    Must be set to `gd_l1vikfch901nx3by4` to collect **Profiles by URL** data.
  </Warning>
</ParamField>

<ParamField type="boolean">
  Whether to send notifications when the request is completed.
</ParamField>

<ParamField type="boolean">
  Whether to include errors in the response.
</ParamField>

## Request Body

<ParamField type="object[]">
  An array of input objects.

  <Expandable title="properties">
    <ParamField type="string">
      The URL of the Instagram profile to collect.
    </ParamField>
  </Expandable>

  #### Example

  ```json wrap theme={null}
  {
    "input": [
      {"url": "https://www.instagram.com/cats_of_world_"},
      {"url": "https://www.instagram.com/dogsofinstagram"},
      {"url": "https://www.instagram.com/zoobarcelona"},
      {"url": "https://www.instagram.com/australiazoo"}
    ]
  }
  ```
</ParamField>

<ResponseExample>
  ```json 200 theme={null}
  [
    {
      "account": "jen***ell***72",
      "fbid": "17841405188025881",
      "id": "5087052934",
      "followers": 7938,
      "posts_count": 835,
      "is_business_account": false,
      "is_professional_account": false,
      "is_verified": false,
      "avg_engagement": 0.0582,
      "external_url": null,
      "biography": "Pod: @raydarcydaily \nemail: jenny@darcydaily.com",
      "business_category_name": null,
      "category_name": null,
      "post_hashtags": null,
      "following": 2520,
      "posts": [
        {
          "caption": "BEING HUMAN - A six part series where Ray chats to 6 well known Irish people about what it means to be human. \n\nFirst episode Wednesday 18th March, and every Wednesday after.\n\nA What Next Production\nPresented by Ray D’Arcy\nProduced by Jenny Kelly\n\n#beinghuman \n#podcast \n#irishpodcast",
          "comments": 2,
          "content_type": "Video",
          "datetime": "2026-03-12T11:52:08.000Z",
          "id": "3851176228498036124",
          "image_url": "https://scontent-dfw5-2.cdninstagram.com/v/t51.82787-15/651142041_18334056292172935_8112879477358850984_n.jpg?stp=dst-jpg_e15_tt6&_nc_ht=scontent-dfw5-2.cdninstagram.com&_nc_cat=107&_nc_oc=Q6cZ2QH-MUSe6C4PkyFc8saG_6IRC_V3hZ9c7StCViUw-zl5K7a2Qh7u0q29i7etbbV1SI4&_nc_ohc=W4Jy7OhEd8MQ7kNvwFBSQNv&_nc_gid=f8NLMHfSvJHjKW7CNjdR5w&edm=AOQ1c0wBAAAA&ccb=7-5&oh=00_Afwe_S8Bh8FtoL_RtvxoQ6RF2c20beQzWeLfJfizNBlciQ&oe=69BCEC94&_nc_sid=8b3546",
          "is_pinned": false,
          "likes": 36,
          "location": {
            "has_public_page": null,
            "id": null,
            "name": null,
            "slug": null
          },
          "post_hashtags": [
            "beinghuman",
            "podcast",
            "irishpodcast"
          ],
          "url": "https://www.instagram.com/p/DVyIGAbDdWc",
          "video_url": "https://scontent-dfw6-1.cdninstagram.com/o1/v/t16/f2/m69/AQMSgH9bCDeY_VmVFTYEzrv9RMglEw0prtVd_QFRgC21aFXJ10hPg07pPxQ6VZdxe1vFeVnYABQlz2zcpXVrQqfV.mp4?strext=1&_nc_cat=103&_nc_sid=5e9851&_nc_ht=scontent-dfw6-1.cdninstagram.com&_nc_ohc=F9Tybdk82ZQQ7kNvwGJ2sbT&efg=eyJ2ZW5jb2RlX3RhZyI6Inhwdl9wcm9ncmVzc2l2ZS5JTlNUQUdSQU0uQ0xJUFMuQzMuNDgwLmRhc2hfYmFzZWxpbmVfMV92MSIsInhwdl9hc3NldF9pZCI6MTgzMzQwNTU2MDgxNzI5MzUsImFzc2V0X2FnZV9kYXlzIjozLCJ2aV91c2VjYXNlX2lkIjoxMDA5OSwiZHVyYXRpb25fcyI6MTE3LCJ1cmxnZW5fc291cmNlIjoid3d3In0%3D&ccb=17-1&_nc_gid=f8NLMHfSvJHjKW7CNjdR5w&_nc_ss=8&_nc_zt=28&vs=672fccf82fe0dcbe&_nc_vs=HBksFQIYOnBhc3N0aHJvdWdoX2V2ZXJzdG9yZS9HUGlMdHlhY29GUzFoRFFEQU9udTlRZ1ByVDFKYnNwVEFRQUYVAALIARIAFQIYUWlnX3hwdl9wbGFjZW1lbnRfcGVybWFuZW50X3YyL0E5NEZGMjZCMjU0OTFERkZBNzYzQjU2NDhBOUM5QThGX2F1ZGlvX2Rhc2hpbml0Lm1wNBUCAsgBEgAoABgAGwKIB3VzZV9vaWwBMRJwcm9ncmVzc2l2ZV9yZWNpcGUBMRUAACaOhor9vq6RQRUCKAJDMywXQF1AAAAAAAAYEmRhc2hfYmFzZWxpbmVfMV92MREAdf4HZeadAQA&oh=00_AfyDY32lp2KMgYLDKEK7Wx7ocPFPwwhGkiuWvBKwB_joLg&oe=69BCCEE9"
        },
        {
          "caption": "Our brand new daily podcast is starting tomorrow \n\nRay D’Arcy Daily \n\nWherever you get your podcasts.\n\nEmail us ray@darcydaily.com\n#podcast #irishpodcast",
          "comments": 86,
          "content_type": "Video",
          "datetime": "2026-03-08T16:21:04.000Z",
          "id": "3848412628930911784",
          "image_url": "https://scontent-dfw5-1.cdninstagram.com/v/t51.71878-15/649327000_1860456074651243_3014167701283875235_n.jpg?stp=dst-jpg_e15_tt6&_nc_ht=scontent-dfw5-1.cdninstagram.com&_nc_cat=111&_nc_oc=Q6cZ2QH-MUSe6C4PkyFc8saG_6IRC_V3hZ9c7StCViUw-zl5K7a2Qh7u0q29i7etbbV1SI4&_nc_ohc=b0EoQkmauKkQ7kNvwGZzfjq&_nc_gid=f8NLMHfSvJHjKW7CNjdR5w&edm=AOQ1c0wBAAAA&ccb=7-5&oh=00_AfxQfU7Ocg9M26vOgYlA3m4oy4cpmvDY9859u4P35lUqng&oe=69BCEFC3&_nc_sid=8b3546",
          "is_pinned": false,
          "likes": 992,
          "location": {
            "has_public_page": null,
            "id": null,
            "name": null,
            "slug": null
          },
          "post_hashtags": [
            "podcast",
            "irishpodcast"
          ],
          "url": "https://www.instagram.com/p/DVoTuVwjd4o",
          "video_url": "https://scontent-dfw5-2.cdninstagram.com/o1/v/t16/f2/m69/AQNqwbuRAKLUvBo_BRm3bnGbIV2EPYfXffZLw2f3swiqVgfVNN31xLUjJYzBUmk31ks69X_8_c7EKmCelHv_buYH.mp4?strext=1&_nc_cat=104&_nc_sid=5e9851&_nc_ht=scontent-dfw5-2.cdninstagram.com&_nc_ohc=iuf2XH_4eaAQ7kNvwGQqv3J&efg=eyJ2ZW5jb2RlX3RhZyI6Inhwdl9wcm9ncmVzc2l2ZS5JTlNUQUdSQU0uQ0xJUFMuQzMuNzIwLmRhc2hfYmFzZWxpbmVfMV92MSIsInhwdl9hc3NldF9pZCI6MTgzMzM2MzkxNzIxNzI5MzUsImFzc2V0X2FnZV9kYXlzIjo3LCJ2aV91c2VjYXNlX2lkIjoxMDA5OSwiZHVyYXRpb25fcyI6NjAsInVybGdlbl9zb3VyY2UiOiJ3d3cifQ%3D%3D&ccb=17-1&_nc_gid=f8NLMHfSvJHjKW7CNjdR5w&_nc_ss=8&_nc_zt=28&vs=ce88cc19b1c12270&_nc_vs=HBksFQIYOnBhc3N0aHJvdWdoX2V2ZXJzdG9yZS9HSVhrcWlhdEZTUTBGLTBFQUNGU2oydVRFWlZ4YnNwVEFRQUYVAALIARIAFQIYUWlnX3hwdl9wbGFjZW1lbnRfcGVybWFuZW50X3YyLzIwNEVCQTgxMTJEMkM2ODRBNzFEREU0RTQwNTBFQThDX2F1ZGlvX2Rhc2hpbml0Lm1wNBUCAsgBEgAoABgAGwKIB3VzZV9vaWwBMRJwcm9ncmVzc2l2ZV9yZWNpcGUBMRUAACaOsuGkoJaRQRUCKAJDMywXQE464UeuFHsYEmRhc2hfYmFzZWxpbmVfMV92MREAdf4HZeadAQA&oh=00_AfzE-98jZ3zhfaRZuLxlWwz5GmrjBpxgERbFaOjPj7UIrw&oe=69BCCCA4"
        },
        {
          "caption": "We have some news! \n\nRAY D’ARCY DAILY - your daily podcast. \n\nThis five day a week show is nothing new, and yet ALL NEW. It’s Monday to Friday with Ray giving his own world view while surrounded by friends of the show, Jenny Kelly (that’s me 🤪), Mairead Ronan and Bernard O’Shea to name a few. \n\nWe hope you’ll join us. \nStarting Monday 9th. \n\nFollow the show now to make sure you never miss an episode. \n\nListen wherever you get your Podcasts #irishpodcast #podcast \n@cocomairead @bernardo.oshea @acast",
          "comments": 166,
          "content_type": "Video",
          "datetime": "2026-03-02T13:25:41.000Z",
          "id": "3843977898726623596",
          "image_url": "https://scontent-dfw5-1.cdninstagram.com/v/t51.71878-15/641425914_1446430403853586_8943556578413069821_n.jpg?stp=dst-jpg_e15_tt6&_nc_ht=scontent-dfw5-1.cdninstagram.com&_nc_cat=110&_nc_oc=Q6cZ2QH-MUSe6C4PkyFc8saG_6IRC_V3hZ9c7StCViUw-zl5K7a2Qh7u0q29i7etbbV1SI4&_nc_ohc=j-4QNAsV4yEQ7kNvwEWKOeO&_nc_gid=f8NLMHfSvJHjKW7CNjdR5w&edm=AOQ1c0wBAAAA&ccb=7-5&oh=00_Afy2MQCg7ccEpt8gZNJowsCxi2k7fkX141C5dFU-dvfEfg&oe=69BCC84E&_nc_sid=8b3546",
          "is_pinned": false,
          "likes": 1158,
          "location": {
            "has_public_page": null,
            "id": null,
            "name": null,
            "slug": null
          },
          "post_hashtags": [
            "irishpodcast",
            "podcast"
          ],
          "url": "https://www.instagram.com/p/DVYjYhaDYls",
          "video_url": "https://scontent-dfw6-1.cdninstagram.com/o1/v/t16/f2/m69/AQM_D-LpDwCPxPZrnXzoyfkknE8jP_GwRpGwtEvjefP4KUFo7dAEFZ51YD7Nn6-NLnnVLm3sIF5e7jbT_ImFtRri.mp4?strext=1&_nc_cat=103&_nc_sid=5e9851&_nc_ht=scontent-dfw6-1.cdninstagram.com&_nc_ohc=-FdPzVISP18Q7kNvwEcVVkv&efg=eyJ2ZW5jb2RlX3RhZyI6Inhwdl9wcm9ncmVzc2l2ZS5JTlNUQUdSQU0uQ0xJUFMuQzMuNzIwLmRhc2hfYmFzZWxpbmVfMV92MSIsInhwdl9hc3NldF9pZCI6MTgzMzMwNTA3OTExNzI5MzUsImFzc2V0X2FnZV9kYXlzIjoxMywidmlfdXNlY2FzZV9pZCI6MTAwOTksImR1cmF0aW9uX3MiOjE0MSwidXJsZ2VuX3NvdXJjZSI6Ind3dyJ9&ccb=17-1&_nc_gid=f8NLMHfSvJHjKW7CNjdR5w&_nc_ss=8&_nc_zt=28&vs=54251b7443d07334&_nc_vs=HBksFQIYOnBhc3N0aHJvdWdoX2V2ZXJzdG9yZS9HSnlFZHlhaTdRb2U1SmtFQURXYkJFSjd5XzEwYnNwVEFRQUYVAALIARIAFQIYUWlnX3hwdl9wbGFjZW1lbnRfcGVybWFuZW50X3YyLzEyNEU2RjhEQkU4M0NCQ0Y3NEU5Njk2Q0I0NTJDRkIxX2F1ZGlvX2Rhc2hpbml0Lm1wNBUCAsgBEgAoABgAGwKIB3VzZV9vaWwBMRJwcm9ncmVzc2l2ZV9yZWNpcGUBMRUAACaO7fTAgPSQQRUCKAJDMywXQGGqp--dsi0YEmRhc2hfYmFzZWxpbmVfMV92MREAdf4HZeadAQA&oh=00_AfxknzHbQifAj5YoGVzxwXn2cPKeVRcRrdXbooIhlD8ZBQ&oe=69BCDC41"
        },
        {
          "caption": "PODCAST NEWS 📢\n\nAfter 3 years we have made the decision to hang up our ‘Jenny and Mairéad NOW' mics. \n\nWe have LOVED doing it. 💕\n\nWe re-connected with so many listeners from our radio days and got lots of new listeners along the way. We want to thank you for all the laughs and life stories you’ve shared with us. \n\nWe both have new commitments that we are diving into, so for today, we'll say ‘so long for now’ 💫 \n\nLots of love, \nJenny and Mairéad \nXx \n\nPS..leave your lips alone, buy a spray mop and remember… \"you’ll be dead forever”",
          "comments": 158,
          "content_type": "Image",
          "datetime": "2025-09-24T17:50:53.000Z",
          "id": "3728872417469969396",
          "image_url": "https://scontent-dfw5-2.cdninstagram.com/v/t51.82787-15/553161422_17973649637947844_5055340064665934469_n.webp?stp=dst-jpg_e35_s1080x1080_sh0.08_tt6&_nc_ht=scontent-dfw5-2.cdninstagram.com&_nc_cat=108&_nc_oc=Q6cZ2QH-MUSe6C4PkyFc8saG_6IRC_V3hZ9c7StCViUw-zl5K7a2Qh7u0q29i7etbbV1SI4&_nc_ohc=0IDMJZLADZgQ7kNvwGBZl2R&_nc_gid=f8NLMHfSvJHjKW7CNjdR5w&edm=AOQ1c0wBAAAA&ccb=7-5&oh=00_AfxVGERnGo1gjS9N7F4Hvi14Ek0zIbXq_m_2vnk8p1c0mQ&oe=69BCDBC8&_nc_sid=8b3546",
          "is_pinned": false,
          "likes": 1572,
          "location": {
            "has_public_page": null,
            "id": null,
            "name": null,
            "slug": null
          },
          "post_hashtags": null,
          "url": "https://www.instagram.com/p/DO_nbUQDLP0",
          "video_url": null
        },
        {
          "caption": "I COULD have been a camogie player (never played in my life 🤣), and @cocomairead COULD have been a pop star … what COULD you have been? \n\nPodcast out tomorrow 6am #irishpodcast #podcast #jennyandmaireadnow",
          "comments": null,
          "content_type": "Video",
          "datetime": "2025-04-29T21:44:06.000Z",
          "id": "3621719997521697568",
          "image_url": "https://scontent-dfw6-1.cdninstagram.com/v/t51.71878-15/491461907_976222424658362_5118993394906495251_n.jpg?stp=dst-jpg_e15_tt6&_nc_ht=scontent-dfw6-1.cdninstagram.com&_nc_cat=102&_nc_oc=Q6cZ2QH-MUSe6C4PkyFc8saG_6IRC_V3hZ9c7StCViUw-zl5K7a2Qh7u0q29i7etbbV1SI4&_nc_ohc=fdEBmapVjIYQ7kNvwH9d2ns&_nc_gid=f8NLMHfSvJHjKW7CNjdR5w&edm=AOQ1c0wBAAAA&ccb=7-5&oh=00_Afz4h2HLZTuYioO61W7aDIMzXCHL34Tv_SD_q5TYfJ99iA&oe=69BCBEDC&_nc_sid=8b3546",
          "is_pinned": false,
          "likes": 62,
          "location": {
            "has_public_page": null,
            "id": null,
            "name": null,
            "slug": null
          },
          "post_hashtags": [
            "irishpodcast",
            "podcast",
            "jennyandmaireadnow"
          ],
          "url": "https://www.instagram.com/p/DJC7yYoNZsg",
          "video_url": "https://scontent-dfw5-2.cdninstagram.com/o1/v/t2/f2/m367/AQNdTe3n8U7HJAUZPYQ2IKytrTScEjIa2LVv7p-gcs7bfH2WDHkU1GuQ63tg4BxPEIFCVKgn-k9soAiz09MH_R_ORdQFWDf5N2MPRLY.mp4?_nc_cat=104&_nc_sid=5e9851&_nc_ht=scontent-dfw5-2.cdninstagram.com&_nc_ohc=Syer777RuQMQ7kNvwEmKdhm&efg=eyJ2ZW5jb2RlX3RhZyI6Inhwdl9wcm9ncmVzc2l2ZS5JTlNUQUdSQU0uQ0xJUFMuQzMuNDgwLmRhc2hfYmFzZWxpbmVfMV92MSIsInhwdl9hc3NldF9pZCI6MTU5NDc3ODcyNzg2ODYyNywiYXNzZXRfYWdlX2RheXMiOjMxOSwidmlfdXNlY2FzZV9pZCI6MTAwOTksImR1cmF0aW9uX3MiOjY5LCJ1cmxnZW5fc291cmNlIjoid3d3In0%3D&ccb=17-1&_nc_gid=f8NLMHfSvJHjKW7CNjdR5w&_nc_ss=8&_nc_zt=28&vs=1d3eb966c62b0ed0&_nc_vs=HBksFQIYQGlnX2VwaGVtZXJhbC8zMTRBRkNEOTM4NTM5NjI2MzhBMUQwQ0QxNDk2QzE4QV92aWRlb19kYXNoaW5pdC5tcDQVAALIARIAFQIYRmlnX3hwdl9yZWVsc19wZXJtYW5lbnRfc3JfcHJvZC8xMjE3ODU0OTYzMjg1ODY0Xzk0ODMzNjE1ODI3NjU5Njg3OC5tcDQVAgLIARIAKAAYABsCiAd1c2Vfb2lsATEScHJvZ3Jlc3NpdmVfcmVjaXBlATEVAAAmpqOPuauc1QUVAigCQzMsF0BRUQYk3S8bGBJkYXNoX2Jhc2VsaW5lXzFfdjERAHX-B2XmnQEA&oh=00_AfxYnVqq-YPFAKEW8CVj-CJBIvyL0qQSOxuzTNCksnr_Sg&oe=69BCE24D"
        },
        {
          "caption": "Podcast @jennyandmaireadnow out tomorrow 6am \n\n✨Mairead needs help\n✨Netflix Doc: Buy Now!\n✨2025 Manifesto\n✨Colour and word of the year \n✨Debutant Balls and Feis\n\nThanks to our sponsor @vhi_ie \n#irishpodcast #podcast #friendship",
          "comments": null,
          "content_type": "Video",
          "datetime": "2024-12-10T21:36:11.000Z",
          "id": "3520245279648780747",
          "image_url": "https://scontent-dfw5-2.cdninstagram.com/v/t51.2885-15/469729187_18286176577172935_8198072792922023263_n.jpg?stp=dst-jpg_e15_tt6&_nc_ht=scontent-dfw5-2.cdninstagram.com&_nc_cat=107&_nc_oc=Q6cZ2QH-MUSe6C4PkyFc8saG_6IRC_V3hZ9c7StCViUw-zl5K7a2Qh7u0q29i7etbbV1SI4&_nc_ohc=skhiJmD75-kQ7kNvwEeKZA6&_nc_gid=f8NLMHfSvJHjKW7CNjdR5w&edm=AOQ1c0wBAAAA&ccb=7-5&oh=00_AfzWsdPI0aqqm2_IHDtzlIqHu2mL76RyRwvUBMetthP-hg&oe=69BCCDF6&_nc_sid=8b3546",
          "is_pinned": false,
          "likes": 64,
          "location": {
            "has_public_page": null,
            "id": null,
            "name": null,
            "slug": null
          },
          "post_hashtags": [
            "irishpodcast",
            "podcast",
            "friendship"
          ],
          "url": "https://www.instagram.com/p/DDabG5HthHL",
          "video_url": "https://scontent-dfw5-1.cdninstagram.com/o1/v/t2/f2/m367/AQMy1Odi0RhpjgXggsSeeNNxmcDcNt0_X6IYxlCD21k4z4h46ndGKxoNjJIRjVg94CuujC1j-CiG89HT8-O9C-XPAl_3C_7p3GqzZ5M.mp4?_nc_cat=109&_nc_sid=5e9851&_nc_ht=scontent-dfw5-1.cdninstagram.com&_nc_ohc=zEKeRBdP2mAQ7kNvwENzKpk&efg=eyJ2ZW5jb2RlX3RhZyI6Inhwdl9wcm9ncmVzc2l2ZS5JTlNUQUdSQU0uQ0xJUFMuQzMuNzIwLmRhc2hfYmFzZWxpbmVfMV92MSIsInhwdl9hc3NldF9pZCI6MTIzMzY5MjkwNzcxNjE1MSwiYXNzZXRfYWdlX2RheXMiOjQ1OSwidmlfdXNlY2FzZV9pZCI6MTAwOTksImR1cmF0aW9uX3MiOjUxLCJ1cmxnZW5fc291cmNlIjoid3d3In0%3D&ccb=17-1&_nc_gid=f8NLMHfSvJHjKW7CNjdR5w&_nc_ss=8&_nc_zt=28&vs=be7ed278cb04ea95&_nc_vs=HBksFQIYQGlnX2VwaGVtZXJhbC9BQjQyNThCNTU0QTJGNEIxODg3NjlBQUJFMDNDMzU4Q192aWRlb19kYXNoaW5pdC5tcDQVAALIARIAFQIYRmlnX3hwdl9yZWVsc19wZXJtYW5lbnRfc3JfcHJvZC8xNTAyMTIxNTUwNzQwNjE0Xzc5ODkxODI2NzE3NDU1MDEwNy5tcDQVAgLIARIAKAAYABsCiAd1c2Vfb2lsATEScHJvZ3Jlc3NpdmVfcmVjaXBlATEVAAAm7vi1uLCCsQQVAigCQzMsF0BJmZmZmZmaGBJkYXNoX2Jhc2VsaW5lXzFfdjERAHX-B2XmnQEA&oh=00_Afzvy10txzkdt9h08tJs_9VMlJicQjSggsPEZ61LEdGYmA&oe=69BCC63E"
        },
        {
          "caption": "This book took me a few weeks to read and it’s only 136 pages long. I could quite easily go back now and start it all over again. One of the most beautiful books I’ve read. It tells the story of 24 hours in the lives of 6 astronauts on the international space station. Each of the 16 chapters takes in one orbit of earth. It’s difficult to describe just how profound and touching this small book is. A love letter to Earth. It made me feel both sad and hopeful at the same time. I read that the author Samantha Harvey stopped writing half way through because she felt she didn’t have the right to write a book like this, so removed was it from her real life. I’m so glad she ignored that voice in her head because this book is something we will read for years and years to come. Stunning.",
          "comments": 6,
          "content_type": "Image",
          "datetime": "2024-12-04T19:34:23.000Z",
          "id": "3515840447256809542",
          "image_url": "https://scontent-dfw6-1.cdninstagram.com/v/t51.82787-15/623407206_17991231980916798_8528601805505725054_n.jpg?stp=dst-jpg_e35_p1080x1080_sh0.08_tt6&_nc_ht=scontent-dfw6-1.cdninstagram.com&_nc_cat=106&_nc_oc=Q6cZ2QH-MUSe6C4PkyFc8saG_6IRC_V3hZ9c7StCViUw-zl5K7a2Qh7u0q29i7etbbV1SI4&_nc_ohc=1jkbYPze7PIQ7kNvwFhqTAc&_nc_gid=f8NLMHfSvJHjKW7CNjdR5w&edm=AOQ1c0wBAAAA&ccb=7-5&oh=00_Afzg1e_fEK30evjHAzSP597UW_USGzLTBIj1k-EIjQQMfA&oe=69BCCA41&_nc_sid=8b3546",
          "is_pinned": false,
          "likes": 109,
          "location": {
            "has_public_page": null,
            "id": null,
            "name": null,
            "slug": null
          },
          "post_hashtags": null,
          "url": "https://www.instagram.com/p/DDKxkJRsVBG",
          "video_url": null
        },
        {
          "caption": "Pod out Wednesday 6am\n\n✨Kissing 💋\n✨Christmas Movies 🎬\n✨family traditions 🏡\n✨Nits 🦗\n\nThanks to our sponsor @vhi_ie",
          "comments": 1,
          "content_type": "Video",
          "datetime": "2024-12-03T21:00:59.000Z",
          "id": "3515158122554635287",
          "image_url": "https://scontent-dfw5-2.cdninstagram.com/v/t51.71878-15/503975082_1908008223345944_5512368651421990898_n.jpg?stp=dst-jpg_e15_tt6&_nc_ht=scontent-dfw5-2.cdninstagram.com&_nc_cat=108&_nc_oc=Q6cZ2QH-MUSe6C4PkyFc8saG_6IRC_V3hZ9c7StCViUw-zl5K7a2Qh7u0q29i7etbbV1SI4&_nc_ohc=LBreF5ALN2IQ7kNvwE_RtAb&_nc_gid=f8NLMHfSvJHjKW7CNjdR5w&edm=AOQ1c0wBAAAA&ccb=7-5&oh=00_AfzmTzT-OfgwVOhOYS62CUgEdWcUX2YsW20KyaTEXiv3Gg&oe=69BCD350&_nc_sid=8b3546",
          "is_pinned": false,
          "likes": 27,
          "location": {
            "has_public_page": null,
            "id": null,
            "name": null,
            "slug": null
          },
          "post_hashtags": null,
          "url": "https://www.instagram.com/p/DDIWbA4MrQX",
          "video_url": "https://scontent-dfw5-2.cdninstagram.com/o1/v/t2/f2/m367/AQNO52R4NspLq6_HyhxNcCLUQtKiP7dXhYXNEIO3IjvmzKdyZMS_YYgB2zRkbZs4SLFVBOdJpB3L19p9-zxxOyqHp9Lk-fOum-vlUa4.mp4?_nc_cat=107&_nc_sid=5e9851&_nc_ht=scontent-dfw5-2.cdninstagram.com&_nc_ohc=eyaMjy3BLs8Q7kNvwFAQ_2h&efg=eyJ2ZW5jb2RlX3RhZyI6Inhwdl9wcm9ncmVzc2l2ZS5JTlNUQUdSQU0uQ0xJUFMuQzMuNzIwLmRhc2hfYmFzZWxpbmVfMV92MSIsInhwdl9hc3NldF9pZCI6MTc3MTU2NjI2MDMyMzQ3NSwiYXNzZXRfYWdlX2RheXMiOjQ2NiwidmlfdXNlY2FzZV9pZCI6MTAwOTksImR1cmF0aW9uX3MiOjQ5LCJ1cmxnZW5fc291cmNlIjoid3d3In0%3D&ccb=17-1&_nc_gid=f8NLMHfSvJHjKW7CNjdR5w&_nc_ss=8&_nc_zt=28&vs=4e62294db6b90ea0&_nc_vs=HBksFQIYQGlnX2VwaGVtZXJhbC82NTRENUM0OTczREYzNDQ0MzFDQTExRDQxRTY0RUI5Rl92aWRlb19kYXNoaW5pdC5tcDQVAALIARIAFQIYRmlnX3hwdl9yZWVsc19wZXJtYW5lbnRfc3JfcHJvZC8xMTYwODk0Nzg1Mzk1ODg1XzgyNDkxMDM2OTY3NjU4NTg4MS5tcDQVAgLIARIAKAAYABsCiAd1c2Vfb2lsATEScHJvZ3Jlc3NpdmVfcmVjaXBlATEVAAAmppKkmt3OpQYVAigCQzMsF0BI7tkWhysCGBJkYXNoX2Jhc2VsaW5lXzFfdjERAHX-B2XmnQEA&oh=00_AfxxoxyLQuVwyz2uioRVM08hneqBb3CfGndyLkviQkDqVw&oe=69BCE6C8"
        },
        {
          "caption": "Podcast out NOW ✨\n\nWe really enjoyed our chat with @michealmartintd \n\n✨telepathy between him and his wife\n✨the ingredients to his perfect salad\n✨book club inspiration \n✨what he REALLY wanted to be when he grew up \n\n#jennyandmaireadnow #whatweknownow #irishpodcasts #friendship #collabrativestudio",
          "comments": 29,
          "content_type": "Video",
          "datetime": "2024-11-13T11:36:18.000Z",
          "id": "3500373609463083880",
          "image_url": "https://scontent-dfw5-2.cdninstagram.com/v/t51.2885-15/466773911_17936241830947844_3117143642697548716_n.jpg?stp=dst-jpg_e15_tt6&_nc_ht=scontent-dfw5-2.cdninstagram.com&_nc_cat=108&_nc_oc=Q6cZ2QH-MUSe6C4PkyFc8saG_6IRC_V3hZ9c7StCViUw-zl5K7a2Qh7u0q29i7etbbV1SI4&_nc_ohc=1pwaOyShnGoQ7kNvwGsRorU&_nc_gid=f8NLMHfSvJHjKW7CNjdR5w&edm=AOQ1c0wBAAAA&ccb=7-5&oh=00_AfxMIFfgprmdzKi-AErgzTmN3E-gzqKmuT2QhUQC1TC7NQ&oe=69BCD28B&_nc_sid=8b3546",
          "is_pinned": false,
          "likes": 197,
          "location": {
            "has_public_page": null,
            "id": null,
            "name": null,
            "slug": null
          },
          "post_hashtags": [
            "jennyandmaireadnow",
            "whatweknownow",
            "irishpodcasts",
            "friendship",
            "collabrativestudio"
          ],
          "url": "https://www.instagram.com/p/DCT00CFMvNo",
          "video_url": "https://scontent-dfw5-1.cdninstagram.com/o1/v/t2/f2/m367/AQNLvylMFRY6P74zmh9wwvuEJ7rtO-sItj8FJLT2nSb_PeMIpJmOm8SkfRH64lOCNztgBnZpZ-XoKhrc8CItJtQKS1Mut4lfPZFXbj8.mp4?_nc_cat=110&_nc_sid=5e9851&_nc_ht=scontent-dfw5-1.cdninstagram.com&_nc_ohc=qIweWDr6GKEQ7kNvwHO-YZz&efg=eyJ2ZW5jb2RlX3RhZyI6Inhwdl9wcm9ncmVzc2l2ZS5JTlNUQUdSQU0uQ0xJUFMuQzMuNzIwLmRhc2hfYmFzZWxpbmVfMV92MSIsInhwdl9hc3NldF9pZCI6MzkwMzA5NDY3MzI4MjA3MiwiYXNzZXRfYWdlX2RheXMiOjQ4NywidmlfdXNlY2FzZV9pZCI6MTAwOTksImR1cmF0aW9uX3MiOjQzLCJ1cmxnZW5fc291cmNlIjoid3d3In0%3D&ccb=17-1&_nc_gid=f8NLMHfSvJHjKW7CNjdR5w&_nc_ss=8&_nc_zt=28&vs=15624de47fd39130&_nc_vs=HBksFQIYQGlnX2VwaGVtZXJhbC8yOTQ3MDYwMDcyNEI5QTQ4Njk2RDIzNUNCQjZGNzI5MV92aWRlb19kYXNoaW5pdC5tcDQVAALIARIAFQIYR2lnX3hwdl9yZWVsc19wZXJtYW5lbnRfc3JfcHJvZC8xMzIyMTQ3MTEyNDk4NDU0Xzg1NDM2NTk1NDU5NDg0NjEyNjYubXA0FQICyAESACgAGAAbAogHdXNlX29pbAExEnByb2dyZXNzaXZlX3JlY2lwZQExFQAAJrDQtLiB9u4NFQIoAkMzLBdARfMzMzMzMxgSZGFzaF9iYXNlbGluZV8xX3YxEQB1_gdl5p0BAA&oh=00_Afx5DWMCHEDJoObUP3-Lb7Hu9-RkPZteuaVDucxzxkaVtg&oe=69BCD8B3"
        },
        {
          "caption": "🎙️Bit of a different podcast for you this week! \n\nWe sat down with Tánaiste @michealmartintd and asked him ‘What He Knows Now.\n\n✨Life lessons that have got him this far. \n✨Friendships, family & grief\n✨Sea swimming, dry robes & switching off\n\n Full episode drops tomorrow at 6am wherever you get your podcasts. \n\nJ & M\n\nThank you to our sponsor @vhi_ie \n\n#jennyandmaireadnow #lifelessons #dryrobe  #seaswimming",
          "comments": 25,
          "content_type": "Video",
          "datetime": "2024-11-12T22:26:31.000Z",
          "id": "3499981808361075522",
          "image_url": "https://scontent-dfw5-2.cdninstagram.com/v/t51.71878-15/466690817_552614564296939_1070270335390837149_n.jpg?stp=dst-jpg_e15_tt6&_nc_ht=scontent-dfw5-2.cdninstagram.com&_nc_cat=107&_nc_oc=Q6cZ2QH-MUSe6C4PkyFc8saG_6IRC_V3hZ9c7StCViUw-zl5K7a2Qh7u0q29i7etbbV1SI4&_nc_ohc=4Pn0CaGAEAwQ7kNvwGgi0OG&_nc_gid=f8NLMHfSvJHjKW7CNjdR5w&edm=AOQ1c0wBAAAA&ccb=7-5&oh=00_Afy31s1gWLZgx-uRpeh_veSBHwycbYIjHaSe6e6ghEjJug&oe=69BCCA2F&_nc_sid=8b3546",
          "is_pinned": false,
          "likes": 367,
          "location": {
            "has_public_page": null,
            "id": null,
            "name": null,
            "slug": null
          },
          "post_hashtags": [
            "jennyandmaireadnow",
            "lifelessons",
            "dryrobe",
            "seaswimming"
          ],
          "url": "https://www.instagram.com/p/DCSbuk3sPNC",
          "video_url": "https://scontent-dfw6-1.cdninstagram.com/o1/v/t2/f2/m367/AQOQyKg3hXP5Vbemc9YXLsURych3495OTaZ-k5hA5Ud_bPJkecOs-XoiZXj14XHIu3zOfYzZrFmrf4xdztvyIdI8ID29tB2UCIKdGKQ.mp4?_nc_cat=106&_nc_sid=5e9851&_nc_ht=scontent-dfw6-1.cdninstagram.com&_nc_ohc=xQB7AZzudfwQ7kNvwFSfvDS&efg=eyJ2ZW5jb2RlX3RhZyI6Inhwdl9wcm9ncmVzc2l2ZS5JTlNUQUdSQU0uQ0xJUFMuQzMuNDgwLmRhc2hfYmFzZWxpbmVfMV92MSIsInhwdl9hc3NldF9pZCI6MTEwMzM1MzI5Nzg3MDA1NCwiYXNzZXRfYWdlX2RheXMiOjQ4NywidmlfdXNlY2FzZV9pZCI6MTAwOTksImR1cmF0aW9uX3MiOjM2LCJ1cmxnZW5fc291cmNlIjoid3d3In0%3D&ccb=17-1&vs=52ef0882b0559893&_nc_vs=HBksFQIYQGlnX2VwaGVtZXJhbC9BMzQxREExQUVBNTJCQUUzNDNCMUEyNzNCQ0FFMzNCQl92aWRlb19kYXNoaW5pdC5tcDQVAALIARIAFQIYRmlnX3hwdl9yZWVsc19wZXJtYW5lbnRfc3JfcHJvZC80NTE4MzkyMTEzNTQwNTNfMjIyNDI2NDEzOTg0ODkxMDcwOC5tcDQVAgLIARIAKAAYABsCiAd1c2Vfb2lsATEScHJvZ3Jlc3NpdmVfcmVjaXBlATEVAAAmzPOM1s7f9QMVAigCQzMsF0BB92yLQ5WBGBJkYXNoX2Jhc2VsaW5lXzFfdjERAHX-B2XmnQEA&_nc_gid=f8NLMHfSvJHjKW7CNjdR5w&_nc_ss=8&_nc_zt=28&oh=00_Afxh28JyyPy9AVGT2wQv9pVAJuU58mjJPkCKFeb6f4Oh8w&oe=69BCE4E7"
        },
        {
          "caption": "Did a photoshoot with Stan because he’s just back from the hairdressers and looking so floofy and smelling beautiful 😍 I needed to document his clean smelling look as he will be rolling in some dirt/fox smell/ muck very soon 🤪 #dogsofinstagram #goldenretriever",
          "comments": 12,
          "content_type": "Carousel",
          "datetime": "2024-11-12T15:25:04.000Z",
          "id": "3499769896973330029",
          "image_url": "https://scontent-dfw5-2.cdninstagram.com/v/t51.29350-15/466995326_990526599761200_5153153982064132557_n.jpg?stp=dst-jpg_e35_p1080x1080_tt6&_nc_ht=scontent-dfw5-2.cdninstagram.com&_nc_cat=104&_nc_oc=Q6cZ2QH-MUSe6C4PkyFc8saG_6IRC_V3hZ9c7StCViUw-zl5K7a2Qh7u0q29i7etbbV1SI4&_nc_ohc=UxLUkZuUog8Q7kNvwEC_RWC&_nc_gid=f8NLMHfSvJHjKW7CNjdR5w&edm=AOQ1c0wBAAAA&ccb=7-5&oh=00_AfyUh-GMDlDzUu9nBtb6d8zt0aKqVnKXwgO24rSu4kLSnw&oe=69BCECBC&_nc_sid=8b3546",
          "is_pinned": false,
          "likes": 432,
          "location": {
            "has_public_page": null,
            "id": null,
            "name": null,
            "slug": null
          },
          "post_hashtags": [
            "dogsofinstagram",
            "goldenretriever"
          ],
          "url": "https://www.instagram.com/p/DCRri3As2Zt",
          "video_url": null
        },
        {
          "caption": "Behind the scenes brain melt during podcast recording @jennyandmaireadnow 😆 #irishpodcast #brainmelt",
          "comments": 5,
          "content_type": "Video",
          "datetime": "2024-11-06T13:01:12.000Z",
          "id": "3495348313982605954",
          "image_url": "https://scontent-dfw5-1.cdninstagram.com/v/t51.71878-15/504211000_1111075530847029_6819244619431359412_n.jpg?stp=dst-jpg_e15_tt6&_nc_ht=scontent-dfw5-1.cdninstagram.com&_nc_cat=109&_nc_oc=Q6cZ2QH-MUSe6C4PkyFc8saG_6IRC_V3hZ9c7StCViUw-zl5K7a2Qh7u0q29i7etbbV1SI4&_nc_ohc=heyO9GE4JlsQ7kNvwFGOhvN&_nc_gid=f8NLMHfSvJHjKW7CNjdR5w&edm=AOQ1c0wBAAAA&ccb=7-5&oh=00_AfyNVgaEmlBsmZcJ8ZLetflfbX0IbHpSFLa21YNcV-oLoA&oe=69BCE5A5&_nc_sid=8b3546",
          "is_pinned": false,
          "likes": 47,
          "location": {
            "has_public_page": null,
            "id": null,
            "name": null,
            "slug": null
          },
          "post_hashtags": [
            "irishpodcast",
            "brainmelt"
          ],
          "url": "https://www.instagram.com/p/DCB-MW9MZqC",
          "video_url": "https://scontent-dfw6-1.cdninstagram.com/o1/v/t2/f2/m367/AQNC9pTSh_sqrA-fhRMmhTUPsv-xrcuqgUEQScc1hUi7SBjj25GcbBoVf_NhjuetkQJhS0LduAJJfqz_Me4Kk3z5CX3qqgUtF3K282A.mp4?_nc_cat=101&_nc_sid=5e9851&_nc_ht=scontent-dfw6-1.cdninstagram.com&_nc_ohc=fKCWP4nLTc4Q7kNvwGRtcmn&efg=eyJ2ZW5jb2RlX3RhZyI6Inhwdl9wcm9ncmVzc2l2ZS5JTlNUQUdSQU0uQ0xJUFMuQzMuNzIwLmRhc2hfYmFzZWxpbmVfMV92MSIsInhwdl9hc3NldF9pZCI6OTY1MDc1OTg4NzgwMzE4LCJhc3NldF9hZ2VfZGF5cyI6NDk0LCJ2aV91c2VjYXNlX2lkIjoxMDA5OSwiZHVyYXRpb25fcyI6MjMsInVybGdlbl9zb3VyY2UiOiJ3d3cifQ%3D%3D&ccb=17-1&_nc_gid=f8NLMHfSvJHjKW7CNjdR5w&_nc_ss=8&_nc_zt=28&vs=ed3daf27ab696a71&_nc_vs=HBksFQIYQGlnX2VwaGVtZXJhbC8xMzQzOTZBRTEyMDg4RDg2MTYzQjIxQkEyMTM0MUVBOV92aWRlb19kYXNoaW5pdC5tcDQVAALIARIAFQIYR2lnX3hwdl9yZWVsc19wZXJtYW5lbnRfc3JfcHJvZC8xMDk1MDkzODgyMTI2MTkyXzg4Njc1NDA2NTc4NDE0MDA5NzMubXA0FQICyAESACgAGAAbAogHdXNlX29pbAExEnByb2dyZXNzaXZlX3JlY2lwZQExFQAAJrzU8Lfo7rYDFQIoAkMzLBdAN7MzMzMzMxgSZGFzaF9iYXNlbGluZV8xX3YxEQB1_gdl5p0BAA&oh=00_AfzX-ow_DcwGwG-N-wJRo2wUhFiBQWG9HH74zasp7_xKdg&oe=69BCE9BA"
        }
      ],
      "profile_image_link": "htt***//s***ten*********cdn*********************885************************************************************************************************************************************************************************************************************************************************************************************************************************************************************************************************************************************************************",
      "profile_url": "htt***//i***agr*********nny************",
      "profile_name": "Jenny K***y",
      "highlights_count": 1,
      "highlights": [
        {
          "highlight_url": "https://www.instagram.com/stories/highlights/18026550763647585",
          "id": "18026550763647585",
          "image": "https://scontent-atl3-3.cdninstagram.com/v/t51.82787-15/573732645_18127616266495367_3673315206062571981_n.jpg?stp=c0.455.1170.1170a_dst-jpg_e15_s150x150_tt6&_nc_ht=scontent-atl3-3.cdninstagram.com&_nc_cat=111&_nc_oc=Q6cZ2QEE4OreRXzcQ2CqfikRW1dKnGrkuowmELfFxSlLCv0wKApkCk_6Wcbln6C2erPd-Xo&_nc_ohc=pr5PJJAmFYkQ7kNvwGad141&_nc_gid=uQYUd6X3lmUi--ZasXrx5A&edm=AGXveE0BAAAA&ccb=7-5&oh=00_AfxIP7Y-MDVbXrKf1PFIq3qOQemwInWjCDquh1v-Zuc0qQ&oe=69BCC45C&_nc_sid=522435",
          "owner": "jennykelly1972",
          "title": "📚"
        }
      ],
      "full_name": "Jenny K***y",
      "is_private": false,
      "bio_hashtags": null,
      "url": "https://www.instagram.com/jennykelly1972/",
      "is_joined_recently": false,
      "has_channel": false,
      "partner_id": "5087052934",
      "business_address": null,
      "related_accounts": [],
      "email_address": "jen***dar***ail******",
      "external_url_title": {
        "title": null,
        "url": null
      },
      "pronouns": null
    }
  ]
  ```
</ResponseExample>


# Discover by username
Source: https://docs.brightdata.com/api-reference/scrapers/social-media-apis/instagram-profiles-discover-by-username

POST https://api.brightdata.com/datasets/v3/scrape
Use the Bright Data Web Scraper API to discover by Username. POST /datasets/v3/scrape starts a scraping job that returns the data as structured JSON records.

## Query Parameters

<ParamField type="string">
  The dataset ID used for this request.

  <Warning>
    Must be set to `gd_l1vikfch901nx3by4` to collect **Discover by Username** data.
  </Warning>
</ParamField>

<ParamField type="string">
  Must be set to `discover_new`.
</ParamField>

<ParamField type="string">
  Must be set to `user_name`.
</ParamField>

<ParamField type="boolean">
  Whether to send notifications when the request is completed.
</ParamField>

<ParamField type="boolean">
  Whether to include errors in the response.
</ParamField>

## Request Body

<ParamField type="object[]">
  An array of input objects.

  <Expandable title="properties">
    <ParamField type="string">
      The username of the Instagram profile.
    </ParamField>
  </Expandable>

  #### Example

  ```json wrap theme={null}
  {
    "input": [
      {"user_name": "zoobarcelona"}
    ]
  }
  ```
</ParamField>

## Response

<ResponseExample>
  ```json 200 theme={null}
  [
    {
      "account": "jen***ell***72",
      "fbid": "17841405188025881",
      "id": "5087052934",
      "followers": 7938,
      "posts_count": 835,
      "is_business_account": false,
      "is_professional_account": false,
      "is_verified": false,
      "avg_engagement": 0.0582,
      "external_url": null,
      "biography": "Pod: @raydarcydaily \nemail: jenny@darcydaily.com",
      "business_category_name": null,
      "category_name": null,
      "post_hashtags": null,
      "following": 2520,
      "posts": [
        {
          "caption": "BEING HUMAN - A six part series where Ray chats to 6 well known Irish people about what it means to be human. \n\nFirst episode Wednesday 18th March, and every Wednesday after.\n\nA What Next Production\nPresented by Ray D’Arcy\nProduced by Jenny Kelly\n\n#beinghuman \n#podcast \n#irishpodcast",
          "comments": 2,
          "content_type": "Video",
          "datetime": "2026-03-12T11:52:08.000Z",
          "id": "3851176228498036124",
          "image_url": "https://scontent-dfw5-2.cdninstagram.com/v/t51.82787-15/651142041_18334056292172935_8112879477358850984_n.jpg?stp=dst-jpg_e15_tt6&_nc_ht=scontent-dfw5-2.cdninstagram.com&_nc_cat=107&_nc_oc=Q6cZ2QH-MUSe6C4PkyFc8saG_6IRC_V3hZ9c7StCViUw-zl5K7a2Qh7u0q29i7etbbV1SI4&_nc_ohc=W4Jy7OhEd8MQ7kNvwFBSQNv&_nc_gid=f8NLMHfSvJHjKW7CNjdR5w&edm=AOQ1c0wBAAAA&ccb=7-5&oh=00_Afwe_S8Bh8FtoL_RtvxoQ6RF2c20beQzWeLfJfizNBlciQ&oe=69BCEC94&_nc_sid=8b3546",
          "is_pinned": false,
          "likes": 36,
          "location": {
            "has_public_page": null,
            "id": null,
            "name": null,
            "slug": null
          },
          "post_hashtags": [
            "beinghuman",
            "podcast",
            "irishpodcast"
          ],
          "url": "https://www.instagram.com/p/DVyIGAbDdWc",
          "video_url": "https://scontent-dfw6-1.cdninstagram.com/o1/v/t16/f2/m69/AQMSgH9bCDeY_VmVFTYEzrv9RMglEw0prtVd_QFRgC21aFXJ10hPg07pPxQ6VZdxe1vFeVnYABQlz2zcpXVrQqfV.mp4?strext=1&_nc_cat=103&_nc_sid=5e9851&_nc_ht=scontent-dfw6-1.cdninstagram.com&_nc_ohc=F9Tybdk82ZQQ7kNvwGJ2sbT&efg=eyJ2ZW5jb2RlX3RhZyI6Inhwdl9wcm9ncmVzc2l2ZS5JTlNUQUdSQU0uQ0xJUFMuQzMuNDgwLmRhc2hfYmFzZWxpbmVfMV92MSIsInhwdl9hc3NldF9pZCI6MTgzMzQwNTU2MDgxNzI5MzUsImFzc2V0X2FnZV9kYXlzIjozLCJ2aV91c2VjYXNlX2lkIjoxMDA5OSwiZHVyYXRpb25fcyI6MTE3LCJ1cmxnZW5fc291cmNlIjoid3d3In0%3D&ccb=17-1&_nc_gid=f8NLMHfSvJHjKW7CNjdR5w&_nc_ss=8&_nc_zt=28&vs=672fccf82fe0dcbe&_nc_vs=HBksFQIYOnBhc3N0aHJvdWdoX2V2ZXJzdG9yZS9HUGlMdHlhY29GUzFoRFFEQU9udTlRZ1ByVDFKYnNwVEFRQUYVAALIARIAFQIYUWlnX3hwdl9wbGFjZW1lbnRfcGVybWFuZW50X3YyL0E5NEZGMjZCMjU0OTFERkZBNzYzQjU2NDhBOUM5QThGX2F1ZGlvX2Rhc2hpbml0Lm1wNBUCAsgBEgAoABgAGwKIB3VzZV9vaWwBMRJwcm9ncmVzc2l2ZV9yZWNpcGUBMRUAACaOhor9vq6RQRUCKAJDMywXQF1AAAAAAAAYEmRhc2hfYmFzZWxpbmVfMV92MREAdf4HZeadAQA&oh=00_AfyDY32lp2KMgYLDKEK7Wx7ocPFPwwhGkiuWvBKwB_joLg&oe=69BCCEE9"
        },
        {
          "caption": "Our brand new daily podcast is starting tomorrow \n\nRay D’Arcy Daily \n\nWherever you get your podcasts.\n\nEmail us ray@darcydaily.com\n#podcast #irishpodcast",
          "comments": 86,
          "content_type": "Video",
          "datetime": "2026-03-08T16:21:04.000Z",
          "id": "3848412628930911784",
          "image_url": "https://scontent-dfw5-1.cdninstagram.com/v/t51.71878-15/649327000_1860456074651243_3014167701283875235_n.jpg?stp=dst-jpg_e15_tt6&_nc_ht=scontent-dfw5-1.cdninstagram.com&_nc_cat=111&_nc_oc=Q6cZ2QH-MUSe6C4PkyFc8saG_6IRC_V3hZ9c7StCViUw-zl5K7a2Qh7u0q29i7etbbV1SI4&_nc_ohc=b0EoQkmauKkQ7kNvwGZzfjq&_nc_gid=f8NLMHfSvJHjKW7CNjdR5w&edm=AOQ1c0wBAAAA&ccb=7-5&oh=00_AfxQfU7Ocg9M26vOgYlA3m4oy4cpmvDY9859u4P35lUqng&oe=69BCEFC3&_nc_sid=8b3546",
          "is_pinned": false,
          "likes": 992,
          "location": {
            "has_public_page": null,
            "id": null,
            "name": null,
            "slug": null
          },
          "post_hashtags": [
            "podcast",
            "irishpodcast"
          ],
          "url": "https://www.instagram.com/p/DVoTuVwjd4o",
          "video_url": "https://scontent-dfw5-2.cdninstagram.com/o1/v/t16/f2/m69/AQNqwbuRAKLUvBo_BRm3bnGbIV2EPYfXffZLw2f3swiqVgfVNN31xLUjJYzBUmk31ks69X_8_c7EKmCelHv_buYH.mp4?strext=1&_nc_cat=104&_nc_sid=5e9851&_nc_ht=scontent-dfw5-2.cdninstagram.com&_nc_ohc=iuf2XH_4eaAQ7kNvwGQqv3J&efg=eyJ2ZW5jb2RlX3RhZyI6Inhwdl9wcm9ncmVzc2l2ZS5JTlNUQUdSQU0uQ0xJUFMuQzMuNzIwLmRhc2hfYmFzZWxpbmVfMV92MSIsInhwdl9hc3NldF9pZCI6MTgzMzM2MzkxNzIxNzI5MzUsImFzc2V0X2FnZV9kYXlzIjo3LCJ2aV91c2VjYXNlX2lkIjoxMDA5OSwiZHVyYXRpb25fcyI6NjAsInVybGdlbl9zb3VyY2UiOiJ3d3cifQ%3D%3D&ccb=17-1&_nc_gid=f8NLMHfSvJHjKW7CNjdR5w&_nc_ss=8&_nc_zt=28&vs=ce88cc19b1c12270&_nc_vs=HBksFQIYOnBhc3N0aHJvdWdoX2V2ZXJzdG9yZS9HSVhrcWlhdEZTUTBGLTBFQUNGU2oydVRFWlZ4YnNwVEFRQUYVAALIARIAFQIYUWlnX3hwdl9wbGFjZW1lbnRfcGVybWFuZW50X3YyLzIwNEVCQTgxMTJEMkM2ODRBNzFEREU0RTQwNTBFQThDX2F1ZGlvX2Rhc2hpbml0Lm1wNBUCAsgBEgAoABgAGwKIB3VzZV9vaWwBMRJwcm9ncmVzc2l2ZV9yZWNpcGUBMRUAACaOsuGkoJaRQRUCKAJDMywXQE464UeuFHsYEmRhc2hfYmFzZWxpbmVfMV92MREAdf4HZeadAQA&oh=00_AfzE-98jZ3zhfaRZuLxlWwz5GmrjBpxgERbFaOjPj7UIrw&oe=69BCCCA4"
        },
        {
          "caption": "We have some news! \n\nRAY D’ARCY DAILY - your daily podcast. \n\nThis five day a week show is nothing new, and yet ALL NEW. It’s Monday to Friday with Ray giving his own world view while surrounded by friends of the show, Jenny Kelly (that’s me 🤪), Mairead Ronan and Bernard O’Shea to name a few. \n\nWe hope you’ll join us. \nStarting Monday 9th. \n\nFollow the show now to make sure you never miss an episode. \n\nListen wherever you get your Podcasts #irishpodcast #podcast \n@cocomairead @bernardo.oshea @acast",
          "comments": 166,
          "content_type": "Video",
          "datetime": "2026-03-02T13:25:41.000Z",
          "id": "3843977898726623596",
          "image_url": "https://scontent-dfw5-1.cdninstagram.com/v/t51.71878-15/641425914_1446430403853586_8943556578413069821_n.jpg?stp=dst-jpg_e15_tt6&_nc_ht=scontent-dfw5-1.cdninstagram.com&_nc_cat=110&_nc_oc=Q6cZ2QH-MUSe6C4PkyFc8saG_6IRC_V3hZ9c7StCViUw-zl5K7a2Qh7u0q29i7etbbV1SI4&_nc_ohc=j-4QNAsV4yEQ7kNvwEWKOeO&_nc_gid=f8NLMHfSvJHjKW7CNjdR5w&edm=AOQ1c0wBAAAA&ccb=7-5&oh=00_Afy2MQCg7ccEpt8gZNJowsCxi2k7fkX141C5dFU-dvfEfg&oe=69BCC84E&_nc_sid=8b3546",
          "is_pinned": false,
          "likes": 1158,
          "location": {
            "has_public_page": null,
            "id": null,
            "name": null,
            "slug": null
          },
          "post_hashtags": [
            "irishpodcast",
            "podcast"
          ],
          "url": "https://www.instagram.com/p/DVYjYhaDYls",
          "video_url": "https://scontent-dfw6-1.cdninstagram.com/o1/v/t16/f2/m69/AQM_D-LpDwCPxPZrnXzoyfkknE8jP_GwRpGwtEvjefP4KUFo7dAEFZ51YD7Nn6-NLnnVLm3sIF5e7jbT_ImFtRri.mp4?strext=1&_nc_cat=103&_nc_sid=5e9851&_nc_ht=scontent-dfw6-1.cdninstagram.com&_nc_ohc=-FdPzVISP18Q7kNvwEcVVkv&efg=eyJ2ZW5jb2RlX3RhZyI6Inhwdl9wcm9ncmVzc2l2ZS5JTlNUQUdSQU0uQ0xJUFMuQzMuNzIwLmRhc2hfYmFzZWxpbmVfMV92MSIsInhwdl9hc3NldF9pZCI6MTgzMzMwNTA3OTExNzI5MzUsImFzc2V0X2FnZV9kYXlzIjoxMywidmlfdXNlY2FzZV9pZCI6MTAwOTksImR1cmF0aW9uX3MiOjE0MSwidXJsZ2VuX3NvdXJjZSI6Ind3dyJ9&ccb=17-1&_nc_gid=f8NLMHfSvJHjKW7CNjdR5w&_nc_ss=8&_nc_zt=28&vs=54251b7443d07334&_nc_vs=HBksFQIYOnBhc3N0aHJvdWdoX2V2ZXJzdG9yZS9HSnlFZHlhaTdRb2U1SmtFQURXYkJFSjd5XzEwYnNwVEFRQUYVAALIARIAFQIYUWlnX3hwdl9wbGFjZW1lbnRfcGVybWFuZW50X3YyLzEyNEU2RjhEQkU4M0NCQ0Y3NEU5Njk2Q0I0NTJDRkIxX2F1ZGlvX2Rhc2hpbml0Lm1wNBUCAsgBEgAoABgAGwKIB3VzZV9vaWwBMRJwcm9ncmVzc2l2ZV9yZWNpcGUBMRUAACaO7fTAgPSQQRUCKAJDMywXQGGqp--dsi0YEmRhc2hfYmFzZWxpbmVfMV92MREAdf4HZeadAQA&oh=00_AfxknzHbQifAj5YoGVzxwXn2cPKeVRcRrdXbooIhlD8ZBQ&oe=69BCDC41"
        },
        {
          "caption": "PODCAST NEWS 📢\n\nAfter 3 years we have made the decision to hang up our ‘Jenny and Mairéad NOW' mics. \n\nWe have LOVED doing it. 💕\n\nWe re-connected with so many listeners from our radio days and got lots of new listeners along the way. We want to thank you for all the laughs and life stories you’ve shared with us. \n\nWe both have new commitments that we are diving into, so for today, we'll say ‘so long for now’ 💫 \n\nLots of love, \nJenny and Mairéad \nXx \n\nPS..leave your lips alone, buy a spray mop and remember… \"you’ll be dead forever”",
          "comments": 158,
          "content_type": "Image",
          "datetime": "2025-09-24T17:50:53.000Z",
          "id": "3728872417469969396",
          "image_url": "https://scontent-dfw5-2.cdninstagram.com/v/t51.82787-15/553161422_17973649637947844_5055340064665934469_n.webp?stp=dst-jpg_e35_s1080x1080_sh0.08_tt6&_nc_ht=scontent-dfw5-2.cdninstagram.com&_nc_cat=108&_nc_oc=Q6cZ2QH-MUSe6C4PkyFc8saG_6IRC_V3hZ9c7StCViUw-zl5K7a2Qh7u0q29i7etbbV1SI4&_nc_ohc=0IDMJZLADZgQ7kNvwGBZl2R&_nc_gid=f8NLMHfSvJHjKW7CNjdR5w&edm=AOQ1c0wBAAAA&ccb=7-5&oh=00_AfxVGERnGo1gjS9N7F4Hvi14Ek0zIbXq_m_2vnk8p1c0mQ&oe=69BCDBC8&_nc_sid=8b3546",
          "is_pinned": false,
          "likes": 1572,
          "location": {
            "has_public_page": null,
            "id": null,
            "name": null,
            "slug": null
          },
          "post_hashtags": null,
          "url": "https://www.instagram.com/p/DO_nbUQDLP0",
          "video_url": null
        },
        {
          "caption": "I COULD have been a camogie player (never played in my life 🤣), and @cocomairead COULD have been a pop star … what COULD you have been? \n\nPodcast out tomorrow 6am #irishpodcast #podcast #jennyandmaireadnow",
          "comments": null,
          "content_type": "Video",
          "datetime": "2025-04-29T21:44:06.000Z",
          "id": "3621719997521697568",
          "image_url": "https://scontent-dfw6-1.cdninstagram.com/v/t51.71878-15/491461907_976222424658362_5118993394906495251_n.jpg?stp=dst-jpg_e15_tt6&_nc_ht=scontent-dfw6-1.cdninstagram.com&_nc_cat=102&_nc_oc=Q6cZ2QH-MUSe6C4PkyFc8saG_6IRC_V3hZ9c7StCViUw-zl5K7a2Qh7u0q29i7etbbV1SI4&_nc_ohc=fdEBmapVjIYQ7kNvwH9d2ns&_nc_gid=f8NLMHfSvJHjKW7CNjdR5w&edm=AOQ1c0wBAAAA&ccb=7-5&oh=00_Afz4h2HLZTuYioO61W7aDIMzXCHL34Tv_SD_q5TYfJ99iA&oe=69BCBEDC&_nc_sid=8b3546",
          "is_pinned": false,
          "likes": 62,
          "location": {
            "has_public_page": null,
            "id": null,
            "name": null,
            "slug": null
          },
          "post_hashtags": [
            "irishpodcast",
            "podcast",
            "jennyandmaireadnow"
          ],
          "url": "https://www.instagram.com/p/DJC7yYoNZsg",
          "video_url": "https://scontent-dfw5-2.cdninstagram.com/o1/v/t2/f2/m367/AQNdTe3n8U7HJAUZPYQ2IKytrTScEjIa2LVv7p-gcs7bfH2WDHkU1GuQ63tg4BxPEIFCVKgn-k9soAiz09MH_R_ORdQFWDf5N2MPRLY.mp4?_nc_cat=104&_nc_sid=5e9851&_nc_ht=scontent-dfw5-2.cdninstagram.com&_nc_ohc=Syer777RuQMQ7kNvwEmKdhm&efg=eyJ2ZW5jb2RlX3RhZyI6Inhwdl9wcm9ncmVzc2l2ZS5JTlNUQUdSQU0uQ0xJUFMuQzMuNDgwLmRhc2hfYmFzZWxpbmVfMV92MSIsInhwdl9hc3NldF9pZCI6MTU5NDc3ODcyNzg2ODYyNywiYXNzZXRfYWdlX2RheXMiOjMxOSwidmlfdXNlY2FzZV9pZCI6MTAwOTksImR1cmF0aW9uX3MiOjY5LCJ1cmxnZW5fc291cmNlIjoid3d3In0%3D&ccb=17-1&_nc_gid=f8NLMHfSvJHjKW7CNjdR5w&_nc_ss=8&_nc_zt=28&vs=1d3eb966c62b0ed0&_nc_vs=HBksFQIYQGlnX2VwaGVtZXJhbC8zMTRBRkNEOTM4NTM5NjI2MzhBMUQwQ0QxNDk2QzE4QV92aWRlb19kYXNoaW5pdC5tcDQVAALIARIAFQIYRmlnX3hwdl9yZWVsc19wZXJtYW5lbnRfc3JfcHJvZC8xMjE3ODU0OTYzMjg1ODY0Xzk0ODMzNjE1ODI3NjU5Njg3OC5tcDQVAgLIARIAKAAYABsCiAd1c2Vfb2lsATEScHJvZ3Jlc3NpdmVfcmVjaXBlATEVAAAmpqOPuauc1QUVAigCQzMsF0BRUQYk3S8bGBJkYXNoX2Jhc2VsaW5lXzFfdjERAHX-B2XmnQEA&oh=00_AfxYnVqq-YPFAKEW8CVj-CJBIvyL0qQSOxuzTNCksnr_Sg&oe=69BCE24D"
        },
        {
          "caption": "Podcast @jennyandmaireadnow out tomorrow 6am \n\n✨Mairead needs help\n✨Netflix Doc: Buy Now!\n✨2025 Manifesto\n✨Colour and word of the year \n✨Debutant Balls and Feis\n\nThanks to our sponsor @vhi_ie \n#irishpodcast #podcast #friendship",
          "comments": null,
          "content_type": "Video",
          "datetime": "2024-12-10T21:36:11.000Z",
          "id": "3520245279648780747",
          "image_url": "https://scontent-dfw5-2.cdninstagram.com/v/t51.2885-15/469729187_18286176577172935_8198072792922023263_n.jpg?stp=dst-jpg_e15_tt6&_nc_ht=scontent-dfw5-2.cdninstagram.com&_nc_cat=107&_nc_oc=Q6cZ2QH-MUSe6C4PkyFc8saG_6IRC_V3hZ9c7StCViUw-zl5K7a2Qh7u0q29i7etbbV1SI4&_nc_ohc=skhiJmD75-kQ7kNvwEeKZA6&_nc_gid=f8NLMHfSvJHjKW7CNjdR5w&edm=AOQ1c0wBAAAA&ccb=7-5&oh=00_AfzWsdPI0aqqm2_IHDtzlIqHu2mL76RyRwvUBMetthP-hg&oe=69BCCDF6&_nc_sid=8b3546",
          "is_pinned": false,
          "likes": 64,
          "location": {
            "has_public_page": null,
            "id": null,
            "name": null,
            "slug": null
          },
          "post_hashtags": [
            "irishpodcast",
            "podcast",
            "friendship"
          ],
          "url": "https://www.instagram.com/p/DDabG5HthHL",
          "video_url": "https://scontent-dfw5-1.cdninstagram.com/o1/v/t2/f2/m367/AQMy1Odi0RhpjgXggsSeeNNxmcDcNt0_X6IYxlCD21k4z4h46ndGKxoNjJIRjVg94CuujC1j-CiG89HT8-O9C-XPAl_3C_7p3GqzZ5M.mp4?_nc_cat=109&_nc_sid=5e9851&_nc_ht=scontent-dfw5-1.cdninstagram.com&_nc_ohc=zEKeRBdP2mAQ7kNvwENzKpk&efg=eyJ2ZW5jb2RlX3RhZyI6Inhwdl9wcm9ncmVzc2l2ZS5JTlNUQUdSQU0uQ0xJUFMuQzMuNzIwLmRhc2hfYmFzZWxpbmVfMV92MSIsInhwdl9hc3NldF9pZCI6MTIzMzY5MjkwNzcxNjE1MSwiYXNzZXRfYWdlX2RheXMiOjQ1OSwidmlfdXNlY2FzZV9pZCI6MTAwOTksImR1cmF0aW9uX3MiOjUxLCJ1cmxnZW5fc291cmNlIjoid3d3In0%3D&ccb=17-1&_nc_gid=f8NLMHfSvJHjKW7CNjdR5w&_nc_ss=8&_nc_zt=28&vs=be7ed278cb04ea95&_nc_vs=HBksFQIYQGlnX2VwaGVtZXJhbC9BQjQyNThCNTU0QTJGNEIxODg3NjlBQUJFMDNDMzU4Q192aWRlb19kYXNoaW5pdC5tcDQVAALIARIAFQIYRmlnX3hwdl9yZWVsc19wZXJtYW5lbnRfc3JfcHJvZC8xNTAyMTIxNTUwNzQwNjE0Xzc5ODkxODI2NzE3NDU1MDEwNy5tcDQVAgLIARIAKAAYABsCiAd1c2Vfb2lsATEScHJvZ3Jlc3NpdmVfcmVjaXBlATEVAAAm7vi1uLCCsQQVAigCQzMsF0BJmZmZmZmaGBJkYXNoX2Jhc2VsaW5lXzFfdjERAHX-B2XmnQEA&oh=00_Afzvy10txzkdt9h08tJs_9VMlJicQjSggsPEZ61LEdGYmA&oe=69BCC63E"
        },
        {
          "caption": "This book took me a few weeks to read and it’s only 136 pages long. I could quite easily go back now and start it all over again. One of the most beautiful books I’ve read. It tells the story of 24 hours in the lives of 6 astronauts on the international space station. Each of the 16 chapters takes in one orbit of earth. It’s difficult to describe just how profound and touching this small book is. A love letter to Earth. It made me feel both sad and hopeful at the same time. I read that the author Samantha Harvey stopped writing half way through because she felt she didn’t have the right to write a book like this, so removed was it from her real life. I’m so glad she ignored that voice in her head because this book is something we will read for years and years to come. Stunning.",
          "comments": 6,
          "content_type": "Image",
          "datetime": "2024-12-04T19:34:23.000Z",
          "id": "3515840447256809542",
          "image_url": "https://scontent-dfw6-1.cdninstagram.com/v/t51.82787-15/623407206_17991231980916798_8528601805505725054_n.jpg?stp=dst-jpg_e35_p1080x1080_sh0.08_tt6&_nc_ht=scontent-dfw6-1.cdninstagram.com&_nc_cat=106&_nc_oc=Q6cZ2QH-MUSe6C4PkyFc8saG_6IRC_V3hZ9c7StCViUw-zl5K7a2Qh7u0q29i7etbbV1SI4&_nc_ohc=1jkbYPze7PIQ7kNvwFhqTAc&_nc_gid=f8NLMHfSvJHjKW7CNjdR5w&edm=AOQ1c0wBAAAA&ccb=7-5&oh=00_Afzg1e_fEK30evjHAzSP597UW_USGzLTBIj1k-EIjQQMfA&oe=69BCCA41&_nc_sid=8b3546",
          "is_pinned": false,
          "likes": 109,
          "location": {
            "has_public_page": null,
            "id": null,
            "name": null,
            "slug": null
          },
          "post_hashtags": null,
          "url": "https://www.instagram.com/p/DDKxkJRsVBG",
          "video_url": null
        },
        {
          "caption": "Pod out Wednesday 6am\n\n✨Kissing 💋\n✨Christmas Movies 🎬\n✨family traditions 🏡\n✨Nits 🦗\n\nThanks to our sponsor @vhi_ie",
          "comments": 1,
          "content_type": "Video",
          "datetime": "2024-12-03T21:00:59.000Z",
          "id": "3515158122554635287",
          "image_url": "https://scontent-dfw5-2.cdninstagram.com/v/t51.71878-15/503975082_1908008223345944_5512368651421990898_n.jpg?stp=dst-jpg_e15_tt6&_nc_ht=scontent-dfw5-2.cdninstagram.com&_nc_cat=108&_nc_oc=Q6cZ2QH-MUSe6C4PkyFc8saG_6IRC_V3hZ9c7StCViUw-zl5K7a2Qh7u0q29i7etbbV1SI4&_nc_ohc=LBreF5ALN2IQ7kNvwE_RtAb&_nc_gid=f8NLMHfSvJHjKW7CNjdR5w&edm=AOQ1c0wBAAAA&ccb=7-5&oh=00_AfzmTzT-OfgwVOhOYS62CUgEdWcUX2YsW20KyaTEXiv3Gg&oe=69BCD350&_nc_sid=8b3546",
          "is_pinned": false,
          "likes": 27,
          "location": {
            "has_public_page": null,
            "id": null,
            "name": null,
            "slug": null
          },
          "post_hashtags": null,
          "url": "https://www.instagram.com/p/DDIWbA4MrQX",
          "video_url": "https://scontent-dfw5-2.cdninstagram.com/o1/v/t2/f2/m367/AQNO52R4NspLq6_HyhxNcCLUQtKiP7dXhYXNEIO3IjvmzKdyZMS_YYgB2zRkbZs4SLFVBOdJpB3L19p9-zxxOyqHp9Lk-fOum-vlUa4.mp4?_nc_cat=107&_nc_sid=5e9851&_nc_ht=scontent-dfw5-2.cdninstagram.com&_nc_ohc=eyaMjy3BLs8Q7kNvwFAQ_2h&efg=eyJ2ZW5jb2RlX3RhZyI6Inhwdl9wcm9ncmVzc2l2ZS5JTlNUQUdSQU0uQ0xJUFMuQzMuNzIwLmRhc2hfYmFzZWxpbmVfMV92MSIsInhwdl9hc3NldF9pZCI6MTc3MTU2NjI2MDMyMzQ3NSwiYXNzZXRfYWdlX2RheXMiOjQ2NiwidmlfdXNlY2FzZV9pZCI6MTAwOTksImR1cmF0aW9uX3MiOjQ5LCJ1cmxnZW5fc291cmNlIjoid3d3In0%3D&ccb=17-1&_nc_gid=f8NLMHfSvJHjKW7CNjdR5w&_nc_ss=8&_nc_zt=28&vs=4e62294db6b90ea0&_nc_vs=HBksFQIYQGlnX2VwaGVtZXJhbC82NTRENUM0OTczREYzNDQ0MzFDQTExRDQxRTY0RUI5Rl92aWRlb19kYXNoaW5pdC5tcDQVAALIARIAFQIYRmlnX3hwdl9yZWVsc19wZXJtYW5lbnRfc3JfcHJvZC8xMTYwODk0Nzg1Mzk1ODg1XzgyNDkxMDM2OTY3NjU4NTg4MS5tcDQVAgLIARIAKAAYABsCiAd1c2Vfb2lsATEScHJvZ3Jlc3NpdmVfcmVjaXBlATEVAAAmppKkmt3OpQYVAigCQzMsF0BI7tkWhysCGBJkYXNoX2Jhc2VsaW5lXzFfdjERAHX-B2XmnQEA&oh=00_AfxxoxyLQuVwyz2uioRVM08hneqBb3CfGndyLkviQkDqVw&oe=69BCE6C8"
        },
        {
          "caption": "Podcast out NOW ✨\n\nWe really enjoyed our chat with @michealmartintd \n\n✨telepathy between him and his wife\n✨the ingredients to his perfect salad\n✨book club inspiration \n✨what he REALLY wanted to be when he grew up \n\n#jennyandmaireadnow #whatweknownow #irishpodcasts #friendship #collabrativestudio",
          "comments": 29,
          "content_type": "Video",
          "datetime": "2024-11-13T11:36:18.000Z",
          "id": "3500373609463083880",
          "image_url": "https://scontent-dfw5-2.cdninstagram.com/v/t51.2885-15/466773911_17936241830947844_3117143642697548716_n.jpg?stp=dst-jpg_e15_tt6&_nc_ht=scontent-dfw5-2.cdninstagram.com&_nc_cat=108&_nc_oc=Q6cZ2QH-MUSe6C4PkyFc8saG_6IRC_V3hZ9c7StCViUw-zl5K7a2Qh7u0q29i7etbbV1SI4&_nc_ohc=1pwaOyShnGoQ7kNvwGsRorU&_nc_gid=f8NLMHfSvJHjKW7CNjdR5w&edm=AOQ1c0wBAAAA&ccb=7-5&oh=00_AfxMIFfgprmdzKi-AErgzTmN3E-gzqKmuT2QhUQC1TC7NQ&oe=69BCD28B&_nc_sid=8b3546",
          "is_pinned": false,
          "likes": 197,
          "location": {
            "has_public_page": null,
            "id": null,
            "name": null,
            "slug": null
          },
          "post_hashtags": [
            "jennyandmaireadnow",
            "whatweknownow",
            "irishpodcasts",
            "friendship",
            "collabrativestudio"
          ],
          "url": "https://www.instagram.com/p/DCT00CFMvNo",
          "video_url": "https://scontent-dfw5-1.cdninstagram.com/o1/v/t2/f2/m367/AQNLvylMFRY6P74zmh9wwvuEJ7rtO-sItj8FJLT2nSb_PeMIpJmOm8SkfRH64lOCNztgBnZpZ-XoKhrc8CItJtQKS1Mut4lfPZFXbj8.mp4?_nc_cat=110&_nc_sid=5e9851&_nc_ht=scontent-dfw5-1.cdninstagram.com&_nc_ohc=qIweWDr6GKEQ7kNvwHO-YZz&efg=eyJ2ZW5jb2RlX3RhZyI6Inhwdl9wcm9ncmVzc2l2ZS5JTlNUQUdSQU0uQ0xJUFMuQzMuNzIwLmRhc2hfYmFzZWxpbmVfMV92MSIsInhwdl9hc3NldF9pZCI6MzkwMzA5NDY3MzI4MjA3MiwiYXNzZXRfYWdlX2RheXMiOjQ4NywidmlfdXNlY2FzZV9pZCI6MTAwOTksImR1cmF0aW9uX3MiOjQzLCJ1cmxnZW5fc291cmNlIjoid3d3In0%3D&ccb=17-1&_nc_gid=f8NLMHfSvJHjKW7CNjdR5w&_nc_ss=8&_nc_zt=28&vs=15624de47fd39130&_nc_vs=HBksFQIYQGlnX2VwaGVtZXJhbC8yOTQ3MDYwMDcyNEI5QTQ4Njk2RDIzNUNCQjZGNzI5MV92aWRlb19kYXNoaW5pdC5tcDQVAALIARIAFQIYR2lnX3hwdl9yZWVsc19wZXJtYW5lbnRfc3JfcHJvZC8xMzIyMTQ3MTEyNDk4NDU0Xzg1NDM2NTk1NDU5NDg0NjEyNjYubXA0FQICyAESACgAGAAbAogHdXNlX29pbAExEnByb2dyZXNzaXZlX3JlY2lwZQExFQAAJrDQtLiB9u4NFQIoAkMzLBdARfMzMzMzMxgSZGFzaF9iYXNlbGluZV8xX3YxEQB1_gdl5p0BAA&oh=00_Afx5DWMCHEDJoObUP3-Lb7Hu9-RkPZteuaVDucxzxkaVtg&oe=69BCD8B3"
        },
        {
          "caption": "🎙️Bit of a different podcast for you this week! \n\nWe sat down with Tánaiste @michealmartintd and asked him ‘What He Knows Now.\n\n✨Life lessons that have got him this far. \n✨Friendships, family & grief\n✨Sea swimming, dry robes & switching off\n\n Full episode drops tomorrow at 6am wherever you get your podcasts. \n\nJ & M\n\nThank you to our sponsor @vhi_ie \n\n#jennyandmaireadnow #lifelessons #dryrobe  #seaswimming",
          "comments": 25,
          "content_type": "Video",
          "datetime": "2024-11-12T22:26:31.000Z",
          "id": "3499981808361075522",
          "image_url": "https://scontent-dfw5-2.cdninstagram.com/v/t51.71878-15/466690817_552614564296939_1070270335390837149_n.jpg?stp=dst-jpg_e15_tt6&_nc_ht=scontent-dfw5-2.cdninstagram.com&_nc_cat=107&_nc_oc=Q6cZ2QH-MUSe6C4PkyFc8saG_6IRC_V3hZ9c7StCViUw-zl5K7a2Qh7u0q29i7etbbV1SI4&_nc_ohc=4Pn0CaGAEAwQ7kNvwGgi0OG&_nc_gid=f8NLMHfSvJHjKW7CNjdR5w&edm=AOQ1c0wBAAAA&ccb=7-5&oh=00_Afy31s1gWLZgx-uRpeh_veSBHwycbYIjHaSe6e6ghEjJug&oe=69BCCA2F&_nc_sid=8b3546",
          "is_pinned": false,
          "likes": 367,
          "location": {
            "has_public_page": null,
            "id": null,
            "name": null,
            "slug": null
          },
          "post_hashtags": [
            "jennyandmaireadnow",
            "lifelessons",
            "dryrobe",
            "seaswimming"
          ],
          "url": "https://www.instagram.com/p/DCSbuk3sPNC",
          "video_url": "https://scontent-dfw6-1.cdninstagram.com/o1/v/t2/f2/m367/AQOQyKg3hXP5Vbemc9YXLsURych3495OTaZ-k5hA5Ud_bPJkecOs-XoiZXj14XHIu3zOfYzZrFmrf4xdztvyIdI8ID29tB2UCIKdGKQ.mp4?_nc_cat=106&_nc_sid=5e9851&_nc_ht=scontent-dfw6-1.cdninstagram.com&_nc_ohc=xQB7AZzudfwQ7kNvwFSfvDS&efg=eyJ2ZW5jb2RlX3RhZyI6Inhwdl9wcm9ncmVzc2l2ZS5JTlNUQUdSQU0uQ0xJUFMuQzMuNDgwLmRhc2hfYmFzZWxpbmVfMV92MSIsInhwdl9hc3NldF9pZCI6MTEwMzM1MzI5Nzg3MDA1NCwiYXNzZXRfYWdlX2RheXMiOjQ4NywidmlfdXNlY2FzZV9pZCI6MTAwOTksImR1cmF0aW9uX3MiOjM2LCJ1cmxnZW5fc291cmNlIjoid3d3In0%3D&ccb=17-1&vs=52ef0882b0559893&_nc_vs=HBksFQIYQGlnX2VwaGVtZXJhbC9BMzQxREExQUVBNTJCQUUzNDNCMUEyNzNCQ0FFMzNCQl92aWRlb19kYXNoaW5pdC5tcDQVAALIARIAFQIYRmlnX3hwdl9yZWVsc19wZXJtYW5lbnRfc3JfcHJvZC80NTE4MzkyMTEzNTQwNTNfMjIyNDI2NDEzOTg0ODkxMDcwOC5tcDQVAgLIARIAKAAYABsCiAd1c2Vfb2lsATEScHJvZ3Jlc3NpdmVfcmVjaXBlATEVAAAmzPOM1s7f9QMVAigCQzMsF0BB92yLQ5WBGBJkYXNoX2Jhc2VsaW5lXzFfdjERAHX-B2XmnQEA&_nc_gid=f8NLMHfSvJHjKW7CNjdR5w&_nc_ss=8&_nc_zt=28&oh=00_Afxh28JyyPy9AVGT2wQv9pVAJuU58mjJPkCKFeb6f4Oh8w&oe=69BCE4E7"
        },
        {
          "caption": "Did a photoshoot with Stan because he’s just back from the hairdressers and looking so floofy and smelling beautiful 😍 I needed to document his clean smelling look as he will be rolling in some dirt/fox smell/ muck very soon 🤪 #dogsofinstagram #goldenretriever",
          "comments": 12,
          "content_type": "Carousel",
          "datetime": "2024-11-12T15:25:04.000Z",
          "id": "3499769896973330029",
          "image_url": "https://scontent-dfw5-2.cdninstagram.com/v/t51.29350-15/466995326_990526599761200_5153153982064132557_n.jpg?stp=dst-jpg_e35_p1080x1080_tt6&_nc_ht=scontent-dfw5-2.cdninstagram.com&_nc_cat=104&_nc_oc=Q6cZ2QH-MUSe6C4PkyFc8saG_6IRC_V3hZ9c7StCViUw-zl5K7a2Qh7u0q29i7etbbV1SI4&_nc_ohc=UxLUkZuUog8Q7kNvwEC_RWC&_nc_gid=f8NLMHfSvJHjKW7CNjdR5w&edm=AOQ1c0wBAAAA&ccb=7-5&oh=00_AfyUh-GMDlDzUu9nBtb6d8zt0aKqVnKXwgO24rSu4kLSnw&oe=69BCECBC&_nc_sid=8b3546",
          "is_pinned": false,
          "likes": 432,
          "location": {
            "has_public_page": null,
            "id": null,
            "name": null,
            "slug": null
          },
          "post_hashtags": [
            "dogsofinstagram",
            "goldenretriever"
          ],
          "url": "https://www.instagram.com/p/DCRri3As2Zt",
          "video_url": null
        },
        {
          "caption": "Behind the scenes brain melt during podcast recording @jennyandmaireadnow 😆 #irishpodcast #brainmelt",
          "comments": 5,
          "content_type": "Video",
          "datetime": "2024-11-06T13:01:12.000Z",
          "id": "3495348313982605954",
          "image_url": "https://scontent-dfw5-1.cdninstagram.com/v/t51.71878-15/504211000_1111075530847029_6819244619431359412_n.jpg?stp=dst-jpg_e15_tt6&_nc_ht=scontent-dfw5-1.cdninstagram.com&_nc_cat=109&_nc_oc=Q6cZ2QH-MUSe6C4PkyFc8saG_6IRC_V3hZ9c7StCViUw-zl5K7a2Qh7u0q29i7etbbV1SI4&_nc_ohc=heyO9GE4JlsQ7kNvwFGOhvN&_nc_gid=f8NLMHfSvJHjKW7CNjdR5w&edm=AOQ1c0wBAAAA&ccb=7-5&oh=00_AfyNVgaEmlBsmZcJ8ZLetflfbX0IbHpSFLa21YNcV-oLoA&oe=69BCE5A5&_nc_sid=8b3546",
          "is_pinned": false,
          "likes": 47,
          "location": {
            "has_public_page": null,
            "id": null,
            "name": null,
            "slug": null
          },
          "post_hashtags": [
            "irishpodcast",
            "brainmelt"
          ],
          "url": "https://www.instagram.com/p/DCB-MW9MZqC",
          "video_url": "https://scontent-dfw6-1.cdninstagram.com/o1/v/t2/f2/m367/AQNC9pTSh_sqrA-fhRMmhTUPsv-xrcuqgUEQScc1hUi7SBjj25GcbBoVf_NhjuetkQJhS0LduAJJfqz_Me4Kk3z5CX3qqgUtF3K282A.mp4?_nc_cat=101&_nc_sid=5e9851&_nc_ht=scontent-dfw6-1.cdninstagram.com&_nc_ohc=fKCWP4nLTc4Q7kNvwGRtcmn&efg=eyJ2ZW5jb2RlX3RhZyI6Inhwdl9wcm9ncmVzc2l2ZS5JTlNUQUdSQU0uQ0xJUFMuQzMuNzIwLmRhc2hfYmFzZWxpbmVfMV92MSIsInhwdl9hc3NldF9pZCI6OTY1MDc1OTg4NzgwMzE4LCJhc3NldF9hZ2VfZGF5cyI6NDk0LCJ2aV91c2VjYXNlX2lkIjoxMDA5OSwiZHVyYXRpb25fcyI6MjMsInVybGdlbl9zb3VyY2UiOiJ3d3cifQ%3D%3D&ccb=17-1&_nc_gid=f8NLMHfSvJHjKW7CNjdR5w&_nc_ss=8&_nc_zt=28&vs=ed3daf27ab696a71&_nc_vs=HBksFQIYQGlnX2VwaGVtZXJhbC8xMzQzOTZBRTEyMDg4RDg2MTYzQjIxQkEyMTM0MUVBOV92aWRlb19kYXNoaW5pdC5tcDQVAALIARIAFQIYR2lnX3hwdl9yZWVsc19wZXJtYW5lbnRfc3JfcHJvZC8xMDk1MDkzODgyMTI2MTkyXzg4Njc1NDA2NTc4NDE0MDA5NzMubXA0FQICyAESACgAGAAbAogHdXNlX29pbAExEnByb2dyZXNzaXZlX3JlY2lwZQExFQAAJrzU8Lfo7rYDFQIoAkMzLBdAN7MzMzMzMxgSZGFzaF9iYXNlbGluZV8xX3YxEQB1_gdl5p0BAA&oh=00_AfzX-ow_DcwGwG-N-wJRo2wUhFiBQWG9HH74zasp7_xKdg&oe=69BCE9BA"
        }
      ],
      "profile_image_link": "htt***//s***ten*********cdn*********************885************************************************************************************************************************************************************************************************************************************************************************************************************************************************************************************************************************************************************",
      "profile_url": "htt***//i***agr*********nny************",
      "profile_name": "Jenny K***y",
      "highlights_count": 1,
      "highlights": [
        {
          "highlight_url": "https://www.instagram.com/stories/highlights/18026550763647585",
          "id": "18026550763647585",
          "image": "https://scontent-atl3-3.cdninstagram.com/v/t51.82787-15/573732645_18127616266495367_3673315206062571981_n.jpg?stp=c0.455.1170.1170a_dst-jpg_e15_s150x150_tt6&_nc_ht=scontent-atl3-3.cdninstagram.com&_nc_cat=111&_nc_oc=Q6cZ2QEE4OreRXzcQ2CqfikRW1dKnGrkuowmELfFxSlLCv0wKApkCk_6Wcbln6C2erPd-Xo&_nc_ohc=pr5PJJAmFYkQ7kNvwGad141&_nc_gid=uQYUd6X3lmUi--ZasXrx5A&edm=AGXveE0BAAAA&ccb=7-5&oh=00_AfxIP7Y-MDVbXrKf1PFIq3qOQemwInWjCDquh1v-Zuc0qQ&oe=69BCC45C&_nc_sid=522435",
          "owner": "jennykelly1972",
          "title": "📚"
        }
      ],
      "full_name": "Jenny K***y",
      "is_private": false,
      "bio_hashtags": null,
      "url": "https://www.instagram.com/jennykelly1972/",
      "is_joined_recently": false,
      "has_channel": false,
      "partner_id": "5087052934",
      "business_address": null,
      "related_accounts": [],
      "email_address": "jen***dar***ail******",
      "external_url_title": {
        "title": null,
        "url": null
      },
      "pronouns": null
    }
  ]
  ```
</ResponseExample>


# Collect all reels
Source: https://docs.brightdata.com/api-reference/scrapers/social-media-apis/instagram-reels-collect-all

POST https://api.brightdata.com/datasets/v3/scrape
Use the Bright Data Web Scraper API to collect All Reels. POST /datasets/v3/scrape starts a scraping job that returns the data as structured JSON records.

## Query Parameters

<ParamField type="string">
  The dataset ID used for this request.

  <Warning>
    Must be set to `gd_lyclm20il4r5helnj` to collect **all Reels** data.
  </Warning>
</ParamField>

<ParamField type="string">
  Must be set to `discover_new`.
</ParamField>

<ParamField type="string">
  Must be set to `url_all_reels`.
</ParamField>

<ParamField type="boolean">
  Whether to send notifications when the request is completed.
</ParamField>

<ParamField type="boolean">
  Whether to include errors in the response.
</ParamField>

## Request Body

<ParamField type="object[]">
  An array of input objects.

  <Expandable title="properties">
    <ParamField type="string">
      The URL of the Instagram profile.
    </ParamField>

    <ParamField type="number">
      The number of recent posts to collect, missing value indicates no limit.
    </ParamField>

    <ParamField type="string[]">
      Post IDs not to include
    </ParamField>

    <ParamField type="integer">
      Start date filter `MM-DD-YYYY` (should be earlier than "end\_date")
    </ParamField>

    <ParamField type="integer">
      End date filter `MM-DD-YYYY` (should be later than "start\_date")
    </ParamField>
  </Expandable>

  #### Example

  ```json wrap theme={null}
  {
    "input":[
      {
        "url":"https://www.instagram.com/billieeilish",
        "num_of_posts":20,
        "start_date":"",
        "end_date":""
      }
    ]
  }
  ```
</ParamField>

## Response

<ResponseExample>
  ```json 200 theme={null}
  [
    {
      "url": "https://www.instagram.com/reel/DH_cMAXRIQY/",
      "user_posted": "abracadabraboutique",
      "description": "Conjunto súper cómodo y moderno. Sólo en Abracadabra 😍🔥💣\n\n#indumentariafemenina🛍❤️ #indumentaria #calzado #calzadomujer #nuevosingresos #nuevatemporada #nuevacoleccion",
      "hashtags": [
        "#indumentariafemenina🛍❤️",
        "#indumentaria",
        "#calzado",
        "#calzadomujer",
        "#nuevosingresos",
        "#nuevatemporada",
        "#nuevacoleccion"
      ],
      "num_comments": 4,
      "date_posted": "2025-04-03T16:34:48.000Z",
      "likes": 73,
      "views": 1693,
      "video_play_count": 4080,
      "top_comments": [
        {
          "avatar": "https://scontent-atl3-3.cdninstagram.com/v/t51.2885-19/393981808_832592148654287_1960908302402060583_n.jpg?stp=dst-jpg_s150x150_tt6&efg=eyJ2ZW5jb2RlX3RhZyI6InByb2ZpbGVfcGljLmRqYW5nby43MjAuYzIifQ&_nc_ht=scontent-atl3-3.cdninstagram.com&_nc_cat=111&_nc_oc=Q6cZ2QF0G7IbSpPio3Hk0geAsBVs2gJ4jQeCifkDkpVXMic-p0t41OMEOyF50VHHXvTi6d4&_nc_ohc=N_kA__8Fo5wQ7kNvwFS6Ger&_nc_gid=pnnR8ImgSAoQzGLidPzdEw&edm=ANTKIIoBAAAA&ccb=7-5&oh=00_AfwkK1Yv4wY0i8oerxqGDvXaONq8-9om9I2Z-yDsAH6DCQ&oe=69BE5B3D&_nc_sid=d885a2",
          "comment": "Muy lindo. Las zapatillas también.",
          "date_of_comment": "2025-04-14T15:10:42.000Z",
          "likes": null,
          "num_replies": 0,
          "replies": [],
          "user_commenting": "bonaviaveronica"
        },
        {
          "avatar": "https://scontent-atl3-2.cdninstagram.com/v/t51.2885-19/500977030_18047146628618941_2751835955884791848_n.jpg?stp=dst-jpg_s150x150_tt6&efg=eyJ2ZW5jb2RlX3RhZyI6InByb2ZpbGVfcGljLmRqYW5nby4xMDgwLmMyIn0&_nc_ht=scontent-atl3-2.cdninstagram.com&_nc_cat=101&_nc_oc=Q6cZ2QF0G7IbSpPio3Hk0geAsBVs2gJ4jQeCifkDkpVXMic-p0t41OMEOyF50VHHXvTi6d4&_nc_ohc=sV0auIHjCWsQ7kNvwH_cdH2&_nc_gid=pnnR8ImgSAoQzGLidPzdEw&edm=ANTKIIoBAAAA&ccb=7-5&oh=00_AfzwL5BtKXDZwJm0ZT7X9FBn5oSmAh2nsfJ77cnvenymxw&oe=69BE5B0A&_nc_sid=d885a2",
          "comment": "Marca ?",
          "date_of_comment": "2025-04-03T17:16:13.000Z",
          "likes": null,
          "num_replies": 0,
          "replies": [],
          "user_commenting": "sildiazperxes1907"
        },
        {
          "avatar": "https://scontent-atl3-1.cdninstagram.com/v/t51.2885-19/271473593_643386380192898_2112725622111954980_n.jpg?stp=dst-jpg_s150x150_tt6&efg=eyJ2ZW5jb2RlX3RhZyI6InByb2ZpbGVfcGljLmRqYW5nby45NjAuYzIifQ&_nc_ht=scontent-atl3-1.cdninstagram.com&_nc_cat=106&_nc_oc=Q6cZ2QF0G7IbSpPio3Hk0geAsBVs2gJ4jQeCifkDkpVXMic-p0t41OMEOyF50VHHXvTi6d4&_nc_ohc=wrE6O4hs60oQ7kNvwHBe6eU&_nc_gid=pnnR8ImgSAoQzGLidPzdEw&edm=ANTKIIoBAAAA&ccb=7-5&oh=00_AfxsNB2qldAzzK1-ksczsJBCwlZlZGpknDcrkiyrMZodrg&oe=69BE5317&_nc_sid=d885a2",
          "comment": "Precio?",
          "date_of_comment": "2025-04-03T16:41:45.000Z",
          "likes": null,
          "num_replies": 1,
          "replies": [
            {
              "date_of_comment": "2025-04-03T17:23:50.000Z",
              "likes": 0,
              "reply": "@riosjuanabeatriz Hola! Este conjunto está $348.000",
              "user_commenting": "abracadabraboutique"
            }
          ],
          "user_commenting": "riosjuanabeatriz"
        }
      ],
      "post_id": "3602722197246084120_1486153738",
      "thumbnail": "https://scontent-atl3-1.cdninstagram.com/v/t51.71878-15/488612825_1867165924020579_4916815125896091111_n.jpg?stp=dst-jpg_e15_tt6&efg=eyJ2ZW5jb2RlX3RhZyI6ImltYWdlX3VybGdlbi42NDB4MTEzNi5zZHIuZjcxODc4LmRlZmF1bHRfY292ZXJfZnJhbWUuYzIifQ&_nc_ht=scontent-atl3-1.cdninstagram.com&_nc_cat=103&_nc_oc=Q6cZ2QF0G7IbSpPio3Hk0geAsBVs2gJ4jQeCifkDkpVXMic-p0t41OMEOyF50VHHXvTi6d4&_nc_ohc=RkqxlEWnOyIQ7kNvwFv_VP7&_nc_gid=pnnR8ImgSAoQzGLidPzdEw&edm=ANTKIIoBAAAA&ccb=7-5&oh=00_AfxcSq1X40zFDMkIhbIx9bweNxizpVgJddTQrWFQTAgGmA&oe=69BE4868&_nc_sid=d885a2",
      "shortcode": "DH_cMAXRIQY",
      "content_id": "3602722197246084120_1486153738_1486153738",
      "product_type": "clips",
      "coauthor_producers": [],
      "tagged_users": [],
      "length": "79.233",
      "video_url": "https://scontent-atl3-1.cdninstagram.com/o1/v/t2/f2/m367/AQP7aYGDohumTP89gcgkkJucB1zmpXBDI3LjFQvlbLwww5fmQdlunmM-s2TyYU77AXScuYUDuz4nexOXZHSsIHloL0OrtqyZIsblTuk.mp4?_nc_cat=106&_nc_sid=5e9851&_nc_ht=scontent-atl3-1.cdninstagram.com&_nc_ohc=87WnVgH0XycQ7kNvwHaewxU&efg=eyJ2ZW5jb2RlX3RhZyI6Inhwdl9wcm9ncmVzc2l2ZS5JTlNUQUdSQU0uQ0xJUFMuQzMuNzIwLmRhc2hfYmFzZWxpbmVfMV92MSIsInhwdl9hc3NldF9pZCI6NjExNzc4Mzc4NTI3OTAwLCJhc3NldF9hZ2VfZGF5cyI6MzQ3LCJ2aV91c2VjYXNlX2lkIjoxMDA5OSwiZHVyYXRpb25fcyI6NzksInVybGdlbl9zb3VyY2UiOiJ3d3cifQ%3D%3D&ccb=17-1&vs=cd0c2157c0c0896a&_nc_vs=HBksFQIYQGlnX2VwaGVtZXJhbC8wMjQ3QzYxRTA3NTJDRTRFNUM5QTNEQ0U1NDc2QURBQl92aWRlb19kYXNoaW5pdC5tcDQVAALIARIAFQIYR2lnX3hwdl9yZWVsc19wZXJtYW5lbnRfc3JfcHJvZC8yMDE2Nzc5ODAyMTc4MjI1XzE1NzQ5MjY2Nzg1ODE0ODI5MDIubXA0FQICyAESACgAGAAbAogHdXNlX29pbAExEnByb2dyZXNzaXZlX3JlY2lwZQExFQAAJrjS946YmpYCFQIoAkMzLBdAU9EGJN0vGxgSZGFzaF9iYXNlbGluZV8xX3YxEQB1_gdl5p0BAA&_nc_gid=pnnR8ImgSAoQzGLidPzdEw&_nc_ss=8&_nc_zt=28&oh=00_AfxgMJ-f72cLigTUYmJnGOgWUL44sVlMMgqbNbbEWwAwaA&oe=69BE3F57",
      "audio_url": "https://www.instagram.com/reels/audio/620087377687453",
      "posts_count": 2088,
      "followers": 13136,
      "following": null,
      "user_profile_url": "htt***//w***ins*********m/a*********************",
      "is_paid_partnership": false,
      "is_verified": false,
      "profile_image_link": "https://scontent-iad3-1.cdninstagram.com/v/t51.2885-19/68842937_227118391542205_7583241919069683712_n.jpg?stp=dst-jpg_s150x150_tt6&efg=eyJ2ZW5jb2RlX3RhZyI6InByb2ZpbGVfcGljLmRqYW5nby40MDkuYzIifQ&_nc_ht=scontent-iad3-1.cdninstagram.com&_nc_cat=101&_nc_oc=Q6cZ2QFoakMwk_BffRbxQUziAUQhhh9xn4M_e3jy682uv2MdFhBkjMB2Xvp9Q1YHauIRl6A&_nc_ohc=ETxaEddFQGEQ7kNvwH-RMVe&_nc_gid=RePH33uhj8xbft4ltJmUeg&edm=APs17CUBAAAA&ccb=7-5&oh=00_Afx2LTpuEXBvMtLGqvSskEE87byrU1Mg8QS8q6VTeI0mEw&oe=69BE5832&_nc_sid=10d13b"
    }
  ]
  ```
</ResponseExample>


# Collect reels by URL
Source: https://docs.brightdata.com/api-reference/scrapers/social-media-apis/instagram-reels-collect-by-url

api-reference/sdk-specs/instagram-reels-collect-by-url POST /datasets/v3/scrape
Use the Bright Data Web Scraper API to collect Reels by URL. POST /datasets/v3/scrape starts a scraping job that returns the data as structured JSON records.

## Query Parameters

<ParamField type="string">
  The dataset ID used for this request.

  <Warning>
    Must be set to `gd_lyclm20il4r5helnj` to collect **Reels by URL** data.
  </Warning>
</ParamField>

<ParamField type="boolean">
  Whether to send notifications when the request is completed.
</ParamField>

<ParamField type="boolean">
  Whether to include errors in the response.
</ParamField>

## Request Body

<ParamField type="object[]">
  An array of input objects.

  <Expandable title="properties">
    <ParamField type="string">
      The URL of the Instagram reels to collect.
    </ParamField>
  </Expandable>

  #### Example

  ```json wrap theme={null}
  {
    "input":[
      {"url":"https://www.instagram.com/reel/C5Rdyj_q7YN/"},
      {"url":"https://www.instagram.com/reel/C85BZjeSHuO"}
    ]
  }
  ```
</ParamField>

<ResponseExample>
  ```json 200 theme={null}
  [
    {
      "url": "https://www.instagram.com/reel/DVNLU52gCAP/",
      "user_posted": "lanceoca",
      "description": "clingy naman ng bebe na yan 😂😂",
      "hashtags": null,
      "num_comments": 6,
      "date_posted": "2026-02-26T03:23:20.000Z",
      "likes": 3,
      "views": 388,
      "video_play_count": 1890,
      "top_comments": [
        {
          "avatar": "https://scontent-phl2-1.cdninstagram.com/v/t51.2885-19/365460701_613557573974169_4246269411584735337_n.jpg?stp=dst-jpg_s150x150_tt6&efg=eyJ2ZW5jb2RlX3RhZyI6InByb2ZpbGVfcGljLmRqYW5nby45NTcuYzIifQ&_nc_ht=scontent-phl2-1.cdninstagram.com&_nc_cat=109&_nc_oc=Q6cZ2QH2Km-HWtG_kFjSkWI-wtXI14TUgdgZN3CffFjRE0mZMwRZwsr6ISXIttcetnv45fU&_nc_ohc=1sksn4DLF60Q7kNvwGVdyy-&_nc_gid=1nVoOKHoCkOl8-av4Iwgkg&edm=ANTKIIoBAAAA&ccb=7-5&oh=00_AfznARNQ0EpZxuYD13_j-z1x5gVSXJzuDNLf27ksGkq9Gg&oe=69BD27FC&_nc_sid=d885a2",
          "comment": "So handsome😍😍😍😍",
          "date_of_comment": "2026-03-05T03:12:12.000Z",
          "likes": null,
          "num_replies": 0,
          "replies": [],
          "user_commenting": "jgmagboo"
        },
        {
          "avatar": "https://scontent-phl2-1.cdninstagram.com/v/t51.82787-19/604381380_17846853735621432_1417364464978583437_n.jpg?stp=dst-jpg_s150x150_tt6&efg=eyJ2ZW5jb2RlX3RhZyI6InByb2ZpbGVfcGljLmRqYW5nby4zMjAuYzIifQ&_nc_ht=scontent-phl2-1.cdninstagram.com&_nc_cat=100&_nc_oc=Q6cZ2QH2Km-HWtG_kFjSkWI-wtXI14TUgdgZN3CffFjRE0mZMwRZwsr6ISXIttcetnv45fU&_nc_ohc=wxn_bgzeNMoQ7kNvwGZZc1t&_nc_gid=1nVoOKHoCkOl8-av4Iwgkg&edm=ANTKIIoBAAAA&ccb=7-5&oh=00_AfzilHku95q5GuC9yL0SW82MZL569Zijwn6C6K-V26ohaA&oe=69BD2DE4&_nc_sid=d885a2",
          "comment": "😢hello handsome",
          "date_of_comment": "2026-03-02T22:51:50.000Z",
          "likes": null,
          "num_replies": 0,
          "replies": [],
          "user_commenting": "mavic6620"
        },
        {
          "avatar": "https://scontent-phl2-1.cdninstagram.com/v/t51.2885-19/487313612_1015621063797112_1603884341697763156_n.jpg?stp=dst-jpg_s150x150_tt6&efg=eyJ2ZW5jb2RlX3RhZyI6InByb2ZpbGVfcGljLmRqYW5nby4xMDgwLmMyIn0&_nc_ht=scontent-phl2-1.cdninstagram.com&_nc_cat=104&_nc_oc=Q6cZ2QH2Km-HWtG_kFjSkWI-wtXI14TUgdgZN3CffFjRE0mZMwRZwsr6ISXIttcetnv45fU&_nc_ohc=FDBy91MOg4AQ7kNvwFSG43x&_nc_gid=1nVoOKHoCkOl8-av4Iwgkg&edm=ANTKIIoBAAAA&ccb=7-5&oh=00_Afw_I5Ji5g_FizTfUahhtB2N5dlEHBfF785jDNFXxxLPzw&oe=69BD245E&_nc_sid=d885a2",
          "comment": "Hi there..😍😍🔥",
          "date_of_comment": "2026-02-28T02:47:21.000Z",
          "likes": "1",
          "num_replies": 0,
          "replies": [],
          "user_commenting": "lajas621"
        },
        {
          "avatar": "https://scontent-phl2-1.cdninstagram.com/v/t51.82787-19/589404006_17927065818169590_4230007312536318761_n.jpg?stp=dst-jpg_s150x150_tt6&efg=eyJ2ZW5jb2RlX3RhZyI6InByb2ZpbGVfcGljLmRqYW5nby43MjAuYzIifQ&_nc_ht=scontent-phl2-1.cdninstagram.com&_nc_cat=106&_nc_oc=Q6cZ2QH2Km-HWtG_kFjSkWI-wtXI14TUgdgZN3CffFjRE0mZMwRZwsr6ISXIttcetnv45fU&_nc_ohc=3cCCnbM9pjkQ7kNvwFuVke7&_nc_gid=1nVoOKHoCkOl8-av4Iwgkg&edm=ANTKIIoBAAAA&ccb=7-5&oh=00_AfyMahn5ck5AEFFmQUrEH1I7VIWpWjok0AU4EwOZtOwpuw&oe=69BD1C6F&_nc_sid=d885a2",
          "comment": "Wow❤️❤️❤️",
          "date_of_comment": "2026-02-26T08:15:44.000Z",
          "likes": null,
          "num_replies": 0,
          "replies": [],
          "user_commenting": "jennalyn294"
        },
        {
          "avatar": "https://scontent-phl2-1.cdninstagram.com/v/t51.82787-19/643610031_18394067647195478_6467437205157259761_n.jpg?stp=dst-jpg_s150x150_tt6&efg=eyJ2ZW5jb2RlX3RhZyI6InByb2ZpbGVfcGljLmRqYW5nby4zMjAuYzIifQ&_nc_ht=scontent-phl2-1.cdninstagram.com&_nc_cat=102&_nc_oc=Q6cZ2QH2Km-HWtG_kFjSkWI-wtXI14TUgdgZN3CffFjRE0mZMwRZwsr6ISXIttcetnv45fU&_nc_ohc=R1RL_k362XwQ7kNvwHO8U39&_nc_gid=1nVoOKHoCkOl8-av4Iwgkg&edm=ANTKIIoBAAAA&ccb=7-5&oh=00_AfxLuxMSr1rcvJEsa2UrMoP8Lz-wVzC72xQZ1W3-1byjSA&oe=69BD02EE&_nc_sid=d885a2",
          "comment": "iloveyou ❤️❤️❤️😘",
          "date_of_comment": "2026-02-26T06:42:50.000Z",
          "likes": null,
          "num_replies": 0,
          "replies": [],
          "user_commenting": "mhat.memoracion"
        },
        {
          "avatar": "https://scontent-phl2-1.cdninstagram.com/v/t51.82787-19/611627622_18554417668038304_6341390296922072598_n.jpg?stp=dst-jpg_s150x150_tt6&efg=eyJ2ZW5jb2RlX3RhZyI6InByb2ZpbGVfcGljLmRqYW5nby4xMDgwLmMyIn0&_nc_ht=scontent-phl2-1.cdninstagram.com&_nc_cat=104&_nc_oc=Q6cZ2QH2Km-HWtG_kFjSkWI-wtXI14TUgdgZN3CffFjRE0mZMwRZwsr6ISXIttcetnv45fU&_nc_ohc=AJwRgGMf_coQ7kNvwHWBhko&_nc_gid=1nVoOKHoCkOl8-av4Iwgkg&edm=ANTKIIoBAAAA&ccb=7-5&oh=00_Afy9MgvDJ_Jv-SVLKAiJVtHaCVrfqmpEtjYOoBCyj_OKjA&oe=69BD0E87&_nc_sid=d885a2",
          "comment": "Kennyyyyy! 😍😍",
          "date_of_comment": "2026-02-26T03:55:43.000Z",
          "likes": null,
          "num_replies": 0,
          "replies": [],
          "user_commenting": "thatsellengayle"
        }
      ],
      "post_id": "3840775872235708431_497234441",
      "thumbnail": "https://scontent-phl2-1.cdninstagram.com/v/t51.71878-15/642489697_931785695971440_3837333144664180149_n.jpg?stp=dst-jpg_e15_tt6&efg=eyJ2ZW5jb2RlX3RhZyI6ImltYWdlX3VybGdlbi42NDB4MTEzNi5zZHIuZjcxODc4Lm5mcmFtZV9jb3Zlcl9mcmFtZS5jMiJ9&_nc_ht=scontent-phl2-1.cdninstagram.com&_nc_cat=100&_nc_oc=Q6cZ2QH2Km-HWtG_kFjSkWI-wtXI14TUgdgZN3CffFjRE0mZMwRZwsr6ISXIttcetnv45fU&_nc_ohc=ld-onItfzFIQ7kNvwEGAIZT&_nc_gid=1nVoOKHoCkOl8-av4Iwgkg&edm=ANTKIIoBAAAA&ccb=7-5&oh=00_Afz7i42LKF1TExXZOoZv8OQ6YEd-kZEdzAyk_rUMlaztEw&oe=69BD27F2&_nc_sid=d885a2",
      "shortcode": "DVNLU52gCAP",
      "content_id": "3840775872235708431_497234441_497234441",
      "product_type": "clips",
      "coauthor_producers": [],
      "tagged_users": [],
      "length": "15.033",
      "video_url": "https://scontent-phl2-1.cdninstagram.com/o1/v/t16/f2/m69/AQO1SuMyUcs1QWW58Fau44ndzK-6SmNd445DizWdt8WagvA2o9UAYpZcn6CfH_Wp3E9pH-k4PDImZiE6IJf87aVm.mp4?strext=1&_nc_cat=102&_nc_sid=5e9851&_nc_ht=scontent-phl2-1.cdninstagram.com&_nc_ohc=fra74Acli5UQ7kNvwG-BbIe&efg=eyJ2ZW5jb2RlX3RhZyI6Inhwdl9wcm9ncmVzc2l2ZS5JTlNUQUdSQU0uQ0xJUFMuQzMuNzIwLmRhc2hfYmFzZWxpbmVfMV92MSIsInhwdl9hc3NldF9pZCI6MTc5NDkxMzUwMjQxMDE5MjYsImFzc2V0X2FnZV9kYXlzIjoxNywidmlfdXNlY2FzZV9pZCI6MTAwOTksImR1cmF0aW9uX3MiOjE1LCJ1cmxnZW5fc291cmNlIjoid3d3In0%3D&ccb=17-1&vs=2267dea350fbd465&_nc_vs=HBksFQIYOnBhc3N0aHJvdWdoX2V2ZXJzdG9yZS9HSFE0LXlXa1JiMzJYa3dEQU9yaEtYTkZyOHRxYnNwVEFRQUYVAALIARIAFQIYUWlnX3hwdl9wbGFjZW1lbnRfcGVybWFuZW50X3YyL0ZDNENBQjg2Q0VFNTU3RkU5NDZBQUYzNTNGNDFGNkI3X2F1ZGlvX2Rhc2hpbml0Lm1wNBUCAsgBEgAoABgAGwKIB3VzZV9vaWwBMRJwcm9ncmVzc2l2ZV9yZWNpcGUBMRUAACbM6JiSlaniPxUCKAJDMywXQC4Q5WBBiTcYEmRhc2hfYmFzZWxpbmVfMV92MREAdf4HZeadAQA&_nc_gid=1nVoOKHoCkOl8-av4Iwgkg&_nc_ss=8&_nc_zt=28&oh=00_Afws7Cm4DuKLxHAjheCqUW1fe2al52lZbgUNRHbiXa_H0g&oe=69BD1196",
      "audio_url": "https://www.instagram.com/reels/audio/613780965138542",
      "posts_count": 2319,
      "followers": 94671,
      "following": null,
      "user_profile_url": "htt***//w***ins*********m/l*********",
      "is_paid_partnership": false,
      "is_verified": true,
      "profile_image_link": "https://scontent-mia5-1.cdninstagram.com/v/t51.82787-19/523513088_18520152235018442_1378657946459904137_n.jpg?stp=dst-jpg_s150x150_tt6&efg=eyJ2ZW5jb2RlX3RhZyI6InByb2ZpbGVfcGljLmRqYW5nby4xMDgwLmMyIn0&_nc_ht=scontent-mia5-1.cdninstagram.com&_nc_cat=102&_nc_oc=Q6cZ2QEI4iViNi0YUmtNR4gwjlifNoniCz1nfEs1XGRXQW5VtoNDlwCKdVe_ayxZrKVC3JI&_nc_ohc=jOf5V5nROFYQ7kNvwFvWJah&_nc_gid=2ag63x5Aw5-NL2Fq6v6jhw&edm=APs17CUBAAAA&ccb=7-5&oh=00_Afy_XwPZFp_gUapVcrmQwXkvlRmt0xThqroTeB2ERmWtBQ&oe=69BD0AE6&_nc_sid=10d13b"
    }
  ]
  ```
</ResponseExample>


# Discover Instagram reels by URL
Source: https://docs.brightdata.com/api-reference/scrapers/social-media-apis/instagram-reels-discover-by-url

POST https://api.brightdata.com/datasets/v3/scrape
Use the Bright Data Web Scraper API to discover Instagram reels by URL. Calls the POST /datasets/v3/scrape endpoint and returns a snapshot ID.

## Query Parameters

<ParamField type="string">
  The dataset ID used for this request.

  <Warning>
    Must be set to `gd_lyclm20il4r5helnj` to collect **Discover by URL** data.
  </Warning>
</ParamField>

<ParamField type="string">
  Must be set to `discover_new`.
</ParamField>

<ParamField type="string">
  Must be set to `url`.
</ParamField>

<ParamField type="boolean">
  Whether to send notifications when the request is completed.
</ParamField>

<ParamField type="boolean">
  Whether to include errors in the response.
</ParamField>

## Request Body

<ParamField type="object[]">
  An array of input objects.

  <Expandable title="properties">
    <ParamField type="string">
      The URL of the Instagram profile.
    </ParamField>

    <ParamField type="number">
      The number of recent posts to collect, missing value indicates no limit.
    </ParamField>

    <ParamField type="string[]">
      Post IDs not to include
    </ParamField>

    <ParamField type="integer">
      Start date filter `MM-DD-YYYY` (should be earlier than "end\_date")
    </ParamField>

    <ParamField type="integer">
      End date filter `MM-DD-YYYY` (should be later than "start\_date")
    </ParamField>
  </Expandable>

  #### Example

  ```json wrap theme={null}
  {
    "input":[
      {
        "url":"https://www.instagram.com/espn",
        "start_date":"",
        "end_date":""
      }
    ]
  }
  ```
</ParamField>

## Response

<ResponseExample>
  ```json 200 theme={null}
  [
    {
      "url": "https://www.instagram.com/reel/DH_cMAXRIQY/",
      "user_posted": "abracadabraboutique",
      "description": "Conjunto súper cómodo y moderno. Sólo en Abracadabra 😍🔥💣\n\n#indumentariafemenina🛍❤️ #indumentaria #calzado #calzadomujer #nuevosingresos #nuevatemporada #nuevacoleccion",
      "hashtags": [
        "#indumentariafemenina🛍❤️",
        "#indumentaria",
        "#calzado",
        "#calzadomujer",
        "#nuevosingresos",
        "#nuevatemporada",
        "#nuevacoleccion"
      ],
      "num_comments": 4,
      "date_posted": "2025-04-03T16:34:48.000Z",
      "likes": 73,
      "views": 1693,
      "video_play_count": 4080,
      "top_comments": [
        {
          "avatar": "https://scontent-atl3-3.cdninstagram.com/v/t51.2885-19/393981808_832592148654287_1960908302402060583_n.jpg?stp=dst-jpg_s150x150_tt6&efg=eyJ2ZW5jb2RlX3RhZyI6InByb2ZpbGVfcGljLmRqYW5nby43MjAuYzIifQ&_nc_ht=scontent-atl3-3.cdninstagram.com&_nc_cat=111&_nc_oc=Q6cZ2QF0G7IbSpPio3Hk0geAsBVs2gJ4jQeCifkDkpVXMic-p0t41OMEOyF50VHHXvTi6d4&_nc_ohc=N_kA__8Fo5wQ7kNvwFS6Ger&_nc_gid=pnnR8ImgSAoQzGLidPzdEw&edm=ANTKIIoBAAAA&ccb=7-5&oh=00_AfwkK1Yv4wY0i8oerxqGDvXaONq8-9om9I2Z-yDsAH6DCQ&oe=69BE5B3D&_nc_sid=d885a2",
          "comment": "Muy lindo. Las zapatillas también.",
          "date_of_comment": "2025-04-14T15:10:42.000Z",
          "likes": null,
          "num_replies": 0,
          "replies": [],
          "user_commenting": "bonaviaveronica"
        },
        {
          "avatar": "https://scontent-atl3-2.cdninstagram.com/v/t51.2885-19/500977030_18047146628618941_2751835955884791848_n.jpg?stp=dst-jpg_s150x150_tt6&efg=eyJ2ZW5jb2RlX3RhZyI6InByb2ZpbGVfcGljLmRqYW5nby4xMDgwLmMyIn0&_nc_ht=scontent-atl3-2.cdninstagram.com&_nc_cat=101&_nc_oc=Q6cZ2QF0G7IbSpPio3Hk0geAsBVs2gJ4jQeCifkDkpVXMic-p0t41OMEOyF50VHHXvTi6d4&_nc_ohc=sV0auIHjCWsQ7kNvwH_cdH2&_nc_gid=pnnR8ImgSAoQzGLidPzdEw&edm=ANTKIIoBAAAA&ccb=7-5&oh=00_AfzwL5BtKXDZwJm0ZT7X9FBn5oSmAh2nsfJ77cnvenymxw&oe=69BE5B0A&_nc_sid=d885a2",
          "comment": "Marca ?",
          "date_of_comment": "2025-04-03T17:16:13.000Z",
          "likes": null,
          "num_replies": 0,
          "replies": [],
          "user_commenting": "sildiazperxes1907"
        },
        {
          "avatar": "https://scontent-atl3-1.cdninstagram.com/v/t51.2885-19/271473593_643386380192898_2112725622111954980_n.jpg?stp=dst-jpg_s150x150_tt6&efg=eyJ2ZW5jb2RlX3RhZyI6InByb2ZpbGVfcGljLmRqYW5nby45NjAuYzIifQ&_nc_ht=scontent-atl3-1.cdninstagram.com&_nc_cat=106&_nc_oc=Q6cZ2QF0G7IbSpPio3Hk0geAsBVs2gJ4jQeCifkDkpVXMic-p0t41OMEOyF50VHHXvTi6d4&_nc_ohc=wrE6O4hs60oQ7kNvwHBe6eU&_nc_gid=pnnR8ImgSAoQzGLidPzdEw&edm=ANTKIIoBAAAA&ccb=7-5&oh=00_AfxsNB2qldAzzK1-ksczsJBCwlZlZGpknDcrkiyrMZodrg&oe=69BE5317&_nc_sid=d885a2",
          "comment": "Precio?",
          "date_of_comment": "2025-04-03T16:41:45.000Z",
          "likes": null,
          "num_replies": 1,
          "replies": [
            {
              "date_of_comment": "2025-04-03T17:23:50.000Z",
              "likes": 0,
              "reply": "@riosjuanabeatriz Hola! Este conjunto está $348.000",
              "user_commenting": "abracadabraboutique"
            }
          ],
          "user_commenting": "riosjuanabeatriz"
        }
      ],
      "post_id": "3602722197246084120_1486153738",
      "thumbnail": "https://scontent-atl3-1.cdninstagram.com/v/t51.71878-15/488612825_1867165924020579_4916815125896091111_n.jpg?stp=dst-jpg_e15_tt6&efg=eyJ2ZW5jb2RlX3RhZyI6ImltYWdlX3VybGdlbi42NDB4MTEzNi5zZHIuZjcxODc4LmRlZmF1bHRfY292ZXJfZnJhbWUuYzIifQ&_nc_ht=scontent-atl3-1.cdninstagram.com&_nc_cat=103&_nc_oc=Q6cZ2QF0G7IbSpPio3Hk0geAsBVs2gJ4jQeCifkDkpVXMic-p0t41OMEOyF50VHHXvTi6d4&_nc_ohc=RkqxlEWnOyIQ7kNvwFv_VP7&_nc_gid=pnnR8ImgSAoQzGLidPzdEw&edm=ANTKIIoBAAAA&ccb=7-5&oh=00_AfxcSq1X40zFDMkIhbIx9bweNxizpVgJddTQrWFQTAgGmA&oe=69BE4868&_nc_sid=d885a2",
      "shortcode": "DH_cMAXRIQY",
      "content_id": "3602722197246084120_1486153738_1486153738",
      "product_type": "clips",
      "coauthor_producers": [],
      "tagged_users": [],
      "length": "79.233",
      "video_url": "https://scontent-atl3-1.cdninstagram.com/o1/v/t2/f2/m367/AQP7aYGDohumTP89gcgkkJucB1zmpXBDI3LjFQvlbLwww5fmQdlunmM-s2TyYU77AXScuYUDuz4nexOXZHSsIHloL0OrtqyZIsblTuk.mp4?_nc_cat=106&_nc_sid=5e9851&_nc_ht=scontent-atl3-1.cdninstagram.com&_nc_ohc=87WnVgH0XycQ7kNvwHaewxU&efg=eyJ2ZW5jb2RlX3RhZyI6Inhwdl9wcm9ncmVzc2l2ZS5JTlNUQUdSQU0uQ0xJUFMuQzMuNzIwLmRhc2hfYmFzZWxpbmVfMV92MSIsInhwdl9hc3NldF9pZCI6NjExNzc4Mzc4NTI3OTAwLCJhc3NldF9hZ2VfZGF5cyI6MzQ3LCJ2aV91c2VjYXNlX2lkIjoxMDA5OSwiZHVyYXRpb25fcyI6NzksInVybGdlbl9zb3VyY2UiOiJ3d3cifQ%3D%3D&ccb=17-1&vs=cd0c2157c0c0896a&_nc_vs=HBksFQIYQGlnX2VwaGVtZXJhbC8wMjQ3QzYxRTA3NTJDRTRFNUM5QTNEQ0U1NDc2QURBQl92aWRlb19kYXNoaW5pdC5tcDQVAALIARIAFQIYR2lnX3hwdl9yZWVsc19wZXJtYW5lbnRfc3JfcHJvZC8yMDE2Nzc5ODAyMTc4MjI1XzE1NzQ5MjY2Nzg1ODE0ODI5MDIubXA0FQICyAESACgAGAAbAogHdXNlX29pbAExEnByb2dyZXNzaXZlX3JlY2lwZQExFQAAJrjS946YmpYCFQIoAkMzLBdAU9EGJN0vGxgSZGFzaF9iYXNlbGluZV8xX3YxEQB1_gdl5p0BAA&_nc_gid=pnnR8ImgSAoQzGLidPzdEw&_nc_ss=8&_nc_zt=28&oh=00_AfxgMJ-f72cLigTUYmJnGOgWUL44sVlMMgqbNbbEWwAwaA&oe=69BE3F57",
      "audio_url": "https://www.instagram.com/reels/audio/620087377687453",
      "posts_count": 2088,
      "followers": 13136,
      "following": null,
      "user_profile_url": "htt***//w***ins*********m/a*********************",
      "is_paid_partnership": false,
      "is_verified": false,
      "profile_image_link": "https://scontent-iad3-1.cdninstagram.com/v/t51.2885-19/68842937_227118391542205_7583241919069683712_n.jpg?stp=dst-jpg_s150x150_tt6&efg=eyJ2ZW5jb2RlX3RhZyI6InByb2ZpbGVfcGljLmRqYW5nby40MDkuYzIifQ&_nc_ht=scontent-iad3-1.cdninstagram.com&_nc_cat=101&_nc_oc=Q6cZ2QFoakMwk_BffRbxQUziAUQhhh9xn4M_e3jy682uv2MdFhBkjMB2Xvp9Q1YHauIRl6A&_nc_ohc=ETxaEddFQGEQ7kNvwH-RMVe&_nc_gid=RePH33uhj8xbft4ltJmUeg&edm=APs17CUBAAAA&ccb=7-5&oh=00_Afx2LTpuEXBvMtLGqvSskEE87byrU1Mg8QS8q6VTeI0mEw&oe=69BE5832&_nc_sid=10d13b"
    }
  ]
  ```
</ResponseExample>


# Collect LinkedIn companies by URL
Source: https://docs.brightdata.com/api-reference/scrapers/social-media-apis/linkedin-companies-collect-by-url

api-reference/sdk-specs/linkedin-companies-collect-by-url POST /datasets/v3/scrape
Collect structured LinkedIn company data by URL using the Bright Data Web Scraper API with dataset ID gd_l1vikfnt1wgvvqz95w for company profiles and metadata.

## Query Parameters

<ParamField type="string">
  The dataset ID used for this request.

  <Warning>
    Must be set to `gd_l1vikfnt1wgvvqz95w` to collect **Companies Information by URL** data.
  </Warning>
</ParamField>

<ParamField type="boolean">
  Whether to send notifications when the request is completed.
</ParamField>

<ParamField type="boolean">
  Whether to include errors in the response.
</ParamField>

## Request Body

<ParamField type="object[]">
  An array of input objects.

  <Expandable title="properties">
    <ParamField type="string">
      The URL of the LinkedIn company to collect.
    </ParamField>
  </Expandable>

  #### Example

  ```json theme={null}
  {
    "input":[
      {"url":"https://il.linkedin.com/company/ibm"},
      {"url":"https://www.linkedin.com/company/figueroa-real-estate/"},
      {"url":"https://www.linkedin.com/organization-guest/company/the-kraft-heinz-company"},
      {"url":"https://il.linkedin.com/company/bright-data"}
    ]
  }
  ```
</ParamField>

<ResponseExample>
  ```json 200 theme={null}
  [
    {
      "id": "zoom",
      "name": "Zoom",
      "country_code": "US,AU,GB,FR,SG,JP,NL",
      "locations": [
        "55 Almaden Blvd., 6th Floor, San Jose, CA 95113 San Jose, CA 95113, US",
        "Level 1, 9 Castlereagh St Sydney, NSW 2000, AU",
        "8000 Avalon Blvd Suite 100, space 216 Alpharetta, Georgia 30008, US",
        "7601 E Technology Way 3rd Floor Denver, Colorado 80237, US",
        "6601 College Blvd Suite 120 Overland Park, Kansas 66211, US",
        "200 E Carrillo St Suite #300 Santa Barbara, California 93101, US",
        "The Place, 4th Floor, 175 High Holborn, London WC1V 7AA, GB",
        "Zoom France, 33 Rue lafayette lafayette, Paris 75009, FR",
        "6 Temasek Boulevard Suntec Tower 5 #17-103 Singapore, SGP 038985, SG",
        "Wework Hibiya park Front 19th floor, 2-1-6 Uchisaiwai-cho Chiyoda-ku, Tokyo 100-0011, JP",
        "Wework 5th floor, Strawinskylaan 4117 Strawinskylaan, Amsterdam 1077 ZX, NL"
      ],
      "followers": 653039,
      "employees_in_linkedin": 12935,
      "about": "Bring teams together, reimagine workspaces, engage new audiences, and delight your customers –– all on the Zoom AI-first work platform you know and love. 💙 Zoomies help people stay connected so they can get more done together. We set out on a mission to make video communications frictionless and secure by building the world’s best video product for the enterprise, but we didn’t stop there. With products like AI Companion, Team Chat, Contact Center, Phone, Events, Rooms, Webinar, Contact Center and more, we bring innovation to a wide variety of customers, from the conference room to the classroom, from doctor’s offices to financial institutions to government agencies, from global brands to small businesses. We do what we do because of our core value of Care: care for our community, our customers, our company, our teammates, and ourselves. Our global employees help our customers meet happier, communicate better, and create meaningful connections the world over. Zoomies are problem-solvers and self-starters, working hard to get results and moving quickly to design solutions with our customers and users in mind. Here, you'll find room to grow with opportunities to stretch your skills and advance your career in a collaborative, growth-focused environment. Learn more about careers at Zoom by visiting our careers site: https://careers.zoom.us/home",
      "specialties": "Mobile Collaboration, Audio Conferencing, Video Conferencing, Online Meetings, Web Conferencing, Cloud Meetings, and Webinar",
      "company_size": "5,001-10,000 employees",
      "organization_type": "Public Company",
      "industries": "IT Services and IT Consulting",
      "website": "https://www.zoom.com/",
      "crunchbase_url": "https://www.crunchbase.com/organization/zoom-video-communications?utm_source=linkedin&utm_medium=referral&utm_campaign=linkedin_companies&utm_content=profile_cta_anon&trk=funding_crunchbase",
      "founded": 2013,
      "company_id": "2532259",
      "employees": [
        {
          "img": "https://media.licdn.com/dms/image/v2/D4D03AQFXMAtpcDdBAw/profile-displayphoto-shrink_100_100/profile-displayphoto-shrink_100_100/0/1701307779350?e=2147483647&v=beta&t=fuYCbTPZhzeQ1Eegj-0cM4B_rLuBh6Akmmby2iH3oD0",
          "link": "https://www.linkedin.com/in/rossmayfield?trk=org-employees",
          "subtitle": "",
          "title": "Ros***ayf***d"
        },
        {
          "img": "https://media.licdn.com/dms/image/v2/D5603AQFsVNwX0nv_mw/profile-displayphoto-shrink_100_100/profile-displayphoto-shrink_100_100/0/1680078275810?e=2147483647&v=beta&t=QmztFPLU-r4iis9HsY_26b-8Wz3cnxTAaycwJN9nxr0",
          "link": "https://www.linkedin.com/in/mattocko?trk=org-employees",
          "subtitle": "",
          "title": "Mat***cko***"
        },
        {
          "img": "https://media.licdn.com/dms/image/v2/D5603AQGdYkEt0wfRgw/profile-displayphoto-scale_100_100/B56Zk_fiJLHUAo-/0/1757706861118?e=2147483647&v=beta&t=STHPO2d1uvPkJUlWvtJEv2DuWtuB4jfOJcC7J6kjTTQ",
          "link": "https://www.linkedin.com/in/jscheinman?trk=org-employees",
          "subtitle": "",
          "title": "Jim***hei***n"
        },
        {
          "img": "https://media.licdn.com/dms/image/v2/C5603AQEwqlsQbHGFVQ/profile-displayphoto-shrink_100_100/profile-displayphoto-shrink_100_100/0/1632693704976?e=2147483647&v=beta&t=ZTB4I2JZMy47qtiZR-p1lG9HE_HBHPrV5BRKUCqBsAI",
          "link": "https://www.linkedin.com/in/shannonmcdole?trk=org-employees",
          "subtitle": "",
          "title": "Sha***n (***d) *********"
        }
      ],
      "headquarters": "San Jose, CA",
      "image": "https://media.licdn.com/dms/image/v2/D563DAQFTYxIYJYwNmw/image-scale_191_1128/B56ZsQFMSLKEAc-/0/1765501357062/zoom_cover?e=2147483647&v=beta&t=hz1TCkzA3Z6tVTSmknd84YeQyij2Q1f5-ooc2_yZ7Co",
      "logo": "https://media.licdn.com/dms/image/v2/D560BAQHdFe3fnAvRmg/company-logo_200_200/company-logo_200_200/0/1711361750580/zoom_video_communications_logo?e=2147483647&v=beta&t=wssg0q9oOBRuuO3kWJQl1RY0c4kNP76u_RELqER9jK8",
      "similar": [
        {
          "Links": "https://www.linkedin.com/company/salesforce?trk=similar-pages",
          "location": "San Francisco, California",
          "subtitle": "Software Development",
          "title": "Salesforce"
        },
        {
          "Links": "https://www.linkedin.com/company/tiny-spec-inc?trk=similar-pages",
          "location": "San Francisco, California",
          "subtitle": "Technology, Information and Internet",
          "title": "Slack"
        },
        {
          "Links": "https://www.linkedin.com/company/google?trk=similar-pages",
          "location": "Mountain View, CA",
          "subtitle": "Software Development",
          "title": "Google"
        },
        {
          "Links": "https://au.linkedin.com/company/atlassian?trk=similar-pages",
          "location": "Sydney, NSW",
          "subtitle": "Software Development",
          "title": "Atlassian"
        },
        {
          "Links": "https://www.linkedin.com/company/microsoft?trk=similar-pages",
          "location": "Redmond, Washington",
          "subtitle": "Software Development",
          "title": "Microsoft"
        },
        {
          "Links": "https://www.linkedin.com/company/airbnb?trk=similar-pages",
          "location": "San Francisco, CA",
          "subtitle": "Software Development",
          "title": "Airbnb"
        },
        {
          "Links": "https://www.linkedin.com/company/netflix?trk=similar-pages",
          "location": "Los Gatos, CA",
          "subtitle": "Entertainment Providers",
          "title": "Netflix"
        },
        {
          "Links": "https://au.linkedin.com/company/canva?trk=similar-pages",
          "location": "Surry Hills, New South Wales",
          "subtitle": "Software Development",
          "title": "Canva"
        },
        {
          "Links": "https://www.linkedin.com/company/hubspot?trk=similar-pages",
          "location": "Cambridge, Massachusetts",
          "subtitle": "Software Development",
          "title": "HubSpot"
        },
        {
          "Links": "https://www.linkedin.com/company/stripe?trk=similar-pages",
          "location": "South San Francisco, California",
          "subtitle": "Technology, Information and Internet",
          "title": "Stripe"
        }
      ],
      "url": "https://www.linkedin.com/company/zoom",
      "updates": [
        {
          "date": "2026-03-16T19:26:02.112Z",
          "likes_count": 14,
          "post_id": "7439391547403530240",
          "post_url": "https://www.linkedin.com/feed/update/urn:li:activity:7439391547403530240/",
          "text": "#ZoomPartner Here's everything that went down with Zoom at Enterprise Connect 2026! Zoom is about way more than meetings - there are so many productivity tools within Zoom Workplace that help ease all those work pain points we experience. #ZoomAhead #JoinTheMovement",
          "text_html": "<a class=\"link\" href=\"https://www.linkedin.com/signup/cold-join?session_redirect=https%3A%2F%2Fwww.linkedin.com%2Ffeed%2Fhashtag%2Fzoompartner&amp;trk=organization_guest_main-feed-card-text\" target=\"_self\" data-tracking-control-name=\"organization_guest_main-feed-card-text\" data-tracking-will-navigate>#ZoomPartner</a> Here&apos;s everything that went down with <a class=\"link\" href=\"https://www.linkedin.com/company/zoom?trk=organization_guest_main-feed-card-text\" target=\"_self\" data-tracking-control-name=\"organization_guest_main-feed-card-text\" data-tracking-will-navigate>Zoom</a>  at Enterprise Connect 2026! Zoom is about way more than meetings - there are so many productivity tools within Zoom Workplace that help ease all those work pain points we experience. <a class=\"link\" href=\"https://www.linkedin.com/signup/cold-join?session_redirect=https%3A%2F%2Fwww.linkedin.com%2Ffeed%2Fhashtag%2Fzoomahead&amp;trk=organization_guest_main-feed-card-text\" target=\"_self\" data-tracking-control-name=\"organization_guest_main-feed-card-text\" data-tracking-will-navigate>#ZoomAhead</a> <a class=\"link\" href=\"https://www.linkedin.com/signup/cold-join?session_redirect=https%3A%2F%2Fwww.linkedin.com%2Ffeed%2Fhashtag%2Fjointhemovement&amp;trk=organization_guest_main-feed-card-text\" target=\"_self\" data-tracking-control-name=\"organization_guest_main-feed-card-text\" data-tracking-will-navigate>#JoinTheMovement</a>",
          "time": "3d",
          "title": "William Bowers",
          "videos": [
            "https://dms.licdn.com/playlist/vid/v2/D4E05AQEJYSUdboIMuQ/mp4-720p-30fp-crf28/B4EZzp1GL3IECI-/0/1773449543327?e=2147483647&v=beta&t=XLOG2RhOkVdK0WCo2csao7InOl9D_o-Up-adbU0cF7E",
            "https://dms.licdn.com/playlist/vid/v2/D4E05AQEJYSUdboIMuQ/mp4-640p-30fp-crf28/B4EZzp1GL3IEBw-/0/1773449542760?e=2147483647&v=beta&t=Eub-gs_Eia8nV9BmB0h-RLC3UKfuWYJxtpbNZ2D-LKY"
          ]
        },
        {
          "comments_count": 2,
          "date": "2026-03-16T16:37:21.224Z",
          "likes_count": 33,
          "post_id": "7439349097322524672",
          "post_url": "https://www.linkedin.com/posts/zoom_zoom-ai-companion-my-notes-activity-7439349097322524672-uOFe",
          "text": "Remember when taking notes felt like a chore? 📝 Let AI Companion My notes do the heavy lifting for you. 💪 Now your notes capture key moments, surface important actions, and help you stay organized — automatically. ✔️ Try it today 🔗 👇",
          "text_html": "Remember when taking notes felt like a chore? &#x1F4DD;\n\nLet AI Companion My notes do the heavy lifting for you. &#x1F4AA;\n\nNow your notes capture key moments, surface important actions, and help you stay organized &#x2014; automatically. &#x2714;&#xFE0F;\n\nTry it today &#x1F517; &#x1F447; ",
          "time": "17h",
          "title": "Zoom",
          "videos": [
            "https://dms.licdn.com/playlist/vid/v2/D5610AQFq8-Z6_G0ynA/mp4-720p-30fp-crf28/B56Zz3ghwUJ8CA-/0/1773679031499?e=2147483647&v=beta&t=tpors2KuQeHa6A91xjIZzYYuwDgZ0YTYCDo9qvBnuE8",
            "https://dms.licdn.com/playlist/vid/v2/D5610AQFq8-Z6_G0ynA/mp4-360p-30fp-crf28/B56Zz3ghwUJ8B8-/0/1773679030921?e=2147483647&v=beta&t=wX73ec8ifCfUs71QZ3IaIzJN-vVqeUdP2xJYgY3MwRA",
            "https://dms.licdn.com/playlist/vid/v2/D5610AQFq8-Z6_G0ynA/mp4-640p-30fp-crf28/B56Zz3ghwUJ8Bk-/0/1773679030920?e=2147483647&v=beta&t=6bJS4S1iuCl6PCAS7TMuaOjD68Df4ErjiDwyZbpIysM"
          ]
        },
        {
          "comments_count": 1,
          "date": "2026-03-16T14:01:13.970Z",
          "likes_count": 36,
          "post_id": "7439309808211660800",
          "post_url": "https://www.linkedin.com/posts/zoom_enterpriseconnect-activity-7439309808211660800-sS8s",
          "text": "Missed the Zoom keynote at #EnterpriseConnect ? Here's your chance to get a first look at Zoom’s latest innovations in AI and orchestration. ⚡ Work today is full of complexity: too many tools, back-to-back meetings, and endless tasks that slow meaningful progress. This friction impacts everyone: IT teams struggle to orchestrate workflows, customer-facing teams wrestle with fragmented data, and small and mid-size businesses find it hard to scale efficiently.",
          "text_html": "Missed the Zoom keynote at <a class=\"link\" href=\"https://www.linkedin.com/signup/cold-join?session_redirect=https%3A%2F%2Fwww.linkedin.com%2Ffeed%2Fhashtag%2Fenterpriseconnect&amp;trk=organization_guest_main-feed-card-text\" target=\"_self\" data-tracking-control-name=\"organization_guest_main-feed-card-text\" data-tracking-will-navigate>#EnterpriseConnect</a>? Here&apos;s your chance to get a first look at Zoom&#x2019;s latest innovations in AI and orchestration. &#x26A1; \n\nWork today is full of complexity: too many tools, back-to-back meetings, and endless tasks that slow meaningful progress. This friction impacts everyone: IT teams struggle to orchestrate workflows, customer-facing teams wrestle with fragmented data, and small and mid-size businesses find it hard to scale efficiently.",
          "time": "20h",
          "title": "Zoom"
        },
        {
          "date": "2026-03-13T19:00:30.157Z",
          "likes_count": 36,
          "post_id": "7438297958321745920",
          "post_url": "https://www.linkedin.com/feed/update/urn:li:activity:7438297958321745920/",
          "text": "#ZoomPartner Mind blown by all the product features Zoom Al Companion has introduced to make work more productive #ZoomAhead #JoinTheMovement",
          "text_html": "<a class=\"link\" href=\"https://www.linkedin.com/signup/cold-join?session_redirect=https%3A%2F%2Fwww.linkedin.com%2Ffeed%2Fhashtag%2Fzoompartner&amp;trk=organization_guest_main-feed-card-text\" target=\"_self\" data-tracking-control-name=\"organization_guest_main-feed-card-text\" data-tracking-will-navigate>#ZoomPartner</a> Mind blown by all the product features <a class=\"link\" href=\"https://www.linkedin.com/company/zoom?trk=organization_guest_main-feed-card-text\" target=\"_self\" data-tracking-control-name=\"organization_guest_main-feed-card-text\" data-tracking-will-navigate>Zoom</a> Al Companion has introduced to make work more productive <a class=\"link\" href=\"https://www.linkedin.com/signup/cold-join?session_redirect=https%3A%2F%2Fwww.linkedin.com%2Ffeed%2Fhashtag%2Fzoomahead&amp;trk=organization_guest_main-feed-card-text\" target=\"_self\" data-tracking-control-name=\"organization_guest_main-feed-card-text\" data-tracking-will-navigate>#ZoomAhead</a> <a class=\"link\" href=\"https://www.linkedin.com/signup/cold-join?session_redirect=https%3A%2F%2Fwww.linkedin.com%2Ffeed%2Fhashtag%2Fjointhemovement&amp;trk=organization_guest_main-feed-card-text\" target=\"_self\" data-tracking-control-name=\"organization_guest_main-feed-card-text\" data-tracking-will-navigate>#JoinTheMovement</a>",
          "time": "4d",
          "title": "Jonjon Perlas",
          "videos": [
            "https://dms.licdn.com/playlist/vid/v2/D5605AQFX_Y-7gNo6pQ/mp4-640p-30fp-crf28/B56ZzkKvIWKMBw-/0/1773354552092?e=2147483647&v=beta&t=DpI4CxpjD6LPqV-0o8rQc6-wehwrXkLoTARZk6au0D8",
            "https://dms.licdn.com/playlist/vid/v2/D5605AQFX_Y-7gNo6pQ/mp4-720p-30fp-crf28/B56ZzkKvIWKMCI-/0/1773354550978?e=2147483647&v=beta&t=G2Joz_R3qdMHWsIvsiabC6rBn-tce7s_8lc75sfWU9c"
          ]
        },
        {
          "comments_count": 2,
          "date": "2026-03-13T16:13:15.946Z",
          "images": [
            "https://media.licdn.com/dms/image/v2/D5612AQFyetvdvO6pnQ/article-cover_image-shrink_720_1280/B56Zzlo8NsJIAI-/0/1773379247714?e=2147483647&v=beta&t=N8kACz_0w2ni-81Y4JCPGuJYbOoDpjd1bv2LLNWiyrU"
          ],
          "likes_count": 82,
          "post_id": "7438255871790460928",
          "post_url": "https://www.linkedin.com/posts/zoom_turn-lets-follow-up-into-finished-work-activity-7438255871790460928-n4kw",
          "text": "At Enterprise Connect , we unveiled new innovations for Zoom Workplace designed to help teams move from conversation to completion. In our latest newsletter, Leo Boulton , Head of Product, Solutions, and Industry Marketing at Zoom, dives into these innovations and explains what this shift looks like in practice—and how AI can help reduce the friction that slows teams down. He breaks down: 🚀 What a “system of action” means for the future of work ✨ How Zoom AI Companion can help turn discussions into deliverables 💥 Why meeting friction is holding teams back Read the full newsletter below and let us know in the comments which innovation you’re most excited about. 👇 #EnterpriseConnect",
          "text_html": "At <a class=\"link\" href=\"https://uk.linkedin.com/company/enterpriseconnect?trk=organization_guest_main-feed-card-text\" target=\"_self\" data-tracking-control-name=\"organization_guest_main-feed-card-text\" data-tracking-will-navigate>Enterprise Connect</a>, we unveiled new innovations for Zoom Workplace designed to help teams move from conversation to completion.\n\nIn our latest newsletter, <a class=\"link\" href=\"https://www.linkedin.com/in/leoboulton?trk=organization_guest_main-feed-card-text\" target=\"_self\" data-tracking-control-name=\"organization_guest_main-feed-card-text\" data-tracking-will-navigate>Leo Boulton</a>, Head of Product, Solutions, and Industry Marketing at Zoom, dives into these innovations and explains what this shift looks like in practice&#x2014;and how AI can help reduce the friction that slows teams down.\n\nHe breaks down:\n&#x1F680; What a &#x201C;system of action&#x201D; means for the future of work\n&#x2728; How Zoom AI Companion can help turn discussions into deliverables\n&#x1F4A5; Why meeting friction is holding teams back\n\nRead the full newsletter below and let us know in the comments which innovation you&#x2019;re most excited about. &#x1F447;\n\n<a class=\"link\" href=\"https://www.linkedin.com/signup/cold-join?session_redirect=https%3A%2F%2Fwww.linkedin.com%2Ffeed%2Fhashtag%2Fenterpriseconnect&amp;trk=organization_guest_main-feed-card-text\" target=\"_self\" data-tracking-control-name=\"organization_guest_main-feed-card-text\" data-tracking-will-navigate>#EnterpriseConnect</a>",
          "time": "3d",
          "title": "Zoom"
        },
        {
          "date": "2026-03-12T23:20:43.792Z",
          "likes_count": 65,
          "post_id": "7438001058787868672",
          "post_url": "https://www.linkedin.com/feed/update/urn:li:activity:7438001058787868672/",
          "text": "#ZoomPartner l'm here at Enterprise Connect to see the latest innovations from the Zoom Booth. Impressed by all the product features Zoom has introduced with Al Companion to help make me more productive. #ZoomAhead #JoinTheMovement",
          "text_html": "<a class=\"link\" href=\"https://www.linkedin.com/signup/cold-join?session_redirect=https%3A%2F%2Fwww.linkedin.com%2Ffeed%2Fhashtag%2Fzoompartner&amp;trk=organization_guest_main-feed-card-text\" target=\"_self\" data-tracking-control-name=\"organization_guest_main-feed-card-text\" data-tracking-will-navigate>#ZoomPartner</a> l&apos;m here at Enterprise Connect to see the latest innovations from the <a class=\"link\" href=\"https://www.linkedin.com/company/zoom?trk=organization_guest_main-feed-card-text\" target=\"_self\" data-tracking-control-name=\"organization_guest_main-feed-card-text\" data-tracking-will-navigate>Zoom</a>  Booth. Impressed by all the product features Zoom has introduced with Al Companion to help make me more productive. <a class=\"link\" href=\"https://www.linkedin.com/signup/cold-join?session_redirect=https%3A%2F%2Fwww.linkedin.com%2Ffeed%2Fhashtag%2Fzoomahead&amp;trk=organization_guest_main-feed-card-text\" target=\"_self\" data-tracking-control-name=\"organization_guest_main-feed-card-text\" data-tracking-will-navigate>#ZoomAhead</a> <a class=\"link\" href=\"https://www.linkedin.com/signup/cold-join?session_redirect=https%3A%2F%2Fwww.linkedin.com%2Ffeed%2Fhashtag%2Fjointhemovement&amp;trk=organization_guest_main-feed-card-text\" target=\"_self\" data-tracking-control-name=\"organization_guest_main-feed-card-text\" data-tracking-will-navigate>#JoinTheMovement</a>",
          "time": "5d",
          "title": "William Bowers",
          "videos": [
            "https://dms.licdn.com/playlist/vid/v2/D4E05AQGCUmvQ_h-5xg/mp4-720p-30fp-crf28/B4EZzfC3UoHsCM-/0/1773268602681?e=2147483647&v=beta&t=pOf4vR8UU9URucZp8A9-nVehFDURjabY9Z9JyNfBIxk",
            "https://dms.licdn.com/playlist/vid/v2/D4E05AQGCUmvQ_h-5xg/mp4-640p-30fp-crf28/B4EZzfC3UoHsB0-/0/1773268602681?e=2147483647&v=beta&t=ogoGLE1vVNdSjLRgWv-Yk0YA-OAuAmr15hVieHHqKKw"
          ]
        },
        {
          "comments_count": 2,
          "date": "2026-03-12T18:25:13.067Z",
          "likes_count": 22,
          "post_id": "7437926690737049600",
          "post_url": "https://www.linkedin.com/posts/zoom_enterpriseconnect-activity-7437926690737049600-zWRU",
          "repost": {
            "repost_date": "202***3-1***7:1*********",
            "repost_hangtags": [
              "******",
              "******",
              "******",
              "#Ag***ic",
              "******"
            ],
            "repost_id": "743***776***610******",
            "repost_text": "Goo***nou***isn*********nou*********************es ***************************************************************************************************************************************************************************************************************",
            "repost_title": "Dav***ich***",
            "repost_url": "htt***//w***lin*********/fe*********************vit************************",
            "tagged_companies": [
              {
                "link": "htt***//w***lin*********/co*********************zat***************************************",
                "name": "******",
                "type": "company"
              }
            ],
            "tagged_users": [
              {
                "link": "htt***//w***lin*********/in*********************iza***************************************",
                "name": "Leo Boulton",
                "type": "people"
              }
            ],
            "videos": [
              "htt***//d***lic*********ayl*********************sPQ******************************************************************************************************************************",
              "htt***//d***lic*********ayl*********************sPQ******************************************************************************************************************************"
            ]
          },
          "text": "Great discussion from Dave Michels following the Enterprise Connect keynote. 🙌 As Leo Boulton , Head of Product, Solutions, and Industry Marketing at Zoom shared: 💬 “System of action is how we progress from a conversation to completion…the system of action is the framework underneath it. We talked about system of record which is more data centric...AI has been changing that. It's about the action that is performed by AI. When AI needs to capture insights, that conversation layer we're talking about needs to support and substantiate the actions that are performed. We're orchestrating the action of work.\" Check out the full conversation here. 👇 #EnterpriseConnect",
          "text_html": "Great discussion from <a class=\"link\" href=\"https://www.linkedin.com/in/davemichels?trk=organization_guest_main-feed-card-text\" target=\"_self\" data-tracking-control-name=\"organization_guest_main-feed-card-text\" data-tracking-will-navigate>Dave Michels</a> following the <a class=\"link\" href=\"https://uk.linkedin.com/company/enterpriseconnect?trk=organization_guest_main-feed-card-text\" target=\"_self\" data-tracking-control-name=\"organization_guest_main-feed-card-text\" data-tracking-will-navigate>Enterprise Connect</a> keynote. &#x1F64C;\n\nAs <a class=\"link\" href=\"https://www.linkedin.com/in/leoboulton?trk=organization_guest_main-feed-card-text\" target=\"_self\" data-tracking-control-name=\"organization_guest_main-feed-card-text\" data-tracking-will-navigate>Leo Boulton</a>, Head of Product, Solutions, and Industry Marketing at Zoom shared:\n\n&#x1F4AC; &#x201C;System of action is how we progress from a conversation to completion&#x2026;the system of action is the framework underneath it. We talked about system of record which is more data centric...AI has been changing that. It&apos;s about the action that is performed by AI. When AI needs to capture insights, that conversation layer we&apos;re talking about needs to support and substantiate the actions that are performed. We&apos;re orchestrating the action of work.&quot;\n\nCheck out the full conversation here. &#x1F447;\n\n<a class=\"link\" href=\"https://www.linkedin.com/signup/cold-join?session_redirect=https%3A%2F%2Fwww.linkedin.com%2Ffeed%2Fhashtag%2Fenterpriseconnect&amp;trk=organization_guest_main-feed-card-text\" target=\"_self\" data-tracking-control-name=\"organization_guest_main-feed-card-text\" data-tracking-will-navigate>#EnterpriseConnect</a>",
          "time": "4d",
          "title": "Zoom",
          "videos": [
            "https://dms.licdn.com/playlist/vid/v2/D5605AQFTOsPQPO90LA/mp4-720p-30fp-crf28/B56Zzg50JWKUCM-/0/1773299879942?e=2147483647&v=beta&t=JorMvMOCh-nKPefhc1iYnIbPbmHQIwnshO1At-TqjZs",
            "https://dms.licdn.com/playlist/vid/v2/D5605AQFTOsPQPO90LA/mp4-640p-30fp-crf28/B56Zzg50JWKUB0-/0/1773299859947?e=2147483647&v=beta&t=Nf7fIU7mN3ipy8kFj01jCrjYZnZLXqctn9Xkz5t2Vm8"
          ]
        },
        {
          "comments_count": 1,
          "date": "2026-03-11T18:50:11.079Z",
          "likes_count": 79,
          "post_id": "7437570585989124099",
          "post_url": "https://www.linkedin.com/posts/zoom_conversation-to-completion-activity-7437570585989124099-uYtQ",
          "text": "Meetings don’t slow work down. Endless follow-ups do. 🫠 94% of employees say friction is slowing them down. 🐌 Why? Context gets lost between preparation, discussion, and follow-up. At Zoom, we focused on giving you the tools to drive Conversation ➡️ Completion. With AI Companion, tasks flow naturally, so teams spend less time chasing context and more time driving decisions forward. ✨ #EnterpriseConnect",
          "text_html": "Meetings don&#x2019;t slow work down. Endless follow-ups do. &#x1FAE0;\n\n94% of employees say friction is slowing them down. &#x1F40C;\n\nWhy? Context gets lost between preparation, discussion, and follow-up.\n\nAt Zoom, we focused on giving you the tools to drive Conversation &#x27A1;&#xFE0F; Completion. \n\nWith AI Companion, tasks flow naturally, so teams spend less time chasing context and more time driving decisions forward. &#x2728;\n\n<a class=\"link\" href=\"https://www.linkedin.com/signup/cold-join?session_redirect=https%3A%2F%2Fwww.linkedin.com%2Ffeed%2Fhashtag%2Fenterpriseconnect&amp;trk=organization_guest_main-feed-card-text\" target=\"_self\" data-tracking-control-name=\"organization_guest_main-feed-card-text\" data-tracking-will-navigate>#EnterpriseConnect</a>",
          "time": "5d",
          "title": "Zoom",
          "videos": [
            "https://dms.licdn.com/playlist/vid/v2/D5610AQH5CIOh97Lpww/mp4-720p-30fp-crf28/B56ZzePBSzJkCA-/0/1773255008652?e=2147483647&v=beta&t=xm2AQU192ejkgZQNj4A3C6HVaTVzbcMwuYRUGJPON0I",
            "https://dms.licdn.com/playlist/vid/v2/D5610AQH5CIOh97Lpww/mp4-360p-30fp-crf28/B56ZzePBSzJkB8-/0/1773255008653?e=2147483647&v=beta&t=SA88DFW7pDlf5o34Pg-F4GmjeY_pL3d6ix4Uf57jQNE",
            "https://dms.licdn.com/playlist/vid/v2/D5610AQH5CIOh97Lpww/mp4-640p-30fp-crf28/B56ZzePBSzJkBk-/0/1773255008653?e=2147483647&v=beta&t=GAoyPtRISNkCJVbU_75fIG92tDcFQCoQLRLpzucaVfc"
          ]
        },
        {
          "comments_count": 2,
          "date": "2026-03-10T23:47:39.433Z",
          "images": [
            "https://media.licdn.com/dms/image/v2/D5622AQFNx1LWnmJw6A/feedshare-shrink_1280/B56ZzaJh3zGgAM-/0/1773186457356?e=2147483647&v=beta&t=4SgrmeXNZaO4bui8FQycnxbWxbEXowlnNxVmCpFBsZc",
            "https://media.licdn.com/dms/image/v2/D5622AQF4OfdDTczLIA/feedshare-shrink_800/B56ZzaJh5xHIAc-/0/1773186457499?e=2147483647&v=beta&t=AhvCx0PgZPYRKdWGtWYFIXT-VZLLsW3swwlhAU2VGqo",
            "https://media.licdn.com/dms/image/v2/D5622AQESoAZHI4VUew/feedshare-shrink_1280/B56ZzaJh8xGgAM-/0/1773186457681?e=2147483647&v=beta&t=vN9KpnNBP-9qFc1VaPTbrfUZn7vE-s7M_Mfzvw84ZXo",
            "https://media.licdn.com/dms/image/v2/D5622AQHfoDT_kvNf_w/feedshare-shrink_2048_1536/B56ZzaJh8aGQAg-/0/1773186457654?e=2147483647&v=beta&t=nlP2i-bLo6H36F9u1z8gaELFXHWNgbcLtiloMkR_mJo"
          ],
          "likes_count": 218,
          "post_id": "7437283059546284032",
          "post_url": "https://www.linkedin.com/posts/zoom_enterpriseconnect-activity-7437283059546284032-UFKx",
          "text": "At #EnterpriseConnect , we’re showcasing how Zoom is transforming the way organizations operate—by eliminating friction and connecting every part of work into one seamless system of action. Stop by our booth to experience how our unified platform turns communication into momentum.",
          "text_html": "At <a class=\"link\" href=\"https://www.linkedin.com/signup/cold-join?session_redirect=https%3A%2F%2Fwww.linkedin.com%2Ffeed%2Fhashtag%2Fenterpriseconnect&amp;trk=organization_guest_main-feed-card-text\" target=\"_self\" data-tracking-control-name=\"organization_guest_main-feed-card-text\" data-tracking-will-navigate>#EnterpriseConnect</a>, we&#x2019;re showcasing how Zoom is transforming the way organizations operate&#x2014;by eliminating friction and connecting every part of work into one seamless system of action.\n\nStop by our booth to experience how our unified platform turns communication into momentum.",
          "time": "6d",
          "title": "Zoom"
        },
        {
          "comments_count": 2,
          "date": "2026-03-10T21:00:34.504Z",
          "likes_count": 151,
          "post_id": "7437241011946377216",
          "post_url": "https://www.linkedin.com/posts/zoom_zoom-innovations-from-ec-2026-activity-7437241011946377216-_rC2",
          "text": "We’re announcing major Zoom innovations at Enterprise Connect this week—and you’re getting the first look. 🚀 Swipe through for a sneak peek at what’s coming. Full details in the comments. ✨ Which of these are you most excited about? 💬 #EnterpriseConnect | Enterprise Connect",
          "text_html": "We&#x2019;re announcing major Zoom innovations at Enterprise Connect this week&#x2014;and you&#x2019;re getting the first look. &#x1F680;\n\nSwipe through for a sneak peek at what&#x2019;s coming. Full details in the comments. &#x2728;\n\nWhich of these are you most excited about? &#x1F4AC;\n\n<a class=\"link\" href=\"https://www.linkedin.com/signup/cold-join?session_redirect=https%3A%2F%2Fwww.linkedin.com%2Ffeed%2Fhashtag%2Fenterpriseconnect&amp;trk=organization_guest_main-feed-card-text\" target=\"_self\" data-tracking-control-name=\"organization_guest_main-feed-card-text\" data-tracking-will-navigate>#EnterpriseConnect</a> | <a class=\"link\" href=\"https://uk.linkedin.com/company/enterpriseconnect?trk=organization_guest_main-feed-card-text\" target=\"_self\" data-tracking-control-name=\"organization_guest_main-feed-card-text\" data-tracking-will-navigate>Enterprise Connect</a> ",
          "time": "6d",
          "title": "Zoom"
        }
      ],
      "slogan": "AI-First Work Platform for Human Connection ✨",
      "affiliated": [
        {
          "Links": "https://www.linkedin.com/showcase/zoom-ventures/?trk=affiliated-pages",
          "location": "San Jose, California",
          "subtitle": "Venture Capital and Private Equity Principals",
          "title": "Zoom Ventures"
        },
        {
          "Links": "https://www.linkedin.com/showcase/zoom-docs/?trk=affiliated-pages",
          "location": null,
          "subtitle": "IT Services and IT Consulting",
          "title": "Zoom Docs"
        },
        {
          "Links": "https://www.linkedin.com/showcase/zoom-revenue-accelerator/?trk=affiliated-pages",
          "location": null,
          "subtitle": "IT Services and IT Consulting",
          "title": "Zoom Revenue Accelerator"
        },
        {
          "Links": "https://www.linkedin.com/showcase/zoom-clips/?trk=affiliated-pages",
          "location": null,
          "subtitle": "IT Services and IT Consulting",
          "title": "Zoom Clips"
        },
        {
          "Links": "https://www.linkedin.com/showcase/zoom-whiteboard/?trk=affiliated-pages",
          "location": null,
          "subtitle": "IT Services and IT Consulting",
          "title": "Zoom Whiteboard"
        },
        {
          "Links": "https://www.linkedin.com/showcase/zoom-scheduler/?trk=affiliated-pages",
          "location": null,
          "subtitle": "IT Services and IT Consulting",
          "title": "Zoom Scheduler"
        }
      ],
      "funding": {
        "last_round_date": "2021-12-04T00:00:00.000Z",
        "last_round_raised": "US$ 130.0M",
        "last_round_type": "Post IPO equity",
        "rounds": 9
      },
      "investors": [
        "ARK Investment Management"
      ],
      "formatted_locations": [
        "55 Almaden Blvd., 6th Floor, San Jose, CA 95113, San Jose, CA 95113, US",
        "Level 1, 9 Castlereagh St, Sydney, NSW 2000, AU",
        "8000 Avalon Blvd, Suite 100, space 216, Alpharetta, Georgia 30008, US",
        "7601 E Technology Way, 3rd Floor, Denver, Colorado 80237, US",
        "6601 College Blvd, Suite 120, Overland Park, Kansas 66211, US",
        "200 E Carrillo St, Suite #300, Santa Barbara, California 93101, US",
        "The Place, 4th Floor, 175 High, Holborn, London WC1V 7AA, GB",
        "Zoom France, 33 Rue lafayette, lafayette, Paris 75009, FR",
        "6 Temasek Boulevard, Suntec Tower 5 #17-103, Singapore, SGP 038985, SG",
        "Wework Hibiya park Front, 19th floor, 2-1-6 Uchisaiwai-cho, Chiyoda-ku, Tokyo 100-0011, JP",
        "Wework 5th floor, Strawinskylaan 4117, Strawinskylaan, Amsterdam 1077 ZX, NL"
      ],
      "stock_info": null,
      "get_directions_url": [
        {
          "directions_url": "https://www.bing.com/maps?where=55+Almaden+Blvd.%2C+6th+Floor%2C+San+Jose%2C+CA+95113+San+Jose+95113+CA+US&trk=org-locations_url"
        },
        {
          "directions_url": "https://www.bing.com/maps?where=Level+1%2C+9+Castlereagh+St+Sydney+2000+NSW+AU&trk=org-locations_url"
        },
        {
          "directions_url": "https://www.bing.com/maps?where=8000+Avalon+Blvd++Suite+100%2C+space+216+Alpharetta+30008+Georgia+US&trk=org-locations_url"
        },
        {
          "directions_url": "https://www.bing.com/maps?where=7601+E+Technology+Way+3rd+Floor+Denver+80237+Colorado++US&trk=org-locations_url"
        },
        {
          "directions_url": "https://www.bing.com/maps?where=6601+College+Blvd+Suite+120+Overland+Park+66211+Kansas++US&trk=org-locations_url"
        },
        {
          "directions_url": "https://www.bing.com/maps?where=200+E+Carrillo+St+Suite+%23300+Santa+Barbara+93101+California+US&trk=org-locations_url"
        },
        {
          "directions_url": "https://www.bing.com/maps?where=The+Place%2C+4th+Floor%2C+175+High+Holborn+WC1V+7AA+London+GB&trk=org-locations_url"
        },
        {
          "directions_url": "https://www.bing.com/maps?where=Zoom+France%2C+33+Rue+lafayette+lafayette+75009+Paris++FR&trk=org-locations_url"
        },
        {
          "directions_url": "https://www.bing.com/maps?where=6+Temasek+Boulevard+Suntec+Tower+5+%2317-103+Singapore+038985+SGP+SG&trk=org-locations_url"
        },
        {
          "directions_url": "https://www.bing.com/maps?where=Wework+Hibiya+park+Front+19th+floor%2C+2-1-6+Uchisaiwai-cho+Chiyoda-ku+100-0011+Tokyo+JP&trk=org-locations_url"
        },
        {
          "directions_url": "https://www.bing.com/maps?where=Wework+5th+floor%2C+Strawinskylaan+4117+Strawinskylaan+1077+ZX+Amsterdam++NL&trk=org-locations_url"
        }
      ],
      "description": "Zoom | 653,039 followers on LinkedIn. AI-First Work Platform for Human Connection ✨ | Bring teams together, reimagine workspaces, engage new audiences, and delight your customers –– all on the Zoom AI-first work platform you know and love. 💙\n\nZoomies help people stay connected so they can get more done together. We set out on a mission to make video communications frictionless and secure by building the world’s best video product for the enterprise, but we didn’t stop there. With products like AI Companion, Team Chat, Contact Center, Phone, Events, Rooms, Webinar, Contact Center and more, we bring innovation to a wide variety of customers, from the conference room to the classroom, from doctor’s offices to financial institutions to government agencies, from global brands to small businesses.",
      "additional_information": "Additional jobs info: Zoom (27,487 open jobs). Engineer (555,845 open jobs). Manager (1,880,925 open jobs). Analyst (694,057 open jobs). Account Executive (71,457 open jobs). Project Manager (253,048 open jobs). Account Manager (121,519 open jobs). Associate (1,091,945 open jobs). Marketing Manager (106,879 open jobs). Director (1,220,357 open jobs). Specialist (768,666 open jobs). Enterprise Account Executive (44,389 open jobs). Executive (690,514 open jobs). Developer (258,935 open jobs). Product Designer (45,389 open jobs). Scientist (48,969 open jobs). Intern (71,196 open jobs). Site Reliability Engineer (169,128 open jobs). Software Engineer (300,699 open jobs). Consultant (760,907 open jobs)",
      "country_codes_array": [
        "US",
        "AU",
        "GB",
        "FR",
        "SG",
        "JP",
        "NL"
      ],
      "alumni": null,
      "alumni_information": null,
      "website_simplified": "zoo***om",
      "unformatted_about": "\n              Bring teams together, reimagine workspaces, engage new audiences, and delight your customers –– all on the Zoom AI-first work platform you know and love. 💙\n\nZoomies help people stay connected so they can get more done together. We set out on a mission to make video communications frictionless and secure by building the world’s best video product for the enterprise, but we didn’t stop there. With products like AI Companion, Team Chat, Contact Center, Phone, Events, Rooms, Webinar, Contact Center and more, we bring innovation to a wide variety of customers, from the conference room to the classroom, from doctor’s offices to financial institutions to government agencies, from global brands to small businesses.\n\nWe do what we do because of our core value of Care: care for our community, our customers, our company, our teammates, and ourselves. Our global employees help our customers meet happier, communicate better, and create meaningful connections the world over. Zoomies are problem-solvers and self-starters, working hard to get results and moving quickly to design solutions with our customers and users in mind. Here, you'll find room to grow with opportunities to stretch your skills and advance your career in a collaborative, growth-focused environment.\n\nLearn more about careers at Zoom by visiting our careers site: https://careers.zoom.us/home\n          "
    }
  ]
  ```
</ResponseExample>


# Collect LinkedIn jobs by URL
Source: https://docs.brightdata.com/api-reference/scrapers/social-media-apis/linkedin-jobs-collect-by-url

api-reference/sdk-specs/linkedin-jobs-collect-by-url POST /datasets/v3/scrape
Collect structured LinkedIn job posting data by URL using the Bright Data Web Scraper API with dataset ID gd_lpfll7v5hcqtkxl6l for job details and metadata.

## Query Parameters

<ParamField type="string">
  The dataset ID used for this request.

  <Warning>
    Must be set to `gd_lpfll7v5hcqtkxl6l` to collect **Jobs by URL** data.
  </Warning>
</ParamField>

<ParamField type="boolean">
  Whether to send notifications when the request is completed.
</ParamField>

<ParamField type="boolean">
  Whether to include errors in the response.
</ParamField>

## Request Body

<ParamField type="object[]">
  An array of input objects.

  <Expandable title="properties">
    <ParamField type="string">
      The URL of the LinkedIn job listing to collect.
    </ParamField>
  </Expandable>

  #### Example

  ```json theme={null}
  {
    "input":[
      {"url":"https://www.linkedin.com/jobs/view/software-engineer-at-epic-3986111804?_l=en"},
      {"url":"https://www.linkedin.com/jobs/view/software-engineer-at-pave-4310512612/"}
    ]
  }
  ```
</ParamField>

<ResponseExample>
  ```json 200 theme={null}
  [
    {
      "url": "https://www.linkedin.com/jobs/view/pharmacy-technician-at-walmart-4385163817?_l=en",
      "job_posting_id": "4385163817",
      "job_title": "Pharmacy Technician",
      "company_name": "Walmart",
      "company_id": "2646",
      "job_location": "Fayetteville, NC",
      "job_summary": "Hourly Wage: $16 - $29 per/hour The actual hourly rate will equal or exceed the required minimum wage applicable to the job location. Additional Compensation Includes Annual Or Quarterly Performance Incentives. Additional compensation in the form of premiums may be paid in amounts ranging from $0.35 per hour to $3.00 per hour in specific circumstances. Premiums may be based on schedule, facility, season, or specific work performed. Multiple premiums may apply if applicable criteria are met. Employment Type: Part-Time Available shifts: Mid-Shift, Closing Location Walmart Supercenter #3595 7701 S RAEFORD RD, FAYETTEVILLE, NC, 28304, US Job Overview Pharmacy associates focus on the needs of our customers as they entrust us with their prescriptions and health needs. They are responsible for inputting and processing prescriptions, supporting patients with product information, and providing customer service in our store pharmacies. Benefits & perks At Walmart, we offer competitive pay as well as performance-based incentive awards and other great benefits for a happier mind, body, and wallet. Health benefits include medical, vision and dental coverage. Financial benefits include 401(k), stock purchase and company-paid life insurance. Paid time off benefits include parental leave, family care leave, bereavement, jury duty, and voting. Other benefits include short-term and long-term disability, company discounts, Military Leave Pay, adoption and surrogacy expense reimbursement, and more. You will also receive PTO and/or PPTO that can be used for vacation, sick leave, holidays, or other purposes. The amount you receive depends on your job classification and length of employment. It will meet or exceed the requirements of paid sick leave laws, where applicable. For information about PTO, see Smart Guide page Live Better U is a Walmart-paid education benefit program for full-time and part-time associates in Walmart and Sam's Club facilities. Programs range from high school completion to bachelor's degrees, including English Language Learning and short-form certificates. Tuition, books, and fees are completely paid for by Walmart. Eligibility requirements apply to some benefits and may depend on your job classification and length of employment. Benefits are subject to change and may be subject to a specific plan or program terms. For information about benefits and eligibility, see One.Walmart.com. Walmart is committed to maintaining a drug-free workplace and has a no tolerance policy regarding the use of illegal drugs and alcohol on the job. This policy applies to all employees and aims to create a safe and productive work environment. Show more Show less",
      "job_seniority_level": "Entry level",
      "job_function": "Health Care Provider",
      "job_employment_type": "Part-time",
      "job_industries": "Retail",
      "job_base_pay_range": "$16.00/hr - $29.00/hr",
      "company_url": "https://www.linkedin.com/company/walmart?trk=public_jobs_topcard-org-name",
      "job_posted_time": "4 days ago",
      "job_num_applicants": 25,
      "discovery_input": {
        "experience_level": null,
        "job_type": null,
        "remote": null,
        "selective_search": null,
        "time_range": null
      },
      "apply_link": null,
      "country_code": "US",
      "title_id": "1062",
      "company_logo": "https://media.licdn.com/dms/image/v2/D560BAQHZkPdlecGssw/company-logo_100_100/company-logo_100_100/0/1736779000209/walmart_logo?e=2147483647&v=beta&t=tWcWIFSyHtICTzTLIPiYeKCp21XucI-HWijZdWwYR-A",
      "job_posted_date": "2026-03-13T09:48:59.171Z",
      "job_poster": {
        "name": null,
        "title": null,
        "url": null
      },
      "application_availability": true,
      "job_description_formatted": "<section class=\"show-more-less-html\" data-max-lines=\"5\">\n        <div class=\"show-more-less-html__markup show-more-less-html__markup--clamp-after-5\n            relative overflow-hidden\">\n          Hourly Wage: <strong>$16 - $29 per/hour<br><br></strong><ul><li>The actual hourly rate will equal or exceed the required minimum wage applicable to the job location.<br><br></li></ul><strong>Additional Compensation Includes Annual Or Quarterly Performance Incentives.<br><br></strong>Additional compensation in the form of premiums may be paid in amounts ranging from $0.35 per hour to $3.00 per hour in specific circumstances. Premiums may be based on schedule, facility, season, or specific work performed. Multiple premiums may apply if applicable criteria are met.<br><br>Employment Type: <strong>Part-Time<br><br></strong>Available shifts: <strong>Mid-Shift, Closing<br><br></strong>Location<br><br><strong>Walmart Supercenter #3595<br><br></strong>7701 S RAEFORD RD, FAYETTEVILLE, NC, 28304, US<br><br><strong>Job Overview<br><br></strong>Pharmacy associates focus on the needs of our customers as they entrust us with their prescriptions and health needs. They are responsible for inputting and processing prescriptions, supporting patients with product information, and providing customer service in our store pharmacies.<br><br>Benefits &amp; perks<br><br>At Walmart, we offer competitive pay as well as performance-based incentive awards and other great benefits for a happier mind, body, and wallet. Health benefits include medical, vision and dental coverage. Financial benefits include 401(k), stock purchase and company-paid life insurance. Paid time off benefits include parental leave, family care leave, bereavement, jury duty, and voting. Other benefits include short-term and long-term disability, company discounts, Military Leave Pay, adoption and surrogacy expense reimbursement, and more.<br><br>You will also receive PTO and/or PPTO that can be used for vacation, sick leave, holidays, or other purposes. The amount you receive depends on your job classification and length of employment. It will meet or exceed the requirements of paid sick leave laws, where applicable. For information about PTO, see Smart Guide page<br><br>Live Better U is a Walmart-paid education benefit program for full-time and part-time associates in Walmart and Sam&apos;s Club facilities. Programs range from high school completion to bachelor&apos;s degrees, including English Language Learning and short-form certificates. Tuition, books, and fees are completely paid for by Walmart.<br><br>Eligibility requirements apply to some benefits and may depend on your job classification and length of employment. Benefits are subject to change and may be subject to a specific plan or program terms. For information about benefits and eligibility, see One.Walmart.com.<br><br>Walmart is committed to maintaining a drug-free workplace and has a no tolerance policy regarding the use of illegal drugs and alcohol on the job. This policy applies to all employees and aims to create a safe and productive work environment.\n        </div>\n\n        \n\n    \n    \n    \n\n    <button class=\"show-more-less-html__button show-more-less-button\n        show-more-less-html__button--more\n        ml-0.5\" data-tracking-control-name=\"public_jobs_show-more-html-btn\" aria-label=\"Show more\" aria-expanded=\"false\">\n<!---->\n        \n            Show more\n          \n\n          <icon class=\"show-more-less-html__button-icon show-more-less-button-icon\" data-delayed-url=\"https://static.licdn.com/aero-v1/sc/h/cyolgscd0imw2ldqppkrb84vo\"></icon>\n    </button>\n  \n\n        \n\n    \n    \n    \n\n    <button class=\"show-more-less-html__button show-more-less-button\n        show-more-less-html__button--less\n        ml-0.5\" data-tracking-control-name=\"public_jobs_show-less-html-btn\" aria-label=\"Show less\" aria-expanded=\"true\">\n<!---->\n        \n            Show less\n          \n\n          <icon class=\"show-more-less-html__button-icon show-more-less-button-icon\" data-delayed-url=\"https://static.licdn.com/aero-v1/sc/h/4chtt12k98xwnba1nimld2oyg\"></icon>\n    </button>\n  \n<!---->    </section>",
      "base_salary": {
        "currency": "$",
        "max_amount": 29,
        "min_amount": 16,
        "payment_period": "hr"
      },
      "salary_standards": "This range is provided by Walmart. Your actual pay will be based on your skills and experience — talk with your recruiter to learn more.",
      "is_easy_apply": false
    }
  ]
  ```
</ResponseExample>


# Discover LinkedIn jobs by keyword
Source: https://docs.brightdata.com/api-reference/scrapers/social-media-apis/linkedin-jobs-discover-by-keyword

POST https://api.brightdata.com/datasets/v3/scrape
Use the Bright Data Web Scraper API to discover LinkedIn Jobs by Keyword. Calls the POST /datasets/v3/scrape endpoint and returns a snapshot ID.

## Query Parameters

<ParamField type="string">
  The dataset ID used for this request.

  <Warning>
    Must be set to `gd_lpfll7v5hcqtkxl6l` to collect **Discover Jobs by Keyword** data.
  </Warning>
</ParamField>

<ParamField type="string">
  Must be set to `discover_new`.
</ParamField>

<ParamField type="string">
  Must be set to `keyword`.
</ParamField>

<ParamField type="boolean">
  Whether to send notifications when the request is completed.
</ParamField>

<ParamField type="boolean">
  Whether to include errors in the response.
</ParamField>

## Request Body

<ParamField type="object[]">
  An array of input objects.

  <Expandable title="properties">
    <ParamField type="string">
      Collect jobs in a specific location
    </ParamField>

    <ParamField type="string">
      Collect new jobs by keyword search like the job title, for example: Product Manager. Utilize quotation marks around specific words or phrases to ensure an exact match.
    </ParamField>

    <ParamField type="string">
      Use country code with 2 letters like `US` or `FR`
    </ParamField>

    <ParamField type="string">
      Time range of the job posting
    </ParamField>

    <ParamField type="string">
      Collect jobs from specific type like Full-time or Part-time
    </ParamField>

    <ParamField type="string">
      Collect jobs from a specific experience level
    </ParamField>

    <ParamField type="string">
      Specify if you want to collect only "Remote", "On-site" or "Hybrid" jobs
    </ParamField>

    <ParamField type="string">
      Collect jobs from a specific company
    </ParamField>

    <ParamField type="boolean">
      When set to true, the filter will exclude titles that do not contain the specified keywords
    </ParamField>

    <ParamField type="string[]">
      Jobs IDs to exclude
    </ParamField>

    <ParamField type="string" />
  </Expandable>

  #### Example

  ```json wrap theme={null}
  {
    "input":[
      {
        "location":"paris",
        "keyword":"product manager",
        "country":"FR",
        "time_range":"Past month",
        "job_type":"Full-time",
        "experience_level":"Internship",
        "remote":"On-site",
        "company":"",
        "location_radius":""
      },
      {
        "location":"New York",
        "keyword":"\"python developer\"",
        "experience_level":"Executive",
        "country":"",
        "time_range":"",
        "job_type":"",
        "remote":"",
        "company":"",
        "location_radius":""
      }
    ]
  }
  ```
</ParamField>

## Response

<ResponseExample>
  ```json 200 theme={null}
  [
    {
      "url": "https://www.linkedin.com/jobs/view/pharmacy-technician-at-walmart-4385163817?_l=en",
      "job_posting_id": "4385163817",
      "job_title": "Pharmacy Technician",
      "company_name": "Walmart",
      "company_id": "2646",
      "job_location": "Fayetteville, NC",
      "job_summary": "Hourly Wage: $16 - $29 per/hour The actual hourly rate will equal or exceed the required minimum wage applicable to the job location. Additional Compensation Includes Annual Or Quarterly Performance Incentives. Additional compensation in the form of premiums may be paid in amounts ranging from $0.35 per hour to $3.00 per hour in specific circumstances. Premiums may be based on schedule, facility, season, or specific work performed. Multiple premiums may apply if applicable criteria are met. Employment Type: Part-Time Available shifts: Mid-Shift, Closing Location Walmart Supercenter #3595 7701 S RAEFORD RD, FAYETTEVILLE, NC, 28304, US Job Overview Pharmacy associates focus on the needs of our customers as they entrust us with their prescriptions and health needs. They are responsible for inputting and processing prescriptions, supporting patients with product information, and providing customer service in our store pharmacies. Benefits & perks At Walmart, we offer competitive pay as well as performance-based incentive awards and other great benefits for a happier mind, body, and wallet. Health benefits include medical, vision and dental coverage. Financial benefits include 401(k), stock purchase and company-paid life insurance. Paid time off benefits include parental leave, family care leave, bereavement, jury duty, and voting. Other benefits include short-term and long-term disability, company discounts, Military Leave Pay, adoption and surrogacy expense reimbursement, and more. You will also receive PTO and/or PPTO that can be used for vacation, sick leave, holidays, or other purposes. The amount you receive depends on your job classification and length of employment. It will meet or exceed the requirements of paid sick leave laws, where applicable. For information about PTO, see Smart Guide page Live Better U is a Walmart-paid education benefit program for full-time and part-time associates in Walmart and Sam's Club facilities. Programs range from high school completion to bachelor's degrees, including English Language Learning and short-form certificates. Tuition, books, and fees are completely paid for by Walmart. Eligibility requirements apply to some benefits and may depend on your job classification and length of employment. Benefits are subject to change and may be subject to a specific plan or program terms. For information about benefits and eligibility, see One.Walmart.com. Walmart is committed to maintaining a drug-free workplace and has a no tolerance policy regarding the use of illegal drugs and alcohol on the job. This policy applies to all employees and aims to create a safe and productive work environment. Show more Show less",
      "job_seniority_level": "Entry level",
      "job_function": "Health Care Provider",
      "job_employment_type": "Part-time",
      "job_industries": "Retail",
      "job_base_pay_range": "$16.00/hr - $29.00/hr",
      "company_url": "https://www.linkedin.com/company/walmart?trk=public_jobs_topcard-org-name",
      "job_posted_time": "4 days ago",
      "job_num_applicants": 25,
      "discovery_input": {
        "experience_level": null,
        "job_type": null,
        "remote": null,
        "selective_search": null,
        "time_range": null
      },
      "apply_link": null,
      "country_code": "US",
      "title_id": "1062",
      "company_logo": "https://media.licdn.com/dms/image/v2/D560BAQHZkPdlecGssw/company-logo_100_100/company-logo_100_100/0/1736779000209/walmart_logo?e=2147483647&v=beta&t=tWcWIFSyHtICTzTLIPiYeKCp21XucI-HWijZdWwYR-A",
      "job_posted_date": "2026-03-13T09:48:59.171Z",
      "job_poster": {
        "name": null,
        "title": null,
        "url": null
      },
      "application_availability": true,
      "job_description_formatted": "<section class=\"show-more-less-html\" data-max-lines=\"5\">\n        <div class=\"show-more-less-html__markup show-more-less-html__markup--clamp-after-5\n            relative overflow-hidden\">\n          Hourly Wage: <strong>$16 - $29 per/hour<br><br></strong><ul><li>The actual hourly rate will equal or exceed the required minimum wage applicable to the job location.<br><br></li></ul><strong>Additional Compensation Includes Annual Or Quarterly Performance Incentives.<br><br></strong>Additional compensation in the form of premiums may be paid in amounts ranging from $0.35 per hour to $3.00 per hour in specific circumstances. Premiums may be based on schedule, facility, season, or specific work performed. Multiple premiums may apply if applicable criteria are met.<br><br>Employment Type: <strong>Part-Time<br><br></strong>Available shifts: <strong>Mid-Shift, Closing<br><br></strong>Location<br><br><strong>Walmart Supercenter #3595<br><br></strong>7701 S RAEFORD RD, FAYETTEVILLE, NC, 28304, US<br><br><strong>Job Overview<br><br></strong>Pharmacy associates focus on the needs of our customers as they entrust us with their prescriptions and health needs. They are responsible for inputting and processing prescriptions, supporting patients with product information, and providing customer service in our store pharmacies.<br><br>Benefits &amp; perks<br><br>At Walmart, we offer competitive pay as well as performance-based incentive awards and other great benefits for a happier mind, body, and wallet. Health benefits include medical, vision and dental coverage. Financial benefits include 401(k), stock purchase and company-paid life insurance. Paid time off benefits include parental leave, family care leave, bereavement, jury duty, and voting. Other benefits include short-term and long-term disability, company discounts, Military Leave Pay, adoption and surrogacy expense reimbursement, and more.<br><br>You will also receive PTO and/or PPTO that can be used for vacation, sick leave, holidays, or other purposes. The amount you receive depends on your job classification and length of employment. It will meet or exceed the requirements of paid sick leave laws, where applicable. For information about PTO, see Smart Guide page<br><br>Live Better U is a Walmart-paid education benefit program for full-time and part-time associates in Walmart and Sam&apos;s Club facilities. Programs range from high school completion to bachelor&apos;s degrees, including English Language Learning and short-form certificates. Tuition, books, and fees are completely paid for by Walmart.<br><br>Eligibility requirements apply to some benefits and may depend on your job classification and length of employment. Benefits are subject to change and may be subject to a specific plan or program terms. For information about benefits and eligibility, see One.Walmart.com.<br><br>Walmart is committed to maintaining a drug-free workplace and has a no tolerance policy regarding the use of illegal drugs and alcohol on the job. This policy applies to all employees and aims to create a safe and productive work environment.\n        </div>\n\n        \n\n    \n    \n    \n\n    <button class=\"show-more-less-html__button show-more-less-button\n        show-more-less-html__button--more\n        ml-0.5\" data-tracking-control-name=\"public_jobs_show-more-html-btn\" aria-label=\"Show more\" aria-expanded=\"false\">\n<!---->\n        \n            Show more\n          \n\n          <icon class=\"show-more-less-html__button-icon show-more-less-button-icon\" data-delayed-url=\"https://static.licdn.com/aero-v1/sc/h/cyolgscd0imw2ldqppkrb84vo\"></icon>\n    </button>\n  \n\n        \n\n    \n    \n    \n\n    <button class=\"show-more-less-html__button show-more-less-button\n        show-more-less-html__button--less\n        ml-0.5\" data-tracking-control-name=\"public_jobs_show-less-html-btn\" aria-label=\"Show less\" aria-expanded=\"true\">\n<!---->\n        \n            Show less\n          \n\n          <icon class=\"show-more-less-html__button-icon show-more-less-button-icon\" data-delayed-url=\"https://static.licdn.com/aero-v1/sc/h/4chtt12k98xwnba1nimld2oyg\"></icon>\n    </button>\n  \n<!---->    </section>",
      "base_salary": {
        "currency": "$",
        "max_amount": 29,
        "min_amount": 16,
        "payment_period": "hr"
      },
      "salary_standards": "This range is provided by Walmart. Your actual pay will be based on your skills and experience — talk with your recruiter to learn more.",
      "is_easy_apply": false
    }
  ]
  ```
</ResponseExample>


# Discover LinkedIn jobs by URL
Source: https://docs.brightdata.com/api-reference/scrapers/social-media-apis/linkedin-jobs-discover-by-url

POST https://api.brightdata.com/datasets/v3/scrape
Discover LinkedIn jobs by a search URL using the Bright Data Web Scraper API with dataset ID gd_lpfll7v5hcqtkxl6l for paginated job listing results.

## Query Parameters

<ParamField type="string">
  The dataset ID used for this request.

  <Warning>
    Must be set to `gd_lpfll7v5hcqtkxl6l` to collect **Discover Jobs by Job Search URL** data.
  </Warning>
</ParamField>

<ParamField type="string">
  Must be set to `discover_new`.
</ParamField>

<ParamField type="string">
  Must be set to `url`.
</ParamField>

<ParamField type="boolean">
  Whether to send notifications when the request is completed.
</ParamField>

<ParamField type="boolean">
  Whether to include errors in the response.
</ParamField>

## Request Body

<ParamField type="object[]">
  An array of input objects.

  <Expandable title="properties">
    <ParamField type="string">
      Direct search link on LinkedIn. For example: by company search
    </ParamField>

    <ParamField type="boolean">
      When set to true, the filter will exclude titles that do not contain the specified keywords
    </ParamField>
  </Expandable>

  #### Example

  ```json theme={null}
  {
    "input":[
      {"url":"https://www.linkedin.com/jobs/search?keywords=Software&location=Tel%20Aviv-Yafo&geoId=101570771&trk=public_jobs_jobs-search-bar_search-submit&position=1&pageNum=0&f_TPR=r3600"},
      {"url":"https://www.linkedin.com/jobs/semrush-jobs?f_C=2821922"},
      {"url":"https://www.linkedin.com/jobs/reddit-inc.-jobs-worldwide?f_C=150573"}
    ]
  }
  ```
</ParamField>

## Response

<ResponseExample>
  ```json 200 theme={null}
  [
    {
      "url": "https://www.linkedin.com/jobs/view/pharmacy-technician-at-walmart-4385163817?_l=en",
      "job_posting_id": "4385163817",
      "job_title": "Pharmacy Technician",
      "company_name": "Walmart",
      "company_id": "2646",
      "job_location": "Fayetteville, NC",
      "job_summary": "Hourly Wage: $16 - $29 per/hour The actual hourly rate will equal or exceed the required minimum wage applicable to the job location. Additional Compensation Includes Annual Or Quarterly Performance Incentives. Additional compensation in the form of premiums may be paid in amounts ranging from $0.35 per hour to $3.00 per hour in specific circumstances. Premiums may be based on schedule, facility, season, or specific work performed. Multiple premiums may apply if applicable criteria are met. Employment Type: Part-Time Available shifts: Mid-Shift, Closing Location Walmart Supercenter #3595 7701 S RAEFORD RD, FAYETTEVILLE, NC, 28304, US Job Overview Pharmacy associates focus on the needs of our customers as they entrust us with their prescriptions and health needs. They are responsible for inputting and processing prescriptions, supporting patients with product information, and providing customer service in our store pharmacies. Benefits & perks At Walmart, we offer competitive pay as well as performance-based incentive awards and other great benefits for a happier mind, body, and wallet. Health benefits include medical, vision and dental coverage. Financial benefits include 401(k), stock purchase and company-paid life insurance. Paid time off benefits include parental leave, family care leave, bereavement, jury duty, and voting. Other benefits include short-term and long-term disability, company discounts, Military Leave Pay, adoption and surrogacy expense reimbursement, and more. You will also receive PTO and/or PPTO that can be used for vacation, sick leave, holidays, or other purposes. The amount you receive depends on your job classification and length of employment. It will meet or exceed the requirements of paid sick leave laws, where applicable. For information about PTO, see Smart Guide page Live Better U is a Walmart-paid education benefit program for full-time and part-time associates in Walmart and Sam's Club facilities. Programs range from high school completion to bachelor's degrees, including English Language Learning and short-form certificates. Tuition, books, and fees are completely paid for by Walmart. Eligibility requirements apply to some benefits and may depend on your job classification and length of employment. Benefits are subject to change and may be subject to a specific plan or program terms. For information about benefits and eligibility, see One.Walmart.com. Walmart is committed to maintaining a drug-free workplace and has a no tolerance policy regarding the use of illegal drugs and alcohol on the job. This policy applies to all employees and aims to create a safe and productive work environment. Show more Show less",
      "job_seniority_level": "Entry level",
      "job_function": "Health Care Provider",
      "job_employment_type": "Part-time",
      "job_industries": "Retail",
      "job_base_pay_range": "$16.00/hr - $29.00/hr",
      "company_url": "https://www.linkedin.com/company/walmart?trk=public_jobs_topcard-org-name",
      "job_posted_time": "4 days ago",
      "job_num_applicants": 25,
      "discovery_input": {
        "experience_level": null,
        "job_type": null,
        "remote": null,
        "selective_search": null,
        "time_range": null
      },
      "apply_link": null,
      "country_code": "US",
      "title_id": "1062",
      "company_logo": "https://media.licdn.com/dms/image/v2/D560BAQHZkPdlecGssw/company-logo_100_100/company-logo_100_100/0/1736779000209/walmart_logo?e=2147483647&v=beta&t=tWcWIFSyHtICTzTLIPiYeKCp21XucI-HWijZdWwYR-A",
      "job_posted_date": "2026-03-13T09:48:59.171Z",
      "job_poster": {
        "name": null,
        "title": null,
        "url": null
      },
      "application_availability": true,
      "job_description_formatted": "<section class=\"show-more-less-html\" data-max-lines=\"5\">\n        <div class=\"show-more-less-html__markup show-more-less-html__markup--clamp-after-5\n            relative overflow-hidden\">\n          Hourly Wage: <strong>$16 - $29 per/hour<br><br></strong><ul><li>The actual hourly rate will equal or exceed the required minimum wage applicable to the job location.<br><br></li></ul><strong>Additional Compensation Includes Annual Or Quarterly Performance Incentives.<br><br></strong>Additional compensation in the form of premiums may be paid in amounts ranging from $0.35 per hour to $3.00 per hour in specific circumstances. Premiums may be based on schedule, facility, season, or specific work performed. Multiple premiums may apply if applicable criteria are met.<br><br>Employment Type: <strong>Part-Time<br><br></strong>Available shifts: <strong>Mid-Shift, Closing<br><br></strong>Location<br><br><strong>Walmart Supercenter #3595<br><br></strong>7701 S RAEFORD RD, FAYETTEVILLE, NC, 28304, US<br><br><strong>Job Overview<br><br></strong>Pharmacy associates focus on the needs of our customers as they entrust us with their prescriptions and health needs. They are responsible for inputting and processing prescriptions, supporting patients with product information, and providing customer service in our store pharmacies.<br><br>Benefits &amp; perks<br><br>At Walmart, we offer competitive pay as well as performance-based incentive awards and other great benefits for a happier mind, body, and wallet. Health benefits include medical, vision and dental coverage. Financial benefits include 401(k), stock purchase and company-paid life insurance. Paid time off benefits include parental leave, family care leave, bereavement, jury duty, and voting. Other benefits include short-term and long-term disability, company discounts, Military Leave Pay, adoption and surrogacy expense reimbursement, and more.<br><br>You will also receive PTO and/or PPTO that can be used for vacation, sick leave, holidays, or other purposes. The amount you receive depends on your job classification and length of employment. It will meet or exceed the requirements of paid sick leave laws, where applicable. For information about PTO, see Smart Guide page<br><br>Live Better U is a Walmart-paid education benefit program for full-time and part-time associates in Walmart and Sam&apos;s Club facilities. Programs range from high school completion to bachelor&apos;s degrees, including English Language Learning and short-form certificates. Tuition, books, and fees are completely paid for by Walmart.<br><br>Eligibility requirements apply to some benefits and may depend on your job classification and length of employment. Benefits are subject to change and may be subject to a specific plan or program terms. For information about benefits and eligibility, see One.Walmart.com.<br><br>Walmart is committed to maintaining a drug-free workplace and has a no tolerance policy regarding the use of illegal drugs and alcohol on the job. This policy applies to all employees and aims to create a safe and productive work environment.\n        </div>\n\n        \n\n    \n    \n    \n\n    <button class=\"show-more-less-html__button show-more-less-button\n        show-more-less-html__button--more\n        ml-0.5\" data-tracking-control-name=\"public_jobs_show-more-html-btn\" aria-label=\"Show more\" aria-expanded=\"false\">\n<!---->\n        \n            Show more\n          \n\n          <icon class=\"show-more-less-html__button-icon show-more-less-button-icon\" data-delayed-url=\"https://static.licdn.com/aero-v1/sc/h/cyolgscd0imw2ldqppkrb84vo\"></icon>\n    </button>\n  \n\n        \n\n    \n    \n    \n\n    <button class=\"show-more-less-html__button show-more-less-button\n        show-more-less-html__button--less\n        ml-0.5\" data-tracking-control-name=\"public_jobs_show-less-html-btn\" aria-label=\"Show less\" aria-expanded=\"true\">\n<!---->\n        \n            Show less\n          \n\n          <icon class=\"show-more-less-html__button-icon show-more-less-button-icon\" data-delayed-url=\"https://static.licdn.com/aero-v1/sc/h/4chtt12k98xwnba1nimld2oyg\"></icon>\n    </button>\n  \n<!---->    </section>",
      "base_salary": {
        "currency": "$",
        "max_amount": 29,
        "min_amount": 16,
        "payment_period": "hr"
      },
      "salary_standards": "This range is provided by Walmart. Your actual pay will be based on your skills and experience — talk with your recruiter to learn more.",
      "is_easy_apply": false
    }
  ]
  ```
</ResponseExample>


# Discover new LinkedIn profiles
Source: https://docs.brightdata.com/api-reference/scrapers/social-media-apis/linkedin-people-discover-new-profiles

POST https://api.brightdata.com/datasets/v3/scrape
Discover new LinkedIn profiles by first and last name using the Bright Data Web Scraper API with dataset ID gd_m8d03he47z8nwb5xc for prospect research.

## Query Parameters

<ParamField type="string">
  The dataset ID used for this request.

  <Warning>
    Must be set to `gd_m8d03he47z8nwb5xc` to collect **Discover New Profiles** data.
  </Warning>
</ParamField>

<ParamField type="boolean">
  Whether to send notifications when the request is completed.
</ParamField>

<ParamField type="boolean">
  Whether to include errors in the response.
</ParamField>

## Request Body

<ParamField type="object[]">
  An array of input objects.

  <Expandable title="properties">
    <ParamField type="string">
      Must be set to `https://www.linkedin.com`.
    </ParamField>

    <ParamField type="string">
      First name to search by
    </ParamField>

    <ParamField type="string">
      Last name to search by
    </ParamField>
  </Expandable>

  #### Example

  ```json theme={null}
  {
    "input":[
      {
        "url":"https://www.linkedin.com",
        "first_name":"james",
        "last_name":"smith"
      },
      {
        "url":"https://www.linkedin.com",
        "first_name":"Lisa",
        "last_name":"Ledger"
      }
    ]
  }
  ```
</ParamField>

<ResponseExample>
  ```json 200 theme={null}
  [
    {
      "url": "https://linkedin.com/in/muge-ozlutiras",
      "name": "Muge O*******s",
      "subtitle": null,
      "location": "Netherlands",
      "experience": null,
      "education": "ETH Zurich",
      "avatar": "htt***//m***a.l*********dms*********************6XV******************************************************************************************************************************************************************"
    }
  ]
  ```
</ResponseExample>


# Collect LinkedIn posts by URL
Source: https://docs.brightdata.com/api-reference/scrapers/social-media-apis/linkedin-posts-collect-by-url

api-reference/sdk-specs/linkedin-posts-collect-by-url POST /datasets/v3/scrape
Use the Bright Data Web Scraper API to collect LinkedIn Posts by URL. Calls the POST /datasets/v3/scrape endpoint and returns a snapshot ID.

## Query Parameters

<ParamField type="string">
  The dataset ID used for this request.

  <Warning>
    Must be set to `gd_lyy3tktm25m4avu764` to collect **Posts by URL** data.
  </Warning>
</ParamField>

<ParamField type="boolean">
  Whether to send notifications when the request is completed.
</ParamField>

<ParamField type="boolean">
  Whether to include errors in the response.
</ParamField>

## Request Body

<ParamField type="object[]">
  An array of input objects.

  <Expandable title="properties">
    <ParamField type="string">
      The URL of the LinkedIn post to collect.
    </ParamField>
  </Expandable>

  #### Example

  ```json theme={null}
  {
    "input":[
      {"url":"https://www.linkedin.com/pulse/ab-test-optimisation-earlier-decisions-new-readout-de-b%C3%A9naz%C3%A9?trk=public_profile_article_view"},
      {"url":"https://www.linkedin.com/posts/orlenchner_scrapecon-activity-7180537307521769472-oSYN?trk=public_profile"},
      {"url":"https://www.linkedin.com/posts/karin-dodis_web-data-collection-for-businesses-bright-activity-7176601589682434049-Aakz?trk=public_profile"},
      {"url":"https://www.linkedin.com/pulse/getting-value-out-sunburst-guillaume-de-b%C3%A9naz%C3%A9?trk=public_profile_article_view"}
    ]
  }
  ```
</ParamField>

<ResponseExample>
  ```json 200 theme={null}
  [
    {
      "url": "https://de.linkedin.com/posts/bathildisheim_sport-inklusion-sportf%C3%BCralle-activity-7439619065922625537-K5QL",
      "id": "7439619065922625537",
      "user_id": "bat***dis***m",
      "use_url": "https://de.linkedin.com/company/bathildisheim?trk=public_post_feed-actor-image",
      "title": "#sp*** #i***usi*********für*********************weg************************",
      "headline": "Aus***chn*** fü********* Vi******************",
      "post_text": "Auszeichnung für gelebte Vielfalt im #Sport . Das Projekt Miteinander bewegt ist gemeinsam mit dem VfL Bad Wildungen mit dem Sonderpreis „Ländlicher Raum“ der Demokratie-Verstärker:innen ausgezeichnet worden. Verliehen wurde der Preis im Rahmen der Initiative „Offen für Vielfalt – Geschlossen gegen Ausgrenzung“ im Regierungspräsidium Kassel. Gewürdigt wurde das gemeinsame Projekt „Boxen ist für alle da“, das seit knapp einem Jahr im Landkreis Waldeck-Frankenberg angeboten wird. Die Auszeichnung macht sichtbar, was das Projekt in der Praxis zeigt: Sport ist weit mehr als Bewegung. Sport schafft Begegnung, stärkt Selbstvertrauen und verbindet Menschen mit unterschiedlichen Voraussetzungen. Gerade deshalb ist es wichtig, dass sportliche Angebote allen offenstehen. Bei „Boxen ist für alle da“ trainieren Menschen mit und ohne Behinderung gemeinsam. So entstehen nicht nur sportliche Erfahrungen, sondern auch Teilhabe, Zusammenhalt und ein selbstverständliches Miteinander. Dass dieses Engagement nun besonders für den ländlichen Raum gewürdigt wird, ist ein starkes Zeichen. Die Freude über den Preis ist groß. Denn er würdigt den gemeinsamen Einsatz für Inklusion, Vielfalt und demokratisches Miteinander im Sport. Ein herzlicher Dank gilt allen Beteiligten, Unterstützer:innen und natürlich den Teilnehmenden, die dieses Projekt mit Leben füllen. #Inklusion #SportFürAlle #bathildisheimbewegt Sebastian Gleim",
      "date_posted": "2026-03-17T10:30:06.724Z",
      "hashtags": [
        "#Sport",
        "#Inklusion",
        "#SportFürAlle",
        "#bathildisheimbewegt"
      ],
      "embedded_links": [
        "https://www.linkedin.com/feed/hashtag/sport",
        "https://www.linkedin.com/feed/hashtag/inklusion",
        "https://www.linkedin.com/feed/hashtag/sportfAeSralle",
        "https://www.linkedin.com/feed/hashtag/bathildisheimbewegt",
        "https://de.linkedin.com/in/sebastian-gleim-47063430a?trk=public_post-text"
      ],
      "images": [
        "https://media.licdn.com/dms/image/v2/D4D22AQGI_ALONwR9og/feedshare-shrink_800/B4DZz7WHjuKQAg-/0/1773743405596?e=2147483647&v=beta&t=dXPqg2rYvo3UwNHHx-irACA7lQ7GWovL4egJ3smyH3o"
      ],
      "videos": null,
      "num_likes": 2,
      "num_comments": 0,
      "more_articles_by_user": null,
      "more_relevant_posts": null,
      "top_visible_comments": null,
      "user_followers": 412,
      "user_posts": 0,
      "user_articles": 0,
      "post_type": "post",
      "account_type": "Organization",
      "post_text_html": "Auszeichnung für gelebte Vielfalt im <a class=\"link\" href=\"https://www.linkedin.com/signup/cold-join?session_redirect=https%3A%2F%2Fwww.linkedin.com%2Ffeed%2Fhashtag%2Fsport&amp;trk=public_post-text\" target=\"_self\" data-tracking-control-name=\"public_post-text\" data-tracking-will-navigate>#Sport</a>. Das Projekt Miteinander bewegt ist gemeinsam mit dem VfL Bad Wildungen mit dem Sonderpreis „Ländlicher Raum“ der Demokratie-Verstärker:innen ausgezeichnet worden. Verliehen wurde der Preis im Rahmen der Initiative „Offen für Vielfalt – Geschlossen gegen Ausgrenzung“ im Regierungspräsidium Kassel.<br/>Gewürdigt wurde das gemeinsame Projekt „Boxen ist für alle da“, das seit knapp einem Jahr im Landkreis Waldeck-Frankenberg angeboten wird.<br/><br/>Die Auszeichnung macht sichtbar, was das Projekt in der Praxis zeigt: Sport ist weit mehr als Bewegung. Sport schafft Begegnung, stärkt Selbstvertrauen und verbindet Menschen mit unterschiedlichen Voraussetzungen. Gerade deshalb ist es wichtig, dass sportliche Angebote allen offenstehen.<br/><br/>Bei „Boxen ist für alle da“ trainieren Menschen mit und ohne Behinderung gemeinsam. So entstehen nicht nur sportliche Erfahrungen, sondern auch Teilhabe, Zusammenhalt und ein selbstverständliches Miteinander. Dass dieses Engagement nun besonders für den ländlichen Raum gewürdigt wird, ist ein starkes Zeichen.<br/>Die Freude über den Preis ist groß. Denn er würdigt den gemeinsamen Einsatz für Inklusion, Vielfalt und demokratisches Miteinander im Sport.<br/>Ein herzlicher Dank gilt allen Beteiligten, Unterstützer:innen und natürlich den Teilnehmenden, die dieses Projekt mit Leben füllen.<br/><br/><a class=\"link\" href=\"https://www.linkedin.com/signup/cold-join?session_redirect=https%3A%2F%2Fwww.linkedin.com%2Ffeed%2Fhashtag%2Finklusion&amp;trk=public_post-text\" target=\"_self\" data-tracking-control-name=\"public_post-text\" data-tracking-will-navigate>#Inklusion</a> <a class=\"link\" href=\"https://www.linkedin.com/signup/cold-join?session_redirect=https%3A%2F%2Fwww.linkedin.com%2Ffeed%2Fhashtag%2FsportfAeSralle&amp;trk=public_post-text\" target=\"_self\" data-tracking-control-name=\"public_post-text\" data-tracking-will-navigate>#SportFürAlle</a> <a class=\"link\" href=\"https://www.linkedin.com/signup/cold-join?session_redirect=https%3A%2F%2Fwww.linkedin.com%2Ffeed%2Fhashtag%2Fbathildisheimbewegt&amp;trk=public_post-text\" target=\"_self\" data-tracking-control-name=\"public_post-text\" data-tracking-will-navigate>#bathildisheimbewegt</a> <a class=\"link\" href=\"https://de.linkedin.com/in/sebastian-gleim-47063430a?trk=public_post-text\" target=\"_self\" data-tracking-control-name=\"public_post-text\" data-tracking-will-navigate>Sebastian Gleim</a>",
      "repost": null,
      "tagged_companies": [],
      "tagged_people": [
        {
          "link": "https://de.linkedin.com/in/sebastian-gleim-47063430a?trk=public_post-text",
          "name": "Sebastian G***m",
          "type": "people"
        }
      ],
      "user_title": null,
      "author_profile_pic": "htt***//m***a.l*********dms*********************mzL************************************************************************************************************************************************************",
      "num_connections": null,
      "video_duration": null,
      "external_link_data": null,
      "video_thumbnail": null,
      "document_cover_image": null,
      "document_page_count": null,
      "original_post_text": "Auszeichnung für gelebte Vielfalt im <a class=\"link\" href=\"https://www.linkedin.com/signup/cold-join?session_redirect=https%3A%2F%2Fwww.linkedin.com%2Ffeed%2Fhashtag%2Fsport&amp;trk=public_post-text\" target=\"_self\" data-tracking-control-name=\"public_post-text\" data-tracking-will-navigate>#Sport</a>. Das Projekt Miteinander bewegt ist gemeinsam mit dem VfL Bad Wildungen mit dem Sonderpreis „Ländlicher Raum“ der Demokratie-Verstärker:innen ausgezeichnet worden. Verliehen wurde der Preis im Rahmen der Initiative „Offen für Vielfalt – Geschlossen gegen Ausgrenzung“ im Regierungspräsidium Kassel.\nGewürdigt wurde das gemeinsame Projekt „Boxen ist für alle da“, das seit knapp einem Jahr im Landkreis Waldeck-Frankenberg angeboten wird.\n\nDie Auszeichnung macht sichtbar, was das Projekt in der Praxis zeigt: Sport ist weit mehr als Bewegung. Sport schafft Begegnung, stärkt Selbstvertrauen und verbindet Menschen mit unterschiedlichen Voraussetzungen. Gerade deshalb ist es wichtig, dass sportliche Angebote allen offenstehen.\n\nBei „Boxen ist für alle da“ trainieren Menschen mit und ohne Behinderung gemeinsam. So entstehen nicht nur sportliche Erfahrungen, sondern auch Teilhabe, Zusammenhalt und ein selbstverständliches Miteinander. Dass dieses Engagement nun besonders für den ländlichen Raum gewürdigt wird, ist ein starkes Zeichen.\nDie Freude über den Preis ist groß. Denn er würdigt den gemeinsamen Einsatz für Inklusion, Vielfalt und demokratisches Miteinander im Sport.\nEin herzlicher Dank gilt allen Beteiligten, Unterstützer:innen und natürlich den Teilnehmenden, die dieses Projekt mit Leben füllen.\n\n<a class=\"link\" href=\"https://www.linkedin.com/signup/cold-join?session_redirect=https%3A%2F%2Fwww.linkedin.com%2Ffeed%2Fhashtag%2Finklusion&amp;trk=public_post-text\" target=\"_self\" data-tracking-control-name=\"public_post-text\" data-tracking-will-navigate>#Inklusion</a> <a class=\"link\" href=\"https://www.linkedin.com/signup/cold-join?session_redirect=https%3A%2F%2Fwww.linkedin.com%2Ffeed%2Fhashtag%2FsportfAeSralle&amp;trk=public_post-text\" target=\"_self\" data-tracking-control-name=\"public_post-text\" data-tracking-will-navigate>#SportFürAlle</a> <a class=\"link\" href=\"https://www.linkedin.com/signup/cold-join?session_redirect=https%3A%2F%2Fwww.linkedin.com%2Ffeed%2Fhashtag%2Fbathildisheimbewegt&amp;trk=public_post-text\" target=\"_self\" data-tracking-control-name=\"public_post-text\" data-tracking-will-navigate>#bathildisheimbewegt</a> <a class=\"link\" href=\"https://de.linkedin.com/in/sebastian-gleim-47063430a?trk=public_post-text\" target=\"_self\" data-tracking-control-name=\"public_post-text\" data-tracking-will-navigate>Sebastian Gleim</a>"
    }
  ]
  ```
</ResponseExample>


# Discover LinkedIn posts by company URL
Source: https://docs.brightdata.com/api-reference/scrapers/social-media-apis/linkedin-posts-discover-by-company-url

POST https://api.brightdata.com/datasets/v3/scrape
Discover LinkedIn posts from a company URL using the Bright Data Web Scraper API with dataset ID gd_lyy3tktm25m4avu764 for company feed monitoring.

## Query Parameters

<ParamField type="string">
  The dataset ID used for this request.

  <Warning>
    Must be set to `gd_lyy3tktm25m4avu764` to collect **Discover Posts by Company URL** data.
  </Warning>
</ParamField>

<ParamField type="string">
  Must be set to `discover_new`.
</ParamField>

<ParamField type="string">
  Must be set to `company_url`.
</ParamField>

<ParamField type="boolean">
  Whether to send notifications when the request is completed.
</ParamField>

<ParamField type="boolean">
  Whether to include errors in the response.
</ParamField>

## Request Body

<ParamField type="object[]">
  An array of input objects.

  <Expandable title="properties">
    <ParamField type="string">
      LinkedIn company url
    </ParamField>

    <ParamField type="string">
      The start\_date input should be in ISO format (`YYYY-MM-DDTHH:MM:SS.sssZ`),

      > For example: `2025-02-12T14:37:05.932Z`
    </ParamField>

    <ParamField type="string">
      The end\_date input should be in ISO format (`YYYY-MM-DDTHH:MM:SS.sssZ`),

      > For example: `2025-02-12T14:37:05.932Z`.
    </ParamField>
  </Expandable>

  #### Example

  ```json theme={null}
  {
    "input":[
      {"url":"https://www.linkedin.com/company/lanieri"},
      {"url":"https://www.linkedin.com/company/effortel"},
      {"url":"https://www.linkedin.com/company/green-philly"}
    ]
  }
  ```
</ParamField>

## Response

<ResponseExample>
  ```json 200 theme={null}
  [
    {
      "url": "https://de.linkedin.com/posts/bathildisheim_sport-inklusion-sportf%C3%BCralle-activity-7439619065922625537-K5QL",
      "id": "7439619065922625537",
      "user_id": "bat***dis***m",
      "use_url": "https://de.linkedin.com/company/bathildisheim?trk=public_post_feed-actor-image",
      "title": "#sp*** #i***usi*********für*********************weg************************",
      "headline": "Aus***chn*** fü********* Vi******************",
      "post_text": "Auszeichnung für gelebte Vielfalt im #Sport . Das Projekt Miteinander bewegt ist gemeinsam mit dem VfL Bad Wildungen mit dem Sonderpreis „Ländlicher Raum“ der Demokratie-Verstärker:innen ausgezeichnet worden. Verliehen wurde der Preis im Rahmen der Initiative „Offen für Vielfalt – Geschlossen gegen Ausgrenzung“ im Regierungspräsidium Kassel. Gewürdigt wurde das gemeinsame Projekt „Boxen ist für alle da“, das seit knapp einem Jahr im Landkreis Waldeck-Frankenberg angeboten wird. Die Auszeichnung macht sichtbar, was das Projekt in der Praxis zeigt: Sport ist weit mehr als Bewegung. Sport schafft Begegnung, stärkt Selbstvertrauen und verbindet Menschen mit unterschiedlichen Voraussetzungen. Gerade deshalb ist es wichtig, dass sportliche Angebote allen offenstehen. Bei „Boxen ist für alle da“ trainieren Menschen mit und ohne Behinderung gemeinsam. So entstehen nicht nur sportliche Erfahrungen, sondern auch Teilhabe, Zusammenhalt und ein selbstverständliches Miteinander. Dass dieses Engagement nun besonders für den ländlichen Raum gewürdigt wird, ist ein starkes Zeichen. Die Freude über den Preis ist groß. Denn er würdigt den gemeinsamen Einsatz für Inklusion, Vielfalt und demokratisches Miteinander im Sport. Ein herzlicher Dank gilt allen Beteiligten, Unterstützer:innen und natürlich den Teilnehmenden, die dieses Projekt mit Leben füllen. #Inklusion #SportFürAlle #bathildisheimbewegt Sebastian Gleim",
      "date_posted": "2026-03-17T10:30:06.724Z",
      "hashtags": [
        "#Sport",
        "#Inklusion",
        "#SportFürAlle",
        "#bathildisheimbewegt"
      ],
      "embedded_links": [
        "https://www.linkedin.com/feed/hashtag/sport",
        "https://www.linkedin.com/feed/hashtag/inklusion",
        "https://www.linkedin.com/feed/hashtag/sportfAeSralle",
        "https://www.linkedin.com/feed/hashtag/bathildisheimbewegt",
        "https://de.linkedin.com/in/sebastian-gleim-47063430a?trk=public_post-text"
      ],
      "images": [
        "https://media.licdn.com/dms/image/v2/D4D22AQGI_ALONwR9og/feedshare-shrink_800/B4DZz7WHjuKQAg-/0/1773743405596?e=2147483647&v=beta&t=dXPqg2rYvo3UwNHHx-irACA7lQ7GWovL4egJ3smyH3o"
      ],
      "videos": null,
      "num_likes": 2,
      "num_comments": 0,
      "more_articles_by_user": null,
      "more_relevant_posts": null,
      "top_visible_comments": null,
      "user_followers": 412,
      "user_posts": 0,
      "user_articles": 0,
      "post_type": "post",
      "account_type": "Organization",
      "post_text_html": "Auszeichnung für gelebte Vielfalt im <a class=\"link\" href=\"https://www.linkedin.com/signup/cold-join?session_redirect=https%3A%2F%2Fwww.linkedin.com%2Ffeed%2Fhashtag%2Fsport&amp;trk=public_post-text\" target=\"_self\" data-tracking-control-name=\"public_post-text\" data-tracking-will-navigate>#Sport</a>. Das Projekt Miteinander bewegt ist gemeinsam mit dem VfL Bad Wildungen mit dem Sonderpreis „Ländlicher Raum“ der Demokratie-Verstärker:innen ausgezeichnet worden. Verliehen wurde der Preis im Rahmen der Initiative „Offen für Vielfalt – Geschlossen gegen Ausgrenzung“ im Regierungspräsidium Kassel.<br/>Gewürdigt wurde das gemeinsame Projekt „Boxen ist für alle da“, das seit knapp einem Jahr im Landkreis Waldeck-Frankenberg angeboten wird.<br/><br/>Die Auszeichnung macht sichtbar, was das Projekt in der Praxis zeigt: Sport ist weit mehr als Bewegung. Sport schafft Begegnung, stärkt Selbstvertrauen und verbindet Menschen mit unterschiedlichen Voraussetzungen. Gerade deshalb ist es wichtig, dass sportliche Angebote allen offenstehen.<br/><br/>Bei „Boxen ist für alle da“ trainieren Menschen mit und ohne Behinderung gemeinsam. So entstehen nicht nur sportliche Erfahrungen, sondern auch Teilhabe, Zusammenhalt und ein selbstverständliches Miteinander. Dass dieses Engagement nun besonders für den ländlichen Raum gewürdigt wird, ist ein starkes Zeichen.<br/>Die Freude über den Preis ist groß. Denn er würdigt den gemeinsamen Einsatz für Inklusion, Vielfalt und demokratisches Miteinander im Sport.<br/>Ein herzlicher Dank gilt allen Beteiligten, Unterstützer:innen und natürlich den Teilnehmenden, die dieses Projekt mit Leben füllen.<br/><br/><a class=\"link\" href=\"https://www.linkedin.com/signup/cold-join?session_redirect=https%3A%2F%2Fwww.linkedin.com%2Ffeed%2Fhashtag%2Finklusion&amp;trk=public_post-text\" target=\"_self\" data-tracking-control-name=\"public_post-text\" data-tracking-will-navigate>#Inklusion</a> <a class=\"link\" href=\"https://www.linkedin.com/signup/cold-join?session_redirect=https%3A%2F%2Fwww.linkedin.com%2Ffeed%2Fhashtag%2FsportfAeSralle&amp;trk=public_post-text\" target=\"_self\" data-tracking-control-name=\"public_post-text\" data-tracking-will-navigate>#SportFürAlle</a> <a class=\"link\" href=\"https://www.linkedin.com/signup/cold-join?session_redirect=https%3A%2F%2Fwww.linkedin.com%2Ffeed%2Fhashtag%2Fbathildisheimbewegt&amp;trk=public_post-text\" target=\"_self\" data-tracking-control-name=\"public_post-text\" data-tracking-will-navigate>#bathildisheimbewegt</a> <a class=\"link\" href=\"https://de.linkedin.com/in/sebastian-gleim-47063430a?trk=public_post-text\" target=\"_self\" data-tracking-control-name=\"public_post-text\" data-tracking-will-navigate>Sebastian Gleim</a>",
      "repost": null,
      "tagged_companies": [],
      "tagged_people": [
        {
          "link": "https://de.linkedin.com/in/sebastian-gleim-47063430a?trk=public_post-text",
          "name": "Sebastian G***m",
          "type": "people"
        }
      ],
      "user_title": null,
      "author_profile_pic": "htt***//m***a.l*********dms*********************mzL************************************************************************************************************************************************************",
      "num_connections": null,
      "video_duration": null,
      "external_link_data": null,
      "video_thumbnail": null,
      "document_cover_image": null,
      "document_page_count": null,
      "original_post_text": "Auszeichnung für gelebte Vielfalt im <a class=\"link\" href=\"https://www.linkedin.com/signup/cold-join?session_redirect=https%3A%2F%2Fwww.linkedin.com%2Ffeed%2Fhashtag%2Fsport&amp;trk=public_post-text\" target=\"_self\" data-tracking-control-name=\"public_post-text\" data-tracking-will-navigate>#Sport</a>. Das Projekt Miteinander bewegt ist gemeinsam mit dem VfL Bad Wildungen mit dem Sonderpreis „Ländlicher Raum“ der Demokratie-Verstärker:innen ausgezeichnet worden. Verliehen wurde der Preis im Rahmen der Initiative „Offen für Vielfalt – Geschlossen gegen Ausgrenzung“ im Regierungspräsidium Kassel.\nGewürdigt wurde das gemeinsame Projekt „Boxen ist für alle da“, das seit knapp einem Jahr im Landkreis Waldeck-Frankenberg angeboten wird.\n\nDie Auszeichnung macht sichtbar, was das Projekt in der Praxis zeigt: Sport ist weit mehr als Bewegung. Sport schafft Begegnung, stärkt Selbstvertrauen und verbindet Menschen mit unterschiedlichen Voraussetzungen. Gerade deshalb ist es wichtig, dass sportliche Angebote allen offenstehen.\n\nBei „Boxen ist für alle da“ trainieren Menschen mit und ohne Behinderung gemeinsam. So entstehen nicht nur sportliche Erfahrungen, sondern auch Teilhabe, Zusammenhalt und ein selbstverständliches Miteinander. Dass dieses Engagement nun besonders für den ländlichen Raum gewürdigt wird, ist ein starkes Zeichen.\nDie Freude über den Preis ist groß. Denn er würdigt den gemeinsamen Einsatz für Inklusion, Vielfalt und demokratisches Miteinander im Sport.\nEin herzlicher Dank gilt allen Beteiligten, Unterstützer:innen und natürlich den Teilnehmenden, die dieses Projekt mit Leben füllen.\n\n<a class=\"link\" href=\"https://www.linkedin.com/signup/cold-join?session_redirect=https%3A%2F%2Fwww.linkedin.com%2Ffeed%2Fhashtag%2Finklusion&amp;trk=public_post-text\" target=\"_self\" data-tracking-control-name=\"public_post-text\" data-tracking-will-navigate>#Inklusion</a> <a class=\"link\" href=\"https://www.linkedin.com/signup/cold-join?session_redirect=https%3A%2F%2Fwww.linkedin.com%2Ffeed%2Fhashtag%2FsportfAeSralle&amp;trk=public_post-text\" target=\"_self\" data-tracking-control-name=\"public_post-text\" data-tracking-will-navigate>#SportFürAlle</a> <a class=\"link\" href=\"https://www.linkedin.com/signup/cold-join?session_redirect=https%3A%2F%2Fwww.linkedin.com%2Ffeed%2Fhashtag%2Fbathildisheimbewegt&amp;trk=public_post-text\" target=\"_self\" data-tracking-control-name=\"public_post-text\" data-tracking-will-navigate>#bathildisheimbewegt</a> <a class=\"link\" href=\"https://de.linkedin.com/in/sebastian-gleim-47063430a?trk=public_post-text\" target=\"_self\" data-tracking-control-name=\"public_post-text\" data-tracking-will-navigate>Sebastian Gleim</a>"
    }
  ]
  ```
</ResponseExample>


# Discover LinkedIn posts by profile URL
Source: https://docs.brightdata.com/api-reference/scrapers/social-media-apis/linkedin-posts-discover-by-profile-url

POST https://api.brightdata.com/datasets/v3/scrape
Discover LinkedIn posts from a profile URL using the Bright Data Web Scraper API with dataset ID gd_lyy3tktm25m4avu764 for individual feed monitoring.

## Query Parameters

<ParamField type="string">
  The dataset ID used for this request.

  <Warning>
    Must be set to `gd_lyy3tktm25m4avu764` to collect **Discover Posts by Profile URL** data.
  </Warning>
</ParamField>

<ParamField type="string">
  Must be set to `discover_new`.
</ParamField>

<ParamField type="string">
  Must be set to `profile_url`.
</ParamField>

<ParamField type="boolean">
  Whether to send notifications when the request is completed.
</ParamField>

<ParamField type="boolean">
  Whether to include errors in the response.
</ParamField>

## Request Body

<ParamField type="object[]">
  An array of input objects.

  <Expandable title="properties">
    <ParamField type="string">
      LinkedIn company url
    </ParamField>

    <ParamField type="string">
      `start_date` to filter by, if filled will only collect posts with publish date
    </ParamField>

    <ParamField type="string">
      `end_date` to filter by, if filled will only collect posts with publish date
    </ParamField>

    <ParamField type="boolean">
      Return only posts created by the profile owner
    </ParamField>
  </Expandable>

  #### Example

  ```json theme={null}
  {
    "input":[
      {
        "url":"https://www.linkedin.com/in/bettywliu",
        "start_date":"2018-04-25T00:00:00.000Z",
        "end_date":"2021-05-25T00:00:00.000Z"  
      }
    ]
  }
  ```
</ParamField>

## Response

<ResponseExample>
  ```json 200 theme={null}
  [
    {
      "url": "https://de.linkedin.com/posts/bathildisheim_sport-inklusion-sportf%C3%BCralle-activity-7439619065922625537-K5QL",
      "id": "7439619065922625537",
      "user_id": "bat***dis***m",
      "use_url": "https://de.linkedin.com/company/bathildisheim?trk=public_post_feed-actor-image",
      "title": "#sp*** #i***usi*********für*********************weg************************",
      "headline": "Aus***chn*** fü********* Vi******************",
      "post_text": "Auszeichnung für gelebte Vielfalt im #Sport . Das Projekt Miteinander bewegt ist gemeinsam mit dem VfL Bad Wildungen mit dem Sonderpreis „Ländlicher Raum“ der Demokratie-Verstärker:innen ausgezeichnet worden. Verliehen wurde der Preis im Rahmen der Initiative „Offen für Vielfalt – Geschlossen gegen Ausgrenzung“ im Regierungspräsidium Kassel. Gewürdigt wurde das gemeinsame Projekt „Boxen ist für alle da“, das seit knapp einem Jahr im Landkreis Waldeck-Frankenberg angeboten wird. Die Auszeichnung macht sichtbar, was das Projekt in der Praxis zeigt: Sport ist weit mehr als Bewegung. Sport schafft Begegnung, stärkt Selbstvertrauen und verbindet Menschen mit unterschiedlichen Voraussetzungen. Gerade deshalb ist es wichtig, dass sportliche Angebote allen offenstehen. Bei „Boxen ist für alle da“ trainieren Menschen mit und ohne Behinderung gemeinsam. So entstehen nicht nur sportliche Erfahrungen, sondern auch Teilhabe, Zusammenhalt und ein selbstverständliches Miteinander. Dass dieses Engagement nun besonders für den ländlichen Raum gewürdigt wird, ist ein starkes Zeichen. Die Freude über den Preis ist groß. Denn er würdigt den gemeinsamen Einsatz für Inklusion, Vielfalt und demokratisches Miteinander im Sport. Ein herzlicher Dank gilt allen Beteiligten, Unterstützer:innen und natürlich den Teilnehmenden, die dieses Projekt mit Leben füllen. #Inklusion #SportFürAlle #bathildisheimbewegt Sebastian Gleim",
      "date_posted": "2026-03-17T10:30:06.724Z",
      "hashtags": [
        "#Sport",
        "#Inklusion",
        "#SportFürAlle",
        "#bathildisheimbewegt"
      ],
      "embedded_links": [
        "https://www.linkedin.com/feed/hashtag/sport",
        "https://www.linkedin.com/feed/hashtag/inklusion",
        "https://www.linkedin.com/feed/hashtag/sportfAeSralle",
        "https://www.linkedin.com/feed/hashtag/bathildisheimbewegt",
        "https://de.linkedin.com/in/sebastian-gleim-47063430a?trk=public_post-text"
      ],
      "images": [
        "https://media.licdn.com/dms/image/v2/D4D22AQGI_ALONwR9og/feedshare-shrink_800/B4DZz7WHjuKQAg-/0/1773743405596?e=2147483647&v=beta&t=dXPqg2rYvo3UwNHHx-irACA7lQ7GWovL4egJ3smyH3o"
      ],
      "videos": null,
      "num_likes": 2,
      "num_comments": 0,
      "more_articles_by_user": null,
      "more_relevant_posts": null,
      "top_visible_comments": null,
      "user_followers": 412,
      "user_posts": 0,
      "user_articles": 0,
      "post_type": "post",
      "account_type": "Organization",
      "post_text_html": "Auszeichnung für gelebte Vielfalt im <a class=\"link\" href=\"https://www.linkedin.com/signup/cold-join?session_redirect=https%3A%2F%2Fwww.linkedin.com%2Ffeed%2Fhashtag%2Fsport&amp;trk=public_post-text\" target=\"_self\" data-tracking-control-name=\"public_post-text\" data-tracking-will-navigate>#Sport</a>. Das Projekt Miteinander bewegt ist gemeinsam mit dem VfL Bad Wildungen mit dem Sonderpreis „Ländlicher Raum“ der Demokratie-Verstärker:innen ausgezeichnet worden. Verliehen wurde der Preis im Rahmen der Initiative „Offen für Vielfalt – Geschlossen gegen Ausgrenzung“ im Regierungspräsidium Kassel.<br/>Gewürdigt wurde das gemeinsame Projekt „Boxen ist für alle da“, das seit knapp einem Jahr im Landkreis Waldeck-Frankenberg angeboten wird.<br/><br/>Die Auszeichnung macht sichtbar, was das Projekt in der Praxis zeigt: Sport ist weit mehr als Bewegung. Sport schafft Begegnung, stärkt Selbstvertrauen und verbindet Menschen mit unterschiedlichen Voraussetzungen. Gerade deshalb ist es wichtig, dass sportliche Angebote allen offenstehen.<br/><br/>Bei „Boxen ist für alle da“ trainieren Menschen mit und ohne Behinderung gemeinsam. So entstehen nicht nur sportliche Erfahrungen, sondern auch Teilhabe, Zusammenhalt und ein selbstverständliches Miteinander. Dass dieses Engagement nun besonders für den ländlichen Raum gewürdigt wird, ist ein starkes Zeichen.<br/>Die Freude über den Preis ist groß. Denn er würdigt den gemeinsamen Einsatz für Inklusion, Vielfalt und demokratisches Miteinander im Sport.<br/>Ein herzlicher Dank gilt allen Beteiligten, Unterstützer:innen und natürlich den Teilnehmenden, die dieses Projekt mit Leben füllen.<br/><br/><a class=\"link\" href=\"https://www.linkedin.com/signup/cold-join?session_redirect=https%3A%2F%2Fwww.linkedin.com%2Ffeed%2Fhashtag%2Finklusion&amp;trk=public_post-text\" target=\"_self\" data-tracking-control-name=\"public_post-text\" data-tracking-will-navigate>#Inklusion</a> <a class=\"link\" href=\"https://www.linkedin.com/signup/cold-join?session_redirect=https%3A%2F%2Fwww.linkedin.com%2Ffeed%2Fhashtag%2FsportfAeSralle&amp;trk=public_post-text\" target=\"_self\" data-tracking-control-name=\"public_post-text\" data-tracking-will-navigate>#SportFürAlle</a> <a class=\"link\" href=\"https://www.linkedin.com/signup/cold-join?session_redirect=https%3A%2F%2Fwww.linkedin.com%2Ffeed%2Fhashtag%2Fbathildisheimbewegt&amp;trk=public_post-text\" target=\"_self\" data-tracking-control-name=\"public_post-text\" data-tracking-will-navigate>#bathildisheimbewegt</a> <a class=\"link\" href=\"https://de.linkedin.com/in/sebastian-gleim-47063430a?trk=public_post-text\" target=\"_self\" data-tracking-control-name=\"public_post-text\" data-tracking-will-navigate>Sebastian Gleim</a>",
      "repost": null,
      "tagged_companies": [],
      "tagged_people": [
        {
          "link": "https://de.linkedin.com/in/sebastian-gleim-47063430a?trk=public_post-text",
          "name": "Sebastian G***m",
          "type": "people"
        }
      ],
      "user_title": null,
      "author_profile_pic": "htt***//m***a.l*********dms*********************mzL************************************************************************************************************************************************************",
      "num_connections": null,
      "video_duration": null,
      "external_link_data": null,
      "video_thumbnail": null,
      "document_cover_image": null,
      "document_page_count": null,
      "original_post_text": "Auszeichnung für gelebte Vielfalt im <a class=\"link\" href=\"https://www.linkedin.com/signup/cold-join?session_redirect=https%3A%2F%2Fwww.linkedin.com%2Ffeed%2Fhashtag%2Fsport&amp;trk=public_post-text\" target=\"_self\" data-tracking-control-name=\"public_post-text\" data-tracking-will-navigate>#Sport</a>. Das Projekt Miteinander bewegt ist gemeinsam mit dem VfL Bad Wildungen mit dem Sonderpreis „Ländlicher Raum“ der Demokratie-Verstärker:innen ausgezeichnet worden. Verliehen wurde der Preis im Rahmen der Initiative „Offen für Vielfalt – Geschlossen gegen Ausgrenzung“ im Regierungspräsidium Kassel.\nGewürdigt wurde das gemeinsame Projekt „Boxen ist für alle da“, das seit knapp einem Jahr im Landkreis Waldeck-Frankenberg angeboten wird.\n\nDie Auszeichnung macht sichtbar, was das Projekt in der Praxis zeigt: Sport ist weit mehr als Bewegung. Sport schafft Begegnung, stärkt Selbstvertrauen und verbindet Menschen mit unterschiedlichen Voraussetzungen. Gerade deshalb ist es wichtig, dass sportliche Angebote allen offenstehen.\n\nBei „Boxen ist für alle da“ trainieren Menschen mit und ohne Behinderung gemeinsam. So entstehen nicht nur sportliche Erfahrungen, sondern auch Teilhabe, Zusammenhalt und ein selbstverständliches Miteinander. Dass dieses Engagement nun besonders für den ländlichen Raum gewürdigt wird, ist ein starkes Zeichen.\nDie Freude über den Preis ist groß. Denn er würdigt den gemeinsamen Einsatz für Inklusion, Vielfalt und demokratisches Miteinander im Sport.\nEin herzlicher Dank gilt allen Beteiligten, Unterstützer:innen und natürlich den Teilnehmenden, die dieses Projekt mit Leben füllen.\n\n<a class=\"link\" href=\"https://www.linkedin.com/signup/cold-join?session_redirect=https%3A%2F%2Fwww.linkedin.com%2Ffeed%2Fhashtag%2Finklusion&amp;trk=public_post-text\" target=\"_self\" data-tracking-control-name=\"public_post-text\" data-tracking-will-navigate>#Inklusion</a> <a class=\"link\" href=\"https://www.linkedin.com/signup/cold-join?session_redirect=https%3A%2F%2Fwww.linkedin.com%2Ffeed%2Fhashtag%2FsportfAeSralle&amp;trk=public_post-text\" target=\"_self\" data-tracking-control-name=\"public_post-text\" data-tracking-will-navigate>#SportFürAlle</a> <a class=\"link\" href=\"https://www.linkedin.com/signup/cold-join?session_redirect=https%3A%2F%2Fwww.linkedin.com%2Ffeed%2Fhashtag%2Fbathildisheimbewegt&amp;trk=public_post-text\" target=\"_self\" data-tracking-control-name=\"public_post-text\" data-tracking-will-navigate>#bathildisheimbewegt</a> <a class=\"link\" href=\"https://de.linkedin.com/in/sebastian-gleim-47063430a?trk=public_post-text\" target=\"_self\" data-tracking-control-name=\"public_post-text\" data-tracking-will-navigate>Sebastian Gleim</a>"
    }
  ]
  ```
</ResponseExample>


# Discover LinkedIn posts by URL
Source: https://docs.brightdata.com/api-reference/scrapers/social-media-apis/linkedin-posts-discover-by-url

POST https://api.brightdata.com/datasets/v3/scrape
Discover a LinkedIn user's posts by URL using the Bright Data Web Scraper API with dataset ID gd_lyy3tktm25m4avu764 for individual feed scraping.

## Query Parameters

<ParamField type="string">
  The dataset ID used for this request.

  <Warning>
    Must be set to `gd_lyy3tktm25m4avu764` to collect **Discover User's posts by URL** data.
  </Warning>
</ParamField>

<ParamField type="string">
  Must be set to `discover_new`.
</ParamField>

<ParamField type="string">
  Must be set to `url`.
</ParamField>

<ParamField type="boolean">
  Whether to send notifications when the request is completed.
</ParamField>

<ParamField type="boolean">
  Whether to include errors in the response.
</ParamField>

## Request Body

<ParamField type="object[]">
  An array of input objects.

  <Expandable title="properties">
    <ParamField type="string">
      The URL of the LinkedIn job listing to collect.
    </ParamField>

    <ParamField type="number">
      Set the maximum number of posts to collect
    </ParamField>
  </Expandable>

  #### Example

  ```json theme={null}
  {
    "input":[
      {
        "url":"https://www.linkedin.com/today/author/cristianbrunori?trk=public_post_follow-articles",
        "limit":50
      },
      {
        "url":"https://www.linkedin.com/today/author/stevenouri?trk=public_post_follow-articles"
      }
    ]
  }
  ```
</ParamField>

## Response

<ResponseExample>
  ```json 200 theme={null}
  [
    {
      "url": "https://de.linkedin.com/posts/bathildisheim_sport-inklusion-sportf%C3%BCralle-activity-7439619065922625537-K5QL",
      "id": "7439619065922625537",
      "user_id": "bat***dis***m",
      "use_url": "https://de.linkedin.com/company/bathildisheim?trk=public_post_feed-actor-image",
      "title": "#sp*** #i***usi*********für*********************weg************************",
      "headline": "Aus***chn*** fü********* Vi******************",
      "post_text": "Auszeichnung für gelebte Vielfalt im #Sport . Das Projekt Miteinander bewegt ist gemeinsam mit dem VfL Bad Wildungen mit dem Sonderpreis „Ländlicher Raum“ der Demokratie-Verstärker:innen ausgezeichnet worden. Verliehen wurde der Preis im Rahmen der Initiative „Offen für Vielfalt – Geschlossen gegen Ausgrenzung“ im Regierungspräsidium Kassel. Gewürdigt wurde das gemeinsame Projekt „Boxen ist für alle da“, das seit knapp einem Jahr im Landkreis Waldeck-Frankenberg angeboten wird. Die Auszeichnung macht sichtbar, was das Projekt in der Praxis zeigt: Sport ist weit mehr als Bewegung. Sport schafft Begegnung, stärkt Selbstvertrauen und verbindet Menschen mit unterschiedlichen Voraussetzungen. Gerade deshalb ist es wichtig, dass sportliche Angebote allen offenstehen. Bei „Boxen ist für alle da“ trainieren Menschen mit und ohne Behinderung gemeinsam. So entstehen nicht nur sportliche Erfahrungen, sondern auch Teilhabe, Zusammenhalt und ein selbstverständliches Miteinander. Dass dieses Engagement nun besonders für den ländlichen Raum gewürdigt wird, ist ein starkes Zeichen. Die Freude über den Preis ist groß. Denn er würdigt den gemeinsamen Einsatz für Inklusion, Vielfalt und demokratisches Miteinander im Sport. Ein herzlicher Dank gilt allen Beteiligten, Unterstützer:innen und natürlich den Teilnehmenden, die dieses Projekt mit Leben füllen. #Inklusion #SportFürAlle #bathildisheimbewegt Sebastian Gleim",
      "date_posted": "2026-03-17T10:30:06.724Z",
      "hashtags": [
        "#Sport",
        "#Inklusion",
        "#SportFürAlle",
        "#bathildisheimbewegt"
      ],
      "embedded_links": [
        "https://www.linkedin.com/feed/hashtag/sport",
        "https://www.linkedin.com/feed/hashtag/inklusion",
        "https://www.linkedin.com/feed/hashtag/sportfAeSralle",
        "https://www.linkedin.com/feed/hashtag/bathildisheimbewegt",
        "https://de.linkedin.com/in/sebastian-gleim-47063430a?trk=public_post-text"
      ],
      "images": [
        "https://media.licdn.com/dms/image/v2/D4D22AQGI_ALONwR9og/feedshare-shrink_800/B4DZz7WHjuKQAg-/0/1773743405596?e=2147483647&v=beta&t=dXPqg2rYvo3UwNHHx-irACA7lQ7GWovL4egJ3smyH3o"
      ],
      "videos": null,
      "num_likes": 2,
      "num_comments": 0,
      "more_articles_by_user": null,
      "more_relevant_posts": null,
      "top_visible_comments": null,
      "user_followers": 412,
      "user_posts": 0,
      "user_articles": 0,
      "post_type": "post",
      "account_type": "Organization",
      "post_text_html": "Auszeichnung für gelebte Vielfalt im <a class=\"link\" href=\"https://www.linkedin.com/signup/cold-join?session_redirect=https%3A%2F%2Fwww.linkedin.com%2Ffeed%2Fhashtag%2Fsport&amp;trk=public_post-text\" target=\"_self\" data-tracking-control-name=\"public_post-text\" data-tracking-will-navigate>#Sport</a>. Das Projekt Miteinander bewegt ist gemeinsam mit dem VfL Bad Wildungen mit dem Sonderpreis „Ländlicher Raum“ der Demokratie-Verstärker:innen ausgezeichnet worden. Verliehen wurde der Preis im Rahmen der Initiative „Offen für Vielfalt – Geschlossen gegen Ausgrenzung“ im Regierungspräsidium Kassel.<br/>Gewürdigt wurde das gemeinsame Projekt „Boxen ist für alle da“, das seit knapp einem Jahr im Landkreis Waldeck-Frankenberg angeboten wird.<br/><br/>Die Auszeichnung macht sichtbar, was das Projekt in der Praxis zeigt: Sport ist weit mehr als Bewegung. Sport schafft Begegnung, stärkt Selbstvertrauen und verbindet Menschen mit unterschiedlichen Voraussetzungen. Gerade deshalb ist es wichtig, dass sportliche Angebote allen offenstehen.<br/><br/>Bei „Boxen ist für alle da“ trainieren Menschen mit und ohne Behinderung gemeinsam. So entstehen nicht nur sportliche Erfahrungen, sondern auch Teilhabe, Zusammenhalt und ein selbstverständliches Miteinander. Dass dieses Engagement nun besonders für den ländlichen Raum gewürdigt wird, ist ein starkes Zeichen.<br/>Die Freude über den Preis ist groß. Denn er würdigt den gemeinsamen Einsatz für Inklusion, Vielfalt und demokratisches Miteinander im Sport.<br/>Ein herzlicher Dank gilt allen Beteiligten, Unterstützer:innen und natürlich den Teilnehmenden, die dieses Projekt mit Leben füllen.<br/><br/><a class=\"link\" href=\"https://www.linkedin.com/signup/cold-join?session_redirect=https%3A%2F%2Fwww.linkedin.com%2Ffeed%2Fhashtag%2Finklusion&amp;trk=public_post-text\" target=\"_self\" data-tracking-control-name=\"public_post-text\" data-tracking-will-navigate>#Inklusion</a> <a class=\"link\" href=\"https://www.linkedin.com/signup/cold-join?session_redirect=https%3A%2F%2Fwww.linkedin.com%2Ffeed%2Fhashtag%2FsportfAeSralle&amp;trk=public_post-text\" target=\"_self\" data-tracking-control-name=\"public_post-text\" data-tracking-will-navigate>#SportFürAlle</a> <a class=\"link\" href=\"https://www.linkedin.com/signup/cold-join?session_redirect=https%3A%2F%2Fwww.linkedin.com%2Ffeed%2Fhashtag%2Fbathildisheimbewegt&amp;trk=public_post-text\" target=\"_self\" data-tracking-control-name=\"public_post-text\" data-tracking-will-navigate>#bathildisheimbewegt</a> <a class=\"link\" href=\"https://de.linkedin.com/in/sebastian-gleim-47063430a?trk=public_post-text\" target=\"_self\" data-tracking-control-name=\"public_post-text\" data-tracking-will-navigate>Sebastian Gleim</a>",
      "repost": null,
      "tagged_companies": [],
      "tagged_people": [
        {
          "link": "https://de.linkedin.com/in/sebastian-gleim-47063430a?trk=public_post-text",
          "name": "Sebastian G***m",
          "type": "people"
        }
      ],
      "user_title": null,
      "author_profile_pic": "htt***//m***a.l*********dms*********************mzL************************************************************************************************************************************************************",
      "num_connections": null,
      "video_duration": null,
      "external_link_data": null,
      "video_thumbnail": null,
      "document_cover_image": null,
      "document_page_count": null,
      "original_post_text": "Auszeichnung für gelebte Vielfalt im <a class=\"link\" href=\"https://www.linkedin.com/signup/cold-join?session_redirect=https%3A%2F%2Fwww.linkedin.com%2Ffeed%2Fhashtag%2Fsport&amp;trk=public_post-text\" target=\"_self\" data-tracking-control-name=\"public_post-text\" data-tracking-will-navigate>#Sport</a>. Das Projekt Miteinander bewegt ist gemeinsam mit dem VfL Bad Wildungen mit dem Sonderpreis „Ländlicher Raum“ der Demokratie-Verstärker:innen ausgezeichnet worden. Verliehen wurde der Preis im Rahmen der Initiative „Offen für Vielfalt – Geschlossen gegen Ausgrenzung“ im Regierungspräsidium Kassel.\nGewürdigt wurde das gemeinsame Projekt „Boxen ist für alle da“, das seit knapp einem Jahr im Landkreis Waldeck-Frankenberg angeboten wird.\n\nDie Auszeichnung macht sichtbar, was das Projekt in der Praxis zeigt: Sport ist weit mehr als Bewegung. Sport schafft Begegnung, stärkt Selbstvertrauen und verbindet Menschen mit unterschiedlichen Voraussetzungen. Gerade deshalb ist es wichtig, dass sportliche Angebote allen offenstehen.\n\nBei „Boxen ist für alle da“ trainieren Menschen mit und ohne Behinderung gemeinsam. So entstehen nicht nur sportliche Erfahrungen, sondern auch Teilhabe, Zusammenhalt und ein selbstverständliches Miteinander. Dass dieses Engagement nun besonders für den ländlichen Raum gewürdigt wird, ist ein starkes Zeichen.\nDie Freude über den Preis ist groß. Denn er würdigt den gemeinsamen Einsatz für Inklusion, Vielfalt und demokratisches Miteinander im Sport.\nEin herzlicher Dank gilt allen Beteiligten, Unterstützer:innen und natürlich den Teilnehmenden, die dieses Projekt mit Leben füllen.\n\n<a class=\"link\" href=\"https://www.linkedin.com/signup/cold-join?session_redirect=https%3A%2F%2Fwww.linkedin.com%2Ffeed%2Fhashtag%2Finklusion&amp;trk=public_post-text\" target=\"_self\" data-tracking-control-name=\"public_post-text\" data-tracking-will-navigate>#Inklusion</a> <a class=\"link\" href=\"https://www.linkedin.com/signup/cold-join?session_redirect=https%3A%2F%2Fwww.linkedin.com%2Ffeed%2Fhashtag%2FsportfAeSralle&amp;trk=public_post-text\" target=\"_self\" data-tracking-control-name=\"public_post-text\" data-tracking-will-navigate>#SportFürAlle</a> <a class=\"link\" href=\"https://www.linkedin.com/signup/cold-join?session_redirect=https%3A%2F%2Fwww.linkedin.com%2Ffeed%2Fhashtag%2Fbathildisheimbewegt&amp;trk=public_post-text\" target=\"_self\" data-tracking-control-name=\"public_post-text\" data-tracking-will-navigate>#bathildisheimbewegt</a> <a class=\"link\" href=\"https://de.linkedin.com/in/sebastian-gleim-47063430a?trk=public_post-text\" target=\"_self\" data-tracking-control-name=\"public_post-text\" data-tracking-will-navigate>Sebastian Gleim</a>"
    }
  ]
  ```
</ResponseExample>


# Collect LinkedIn profiles by URL
Source: https://docs.brightdata.com/api-reference/scrapers/social-media-apis/linkedin-profiles-collect-by-url

api-reference/sdk-specs/linkedin-profiles-collect-by-url POST /datasets/v3/scrape
Collect LinkedIn profile data by URL using the Bright Data Web Scraper API (dataset ID gd_l1viktl72bvl7bjuj0): work history, education, skills and connections.

## Query Parameters

<ParamField type="string">
  The dataset ID used for this request.

  <Warning>
    Must be set to `gd_l1viktl72bvl7bjuj0` to collect **Profiles by URL** data.
  </Warning>
</ParamField>

<ParamField type="boolean">
  Whether to send notifications when the request is completed.
</ParamField>

<ParamField type="boolean">
  Whether to include errors in the response.
</ParamField>

## Request Body

<ParamField type="object[]">
  An array of input objects.

  <Expandable title="properties">
    <ParamField type="string">
      The URL of the LinkedIn profile to collect.
    </ParamField>
  </Expandable>

  #### Example

  ```json wrap theme={null}
  {
    "input":[
      {"url":"https://www.linkedin.com/in/elad-moshe-05a90413/"},
      {"url":"https://www.linkedin.com/in/jonathan-myrvik-3baa01109"},
      {"url":"https://www.linkedin.com/in/aviv-tal-75b81/"},
      {"url":"https://www.linkedin.com/in/bulentakar/"}
    ]
  }
  ```
</ParamField>

<ResponseExample>
  ```json 200 theme={null}
  [
    {
      "id": "bud***eie***d-a*********",
      "name": "Buddemeier **",
      "city": "Marshfield, Wisconsin, United States",
      "country_code": "US",
      "position": null,
      "about": null,
      "posts": null,
      "current_company": {
        "company_id": "marshfield-clinic-health-system",
        "link": "https://www.linkedin.com/company/marshfield-clinic-health-system?trk=public_profile_topcard-current-company",
        "location": null,
        "name": "Marshfield Clinic"
      },
      "experience": [
        {
          "company": "Marshfield Clinic",
          "company_logo_url": "https://media.licdn.com/dms/image/v2/D560BAQG-SexE0os4Kw/company-logo_100_100/company-logo_100_100/0/1726590593493/marshfield_clinic_health_system_logo?e=2147483647&v=beta&t=dHRCitimMYch4pTLvVukWXMZkhkkRszOlpMekvx9FeQ",
          "description_html": null,
          "subtitle": "************** ************",
          "title": "Marshfield Clinic"
        }
      ],
      "url": "htt***//w***lin*********/in*********************6a",
      "people_also_viewed": [
        {
          "about": "Sou***rn ***ica*********",
          "location": "2K followers Tallahassee Metropolitan Area",
          "name": "Bill D***n",
          "profile_link": "htt***//w***lin*********/in*********************"
        },
        {
          "about": "Car***vas***ar *********ts,******",
          "location": "52 followers Columbus, Ohio Metropolitan Area",
          "name": "Mobusher M****d",
          "profile_link": "htt***//w***lin*********/in*********************459***"
        },
        {
          "about": "Mem***al ***man*********Sys******",
          "location": "301 followers Houston, TX",
          "name": "Danny H*****n",
          "profile_link": "htt***//w***lin*********/in*********************78"
        },
        {
          "about": "IU ***lth***rth*********Cen******",
          "location": "232 followers Fishers, IN",
          "name": "Farooq I*****r",
          "profile_link": "htt***//w***lin*********/in*********************610***"
        },
        {
          "about": "Car***log***lin********* An******",
          "location": "216 followers San Antonio, TX",
          "name": "Jorge A*****z",
          "profile_link": "htt***//w***lin*********/in*********************7"
        },
        {
          "about": "Uni***sit***f C*********ori*********************ine***",
          "location": "141 followers United States",
          "name": "Hafiz H*****n",
          "profile_link": "htt***//w***lin*********/in*********************108***"
        },
        {
          "about": "BJC***alt***yst***",
          "location": "2K followers St Louis, MO",
          "name": "Deepak K***, *** F***, F***I",
          "profile_link": "htt***//w***lin*********/in*********************fsc************"
        },
        {
          "about": "Bap***t H***th *********",
          "location": "309 followers Lexington, KY",
          "name": "Michael S***, *** M**, F***, F***I",
          "profile_link": "htt***//w***lin*********/in*********************fac******************"
        },
        {
          "about": "Val*** Vi***Reg*********pit***",
          "location": "69 followers Glenwood Springs, CO",
          "name": "Marcus H****l",
          "profile_link": "htt***//w***lin*********/in*********************92"
        },
        {
          "about": "Dan***y H***ita***",
          "location": "204 followers Danbury, CT",
          "name": "Hal W*******n",
          "profile_link": "htt***//w***lin*********/in*********************2a"
        },
        {
          "about": "Uni***sit***f K*********ica*********",
          "location": "145 followers Leawood, KS",
          "name": "Eric H******d",
          "profile_link": "htt***//w***lin*********/in*********************62"
        },
        {
          "about": "Tuf***Med***l C******",
          "location": "564 followers Greater Boston",
          "name": "Mohamad E******, M**********M",
          "profile_link": "htt***//w***lin*********/in*********************pvi***************"
        },
        {
          "about": "Ore*** He*** Ce*********",
          "location": "93 followers Salem, OR",
          "name": "Kevin T******n",
          "profile_link": "htt***//w***lin*********/in*********************919***"
        },
        {
          "about": "NEA***pti***Cli******",
          "location": "842 followers Jonesboro, AR",
          "name": "Matthew H*******, **",
          "profile_link": "htt***//w***lin*********/in*********************363******"
        },
        {
          "about": "Adv***te ***lth******",
          "location": "56 followers Greater Chicago Area",
          "name": "Raminder S***h **",
          "profile_link": "htt***//w***lin*********/in*********************473******"
        },
        {
          "about": "Ash*** He*** & *********Cen******",
          "location": "573 followers United States",
          "name": "Farah ** K****n",
          "profile_link": "htt***//w***lin*********/in*********************951***"
        },
        {
          "about": "Met***etr*** Ca*********lar************",
          "location": "253 followers Detroit, MI",
          "name": "Nithin G****m",
          "profile_link": "htt***//w***lin*********/in*********************a6"
        },
        {
          "about": "Mai***ide***edi*********r",
          "location": "383 followers Jericho, NY",
          "name": "Bilal M***k",
          "profile_link": "htt***//w***lin*********/in*********************"
        },
        {
          "about": "Jam***a H***ita***",
          "location": "371 followers New York, NY",
          "name": "Aditya M****a",
          "profile_link": "htt***//w***lin*********/in*********************72"
        }
      ],
      "educations_details": null,
      "education": null,
      "recommendations_count": null,
      "avatar": "https://static.licdn.com/aero-v1/sc/h/9c8pery4andzj6ohjkjp54ma2",
      "courses": null,
      "languages": null,
      "certifications": null,
      "recommendations": null,
      "volunteer_experience": null,
      "followers": 42,
      "connections": 41,
      "current_company_company_id": "marshfield-clinic-health-system",
      "current_company_name": "Marshfield Clinic",
      "publications": null,
      "patents": null,
      "projects": null,
      "organizations": null,
      "location": "Marshfield",
      "input_url": "htt***//w***lin*********/in*********************6a",
      "linkedin_id": "bud***eie***d-a*********",
      "activity": null,
      "linkedin_num_id": "245026690",
      "banner_image": "https://static.licdn.com/aero-v1/sc/h/5q92mjc5c51bjlwaj3rs9aa82",
      "honors_and_awards": null,
      "similar_profiles": [],
      "default_avatar": true,
      "memorialized_account": false,
      "bio_links": [],
      "first_name": "Bud***eie***",
      "last_name": "******",
      "influencer": false
    }
  ]
  ```
</ResponseExample>


# Social media scraper APIs
Source: https://docs.brightdata.com/api-reference/scrapers/social-media-apis/overview

Bright Data Social Media Scraper APIs collect profiles, posts and comments from 10 platforms across 68 dedicated endpoints, including Facebook and LinkedIn.

The Bright Data Social Media Scraper APIs collect profiles, posts, reels, jobs, events and comments from 10 social platforms through 68 dedicated endpoints, with one endpoint per data type and input method.

## Supported platforms

<CardGroup>
  <Card title="Facebook" icon="facebook" href="/api-reference/scrapers/social-media-apis/facebook-pages-posts-collect-by-url" />

  <Card title="Instagram" icon="instagram" href="/api-reference/scrapers/social-media-apis/instagram-profiles-collect-by-url" />

  <Card title="LinkedIn" icon="linkedin" href="/api-reference/scrapers/social-media-apis/linkedin-profiles-collect-by-url" />

  <Card title="TikTok" icon="tiktok" href="/api-reference/scrapers/social-media-apis/tiktok-profiles-collect-by-url" />

  <Card title="Reddit" icon="reddit" href="/api-reference/scrapers/social-media-apis/reddit-posts-collect-by-url" />

  <Card title="X (Twitter)" icon="x-twitter" href="/api-reference/scrapers/social-media-apis/twitter-posts-collect-by-url" />

  <Card title="YouTube" icon="youtube" href="/api-reference/scrapers/social-media-apis/youtube-videos-collect-by-url" />

  <Card title="Pinterest" icon="pinterest" href="/api-reference/scrapers/social-media-apis/pinterest" />

  <Card title="Quora" icon="quora" href="/api-reference/scrapers/social-media-apis/quora" />

  <Card title="Vimeo" icon="vimeo" href="/api-reference/scrapers/social-media-apis/vimeo" />
</CardGroup>

## How the endpoints are organized

Each Social Media Scraper API endpoint is dedicated to a single data type and a single input method. Endpoint names follow the pattern `{platform}-{object}-{action}-by-{input}`, for example `instagram-posts-collect-by-url` or `reddit-posts-discover-by-keyword`.

Two action types cover every endpoint:

* **Collect by URL**: you pass one or more canonical URLs and receive the structured record for each target (profile, post, video, job, listing). Use this when you already know what you want.
* **Discover by keyword, username, category or hashtag**: you pass a query and the endpoint returns the matching set of URLs and records. Use this when you need to find items before collecting them.

You can chain the two. Run a `discover` endpoint first to build a URL list, then feed that list into the matching `collect-by-url` endpoint on the same platform.

## Endpoint coverage by platform

| Platform    | Endpoints | What you can collect                                                                   |
| ----------- | --------- | -------------------------------------------------------------------------------------- |
| Facebook    | 15        | Pages, posts, comments, profiles, events, reels, marketplace listings, company reviews |
| Instagram   | 8         | Profiles, posts, reels, comments                                                       |
| LinkedIn    | 10        | Profiles, companies, posts, jobs, people discovery                                     |
| TikTok      | 12        | Profiles, posts, comments, TikTok Shop products                                        |
| Reddit      | 4         | Posts by URL, subreddit or keyword and post comments                                   |
| X (Twitter) | 6         | Posts and profiles by URL, username or profile array                                   |
| YouTube     | 10        | Videos, channels and comments by URL, keyword, hashtag or podcast                      |
| Pinterest   | 1         | Profiles and pins                                                                      |
| Quora       | 1         | Posts and answers                                                                      |
| Vimeo       | 1         | Videos and channels                                                                    |

## Data types each platform exposes

The endpoints map to three data types that are interconnected, so the output of one can be the input to another:

* **Profiles**: user, page, channel or company data, with metrics such as followers, subscribers and post counts.
* **Posts**: individual posts, reels, videos, jobs or listings, with engagement metrics such as likes, views, comments and hashtags.
* **Comments**: replies and reactions attached to a specific post or video.

### Example: end-to-end YouTube collection

1. Call `youtube-channels-discover-by-keyword` with a search term to find channels.
2. Pass the channel URLs to `youtube-channels-collect-by-url` for channel metadata.
3. Pass the same channel URLs to `youtube-videos-collect-by-url` to fetch videos.
4. Pass the resulting video URLs to `youtube-comments-collect-by-url` to fetch comments.

The same chain pattern applies to every other supported platform.

## Next steps

Pick a platform above to see its dedicated endpoints. If you are new to the Web Scraper API request model, review [Synchronous requests](/api-reference/scrapers/synchronous-requests) and [Asynchronous requests](/api-reference/rest-api/scraper/asynchronous-requests) first.


# Pinterest API scrapers
Source: https://docs.brightdata.com/api-reference/scrapers/social-media-apis/pinterest

Use the Bright Data Web Scraper API (1000+ scrapers) for Pinterest. Submit the request and retrieve the data as structured JSON records once the job completes.

## Overview

The Pinterest API Suite offers multiple types of APIs, each designed for specific data collection needs from Pinterest. Below is an overview of how these APIs connect and interact, based on the available features:

<CardGroup>
  <Card title="Profiles API" icon="user" href="/api-reference/scrapers/social-media-apis/pinterest#profiles-api">
    This API allows users to collect profile details based on a single input: profile URL.

    <br />

    *   **Discovery functionality**:

    *   Discover by Keywords.

    <br />

    *   **Interesting Columns**:

    *   `name`, `following_count`, `website`, `follower_count`.
  </Card>

  <Card title="Posts API" icon="images" href="/api-reference/scrapers/social-media-apis/pinterest#posts-api">
    This API allows users to collect multiple posts based on a single input.

    <br />

    *   **Discovery functionality**:

      *   - Discover by profile URL.

      *   - Discover by Keywords.

    <br />

    *   **Interesting Columns**:

    *   `title`, `content`, `user_name`, `likes`.
  </Card>
</CardGroup>

## Profiles API

### Collect by URL

This API allows users to retrieve detailed Pinterest profile information using the provided profile URL.

**Input Parameters**:

<ParamField type="string">
  The Pinterest profile URL.
</ParamField>

**Output Structure**:\
Includes comprehensive data points:

* **Profile Details**:\
  `url`, `profile_picture`, `name`, `nickname`, `website`, `bio`, `country_code`, `profile_id`.

  > For all data points, [click here](https://brightdata.com/cp/scrapers/gd_lk0zv93c2m9qdph46z?tab=overview).

* **Engagement & Metrics**:\
  `following_count`, `follower_count`, `boards_num`, `saved`.

* **Additional Information**:\
  `last_updated`, `posts_page_url`, `discovery_input`.

This API allows users to collect detailed insights into a Pinterest profile, including user statistics, engagement metrics, and profile information.

### Discover by Keywords

This API allows users to discover Pinterest profiles based on a specified keyword.

**Input Parameters**:

<ParamField type="string">
  The keyword to search for profiles.
</ParamField>

**Output Structure**:\
Includes comprehensive data points:

* **Profile Details**:\
  `url`, `profile_picture`, `name`, `nickname`, `website`, `bio`, `country_code`, `profile_id`.

  > For all data points, [click here](https://brightdata.com/cp/scrapers/gd_lk0zv93c2m9qdph46z/keyword?tab=overview).

* **Engagement & Metric**s:\
  `following_count`, `follower_count`, `boards_num`, saved.

* **Additional Information**:\
  `last_updated`, `posts_page_url`, `discovery_input`.

This API enables users to find Pinterest profiles related to a specific keyword, offering insights into user statistics, engagement, and profile details.

## Posts API

### Collect by URL

This API allows users to collect detailed post data from a specific Pinterest post using the provided post URL.

**Input Parameters**:

<ParamField type="string">
  The Pinterest post URL.
</ParamField>

**Output Structure**:\
Includes comprehensive data points:

* **Post Details**:\
  `url`, `post_id`, `title`, `content`, `date_posted`, `post_type`.

  > For all data points, [click here](https://brightdata.com/cp/scrapers/gd_lk0sjs4d21kdr7cnlv?tab=overview).

* **User Details**:\
  `user_name`, `user_url`, `user_id`, `followers`.

* **Post Metrics**:\
  `likes`, `comments_num`, `comments`, `categories`.

* **Media & Attachments**:\
  `image_video_url`, `video_length`, `attached_files`.

* **Hashtags & Discovery**:\
  `hashtags`, `discovery_input`.

This API allows users to retrieve detailed insights into a specific Pinterest post, including user engagement, post content, media, and other related information.

### Discover by Profile URL

This API allows users to retrieve posts from a specific Pinterest profile based on the provided profile URL.

**Input Parameters**:

<ParamField type="string">
  The Pinterest profile URL from which to collect posts.
</ParamField>

<ParamField type="number">
  The number of posts to collect. If omitted, there is no limit.
</ParamField>

<ParamField type="array">
  An array of post IDs to exclude from the results.
</ParamField>

<ParamField type="string">
  Start date for filtering posts in `MM-DD-YYYY` format (should be earlier than `end_date`).
</ParamField>

<ParamField type="string">
  End date for filtering posts in `MM-DD-YYYY` format (should be later than `start_date`).
</ParamField>

**Output Structure**:\
Includes comprehensive data points:

* **Post Details**:\
  `url`, `post_id`, `title`, `content`, `date_posted`, `user_name`, `user_url`, `user_id`, `followers`, `likes`, `categories`, `source`, `attached_files`, `image_video_url`, `video_length`, `hashtags`, `comments_num`, `comments`, `post_type`.

  > For all data points, [click here](https://brightdata.com/cp/scrapers/gd_lk0sjs4d21kdr7cnlv/profile_url?tab=overview).

* **Engagement & Metrics**:\
  `followers`, `likes`, `comments_num`.

* **Media & Attachments**:\
  `image_video_url`, `video_length`, `attached_files`.

* **Additional Information**:\
  `discovery_input`.

This API enables users tso collect posts from a specific Pinterest profile, allowing for filtering by date, exclusion of specific posts, and retrieval of detailed post data including media, comments, and engagement metrics.

### Discover by Keywords

This API allows users to discover Pinterest posts based on a specific keyword, enabling efficient content discovery.

**Input Parameters**:

<ParamField type="string">
  The keyword to search for posts, such as "food" or any other relevant term.
</ParamField>

**Output Structure**:\
Includes comprehensive data points:

* **Post Details**:\
  `url`, `post_id`, `title`, `content`, `date_posted`, `user_name`, `user_url`, `user_id`, `followers`, `likes`, `categories`, `source`, `attached_files`, `image_video_url`, `video_length`, `hashtags`, `comments_num`, `comments`, `post_type`.

  > For all data points, [click here](https://brightdata.com/cp/scrapers/gd_lk0zv93c2m9qdph46z/keyword?tab=overview).

* **Engagement & Metrics**:\
  `followers`, `likes`, `comments_num`.

* **Media & Attachments**:\
  `image_video_url`, `video_length`, `attached_files`.

* **Additional Information**:\
  `discovery_input`.

This API enables users to search for Pinterest posts based on a specific keyword, providing detailed insights into the content, engagement, media, and associated metrics for efficient discovery.


# Quora API scrapers
Source: https://docs.brightdata.com/api-reference/scrapers/social-media-apis/quora

Use the Bright Data Web Scraper API (1000+ scrapers) for Quora. Submit the request and retrieve the data as structured JSON records once the job completes.

## Overview

<CardGroup>
  <Card title="Posts API" icon="images" href="/api-reference/scrapers/social-media-apis/quora#posts-api">
    This API allows users to collect multiple posts based on a single input URL.

    <br />

    *   **Discovery functionality**:

    *   N/A

    <br />

    *   **Interesting Columns**:

    *   `author_name`, `title`, `over_all_answers`, `shares`.
  </Card>
</CardGroup>

## Posts API

### Collect by URL

This API allows users to collect detailed information about a specific Quora post using the provided post URL.

**Input Parameters**

<ParamField type="string">
  The URL of the Quora post.
</ParamField>

**Output Structure**:\
Includes comprehensive data points:

* **Post Details**:\
  `url`, `post_id`, `title`, `post_date`, `originally_answered`, `over_all_answers`, `post_text`, `header`.

  > For all data points, [click here](https://brightdata.com/cp/scrapers/gd_lvz1rbj81afv3m6n5y?tab=overview).

* **Media & Links**:\
  `pictures_urls`, `videos_urls`, `external_urls`.

* **Engagement & Metrics**:\
  `upvotes`, `shares`, `views`, `author_content_views`.

* **Author Details**:\
  `author_name`, `author_active_spaces`, `author_joined_date`, `author_about`, `author_education`.

* **Top Comments**:\
  `top_comments`.

This API provides detailed insights into a Quora post, including content, media, author information, and engagement metrics, enabling efficient post analysis and content tracking.


# Collect Reddit comments by URL
Source: https://docs.brightdata.com/api-reference/scrapers/social-media-apis/reddit-comments-collect-by-url

POST https://api.brightdata.com/datasets/v3/scrape
Use the Bright Data Web Scraper API to collect Reddit comments by URL. Calls the POST /datasets/v3/scrape endpoint and returns a snapshot ID.

## Query Parameters

<ParamField type="string">
  The dataset ID used for this request.

  <Warning>
    Must be set to `gd_lvzdpsdlw09j6t702` to collect **Comments by URL** data.
  </Warning>
</ParamField>

<ParamField type="boolean">
  Whether to send notifications when the request is completed.
</ParamField>

<ParamField type="boolean">
  Whether to include errors in the response.
</ParamField>

## Request Body

<ParamField type="object[]">
  An array of input objects.

  <Expandable title="properties">
    <ParamField type="string">
      The URL of the Reddit post or comment thread to collect comments from.
    </ParamField>

    <ParamField type="number">
      Limit results to comments published within this number of days.
    </ParamField>
  </Expandable>

  #### Example

  ```json wrap theme={null}
  {
    "input": [
      {"url": "https://www.reddit.com/r/learnpython/comments/1asdf12/", "days_back": 7},
      {"url": "https://www.reddit.com/r/python/comments/1bsdf34/"}
    ]
  }
  ```
</ParamField>

<ResponseExample>
  ```json 200 theme={null}
  [
    {
      "comment_id": "k5f7a9b",
      "url": "https://www.reddit.com/r/learnpython/comments/1asdf12/comment/k5f7a9b/",
      "user_posted": "helpful_dev",
      "comment": "Start with the official Python tutorial, it covers the basics well.",
      "date_posted": "2026-03-15T08:42:00Z",
      "num_upvotes": 24,
      "num_replies": 3,
      "replies": [],
      "post_url": "https://www.reddit.com/r/learnpython/comments/1asdf12/",
      "post_id": "1asdf12",
      "post_language": "en",
      "post_state": "active",
      "post_type": "text",
      "images": [],
      "community_name": "learnpython",
      "community_url": "https://www.reddit.com/r/learnpython",
      "community_description": "Subreddit for posting questions and asking for general advice about your Python code.",
      "community_members_num": 1120000,
      "community_rank": null,
      "is_moderator": false,
      "is_pinned": false,
      "has_bot_in_username": false,
      "is_locked": false,
      "is_admin_post": false,
      "is_archived_post": false,
      "is_moderator_post": false,
      "is_quarantined_post": false,
      "is_not_safe_for_work_post": false,
      "is_eligible_for_content_blocking_post": false,
      "is_promoted_post": false
    }
  ]
  ```
</ResponseExample>


# Collect Reddit posts by URL
Source: https://docs.brightdata.com/api-reference/scrapers/social-media-apis/reddit-posts-collect-by-url

api-reference/sdk-specs/reddit-posts-collect-by-url POST /datasets/v3/scrape
Use the Bright Data Web Scraper API to collect Reddit posts by URL. Calls the POST /datasets/v3/scrape endpoint and returns a snapshot ID.

## Query Parameters

<ParamField type="string">
  The dataset ID used for this request.

  <Warning>
    Must be set to `gd_lvz8ah06191smkebj4` to collect **Posts by URL** data.
  </Warning>
</ParamField>

<ParamField type="boolean">
  Whether to send notifications when the request is completed.
</ParamField>

<ParamField type="boolean">
  Whether to include errors in the response.
</ParamField>

## Request Body

<ParamField type="object[]">
  An array of input objects.

  <Expandable title="properties">
    <ParamField type="string">
      The URL of the Reddit post to retrieve.
    </ParamField>
  </Expandable>

  #### Example

  ```json wrap theme={null}
  {
    "input": [
      {"url": "https://www.reddit.com/r/learnpython/comments/1asdf12/how_do_i_start_learning_python/"},
      {"url": "https://www.reddit.com/r/python/comments/1bsdf34/"}
    ]
  }
  ```
</ParamField>

<ResponseExample>
  ```json 200 theme={null}
  [
    {
      "post_id": "1asdf12",
      "url": "https://www.reddit.com/r/learnpython/comments/1asdf12/how_do_i_start_learning_python/",
      "user_posted": "example_user",
      "title": "How do I start learning Python?",
      "description": "I'm a complete beginner...",
      "num_upvotes": 1240,
      "num_comments": 86,
      "date_posted": "2026-03-14T18:22:00Z",
      "tag": "Tutorial",
      "community_name": "learnpython",
      "community_url": "https://www.reddit.com/r/learnpython",
      "community_description": "Subreddit for posting questions and asking for general advice about your Python code.",
      "community_members_num": 1120000,
      "community_rank": null,
      "related_posts": [],
      "comments": [],
      "photos": [],
      "videos": []
    }
  ]
  ```
</ResponseExample>


# Discover posts by keyword
Source: https://docs.brightdata.com/api-reference/scrapers/social-media-apis/reddit-posts-discover-by-keyword

POST https://api.brightdata.com/datasets/v3/scrape
Use the Bright Data Web Scraper API to discover Posts by Keyword. Calls the POST /datasets/v3/scrape endpoint and returns a snapshot ID.

## Query Parameters

<ParamField type="string">
  The dataset ID used for this request.

  <Warning>
    Must be set to `gd_lvz8ah06191smkebj4` to collect **Discover by keyword** data.
  </Warning>
</ParamField>

<ParamField type="string">
  Must be set to `discover_new`.
</ParamField>

<ParamField type="string">
  Must be set to `keyword`.
</ParamField>

<ParamField type="boolean">
  Whether to send notifications when the request is completed.
</ParamField>

<ParamField type="boolean">
  Whether to include errors in the response.
</ParamField>

## Request Body

<ParamField type="object[]">
  An array of input objects.

  <Expandable title="properties">
    <ParamField type="string">
      The search term to find relevant posts.
    </ParamField>

    <ParamField type="string">
      The date filter to apply to the search.

      One of: `Past hour`, `Past day`, `Past week`, `Past month`, `Past year`, `All time`
    </ParamField>

    <ParamField type="number">
      The number of posts to collect. Omit to retrieve all matching posts.
    </ParamField>
  </Expandable>

  #### Example

  ```json wrap theme={null}
  {
    "input": [
      {"keyword": "machine learning", "date": "Past week", "num_of_posts": 100},
      {"keyword": "python tips", "date": "Past month", "num_of_posts": 50}
    ]
  }
  ```
</ParamField>

<ResponseExample>
  ```json 200 theme={null}
  [
    {
      "post_id": "1bsdf34",
      "url": "https://www.reddit.com/r/MachineLearning/comments/1bsdf34/",
      "user_posted": "ml_researcher",
      "title": "New paper on transformer efficiency",
      "description": "Sharing a recent paper...",
      "num_upvotes": 842,
      "num_comments": 54,
      "date_posted": "2026-04-03T09:14:00Z",
      "tag": "Research",
      "community_name": "MachineLearning",
      "community_url": "https://www.reddit.com/r/MachineLearning",
      "community_description": "Beginners to experts.",
      "community_members_num": 2900000,
      "community_rank": null,
      "related_posts": [],
      "comments": [],
      "photos": [],
      "videos": []
    }
  ]
  ```
</ResponseExample>


# Discover posts by subreddit URL
Source: https://docs.brightdata.com/api-reference/scrapers/social-media-apis/reddit-posts-discover-by-subreddit-url

POST https://api.brightdata.com/datasets/v3/scrape
Use the Bright Data Web Scraper API to discover Posts by Subreddit URL. Calls the POST /datasets/v3/scrape endpoint and returns a snapshot ID.

## Query Parameters

<ParamField type="string">
  The dataset ID used for this request.

  <Warning>
    Must be set to `gd_lvz8ah06191smkebj4` to collect **Discover by subreddit URL** data.
  </Warning>
</ParamField>

<ParamField type="string">
  Must be set to `discover_new`.
</ParamField>

<ParamField type="string">
  Must be set to `subreddit_url`.
</ParamField>

<ParamField type="boolean">
  Whether to send notifications when the request is completed.
</ParamField>

<ParamField type="boolean">
  Whether to include errors in the response.
</ParamField>

## Request Body

<ParamField type="object[]">
  An array of input objects.

  <Expandable title="properties">
    <ParamField type="string">
      The URL of the subreddit to collect posts from.
    </ParamField>

    <ParamField type="string">
      The sort order for returned posts.

      One of: `new`, `top`, `hot`
    </ParamField>
  </Expandable>

  #### Example

  ```json wrap theme={null}
  {
    "input": [
      {"url": "https://www.reddit.com/r/learnpython/", "sort_by": "hot"},
      {"url": "https://www.reddit.com/r/datascience/", "sort_by": "top"}
    ]
  }
  ```
</ParamField>

<ResponseExample>
  ```json 200 theme={null}
  [
    {
      "post_id": "1csdf56",
      "url": "https://www.reddit.com/r/learnpython/comments/1csdf56/",
      "user_posted": "newbie_dev",
      "title": "Best resources for learning pandas?",
      "description": "I'm about two weeks into Python...",
      "num_upvotes": 312,
      "num_comments": 41,
      "date_posted": "2026-04-05T14:05:00Z",
      "tag": "Help",
      "community_name": "learnpython",
      "community_url": "https://www.reddit.com/r/learnpython",
      "community_description": "Subreddit for posting questions and asking for general advice about your Python code.",
      "community_members_num": 1120000,
      "community_rank": null,
      "related_posts": [],
      "comments": [],
      "photos": [],
      "videos": []
    }
  ]
  ```
</ResponseExample>


# Collect TikTok comments by URL
Source: https://docs.brightdata.com/api-reference/scrapers/social-media-apis/tiktok-comments-collect-by-url

api-reference/sdk-specs/tiktok-comments-collect-by-url POST /datasets/v3/scrape
Use the Bright Data Web Scraper API to collect TikTok comments by URL. Calls the POST /datasets/v3/scrape endpoint and returns a snapshot ID.

## Query Parameters

<ParamField type="string">
  The dataset ID used for this request.

  <Warning>
    Must be set to `gd_lkf2st302ap89utw5k` to collect **Comments by URL** data.
  </Warning>
</ParamField>

<ParamField type="boolean">
  Whether to send notifications when the request is completed.
</ParamField>

<ParamField type="boolean">
  Whether to include errors in the response.
</ParamField>

## Request Body

<ParamField type="object[]">
  An array of input objects.

  <Expandable title="properties">
    <ParamField type="string">
      The URL of the TikTok post to collect comments from.
    </ParamField>
  </Expandable>

  #### Example

  ```json wrap theme={null}
  {
    "input": [
      {"url": "https://www.tiktok.com/@mrbeast/video/7553300000000000000"}
    ]
  }
  ```
</ParamField>

<ResponseExample>
  ```json 200 theme={null}
  [
    {
      "post_url": "https://www.tiktok.com/@examplecreator/video/7553300000000000000",
      "post_id": "7553300000000000000",
      "post_date_created": "2025-01-15T14:30:00.000Z",
      "date_created": "2025-01-15T16:45:00.000Z",
      "comment_text": "This is amazing content!",
      "num_likes": 1250,
      "num_replies": 15,
      "comment_id": "7553400000000000000",
      "comment_url": "https://www.tiktok.com/@examplecreator/video/7553300000000000000?comment=7553400000000000000",
      "commenter_user_name": "viewer123",
      "commenter_id": "456789012",
      "commenter_url": "https://www.tiktok.com/@viewer123"
    }
  ]
  ```
</ResponseExample>


# Collect posts by profile Fast API
Source: https://docs.brightdata.com/api-reference/scrapers/social-media-apis/tiktok-posts-by-profile-fast-api-collect-by-url

POST https://api.brightdata.com/datasets/v3/scrape
Use the Bright Data Web Scraper API to collect Posts by Profile Fast API. Calls the POST /datasets/v3/scrape endpoint and returns a snapshot ID.

## Query Parameters

<ParamField type="string">
  The dataset ID used for this request.

  <Warning>
    Must be set to `gd_m7n5v2gq296pex2f5m` to collect **Posts by Profile Fast API** data.
  </Warning>
</ParamField>

<ParamField type="boolean">
  Whether to send notifications when the request is completed.
</ParamField>

<ParamField type="boolean">
  Whether to include errors in the response.
</ParamField>

## Request Body

<ParamField type="object[]">
  An array of input objects.

  <Expandable title="properties">
    <ParamField type="string">
      The URL of the TikTok profile to collect posts from.
    </ParamField>

    <ParamField type="number">
      The number of recent posts to collect. Missing value indicates no limit.
    </ParamField>

    <ParamField type="string">
      Start date filter in `MM-DD-YYYY` format (should be earlier than `end_date`).
    </ParamField>

    <ParamField type="string">
      End date filter in `MM-DD-YYYY` format (should be later than `start_date`).
    </ParamField>
  </Expandable>

  #### Example

  ```json wrap theme={null}
  {
    "input": [
      {
        "url": "https://www.tiktok.com/@mrbeast",
        "num_of_posts": 20,
        "start_date": "01-01-2025",
        "end_date": "03-01-2025"
      }
    ]
  }
  ```
</ParamField>

<ResponseExample>
  ```json 200 theme={null}
  [
    {
      "post_id": "7553300000000000000",
      "description": "New challenge video is here #challenge #viral",
      "create_time": "2025-02-01T10:00:00.000Z",
      "share_count": 95000,
      "collect_count": 28000,
      "comment_count": 18000,
      "play_count": 42000000,
      "video_duration": 90,
      "hashtags": [
        "#challenge",
        "#viral"
      ],
      "video_url": "https://v16-webapp-prime.tiktok.com/video/example.mp4",
      "profile_username": "examplecreator",
      "profile_url": "https://www.tiktok.com/@examplecreator",
      "is_verified": true
    }
  ]
  ```
</ResponseExample>


# Collect TikTok posts by URL
Source: https://docs.brightdata.com/api-reference/scrapers/social-media-apis/tiktok-posts-collect-by-url

api-reference/sdk-specs/tiktok-posts-collect-by-url POST /datasets/v3/scrape
Use the Bright Data Web Scraper API to collect TikTok posts by URL. Calls the POST /datasets/v3/scrape endpoint and returns a snapshot ID.

## Query Parameters

<ParamField type="string">
  The dataset ID used for this request.

  <Warning>
    Must be set to `gd_lu702nij2f790tmv9h` to collect **Posts by URL** data.
  </Warning>
</ParamField>

<ParamField type="boolean">
  Whether to send notifications when the request is completed.
</ParamField>

<ParamField type="boolean">
  Whether to include errors in the response.
</ParamField>

## Request Body

<ParamField type="object[]">
  An array of input objects.

  <Expandable title="properties">
    <ParamField type="string">
      The URL of the TikTok post to collect.
    </ParamField>
  </Expandable>

  #### Example

  ```json wrap theme={null}
  {
    "input": [
      {"url": "https://www.tiktok.com/@mrbeast/video/7553300000000000000"},
      {"url": "https://www.tiktok.com/@bellapoarch/video/7400000000000000000"}
    ]
  }
  ```
</ParamField>

<ResponseExample>
  ```json 200 theme={null}
  [
    {
      "post_id": "7553300000000000000",
      "description": "This is an example post description #fyp #viral",
      "create_time": "2025-01-15T14:30:00.000Z",
      "share_count": 45000,
      "collect_count": 12000,
      "comment_count": 8500,
      "play_count": 15000000,
      "video_duration": 45,
      "hashtags": [
        "#fyp",
        "#viral"
      ],
      "video_url": "https://v16-webapp-prime.tiktok.com/video/example.mp4",
      "profile_username": "examplecreator",
      "profile_url": "https://www.tiktok.com/@examplecreator",
      "is_verified": true
    }
  ]
  ```
</ResponseExample>


# Discover TikTok posts by keyword
Source: https://docs.brightdata.com/api-reference/scrapers/social-media-apis/tiktok-posts-discover-by-keyword

POST https://api.brightdata.com/datasets/v3/scrape
Use the Bright Data Web Scraper API to discover TikTok posts by keyword. Calls the POST /datasets/v3/scrape endpoint and returns a snapshot ID.

## Query Parameters

<ParamField type="string">
  The dataset ID used for this request.

  <Warning>
    Must be set to `gd_lu702nij2f790tmv9h` to collect **Discover by Keyword** data.
  </Warning>
</ParamField>

<ParamField type="string">
  Must be set to `discover_new`.
</ParamField>

<ParamField type="string">
  Must be set to `keyword`.
</ParamField>

<ParamField type="boolean">
  Whether to send notifications when the request is completed.
</ParamField>

<ParamField type="boolean">
  Whether to include errors in the response.
</ParamField>

## Request Body

<ParamField type="object[]">
  An array of input objects.

  <Expandable title="properties">
    <ParamField type="string">
      The keyword to search for TikTok posts.
    </ParamField>

    <ParamField type="number">
      The number of posts to collect. Missing value indicates no limit.
    </ParamField>

    <ParamField type="string">
      Specifies what data to collect from each post.
    </ParamField>
  </Expandable>

  #### Example

  ```json wrap theme={null}
  {
    "input": [
      {
        "search_keyword": "cooking recipes",
        "num_of_posts": 20
      }
    ]
  }
  ```
</ParamField>

<ResponseExample>
  ```json 200 theme={null}
  [
    {
      "post_id": "7500000000000000000",
      "description": "Easy pasta recipe you need to try #cooking #recipes #foodtok",
      "create_time": "2025-02-10T09:15:00.000Z",
      "share_count": 3200,
      "collect_count": 8900,
      "comment_count": 1500,
      "play_count": 5200000,
      "video_duration": 60,
      "hashtags": [
        "#cooking",
        "#recipes",
        "#foodtok"
      ],
      "video_url": "https://v16-webapp-prime.tiktok.com/video/example.mp4",
      "profile_username": "homechef",
      "profile_url": "https://www.tiktok.com/@homechef",
      "is_verified": false
    }
  ]
  ```
</ResponseExample>


# Discover by profile URL
Source: https://docs.brightdata.com/api-reference/scrapers/social-media-apis/tiktok-posts-discover-by-profile-url

POST https://api.brightdata.com/datasets/v3/scrape
Use the Bright Data Web Scraper API to discover by Profile URL. POST /datasets/v3/scrape starts a scraping job that returns the data as structured JSON records.

## Query Parameters

<ParamField type="string">
  The dataset ID used for this request.

  <Warning>
    Must be set to `gd_lu702nij2f790tmv9h` to collect **Discover by Profile URL** data.
  </Warning>
</ParamField>

<ParamField type="string">
  Must be set to `discover_new`.
</ParamField>

<ParamField type="string">
  Must be set to `profile_url`.
</ParamField>

<ParamField type="boolean">
  Whether to send notifications when the request is completed.
</ParamField>

<ParamField type="boolean">
  Whether to include errors in the response.
</ParamField>

## Request Body

<ParamField type="object[]">
  An array of input objects.

  <Expandable title="properties">
    <ParamField type="string">
      The URL of the TikTok profile to discover posts from.
    </ParamField>

    <ParamField type="number">
      The number of recent posts to collect. Missing value indicates no limit.
    </ParamField>

    <ParamField type="string">
      Start date filter in `MM-DD-YYYY` format (should be earlier than `end_date`).
    </ParamField>

    <ParamField type="string">
      End date filter in `MM-DD-YYYY` format (should be later than `start_date`).
    </ParamField>

    <ParamField type="string[]">
      Post IDs to exclude from the results.
    </ParamField>

    <ParamField type="string">
      Specifies what data to collect from each post.
    </ParamField>
  </Expandable>

  #### Example

  ```json wrap theme={null}
  {
    "input": [
      {
        "url": "https://www.tiktok.com/@mrbeast",
        "num_of_posts": 10,
        "start_date": "01-01-2025",
        "end_date": "03-01-2025"
      }
    ]
  }
  ```
</ParamField>

<ResponseExample>
  ```json 200 theme={null}
  [
    {
      "post_id": "7553300000000000000",
      "description": "You won't believe what happened next #challenge",
      "create_time": "2025-01-20T18:00:00.000Z",
      "share_count": 120000,
      "collect_count": 45000,
      "comment_count": 32000,
      "play_count": 85000000,
      "video_duration": 120,
      "hashtags": [
        "#challenge"
      ],
      "video_url": "https://v16-webapp-prime.tiktok.com/video/example.mp4",
      "profile_username": "examplecreator",
      "profile_url": "https://www.tiktok.com/@examplecreator",
      "is_verified": true
    }
  ]
  ```
</ResponseExample>


# Discover TikTok posts by URL
Source: https://docs.brightdata.com/api-reference/scrapers/social-media-apis/tiktok-posts-discover-by-url

POST https://api.brightdata.com/datasets/v3/scrape
Use the Bright Data Web Scraper API to discover TikTok posts by URL. Calls the POST /datasets/v3/scrape endpoint and returns a snapshot ID.

## Query Parameters

<ParamField type="string">
  The dataset ID used for this request.

  <Warning>
    Must be set to `gd_lu702nij2f790tmv9h` to collect **Discover by URL** data.
  </Warning>
</ParamField>

<ParamField type="string">
  Must be set to `discover_new`.
</ParamField>

<ParamField type="string">
  Must be set to `url`.
</ParamField>

<ParamField type="boolean">
  Whether to send notifications when the request is completed.
</ParamField>

<ParamField type="boolean">
  Whether to include errors in the response.
</ParamField>

## Request Body

<ParamField type="object[]">
  An array of input objects.

  <Expandable title="properties">
    <ParamField type="string">
      The TikTok discover URL to collect posts from.
    </ParamField>
  </Expandable>

  #### Example

  ```json wrap theme={null}
  {
    "input": [
      {"url": "https://www.tiktok.com/tag/cooking"}
    ]
  }
  ```
</ParamField>

<ResponseExample>
  ```json 200 theme={null}
  [
    {
      "post_id": "7480000000000000000",
      "description": "5-minute meal prep ideas #cooking #mealprep",
      "create_time": "2025-03-05T12:00:00.000Z",
      "share_count": 8700,
      "collect_count": 15000,
      "comment_count": 2300,
      "play_count": 9800000,
      "video_duration": 55,
      "hashtags": [
        "#cooking",
        "#mealprep"
      ],
      "video_url": "https://v16-webapp-prime.tiktok.com/video/example.mp4",
      "profile_username": "quickmeals",
      "profile_url": "https://www.tiktok.com/@quickmeals",
      "is_verified": false
    }
  ]
  ```
</ResponseExample>


# Collect TikTok profiles by URL
Source: https://docs.brightdata.com/api-reference/scrapers/social-media-apis/tiktok-profiles-collect-by-url

api-reference/sdk-specs/tiktok-profiles-collect-by-url POST /datasets/v3/scrape
Use the Bright Data Web Scraper API to collect TikTok profiles by URL. Calls the POST /datasets/v3/scrape endpoint and returns a snapshot ID.

## Query Parameters

<ParamField type="string">
  The dataset ID used for this request.

  <Warning>
    Must be set to `gd_l1villgoiiidt09ci` to collect **Profiles by URL** data.
  </Warning>
</ParamField>

<ParamField type="boolean">
  Whether to send notifications when the request is completed.
</ParamField>

<ParamField type="boolean">
  Whether to include errors in the response.
</ParamField>

## Request Body

<ParamField type="object[]">
  An array of input objects.

  <Expandable title="properties">
    <ParamField type="string">
      The URL of the TikTok profile to collect.
    </ParamField>
  </Expandable>

  #### Example

  ```json wrap theme={null}
  {
    "input": [
      {"url": "https://www.tiktok.com/@mrbeast"},
      {"url": "https://www.tiktok.com/@charlidamelio"}
    ]
  }
  ```
</ParamField>

<ResponseExample>
  ```json 200 theme={null}
  [
    {
      "account_id": "123456789",
      "nickname": "Example Creator",
      "biography": "Content creator and storyteller",
      "bio_link": "https://example.com",
      "is_verified": true,
      "followers": 150000000,
      "following": 800,
      "likes": 3200000000,
      "videos_count": 950,
      "create_time": "2018-05-20T00:00:00.000Z",
      "url": "https://www.tiktok.com/@examplecreator",
      "profile_pic_url": "https://p16-sign-sg.tiktokcdn.com/example-avatar~100x100.jpeg",
      "profile_pic_url_hd": "https://p16-sign-sg.tiktokcdn.com/example-avatar~720x720.jpeg",
      "awg_engagement_rate": 0.0432,
      "is_private": false,
      "region": "US"
    }
  ]
  ```
</ResponseExample>


# Discover by search URL
Source: https://docs.brightdata.com/api-reference/scrapers/social-media-apis/tiktok-profiles-discover-by-search-url

POST https://api.brightdata.com/datasets/v3/scrape
Use the Bright Data Web Scraper API to discover by Search URL. POST /datasets/v3/scrape starts a scraping job that returns the data as structured JSON records.

## Query Parameters

<ParamField type="string">
  The dataset ID used for this request.

  <Warning>
    Must be set to `gd_l1villgoiiidt09ci` to collect **Discover by Search URL** data.
  </Warning>
</ParamField>

<ParamField type="string">
  Must be set to `discover_new`.
</ParamField>

<ParamField type="string">
  Must be set to `search_url`.
</ParamField>

<ParamField type="boolean">
  Whether to send notifications when the request is completed.
</ParamField>

<ParamField type="boolean">
  Whether to include errors in the response.
</ParamField>

## Request Body

<ParamField type="object[]">
  An array of input objects.

  <Expandable title="properties">
    <ParamField type="string">
      The TikTok search URL to discover profiles from.
    </ParamField>

    <ParamField type="string">
      The country from which to perform the search.
    </ParamField>
  </Expandable>

  #### Example

  ```json wrap theme={null}
  {
    "input": [
      {
        "search_url": "https://www.tiktok.com/search/user?q=cooking",
        "country": "us"
      }
    ]
  }
  ```
</ParamField>

<ResponseExample>
  ```json 200 theme={null}
  [
    {
      "account_id": "987654321",
      "nickname": "Cooking Daily",
      "biography": "Easy recipes for busy people",
      "bio_link": "https://example.com/recipes",
      "is_verified": false,
      "followers": 2500000,
      "following": 150,
      "likes": 45000000,
      "videos_count": 320,
      "create_time": "2020-03-15T00:00:00.000Z",
      "url": "https://www.tiktok.com/@cookingdaily",
      "profile_pic_url": "https://p16-sign-sg.tiktokcdn.com/example-avatar~100x100.jpeg",
      "profile_pic_url_hd": "https://p16-sign-sg.tiktokcdn.com/example-avatar~720x720.jpeg",
      "awg_engagement_rate": 0.0521,
      "is_private": false,
      "region": "US"
    }
  ]
  ```
</ResponseExample>


# Collect Shop by URL
Source: https://docs.brightdata.com/api-reference/scrapers/social-media-apis/tiktok-shop-collect-by-url

POST https://api.brightdata.com/datasets/v3/scrape
Use the Bright Data Web Scraper API to collect Shop by URL. POST /datasets/v3/scrape starts a scraping job that returns the data as structured JSON records.

## Query Parameters

<ParamField type="string">
  The dataset ID used for this request.

  <Warning>
    Must be set to `gd_m45m1u911dsa4274pi` to collect **Shop by URL** data.
  </Warning>
</ParamField>

<ParamField type="boolean">
  Whether to send notifications when the request is completed.
</ParamField>

<ParamField type="boolean">
  Whether to include errors in the response.
</ParamField>

## Request Body

<ParamField type="object[]">
  An array of input objects.

  <Expandable title="properties">
    <ParamField type="string">
      The URL of the TikTok Shop product to collect.
    </ParamField>
  </Expandable>

  #### Example

  ```json wrap theme={null}
  {
    "input": [
      {"url": "https://www.tiktok.com/view/product/1729000000000000000"}
    ]
  }
  ```
</ParamField>

<ResponseExample>
  ```json 200 theme={null}
  [
    {
      "url": "https://www.tiktok.com/view/product/1729000000000000000",
      "title": "Wireless Bluetooth Headphones with Noise Cancellation",
      "price": 29.99,
      "currency": "USD",
      "rating": 4.7,
      "reviews_count": 1250,
      "seller_name": "TechGadgets Official",
      "seller_url": "https://www.tiktok.com/@techgadgets",
      "description": "High-quality wireless headphones with active noise cancellation and 30-hour battery life.",
      "images": [
        "https://p16-oec-ttp.tiktokcdn-us.com/example-product-1.jpeg",
        "https://p16-oec-ttp.tiktokcdn-us.com/example-product-2.jpeg"
      ],
      "category": "Electronics > Audio > Headphones"
    }
  ]
  ```
</ResponseExample>


# Discover by category
Source: https://docs.brightdata.com/api-reference/scrapers/social-media-apis/tiktok-shop-discover-by-category

POST https://api.brightdata.com/datasets/v3/scrape
Use the Bright Data Web Scraper API to discover by Category. POST /datasets/v3/scrape starts a scraping job that returns the data as structured JSON records.

## Query Parameters

<ParamField type="string">
  The dataset ID used for this request.

  <Warning>
    Must be set to `gd_m45m1u911dsa4274pi` to collect **Discover by Category** data.
  </Warning>
</ParamField>

<ParamField type="string">
  Must be set to `discover_new`.
</ParamField>

<ParamField type="string">
  Must be set to `category_url`.
</ParamField>

<ParamField type="boolean">
  Whether to send notifications when the request is completed.
</ParamField>

<ParamField type="boolean">
  Whether to include errors in the response.
</ParamField>

## Request Body

<ParamField type="object[]">
  An array of input objects.

  <Expandable title="properties">
    <ParamField type="string">
      The TikTok Shop category URL to discover products from.
    </ParamField>

    <ParamField type="number">
      The number of products to collect. Missing value indicates no limit.
    </ParamField>
  </Expandable>

  #### Example

  ```json wrap theme={null}
  {
    "input": [
      {
        "category_url": "https://www.tiktok.com/browse/electronics",
        "num_of_products": 20
      }
    ]
  }
  ```
</ParamField>

<ResponseExample>
  ```json 200 theme={null}
  [
    {
      "url": "https://www.tiktok.com/view/product/1730000000000000000",
      "title": "Portable Bluetooth Speaker Waterproof",
      "price": 19.99,
      "currency": "USD",
      "rating": 4.5,
      "reviews_count": 870,
      "seller_name": "AudioShop",
      "seller_url": "https://www.tiktok.com/@audioshop",
      "description": "Compact waterproof Bluetooth speaker with 12-hour battery life.",
      "images": [
        "https://p16-oec-ttp.tiktokcdn-us.com/example-product-1.jpeg"
      ],
      "category": "Electronics > Audio > Speakers"
    }
  ]
  ```
</ResponseExample>


# Discover TikTok Shop products by keyword
Source: https://docs.brightdata.com/api-reference/scrapers/social-media-apis/tiktok-shop-discover-by-keyword

POST https://api.brightdata.com/datasets/v3/scrape
Use the Bright Data Web Scraper API to discover TikTok Shop products by keyword. Calls the POST /datasets/v3/scrape endpoint.

## Query Parameters

<ParamField type="string">
  The dataset ID used for this request.

  <Warning>
    Must be set to `gd_m45m1u911dsa4274pi` to collect **Discover by Keyword** data.
  </Warning>
</ParamField>

<ParamField type="string">
  Must be set to `discover_new`.
</ParamField>

<ParamField type="string">
  Must be set to `keyword`.
</ParamField>

<ParamField type="boolean">
  Whether to send notifications when the request is completed.
</ParamField>

<ParamField type="boolean">
  Whether to include errors in the response.
</ParamField>

## Request Body

<ParamField type="object[]">
  An array of input objects.

  <Expandable title="properties">
    <ParamField type="string">
      The keyword to search for TikTok Shop products.
    </ParamField>

    <ParamField type="number">
      The number of products to collect. Missing value indicates no limit.
    </ParamField>
  </Expandable>

  #### Example

  ```json wrap theme={null}
  {
    "input": [
      {
        "keyword": "wireless earbuds",
        "num_of_products": 15
      }
    ]
  }
  ```
</ParamField>

<ResponseExample>
  ```json 200 theme={null}
  [
    {
      "url": "https://www.tiktok.com/view/product/1731000000000000000",
      "title": "Wireless Earbuds with Charging Case",
      "price": 24.99,
      "currency": "USD",
      "rating": 4.3,
      "reviews_count": 2100,
      "seller_name": "EarTech Store",
      "seller_url": "https://www.tiktok.com/@eartechstore",
      "description": "True wireless earbuds with touch controls and 24-hour total battery life.",
      "images": [
        "https://p16-oec-ttp.tiktokcdn-us.com/example-product-1.jpeg"
      ],
      "category": "Electronics > Audio > Earbuds"
    }
  ]
  ```
</ResponseExample>


# Discover by shop
Source: https://docs.brightdata.com/api-reference/scrapers/social-media-apis/tiktok-shop-discover-by-shop

POST https://api.brightdata.com/datasets/v3/scrape
Use the Bright Data Web Scraper API to discover by Shop. POST /datasets/v3/scrape starts a scraping job that returns the data as structured JSON records.

## Query Parameters

<ParamField type="string">
  The dataset ID used for this request.

  <Warning>
    Must be set to `gd_m45m1u911dsa4274pi` to collect **Discover by Shop** data.
  </Warning>
</ParamField>

<ParamField type="string">
  Must be set to `discover_new`.
</ParamField>

<ParamField type="string">
  Must be set to `shop_url`.
</ParamField>

<ParamField type="boolean">
  Whether to send notifications when the request is completed.
</ParamField>

<ParamField type="boolean">
  Whether to include errors in the response.
</ParamField>

## Request Body

<ParamField type="object[]">
  An array of input objects.

  <Expandable title="properties">
    <ParamField type="string">
      The URL of the TikTok Shop to discover products from.
    </ParamField>

    <ParamField type="number">
      The number of products to collect. Missing value indicates no limit.
    </ParamField>
  </Expandable>

  #### Example

  ```json wrap theme={null}
  {
    "input": [
      {
        "shop_url": "https://www.tiktok.com/@techgadgets/shop",
        "num_of_products": 25
      }
    ]
  }
  ```
</ParamField>

<ResponseExample>
  ```json 200 theme={null}
  [
    {
      "url": "https://www.tiktok.com/view/product/1732000000000000000",
      "title": "Smart Watch Fitness Tracker",
      "price": 39.99,
      "currency": "USD",
      "rating": 4.6,
      "reviews_count": 3400,
      "seller_name": "TechGadgets Official",
      "seller_url": "https://www.tiktok.com/@techgadgets",
      "description": "Fitness tracker with heart rate monitor, sleep tracking, and 7-day battery life.",
      "images": [
        "https://p16-oec-ttp.tiktokcdn-us.com/example-product-1.jpeg"
      ],
      "category": "Electronics > Wearables > Smartwatches"
    }
  ]
  ```
</ResponseExample>


# Collect X (Twitter) posts by URL
Source: https://docs.brightdata.com/api-reference/scrapers/social-media-apis/twitter-posts-collect-by-url

POST https://api.brightdata.com/datasets/v3/scrape
Use the Bright Data Web Scraper API to collect X (Twitter) posts by URL. Calls the POST /datasets/v3/scrape endpoint and returns a snapshot ID.

## Query Parameters

<ParamField type="string">
  The dataset ID used for this request.

  <Warning>
    Must be set to `gd_lwxkxvnf1cynvib9co` to collect **Posts by URL** data.
  </Warning>
</ParamField>

<ParamField type="boolean">
  Whether to send notifications when the request is completed.
</ParamField>

<ParamField type="boolean">
  Whether to include errors in the response.
</ParamField>

## Request Body

<ParamField type="object[]">
  An array of input objects.

  <Expandable title="properties">
    <ParamField type="string">
      The URL of the X.com post to collect.
    </ParamField>
  </Expandable>

  #### Example

  ```json wrap theme={null}
  {
    "input": [
      {"url": "https://x.com/elonmusk/status/1234567890123456789"},
      {"url": "https://x.com/OpenAI/status/9876543210987654321"}
    ]
  }
  ```
</ParamField>

<ResponseExample>
  ```json 200 theme={null}
  [
    {
      "id": "2039126434510418303",
      "user_posted": "CozHealsSEN",
      "name": "SENQ Breakfast",
      "description": "LISTEN: North Queensland Cowboys front rower Matt Lodge joins Corey Parker and Andrew McCullough to discuss this weekend's match up against the Dragons",
      "date_posted": "2026-03-31T23:43:21.000Z",
      "photos": ["https://pbs.twimg.com/..."],
      "url": "https://x.com/CozHealsSEN/status/2039126434510418303",
      "quoted_post": null,
      "tagged_users": null,
      "replies": 0,
      "reposts": 4,
      "likes": 7,
      "views": 726,
      "external_url": "https://...",
      "hashtags": null,
      "followers": 814,
      "biography": "QLD brekkie show with Corey Parker & Ian Healy.",
      "posts_count": 4862,
      "profile_image_link": "https://pbs.twimg.com/...",
      "following": 430,
      "is_verified": null,
      "quotes": 0,
      "bookmarks": 0,
      "parent_post_details": {
        "date_posted": "2026-03-31T23:43:21.000Z",
        "post_id": "2039126434510418303",
        "profile_id": "889656535722360833",
        "profile_name": "SENQ Breakfast"
      },
      "videos": null,
      "verification_type": null,
      "user_id": "889656535722360833"
    }
  ]
  ```
</ResponseExample>


# Discover posts by profile URL
Source: https://docs.brightdata.com/api-reference/scrapers/social-media-apis/twitter-posts-discover-by-profile-url

POST https://api.brightdata.com/datasets/v3/scrape
Use the Bright Data Web Scraper API to discover Posts by Profile URL. Calls the POST /datasets/v3/scrape endpoint and returns a snapshot ID.

## Query Parameters

<ParamField type="string">
  The dataset ID used for this request.

  <Warning>
    Must be set to `gd_lwxkxvnf1cynvib9co` to collect **Discover by Profile URL** data.
  </Warning>
</ParamField>

<ParamField type="string">
  Must be set to `discover_new`.
</ParamField>

<ParamField type="string">
  Must be set to `profile_url`.
</ParamField>

<ParamField type="boolean">
  Whether to send notifications when the request is completed.
</ParamField>

<ParamField type="boolean">
  Whether to include errors in the response.
</ParamField>

## Request Body

<ParamField type="object[]">
  An array of input objects.

  <Expandable title="properties">
    <ParamField type="string">
      The URL of the X.com profile to discover posts from.
    </ParamField>
  </Expandable>

  #### Example

  ```json wrap theme={null}
  {
    "input": [
      {"url": "https://x.com/elonmusk"}
    ]
  }
  ```
</ParamField>

<ResponseExample>
  ```json 200 theme={null}
  [
    {
      "id": "2039126434510418303",
      "user_posted": "CozHealsSEN",
      "name": "SENQ Breakfast",
      "description": "LISTEN: North Queensland Cowboys front rower Matt Lodge joins Corey Parker and Andrew McCullough to discuss this weekend's match up against the Dragons",
      "date_posted": "2026-03-31T23:43:21.000Z",
      "photos": ["https://pbs.twimg.com/..."],
      "url": "https://x.com/CozHealsSEN/status/2039126434510418303",
      "quoted_post": null,
      "tagged_users": null,
      "replies": 0,
      "reposts": 4,
      "likes": 7,
      "views": 726,
      "external_url": "https://...",
      "hashtags": null,
      "followers": 814,
      "biography": "QLD brekkie show with Corey Parker & Ian Healy.",
      "posts_count": 4862,
      "profile_image_link": "https://pbs.twimg.com/...",
      "following": 430,
      "is_verified": null,
      "quotes": 0,
      "bookmarks": 0,
      "parent_post_details": {
        "date_posted": "2026-03-31T23:43:21.000Z",
        "post_id": "2039126434510418303",
        "profile_id": "889656535722360833",
        "profile_name": "SENQ Breakfast"
      },
      "videos": null,
      "verification_type": null,
      "user_id": "889656535722360833"
    }
  ]
  ```
</ResponseExample>


# Discover posts by profiles array
Source: https://docs.brightdata.com/api-reference/scrapers/social-media-apis/twitter-posts-discover-by-profiles-array

POST https://api.brightdata.com/datasets/v3/scrape
Use the Bright Data Web Scraper API to discover Posts by Profiles Array. Calls the POST /datasets/v3/scrape endpoint and returns a snapshot ID.

## Query Parameters

<ParamField type="string">
  The dataset ID used for this request.

  <Warning>
    Must be set to `gd_lwxkxvnf1cynvib9co` to collect **Discover by Profiles Array** data.
  </Warning>
</ParamField>

<ParamField type="string">
  Must be set to `discover_new`.
</ParamField>

<ParamField type="string">
  Must be set to `profiles_array`.
</ParamField>

<ParamField type="boolean">
  Whether to send notifications when the request is completed.
</ParamField>

<ParamField type="boolean">
  Whether to include errors in the response.
</ParamField>

## Request Body

<ParamField type="object[]">
  An array of input objects.

  <Expandable title="properties">
    <ParamField type="string">
      The URL of the X.com profile to discover posts from.
    </ParamField>
  </Expandable>

  #### Example

  ```json wrap theme={null}
  {
    "input": [
      {"url": "https://x.com/elonmusk"},
      {"url": "https://x.com/OpenAI"}
    ]
  }
  ```
</ParamField>

<ResponseExample>
  ```json 200 theme={null}
  [
    {
      "id": "2039126434510418303",
      "user_posted": "CozHealsSEN",
      "name": "SENQ Breakfast",
      "description": "LISTEN: North Queensland Cowboys front rower Matt Lodge joins Corey Parker and Andrew McCullough to discuss this weekend's match up against the Dragons",
      "date_posted": "2026-03-31T23:43:21.000Z",
      "photos": ["https://pbs.twimg.com/..."],
      "url": "https://x.com/CozHealsSEN/status/2039126434510418303",
      "quoted_post": null,
      "tagged_users": null,
      "replies": 0,
      "reposts": 4,
      "likes": 7,
      "views": 726,
      "external_url": "https://...",
      "hashtags": null,
      "followers": 814,
      "biography": "QLD brekkie show with Corey Parker & Ian Healy.",
      "posts_count": 4862,
      "profile_image_link": "https://pbs.twimg.com/...",
      "following": 430,
      "is_verified": null,
      "quotes": 0,
      "bookmarks": 0,
      "parent_post_details": {
        "date_posted": "2026-03-31T23:43:21.000Z",
        "post_id": "2039126434510418303",
        "profile_id": "889656535722360833",
        "profile_name": "SENQ Breakfast"
      },
      "videos": null,
      "verification_type": null,
      "user_id": "889656535722360833"
    }
  ]
  ```
</ResponseExample>


# Collect X (Twitter) profiles by URL
Source: https://docs.brightdata.com/api-reference/scrapers/social-media-apis/twitter-profiles-collect-by-url

POST https://api.brightdata.com/datasets/v3/scrape
Use the Bright Data Web Scraper API to collect X (Twitter) profiles by URL. Calls the POST /datasets/v3/scrape endpoint.

## Query Parameters

<ParamField type="string">
  The dataset ID used for this request.

  <Warning>
    Must be set to `gd_lwxmeb2u1cniijd7t4` to collect **Profiles by URL** data.
  </Warning>
</ParamField>

<ParamField type="boolean">
  Whether to send notifications when the request is completed.
</ParamField>

<ParamField type="boolean">
  Whether to include errors in the response.
</ParamField>

## Request Body

<ParamField type="object[]">
  An array of input objects.

  <Expandable title="properties">
    <ParamField type="string">
      The URL of the X.com profile to collect.
    </ParamField>
  </Expandable>

  #### Example

  ```json wrap theme={null}
  {
    "input": [
      {"url": "https://x.com/elonmusk"},
      {"url": "https://x.com/OpenAI"}
    ]
  }
  ```
</ParamField>

<ResponseExample>
  ```json 200 theme={null}
  [
    {
      "x_id": "1077446982",
      "url": "https://x.com/RepRWilliams",
      "id": "RepRWilliams",
      "profile_name": "Rep. Roger Williams",
      "biography": "Chairman of @HouseSmallBiz. Conservative fighting for lower taxes, less regulations, and more freedom for Texans.",
      "is_verified": true,
      "profile_image_link": "https://pbs.twimg.com/...",
      "external_link": "https://williams.house.gov/",
      "date_joined": "2013-01-10T19:21:22.000Z",
      "following": 910,
      "followers": 24746,
      "subscriptions": 0,
      "location": "North Texas",
      "birth_date": null,
      "posts_count": 10434,
      "posts": [
        {
          "date_posted": "2026-04-07T19:10:38.000Z",
          "description": "As Chairman of @HouseSmallBiz, I have seen the positive impact the Working Families Tax Cuts have had on small businesses.",
          "likes": 6,
          "post_id": "2041594516373700624",
          "post_url": "https://x.com/RepRWilliams/status/2041594516373700624",
          "replies": 3,
          "reposts": 3,
          "views": 449
        }
      ],
      "is_business_account": false,
      "is_government_account": false,
      "banner_image": "https://pbs.twimg.com/..."
    }
  ]
  ```
</ResponseExample>


# Discover profiles by username
Source: https://docs.brightdata.com/api-reference/scrapers/social-media-apis/twitter-profiles-discover-by-username

POST https://api.brightdata.com/datasets/v3/scrape
Use the Bright Data Web Scraper API to discover Profiles by Username. Calls the POST /datasets/v3/scrape endpoint and returns a snapshot ID.

## Query Parameters

<ParamField type="string">
  The dataset ID used for this request.

  <Warning>
    Must be set to `gd_lwxmeb2u1cniijd7t4` to collect **Discover by Username** data.
  </Warning>
</ParamField>

<ParamField type="string">
  Must be set to `discover_new`.
</ParamField>

<ParamField type="string">
  Must be set to `user_name`.
</ParamField>

<ParamField type="boolean">
  Whether to send notifications when the request is completed.
</ParamField>

<ParamField type="boolean">
  Whether to include errors in the response.
</ParamField>

## Request Body

<ParamField type="object[]">
  An array of input objects.

  <Expandable title="properties">
    <ParamField type="string">
      The username of the X.com profile.
    </ParamField>
  </Expandable>

  #### Example

  ```json wrap theme={null}
  {
    "input": [
      {"user_name": "elonmusk"}
    ]
  }
  ```
</ParamField>

<ResponseExample>
  ```json 200 theme={null}
  [
    {
      "x_id": "1077446982",
      "url": "https://x.com/RepRWilliams",
      "id": "RepRWilliams",
      "profile_name": "Rep. Roger Williams",
      "biography": "Chairman of @HouseSmallBiz. Conservative fighting for lower taxes, less regulations, and more freedom for Texans.",
      "is_verified": true,
      "profile_image_link": "https://pbs.twimg.com/...",
      "external_link": "https://williams.house.gov/",
      "date_joined": "2013-01-10T19:21:22.000Z",
      "following": 910,
      "followers": 24746,
      "subscriptions": 0,
      "location": "North Texas",
      "birth_date": null,
      "posts_count": 10434,
      "posts": [
        {
          "date_posted": "2026-04-07T19:10:38.000Z",
          "description": "As Chairman of @HouseSmallBiz, I have seen the positive impact the Working Families Tax Cuts have had on small businesses.",
          "likes": 6,
          "post_id": "2041594516373700624",
          "post_url": "https://x.com/RepRWilliams/status/2041594516373700624",
          "replies": 3,
          "reposts": 3,
          "views": 449
        }
      ],
      "is_business_account": false,
      "is_government_account": false,
      "banner_image": "https://pbs.twimg.com/..."
    }
  ]
  ```
</ResponseExample>


# Vimeo API scrapers
Source: https://docs.brightdata.com/api-reference/scrapers/social-media-apis/vimeo

Use the Bright Data Web Scraper API (1000+ scrapers) for Vimeo. Submit the request and retrieve the data as structured JSON records once the job completes.

## Overview

The Vimeo API Suite offers multiple types of APIs, each designed for specific data collection needs from Vimeo. Below is an overview of how these APIs connect and interact, based on the available features:

<CardGroup>
  <Card title="Posts API" icon="images" href="/api-reference/scrapers/social-media-apis/vimeo#posts-api">
    This API allows users to collect multiple posts based on a single input URL.

    <br />

    *   **Discovery functionality**:

    *   Discover by profile URL.

    *   Discover by Keywords and License.

    <br />

    *   **Interesting Columns**:

    *   `title`, `video_length`, `views`, `likes`.
  </Card>
</CardGroup>

## Posts API

### Collect by URL

This API allows users to collect detailed information about a specific Vimeo video using the provided video URL.

**Input Parameters**

<ParamField type="string">
  The URL of the Vimeo video.
</ParamField>

**Output Structure**:\
Includes comprehensive data points:

* **Video Details**\
  `video_id`, `title`, `url`, `video_url`, `video_length`, `description`, `data_posted`, `transcript`.

  > For all data points, [click here](https://brightdata.com/cp/scrapers/gd_lxk88z3v1ketji4pn?tab=overview).

* **Engagement & Metrics**\
  `views`, `likes`, `comments`, `collections`.

* **Uploader Details**\
  `uploader`, `uploader_url`, `uploader_id`, `avatar_img_uploader`.

* **Video Media & Content**\
  `preview_image`, `related_videos`, `music_track`.

* **License & Quality**\
  `license`, `license_info`, `video_quality`.

* **Dimensions**\
  `height`, `width`.

This API provides detailed insights into a Vimeo video, including video content, uploader information, media links, engagement metrics, and more, enabling efficient video analysis and content tracking.

### Discover by URL

This API allows users to discover Vimeo videos based on a specific URL and associated keywords, providing detailed video information and insights.

**Input Parameters**

<ParamField type="string">
  The URL of the Vimeo post.
</ParamField>

<ParamField type="string">
  The keyword to search for within the video's content.
</ParamField>

<ParamField type="number">
  The number of pages of results to collect.
</ParamField>

**Output Structure**:\
Includes comprehensive data points:

* **Video Details**\
  `video_id`, `title`, `url`, `video_url`, `video_length`, `description`, `data_posted`, `transcript`.

  > For all data points, [click here](https://brightdata.com/cp/scrapers/gd_lxk88z3v1ketji4pn/url?tab=overview).

* **Engagement & Metrics**\
  `views`, `likes`, `comments`, `collections`.

* **Uploader Details**\
  `uploader`, `uploader_url`, `uploader_id`, `avatar_img_uploader`.

* **Video Media & Content**\
  `preview_image`, `related_videos`, `music_track`.

* **License & Quality**\
  `license`, `license_info`, `video_quality`.

* **Dimensions**\
  `height`, `width`.

This API allows users to discover Vimeo videos by URL and keyword, offering detailed insights into video content, uploader information, and engagement metrics.

### Discover by Keywords and License

This API allows users to discover Vimeo videos based on specific keywords and license types, providing detailed video information and insights.

**Input Parameters**

<ParamField type="string">
  The keyword to search for in the video content.
</ParamField>

<ParamField type="string">
  The license type to filter the videos by (e.g., Creative Commons, Standard License).
</ParamField>

<ParamField type="number">
  The number of pages of results to collect.
</ParamField>

**Output Structure**:\
Includes comprehensive data points:

* **Video Details**\
  `video_id`, `title`,`url`, `video_url`, `video_length`, `description`, `data_posted`, `transcript`.

  > For all data points, [click here](https://brightdata.com/cp/scrapers/gd_lxk88z3v1ketji4pn/keyword_and_license?tab=overview).

* **Engagement & Metrics**\
  `views`, `likes`, `comments`, `collections`.

* **Uploader Details**\
  `uploader`, `uploader_url`, `uploader_id`, `avatar_img_uploader`.

* **Video Media & Content**\
  `preview_image`, `related_videos`, `music_track`.

* **License & Quality**\
  `license`, `license_info`, `video_quality`.

* **Dimensions**\
  `height`, `width`.

This API allows users to discover Vimeo videos based on specific keywords and license types, offering detailed insights into video content, uploader information, and engagement metrics.


# Collect channels by URL
Source: https://docs.brightdata.com/api-reference/scrapers/social-media-apis/youtube-channels-collect-by-url

POST https://api.brightdata.com/datasets/v3/scrape
Use the Bright Data Web Scraper API to collect Channels by URL. POST /datasets/v3/scrape starts a scraping job that returns the data as structured JSON records.

## Query Parameters

<ParamField type="string">
  The dataset ID used for this request.

  <Warning>
    Must be set to `gd_lk538t2k2p1k3oos71` to collect **YouTube channels** data.
  </Warning>
</ParamField>

<ParamField type="boolean">
  Whether to send notifications when the request is completed.
</ParamField>

<ParamField type="boolean">
  Whether to include errors in the response.
</ParamField>

## Request Body

<ParamField type="object[]">
  An array of input objects.

  <Expandable title="properties">
    <ParamField type="string">
      The YouTube channel URL to collect data from.
    </ParamField>
  </Expandable>

  #### Example

  ```json wrap theme={null}
  {
    "input": [
      {"url": "https://www.youtube.com/@MrBeast"},
      {"url": "https://www.youtube.com/@PewDiePie"}
    ]
  }
  ```
</ParamField>

<ResponseExample>
  ```json 200 theme={null}
  [
    {
      "url": "https://www.youtube.com/@channelname",
      "handle": "@channelname",
      "banner_img": "https://...",
      "profile_image": "https://...",
      "name": "Channel Name",
      "subscribers": 299,
      "Description": "Channel description...",
      "videos_count": 21,
      "created_date": "2024-11-25T00:00:00.000Z",
      "views": 98723,
      "Details": {"location": "United States"},
      "Links": ["youtube.com/@channelname"],
      "identifier": "UC...",
      "id": "UC...",
      "has_podcast": false,
      "top_videos": [
        {
          "Image_url": "https://...",
          "posted_time": "3 weeks ago",
          "title": "Video Title",
          "video_url": "https://www.youtube.com/watch?v=abc",
          "views": 11
        }
      ]
    }
  ]
  ```
</ResponseExample>


# Discover channels by keyword
Source: https://docs.brightdata.com/api-reference/scrapers/social-media-apis/youtube-channels-discover-by-keyword

POST https://api.brightdata.com/datasets/v3/scrape
Use the Bright Data Web Scraper API to discover Channels by Keyword. Calls the POST /datasets/v3/scrape endpoint and returns a snapshot ID.

## Query Parameters

<ParamField type="string">
  The dataset ID used for this request.

  <Warning>
    Must be set to `gd_lk538t2k2p1k3oos71` to collect **Discover Channels by Keyword** data.
  </Warning>
</ParamField>

<ParamField type="string">
  Must be set to `discover_new`.
</ParamField>

<ParamField type="string">
  Must be set to `keyword`.
</ParamField>

<ParamField type="boolean">
  Whether to send notifications when the request is completed.
</ParamField>

<ParamField type="boolean">
  Whether to include errors in the response.
</ParamField>

## Request Body

<ParamField type="object[]">
  An array of input objects.

  <Expandable title="properties">
    <ParamField type="string">
      The keyword to search for YouTube channels.
    </ParamField>
  </Expandable>

  #### Example

  ```json wrap theme={null}
  {
    "input": [
      {
        "keyword": "cooking tutorials"
      }
    ]
  }
  ```
</ParamField>

<ResponseExample>
  ```json 200 theme={null}
  [
    {
      "url": "https://www.youtube.com/@channelname",
      "handle": "@channelname",
      "banner_img": "https://...",
      "profile_image": "https://...",
      "name": "Channel Name",
      "subscribers": 299,
      "Description": "Channel description...",
      "videos_count": 21,
      "created_date": "2024-11-25T00:00:00.000Z",
      "views": 98723,
      "Details": {"location": "United States"},
      "Links": ["youtube.com/@channelname"],
      "identifier": "UC...",
      "id": "UC...",
      "has_podcast": false,
      "top_videos": [
        {
          "Image_url": "https://...",
          "posted_time": "3 weeks ago",
          "title": "Video Title",
          "video_url": "https://www.youtube.com/watch?v=abc",
          "views": 11
        }
      ]
    }
  ]
  ```
</ResponseExample>


# Collect YouTube comments by URL
Source: https://docs.brightdata.com/api-reference/scrapers/social-media-apis/youtube-comments-collect-by-url

POST https://api.brightdata.com/datasets/v3/scrape
Use the Bright Data Web Scraper API to collect YouTube comments by URL. Calls the POST /datasets/v3/scrape endpoint and returns a snapshot ID.

## Query Parameters

<ParamField type="string">
  The dataset ID used for this request.

  <Warning>
    Must be set to `gd_lk9q0ew71spt1mxywf` to collect **YouTube comments** data.
  </Warning>
</ParamField>

<ParamField type="boolean">
  Whether to send notifications when the request is completed.
</ParamField>

<ParamField type="boolean">
  Whether to include errors in the response.
</ParamField>

## Request Body

<ParamField type="object[]">
  An array of input objects.

  <Expandable title="properties">
    <ParamField type="string">
      The YouTube video URL to collect comments from.
    </ParamField>
  </Expandable>

  #### Example

  ```json wrap theme={null}
  {
    "input": [
      {"url": "https://www.youtube.com/watch?v=dQw4w9WgXcQ"},
      {"url": "https://www.youtube.com/watch?v=4L_m0m3bEtE"}
    ]
  }
  ```
</ParamField>

<ResponseExample>
  ```json 200 theme={null}
  [
    {
      "comment_id": "UgxtjoPOlwN1r91t6OF4AaABAg",
      "comment_text": "Great video!",
      "likes": 2,
      "replies": 0,
      "username": "@username",
      "user_channel": "https://www.youtube.com/@username",
      "date": "1 year ago",
      "url": "https://www.youtube.com/watch?v=abc123",
      "video_id": "abc123",
      "user_id": "UCRmKhm9d3FuhiU6SqW4mbDA"
    }
  ]
  ```
</ResponseExample>


# Collect videos by URL
Source: https://docs.brightdata.com/api-reference/scrapers/social-media-apis/youtube-videos-collect-by-url

api-reference/sdk-specs/youtube-videos-collect-by-url POST /datasets/v3/scrape
Use the Bright Data Web Scraper API to collect Videos by URL. POST /datasets/v3/scrape starts a scraping job that returns the data as structured JSON records.

## Query Parameters

<ParamField type="string">
  The dataset ID used for this request.

  <Warning>
    Must be set to `gd_lk56epmy2i5g7lzu0k` to collect **YouTube videos** data.
  </Warning>
</ParamField>

<ParamField type="boolean">
  Whether to send notifications when the request is completed.
</ParamField>

<ParamField type="boolean">
  Whether to include errors in the response.
</ParamField>

## Request Body

<ParamField type="object[]">
  An array of input objects.

  <Expandable title="properties">
    <ParamField type="string">
      The YouTube video URL to collect data from.
    </ParamField>

    <ParamField type="string">
      The country to use for the request.
    </ParamField>

    <ParamField type="string">
      The language for video transcription.
    </ParamField>
  </Expandable>

  #### Example

  ```json wrap theme={null}
  {
    "input": [
      {"url": "https://www.youtube.com/watch?v=dQw4w9WgXcQ"},
      {"url": "https://www.youtube.com/watch?v=4L_m0m3bEtE"}
    ]
  }
  ```
</ParamField>

<ResponseExample>
  ```json 200 theme={null}
  [
    {
      "url": "https://www.youtube.com/watch?v=4L_m0m3bEtE",
      "title": "Video Title Here",
      "youtuber": "@channelname",
      "video_url": "https://...",
      "video_length": 96,
      "likes": 18,
      "views": 1648,
      "date_posted": "2025-04-18T05:26:16.000Z",
      "description": "Video description...",
      "num_comments": 0,
      "subscribers": 4810000,
      "video_id": "4L_m0m3bEtE",
      "channel_url": "https://www.youtube.com/@channelname",
      "preview_image": "https://i.ytimg.com/vi/4L_m0m3bEtE/maxresdefault.jpg",
      "shortcode": "4L_m0m3bEtE",
      "verified": true,
      "handle_name": "Channel Name",
      "is_sponsored": false,
      "quality": "hd1080",
      "transcript": "...",
      "tags": ["tag1", "tag2"],
      "is_age_restricted": false
    }
  ]
  ```
</ResponseExample>


# Discover videos by explore
Source: https://docs.brightdata.com/api-reference/scrapers/social-media-apis/youtube-videos-discover-by-explore

POST https://api.brightdata.com/datasets/v3/scrape
Use the Bright Data Web Scraper API to discover Videos by Explore. Calls the POST /datasets/v3/scrape endpoint and returns a snapshot ID.

## Query Parameters

<ParamField type="string">
  The dataset ID used for this request.

  <Warning>
    Must be set to `gd_lk56epmy2i5g7lzu0k` to collect **Discover Videos by Explore** data.
  </Warning>
</ParamField>

<ParamField type="string">
  Must be set to `discover_new`.
</ParamField>

<ParamField type="string">
  Must be set to `explore`.
</ParamField>

<ParamField type="boolean">
  Whether to send notifications when the request is completed.
</ParamField>

<ParamField type="boolean">
  Whether to include errors in the response.
</ParamField>

## Request Body

<ParamField type="object[]">
  An array of input objects.

  <Expandable title="properties">
    <ParamField type="string">
      The YouTube explore page URL to discover videos from.
    </ParamField>
  </Expandable>

  #### Example

  ```json wrap theme={null}
  {
    "input": [
      {"url": "https://www.youtube.com/feed/explore"}
    ]
  }
  ```
</ParamField>

<ResponseExample>
  ```json 200 theme={null}
  [
    {
      "url": "https://www.youtube.com/watch?v=4L_m0m3bEtE",
      "title": "Video Title Here",
      "youtuber": "@channelname",
      "video_url": "https://...",
      "video_length": 96,
      "likes": 18,
      "views": 1648,
      "date_posted": "2025-04-18T05:26:16.000Z",
      "description": "Video description...",
      "num_comments": 0,
      "subscribers": 4810000,
      "video_id": "4L_m0m3bEtE",
      "channel_url": "https://www.youtube.com/@channelname",
      "preview_image": "https://i.ytimg.com/vi/4L_m0m3bEtE/maxresdefault.jpg",
      "shortcode": "4L_m0m3bEtE",
      "verified": true,
      "handle_name": "Channel Name",
      "is_sponsored": false,
      "quality": "hd1080",
      "transcript": "...",
      "tags": ["tag1", "tag2"],
      "is_age_restricted": false
    }
  ]
  ```
</ResponseExample>


# Discover videos by hashtag
Source: https://docs.brightdata.com/api-reference/scrapers/social-media-apis/youtube-videos-discover-by-hashtag

POST https://api.brightdata.com/datasets/v3/scrape
Use the Bright Data Web Scraper API to discover Videos by Hashtag. Calls the POST /datasets/v3/scrape endpoint and returns a snapshot ID.

## Query Parameters

<ParamField type="string">
  The dataset ID used for this request.

  <Warning>
    Must be set to `gd_lk56epmy2i5g7lzu0k` to collect **Discover Videos by Hashtag** data.
  </Warning>
</ParamField>

<ParamField type="string">
  Must be set to `discover_new`.
</ParamField>

<ParamField type="string">
  Must be set to `hashtag`.
</ParamField>

<ParamField type="boolean">
  Whether to send notifications when the request is completed.
</ParamField>

<ParamField type="boolean">
  Whether to include errors in the response.
</ParamField>

## Request Body

<ParamField type="object[]">
  An array of input objects.

  <Expandable title="properties">
    <ParamField type="string">
      The hashtag to discover YouTube videos for.
    </ParamField>

    <ParamField type="number">
      The number of posts to collect. Missing value indicates no limit.
    </ParamField>

    <ParamField type="array">
      An array of post URLs to exclude from the results.
    </ParamField>

    <ParamField type="string">
      The start date for filtering results (MM-DD-YYYY).
    </ParamField>

    <ParamField type="string">
      The end date for filtering results (MM-DD-YYYY).
    </ParamField>
  </Expandable>

  #### Example

  ```json wrap theme={null}
  {
    "input": [
      {
        "hashtag": "trend",
        "num_of_posts": 20
      }
    ]
  }
  ```
</ParamField>

<ResponseExample>
  ```json 200 theme={null}
  [
    {
      "url": "https://www.youtube.com/watch?v=4L_m0m3bEtE",
      "title": "Video Title Here",
      "youtuber": "@channelname",
      "video_url": "https://...",
      "video_length": 96,
      "likes": 18,
      "views": 1648,
      "date_posted": "2025-04-18T05:26:16.000Z",
      "description": "Video description...",
      "num_comments": 0,
      "subscribers": 4810000,
      "video_id": "4L_m0m3bEtE",
      "channel_url": "https://www.youtube.com/@channelname",
      "preview_image": "https://i.ytimg.com/vi/4L_m0m3bEtE/maxresdefault.jpg",
      "shortcode": "4L_m0m3bEtE",
      "verified": true,
      "handle_name": "Channel Name",
      "is_sponsored": false,
      "quality": "hd1080",
      "transcript": "...",
      "tags": ["tag1", "tag2"],
      "is_age_restricted": false
    }
  ]
  ```
</ResponseExample>


# Discover videos by keyword
Source: https://docs.brightdata.com/api-reference/scrapers/social-media-apis/youtube-videos-discover-by-keyword

POST https://api.brightdata.com/datasets/v3/scrape
Use the Bright Data Web Scraper API to discover Videos by Keyword. Calls the POST /datasets/v3/scrape endpoint and returns a snapshot ID.

## Query Parameters

<ParamField type="string">
  The dataset ID used for this request.

  <Warning>
    Must be set to `gd_lk56epmy2i5g7lzu0k` to collect **Discover Videos by Keyword** data.
  </Warning>
</ParamField>

<ParamField type="string">
  Must be set to `discover_new`.
</ParamField>

<ParamField type="string">
  Must be set to `keyword`.
</ParamField>

<ParamField type="boolean">
  Whether to send notifications when the request is completed.
</ParamField>

<ParamField type="boolean">
  Whether to include errors in the response.
</ParamField>

## Request Body

<ParamField type="object[]">
  An array of input objects.

  <Expandable title="properties">
    <ParamField type="string">
      The keyword to search for YouTube videos.
    </ParamField>

    <ParamField type="number">
      The number of posts to collect. Missing value indicates no limit.
    </ParamField>

    <ParamField type="string">
      The start date for filtering results.
    </ParamField>

    <ParamField type="string">
      The end date for filtering results.
    </ParamField>

    <ParamField type="string">
      The country to use for the request.
    </ParamField>
  </Expandable>

  #### Example

  ```json wrap theme={null}
  {
    "input": [
      {
        "keyword": "popular music",
        "num_of_posts": 20
      }
    ]
  }
  ```
</ParamField>

<ResponseExample>
  ```json 200 theme={null}
  [
    {
      "url": "https://www.youtube.com/watch?v=4L_m0m3bEtE",
      "title": "Video Title Here",
      "youtuber": "@channelname",
      "video_url": "https://...",
      "video_length": 96,
      "likes": 18,
      "views": 1648,
      "date_posted": "2025-04-18T05:26:16.000Z",
      "description": "Video description...",
      "num_comments": 0,
      "subscribers": 4810000,
      "video_id": "4L_m0m3bEtE",
      "channel_url": "https://www.youtube.com/@channelname",
      "preview_image": "https://i.ytimg.com/vi/4L_m0m3bEtE/maxresdefault.jpg",
      "shortcode": "4L_m0m3bEtE",
      "verified": true,
      "handle_name": "Channel Name",
      "is_sponsored": false,
      "quality": "hd1080",
      "transcript": "...",
      "tags": ["tag1", "tag2"],
      "is_age_restricted": false
    }
  ]
  ```
</ResponseExample>


# Discover videos by podcast URL
Source: https://docs.brightdata.com/api-reference/scrapers/social-media-apis/youtube-videos-discover-by-podcast-url

POST https://api.brightdata.com/datasets/v3/scrape
Use the Bright Data Web Scraper API to discover Videos by Podcast URL. Calls the POST /datasets/v3/scrape endpoint and returns a snapshot ID.

## Query Parameters

<ParamField type="string">
  The dataset ID used for this request.

  <Warning>
    Must be set to `gd_lk56epmy2i5g7lzu0k` to collect **Discover Videos by Podcast URL** data.
  </Warning>
</ParamField>

<ParamField type="string">
  Must be set to `discover_new`.
</ParamField>

<ParamField type="string">
  Must be set to `podcast_url`.
</ParamField>

<ParamField type="boolean">
  Whether to send notifications when the request is completed.
</ParamField>

<ParamField type="boolean">
  Whether to include errors in the response.
</ParamField>

## Request Body

<ParamField type="object[]">
  An array of input objects.

  <Expandable title="properties">
    <ParamField type="string">
      The YouTube podcast URL to discover videos from.
    </ParamField>
  </Expandable>

  #### Example

  ```json wrap theme={null}
  {
    "input": [
      {"url": "https://www.youtube.com/playlist?list=PLrAXtmErZgOeiKm4sgNOknGvNjby9efdf"}
    ]
  }
  ```
</ParamField>

<ResponseExample>
  ```json 200 theme={null}
  [
    {
      "url": "https://www.youtube.com/watch?v=4L_m0m3bEtE",
      "title": "Video Title Here",
      "youtuber": "@channelname",
      "video_url": "https://...",
      "video_length": 96,
      "likes": 18,
      "views": 1648,
      "date_posted": "2025-04-18T05:26:16.000Z",
      "description": "Video description...",
      "num_comments": 0,
      "subscribers": 4810000,
      "video_id": "4L_m0m3bEtE",
      "channel_url": "https://www.youtube.com/@channelname",
      "preview_image": "https://i.ytimg.com/vi/4L_m0m3bEtE/maxresdefault.jpg",
      "shortcode": "4L_m0m3bEtE",
      "verified": true,
      "handle_name": "Channel Name",
      "is_sponsored": false,
      "quality": "hd1080",
      "transcript": "...",
      "tags": ["tag1", "tag2"],
      "is_age_restricted": false
    }
  ]
  ```
</ResponseExample>


# Discover videos by search filters
Source: https://docs.brightdata.com/api-reference/scrapers/social-media-apis/youtube-videos-discover-by-search-filters

POST https://api.brightdata.com/datasets/v3/scrape
Use the Bright Data Web Scraper API to discover Videos by Search Filters. Calls the POST /datasets/v3/scrape endpoint and returns a snapshot ID.

## Query Parameters

<ParamField type="string">
  The dataset ID used for this request.

  <Warning>
    Must be set to `gd_lk56epmy2i5g7lzu0k` to collect **Discover Videos by Search Filters** data.
  </Warning>
</ParamField>

<ParamField type="string">
  Must be set to `discover_new`.
</ParamField>

<ParamField type="string">
  Must be set to `search_filters`.
</ParamField>

<ParamField type="boolean">
  Whether to send notifications when the request is completed.
</ParamField>

<ParamField type="boolean">
  Whether to include errors in the response.
</ParamField>

## Request Body

<ParamField type="object[]">
  An array of input objects.

  <Expandable title="properties">
    <ParamField type="string">
      The YouTube search URL with filters to discover videos from.
    </ParamField>
  </Expandable>

  #### Example

  ```json wrap theme={null}
  {
    "input": [
      {"url": "https://www.youtube.com/results?search_query=cooking&sp=EgIIAg%253D%253D"}
    ]
  }
  ```
</ParamField>

<ResponseExample>
  ```json 200 theme={null}
  [
    {
      "url": "https://www.youtube.com/watch?v=4L_m0m3bEtE",
      "title": "Video Title Here",
      "youtuber": "@channelname",
      "video_url": "https://...",
      "video_length": 96,
      "likes": 18,
      "views": 1648,
      "date_posted": "2025-04-18T05:26:16.000Z",
      "description": "Video description...",
      "num_comments": 0,
      "subscribers": 4810000,
      "video_id": "4L_m0m3bEtE",
      "channel_url": "https://www.youtube.com/@channelname",
      "preview_image": "https://i.ytimg.com/vi/4L_m0m3bEtE/maxresdefault.jpg",
      "shortcode": "4L_m0m3bEtE",
      "verified": true,
      "handle_name": "Channel Name",
      "is_sponsored": false,
      "quality": "hd1080",
      "transcript": "...",
      "tags": ["tag1", "tag2"],
      "is_age_restricted": false
    }
  ]
  ```
</ResponseExample>


# Discover videos by URL
Source: https://docs.brightdata.com/api-reference/scrapers/social-media-apis/youtube-videos-discover-by-url

POST https://api.brightdata.com/datasets/v3/scrape
Use the Bright Data Web Scraper API to discover Videos by URL. POST /datasets/v3/scrape starts a scraping job that returns the data as structured JSON records.

## Query Parameters

<ParamField type="string">
  The dataset ID used for this request.

  <Warning>
    Must be set to `gd_lk56epmy2i5g7lzu0k` to collect **Discover Videos by URL** data.
  </Warning>
</ParamField>

<ParamField type="string">
  Must be set to `discover_new`.
</ParamField>

<ParamField type="string">
  Must be set to `url`.
</ParamField>

<ParamField type="boolean">
  Whether to send notifications when the request is completed.
</ParamField>

<ParamField type="boolean">
  Whether to include errors in the response.
</ParamField>

## Request Body

<ParamField type="object[]">
  An array of input objects.

  <Expandable title="properties">
    <ParamField type="string">
      The YouTube channel or playlist URL to discover videos from.
    </ParamField>
  </Expandable>

  #### Example

  ```json wrap theme={null}
  {
    "input": [
      {"url": "https://www.youtube.com/@MrBeast"}
    ]
  }
  ```
</ParamField>

<ResponseExample>
  ```json 200 theme={null}
  [
    {
      "url": "https://www.youtube.com/watch?v=4L_m0m3bEtE",
      "title": "Video Title Here",
      "youtuber": "@channelname",
      "video_url": "https://...",
      "video_length": 96,
      "likes": 18,
      "views": 1648,
      "date_posted": "2025-04-18T05:26:16.000Z",
      "description": "Video description...",
      "num_comments": 0,
      "subscribers": 4810000,
      "video_id": "4L_m0m3bEtE",
      "channel_url": "https://www.youtube.com/@channelname",
      "preview_image": "https://i.ytimg.com/vi/4L_m0m3bEtE/maxresdefault.jpg",
      "shortcode": "4L_m0m3bEtE",
      "verified": true,
      "handle_name": "Channel Name",
      "is_sponsored": false,
      "quality": "hd1080",
      "transcript": "...",
      "tags": ["tag1", "tag2"],
      "is_age_restricted": false
    }
  ]
  ```
</ResponseExample>


# Add static IP(s)
Source: https://docs.brightdata.com/api-reference/account-management-api/Add_Static_Datacenter_ISP_IPs

api-reference/openapi POST /zone/ips
Use the Bright Data Account Management API to add Static IP(s). POST /zone/ips returns 200 OK with zone or account configuration data as JSON.

<Warning>Only users with **Admin** or **Ops** roles can perform this action.</Warning>

<Warning> **Warning:** This API can modify your account settings, damage your operations or incur charges.</Warning>

<Tip>
  Paste your API key to the authorization field. To get an API key, [Create an account](https://brightdata.com/?hs_signup=1\&utm_source=docs\&utm_campaign=playground) and learn [how to generate an API key](/api-reference/authentication#how-do-i-generate-a-new-api-key%3F)
</Tip>


# Add a zone
Source: https://docs.brightdata.com/api-reference/account-management-api/Add_a_Zone

api-reference/openapi POST /zone
Use the Bright Data Account Management API to add a Zone. POST /zone returns 200 OK with zone or account configuration data as JSON.

<Warning>Only users with **Admin** or **Ops** roles can perform this action.</Warning>

<Warning>This API can modify your account settings, damage your operations or incur charges.</Warning>

<Tip>
  Paste your API key to the authorization field. To get an API key, [Create an account](https://brightdata.com/?hs_signup=1\&utm_source=docs\&utm_campaign=playground) and learn [how to generate an API key](/api-reference/authentication#how-do-i-generate-a-new-api-key%3F)
</Tip>

## ISP proxy zone examples

Creating an ISP zone requires specific parameter combinations. The fields below are not optional. Omitting them will silently create the wrong zone type or billing plan.

<Warning>
  Setting `zone.type` to `ISP` alone will create a **Datacenter zone**, not an ISP zone. You must also set `plan.pool_ip_type` to `static_res`. Country codes must be **lowercase** (e.g. `us`, `gb`). Uppercase codes return a misleading "no IPs available" error.
</Warning>

### Shared ISP (pay-per-GB)

```json theme={null}
{
  "zone": { "name": "my_isp_zone", "type": "ISP" },
  "plan": {
    "type": "static",
    "pool_ip_type": "static_res",
    "ips_type": "shared",
    "bandwidth": "bandwidth",
    "country": "us"
  }
}
```

### Shared ISP (unlimited bandwidth)

Setting `bandwidth: unlimited` alone **does not** activate unlimited billing. You must also include `unl_bw_tiers: std`.

```json theme={null}
{
  "zone": { "name": "my_isp_zone", "type": "ISP" },
  "plan": {
    "type": "static",
    "pool_ip_type": "static_res",
    "ips_type": "shared",
    "bandwidth": "unlimited",
    "unl_bw_tiers": "std",
    "country": "us"
  }
}
```

### Dedicated ISP (unlimited bandwidth)

```json theme={null}
{
  "zone": { "name": "my_isp_zone", "type": "ISP" },
  "plan": {
    "type": "static",
    "pool_ip_type": "static_res",
    "ips_type": "dedicated",
    "bandwidth": "unlimited",
    "unl_bw_tiers": "std",
    "country": "us",
    "ips": 10
  }
}
```

## Residential proxy zone

<Warning>
  **New Residential zones require KYC approval.** For Residential zones created after July 7, 2026, adding a zone is available only to KYC-verified companies. A request from an account that has not completed KYC is blocked and returns HTTP 403 with a compliance error. Residential zones created on or before July 7, 2026 are unaffected and continue to work as expected. Start at [KYC verification](https://brightdata.com/cp/kyc) and see the [Residential network access policy](/proxy-networks/residential/network-access).
</Warning>

Creating any Residential proxy type (shared rotating, IPv6 or dedicated) after July 7, 2026 requires KYC approval by the Bright Data compliance team. There is no automatic or no-KYC path for these new zones. Without KYC, create an [ISP](/proxy-networks/isp/introduction) or [Datacenter](/proxy-networks/data-center/introduction) zone instead.

### Dedicated Residential (gIP) zone

A dedicated Residential zone allocates a gIP (group of IPs) that is exclusive to a fixed list of target domains. Create one by setting `vips_type: "domain"` and including `domain_whitelist`.

<Warning>
  Dedicated Residential gIPs are **domain-restricted**. You must set `vips_type: "domain"` and include `domain_whitelist` (a space-separated list of target domains). `vip_country` applies only to dedicated zones. For a shared zone, set the country with the `-country` username flag instead. Country codes must be **lowercase** (e.g. `us`, `gb`).
</Warning>

The following payload creates a dedicated Residential zone with one US gIP scoped to `example.com`. This payload was verified working on July 9, 2026.

```json theme={null}
{
  "zone": { "name": "my_dedicated_resi_zone", "type": "resident" },
  "plan": {
    "type": "resident",
    "vips_type": "domain",
    "vips": 1,
    "vip_country": "us",
    "domain_whitelist": "example.com"
  }
}
```

The allocated gIP is exclusive to the domains listed in `domain_whitelist`. Requests to any other domain are routed through Bright Data's shared Datacenter proxies.

### Shared Residential country targeting

For shared Residential zones, country is not set with `vip_country`. Target countries at request level with the `-country-<code>` flag in the proxy username (for example `-country-us`), or set default countries in the control panel. See [How to configure your Residential proxy](/proxy-networks/residential/configure-your-proxy).

### Dedicated Residential gIP errors

An invalid dedicated Residential (gIP) payload returns one of the following errors.

| Error                                                                                                                                     | Cause                      | How to fix                                        |
| :---------------------------------------------------------------------------------------------------------------------------------------- | :------------------------- | :------------------------------------------------ |
| `Can't allocate required amount of gIPs. Dedicated gIPs are only supported with "vips_type": "domain" together with a "domain_whitelist"` | Wrong `vips_type` value    | Set `vips_type: "domain"`                         |
| `Can't allocate required amount of gIPs. Target domains ("domain_whitelist") are required to allocate dedicated gIPs`                     | Missing `domain_whitelist` | Add `domain_whitelist` with your target domain(s) |

### Residential 403 compliance errors

For Residential zones created after July 7, 2026, an Add-a-Zone request from an account that is not eligible returns HTTP 403 with one of the following compliance errors. Zones created on or before July 7, 2026 are not affected. See the [proxy errors catalog](/proxy-networks/errorCatalog#http-error-403) for the full catalog.

| Error code                  | When it fires                                       | How to fix                                                                                                                                          |
| :-------------------------- | :-------------------------------------------------- | :-------------------------------------------------------------------------------------------------------------------------------------------------- |
| `kyc_required`              | A company-email account that has not completed KYC. | Start [KYC verification](https://brightdata.com/cp/kyc). A human compliance reviewer approves Residential access.                                   |
| `business_account_required` | A personal-email account (not a verified company).  | Use a corporate email and contact the Bright Data team to establish business eligibility. Personal-email accounts are not eligible for Residential. |

Each error returns a structured JSON body so integrations can branch on the stable `code` value. A company-email account without KYC receives `kyc_required`:

```json theme={null}
{
  "error": {
    "code": "kyc_required",
    "message": "Residential proxies are available to verified companies only, after KYC review, in accordance with Bright Data's compliance policy.",
    "action": "Start verification at brightdata.com/cp/kyc. Applications are reviewed by our compliance team.",
    "alternatives": [
      { "product": "ISP proxy", "plan": { "type": "static", "pool_ip_type": "static_res", "ips_type": "shared" } },
      { "product": "Web Unlocker API", "plan": { "type": "unblocker" } }
    ],
    "docs": "https://docs.brightdata.com/compliance/kyc"
  }
}
```

A personal-email account receives `business_account_required`, which does not offer KYC because personal accounts are not eligible:

```json theme={null}
{
  "error": {
    "code": "business_account_required",
    "message": "Residential proxies are available to verified companies only. Eligibility requires a corporate email and full verification with the Bright Data team.",
    "action": "Contact the Bright Data team with a corporate email to determine business eligibility for Residential access.",
    "alternatives": [
      { "product": "ISP proxy", "plan": { "type": "static", "pool_ip_type": "static_res", "ips_type": "shared" } },
      { "product": "Web Unlocker API", "plan": { "type": "unblocker" } }
    ],
    "docs": "https://docs.brightdata.com/compliance/kyc"
  }
}
```

Both bodies include an `alternatives` array with the exact `plan` objects to create a no-KYC [ISP](/proxy-networks/isp/introduction) or [Web Unlocker API](/scraping-automation/web-unlocker/introduction) zone instead. To create the ISP zone, send `POST /zone` with that `plan` object in place of the Residential one.


# Change account status
Source: https://docs.brightdata.com/api-reference/account-management-api/Change_account_status

api-reference/openapi PUT /status
Use the Bright Data Account Management API to change Account Status. PUT /status returns 200 OK with zone or account configuration data as JSON.

<Warning>Only users with **Admin** or **Ops** roles can perform this action.</Warning>

<Warning> **Warning:** This API can modify your account settings, damage your operations or incur charges.</Warning>

<Tip>
  Paste your API key to the authorization field. To get an API key, [Create an account](https://brightdata.com/?hs_signup=1\&utm_source=docs\&utm_campaign=playground) and learn [how to generate an API key](/api-reference/authentication#how-do-i-generate-a-new-api-key%3F)
</Tip>


# Cost breakdown export
Source: https://docs.brightdata.com/api-reference/account-management-api/Export_cost_breakdown

api-reference/openapi POST /costs/export/json
Export account cost data by dimension (products, APIs, datasets, Web Scraper APIs). Same source as Cost Explorer. JSON or CSV per-day, 200 OK on success.

This endpoint exports the same per-day, per-resource cost breakdown that the Control Panel's Cost Explorer displays, in JSON or CSV, grouped by the dimension you pick (products, zones, datasets, Web Scraper APIs, collectors, domains, dataset snapshots, or WSA snapshots).

<Warning>
  **The `to` parameter is exclusive.** The day specified in `to` is **not** included in the result. To match a calendar month shown in the Control Panel or on your invoice, set `to` to the first day of the **following** month. For example, `from=2026-04-01&to=2026-05-01` returns all of April 2026.
</Warning>

<Tip>
  Paste your API key into the authorization field. To get an API key, [create an account](https://brightdata.com/?hs_signup=1\&utm_source=docs\&utm_campaign=playground) and learn [how to generate an API key](/api-reference/authentication#how-do-i-generate-a-new-api-key%3F).
</Tip>

## When to use this endpoint

Use this endpoint when you need cost data that `GET /zone/cost` cannot return. The `/zone/cost` endpoint is scoped to a single zone, which means it cannot break down Web Scraper API costs (those are keyed by `dataset_id`, not by zone name) and it cannot answer questions like "What did I spend on datacenter and unlocker proxies combined last month?".

This endpoint accepts a `dimension` parameter that groups costs by the same buckets the Control Panel Cost Explorer uses.

| Dimension      | Groups costs by                                                                                   |
| -------------- | ------------------------------------------------------------------------------------------------- |
| `products`     | Product family (datacenter, residential, ISP, mobile, unlocker, SERP API, Browser API, and so on) |
| `types`        | Network or charge type                                                                            |
| `zones`        | Individual zones in your account                                                                  |
| `datasets`     | Dataset Marketplace dataset purchases                                                             |
| `web_apis`     | Web Scraper API `dataset_id`s                                                                     |
| `collectors`   | Scraper Studio collectors                                                                         |
| `domains`      | Target domains                                                                                    |
| `ws_api_snaps` | Web Scraper API snapshots                                                                         |
| `snapshots`    | Dataset snapshots                                                                                 |

The dimensions match what you see in the Cost Explorer UI, so the simplest way to discover what each dimension returns is to open Cost Explorer in the Control Panel and switch the grouping.

## Reproduce your monthly invoice for a dimension

To retrieve the full monthly cost broken down by Web Scraper API datasets for April 2026:

```bash theme={null}
curl -X POST -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "dimension": "web_apis",
    "filters": {},
    "from": "2026-04-01",
    "to": "2026-05-01"
  }' \
  "https://api.brightdata.com/costs/export/json"
```

Response shape (one entry per day; each day maps resource ID to billed USD):

```json theme={null}
{
  "2026-04-01": {
    "gd_l1viktl72bvl7bjuj0": 45.20,
    "gd_l1vikfnt1wgvvqz95w": 12.80
  },
  "2026-04-02": {
    "gd_l1viktl72bvl7bjuj0": 38.10
  }
}
```

For the same data as CSV, call `POST /costs/export/csv` with the identical request body. The CSV pivots the response into one row per day with one column per resource ID that appears in the date range, so column count varies with the data:

```csv theme={null}
Day,gd_l1viktl72bvl7bjuj0,gd_l1vikfnt1wgvvqz95w
2026-04-01,45.20,12.80
2026-04-02,38.10,0
```

## Using the `filters` field

The `filters` object uses Bright Data's internal charges-structure notation, the same notation used by Cost Explorer. Building a filter from scratch requires knowledge of that structure. Most callers leave `filters` empty (`{}`) and rely on the `dimension` parameter to scope the response.

One working example, restricting the result to datacenter and Web Unlocker products:

```json theme={null}
{
  "props": {
    "product": {
      "whitelist": ["dc", "unblocker"]
    }
  }
}
```

If you need a filter that the dimension alone cannot express, contact Bright Data support with the question you are trying to answer. We do not currently publish a complete filter grammar; support can build the filter you need or confirm that no filter is required.

## Rate limits

* 1,000 requests per minute
* 5,000 requests per hour

The endpoint accepts any API key with cost-data access. There is no separate billing-admin scope.

## Reconciling with raw request logs

The values returned by this endpoint are the source of truth for billing. They match the Control Panel's Cost Explorer and Usage Overview, and they roll up into your invoice. If you compare these values against raw request logs you collect yourself (for example, access logs forwarded to Logz or CloudWatch), expect differences of a few percent. Raw logs may capture requests that were never committed to the billing database because of async aggregation timing or transient network issues. Your invoice always reflects the values returned by this endpoint.

## Related endpoints

* [Total cost & bandwidth for a zone](/api-reference/account-management-api/Get_the_total_cost_and_bandwidth_stats_for_a_Zone). Single-zone cost and bandwidth over a date range. Cannot return Web Scraper API or Scraper Studio cost.
* [Bandwidth stats for a zone](/api-reference/account-management-api/Get_the_bandwidth_stats_for_a_Zone). Bandwidth only, no cost.
* [Bandwidth stats for all your Zones](/api-reference/account-management-api/Get_the_bandwidth_stats_for_all_your_Zones). Aggregate bandwidth across zones.


# Get account available countries
Source: https://docs.brightdata.com/api-reference/account-management-api/Get_Available_Countries

api-reference/openapi GET /countrieslist
Use the Bright Data Account Management API to get account available countries. GET /countrieslist returns 200 OK with zone or account JSON.

<Tip>
  Paste your API key to the authorization field. To get an API key, [Create an account](https://brightdata.com/?hs_signup=1\&utm_source=docs\&utm_campaign=playground) and learn [how to generate an API key](/api-reference/authentication#how-do-i-generate-a-new-api-key%3F)
</Tip>


# Account status
Source: https://docs.brightdata.com/api-reference/account-management-api/Get_account_status

api-reference/openapi GET /status
Use the Bright Data Account Management API to account status. GET /status returns 200 OK with zone or account configuration data as JSON.

<Tip>
  Paste your API key to the authorization field. To get an API key, [Create an account](https://brightdata.com/?hs_signup=1\&utm_source=docs\&utm_campaign=playground) and learn [how to generate an API key](/api-reference/authentication#how-do-i-generate-a-new-api-key%3F)
</Tip>


# Active zones
Source: https://docs.brightdata.com/api-reference/account-management-api/Get_active_Zones

api-reference/openapi GET /zone/get_active_zones
Use the Bright Data Account Management API to active Zones. GET /zone/get_active_zones returns 200 OK with zone or account configuration data as JSON.

<Tip>
  Paste your API key to the authorization field. To get an API key, [Create an account](https://brightdata.com/?hs_signup=1\&utm_source=docs\&utm_campaign=playground) and learn [how to generate an API key](/api-reference/authentication#how-do-i-generate-a-new-api-key%3F)
</Tip>


# Get available dedicated IPs per zone
Source: https://docs.brightdata.com/api-reference/account-management-api/Get_all_available_dedicated_residential_IPs_per_Zone

api-reference/openapi GET /zone/route_vips
Use the Bright Data Account Management API to get available dedicated IPs per Zone via GET /zone/route_vips, returning JSON zone or account data with 200 OK.

<Tip>
  Paste your API key to the authorization field. To get an API key, [Create an account](https://brightdata.com/?hs_signup=1\&utm_source=docs\&utm_campaign=playground) and learn [how to generate an API key](/api-reference/authentication#how-do-i-generate-a-new-api-key%3F)
</Tip>

<Warning>Only works with residential dedicated zone</Warning>


# Available Datacenter and ISP IPs
Source: https://docs.brightdata.com/api-reference/account-management-api/Get_amount_of_available_Datacenter_and_ISP_IPs

api-reference/openapi GET /zone/count_available_ips
Use the Bright Data Account Management API to available Datacenter and ISP IPs via GET /zone/count_available_ips, returning a 200 OK JSON response.

<Tip>
  Paste your API key to the authorization field. To get an API key, [Create an account](https://brightdata.com/?hs_signup=1\&utm_source=docs\&utm_campaign=playground) and learn [how to generate an API key](/api-reference/authentication#how-do-i-generate-a-new-api-key%3F)
</Tip>

<Accordion title="Plan Examples">
  * Available IPs for current Zone plan:

  ```sh theme={null}
  curl "https://api.brightdata.com/count_available_ips?zone=ZONE" -H "Authorization: Bearer API_KEY"
  ```

  * Abstract plan, dedicated IPs:

  ```sh dedicated IPs theme={null}
  curl "https://api.brightdata.com/count_available_ips?plan=\{\"ips_type\":\"dedicated\"\}" -H "Authorization: Bearer API_KEY"
  ```

  * Abstract plan, shared IPs located in United States:

  ```sh theme={null}
  curl "https://api.brightdata.com/count_available_ips?plan=\{\"country\":\"us\",\"ips_type\":\"shared\"\}" -H "Authorization: Bearer API_KEY"
  ```

  * Abstract plan, dedicated ips located in United States:

  ```sh theme={null}
  curl "https://api.brightdata.com/count_available_ips?plan=\{\"country\":\"us\",\"ips_type\":\"dedicated\"\}" -H "Authorization: Bearer API_KEY"
  ```

  * Abstract plan, shared IPs located in United States, Denver:

  ```sh theme={null}
  curl "https://api.brightdata.com/count_available_ips?plan=\{\"ips_type\":\"shared\",\"country_city\":\"us-denver\",\"city\":true\}" -H "Authorization: Bearer API_KEY"
  ```

  * Abstract plan, shared IPs located in US, exclusive for domains: amazon.com, fb.com:

  ```sh theme={null}
  curl "https://api.brightdata.com/count_available_ips?plan=\{\"ips_type\":\"selective\",\"country\":\"us\",\"domain_whitelist\":\"amazon.com%20fb.com\"\}" -H "Authorization: Bearer API_KEY"
  ```

  * Abstract plan, shared IPs located in US, geo IP databases: should persist in both maxmind and dbip:

  ```sh theme={null}
  curl "https://api.brightdata.com/count_available_ips?plan=\{\"ips_type\":\"shared\",\"country\":\"us\",\"geo_db\":\{\"maxmind\":true,\"dbip\":true\}\}" -H "Authorization: Bearer API_KEY"
  ```
</Accordion>


# Get country cities
Source: https://docs.brightdata.com/api-reference/account-management-api/Get_country_cities

api-reference/openapi GET /cities
Use the Bright Data Account Management API to get Country Cities. GET /cities returns 200 OK with zone or account configuration data as JSON.

<Tip>
  Paste your API key to the authorization field. To get an API key, [Create an account](https://brightdata.com/?hs_signup=1\&utm_source=docs\&utm_campaign=playground) and learn [how to generate an API key](/api-reference/authentication#how-do-i-generate-a-new-api-key%3F)
</Tip>


# Get current service status
Source: https://docs.brightdata.com/api-reference/account-management-api/Get_current_service_status

api-reference/openapi GET /network_status/{NETWORK_TYPE}
Use the Bright Data Account Management API to get current service status via GET /network_status/{NETWORK_TYPE}, returning a 200 OK JSON response.

<Tip>
  Paste your API key to the authorization field. To get an API key, [Create an account](https://brightdata.com/?hs_signup=1\&utm_source=docs\&utm_campaign=playground) and learn [how to generate an API key](/api-reference/authentication#how-do-i-generate-a-new-api-key%3F)
</Tip>


# List static network cities by country
Source: https://docs.brightdata.com/api-reference/account-management-api/Get_list_of_available_cities_of_static_network_per_country

api-reference/openapi GET /zone/static/cities
Use the Bright Data Account Management API to list static network cities by country via GET /zone/static/cities, returning a 200 OK JSON response.

<Tip>
  Paste your API key to the authorization field. To get an API key, [Create an account](https://brightdata.com/?hs_signup=1\&utm_source=docs\&utm_campaign=playground) and learn [how to generate an API key](/api-reference/authentication#how-do-i-generate-a-new-api-key%3F)
</Tip>


# Recent IPs attempting to use your zone
Source: https://docs.brightdata.com/api-reference/account-management-api/Get_recent_IPs_attempting_to_use_your_Zone

api-reference/openapi GET /zone/recent_ips
Use the Bright Data Account Management API to recent IPs attempting to use your Zone via GET /zone/recent_ips, returning JSON zone or account data with 200 OK.

<Tip>
  Paste your API key to the authorization field. To get an API key, [Create an account](https://brightdata.com/?hs_signup=1\&utm_source=docs\&utm_campaign=playground) and learn [how to generate an API key](/api-reference/authentication#how-do-i-generate-a-new-api-key%3F)
</Tip>


# Available Datacenter & ISP IPs/zone
Source: https://docs.brightdata.com/api-reference/account-management-api/Get_the_available_Data_center_ISP_IPs_per_Zone

api-reference/openapi GET /zone/route_ips
Use the Bright Data Account Management API to available Datacenter & ISP IPs/Zone. GET /zone/route_ips returns 200 OK with zone or account JSON.

<Tip>
  Paste your API key to the authorization field. To get an API key, [Create an account](https://brightdata.com/?hs_signup=1\&utm_source=docs\&utm_campaign=playground) and learn [how to generate an API key](/api-reference/authentication#how-do-i-generate-a-new-api-key%3F)
</Tip>


# Bandwidth stats for a zone
Source: https://docs.brightdata.com/api-reference/account-management-api/Get_the_bandwidth_stats_for_a_Zone

api-reference/openapi GET /zone/bw
Use the Bright Data Account Management API to bandwidth stats for a zone. GET /zone/bw returns 200 OK with zone or account configuration data as JSON.

<Tip>
  Paste your API key to the authorization field. To get an API key, [Create an account](https://brightdata.com/?hs_signup=1\&utm_source=docs\&utm_campaign=playground) and learn [how to generate an API key](/api-reference/authentication#how-do-i-generate-a-new-api-key%3F)
</Tip>


# Bandwidth stats for all your zones
Source: https://docs.brightdata.com/api-reference/account-management-api/Get_the_bandwidth_stats_for_all_your_Zones

api-reference/openapi GET /customer/bw
Retrieve bandwidth consumption stats for every Bright Data API across your account in 1 request, with totals returned per product and time window as JSON.

<Tip>
  Paste your API key to the authorization field. To get an API key, [Create an account](https://brightdata.com/?hs_signup=1\&utm_source=docs\&utm_campaign=playground) and learn [how to generate an API key](/api-reference/authentication#how-do-i-generate-a-new-api-key%3F)
</Tip>

<Note>Sample response redacted</Note>


# Total cost & bandwidth for a zone
Source: https://docs.brightdata.com/api-reference/account-management-api/Get_the_total_cost_and_bandwidth_stats_for_a_Zone

api-reference/openapi GET /zone/cost
Returns 200 OK with billed cost, bandwidth and usage for a Zone over a date range. Matches the Control Panel Usage Overview and your invoice.

<Warning>
  **The `to` parameter is exclusive.** The day specified in `to` is **not** included in the result. To match a calendar month shown in the Control Panel or on your invoice, set `to` to the first day of the **following** month. For example, `from=2026-04-01&to=2026-05-01` returns all of April 2026.
</Warning>

<Note>
  This endpoint is scoped to a single zone and cannot return Web Scraper API or Scraper Studio cost data (those are keyed by `dataset_id` / collector ID, not by zone name). For multi-product or WSA / Scraper Studio breakdowns, use [Cost breakdown export](/api-reference/account-management-api/Export_cost_breakdown).
</Note>

<Tip>
  Paste your API key to the authorization field. To get an API key, [Create an account](https://brightdata.com/?hs_signup=1\&utm_source=docs\&utm_campaign=playground) and learn [how to generate an API key](/api-reference/authentication#how-do-i-generate-a-new-api-key%3F).
</Tip>

## Reproduce your monthly invoice

To retrieve the exact billed cost and usage for a calendar month as shown in the Control Panel and on your invoice, set `from` to the first day of the month and `to` to the first day of the **following** month:

```bash theme={null}
# Returns billed usage for all of April 2026
curl -H "Authorization: Bearer YOUR_API_KEY" \
  "https://api.brightdata.com/zone/cost?zone=YOUR_ZONE&from=2026-04-01&to=2026-05-01"
```

Using `to=2026-04-30` would omit the last day of the month. Always set `to` to the day **after** the last day you want included.

## Reconciling with raw request logs

The values returned by this endpoint are the source of truth for billing. They match the Control Panel's Usage Overview and your invoice. If you compare these values against raw request logs you collect yourself (e.g., access logs forwarded to Logz, CloudWatch, or another sink), expect differences of a few percent. Raw logs may capture requests that were never committed to the billing database because of async aggregation timing or transient network issues. Your invoice always reflects the values returned by this endpoint.

## Related endpoints

* [Bandwidth stats for a Zone](/api-reference/account-management-api/Get_the_bandwidth_stats_for_a_Zone). Bandwidth only, no cost.
* [Bandwidth stats for all your Zones](/api-reference/account-management-api/Get_the_bandwidth_stats_for_all_your_Zones). Aggregate across zones.


# Migrate static IPs between zones
Source: https://docs.brightdata.com/api-reference/account-management-api/Migrate_Static_Datacenter_ISP_IPs_between_zones

api-reference/openapi POST /zone/ips/migrate
Use the Bright Data Account Management API to migrate Static IPs between zones. POST /zone/ips/migrate returns 200 OK with zone or account JSON.

<Warning>Only users with **Admin** or **Ops** roles can perform this action.</Warning>

<Warning> **Warning:** This API can modify your account settings, damage your operations or incur charges.</Warning>

<Tip>
  Paste your API key to the authorization field. To get an API key, [Create an account](https://brightdata.com/?hs_signup=1\&utm_source=docs\&utm_campaign=playground) and learn [how to generate an API key](/api-reference/authentication#how-do-i-generate-a-new-api-key%3F)
</Tip>


# Refresh static IPs (Datacenter/ISP)
Source: https://docs.brightdata.com/api-reference/account-management-api/Refresh_Static_Datacenter_ISP_IPs

api-reference/openapi POST /zone/ips/refresh
Use the Bright Data Account Management API to refresh Static IPs (Datacenter/ISP) via POST /zone/ips/refresh, returning JSON zone or account data with 200 OK.

<Warning>Only users with **Admin** or **Ops** roles can perform this action.</Warning>

<Warning> **Warning:** This API can modify your account settings, damage your operations or incur charges.</Warning>

<Tip>
  Paste your API key to the authorization field. To get an API key, [Create an account](https://brightdata.com/?hs_signup=1\&utm_source=docs\&utm_campaign=playground) and learn [how to generate an API key](/api-reference/authentication#how-do-i-generate-a-new-api-key%3F)
</Tip>

```json Sample Response for Static IPs theme={null}
{
    "ips":[
        "1.1.1.1",
        "1.1.1.2",
        "1.1.1.3"
    ],
    "new_ips":[
        "1.1.1.1",
        "1.1.1.3"
    ]
}
```


# Refresh dedicated residential IPs
Source: https://docs.brightdata.com/api-reference/account-management-api/Refresh_dedicated_residential_IPs

api-reference/openapi POST /zone/ips/refresh
Use the Bright Data Account Management API to refresh dedicated residential IPs via POST /zone/ips/refresh, returning JSON zone or account data with 200 OK.

<Warning>Only users with **Admin** or **Ops** roles can perform this action.</Warning>

<Warning> **Warning:** This API can modify your account settings, damage your operations or incur charges.</Warning>

<Tip>
  Paste your API key to the authorization field. To get an API key, [Create an account](https://brightdata.com/?hs_signup=1\&utm_source=docs\&utm_campaign=playground) and learn [how to generate an API key](/api-reference/authentication#how-do-i-generate-a-new-api-key%3F)
</Tip>

<Warning>
  Each dedicated residential IP refreshed costs \$0.02/refresh/IP
</Warning>


# Allowlist IP(s)
Source: https://docs.brightdata.com/api-reference/account-management-api/allowlist-ip

api-reference/openapi POST /zone/whitelist
Use the Bright Data Account Management API to allowlist IP(s). POST /zone/whitelist returns 200 OK with zone or account configuration data as JSON.

<Warning>Only users with **Admin** or **Ops** roles can perform this action.</Warning>

<Warning> **Warning:** This API can modify your account settings, damage your operations or incur charges.</Warning>

<Tip>
  Paste your API key to the authorization field. To get an API key, [Create an account](https://brightdata.com/?hs_signup=1\&utm_source=docs\&utm_campaign=playground) and learn [how to generate an API key](/api-reference/authentication#how-do-i-generate-a-new-api-key%3F)
</Tip>


# Allowlist/denylist domain(s)
Source: https://docs.brightdata.com/api-reference/account-management-api/allowlist-or-denylist-domains

api-reference/openapi POST /zone/domain_perm
Use the Bright Data Account Management API to allowlist/Denylist Domain(s). POST /zone/domain_perm returns 200 OK with zone or account JSON.

<Warning>Only users with **Admin** or **Ops** roles can perform this action.</Warning>

<Warning> **Warning:** This API can modify your account settings, damage your operations or incur charges.</Warning>

<Tip>
  Paste your API key to the authorization field. To get an API key, [Create an account](https://brightdata.com/?hs_signup=1\&utm_source=docs\&utm_campaign=playground) and learn [how to generate an API key](/api-reference/authentication#how-do-i-generate-a-new-api-key%3F)
</Tip>


# Denylist IP(s)
Source: https://docs.brightdata.com/api-reference/account-management-api/denylist-ip

api-reference/openapi POST /zone/blacklist
Use the Bright Data Account Management API to denylist IP(s). POST /zone/blacklist returns 200 OK with zone or account configuration data as JSON.

<Warning>Only users with **Admin** or **Ops** roles can perform this action.</Warning>

<Warning> **Warning:** This API can modify your account settings, damage your operations or incur charges.</Warning>

<Tip>
  Paste your API key to the authorization field. To get an API key, [Create an account](https://brightdata.com/?hs_signup=1\&utm_source=docs\&utm_campaign=playground) and learn [how to generate an API key](/api-reference/authentication#how-do-i-generate-a-new-api-key%3F)
</Tip>


# All zones
Source: https://docs.brightdata.com/api-reference/account-management-api/get-all-zones

api-reference/openapi GET /zone/get_all_zones
Use the Bright Data Account Management API to all Zones. GET /zone/get_all_zones returns 200 OK with zone or account configuration data as JSON.

<Tip>
  Paste your API key to the authorization field. To get an API key, [Create an account](https://brightdata.com/?hs_signup=1\&utm_source=docs\&utm_campaign=playground) and learn [how to generate an API key](/api-reference/authentication#how-do-i-generate-a-new-api-key%3F)
</Tip>


# Deliver snapshot to S3, Azure Blob or GCP
Source: https://docs.brightdata.com/api-reference/archive-api/deliver-to-cloud

api-reference/web-archive-api POST /webarchive/dump
Use the Bright Data Marketplace Archive API to deliver snapshot to S3 or Azure Blob. Manages web archive snapshots and returns job status as JSON.

<Note>
  To use S3 storage delivery, you will first need to do the following:

  * Create an [AWS role](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles_create_for-user_externalid.html) which gives Bright Data access to your system.
    * During this setup, you will be asked by Amazon for an “external ID” that is used with the role.
    * Your external ID for S3 is your Bright Data **Account ID** that can be found within [Account Settings](https://brightdata.com/cp/setting/customer_details)
  * Once a role is created, you will need to allow the Bright Data delivery role to `AssumeRole` that role.
    * The Bright Data delivery role is: `arn:aws:iam::422310177405:role/brd.ec2.zs-dca-delivery`
</Note>

<Note>
  To use Google Cloud Storage delivery, create a bucket and provide the required GCP delivery settings.
</Note>

<Warning>
  The **webhook** delivery strategy is **not suitable for large dumps** unless you
  are hosting the webhook on your own infrastructure. Third-party inspection
  tools such as [webhook.site](https://webhook.site) impose strict request body
  size limits and will fail to receive payloads that can reach up to **1 GB** in
  size. For large deliveries, use **Amazon S3**,  **Azure Blob Storage**
  or **Google Cloud Storage** instead.
</Warning>

<Note>
  **Common dump parameters:**

  * `search_id` (required): The search ID from a completed search
  * `max_entries` (optional): Limit the number of files to include in the dump
  * `delivery` (required): Delivery configuration (S3, Azure, GCP, or webhook)
</Note>

<Tip>
  If you’re running a linux/macos machine, you can simulate one of our delivery webhooks with the code on [this page](/datasets/archive/webhook-test).
</Tip>


# Get all search statuses
Source: https://docs.brightdata.com/api-reference/archive-api/get-all-search-statuses

api-reference/web-archive-api GET /webarchive/searches
Use the Bright Data Marketplace Archive API to get All Search Statuses. GET /webarchive/searches manages web archive snapshots; returns 200 OK with JSON status.

<Info>
  Starting **March 26, 2026**, the hot storage retention period changed from 48 hours to 24 hours.
</Info>


# Get the statuses of all data snapshots
Source: https://docs.brightdata.com/api-reference/archive-api/get-all-snapshots-statuses

api-reference/web-archive-api GET /webarchive/dumps
Use the Bright Data Marketplace Archive API to get statuses of all Data Snapshots. Manages web archive snapshots; returns 200 OK with JSON job status.



# Get search status
Source: https://docs.brightdata.com/api-reference/archive-api/get-search-status

api-reference/web-archive-api GET /webarchive/search/{search_id}
Use the Bright Data Marketplace Archive API to get Search Status. GET /webarchive/search/{search_id} returns 200 OK with archive search status JSON.

When successful it will retrieve:

* The number of entries for your query
* The estimated size and cost of the full Data Snapshot

<Note>
  **Pricing & size:** `estimate_batch_size` is measured in bytes. `dump_cost_usd` is an estimated total cost based on `files_count` and your current cache/archive pricing tier. The `cost_breakdown` object shows separate costs for cache vs archive pages.
</Note>


# Get status of data snapshot
Source: https://docs.brightdata.com/api-reference/archive-api/get-snapshot-status

api-reference/web-archive-api GET /webarchive/dump/{dump_id}
Use the Bright Data Marketplace Archive API to get Status of a Data Snapshot. Manages web archive snapshots; returns 200 OK with JSON job status.



# Run a search
Source: https://docs.brightdata.com/api-reference/archive-api/run-a-search

api-reference/web-archive-api POST /webarchive/search
Use the Bright Data Marketplace Archive API to run a Search. POST /webarchive/search manages web archive snapshots; returns 200 OK with JSON status.

<Danger>
  **Mandatory**:\
  Either use `max_age` OR a combination of `min_date` + `max_date`
</Danger>

<Note>
  If the search takes longer than 30 seconds, the response returns only a `search_id` and you should poll the status asynchronously. If the search completes within 30 seconds, the response returns the full search result object (same as `GET /webarchive/search/<search_id>`).
</Note>

<Note>
  You can run up to 100 searches per day without triggering a dump.
  Once you trigger a dump, that search no longer count against your limit.
</Note>

<Accordion title="LIKE vs Regex Filters">
  * Use LIKE filters (`domain_like_*`, `url_like_*`) for simple pattern matching with `%` (any sequence) and `_` (single character).
  * LIKE patterns are case-insensitive and often faster than regex for simple prefix/suffix matching like `%.com` or `amazon%`.
  * Use regex filters (`domain_regex_*`, `url_regex_*`) for complex patterns requiring full regex syntax. LIKE patterns use backslash escaping: `\%` for literal `%`, `\_` for literal `_`.
</Accordion>


# Cancel request
Source: https://docs.brightdata.com/api-reference/deep-lookup/cancel-request

api-reference/deep-lookup POST /request/{id}/cancel
Use the Bright Data Deep Lookup API to cancel Request. POST /request/{id}/cancel returns enriched records as JSON with 200 OK on success.



# Create preview
Source: https://docs.brightdata.com/api-reference/deep-lookup/create-preview

api-reference/deep-lookup POST /preview
Use the Bright Data Deep Lookup API to create Preview. POST /preview returns enriched records as JSON with 200 OK on success.

<Warning>
  Preview data is not immediately available.

  Use the [Get Preview Data](/api-reference/deep-lookup/get-preview-data) endpoint to retrieve results.
</Warning>


# Download results
Source: https://docs.brightdata.com/api-reference/deep-lookup/download-results

api-reference/deep-lookup GET /request/{id}/download
Use the Bright Data Deep Lookup API to download Results. GET /request/{id}/download returns enriched records as JSON with 200 OK on success.

<Card title="Query Parameters">
  <ParamField type="string">
    Output format: `json` (default), `csv`, `excel`
  </ParamField>
</Card>

```bash theme={null}
curl -X GET "https://api.brightdata.com/datasets/deep_lookup/v1/request/ai_meu3z0171o8k9jc4dh/download?format=csv" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -o results.csv
```


# Enhance query
Source: https://docs.brightdata.com/api-reference/deep-lookup/enhance-query

api-reference/deep-lookup POST /enhance_query
Use the Bright Data Deep Lookup API to enhance Query. POST /enhance_query returns enriched records as JSON with 200 OK on success.



# Enrich column
Source: https://docs.brightdata.com/api-reference/deep-lookup/enrich-column

api-reference/deep-lookup POST /request/{id}/enrich
Use the Bright Data Deep Lookup API to enrich Column. POST /request/{id}/enrich returns enriched records as JSON with 200 OK on success.



# Get preview data
Source: https://docs.brightdata.com/api-reference/deep-lookup/get-preview-data

api-reference/deep-lookup GET /preview/{id}
Use the Bright Data Deep Lookup API to get Preview Data. GET /preview/{id} returns enriched records as JSON with 200 OK on success.



# Get request data
Source: https://docs.brightdata.com/api-reference/deep-lookup/get-request-data

api-reference/deep-lookup GET /request/{id}
Use the Bright Data Deep Lookup API to get Request Data. GET /request/{id} returns enriched records as JSON with 200 OK on success.



# Get request status
Source: https://docs.brightdata.com/api-reference/deep-lookup/get-request-status

api-reference/deep-lookup GET /request/{id}/status
Use the Bright Data Deep Lookup API to get Request Status. GET /request/{id}/status returns enriched records as JSON with 200 OK on success.



# Deep Lookup API overview
Source: https://docs.brightdata.com/api-reference/deep-lookup/overview

Bright Data Deep Lookup API: search and extract structured records from the public web programmatically. Pay-per-result with 200 OK JSON over HTTPS.

## Getting Started

**Base URL:** `https://api.brightdata.com/datasets/deep_lookup/v1`

**Authentication:** All API requests require authentication using your API key in the request headers.

```bash theme={null}
curl -H "Authorization: Bearer YOUR_API_KEY" \
  https://api.brightdata.com/datasets/deep_lookup/v1/preview
```

## Core Workflow

The Deep Lookup API follows a simple workflow designed for maximum flexibility and cost control:

<CardGroup>
  <Card title="Create Preview" href="/api-reference/deep-lookup/create-preview" icon="square-1">
    Start a preview to test your query with sample results.
  </Card>

  <Card title="Get Preview Data" href="/api-reference/deep-lookup/get-preview-data" icon="square-2">
    Retrieve the preview results once processing is complete
  </Card>

  <Card title="Enhance Query (Optional)" href="/api-reference/deep-lookup/enhance-query" icon="square-3">
    Refine your query based on preview results
  </Card>

  <Card title="Trigger Full Request" href="/api-reference/deep-lookup/trigger-full-request" icon="square-4">
    Execute the research with your desired parameters
  </Card>
</CardGroup>

<Card title="Get Results" href="/api-reference/deep-lookup/download-results" icon="square-5">
  Retrieve your structured data in JSON or CSV format
</Card>

## Understanding Column Types

When creating requests with specifications, you need to define column types:

### Column Type: `enrichment`

Adds data attributes without filtering results.

> **Examples:**
>
> * Company revenue
> * Contact information
> * Social profiles

### Column Type: `constraint`

Filters results based on criteria. Only entities matching ALL constraints are included.

> **Examples:**
>
> * Must be a startup
> * Revenue over \$10M
> * Founded after 2020

## Processing Steps

When monitoring request progress, the step field indicates the current processing phase:

| Step                | Description                                          |
| :------------------ | :--------------------------------------------------- |
| `identifying`       | Understanding and analyzing your query               |
| `generating_schema` | Creating the data structure for results              |
| `generating`        | Actively collecting and processing data from sources |
| `done`              | Research completed successfully                      |

## Webhooks

Configure webhooks to receive notifications when research completes:

```json theme={null}
{
  "webhook_url": "https://your-app.com/webhook",
  "events": ["request.completed", "request.failed"]
}
```


# Trigger full request
Source: https://docs.brightdata.com/api-reference/deep-lookup/trigger-full-request

api-reference/deep-lookup POST /trigger
Use the Bright Data Deep Lookup API to trigger Full Request. POST /trigger returns enriched records as JSON with 200 OK on success.

<Note>
  The `steps` array with detailed processing stages is available but typically used for internal debugging.
</Note>


# Add a user
Source: https://docs.brightdata.com/api-reference/proxy-manager/add_a_user

Use the Bright Data Proxy Manager API to add a User. Updates the local Proxy Manager (default port 22999) configuration and returns a JSON status.

**API endpoint:** `POST` `/api/lpm_user`

## `POST` body

<ParamField type="string">
  User email address to add
</ParamField>

<RequestExample>
  ```sh Shell theme={null}
  curl "http://127.0.0.1:22999/api/lpm_user" -H "Content-Type: application/json" -d '{"email":"test@example.com"}'
  ```

  ```js NodeJS theme={null}
  #!/usr/bin/env node
  (async () => {
    const response = await fetch('http://127.0.0.1:22999/api/lpm_user', {
      method: 'POST',
      headers: { 'Content-Type': 'application/json' },
      body: JSON.stringify({'email':'test@example.com'}),
    });
    const data = await response.text();
    console.log(data);
  })();
  ```

  ```java Java theme={null}
  package example;
  import org.apache.http.HttpHost;
  import org.apache.http.client.fluent.*;


  public class Example {
   public static void main(String[] args) throws Exception {

   String body = "{\"email\":\"test@example.com\"}";

   String res = Executor.newInstance()
   .execute(Request.Post("http://127.0.0.1:22999/api/lpm_user")
   .bodyString(body, ContentType.APPLICATION_JSON))
   .returnContent().asString();
   
   System.out.println(res)

   }
  }
  ```

  ```cs C# theme={null}
  using System;
  using System.Net;
  using System.Net.Http;
  using System.Net.Http.Headers;


  public class Program {
   public static async Task Main() {

   var client = new HttpClient();

   var requestMessage = new HttpRequestMessage {

   Method = HttpMethod.Post,

   RequestUri = new Uri("http://127.0.0.1:22999/api/lpm_user"),

   Content = new StringContent(JsonConvert.SerializeObject(new {

   email = "test@example.com"

   }), Encoding.UTF8, "application/json")

   };

   var response = await client.SendAsync(requestMessage);

   var responseString = await response.Content.ReadAsStringAsync();

   Console.WriteLine(responseString);

   }

  }

  ```

  ```python Python theme={null}
  #!/usr/bin/env python
  print('If you get error "ImportError: No module named requests", please install it:\n$ sudo pip install requests');

  import requests
  import json

  data = {'email':'test@example.com'}
  r = requests.post('http://127.0.0.1:22999/api/lpm_user', data=json.dumps(data))

  print(r.content)
  ```
</RequestExample>


# Allowlist IPs
Source: https://docs.brightdata.com/api-reference/proxy-manager/allowlist-ips

Use the Bright Data Proxy Manager API to allowlist IPs. Updates the local Proxy Manager (default port 22999) configuration and returns a JSON status.

**API endpoint:** `PUT` `/api/wip`

<ParamField type="string">
  API key
  <Tip>API key should be generated using [Generate API key](/api-reference/proxy-manager/generate_token_for_token_based_authentication)</Tip>
</ParamField>

## `PUT` body

<ParamField type="string">
  IP to allowlist. e.g, `ip="1.2.1.2"`
</ParamField>

<RequestExample>
  ```sh Shell theme={null}
  curl -X PUT "http://127.0.0.1:22999/api/wip" -H "Authorization: API key" -H "Content-Type: application/json" -d '{"ip":"1.2.1.2"}'
  ```

  ```js NodeJS theme={null}
  #!/usr/bin/env node

  (async () => {
    const response = await fetch('http://127.0.0.1:22999/api/wip', {
      method: 'PUT',
      headers: { 'Authorization': 'API key', 'Content-Type': 'application/json' },
      body: JSON.stringify({'ip':'1.2.1.2'}),
    });
    const data = await response.text();
    console.log(data);
  })();
  ```

  ```java Java theme={null}
  package example;

  import org.apache.http.HttpHost;
  import org.apache.http.client.fluent.\*;

  public class Example {
    public static void main(String[] args) throws Exception {
      String body = "{\"ip\":\"1.2.1.2\"}";
      String res =Executor.newInstance()
        .addHeader("Authorization", "API key")
        .execute(Request.Put("http://127.0.0.1:22999/api/wip")
        .bodyString(body, ContentType.APPLICATION_JSON))
        .returnContent()
        .asString();

      System.out.println(res)
    }
  }
  ```

  ```cs C# theme={null}
  using System;
  using System.Net;
  using System.Net.Http;
  using System.Net.Http.Headers;


  public class Program {
    public static async Task Main() {
      var client = new HttpClient();
      var requestMessage = new HttpRequestMessage {
        Method = HttpMethod.Put,
        RequestUri = new Uri("http://127.0.0.1:22999/api/wip"),
        Headers = {{"Authorization", "API key"}},
        Content = new StringContent(JsonConvert.SerializeObject(new {
          ip = "1.2.1.2"
        }), Encoding.UTF8, "application/json")
      };

      var response = await client.SendAsync(requestMessage);
      var responseString = await response.Content.ReadAsStringAsync();

      Console.WriteLine(responseString);
    }
  }
  ```

  ```python Python theme={null}
  #!/usr/bin/env python

  import json
  import requests


  data = {'ip':'1.2.1.2'}
  headers = {'Authorization': 'API key'}

  r = requests.put(
    'http://127.0.0.1:22999/api/wip',
    data=json.dumps(data),
    headers=headers
  )

  print(r.content)
  ```
</RequestExample>

<ResponseExample>
  ```json 200 theme={null}
  Successful response
  ```

  ```json 400 theme={null}
  Bad request. No IP was passed
  ```

  ```json 403 theme={null}
  Forbidden. No authentication provided
  ```

  ```json 422 theme={null}
  Unprocessable entity. Invalid IP was passed
  ```
</ResponseExample>


# Ban an IP (all ports)
Source: https://docs.brightdata.com/api-reference/proxy-manager/ban_an_ip_for_all_ports

Use the Bright Data Proxy Manager API to ban an IP (All Ports). Calls POST /api/banip on the local Proxy Manager port 22999.

API endpoint: `POST` `/api/banip`

## `POST` body

<ParamField type="string">
  IP to ban. e.g. `1.2.1.2`
</ParamField>

<ParamField type="string">
  Ban the IP for sending requests to the specified domain
</ParamField>

<ParamField type="integer">
  Ban the IP for specified milliseconds
</ParamField>

<RequestExample>
  ```sh Shell theme={null}
  curl "http://127.0.0.1:22999/api/banip" -H "Content-Type: application/json" -d '{"ip":"1.2.1.2","domain":"example.com","ms":60000}'
  ```

  ```js NodeJS theme={null}
  #!/usr/bin/env node

  (async () => {
    const response = await fetch('http://127.0.0.1:22999/api/banip', {
      method: 'POST',
      headers: { 'Content-Type': 'application/json' },
      body: JSON.stringify({'ip':'1.2.1.2','domain':'example.com','ms':60000}),
    });
    const data = await response.text();
    console.log(data);
  })();
  ```

  ```java Java theme={null}
  package example;

   

  import org.apache.http.HttpHost;

  import org.apache.http.client.fluent.\*;

   

  public class Example {

   public static void main(String[] args) throws Exception {

    String body = "{\"ip\":\"1.2.1.2\",\"domain\":\"example.com\",\"ms\":60000}";

    String res = Executor.newInstance()

     .execute(Request.Post("http://127.0.0.1:22999/api/banip")

     .bodyString(body, ContentType.APPLICATION_JSON))

     .returnContent().asString();

   

    System.out.println(res)

   }

  }
  ```

  ```cs C# theme={null}
  using System;
  using System.Net;
  using System.Net.Http;
  using System.Net.Http.Headers;


  public class Program {

   public static async Task Main() {

    var client = new HttpClient();

    var requestMessage = new HttpRequestMessage {

     Method = HttpMethod.Post,

     RequestUri = new Uri("http://127.0.0.1:22999/api/banip"),

     Content = new StringContent(JsonConvert.SerializeObject(new {

      ip = "1.2.1.2",

      domain = "example.com",

      ms = 60000

     }), Encoding.UTF8, "application/json")

    };

    var response = await client.SendAsync(requestMessage);

    var responseString = await response.Content.ReadAsStringAsync();

    Console.WriteLine(responseString);

   }

  }

  ```

  ```python Python theme={null}
  #!/usr/bin/env python

  print('If you get error "ImportError: No module named requests", please install it:\n$ sudo pip install requests');

  import requests
  import json


  data = {'ip':'1.2.1.2','domain':'example.com','ms':60000}
  r = requests.post('http://127.0.0.1:22999/api/banip', data=json.dumps(data))

  print(r.content)
  ```
</RequestExample>


# Ban an IP
Source: https://docs.brightdata.com/api-reference/proxy-manager/ban_an_ip_single_

Use the Bright Data Proxy Manager API to ban an IP. Calls POST /api/proxies/{PORT}/banip on the local Proxy Manager port 22999.

**API endpoint:** `POST` `/api/proxies/{PORT}/banip`

## Path Parameter

<ParamField type="string">
  Existing proxy port number
</ParamField>

## `POST` body

<ParamField type="string">
  IP to ban. e.g. `1.2.1.2`
</ParamField>

<ParamField type="string">
  Ban the IP for sending requests to the specified domain
</ParamField>

<ParamField type="integer">
  Ban the IP for specified milliseconds
</ParamField>

<RequestExample>
  ```sh Shell theme={null}
  curl "http://127.0.0.1:22999/api/proxies/{PORT}/banip" -H "Content-Type: application/json" -d '{"ip":"1.2.1.2","domain":"example.com","ms":60000}'
  ```

  ```js NodeJS theme={null}
  #!/usr/bin/env node

  (async () => {
    const response = await fetch('http://127.0.0.1:22999/api/proxies/{PORT}/banip', {
      method: 'POST',
      headers: { 'Content-Type': 'application/json' },
      body: JSON.stringify({'ip':'1.2.1.2','domain':'example.com','ms':60000}),
    });
    const data = await response.text();
    console.log(data);
  })();
  ```

  ```java Java theme={null}
  package example;

  import org.apache.http.HttpHost;
  import org.apache.http.client.fluent.*;


  public class Example {
    public static void main(String[] args) throws Exception {
     String body = "{\"ip\":\"1.2.1.2\",\"domain\":\"example.com\",\"ms\":60000}";
      String res = Executor.newInstance()
       .execute(Request.Post("http://127.0.0.1:22999/api/proxies/{PORT}/banip")
       .bodyString(body, ContentType.APPLICATION_JSON))
       .returnContent().asString();
      System.out.println(res)
    }
  }
  ```

  ```cs C# theme={null}
  using System;
  using System.Net;
  using System.Net.Http;
  using System.Net.Http.Headers;
   

  public class Program {
    public static async Task Main() {
      var client = new HttpClient();
      var requestMessage = new HttpRequestMessage {
        Method = HttpMethod.Post,
       RequestUri = new Uri("http://127.0.0.1:22999/api/proxies/{PORT}/banip"),
       Content = new StringContent(JsonConvert.SerializeObject(new {
         ip = "1.2.1.2",
         domain = "example.com",
         ms = 60000
       }), Encoding.UTF8, "application/json")
      };

      var response = await client.SendAsync(requestMessage);
      var responseString = await response.Content.ReadAsStringAsync();

      Console.WriteLine(responseString);
    }
  }
  ```

  ```python Python theme={null}
  #!/usr/bin/env python

  print('If you get error "ImportError: No module named requests", please install it:\n$ sudo pip install requests');
  import requests
  import json


  data = {'ip':'1.2.1.2','domain':'example.com','ms':60000}
  r = requests.post('http://127.0.0.1:22999/api/proxies/{PORT}/banip', data=json.dumps(data))

  print(r.content)
  ```
</RequestExample>


# Ban multiple IPs (array)
Source: https://docs.brightdata.com/api-reference/proxy-manager/ban_ips_array_

Use the Bright Data Proxy Manager API to ban multiple IPs (array). Endpoint: POST /api/proxies/{PORT}/banips on port 22999.

**API endpoint:** `POST` `/api/proxies/{PORT}/banips`

## Path Parameter

<ParamField type="string">
  Existing proxy port number
</ParamField>

## `POST` body

<ParamField type="array">
  IPs to ban. e.g. \["10.0.0.1","20.0.0.1"]
</ParamField>

<ParamField type="string">
  Ban the IP for sending requests to the specified domain
</ParamField>

<ParamField type="integer">
  Ban the IP for specified milliseconds
</ParamField>

<RequestExample>
  ```sh Shell theme={null}
  curl "http://127.0.0.1:22999/api/proxies/{PORT}/banips" -H "Content-Type: application/json" -d '{"ips":["10.0.0.1","20.0.0.1"],"domain":"example.com","ms":60000}'
  ```

  ```js NodeJS theme={null}
  #!/usr/bin/env node
  (async () => {
    const response = await fetch('http://127.0.0.1:22999/api/proxies/{PORT}/banips', {
      method: 'POST',
      headers: { 'Content-Type': 'application/json' },
      body: JSON.stringify({'ips':['10.0.0.1','20.0.0.1'],'domain':'example.com','ms':60000}),
    });
    const data = await response.text();
    console.log(data);
  })();
  ```

  ```java Java theme={null}
  package example;


  import org.apache.http.HttpHost;
  import org.apache.http.client.fluent.\*;


  public class Example {

    public static void main(String[] args) throws Exception {

      String body = "{\"ips\":[\"10.0.0.1\",\"20.0.0.1\"],\"domain\":\"example.com\",\"ms\":60000}";
      String res = Executor.newInstance()
          .execute(Request.Post("http://127.0.0.1:22999/api/proxies/{PORT}/banips")
          .bodyString(body, ContentType.APPLICATION_JSON))
          .returnContent().asString();
      System.out.println(res)
    }
  }
  ```

  ```cs C# theme={null}
  using System;
  using System.Net;
  using System.Net.Http;
  using System.Net.Http.Headers;
   

  public class Program {
    public static async Task Main() {
      var client = new HttpClient();
      var requestMessage = new HttpRequestMessage {
        Method = HttpMethod.Post,
       RequestUri = new Uri("http://127.0.0.1:22999/api/proxies/{PORT}/banips"),
       Content = new StringContent(JsonConvert.SerializeObject(new {
         ips = [ "10.0.0.1","20.0.0.1" ],
         domain = "example.com",
         ms = 60000
       }), Encoding.UTF8, "application/json")
      };
      var response = await client.SendAsync(requestMessage);
      var responseString = await response.Content.ReadAsStringAsync();
      Console.WriteLine(responseString);

    }
  }

   
  ```

  ```python Python theme={null}
  #!/usr/bin/env python

  print('If you get error "ImportError: No module named requests", please install it:\n$ sudo pip install requests');

  import requests
  import json


  data = {'ips':['10.0.0.1','20.0.0.1'],'domain':'example.com','ms':60000}
  r = requests.post('http://127.0.0.1:22999/api/proxies/{PORT}/banips', data=json.dumps(data))

  print(r.content)
  ```
</RequestExample>


# Create new proxy port
Source: https://docs.brightdata.com/api-reference/proxy-manager/create_a_new_proxy_port

Use the Bright Data Proxy Manager API to create new Proxy Port. Calls POST /api/proxies on the local Proxy Manager port 22999.

**API endpoint:** `POST` `/api/proxies`

## `POST` body

<ParamField type="User Object">
  <Expandable title="properties">
    <ParamField type="integer">
      Port for the HTTP proxy
    </ParamField>

    <ParamField type="string">
      Set to `persist` to save proxy into the configuration file.
    </ParamField>

    <ParamField type="integer">
      Multiply the port definition given number of times
    </ParamField>

    <ParamField type="boolean" />

    <ParamField type="array">
      List of `user`s `[string]`. This option has to be used along with `multiply_users`
    </ParamField>

    <ParamField type="boolean">
      Enable SSL analyzing
    </ParamField>

    <ParamField type="string">
      Choose the SSL library

      | value      | description      |
      | ---------- | ---------------- |
      | `open_ssl` | Open SSL Library |
      | `flex_tls` | Flex TLS Library |
    </ParamField>

    <ParamField type="string">
      Interface or IP to listen on
    </ParamField>

    <ParamField type="string">
      Customer name
    </ParamField>

    <ParamField type="string">
      Zone name
    </ParamField>

    <ParamField type="string">
      Zone password
    </ParamField>

    <ParamField type="string">
      Hostname or IP of super proxy
    </ParamField>

    <ParamField type="integer">
      Super proxy port
    </ParamField>

    <ParamField type="string">
      Determines what kind of connection will be used between Proxy Manager and Super Proxy

      |         |   |
      | ------- | - |
      | `http`  |   |
      | `https` |   |
      | `socks` |   |
    </ParamField>

    <ParamField type="integer">
      Automatically retry on super proxy failure
    </ParamField>

    <ParamField type="boolean">
      Enable SSL connection/analyzing to insecure hosts
    </ParamField>

    <ParamField type="string">
      Country
    </ParamField>

    <ParamField type="string">
      State
    </ParamField>

    <ParamField type="string">
      City
    </ParamField>

    <ParamField type="string">
      ASN
    </ParamField>

    <ParamField type="string">
      Data Center IP
    </ParamField>

    <ParamField type="integer">
      gIP
    </ParamField>

    <ParamField type="array">
      A list of proxies from external vendors. Format: \[username:password@]ip\[:port]

      * proxy\[string]
    </ParamField>

    <ParamField type="string">
      Default username for external vendor ips
    </ParamField>

    <ParamField type="string">
      Default password for external vendor ips
    </ParamField>

    <ParamField type="integer">
      Default port for external vendor ips
    </ParamField>

    <ParamField type="string">
      DNS resolving

      |          |   |
      | -------- | - |
      | `local`  |   |
      | `remote` |   |
    </ParamField>

    <ParamField type="boolean">
      Process reverse lookup via DNS
    </ParamField>

    <ParamField type="string">
      Process reverse lookup via file
    </ParamField>

    <ParamField type="array">
      Process reverse lookup via value
    </ParamField>

    <ParamField type="string">
      Session for all proxy requests
    </ParamField>

    <ParamField type="boolean">
      Use session per requesting host to maintain IP per host
    </ParamField>

    <ParamField type="integer" />

    <ParamField type="boolean">
      Session pool size
    </ParamField>

    <ParamField type="integer">
      Throttle requests above given number
    </ParamField>

    <ParamField type="array">
      Proxy request rules
    </ParamField>

    <ParamField type="string">
      Block or allow requests to be automatically sent through super proxy on error
    </ParamField>

    <ParamField type="array" />

    <ParamField type="string" />

    <ParamField type="string">
      Operating System of the Peer IP
    </ParamField>

    <ParamField type="array">
      Request headers
    </ParamField>

    * name\[string]
    * value\[string]

    <ParamField type="string">
      Request debug info

      |        |   |
      | ------ | - |
      | `full` |   |
      | `none` |   |
    </ParamField>

    <ParamField type="string">
      x-lpm-authorization header
    </ParamField>

    <ParamField type="boolean" />

    <ParamField type="integer" />

    <ParamField type="boolean" />

    <ParamField type="boolean" />

    <ParamField type="integer" />

    <ParamField type="string" />

    <ParamField type="boolean">
      Unblocker Mobile UA
    </ParamField>

    <ParamField type="string">
      Timezone ID to be used by the browser
    </ParamField>

    <ParamField type="string">
      Browser screen size
    </ParamField>

    <ParamField type="string">
      WebRTC plugin behavior in the browser
    </ParamField>

    <ParamField type="object">
      BW limit params

      * days \[integer]
      * bytes \[integer]
      * renewable\[boolean] - Renew limit of bytes each period or use single period and stop usage once last day of period is reached. Default is true
    </ParamField>
  </Expandable>
</ParamField>

<ParamField type="boolean" />

<ResponseExample>
  ```JSON Sample Response theme={null}
  {
  	"port":24000,
  	"zone":"zone_name",
  	"proxy_type":"persist",
  	"customer":"customer_id",
  	"password":"password",
  	"whitelist_ips":[]
  }
  ```
</ResponseExample>

<RequestExample>
  ```sh Shell theme={null}
  curl "http://127.0.0.1:22999/api/proxies" -H "Content-Type: application/json" -d '{"proxy":{"port":24000,"zone":"ZONE","proxy_type":"persist","customer":"CUSTOMER","password":"password","whitelist_ips":[]}}'
  ```

  ```js NodeJS theme={null}
  #!/usr/bin/env node

  (async () => {
    const response = await fetch('http://127.0.0.1:22999/api/proxies', {
      method: 'POST',
      headers: { 'Content-Type': 'application/json' },
      body: JSON.stringify({'proxy':{'port':24000,'zone': 'ZONE','proxy_type':'persist','customer':'CUSTOMER','password':'password','whitelist_ips':[]}}),
    });
    const data = await response.text();
    console.log(data);
  })();
  ```

  ```java Java theme={null}
  package example;

  import org.apache.http.HttpHost;
  import org.apache.http.client.fluent.*;


  public class Example {
    public static void main(String[] args) throws Exception {
     String body = "{\"proxy\":{\"port\":24000,\"zone\":\"ZONE\",\"proxy_type\":\"persist\",\"customer\":\"CUSTOMER\",\"password\":\"password\",\"whitelist_ips\":[]}}";
      String res = Executor.newInstance()
       .execute(Request.Post("http://127.0.0.1:22999/api/proxies")
       .bodyString(body, ContentType.APPLICATION_JSON))
       .returnContent().asString();
      System.out.println(res)
    }
  }
  ```
</RequestExample>


# Delete a proxy port
Source: https://docs.brightdata.com/api-reference/proxy-manager/delete_a_proxy_port

Use the Bright Data Proxy Manager API to delete a Proxy Port. Calls DELETE /api/proxies/{PORT} on the local Proxy Manager port 22999.

**API endpoint:** `DELETE` `/api/proxies/{PORT}`

## Path Parameter

<ParamField type="string">
  Existing proxy port number
</ParamField>

<RequestExample>
  ```sh Shell theme={null}
  curl -X DELETE "http://127.0.0.1:22999/api/proxies/{PORT}"
  ```

  ```js NodeJS theme={null}
  #!/usr/bin/env node

  (async () => {
    const response = await fetch('http://127.0.0.1:22999/api/proxies/{PORT}', {
      method: 'DELETE',

    });
    const data = await response.text();
    console.log(data);
  })();
  ```

  ```java Java theme={null}
  package example;


  import org.apache.http.HttpHost;
  import org.apache.http.client.fluent.*;


  public class Example {

    public static void main(String[] args) throws Exception {

      String res = Executor.newInstance()

       .execute(Request.Delete("http://127.0.0.1:22999/api/proxies/{PORT}"))

       .returnContent().asString();

   

      System.out.println(res)

    }

  }
  ```

  ```cs C# theme={null}
  using System;
  using System.Net;
  using System.Net.Http;
  using System.Net.Http.Headers;


  public class Program {

    public static async Task Main() {

      var client = new HttpClient();

      var requestMessage = new HttpRequestMessage {

        Method = HttpMethod.Delete,

       RequestUri = new Uri("http://127.0.0.1:22999/api/proxies/{PORT}")

      };

      var response = await client.SendAsync(requestMessage);

      var responseString = await response.Content.ReadAsStringAsync();

      Console.WriteLine(responseString);

    }

  }
  ```

  ```python Python theme={null}
  #!/usr/bin/env python

  print('If you get error "ImportError: No module named requests", please install it:\n$ sudo pip install requests');

  import requests

  r = requests.delete('http://127.0.0.1:22999/api/proxies/{PORT}')

  print(r.content)

  ```
</RequestExample>


# Delete proxy ports (multiple)
Source: https://docs.brightdata.com/api-reference/proxy-manager/delete_proxy_ports

Bright Data Proxy Manager API endpoint to delete Proxy Ports (multiple). Endpoint: POST /api/proxies/delete on port 22999.

**API endpoint:** `POST /api/proxies/delete`

## `POST` body

<ParamField type="array">
  Array of ports
</ParamField>

<RequestExample>
  ```sh Shell theme={null}
  curl "http://127.0.0.1:22999/api/proxies/delete" -H "Content-Type: application/json" -d '{"ports":[24000,24001]}'
  ```

  ```js NodeJS theme={null}
  #!/usr/bin/env node

  (async () => {
    const response = await fetch('http://127.0.0.1:22999/api/proxies/delete', {
      method: 'POST',
      headers: { 'Content-Type': 'application/json' },
      body: JSON.stringify({'ports':[24000,24001]}),
    });
    const data = await response.text();
    console.log(data);
  })();
  ```

  ```java Java theme={null}
  package example;

  import org.apache.http.HttpHost;

  import org.apache.http.client.fluent.\*;

   

  public class Example {

    public static void main(String[] args) throws Exception {

     String body = "{\"ports\":[24000,24001]}";

      String res = Executor.newInstance()

       .execute(Request.Post("http://127.0.0.1:22999/api/proxies/delete")

       .bodyString(body, ContentType.APPLICATION_JSON))

       .returnContent().asString();

   

      System.out.println(res)

    }

  }
  ```

  ```cs C# theme={null}
  using System;

  using System.Net;

  using System.Net.Http;

  using System.Net.Http.Headers;

   

  public class Program {

    public static async Task Main() {

      var client = new HttpClient();

      var requestMessage = new HttpRequestMessage {

        Method = HttpMethod.Post,

       RequestUri = new Uri("http://127.0.0.1:22999/api/proxies/delete"),

       Content = new StringContent(JsonConvert.SerializeObject(new {

         ports = [ 24000, 24001 ]

       }), Encoding.UTF8, "application/json")

      };

      var response = await client.SendAsync(requestMessage);

      var responseString = await response.Content.ReadAsStringAsync();

      Console.WriteLine(responseString);

    }

  }
  ```

  ```python Python theme={null}
  #!/usr/bin/env python

  print('If you get error "ImportError: No module named requests", please install it:\n$ sudo pip install requests');

  import requests
  import json


  data = {'ports':[24000,24001]}

  r = requests.post('http://127.0.0.1:22999/api/proxies/delete', data=json.dumps(data))

  print(r.content)
  ```
</RequestExample>


# Enable SSL analyzing (all ports)
Source: https://docs.brightdata.com/api-reference/proxy-manager/enable_ssl_analyzing_on_all_proxy_ports

Bright Data Proxy Manager API endpoint to enable SSL Analyzing (All Ports). Endpoint: POST /api/enable_ssl on port 22999.

**API endpoint:** `POST` `/api/enable_ssl`

<RequestExample>
  ```sh theme={null}
  curl -X POST "http://127.0.0.1:22999/api/enable_ssl"
  ```

  ```js NodeJS theme={null}
  #!/usr/bin/env node

  (async () => {
    const response = await fetch('http://127.0.0.1:22999/api/enable_ssl', {
      method: 'POST',

    });
    const data = await response.text();
    console.log(data);
  })();
  ```

  ```java Java theme={null}
  package example;

  import org.apache.http.HttpHost;
  import org.apache.http.client.fluent.*;


  public class Example {
    public static void main(String[] args) throws Exception {
      String res = Executor.newInstance()
       .execute(Request.Post("http://127.0.0.1:22999/api/enable_ssl"))
       .returnContent().asString();
      System.out.println(res)
    }

  }
  ```

  ```cs C# theme={null}
  using System;
  using System.Net;
  using System.Net.Http;
  using System.Net.Http.Headers;

   

  public class Program {
    public static async Task Main() {
      var client = new HttpClient();
      var requestMessage = new HttpRequestMessage {
        Method = HttpMethod.Post,
       RequestUri = new Uri("http://127.0.0.1:22999/api/enable_ssl")
      };

      var response = await client.SendAsync(requestMessage);
      var responseString = await response.Content.ReadAsStringAsync();
      Console.WriteLine(responseString);

    }

  }
  ```

  ```python Python theme={null}
  #!/usr/bin/env python

  print('If you get error "ImportError: No module named requests", please install it:\n$ sudo pip install requests');

  import requests

  r = requests.post('http://127.0.0.1:22999/api/enable_ssl')

  print(r.content)
  ```
</RequestExample>


# Generate API key
Source: https://docs.brightdata.com/api-reference/proxy-manager/generate_token_for_token_based_authentication

Generate a Bright Data Proxy Manager API key for token-based authentication. Endpoint: GET /api/gen_token on port 22999.

**API endpoint:** `GET` `/api/gen_token`

<ResponseExample>
  ```json Sample Response theme={null}
  {
      "token": "RZD9vaQQaL6En7"
  }
  ```
</ResponseExample>

<RequestExample>
  ```sh Shell theme={null}
  curl "http://127.0.0.1:22999/api/gen_token"
  ```

  ```js NodeJS theme={null}
  #!/usr/bin/env node

  (async () => {
    const response = await fetch('http://127.0.0.1:22999/api/gen_token');
    const data = await response.text();
    console.log(data);
  })();
  ```

  ```java Java theme={null}
  package example;


  import org.apache.http.HttpHost;
  import org.apache.http.client.fluent.*;


  public class Example {

    public static void main(String[] args) throws Exception {

      String res = Executor.newInstance()

       .execute(Request.Get("http://127.0.0.1:22999/api/gen_token"))

       .returnContent().asString();

      System.out.println(res)

    }

  }
  ```

  ```cs C# theme={null}
  using System;
  using System.Net;
  using System.Net.Http;
  using System.Net.Http.Headers;


  public class Program {
      public static async Task Main() {

          var client = new HttpClient();
          var requestMessage = new HttpRequestMessage {
              Method = HttpMethod.Get,
              RequestUri = new Uri("http://127.0.0.1:22999/api/gen_token")
          };

          var response = await client.SendAsync(requestMessage);
          var responseString = await response.Content.ReadAsStringAsync();

          Console.WriteLine(responseString);
      }
  }
  ```

  ```python Python theme={null}
  #!/usr/bin/env python

  print('If you get error "ImportError: No module named requests", please install it:\n$ sudo pip install requests');

  import requests


  r = requests.get('http://127.0.0.1:22999/api/gen_token')

  print(r.content)
  ```
</RequestExample>


# Get all users
Source: https://docs.brightdata.com/api-reference/proxy-manager/get_all_users

Use the Bright Data Proxy Manager API to get all users. Updates the local Proxy Manager (default port 22999) configuration and returns a JSON status.

**API endpoint:** `GET` `/api/lpm_users`

<ResponseExample>
  ```JSON Sample Response theme={null}
  [
      {
          "email": "test@example.com",
          "password":"password"
      }
  ]
  ```
</ResponseExample>

<RequestExample>
  ```sh Shell theme={null}
  curl "http://127.0.0.1:22999/api/lpm_users"
  ```

  ```js NodeJS theme={null}
  #!/usr/bin/env node

  (async () => {
    const response = await fetch('http://127.0.0.1:22999/api/lpm_users');
    const data = await response.text();
    console.log(data);
  })();
  ```

  ```java Java theme={null}
  package example;


  import org.apache.http.HttpHost;
  import org.apache.http.client.fluent.*;


  public class Example {
      public static void main(String[] args) throws Exception {
      String res = Executor.newInstance().execute(
          Request.Get("http://127.0.0.1:22999/api/lpm_users")
      ).returnContent().asString();

      System.out.println(res)
  }

  }
  ```

  ```cs C# theme={null}
  using System;
  using System.Net;
  using System.Net.Http;
  using System.Net.Http.Headers;


  public class Program {
      public static async Task Main() {

          var client = new HttpClient();
          var requestMessage = new HttpRequestMessage {
              Method = HttpMethod.Get,
              RequestUri = new Uri("http://127.0.0.1:22999/api/lpm_users")
          };

          var response = await client.SendAsync(requestMessage);
          var responseString = await response.Content.ReadAsStringAsync();

          Console.WriteLine(responseString);
      }
  }
  ```

  ```python Python theme={null}
  #!/usr/bin/env python

  print('If you get error "ImportError: No module named requests", please install it:\n$ sudo pip install requests');

  import requests


  r = requests.get('http://127.0.0.1:22999/api/lpm_users')

  print(r.content)
  ```
</RequestExample>


# Get allocated gIPs in a zone
Source: https://docs.brightdata.com/api-reference/proxy-manager/get_allocated_gips_in_zone

Bright Data Proxy Manager API endpoint to get allocated gIPs in a zone. Endpoint: GET /api/allocated_vips on port 22999.

**API endpoint:** `GET` `/api/allocated_vips`

## Query Parameter

<ParamField type="string">
  Residential/Mobile exclusive zone name
</ParamField>

<ResponseExample>
  ```json Sample Response theme={null}
  {
      "ips": [
          "gIP_1",
          "gIP_2"
      ]
  }
  ```
</ResponseExample>

<RequestExample>
  ```sh Shell theme={null}
  curl "http://127.0.0.1:22999/api/allocated_vips?zone=ZONE"
  ```

  ```js NodeJS theme={null}
  #!/usr/bin/env node

  (async () => {
    const response = await fetch('http://127.0.0.1:22999/api/allocated_vips?zone=ZONE');
    const data = await response.text();
    console.log(data);
  })();
  ```

  ```java Java theme={null}
  package example;


  import org.apache.http.HttpHost;
  import org.apache.http.client.fluent.*;

  public class Example {
    public static void main(String[] args) throws Exception {
      String res = Executor.newInstance()
       .execute(Request.Get("http://127.0.0.1:22999/api/allocated_vips?zone=ZONE"))
       .returnContent().asString();
      System.out.println(res)
    }
  }
  ```

  ```cs C# theme={null}
  using System;
  using System.Net;
  using System.Net.Http;
  using System.Net.Http.Headers;


  public class Program {
    public static async Task Main() {
      var client = new HttpClient();
      var requestMessage = new HttpRequestMessage {
        Method = HttpMethod.Get,
       RequestUri = new Uri("http://127.0.0.1:22999/api/allocated_vips?zone=ZONE")
      };

      var response = await client.SendAsync(requestMessage);
      var responseString = await response.Content.ReadAsStringAsync();

      Console.WriteLine(responseString);
    }
  }
  ```

  ```python Python theme={null}
  #!/usr/bin/env python

  print('If you get error "ImportError: No module named requests", please install it:\n$ sudo pip install requests');

  import requests

   

  r = requests.get('http://127.0.0.1:22999/api/allocated_vips?zone=ZONE')

  print(r.content)
  ```
</RequestExample>


# Get allocated IPs in a zone
Source: https://docs.brightdata.com/api-reference/proxy-manager/get_allocated_ips_in_zone

Use the Bright Data Proxy Manager API to get allocated IPs in a zone. Calls GET /api/allocated_ips on the local Proxy Manager port 22999.

**API endpoint:** `GET` `/api/allocated_ips`

## Query Parameter

<ParamField type="string">
  Static (Datacenter/ISP) zone name
</ParamField>

<ResponseExample>
  ```JSON Sample Response theme={null}
  {
      "ips": [
          "10.0.0.1",
          "20.0.0.1"
      ]
  }
  ```
</ResponseExample>

<RequestExample>
  ```sh Shell theme={null}
  curl "http://127.0.0.1:22999/api/allocated_ips?zone=ZONE"
  ```

  ```js NodeJS theme={null}
  #!/usr/bin/env node

  (async () => {
    const response = await fetch('http://127.0.0.1:22999/api/allocated_ips?zone=ZONE');
    const data = await response.text();
    console.log(data);
  })();
  ```

  ```java Java theme={null}
  package example;

   

  import org.apache.http.HttpHost;

  import org.apache.http.client.fluent.*;

   

  public class Example {

    public static void main(String[] args) throws Exception {

      String res = Executor.newInstance()

       .execute(Request.Get("http://127.0.0.1:22999/api/allocated_ips?zone=ZONE"))

       .returnContent().asString();

      System.out.println(res)

    }

  }
  ```

  ```cs C# theme={null}
  using System;
  using System.Net;
  using System.Net.Http;
  using System.Net.Http.Headers;


  public class Program {

    public static async Task Main() {

      var client = new HttpClient();

      var requestMessage = new HttpRequestMessage {

        Method = HttpMethod.Get,

       RequestUri = new Uri("http://127.0.0.1:22999/api/allocated_ips?zone=ZONE")

      };

      var response = await client.SendAsync(requestMessage);

      var responseString = await response.Content.ReadAsStringAsync();

      Console.WriteLine(responseString);

    }

  }

  ```

  ```python Python theme={null}
  #!/usr/bin/env python

  print('If you get error "ImportError: No module named requests", please install it:\n$ sudo pip install requests');

  import requests


  r = requests.get('http://127.0.0.1:22999/api/allocated_ips?zone=ZONE')

  print(r.content)
  ```
</RequestExample>


# Get banned IPs
Source: https://docs.brightdata.com/api-reference/proxy-manager/get_banned_ips

Use the Bright Data Proxy Manager API to get Banned IPs. Calls GET /api/banlist/{PORT} on the local Proxy Manager port 22999.

**API endpoint:** `GET` `/api/banlist/{PORT}`

<ParamField type="boolean">
  `full=true` parameter is optional and can be used to provide additional details about each entry in the ban-list
</ParamField>

<ResponseExample>
  ```JSON Sample Response theme={null}
  {
      "ips": [
          "10.20.30.40",
          "50.60.70.80|example.com"
      ]
  }
  ```
</ResponseExample>

<RequestExample>
  ```sh Shell theme={null}
  curl "http://127.0.0.1:22999/api/banlist/{PORT}?full=true"
  ```

  ```js NodeJS theme={null}
  #!/usr/bin/env node

  (async () => {
    const response = await fetch('http://127.0.0.1:22999/api/banlist/{PORT}?full=true');
    const data = await response.text();
    console.log(data);
  })();
  ```

  ```java Java theme={null}
  package example;


  import org.apache.http.HttpHost;
  import org.apache.http.client.fluent.*;

  public class Example {
    public static void main(String[] args) throws Exception {
      String res = Executor.newInstance()
       .execute(Request.Get("http://127.0.0.1:22999/api/banlist/{PORT}?full=true"))
       .returnContent().asString();
      System.out.println(res)
    }

  }
  ```

  ```cs C# theme={null}
  using System;
  using System.Net;
  using System.Net.Http;
  using System.Net.Http.Headers;
   

  public class Program {

    public static async Task Main() {

      var client = new HttpClient();

      var requestMessage = new HttpRequestMessage {

        Method = HttpMethod.Get,

       RequestUri = new Uri("http://127.0.0.1:22999/api/banlist/{PORT}?full=true")

      };

      var response = await client.SendAsync(requestMessage);

      var responseString = await response.Content.ReadAsStringAsync();

      Console.WriteLine(responseString);

    }

  }
  ```

  ```python Python theme={null}
  #!/usr/bin/env python

  print('If you get error "ImportError: No module named requests", please install it:\n$ sudo pip install requests');

  import requests

   

  r = requests.get('http://127.0.0.1:22999/api/banlist/{PORT}?full=true')

  print(r.content)
  ```
</RequestExample>


# Get current NodeJS version
Source: https://docs.brightdata.com/api-reference/proxy-manager/get_currently_running_nodejs_version

Use the Bright Data Proxy Manager API to get current NodeJS version. Calls GET /api/node_version on the local Proxy Manager port 22999.

**API endpoint:** `GET` `/api/node_version`

<ResponseExample>
  ```JSON Sample Response theme={null}
  {
      "current": {
          "options": {
              "loose": false,
              "includePrerelease":false
          },
          "loose": false,
          "raw":"v12.16.1\n",
          "major":12,
          "minor":16,
          "patch":1,
          "prerelease":[],
          "build":[],
          "version":"12.16.1"
      },
      "satisfied": true,
      "recommended": ">=10.0"
  }
  ```
</ResponseExample>


# Get effective config of running proxies
Source: https://docs.brightdata.com/api-reference/proxy-manager/get_effective_configuration_for_all_running_proxies

Bright Data Proxy Manager API endpoint to get effective config of running proxies. Endpoint: GET /api/proxies_running on port 22999.

**API endpoint:** `GET` `/api/proxies_running`

<ResponseExample>
  ```JSON Sample Response theme={null}
  [
      {
          "port": 24000,
          "zone": "ZONE",
          "proxy_type": "persist",
          "customer": "CUSTOMER",
          "password": "password",
          "whitelist_ips":[]
      }
  ]
  ```
</ResponseExample>

<RequestExample>
  ```sh Shell theme={null}
  curl "http://127.0.0.1:22999/api/proxies_running"
  ```

  ```js NodeJS theme={null}
  #!/usr/bin/env node

  (async () => {
    const response = await fetch('http://127.0.0.1:22999/api/proxies_running');
    const data = await response.text();
    console.log(data);
  })();
  ```

  ```java Java theme={null}
  package example;

   

  import org.apache.http.HttpHost;

  import org.apache.http.client.fluent.\*;

   

  public class Example {

    public static void main(String[] args) throws Exception {

      String res = Executor.newInstance()

       .execute(Request.Get("http://127.0.0.1:22999/api/proxies_running"))

       .returnContent().asString();

      System.out.println(res)

    }

  }
  ```

  ```cs C# theme={null}
  using System;
  using System.Net;
  using System.Net.Http;
  using System.Net.Http.Headers;

  public class Program {
    public static async Task Main() {
      var client = new HttpClient();
      var requestMessage = new HttpRequestMessage {
        Method = HttpMethod.Get,
       RequestUri = new Uri("http://127.0.0.1:22999/api/proxies_running")
      };

      var response = await client.SendAsync(requestMessage);
      var responseString = await response.Content.ReadAsStringAsync();

      Console.WriteLine(responseString);
    }
  }
  ```

  ```python Python theme={null}
  #!/usr/bin/env python

  print('If you get error "ImportError: No module named requests", please install it:\n$ sudo pip install requests');

  import requests


  r = requests.get('http://127.0.0.1:22999/api/proxies_running')

  print(r.content)
  ```
</RequestExample>


# Get enabled zone's configuration
Source: https://docs.brightdata.com/api-reference/proxy-manager/get_enabled_zones_configuration

Bright Data Proxy Manager API endpoint to get enabled Zone's configuration. Calls GET /api/zones on the local Proxy Manager port 22999.

**API endpoint:** `GET` `/api/zones`

<ResponseExample>
  ```JSON Sample Response theme={null}
  {
      "name": "ZONE",
      "perm": "country ip route_all route_dedicated",
      "plan": {},
      "password":"password"
  }
  ```
</ResponseExample>

<RequestExample>
  ```sh Shell theme={null}
  curl "http://127.0.0.1:22999/api/zones"
  ```

  ```js NodeJS theme={null}
  #!/usr/bin/env node

  (async () => {
    const response = await fetch('http://127.0.0.1:22999/api/zones');
    const data = await response.text();
    console.log(data);
  })();
  ```

  ```java Java theme={null}
  package example;


  import org.apache.http.HttpHost;
  import org.apache.http.client.fluent.*;


  public class Example {

    public static void main(String[] args) throws Exception {

      String res = Executor.newInstance()

       .execute(Request.Get("http://127.0.0.1:22999/api/zones"))

       .returnContent().asString();

      System.out.println(res)

    }

  }
  ```

  ```cs C# theme={null}
  using System;
  using System.Net;
  using System.Net.Http;
  using System.Net.Http.Headers;


  public class Program {
      public static async Task Main() {
          var client = new HttpClient();
          var requestMessage = new HttpRequestMessage {
              Method = HttpMethod.Get,
              RequestUri = new Uri("http://127.0.0.1:22999/api/zones")
          };

      var response = await client.SendAsync(requestMessage);
      var responseString = await response.Content.ReadAsStringAsync();

      Console.WriteLine(responseString);
      }
  }
  ```

  ```python Python theme={null}
  #!/usr/bin/env python


  import requests


  r = requests.get('http://127.0.0.1:22999/api/zones')

  print(r.content)
  ```
</RequestExample>


# Get explicit config of proxies
Source: https://docs.brightdata.com/api-reference/proxy-manager/get_explicit_configuration_of_all_or_specified_proxies

Bright Data Proxy Manager API endpoint to get explicit config of proxies. Endpoint: GET /api/proxies/{PORT} on port 22999.

**API endpoint:** `GET` `/api/proxies/{PORT}`

<ParamField type="string">
  PORT parameter is optional. You can skip it to fetch all the proxies\*
</ParamField>

<ResponseExample>
  ```JSON Sample Response theme={null}
  [
      {"port": 24000,
      "zone": "ZONE",
      "proxy_type": "persist",
      "customer": "CUSTOMER",
      "password": "password",
      "whitelist_ips": []
      },
      {
          "port": 44445,
          "zone": "ZONE",
          "listen_port": 44445,
          "customer": "CUSTOMER",
          "password":"password"
      }
  ]
  ```
</ResponseExample>

<RequestExample>
  ```sh Shell theme={null}
  curl "http://127.0.0.1:22999/api/proxies/{PORT}"
  ```

  ```js NodeJS theme={null}
  #!/usr/bin/env node

  (async () => {
    const response = await fetch('http://127.0.0.1:22999/api/proxies/{PORT}');
    const data = await response.text();
    console.log(data);
  })();
  ```

  ```java Java theme={null}
  package example;

   

  import org.apache.http.HttpHost;
  import org.apache.http.client.fluent.*;

   

  public class Example {

    public static void main(String[] args) throws Exception {

      String res = Executor.newInstance()

       .execute(Request.Get("http://127.0.0.1:22999/api/proxies/{PORT}"))

       .returnContent().asString();

      System.out.println(res)

    }

  }
  ```

  ```cs C# theme={null}
  using System;

  using System.Net;

  using System.Net.Http;

  using System.Net.Http.Headers;

   

  public class Program {

    public static async Task Main() {

      var client = new HttpClient();

      var requestMessage = new HttpRequestMessage {

        Method = HttpMethod.Get,

       RequestUri = new Uri("http://127.0.0.1:22999/api/proxies/{PORT}")

      };

      var response = await client.SendAsync(requestMessage);

      var responseString = await response.Content.ReadAsStringAsync();

      Console.WriteLine(responseString);

    }

  }
  ```

  ```python Python theme={null}
  #!/usr/bin/env python

  print('If you get error "ImportError: No module named requests", please install it:\n$ sudo pip install requests');

  import requests

   

  r = requests.get('http://127.0.0.1:22999/api/proxies/{PORT}')

  print(r.content)
  ```
</RequestExample>


# Get general settings
Source: https://docs.brightdata.com/api-reference/proxy-manager/get_general_settings

Use the Bright Data Proxy Manager API to get general settings. Calls GET /api/settings on the local Proxy Manager port 22999.

**API endpoint:** `GET` `/api/settings`

<ResponseExample>
  ```JSON Sample Response theme={null}
  {
      "customer": "CUSTOMER",
      "zone": "ZONE",
      "password": "password",
      "www_whitelist_ips": [],
      "whitelist_ips": [],
      "fixed_whitelist_ips": [],
      "read_only": false,
      "config": "/home/user/proxy_manager/.luminati.json",
      "test_url":"http://brdtest.com/myip.json",
      "logs":1000,
      "log":"notice",
      "har_limit": 1024,
      "request_stats": true,
      "dropin": true,
      "pending_ips": [],
      "pending_www_ips": [],
      "zagent": false,
      "sync_config": true
  }
  ```
</ResponseExample>

<RequestExample>
  ```sh Shell theme={null}
  curl "http://127.0.0.1:22999/api/settings"
  ```

  ```js NodeJS theme={null}
  #!/usr/bin/env node

  (async () => {
    const response = await fetch('http://127.0.0.1:22999/api/settings');
    const data = await response.text();
    console.log(data);
  })();
  ```

  ```java Java theme={null}
  package example;

  import org.apache.http.HttpHost;
  import org.apache.http.client.fluent.*;
   

  public class Example {
    public static void main(String[] args) throws Exception {
      String res = Executor.newInstance()
       .execute(Request.Get("http://127.0.0.1:22999/api/settings"))
       .returnContent().asString();
      System.out.println(res)
    }
  }
  ```

  ```cs C# theme={null}
  using System;
  using System.Net;
  using System.Net.Http;
  using System.Net.Http.Headers;

   

  public class Program {

    public static async Task Main() {

      var client = new HttpClient();

      var requestMessage = new HttpRequestMessage {

        Method = HttpMethod.Get,

       RequestUri = new Uri("http://127.0.0.1:22999/api/settings")

      };

      var response = await client.SendAsync(requestMessage);

      var responseString = await response.Content.ReadAsStringAsync();

      Console.WriteLine(responseString);

    }

  }
  ```

  ```python Python theme={null}
  #!/usr/bin/env python

  print('If you get error "ImportError: No module named requests", please install it:\n$ sudo pip install requests');

  import requests

   

  r = requests.get('http://127.0.0.1:22999/api/settings')

  print(r.content)
  ```
</RequestExample>


# Get HAR logs
Source: https://docs.brightdata.com/api-reference/proxy-manager/get_har_logs

Use the Bright Data Proxy Manager API to get HAR Logs. Updates the local Proxy Manager (default port 22999) configuration and returns a JSON status.

API endpoint: `GET` `/api/logs`

<ParamField type="integar">
  Number of logs to get from tail
</ParamField>

<ParamField type="integar">
  Number of logs to get from tail
</ParamField>

<ParamField type="integar">
  Maximum number of requests to be fetched
</ParamField>

<ParamField type="string">
  regex search query for the URL
</ParamField>

<ParamField type="string">
  lower bound for port number
</ParamField>

<ParamField type="string">
  upper bound for port number
</ParamField>

<ParamField type="string">
  filter requests by status code
</ParamField>

<ParamField type="string">
  parameter to be sorted by
</ParamField>

<ParamField type="boolean">
  is descending sorting direction
</ParamField>

<RequestExample>
  ```sh Shell theme={null}
  curl "http://127.0.0.1:22999/api/logs"
  ```

  ```js NodeJS theme={null}
  #!/usr/bin/env node

  (async () => {
    const response = await fetch('http://127.0.0.1:22999/api/logs');
    const data = await response.text();
    console.log(data);
  })();
  ```

  ```java Java theme={null}
  package example;

  import org.apache.http.HttpHost;
  import org.apache.http.client.fluent.*;


  public class Example {
    public static void main(String[] args) throws Exception {
      String res = Executor.newInstance()
       .execute(Request.Get("http://127.0.0.1:22999/api/logs"))
       .returnContent().asString();
      System.out.println(res)
    }
  }
  ```

  ```cs C# theme={null}
  using System;
  using System.Net;
  using System.Net.Http;
  using System.Net.Http.Headers;

   

  public class Program {

    public static async Task Main() {

      var client = new HttpClient();

      var requestMessage = new HttpRequestMessage {

        Method = HttpMethod.Get,

       RequestUri = new Uri("http://127.0.0.1:22999/api/logs")

      };

      var response = await client.SendAsync(requestMessage);

      var responseString = await response.Content.ReadAsStringAsync();

      Console.WriteLine(responseString);

    }

  }
  ```

  ```python Python theme={null}
  #!/usr/bin/env python

  print('If you get error "ImportError: No module named requests", please install it:\n$ sudo pip install requests');

  import requests

   

  r = requests.get('http://127.0.0.1:22999/api/logs')

  print(r.content)
  ```
</RequestExample>


# Get Proxy Manager version
Source: https://docs.brightdata.com/api-reference/proxy-manager/get_proxy_manager_version

Use the Bright Data Proxy Manager API to get Proxy Manager version. Calls GET /api/version on the local Proxy Manager port 22999.

**API endpoint:** `GET` `/api/version`

<ResponseExample>
  ```json Sample Response theme={null}
  {
    "version":"1.280.385",
    "argv":""
  }
  ```
</ResponseExample>

<RequestExample>
  ```sh Shell theme={null}
  curl "http://127.0.0.1:22999/api/version"
  ```

  ```js NodeJS theme={null}
  #!/usr/bin/env node

  (async () => {
    const response = await fetch('http://127.0.0.1:22999/api/version');
    const data = await response.text();
    console.log(data);
  })();
  ```

  ```java Java theme={null}
  package example;

   
  import org.apache.http.HttpHost;
  import org.apache.http.client.fluent.*;


  public class Example {

    public static void main(String[] args) throws Exception {

      String res = Executor.newInstance()

       .execute(Request.Get("http://127.0.0.1:22999/api/version"))

       .returnContent().asString();

      System.out.println(res)

    }

  }
  ```

  ```cs C#  theme={null}
  using System;
  using System.Net;
  using System.Net.Http;
  using System.Net.Http.Headers;

   

  public class Program {

    public static async Task Main() {

      var client = new HttpClient();

      var requestMessage = new HttpRequestMessage {

        Method = HttpMethod.Get,

       RequestUri = new Uri("http://127.0.0.1:22999/api/version")

      };

      var response = await client.SendAsync(requestMessage);

      var responseString = await response.Content.ReadAsStringAsync();

      Console.WriteLine(responseString);

    }

  }
  ```

  ```python Python theme={null}
  #!/usr/bin/env python

  print('If you get error "ImportError: No module named requests", please install it:\n$ sudo pip install requests');

  import requests

  r = requests.get('http://127.0.0.1:22999/api/version')

  print(r.content)
  ```
</RequestExample>


# Get proxy port status
Source: https://docs.brightdata.com/api-reference/proxy-manager/get_proxy_port_status

Use the Bright Data Proxy Manager API to get Proxy Port Status. Calls GET /api/proxy_status/{PORT} on the local Proxy Manager port 22999.

**API endpoint:** `GET` `/api/proxy_status/{PORT}`

<ParamField type="string">
  Existing proxy port number
</ParamField>

<ResponseExample>
  ```JSON Sample Response theme={null}
  {
      "status":"ok",
      "status_details":[]
  }
  ```
</ResponseExample>

<RequestExample>
  ```sh Shell theme={null}
  curl "http://127.0.0.1:22999/api/proxy_status/{PORT}"
  ```

  ```js NodeJS theme={null}
  #!/usr/bin/env node

  (async () => {
    const response = await fetch('http://127.0.0.1:22999/api/proxy_status/{PORT}');
    const data = await response.text();
    console.log(data);
  })();
  ```

  ```java Java theme={null}
  package example;


  import org.apache.http.HttpHost;
  import org.apache.http.client.fluent.*;


  public class Example {
      public static void main(String[] args) throws Exception {

          String res = Executor.newInstance().execute(
              Request.Get("http://127.0.0.1:22999/api/proxy_status/{PORT}")
          ).returnContent().asString();

          System.out.println(res)
      }
  }
  ```

  ```cs C# theme={null}
  using System;
  using System.Net;
  using System.Net.Http;
  using System.Net.Http.Headers;


  public class Program {
      public static async Task Main() {

          var client = new HttpClient();
          var requestMessage = new HttpRequestMessage {
              Method = HttpMethod.Get,
              RequestUri = new Uri("http://127.0.0.1:22999/api/proxy_status/{PORT}")
          };

          var response = await client.SendAsync(requestMessage);
          var responseString = await response.Content.ReadAsStringAsync();

          Console.WriteLine(responseString);

      }
  }
  ```

  ```python Python theme={null}
  #!/usr/bin/env python

  print('If you get error "ImportError: No module named requests", please install it:\n$ sudo pip install requests');

  import requests

  r = requests.get('http://127.0.0.1:22999/api/proxy_status/{PORT}')

  print(r.content)
  ```
</RequestExample>


# Get recent status
Source: https://docs.brightdata.com/api-reference/proxy-manager/get_recent_stats

Use the Bright Data Proxy Manager API to get Recent Status. Calls GET /api/recent_stats on the local Proxy Manager port 22999.

**API endpoint:** `GET /api/recent_stats`

<ResponseExample>
  ```JSON Sample Response theme={null}
  {
      "ports": {},
      "status_code": [],
      "hostname": [],
      "protocol": [],
      "total": 0,
      "success": 0,
      "ssl_enable":true}
  ```
</ResponseExample>

<RequestExample>
  ```sh Shell theme={null}
  curl "http://127.0.0.1:22999/api/recent_stats"
  ```

  ```js NodeJS theme={null}
  #!/usr/bin/env node

  (async () => {
    const response = await fetch('http://127.0.0.1:22999/api/recent_stats');
    const data = await response.text();
    console.log(data);
  })();
  ```

  ```java Java theme={null}
  package example;


  import org.apache.http.HttpHost;
  import org.apache.http.client.fluent.\*;


  public class Example {
      public static void main(String[] args) throws Exception {

          String res = Executor.newInstance().execute(
              Request.Get("http://127.0.0.1:22999/api/recent_stats")
          ).returnContent().asString();

          System.out.println(res)
      }
  }
  ```

  ```cs C# theme={null}
  using System;
  using System.Net;
  using System.Net.Http;
  using System.Net.Http.Headers;


  public class Program {
      public static async Task Main() {
          var client = new HttpClient();
          var requestMessage = new HttpRequestMessage {
              Method = HttpMethod.Get,
              RequestUri = new Uri("http://127.0.0.1:22999/api/recent_stats")
          };

          var response = await client.SendAsync(requestMessage);
          var responseString = await response.Content.ReadAsStringAsync();
          Console.WriteLine(responseString);
      }
  }
  ```

  ```python Python theme={null}
  #!/usr/bin/env python

  print('If you get error "ImportError: No module named requests", please install it:\n$ sudo pip install requests');

  import requests


  r = requests.get('http://127.0.0.1:22999/api/recent_stats')

  print(r.content)
  ```
</RequestExample>


# Get tail from the log file
Source: https://docs.brightdata.com/api-reference/proxy-manager/get_tail_from_the_log_file

Use the Bright Data Proxy Manager API to get tail from the Log file. Calls GET /api/general_logs on the local Proxy Manager port 22999.

**API endpoint:** `GET` `/api/general_logs`

<ParamField type="integer">
  Number of logs to get from tail
</ParamField>

<RequestExample>
  ```sh Shell theme={null}
  curl "http://127.0.0.1:22999/api/general_logs?limit=5"
  ```

  ```js NodeJS theme={null}
  #!/usr/bin/env node

  (async () => {
    const response = await fetch('http://127.0.0.1:22999/api/general_logs?limit=5');
    const data = await response.text();
    console.log(data);
  })();
  ```

  ```java Java theme={null}
  package example;

   

  import org.apache.http.HttpHost;

  import org.apache.http.client.fluent.\*;

   

  public class Example {

    public static void main(String[] args) throws Exception {

      String res = Executor.newInstance()

       .execute(Request.Get("http://127.0.0.1:22999/api/general_logs?limit=5"))

       .returnContent().asString();

      System.out.println(res)

    }

  }
  ```

  ```cs C# theme={null}
  using System;
  using System.Net;
  using System.Net.Http;
  using System.Net.Http.Headers;



  public class Program {

    public static async Task Main() {

      var client = new HttpClient();

      var requestMessage = new HttpRequestMessage {

        Method = HttpMethod.Get,

       RequestUri = new Uri("http://127.0.0.1:22999/api/general_logs?limit=5")

      };

      var response = await client.SendAsync(requestMessage);

      var responseString = await response.Content.ReadAsStringAsync();

      Console.WriteLine(responseString);

    }

  }
  ```

  ```python Python theme={null}
  #!/usr/bin/env python

  print('If you get error "ImportError: No module named requests", please install it:\n$ sudo pip install requests');

  import requests


  r = requests.get('http://127.0.0.1:22999/api/general_logs?limit=5')

  print(r.content)
  ```
</RequestExample>


# Get the latest Proxy Manager (PM) version
Source: https://docs.brightdata.com/api-reference/proxy-manager/get_the_latest_proxy_manager_versions

Use the Bright Data Proxy Manager API to get the latest Proxy Manager (PM) version. Endpoint: GET /api/last_version on port 22999.

**API endpoint:** `GET` `/api/last_version`

<ResponseExample>
  ```json Sample Response theme={null}
  {
    "version": "1.280.385",
    "newer": false,
    "versions": [
      {
        "ver": "1.280.385",
        "type": "stable",
        "changes": [
          {
            "type": "star",
            "text": "Add render option for unblocker and serp zones"
          }
        ]
      }
    ]
  }
  ```
</ResponseExample>

<RequestExample>
  ```sh Shell theme={null}
  curl "http://127.0.0.1:22999/api/last_version"
  ```

  ```js NodeJS theme={null}
  #!/usr/bin/env node  
    
  (async () => {
    const response = await fetch('http://127.0.0.1:22999/api/last_version');
    const data = await response.text();
    console.log(data);
  })();
  ```

  ```java Java theme={null}
  package example;  
    
  import org.apache.http.HttpHost;    
  import org.apache.http.client.fluent.*;  
    
    
    
    
  public class Example {  
    
    public static void main(String[] args) throws Exception {  
    
      String res = Executor.newInstance()  
    
       .execute(Request.Get("http://127.0.0.1:22999/api/last_version"))  
    
       .returnContent().asString();  
    
      System.out.println(res)  
    
    }  
    
  }
  ```

  ```cs C# theme={null}
  using System;  
  using System.Net;  
  using System.Net.Http;  
  using System.Net.Http.Headers;  
    

  public class Program {  
    
    public static async Task Main() {  
    
      var client = new HttpClient();  
    
      var requestMessage = new HttpRequestMessage {  
    
        Method = HttpMethod.Get,  
    
       RequestUri = new Uri("http://127.0.0.1:22999/api/last_version")  
    
      };  
    
      var response = await client.SendAsync(requestMessage);  
    
      var responseString = await response.Content.ReadAsStringAsync();  
    
      Console.WriteLine(responseString);  
    
    }  
    
  }
  ```

  ```python Python theme={null}
  #!/usr/bin/env python  
    
  print('If you get error "ImportError: No module named requests", please install it:\n$ sudo pip install requests');  
    
  import requests  

  r = requests.get('http://127.0.0.1:22999/api/last_version')  

  print(r.content)
  ```
</RequestExample>


# Refresh IP/gIP in a zone
Source: https://docs.brightdata.com/api-reference/proxy-manager/refresh_ips_or_gips_in_zone

Use the Bright Data Proxy Manager API to refresh IP/gIP in a zone. Calls POST /api/refresh_ips on the local Proxy Manager port 22999.

**API endpoint:** `POST` `/api/refresh_ips`

## `POST` body

<ParamField type="string">
  Zone name
</ParamField>

<ParamField type="array">
  Static IPs. e.g. `ips=["ip1","ip2"]`
</ParamField>

<ParamField type="array">
  gIPs. e.g. `vips=["gip1","gip2"] [array]`
</ParamField>

<ResponseExample>
  ```json Sample Response theme={null}
  {
    "ips": [
  	{
  	  "ip":"10.0.0.1",
  	  "maxmind":"us"
  	},
  	{
  	  "ip":"20.0.0.1",
  	  "maxmind":"us"
  	}
    ]
  }
  ```
</ResponseExample>

<RequestExample>
  ```sh Shell theme={null}
  curl "http://127.0.0.1:22999/api/refresh_ips" -H "Content-Type: application/json" -d '{"zone":"ZONE","ips":["10.0.0.1"]}'
  ```

  ```js NodeJS theme={null}
  #!/usr/bin/env node

  (async () => {
    const response = await fetch('http://127.0.0.1:22999/api/refresh_ips', {
      method: 'POST',
      headers: { 'Content-Type': 'application/json' },
      body: JSON.stringify({'zone':'ZONE','ips':['10.0.0.1']}),
    });
    const data = await response.text();
    console.log(data);
  })();
  ```

  ```java Java theme={null}
  package example;

  import org.apache.http.HttpHost;
  import org.apache.http.client.fluent.*;

  public class Example {
    public static void main(String[] args) throws Exception {
     String body = "{\"zone\":\"ZONE\",\"ips\":[\"10.0.0.1\"]}";
      String res = Executor.newInstance()
       .execute(Request.Post("http://127.0.0.1:22999/api/refresh_ips")
       .bodyString(body, ContentType.APPLICATION_JSON))
       .returnContent().asString();


      System.out.println(res)
    }
  }
  ```

  ```cs C# theme={null}
  using System;
  using System.Net;
  using System.Net.Http;
  using System.Net.Http.Headers;


  public class Program {

    public static async Task Main() {
      var client = new HttpClient();
      var requestMessage = new HttpRequestMessage {
        Method = HttpMethod.Post,
       RequestUri = new Uri("http://127.0.0.1:22999/api/refresh_ips"),
       Content = new StringContent(JsonConvert.SerializeObject(new {
         zone = "ZONE",
         ips = ["10.0.0.1"]
       }), Encoding.UTF8, "application/json")
      };

      var response = await client.SendAsync(requestMessage);
      var responseString = await response.Content.ReadAsStringAsync();

      Console.WriteLine(responseString);
    }
  }
  ```

  ```python Python theme={null}
  #!/usr/bin/env python

  import requests
  import json

  data = {'zone':'ZONE','ips':['10.0.0.1']}

  r = requests.post('http://127.0.0.1:22999/api/refresh_ips', data=json.dumps(data))

  print(r.content)
  ```
</RequestExample>


# Refresh Proxy Manager port session
Source: https://docs.brightdata.com/api-reference/proxy-manager/refresh_proxy_manager_port_sessions

Bright Data Proxy Manager API endpoint to refresh Proxy Manager Port Session. Endpoint: GET /api/refresh_sessions/{PORT} on port 22999.

**API endpoint:** `GET` `/api/refresh_sessions/{PORT}`

## Path Parameter

<ParamField type="string">
  Existing proxy port number
</ParamField>

<RequestExample>
  ```sh Shell theme={null}
  curl "http://127.0.0.1:22999/api/refresh_sessions/{PORT}"
  ```

  ```js NodeJS theme={null}
  #!/usr/bin/env node

  (async () => {
    const response = await fetch('http://127.0.0.1:22999/api/refresh_sessions/{PORT}');
    const data = await response.text();
    console.log(data);
  })();
  ```

  ```java Java theme={null}
  package example;

   

  import org.apache.http.HttpHost;

  import org.apache.http.client.fluent.*;

   

  public class Example {

    public static void main(String[] args) throws Exception {

      String res = Executor.newInstance()

       .execute(Request.Get("http://127.0.0.1:22999/api/refresh_sessions/{PORT}"))

       .returnContent().asString();

      System.out.println(res)

    }

  }
  ```

  ```cs C# theme={null}
  using System;

  using System.Net;

  using System.Net.Http;

  using System.Net.Http.Headers;

   

  public class Program {

    public static async Task Main() {

      var client = new HttpClient();

      var requestMessage = new HttpRequestMessage {

        Method = HttpMethod.Get,

       RequestUri = new Uri("http://127.0.0.1:22999/api/refresh_sessions/{PORT}")

      };

      var response = await client.SendAsync(requestMessage);

      var responseString = await response.Content.ReadAsStringAsync();

      Console.WriteLine(responseString);

    }

  }
  ```

  ```python Python theme={null}
  #!/usr/bin/env python


  import requests



  r = requests.get('http://127.0.0.1:22999/api/refresh_sessions/{PORT}')

  print(r.content)
  ```
</RequestExample>


# Restart Proxy Manager
Source: https://docs.brightdata.com/api-reference/proxy-manager/restart_proxy_manager

Use the Bright Data Proxy Manager API to restart Proxy Manager. Calls POST /api/restart on the local Proxy Manager port 22999.

**API endpoint:** `POST` `/api/restart`

<RequestExample>
  ```sh Shell theme={null}
  curl -X POST "http://127.0.0.1:22999/api/restart"
  ```

  ```js NodeJS theme={null}
  #!/usr/bin/env node

  (async () => {
    const response = await fetch('http://127.0.0.1:22999/api/restart', {
      method: 'POST',

    });
    const data = await response.text();
    console.log(data);
  })();
  ```

  ```java Java theme={null}
  package example;

   
  import org.apache.http.HttpHost;
  import org.apache.http.client.fluent.*;

   

  public class Example {

    public static void main(String[] args) throws Exception {

      String res = Executor.newInstance()

       .execute(Request.Post("http://127.0.0.1:22999/api/restart"))

       .returnContent().asString();

   

      System.out.println(res)

    }

  }
  ```

  ```cs C# theme={null}
  using System;
  using System.Net;
  using System.Net.Http;
  using System.Net.Http.Headers;

   

  public class Program {

    public static async Task Main() {

      var client = new HttpClient();

      var requestMessage = new HttpRequestMessage {

        Method = HttpMethod.Post,

       RequestUri = new Uri("http://127.0.0.1:22999/api/restart")

      };

      var response = await client.SendAsync(requestMessage);

      var responseString = await response.Content.ReadAsStringAsync();

      Console.WriteLine(responseString);

    }

  }
  ```

  ```python Python theme={null}
  #!/usr/bin/env python

  print('If you get error "ImportError: No module named requests", please install it:\n$ sudo pip install requests');

  import requests


  r = requests.post('http://127.0.0.1:22999/api/restart')

  print(r.content)
  ```
</RequestExample>


# Shutdown Proxy Manager
Source: https://docs.brightdata.com/api-reference/proxy-manager/shutdown_proxy_manager

Use the Bright Data Proxy Manager API to shutdown Proxy Manager. Calls POST /api/shutdown on the local Proxy Manager port 22999.

**API endpoint:** `POST` `/api/shutdown`

<RequestExample>
  ```sh Shell theme={null}
  curl -X POST "http://127.0.0.1:22999/api/shutdown"
  ```

  ```js NodeJS theme={null}
  #!/usr/bin/env node

  (async () => {
    const response = await fetch('http://127.0.0.1:22999/api/shutdown', {
      method: 'POST',

    });
    const data = await response.text();
    console.log(data);
  })();
  ```

  ```java Java theme={null}
  package example;


  import org.apache.http.HttpHost;
  import org.apache.http.client.fluent.\*;


  public class Example {

    public static void main(String[] args) throws Exception {

      String res = Executor.newInstance()

       .execute(Request.Post("http://127.0.0.1:22999/api/shutdown"))

       .returnContent().asString();

   

      System.out.println(res)

    }

  }
  ```

  ```cs C# theme={null}
  using System;

  using System.Net;

  using System.Net.Http;

  using System.Net.Http.Headers;

   

  public class Program {

    public static async Task Main() {

      var client = new HttpClient();

      var requestMessage = new HttpRequestMessage {

        Method = HttpMethod.Post,

       RequestUri = new Uri("http://127.0.0.1:22999/api/shutdown")

      };

      var response = await client.SendAsync(requestMessage);

      var responseString = await response.Content.ReadAsStringAsync();

      Console.WriteLine(responseString);

    }

  }
  ```

  ```python Python theme={null}
  #!/usr/bin/env python


  import requests



  r = requests.post('http://127.0.0.1:22999/api/shutdown')

  print(r.content)
  ```
</RequestExample>


# Allowlist IPs to access UI
Source: https://docs.brightdata.com/api-reference/proxy-manager/ui-allowlist-ips

Use the Bright Data Proxy Manager API to allowlist IPs to Access UI. Calls PUT /api/add_whitelist_ip on the local Proxy Manager port 22999.

**API endpoint:** `PUT` `/api/add_whitelist_ip`

<ParamField type="string">
  API key
  <Tip>API Key should be generated using [Generate API Key](/api-reference/proxy-manager/generate_token_for_token_based_authentication)</Tip>
</ParamField>

## `PUT` body

<ParamField type="string">
  IP to allowlist e.g. `ip="1.2.1.2"`
</ParamField>

<RequestExample>
  ```sh Shell theme={null}
  curl -X PUT "http://127.0.0.1:22999/api/add_whitelist_ip" -H "Authorization: API key" -H "Content-Type: application/json" -d '{"ip":"1.2.1.2"}'
  ```

  ```js NodeJS theme={null}
  #!/usr/bin/env node

  (async () => {
    const response = await fetch('http://127.0.0.1:22999/api/add_whitelist_ip', {
      method: 'PUT',
      headers: { 'Authorization': 'API key', 'Content-Type': 'application/json' },
      body: JSON.stringify({'ip':'1.2.1.2'}),
    });
    const data = await response.text();
    console.log(data);
  })();
  ```

  ```java Java theme={null}
  package example;

  import org.apache.http.HttpHost;
  import org.apache.http.client.fluent.\*;


  public class Example {
      public static void main(String[] args) throws Exception {
      String body = "{\"ip\":\"1.2.1.2\"}";
      String res = Executor.newInstance()
        .addHeader("Authorization", "API key")
        .execute(Request.Put("http://127.0.0.1:22999/api/add_whitelist_ip")
        .bodyString(body, ContentType.APPLICATION_JSON))
        .returnContent()
        .asString();
      
      System.out.println(res)
      }
  }
  ```

  ```cs C# theme={null}
  using System;
  using System.Net;
  using System.Net.Http;
  using System.Net.Http.Headers;


  public class Program {
    public static async Task Main() {
      var client = new HttpClient();
      var requestMessage = new HttpRequestMessage {
        Method = HttpMethod.Put,
        RequestUri = new Uri("http://127.0.0.1:22999/api/add_whitelist_ip"),
        Headers = {{"Authorization", "API key"}},
        Content = new StringContent(JsonConvert.SerializeObject(new {
          ip = "1.2.1.2"
        }), Encoding.UTF8, "application/json")
      };

      var response = await client.SendAsync(requestMessage);
      var responseString = await response.Content.ReadAsStringAsync();

      Console.WriteLine(responseString);
    }
  }
  ```

  ```python Python theme={null}
  #!/usr/bin/env python

  import json
  import requests


  data = {'ip':'1.2.1.2'}
  headers = {'Authorization': 'API key'}

  r = requests.put(
      'http://127.0.0.1:22999/api/add_whitelist_ip',
      data=json.dumps(data),
      headers=headers
  )

  print(r.content)
  ```
</RequestExample>


# Unban an IP
Source: https://docs.brightdata.com/api-reference/proxy-manager/unban_an_ip

Use the Bright Data Proxy Manager API to unban an IP. Calls POST /api/proxies/{PORT}/unbanip on the local Proxy Manager port 22999.

**API endpoint:** `POST` `/api/proxies/{PORT}/unbanip`

## Path Parameter

<ParamField type="string">
  Existing proxy port number
</ParamField>

## `POST` body

<ParamField type="string">
  IP to unban. e.g. `ip="1.2.1.2"`
</ParamField>

<ParamField type="string">
  Unban the IP for sending requests to the specified domain.
</ParamField>

<RequestExample>
  ```sh Shell theme={null}
  curl "http://127.0.0.1:22999/api/proxies/{PORT}/unbanip" -H "Content-Type: application/json" -d '{"ip":"1.2.1.2","domain":"example.com"}'
  ```

  ```js NodeJS theme={null}
  #!/usr/bin/env node

  (async () => {
    const response = await fetch('http://127.0.0.1:22999/api/proxies/{PORT}/unbanip', {
      method: 'POST',
      headers: { 'Content-Type': 'application/json' },
      body: JSON.stringify({
            'ip': '1.2.1.2',
            'domain': 'example.com'
        }),

    });
    const data = await response.text();
    console.log(data);
  })();
  ```

  ```java Java theme={null}
  package example;

   

  import org.apache.http.HttpHost;

  import org.apache.http.client.fluent.\*;

   

  public class Example {

    public static void main(String[] args) throws Exception {

     String body = "{\"ip\":\"1.2.1.2\",\"domain\":\"example.com\"}";

      String res = Executor.newInstance()

       .execute(Request.Post("http://127.0.0.1:22999/api/proxies/{PORT}/unbanip")

       .bodyString(body, ContentType.APPLICATION_JSON))

       .returnContent().asString();

   

      System.out.println(res)

    }

  }
  ```

  ```cs C# theme={null}
  using System;

  using System.Net;

  using System.Net.Http;

  using System.Net.Http.Headers;

   

  public class Program {

    public static async Task Main() {

      var client = new HttpClient();

      var requestMessage = new HttpRequestMessage {

        Method = HttpMethod.Post,

       RequestUri = new Uri("http://127.0.0.1:22999/api/proxies/{PORT}/unbanip"),

       Content = new StringContent(JsonConvert.SerializeObject(new {

         ip = "1.2.1.2",

         domain = "example.com"

       }), Encoding.UTF8, "application/json")

      };

      var response = await client.SendAsync(requestMessage);

      var responseString = await response.Content.ReadAsStringAsync();

      Console.WriteLine(responseString);

    }

  }
  ```

  ```python Python theme={null}
  #!/usr/bin/env python

  print('If you get error "ImportError: No module named requests", please install it:\n$ sudo pip install requests');

  import requests
  import json

   

  data = {'ip':'1.2.1.2','domain':'example.com'}

  r = requests.post('http://127.0.0.1:22999/api/proxies/{PORT}/unbanip', data=json.dumps(data))

  print(r.content)
  ```
</RequestExample>


# Unban IPs (multiple)
Source: https://docs.brightdata.com/api-reference/proxy-manager/unban_ips

Use the Bright Data Proxy Manager API to unban IPs (multiple). Endpoint: POST /api/proxies/{PORT}/unbanips on port 22999.

**API endpoint:** `POST` `/api/proxies/{PORT}/unbanips`

## Path Parameter

<ParamField type="string">
  Existing proxy port number
</ParamField>

<RequestExample>
  ```sh Shell theme={null}
  curl "http://127.0.0.1:22999/api/proxies/{PORT}/unbanips"
  ```

  ```js NodeJS theme={null}
  #!/usr/bin/env node

  (async () => {
    const response = await fetch('http://127.0.0.1:22999/api/proxies/{PORT}/unbanips', {
      method: 'POST',

    });
    const data = await response.text();
    console.log(data);
  })();
  ```

  ```java Java theme={null}
  package example;


  import org.apache.http.HttpHost;
  import org.apache.http.client.fluent.*;


  public class Example {
      public static void main(String[] args) throws Exception {
          String res = Executor.newInstance().execute(
              Request.Post("http://127.0.0.1:22999/api/proxies/{PORT}/unbanips"
          )).returnContent().asString();

          System.out.println(res)
      }
  }
  ```

  ```cs C# theme={null}
  using System;
  using System.Net;
  using System.Net.Http;
  using System.Net.Http.Headers;
   

  public class Program {
    public static async Task Main() {
      var client = new HttpClient();
      var requestMessage = new HttpRequestMessage {
        Method = HttpMethod.Post,
       RequestUri = new Uri("http://127.0.0.1:22999/api/proxies/{PORT}/unbanips")
      };

      var response = await client.SendAsync(requestMessage);
      var responseString = await response.Content.ReadAsStringAsync();

      Console.WriteLine(responseString);
    }
  }
  ```

  ```python Python theme={null}
  #!/usr/bin/env python

  print('If you get error "ImportError: No module named requests", please install it:\n$ sudo pip install requests');

  import requests

  r = requests.post('http://127.0.0.1:22999/api/proxies/{PORT}/unbanips')

  print(r.content)
  ```
</RequestExample>


# Update a proxy port
Source: https://docs.brightdata.com/api-reference/proxy-manager/update_a_proxy_port

Use the Bright Data Proxy Manager API to update a Proxy Port. Calls PUT /api/proxies/{PORT} on the local Proxy Manager port 22999.

**API endpoint:** `PUT` `/api/proxies/{PORT}`

## Path Parameter

<ParamField type="string">
  Existing proxy port number
</ParamField>

## `PUT` body

<ParamField type="User Object">
  <Expandable title="properties">
    <ParamField type="integer">
      Port for the HTTP proxy
    </ParamField>

    <ParamField type="string">
      Set to `persist` to save proxy into the configuration file.
    </ParamField>

    <ParamField type="integer">
      Multiply the port definition given number of times
    </ParamField>

    <ParamField type="boolean" />

    <ParamField type="array">
      List of `user`s `[string]`. This option has to be used along with `multiply_users`
    </ParamField>

    <ParamField type="boolean">
      Enable SSL analyzing
    </ParamField>

    <ParamField type="string">
      Choose the SSL library

      | value      | description      |
      | ---------- | ---------------- |
      | `open_ssl` | Open SSL Library |
      | `flex_tls` | Flex TLS Library |
    </ParamField>

    <ParamField type="string">
      Interface or IP to listen on
    </ParamField>

    <ParamField type="string">
      Customer name
    </ParamField>

    <ParamField type="string">
      Zone name
    </ParamField>

    <ParamField type="string">
      Zone password
    </ParamField>

    <ParamField type="string">
      Hostname or IP of super proxy
    </ParamField>

    <ParamField type="integer">
      Super proxy port
    </ParamField>

    <ParamField type="string">
      Determines what kind of connection will be used between Proxy Manager and Super Proxy

      |         |   |
      | ------- | - |
      | `http`  |   |
      | `https` |   |
      | `socks` |   |
    </ParamField>

    <ParamField type="integer">
      Automatically retry on super proxy failure
    </ParamField>

    <ParamField type="boolean">
      Enable SSL connection/analyzing to insecure hosts
    </ParamField>

    <ParamField type="string">
      Country
    </ParamField>

    <ParamField type="string">
      State
    </ParamField>

    <ParamField type="string">
      City
    </ParamField>

    <ParamField type="string">
      ASN
    </ParamField>

    <ParamField type="string">
      Data Center IP
    </ParamField>

    <ParamField type="integer">
      gIP
    </ParamField>

    <ParamField type="array">
      A list of proxies from external vendors. Format: \[username:password@]ip\[:port]

      * proxy\[string]
    </ParamField>

    <ParamField type="string">
      Default username for external vendor ips
    </ParamField>

    <ParamField type="string">
      Default password for external vendor ips
    </ParamField>

    <ParamField type="integer">
      Default port for external vendor ips
    </ParamField>

    <ParamField type="string">
      DNS resolving

      |          |   |
      | -------- | - |
      | `local`  |   |
      | `remote` |   |
    </ParamField>

    <ParamField type="boolean">
      Process reverse lookup via DNS
    </ParamField>

    <ParamField type="string">
      Process reverse lookup via file
    </ParamField>

    <ParamField type="array">
      Process reverse lookup via value
    </ParamField>

    <ParamField type="string">
      Session for all proxy requests
    </ParamField>

    <ParamField type="boolean">
      Use session per requesting host to maintain IP per host
    </ParamField>

    <ParamField type="integer" />

    <ParamField type="boolean">
      Session pool size
    </ParamField>

    <ParamField type="integer">
      Throttle requests above given number
    </ParamField>

    <ParamField type="array">
      Proxy request rules
    </ParamField>

    <ParamField type="string">
      Block or allow requests to be automatically sent through super proxy on error
    </ParamField>

    <ParamField type="array" />

    <ParamField type="string" />

    <ParamField type="string">
      Operating System of the Peer IP
    </ParamField>

    <ParamField type="array">
      Request headers
    </ParamField>

    * name\[string]
    * value\[string]

    <ParamField type="string">
      Request debug info

      |        |   |
      | ------ | - |
      | `full` |   |
      | `none` |   |
    </ParamField>

    <ParamField type="string">
      x-lpm-authorization header
    </ParamField>

    <ParamField type="boolean" />

    <ParamField type="integer" />

    <ParamField type="boolean" />

    <ParamField type="boolean" />

    <ParamField type="integer" />

    <ParamField type="string" />

    <ParamField type="boolean">
      Unblocker Mobile UA
    </ParamField>

    <ParamField type="string">
      Timezone ID to be used by the browser
    </ParamField>

    <ParamField type="string">
      Browser screen size
    </ParamField>

    <ParamField type="string">
      WebRTC plugin behavior in the browser
    </ParamField>

    <ParamField type="object">
      BW limit params

      * days \[integer]
      * bytes \[integer]
      * renewable\[boolean] - Renew limit of bytes each period or use single period and stop usage once last day of period is reached. Default is true
    </ParamField>
  </Expandable>
</ParamField>

<ResponseExample>
  ```JSON Sample Response theme={null}
  {
      "port":24000,
      "zone":"ZONE",
      "proxy_type":"persist",
      "customer":"CUSTOMER",
      "password":"password",
      "whitelist_ips":[]
  }
  ```
</ResponseExample>

<RequestExample>
  ```sh Shell theme={null}
  curl -X PUT "http://127.0.0.1:22999/api/proxies/{PORT}" -H "Content-Type: application/json" -d '{"proxy":{"port":24000,"zone":"ZONE","proxy_type":"persist","customer":"CUSTOMER","password":"password","whitelist_ips":[]}}'
  ```

  ```js NodeJS theme={null}
  #!/usr/bin/env node

  (async () => {
    const response = await fetch('http://127.0.0.1:22999/api/proxies/{PORT}', {
      method: 'PUT',
      headers: { 'Content-Type': 'application/json' },
      body: JSON.stringify({'proxy':{'port':24000,'zone': 'ZONE','proxy_type':'persist','customer':'CUSTOMER','password':'password','whitelist_ips':[]}}),
    });
    const data = await response.text();
    console.log(data);
  })();
  ```

  ```java Java theme={null}
  package example;

   

  import org.apache.http.HttpHost;

  import org.apache.http.client.fluent.*;

   

  public class Example {

    public static void main(String[] args) throws Exception {

     String body = "{\"proxy\":{\"port\":24000,\"zone\":\"ZONE\",\"proxy_type\":\"persist\",\"customer\":\"CUSTOMER\",\"password\":\"password\",\"whitelist_ips\":[]}}";

      String res = Executor.newInstance()

       .execute(Request.Put("http://127.0.0.1:22999/api/proxies/{PORT}")

       .bodyString(body, ContentType.APPLICATION_JSON))

       .returnContent().asString();

   

      System.out.println(res)

    }

  }
  ```

  ```cs C# theme={null}
  using System;
  using System.Net;
  using System.Net.Http;
  using System.Net.Http.Headers;
   

  public class Program {
    public static async Task Main() {
      var client = new HttpClient();
      var requestMessage = new HttpRequestMessage {
        Method = HttpMethod.Put,
       RequestUri = new Uri("http://127.0.0.1:22999/api/proxies/{PORT}"),
       Content = new StringContent(JsonConvert.SerializeObject(new {
         proxy = new {
           port = 24000, zone = "ZONE", proxy_type = "persist", customer = "CUSTOMER", password = "password", whitelist_ips = []
         }
       }), Encoding.UTF8, "application/json")
      };
      var response = await client.SendAsync(requestMessage);
      var responseString = await response.Content.ReadAsStringAsync();

      Console.WriteLine(responseString);
    }
  }
  ```

  ```python Python theme={null}
  #!/usr/bin/env python

  import requests
  import json


  data = {'proxy':{'port':24000,'zone': 'ZONE','proxy_type':'persist','customer':'CUSTOMER','password':'password','whitelist_ips':[]}}

  r = requests.put('http://127.0.0.1:22999/api/proxies/{PORT}', data=json.dumps(data))

  print(r.content)
  ```
</RequestExample>


# Update general setting
Source: https://docs.brightdata.com/api-reference/proxy-manager/update_general_settings

Use the Bright Data Proxy Manager API to update General Setting. Calls PUT /api/settings on the local Proxy Manager port 22999.

**API Endpoint:** `PUT` `/api/settings`

## `PUT` Body:

<ParamField type="string">
  Default zone
</ParamField>

<ParamField type="array">
  Allowlist ip list for granting access to browser admin UI
</ParamField>

<ParamField type="array">
  Default for all proxies allowlist ip list for granting access to them
</ParamField>

<ParamField type="integer">
  Number of request logs to store
</ParamField>

<ParamField type="boolean">
  Enable requests statistics
</ParamField>

<ResponseExample>
  ```JSON Sample Response theme={null}
  {
      "customer":"CUSTOMER",
      "zone":"ZONE",
      "password":"password",
      "www_whitelist_ips":[],
      "whitelist_ips":[],
      "fixed_whitelist_ips":[],
      "read_only":false,
      "config":"/home/user/proxy_manager/.luminati.json",
      "test_url":"http://brdtest.com/myip.json",
      "logs":1000,
      "log":"notice",
      "har_limit":1024,
      "request_stats":true,
      "dropin":true,
      "pending_ips":[],
      "pending_www_ips":[],
      "zagent":false,
      "sync_config":true
  }
  ```
</ResponseExample>

<RequestExample>
  ```sh Shell theme={null}
  curl -X PUT "http://127.0.0.1:22999/api/settings" -H "Content-Type: application/json" -d '{"zone":"ZONE","www_whitelist_ips":[],"whitelist_ips":[],"logs":1000,"request_stats":true}'
  ```

  ```js NodeJS theme={null}
  #!/usr/bin/env node

  (async () => {
    const response = await fetch('http://127.0.0.1:22999/api/settings', {
      method: 'PUT',
      headers: { 'Content-Type': 'application/json' },
      body: JSON.stringify({'zone': 'ZONE','www_whitelist_ips':[],'whitelist_ips':[],'logs':1000,'request_stats':true}),
    });
    const data = await response.text();
    console.log(data);
  })();
  ```

  ```java Java theme={null}
  package example;

  import org.apache.http.HttpHost;

  import org.apache.http.client.fluent.*;

  public class Example {

    public static void main(String[] args) throws Exception {

     String body = "{\"zone\":\"ZONE\",\"www_whitelist_ips\":[],\"whitelist_ips\":[],\"logs\":1000,\"request_stats\":true}";

      String res = Executor.newInstance()

       .execute(Request.Put("http://127.0.0.1:22999/api/settings")

       .bodyString(body, ContentType.APPLICATION_JSON))

       .returnContent().asString();

   

      System.out.println(res)

    }

  }
  ```

  ```cs C# theme={null}
  using System;

  using System.Net;

  using System.Net.Http;

  using System.Net.Http.Headers;

   

  public class Program {

    public static async Task Main() {

      var client = new HttpClient();

      var requestMessage = new HttpRequestMessage {

        Method = HttpMethod.Put,

       RequestUri = new Uri("http://127.0.0.1:22999/api/settings"),

       Content = new StringContent(JsonConvert.SerializeObject(new {

           zone = "ZONE", www_whitelist_ips = [], whitelist_ips = [], logs = 1000, request_stats = true

       }), Encoding.UTF8, "application/json")

      };

      var response = await client.SendAsync(requestMessage);

      var responseString = await response.Content.ReadAsStringAsync();

      Console.WriteLine(responseString);

    }

  }
  ```

  ```python Python theme={null}
  #!/usr/bin/env python

  print('If you get error "ImportError: No module named requests", please install it:\n$ sudo pip install requests');

  import requests
  import json

   

  data = {'zone': 'ZONE','www_whitelist_ips':[],'whitelist_ips':[],'logs':1000,'request_stats':True}

  r = requests.put('http://127.0.0.1:22999/api/settings', data=json.dumps(data))

  print(r.content)

  ```
</RequestExample>


# Upgrade Proxy Manager
Source: https://docs.brightdata.com/api-reference/proxy-manager/upgrade_proxy_manager

Use the Bright Data Proxy Manager API to upgrade Proxy Manager. Calls POST /api/upgrade on the local Proxy Manager port 22999.

**API endpoint:** `POST` `/api/upgrade`

<RequestExample>
  ```sh Shell theme={null}
  curl -X POST "http://127.0.0.1:22999/api/upgrade"
  ```

  ```js NodeJS theme={null}
  #!/usr/bin/env node

  (async () => {
    const response = await fetch('http://127.0.0.1:22999/api/upgrade', {
      method: 'POST',

    });
    const data = await response.text();
    console.log(data);
  })();
  ```

  ```java Java theme={null}
  package example;


  import org.apache.http.HttpHost;
  import org.apache.http.client.fluent.*;


  public class Example {

    public static void main(String[] args) throws Exception {

      String res = Executor.newInstance()

       .execute(Request.Post("http://127.0.0.1:22999/api/upgrade"))

       .returnContent().asString();

   

      System.out.println(res)

    }

  }
  ```

  ```cs C# theme={null}
  using System;
  using System.Net;
  using System.Net.Http;
  using System.Net.Http.Headers;

   

  public class Program {

    public static async Task Main() {

      var client = new HttpClient();

      var requestMessage = new HttpRequestMessage {

        Method = HttpMethod.Post,

       RequestUri = new Uri("http://127.0.0.1:22999/api/upgrade")

      };

      var response = await client.SendAsync(requestMessage);

      var responseString = await response.Content.ReadAsStringAsync();

      Console.WriteLine(responseString);

    }

  }
  ```

  ```python Python theme={null}
  #!/usr/bin/env python

  print('If you get error "ImportError: No module named requests", please install it:\n$ sudo pip install requests');

  import requests


  r = requests.post('http://127.0.0.1:22999/api/upgrade')

  print(r.content)
  ```
</RequestExample>


# Request and response C-Tag
Source: https://docs.brightdata.com/api-reference/proxy/c-tag

Configure the Bright Data Proxy REST API Request and Response C-Tag to control request behavior on port 44445, with reference for parameters and fields.

When you're dealing with a massive volume of requests, keeping track of individual responses can be challenging. Enter C-Tag, a simple yet powerful solution that improves request tracking.

With C-Tag, users include a unique `c_tag` flag in their requests. In response, businesses echo back the same tag in the header. This seamless exchange ensures that each response is bound to its corresponding request, eliminating confusion and streamlining data management.

Add any C-Tag text in your request and get the identical sting in your response header:

<CodeGroup>
  ```sh Sample Request theme={null}
  curl "http://target.site" --proxy brd.superproxy.io:44445 --proxy-user brd-customer-<customer_id>-zone-<zone_name>-c_tag-<C_TAG_VALUE>:<zone_password>
  ```

  ```js Output headers theme={null}
  x-brd-c_tag: <C_TAG_VALUE>
  ```
</CodeGroup>


# Configuring DNS resolution
Source: https://docs.brightdata.com/api-reference/proxy/configuring_dns_resolution

Configure DNS resolution on the Bright Data Proxy REST API (port 44445) to control request behavior, with reference for parameters and response fields.

It is possible to direct Bright Data proxy network to use either remote or local DNS resolution.

This is useful if your target has more than two IPs (depending on where the DNS query is made) and would like to target a specific IP of the target site.

All requests to Bright Data start with a connection to a Super Proxy (brd.superproxy.io). The Super Proxy then send the request to local servers in different countries, who can send the request if needed to Residental proxies ("peers").

When using `local` DNS resolution, domain names are resolved and cached by Bright Data Super Proxy network server, the resolved IP is used the real request by the proxy in the actual country.

When requests are made using `remote` they initially received by a Super Proxy (brd.superproxy.io). The Super Proxy does a preliminary DNS resolution locally, only to check if domain is valid. If the domain is valid, the request is sent to a Bright Data server that is closest to the country where the proxy is located.

* If the Bright Data server is in the same country as the proxy, DNS is performed on the server, the resolved IP is used the real request. This DNS resolution is usually faster than DNS resolution by the proxy.
* If the Bright Data server is in a different country, DNS is performed on actual proxy.

<CodeGroup>
  ```sh DNS (Local) theme={null}
  curl "https://example.com" --proxy brd.superproxy.io:44445 --proxy-user brd-customer-<customer_id>-zone-<zone_name>-dns-local:<zone_password>
  ```

  ```sh DNS (Remote) theme={null}
  curl "https://example.com" --proxy brd.superproxy.io:44445 --proxy-user brd-customer-<customer_id>-zone-<zone_name>-dns-remote:<zone_password>
  ```
</CodeGroup>

<Note>
  When using remote DNS resolution you may see some performance degradation due to local DNS resolution lag.
</Note>


# Proxy geolocation targeting
Source: https://docs.brightdata.com/api-reference/proxy/geolocation-targeting

Target Bright Data proxy exits across 195 countries by Country, City, State, ASN or ZIP code by adding parameters to the proxy username for geo control.

## Country Targeting

You can target a specific country by adding a country code to your username, like `username-country-country_code`. Use only two-letter country codes in lowercase.

```sh Shell theme={null}
curl "https://example.com" --proxy brd.superproxy.io:44445 --proxy-user brd-customer-<customer_id>-zone-<zone_name>-country-us:<zone_password>
```

### Default countries' selection

In all Bright Data shared pool proxies: Datacenter, ISP, Residential and Mobile share pools (also known as "Rotating proxies") we offer a default country selection during zone configuration. When a country(s) is selected, Bright Data will attempt to allocate a peer from the selected default countries. The allocation sequence is as follows:&#x20;

If there are default countries configured:&#x20;

1. Select a random country from the **default countries** list.&#x20;

2. Attempt to allocate a peer in that country

3. If peer found: route request to the peer&#x20;

4. If peer not found: fail the request and reply with error

In case there are **no default countries selected,** Bright Data will allocate a random proxy peer from the pool and route the request through it.&#x20;

### EU Countries targeting

Bright Data proxy networks as well as our Web Unlocker API allow random peer selection specifically from **EU-member countries** via the use of the `-country-eu` flag. When needing to target EU peers, this will improve success rates over targeting from just one EU country, while still keeping the peer within the EU.

## City Targeting

<Note> City targeting works best in Residential & Mobile proxies. City targeting in Datacenter & ISP proxies has deprecated and we do not recommend using it. </Note>

You can target a specific city within a country by adding a city name to the username, like `username-country-country_code-city-city_code`. The city\_codemust be in lowercase only and have no spaces, for example `-city-sanfrancisco`

```sh Shell theme={null}
curl "https://example.com" --proxy brd.superproxy.io:44445 --proxy-user brd-customer-<customer_id>-zone-<zone_name>-country-us-city-sanfrancisco:<zone_password>
```

## State Targeting

<Note> Residential proxies only </Note>

You can target a specific region or subdivision by adding the parameter `-state-<state_code>` to your username string.

We utilize the **ISO 3166-2** standard for state targeting. While this includes standard 2-letter codes (e.g., US states), we also support **3-letter** and **numeric** codes as defined by the standard for other regions.

<Tip>
  Always verify the correct subdivision code using the [ISO 3166-2 standard](https://en.wikipedia.org/wiki/ISO_3166-2). Ensure the code is entered in **lowercase**.
</Tip>

<CodeGroup>
  ```sh Country: USA (2-letter) theme={null} theme={null}
  # Targeting New York (ny)
  curl "https://example.com" --proxy brd.superproxy.io:44445 --proxy-user brd-customer-<customer_id>-zone-<zone_name>-country-us-state-ny:<zone_password> 

  ```

  ```sh Country: England (3-letter) theme={null} theme={null}
  # Targeting England (eng)
  curl "https://example.com" --proxy brd.superproxy.io:44445 --proxy-user brd-customer-<customer_id>-zone-<zone_name>-country-gb-state-eng:<zone_password>

  ```

  ```sh Country: Japan (Numeric) theme={null} theme={null}
  # Targeting Okinawa (47)
  curl "https://example.com" --proxy brd.superproxy.io:44445 --proxy-user brd-customer-<customer_id>-zone-<zone_name>-country-jp-state-47:<zone_password>

  ```
</CodeGroup>

## ASN Targeting

<Note> Residential proxies only </Note>

You can target a specific ASN from the [list of ASNs](http://bgp.potaroo.net/cidr/autnums.html). Choosing an ASN country is done as following: -asn-ASN\_NUMBER

```sh Shell theme={null}
curl "https://example.com" --proxy brd.superproxy.io:44445 --proxy-user brd-customer-<customer_id>-zone-<zone_name>-asn-56386:<zone_password>
```

## ZIP Code Targeting

<Note> Residential proxies only </Note>

You can target proxy peers by a ZIP code of a specific area. Here is an example of targeting an IP from Memphis, US and zip code 12345:

```sh Shell theme={null}
curl "https://example.com" --proxy brd.superproxy.io:44445 --proxy-user brd-customer-<customer_id>-zone-<zone_name>-city-memphis-zip-12345:<zone_password>
```


# Disable peer rotation
Source: https://docs.brightdata.com/api-reference/proxy/keep_same_peer_in_session

Configure the Bright Data Proxy REST API to disable peer rotation on port 44445 and pin sessions, with reference for parameters and response fields.

You can avoid assigning a new peer to the session in case the peer used in the session went offline. When using this option parameter, you will get a `502` error code for your request when that peer used for your session went offline, with error message:

```sh Error Message theme={null}
502 Proxy Error: server_error Failed to establish connection with peer
```

This workflow can be useful for Residential and Mobile proxy zones, which consist of real PCs and mobile devices

It's used by adding `-const` after your session name, for example `-session-mystring12345-const`

```sh Shell theme={null}
curl "http://target.site" --proxy brd.superproxy.io:44445 --proxy-user brd-customer-<customer_id>-zone-<zone_name>-session-mystring12345-const:<zone_password>
```


# OS targeting
Source: https://docs.brightdata.com/api-reference/proxy/os_targeting

Configure the Bright Data Proxy REST API OS Targeting to control request behavior, with reference for parameters and response fields. Connects via port 44445.

Bright Data allows targeting the following **Operating Systems**:

<CodeGroup>
  ```sh Windows theme={null}
  curl "https://target.site" --proxy brd.superproxy.io:44445 --proxy-user brd-customer-<customer_id>-zone-<zone_name>-os-windows:<password>
  ```

  ```sh macOS theme={null}
  curl "https://target.site" --proxy brd.superproxy.io:44445 --proxy-user brd-customer-<customer_id>-zone-<zone_name>-os-osx:<password>
  ```

  ```sh Android theme={null}
  curl "https://target.site" --proxy brd.superproxy.io:44445 --proxy-user brd-customer-<customer_id>-zone-<zone_name>-os-android:<password>
  ```
</CodeGroup>


# Request error handling
Source: https://docs.brightdata.com/api-reference/proxy/request_error_handling

Configure request error handling on the Bright Data Proxy REST API (port 44445) to control request behavior, with reference for parameters and fields.

| value      | description                                                                       |
| ---------- | --------------------------------------------------------------------------------- |
| `pass_dyn` | if a request can't pass via proxy peer, automatically pass it via the Super Proxy |
| `block`    | if a request can't pass via proxy peer, block it and don't send via Super Proxy   |

<CodeGroup>
  ```sh pass_dyn theme={null}
  curl "http://target.site" --proxy brd.superproxy.io:44445 --proxy-user brd-customer-<customer_id>-zone-<zone_name>-route_err-pass_dyn:<zone_password>
  ```

  ```sh block theme={null}
  curl "http://target.site" --proxy brd.superproxy.io:44445 --proxy-user brd-customer-<customer_id>-zone-<zone_name>-route_err-block:<zone_password>
  ```
</CodeGroup>


# Proxy and IP rotation control
Source: https://docs.brightdata.com/api-reference/proxy/rotate_ips

How Bright Data proxy IP rotation works across 4 networks (Datacenter, ISP, Residential, Mobile) and how to control rotation with session parameters.

## Default proxy IP rotation in Shared Pool

Shared pool proxies, also known as "Rotating Proxies" are available in all Bright Data proxy networks: Datacenter, ISP, Residential & Mobile.

By default, Bright Data assigns a random proxy from the available proxies in the zone, according to your configuration.

For example: if you chose to target a specific country, for example Canada, using the `-country=ca` parameter, we will randomly assign a proxy in Canada out of all the proxies located in Canada that we have in the pool.

The next request, will be directed to a different proxy, and so on, selected randomly from our pool. Executing requests in high rate or by multiple calling agents may result in reuse of the same proxy IPs.

## Default proxy IP rotation in dedicated proxy zone

When you configure a set of dedicated proxies dedicated proxies are assigned to your exclusive use in the following manner:

1. In Datacenter and ISP network: proxies are exclusively yours for all domains.
2. In Residential and Mobile networks: are exclusively yours towards **specific domains**.

In dedicated proxy zones we will rotate to next available proxy to serve the next request.

### What are "Static residential" proxies?

"Static residential proxies" are datacenter hosted proxies registered as owned by Internet Service Providers (ISP) and enable have a fixed, static IP address. In Bright Data we name these proxies: "ISP Proxies" and not "Static residential".

### Rotation in dedicated residential proxies

Since residential proxies vary in their availability, we group together a number of proxies to a group which we call `gIP`.  This `gIP` gets a unique identifier, and peers assigned to it (members of the group) are selected according to configuration you specify. For example: if you require 3 dedicated residential ips towards target [http://example.com](http://example.com) ; we will provide 3 `gIPs` which we rotate over to serve your requests.

## Using explicit proxy for multiple requests: `ip`

To explicitly target a request to a specific proxy, use the `-ip` parameter in your proxy zone username request. This is when you issue a set of requests on a different connection (like a sequence of `curl` requests).

## Using the same proxy for multiple requests: `session`

To keep the same proxy IP address for multiple requests, use the `-session` parameter with a session identifier you create and control. Each request, carrying the same `-session` value will be forwarded to the **same proxy IP**.

The `-session` parameter value is generated by you and controlled by you, yet its format should include alphanumeric characters only. Using special characters like `-` or `*` will result in errors.

If you work with native proxy access (within code libraries or 3rd party tools which take proxy ip:port and credentials) then you embed the session parameter in the user name parameter as shown below for session identified `mystring12345`.  If you are using our proxy REST API, then the `session` parameter in request `body` shall carry the session identified value.

```sh Shell theme={null}
curl "http://target.site" --proxy brd.superproxy.io:44445 --proxy-user brd-customer-<customer_id>-zone-<zone_name>-session-mystring12345:<zone_password>
```

## Disable proxy rotation in case of unavailable peer

Our default behavior is to direct your request to another peer in case the peer is unavailable to allow fluent operations. In case you would like to prevent this, and only use a single peer for a session, and fail the request in case the peer is unavailable, add the `-const `option to the `session `parameter.

When using the `-const` option, in case peer is unavailable you will get a `HTTP 502` Error.

```sh Shell theme={null}
curl "http://target.site" --proxy brd.superproxy.io:44445 --proxy-user brd-customer-<customer_id>-zone-<zone_name>-session-mystring12345-const:<zone_password>
```

## Losing session context

The following describes scenarios where session context can be lost, and consequent requests will be executed by **different** proxies.

### Session Idle Time

Session idle time is 5 minutes. In case there are more than 5 minutes idle time between two consequent requests, the second request, although carrying the same `session` parameter as the first, will use a randomly selected proxy from the pool.

### Session origin must be from same global region

In order to keep the same session, you must ensure your calling process issuing the request is not switching between global regions. We recognize 3 global regions:

1. AMER: North, central and south America
2. EMEA: Europe, Middle East and Africa
3. APAC: Asia and Pacific

Example: If you issue 2 consequent requests, one from **your company** server in Canada (in AMER region) and one from **your company server** in France, even if both requests will carry the same `session` parameter, they will be executed by different proxy peers.

### Other parameters must be identical

In case 2 consequent requests carry different country, city or any other parameter: session context will be lost , even if they carry the same `session` parameter.

### Error on lost session

By default, if session is lost or reset, Bright Data will randomly assign a proxy to your request. If you wish to avoid this default assignment, and error instead, use the `-const` parameter in your request. If the same peer is not available from any reason to 2 consequent requests, the second request will result in `HTTP Error 502`

```sh Shell theme={null}
curl "http://target.site" --proxy brd.superproxy.io:44445 --proxy-user brd-customer-<customer_id>-zone-<zone_name>-session-mystring12345-const:<zone_password>
```

## Keeping track of requests and their responses (C-Tag)

We've implemented an optional feature that can greatly help tracking and linking requests with their corresponding responses, see the following article for more information: [more info on C-Tag](/api-reference/proxy/c-tag)


# Select a specific gIP
Source: https://docs.brightdata.com/api-reference/proxy/select_a_specific_gip

Configure the Bright Data Proxy REST API to select a specific gIP on port 44445, with reference for parameters and response fields.

Option available only for Residential or Mobile zones with multiple IPs allocated. To target a specific `gIP` allocated to your zone, use `-gip-gip_name` request parameter.

```sh theme={null}
curl "http://target.site" --proxy brd.superproxy.io:44445 --proxy-user brd-customer-<customer_id>-zone-<zone_name>-gip-us_7922_fl_hollywood_0:<zone_password>
```


# Select a specific IP
Source: https://docs.brightdata.com/api-reference/proxy/select_a_specific_ip

Configure the Bright Data Proxy REST API to select a specific IP on port 44445, with reference for parameters and response fields.

Option available only for zones with multiple IPs allocated. To target a specific IP allocated to your zone, use -ip-ip\_address request parameter.

```sh Shell theme={null}
curl "http://target.site" --proxy brd.superproxy.io:44445 --proxy-user brd-customer-<customer_id>-zone-<zone_name>-ip-1.2.3.4:<zone_password>
```


# Select super proxy by country
Source: https://docs.brightdata.com/api-reference/proxy/select_super_proxy_in_specific_country

Configure a Bright Data super proxy in a specific country using the -country flag in shared zones or via dedicated zone settings. Connects via port 44445.

Important note: This article is relevant ONLY for choosing a 'super proxy', which is rarely needed. In order to select a specific standard proxy (for example, Residential Proxy, Datacenter proxy or ISP proxy)

* In **Shared proxy zones**, you can add the '-country' flag (and also '-city') to your proxy username like this: username-country-country\_code-city-city\_code. Country codes are standard 2-character codes. The city\_code must be in lowercase only and have no spaces, for example -city-sanfrancisco.

* In **Dedicated proxy zones**, you can select the countries and cities in your zone configuration page by following these steps:

  1. Add a new proxy zone and set the IP type to 'Dedicated'

  2. Choose the domains you would like to target with this zone.

  3. Select the number of dedicated proxies you want to allocate to your zone

  4. Select the countries you want to target

  5. Optional - After selecting the countries you want, click 'Add city' next to each country you want to target in city resolution

  6. Add the chosen cities for each country and save the zone.

  7. Your new Dedicated proxy zone will allocate the number of grproxies you requested evenly between the countries and cities you selected.

If you actualy require our load balancer to provide a super proxy in a specific country:

<Note>
  If no specific server country is selected, Bright Data will automatically choose the optimal load-balancing server for speed. If speed is your primary concern, use this feature with caution, as it may negatively impact performance over time.
</Note>

Choosing the super proxy country can be done like this: `servercountry-{country}`.brd.superproxy.io. E.g. `servercountry-gb.brd.superproxy.io`

```sh Shell theme={null}
curl "https://example.com" --proxy servercountry-gb.brd.superproxy.io:44445 --proxy-user brd-customer-<customer_id>-zone-<zone_name>:<zone_password>
```


# Send requests directly from super proxy
Source: https://docs.brightdata.com/api-reference/proxy/send_requests_directly_from_super_proxy

Configure the Bright Data Proxy REST API to send requests directly from Super Proxy on port 44445, with reference for parameters and response fields.

You can choose to perform the request from the super proxy directly instead of the IP of the peer. In that case, the IP of the request will be the one of the Super Proxy by adding `-direct` to your request authorization string.

```sh Shell theme={null}
curl "http://target.site" --proxy brd.superproxy.io:44445 --proxy-user brd-customer-<customer_id>-zone-<zone_name>-direct:<zone_password>
```


# AI job progress
Source: https://docs.brightdata.com/api-reference/scraper-studio-api/ai-flow/ai-job-progress

api-reference/web-scraper-ide-rest-api GET /dca/collectors/{collector_id}/automate_template/progress
Use the Bright Data Scraper Studio AI Flow API to get AI job progress. Returns 200 OK with AI scraper template or job progress data as JSON.



# Create scraper template
Source: https://docs.brightdata.com/api-reference/scraper-studio-api/ai-flow/create-scraper-template

api-reference/web-scraper-ide-rest-api POST /dca/collector
Use the Bright Data Scraper Studio AI Flow API to create a scraper template. POST /dca/collector returns 200 OK with AI scraper template or job status as JSON.



# Understanding the AI Scraper Studio APIs
Source: https://docs.brightdata.com/api-reference/scraper-studio-api/ai-flow/overview

Bright Data Scraper Studio AI Flow API overview, covering 5 endpoints. Returns AI scraper template or job progress data as JSON with 200 OK on success.

The AI Scraper Studio API is a set of endpoints that let you create Scraper Studio scrapers with AI and update existing scrapers using Self-Healing tool, without using the UI. This page explains which endpoint to call and in what order.

Both flows are asynchronous: you start an AI job, then check its progress until it completes.

## Workflow 1: Create a new scraper with AI

Use these endpoints when you want AI to generate a scraper (schema + code) from scratch for a target site.

1. Create the scraper entity\
   → <Badge><a href="/api-reference/scraper-studio-api/ai-flow/create-scraper-template">Create scraper template</a></Badge>

2. Start the AI generation job (schema + code)\
   → <Badge><a href="/api-reference/scraper-studio-api/ai-flow/trigger-ai-flow">Trigger AI Flow to create code</a></Badge>

3. Poll until the AI job finishes and returns the result\
   → <Badge><a href="/api-reference/scraper-studio-api/ai-flow/ai-job-progress">AI job progress</a></Badge>

## Workflow 2: Update an existing scraper with Self-Healing

Use these endpoints when you already have a scraper and want to fix or modify it using a prompt.

1. Start a Self-Healing refactor job\
   → <Badge><a href="/api-reference/scraper-studio-api/ai-flow/trigger-self-healing">Trigger Self-Healing</a></Badge>

2. Poll until the refactor job finishes or pauses for user input\
   → <Badge><a href="/api-reference/scraper-studio-api/ai-flow/self-healing-job-progress">Self-Healing job progress</a></Badge>

3. If progress returns `status: "pending_answer"`, approve or reject the proposed diff\
   → <Badge><a href="/api-reference/scraper-studio-api/ai-flow/resume-self-healing-job">Resume Self-Healing job</a></Badge>

4. After the scraper is ready, initiate collection\
   → <Badge><a href="/api-reference/scraper-studio-api/Trigger_a_scraper_for_batch_collection_method">Initiate collection</a></Badge>

Once created or updated, run it using the standard Scraper Studio API initiation endpoints (manual trigger, schedule, queue, etc.).

<Columns>
  <Tip>
    **Not sure which to use?**

    * No scraper yet → [Workflow 1](#workflow-1-create-a-new-scraper-with-ai)
    * Scraper needs changes → [Workflow 2](#workflow-2-update-an-existing-scraper-with-self-healing)
  </Tip>

  <Tip>
    **New to the API?**

    See: <a href="/datasets/scraper-studio/quickstart">Getting started with the API</a>
  </Tip>
</Columns>


# Resume Self-Healing Job
Source: https://docs.brightdata.com/api-reference/scraper-studio-api/ai-flow/resume-self-healing-job

api-reference/web-scraper-ide-rest-api POST /dca/collectors/{collector_id}/resume_automation_job
Use the Bright Data Scraper Studio AI Flow API to approve or reject a Self-Healing job paused at pending_answer. Returns 200 OK with no body.



# Self-Healing Job Progress
Source: https://docs.brightdata.com/api-reference/scraper-studio-api/ai-flow/self-healing-job-progress

api-reference/web-scraper-ide-rest-api GET /dca/collectors/{collector_id}/refactor_template/progress
Use the Bright Data Scraper Studio AI Flow API to get self-healing job progress. Returns 200 OK with AI scraper template or job progress data as JSON.



# Trigger AI Flow
Source: https://docs.brightdata.com/api-reference/scraper-studio-api/ai-flow/trigger-ai-flow

api-reference/web-scraper-ide-rest-api POST /dca/collectors/{collector_id}/automate_template
Use the Bright Data Scraper Studio AI Flow API to trigger AI Flow. Returns 200 OK with AI scraper template or job progress data as JSON.



# Trigger Self-Healing
Source: https://docs.brightdata.com/api-reference/scraper-studio-api/ai-flow/trigger-self-healing

api-reference/web-scraper-ide-rest-api POST /dca/collectors/{collector_id}/refactor_template
Use the Bright Data Scraper Studio AI Flow API to trigger self-healing. Returns 200 OK with AI scraper template or job progress data as JSON.



# List Scraper Studio jobs
Source: https://docs.brightdata.com/api-reference/scraper-studio-api/list-jobs

api-reference/web-scraper-ide-rest-api GET /dca/collector/jobs
GET /dca/collector/jobs returns the Scraper Studio jobs in your account. Filter by scraper ID and date range, and paginate with offset and limit.

Use `GET /dca/collector/jobs` to retrieve the Bright Data Scraper Studio jobs in your account. Filter the list by scraper ID and date range, and control pagination with `offset` and `limit`.

`from_date` and `to_date` are required. Use a narrower date range for faster responses and easier pagination.

<Note>
  Pass a scraper ID as the `collector` parameter to return only that scraper's jobs. Get scraper IDs from [List Scrapers](./list-scrapers).
</Note>

## Filter, paginate and sort

* **Filter by scraper.** Pass a scraper ID as the `collector` parameter to return only that scraper's jobs. Get IDs from [List Scrapers](./list-scrapers).
* **Paginate.** Use `offset` and `limit` to page through jobs. To retrieve the next page, increase `offset` by the previous `limit`, for example `offset=0&limit=100`, then `offset=100&limit=100`. `limit` must be between 0 and 500.
* **Sort.** Use `sort_asc=1` for ascending order or `sort_asc=-1` for descending order. The default is `-1`.

## When to use this endpoint

* Build a dashboard that lists recent jobs for a scraper across a date range
* Audit job history and compute success rates from `inputs`, `data_lines` and `failed_pages`
* Look up job IDs, then fetch per-job metadata with [Job data](./job-data)
* Spot scrapers that need attention by watching `failed_pages`

## Errors

| Status             | Cause                                         | Fix                                                                             |
| ------------------ | --------------------------------------------- | ------------------------------------------------------------------------------- |
| `400 Bad Request`  | Missing or malformed `from_date` or `to_date` | Send both dates in `YYYY-MM-DD` format                                          |
| `401 Unauthorized` | Token missing, malformed or revoked           | Re-copy from [Account Settings → API Tokens](https://brightdata.com/cp/setting) |
| `5xx`              | Transient Bright Data API error               | Retry with exponential backoff, for example 1s, 2s, 4s                          |

## Related

* [List Scrapers](./list-scrapers): find the scraper `id` to pass as the `collector` parameter
* [Job data](./job-data): job-level metadata for a single job
* [Receive batch data](./Receive_batch_data): download the records a job produced
* [Trigger async batch collection](./Trigger_a_scraper_for_batch_collection_method): the endpoint that creates jobs


# List Scraper Studio scrapers
Source: https://docs.brightdata.com/api-reference/scraper-studio-api/list-scrapers

api-reference/web-scraper-ide-rest-api GET /dca/collectors_list
GET /dca/collectors_list returns the Scraper Studio scrapers in your account, with each scraper's ID, name, active status, delivery config and output schema.

Use `GET /dca/collectors_list` to retrieve the Bright Data Scraper Studio scrapers available in your account. The response includes scraper IDs, names, active status, delivery configuration, last run time and the output schema when available.

<Note>
  Use this endpoint to discover the scraper `id` values in your account, then pass an `id` as the `collector` parameter when you [trigger a scraper](./Trigger_a_scraper_for_batch_collection_method).
</Note>

## Search scrapers

Use the `search` query parameter to return only scrapers whose name matches a search term, for example `?search=amazon`. Omit `search` to return every scraper in the account.

## When to use this endpoint

* Look up the `id` of a scraper before triggering a batch or real-time job
* Build a picker that lists every scraper in your account
* Audit which scrapers are `active` and which have run before (`last_run`)
* Read the `output_schema` to map returned fields before parsing records

## Errors

| Status             | Cause                               | Fix                                                                             |
| ------------------ | ----------------------------------- | ------------------------------------------------------------------------------- |
| `401 Unauthorized` | Token missing, malformed or revoked | Re-copy from [Account Settings → API Tokens](https://brightdata.com/cp/setting) |
| `5xx`              | Transient Bright Data API error     | Retry with exponential backoff, for example 1s, 2s, 4s                          |

## Related

* [List Jobs](./list-jobs): list the jobs a scraper has run
* [Trigger async batch collection](./Trigger_a_scraper_for_batch_collection_method): pass the scraper `id` as the `collector` parameter
* [Job data](./job-data): job-level metadata for a triggered scraper
* [Receive batch data](./Receive_batch_data): download the records a scraper produced


# All classification data
Source: https://docs.brightdata.com/api-reference/scraping-shield-api/all-classification-data

api-reference/scraping-shield-rest-api GET /shield/class
Use the Bright Data Scraping Shield API to retrieve all Classification Data. GET /shield/class returns 200 OK with site classification data as JSON.



# Domains by classification
Source: https://docs.brightdata.com/api-reference/scraping-shield-api/domains-by-classification-data

api-reference/scraping-shield-rest-api GET /shield/domains_by_class
Use the Bright Data Scraping Shield API to retrieve domains by Classification. GET /shield/domains_by_class returns 200 OK with site data as JSON.



# Samples by classification
Source: https://docs.brightdata.com/api-reference/scraping-shield-api/samples-by-classification-data

api-reference/scraping-shield-rest-api GET /shield/samples
Use the Bright Data Scraping Shield API to retrieve samples by Classification. GET /shield/samples returns 200 OK with site classification data as JSON.



# Zone by classification
Source: https://docs.brightdata.com/api-reference/scraping-shield-api/zones-by-classification-data

api-reference/scraping-shield-rest-api GET /shield/zones_by_class
Use the Bright Data Scraping Shield API to retrieve API zone by Classification. GET /shield/zones_by_class returns 200 OK with site data as JSON.



# Send your first request
Source: https://docs.brightdata.com/api-reference/unlocker/sending_first_request

Send your first Bright Data Web Unlocker API (98% success rate) request. Walk through authentication, setup and a cURL example that returns unblocked HTML.

Here's an example of the most simple Web Unlocker API request using cURL that returns a JSON:

```sh theme={null}
curl "https://geo.brdtest.com/welcome.txt" --proxy brd.superproxy.io:44445 --proxy-user brd-customer-<customer_id>-zone-<zone_name>:<zone_password>
```

You can find your API credentials including Username (`Customer_ID`), Zone name, and Password, within your proxy zone’s ‘Overview’ tab.

|                                                                                    |                                                                                                                         |
| ---------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------- |
| `brd.superproxy.io`                                                                | Address of our load balancer that will find the fastest Super Proxy for your request                                    |
| <Tooltip>[`44445`](/general/faqs#which-port-shall-i-use-22225-or-33335) </Tooltip> | Infrastructure port of our Super Proxies that is used to receive your requests                                          |
| `-user brd-customer-<customer_id>-zone-<zone_name>`                                | Username authentication. In its most basic form, it defines your username and what zone you will use for your request.  |
| `<zone_password>`                                                                  | Zone password. All zones have passwords that are used for authentication                                                |
| [https://geo.brdtest.com/welcome.txt](https://geo.brdtest.com/welcome.txt)         | Replace with your target domain. This is a test URL pointing to a Bright Data test server.                              |

For an in-depth interactive display of all the API use cases, integrations, and preferences, please see our [API examples](https://brightdata.com/cp/zones/proxy_examples) page.

<Tip>
  You'll need to [sign up](https://brightdata.com/) (for free), and **login** to the Bright Data control panel in order to access this API tool. If you add your payment method, you’ll even receive a \$5 credit to get you started!
</Tip>


# Zone statistics
Source: https://docs.brightdata.com/api-reference/account-management-api/Get_Zone_Static_Datacenter_ISP_IPs

api-reference/openapi GET /zone/ips
Use the Bright Data Account Management API to zone Statistics. GET /zone/ips returns 200 OK with zone or account configuration data as JSON.

<Tip>
  Paste your API key to the authorization field. To get an API key, [Create an account](https://brightdata.com/?hs_signup=1\&utm_source=docs\&utm_campaign=playground) and learn [how to generate an API key](/api-reference/authentication#how-do-i-generate-a-new-api-key%3F)
</Tip>

```json Response when "ip_per_country=true" theme={null}
{
    "gb":198,
    "de":282,
    "br":418,
    "au":115,
    "jp":292,
    "nl":421,
    "uz":333,
    "il":517,
    "kg":566,
    "az":498,
    "lv":484,
    "tw":372,
    "sg":184
}
```


# Zone info
Source: https://docs.brightdata.com/api-reference/account-management-api/Get_Zone_info

api-reference/openapi GET /zone
Use the Bright Data Account Management API to zone info. GET /zone returns 200 OK with zone or account configuration data as JSON.

<Tip>
  Paste your API key to the authorization field. To get an API key, [Create an account](https://brightdata.com/?hs_signup=1\&utm_source=docs\&utm_campaign=playground) and learn [how to generate an API key](/api-reference/authentication#how-do-i-generate-a-new-api-key%3F)
</Tip>


# Zone password
Source: https://docs.brightdata.com/api-reference/account-management-api/Get_Zone_passwords

api-reference/openapi GET /zone/passwords
Use the Bright Data Account Management API to zone Password. GET /zone/passwords returns 200 OK with zone or account configuration data as JSON.

<Tip>
  Paste your API key to the authorization field. To get an API key, [Create an account](https://brightdata.com/?hs_signup=1\&utm_source=docs\&utm_campaign=playground) and learn [how to generate an API key](/api-reference/authentication#how-do-i-generate-a-new-api-key%3F)
</Tip>


# Zone permission
Source: https://docs.brightdata.com/api-reference/account-management-api/Get_Zone_permissions

api-reference/openapi GET /zone/permissions
Use the Bright Data Account Management API to zone Permission. GET /zone/permissions returns 200 OK with zone or account configuration data as JSON.

<Tip>
  Paste your API key to the authorization field. To get an API key, [Create an account](https://brightdata.com/?hs_signup=1\&utm_source=docs\&utm_campaign=playground) and learn [how to generate an API key](/api-reference/authentication#how-do-i-generate-a-new-api-key%3F)
</Tip>


# Zone status
Source: https://docs.brightdata.com/api-reference/account-management-api/Get_Zone_status

api-reference/openapi GET /zone/status
Use the Bright Data Account Management API to zone status. GET /zone/status returns 200 OK with zone or account configuration data as JSON.

<Tip>
  Paste your API key to the authorization field. To get an API key, [Create an account](https://brightdata.com/?hs_signup=1\&utm_source=docs\&utm_campaign=playground) and learn [how to generate an API key](/api-reference/authentication#how-do-i-generate-a-new-api-key%3F)
</Tip>


# Live status of static zone
Source: https://docs.brightdata.com/api-reference/account-management-api/Get_live_status_of_Static_Datacenter_ISP_Zone_and_IPs_with_connectivity_problem

api-reference/openapi GET /zone/ips/unavailable
Use the Bright Data Account Management API to live status of Static Zone. GET /zone/ips/unavailable returns 200 OK with zone or account JSON.

<Tip>
  Paste your API key to the authorization field. To get an API key, [Create an account](https://brightdata.com/?hs_signup=1\&utm_source=docs\&utm_campaign=playground) and learn [how to generate an API key](/api-reference/authentication#how-do-i-generate-a-new-api-key%3F)
</Tip>


# Total balance
Source: https://docs.brightdata.com/api-reference/account-management-api/Get_total_balance_through_API

api-reference/openapi GET /customer/balance
Use the Bright Data Account Management API to total Balance. GET /customer/balance returns 200 OK with zone or account configuration data as JSON.

<Tip>
  Paste your API key to the authorization field. To get an API key, [Create an account](https://brightdata.com/?hs_signup=1\&utm_source=docs\&utm_campaign=playground) and learn [how to generate an API key](/api-reference/authentication#how-do-i-generate-a-new-api-key%3F)
</Tip>


# Remove static IPs (Datacenter/ISP)
Source: https://docs.brightdata.com/api-reference/account-management-api/Remove_Static_Datacenter_ISP_IPs

api-reference/openapi DELETE /zone/ips
Use the Bright Data Account Management API to remove Static IPs (Datacenter/ISP). DELETE /zone/ips returns 200 OK with zone or account JSON.

<Warning>Only users with **Admin** or **Ops** roles can perform this action.</Warning>

<Warning> **Warning:** This API can modify your account settings, damage your operations or incur charges.</Warning>

<Tip>
  Paste your API key to the authorization field. To get an API key, [Create an account](https://brightdata.com/?hs_signup=1\&utm_source=docs\&utm_campaign=playground) and learn [how to generate an API key](/api-reference/authentication#how-do-i-generate-a-new-api-key%3F)
</Tip>


# Remove a zone
Source: https://docs.brightdata.com/api-reference/account-management-api/Remove_Zone

api-reference/openapi DELETE /zone
Use the Bright Data Account Management API to remove a Zone. DELETE /zone returns 200 OK with zone or account configuration data as JSON.

<Warning>Only users with **Admin** or **Ops** roles can perform this action.</Warning>

<Warning> **Warning:** This API can modify your account settings, damage your operations or incur charges.</Warning>

<Tip>
  Paste your API key to the authorization field. To get an API key, [Create an account](https://brightdata.com/?hs_signup=1\&utm_source=docs\&utm_campaign=playground) and learn [how to generate an API key](/api-reference/authentication#how-do-i-generate-a-new-api-key%3F)
</Tip>


# Remove dedicated residential IPs
Source: https://docs.brightdata.com/api-reference/account-management-api/Remove_dedicated_residential_IPs

api-reference/openapi DELETE /zone/vips
Use the Bright Data Account Management API to remove dedicated residential IPs. DELETE /zone/vips returns 200 OK with zone or account JSON.

<Warning>Only users with **Admin** or **Ops** roles can perform this action.</Warning>

<Warning> **Warning:** This API can modify your account settings, damage your operations or incur charges.</Warning>

<Tip>
  Paste your API key to the authorization field. To get an API key, [Create an account](https://brightdata.com/?hs_signup=1\&utm_source=docs\&utm_campaign=playground) and learn [how to generate an API key](/api-reference/authentication#how-do-i-generate-a-new-api-key%3F)
</Tip>


# Switch automatic failover
Source: https://docs.brightdata.com/api-reference/account-management-api/Switch_100_uptime_ON_OFF_in_a_Static_zone

api-reference/openapi POST /zone/switch_100uptime
Use the Bright Data Account Management API to switch Automatic Failover. POST /zone/switch_100uptime returns the requested zone or account configuration data.

<Warning> **Warning:** This API can modify your account settings, damage your operations or incur charges. </Warning>

<Tip>
  Paste your API key to the authorization field. To get an API key, [Create an account](https://brightdata.com/?hs_signup=1\&utm_source=docs\&utm_campaign=playground) and learn [how to generate an API key](/api-reference/authentication#how-do-i-generate-a-new-api-key%3F)
</Tip>


# Turn on/off zone
Source: https://docs.brightdata.com/api-reference/account-management-api/Turn_on_off_Zone

api-reference/openapi POST /zone/change_disable
Use the Bright Data Account Management API to turn on/off Zone. POST /zone/change_disable returns 200 OK with zone or account configuration data as JSON.

<Warning>Only users with **Admin** or **Ops** roles can perform this action.</Warning>

<Warning> **Warning:** This API can modify your account settings, damage your operations or incur charges.</Warning>

<Tip>
  Paste your API key to the authorization field. To get an API key, [Create an account](https://brightdata.com/?hs_signup=1\&utm_source=docs\&utm_campaign=playground) and learn [how to generate an API key](/api-reference/authentication#how-do-i-generate-a-new-api-key%3F)
</Tip>


# Add zone password
Source: https://docs.brightdata.com/api-reference/account-management-api/add-zone-password

api-reference/openapi POST /zone/add_password
Use the Bright Data Account Management API to add Zone Password. POST /zone/add_password returns 200 OK with zone or account configuration data as JSON.

<Warning>Only users with **Admin** or **Ops** roles can perform this action.</Warning>

<Note>
  To add multiple passwords in a single request, pass an array of strings to the `password` field.
</Note>


# Domain consumption
Source: https://docs.brightdata.com/api-reference/account-management-api/domain-consumption

api-reference/proxy-manager GET /domains/{metric}
Retrieve per-domain usage metrics including bandwidth and request count from the Bright Data Domain Consumption API. Returns 200 OK with JSON results.

## Sample Requests

<CodeGroup>
  ```sh All zones theme={null}
  curl --request GET \
    --url 'api.brightdata.com/domains/bw?from=2025-12-01&to=2025-12-10' \
    --header 'Authorization: Bearer API_KEY'
  ```

  ```sh Bandwidth by zone theme={null}
  curl --request GET \
    --url 'api.brightdata.com/domains/bw?from=2025-12-01&to=2025-12-10&zones=zone_name' \
    --header 'Authorization: Bearer API_KEY'
  ```

  ```sh Requests by zone theme={null}
  curl --request GET \
    --url 'api.brightdata.com/domains/req?from=2025-12-01&to=2025-12-10&zones=zone_name' \
    --header 'Authorization: Bearer API_KEY'
  ```
</CodeGroup>


# Get proxies pending replacement
Source: https://docs.brightdata.com/api-reference/account-management-api/get-proxies-pending-replacement

api-reference/openapi GET /zone/proxies_pending_replacement
Use the Bright Data Account Management API to get Proxies Pending Replacement via GET /zone/proxies_pending_replacement, returning a 200 OK JSON response.



# Remove domain from allow/denylist
Source: https://docs.brightdata.com/api-reference/account-management-api/remove-domain-from-zone-allowlist-or-denylist

api-reference/openapi DELETE /zone/domain_perm
Use the Bright Data Account Management API to remove domain from allow/denylist via DELETE /zone/domain_perm, returning JSON zone or account data with 200 OK.

<Warning>Only users with **Admin** or **Ops** roles can perform this action.</Warning>

<Warning> **Warning:** This API can modify your account settings, damage your operations or incur charges.</Warning>

<Tip>
  Paste your API key to the authorization field. To get an API key, [Create an account](https://brightdata.com/?hs_signup=1\&utm_source=docs\&utm_campaign=playground) and learn [how to generate an API key](/api-reference/authentication#how-do-i-generate-a-new-api-key%3F)
</Tip>


# Remove IP from zone allowlist
Source: https://docs.brightdata.com/api-reference/account-management-api/remove-ip-from-zone-allowlist

api-reference/openapi DELETE /zone/whitelist
Use the Bright Data Account Management API to remove IP from Zone allowlist. DELETE /zone/whitelist returns 200 OK with zone or account JSON.

<Warning>Only users with **Admin** or **Ops** roles can perform this action.</Warning>

<Warning> **Warning:** This API can modify your account settings, damage your operations or incur charges.</Warning>

<Tip>
  Paste your API key to the authorization field. To get an API key, [Create an account](https://brightdata.com/?hs_signup=1\&utm_source=docs\&utm_campaign=playground) and learn [how to generate an API key](/api-reference/authentication#how-do-i-generate-a-new-api-key%3F)
</Tip>


# Remove IP from zone denylist
Source: https://docs.brightdata.com/api-reference/account-management-api/remove-ip-from-zone-denylist

api-reference/openapi DELETE /zone/blacklist
Use the Bright Data Account Management API to remove IP from Zone denylist. DELETE /zone/blacklist returns 200 OK with zone or account JSON.

<Warning>Only users with **Admin** or **Ops** roles can perform this action.</Warning>

<Warning> **Warning:** This API can modify your account settings, damage your operations or incur charges.</Warning>

<Tip>
  Paste your API key to the authorization field. To get an API key, [Create an account](https://brightdata.com/?hs_signup=1\&utm_source=docs\&utm_campaign=playground) and learn [how to generate an API key](/api-reference/authentication#how-do-i-generate-a-new-api-key%3F)
</Tip>


# Remove zone password
Source: https://docs.brightdata.com/api-reference/account-management-api/remove-zone-password

api-reference/openapi POST /zone/remove_password
Use the Bright Data Account Management API to remove Zone Password. POST /zone/remove_password returns 200 OK with zone or account configuration data as JSON.

<Warning>Only users with **Admin** or **Ops** roles can perform this action.</Warning>

<Warning>
  A zone must always have at least one password. This request will fail if removing the specified password(s) would leave the zone with no passwords.
</Warning>

<Note>
  To remove multiple passwords in a single request, pass an array of strings to the `password` field.
</Note>


# List of allowlisted IPs for a zone
Source: https://docs.brightdata.com/api-reference/account-management-api/zone-ip-allowlist

api-reference/openapi GET /zone/whitelist
Use the Bright Data Account Management API to list of allowlisted IPs for a zone. GET /zone/whitelist returns 200 OK with zone or account JSON.

<Tip>
  Paste your API key to the authorization field. To get an API key, [Create an account](https://brightdata.com/?hs_signup=1\&utm_source=docs\&utm_campaign=playground) and learn [how to generate an API key](/api-reference/authentication#how-do-i-generate-a-new-api-key%3F)
</Tip>


# List of denylisted IPs for a zone
Source: https://docs.brightdata.com/api-reference/account-management-api/zone-ip-denylist

api-reference/openapi GET /zone/blacklist
Use the Bright Data Account Management API to list of denylisted IPs for a zone. GET /zone/blacklist returns 200 OK with zone or account JSON.

<Tip>
  Paste your API key to the authorization field. To get an API key, [Create an account](https://brightdata.com/?hs_signup=1\&utm_source=docs\&utm_campaign=playground) and learn [how to generate an API key](/api-reference/authentication#how-do-i-generate-a-new-api-key%3F)
</Tip>


# Billing
Source: https://docs.brightdata.com/general/account/billing-and-pricing/billing

Understand how Bright Data billing works in 4 areas: monthly commitments, pay-as-you-go funds and how usage limits apply to your account.

<Info>
  All of the prices posted on our website are the US Dollar prices
</Info>

<AccordionGroup>
  <Accordion title="How Bright Data billing works?">
    **A minimum monthly commitment** - Each plan requires you to commit to paying a minimum amount at the beginning of every month while your account is in “active” status. This minimum commitment will set the limits for your basic usage: once your usage goes over your minimum commitment amount, you will need to add additional funds to keep using Bright Data.

    <Note>
      Learn more at our [pricing page](https://brightdata.com/pricing).
    </Note>
  </Accordion>

  <Accordion title="How do I re-verify my account to clear a billing issue?">
    If your account was blocked, you will immediately receive an email explaining how to resolve the issue. Contact your dedicated account manager or Bright Data's compliance team at [compliance@brightdata.com](mailto:compliance@brightdata.com). To reinstate your blocked account, you will need to provide the following:

    <Tabs>
      <Tab title="Registered Companies">
        * A company registration form
        * A photo of the flagged payment method
      </Tab>

      <Tab title="Non Registered Companies">
        * Photo ID, driver's license, or passport
        * A photo of the flagged payment method
      </Tab>
    </Tabs>
  </Accordion>

  <Accordion title="How does the Bright Data billing cycle work if I am only using data-center IPs?">
    When customers only use data-center IPs, we calculate their cost on a daily basis. We subtract this daily cost from the current balance in your account, showing the remaining balance available for use. Costs are calculated according to the IP types used (shared vs. dedicated), as well as bandwidth/GB used. We also calculate any additional costs for added features (like exclusive time or dedicated domain/host).\
    You will be billed for the costs described above on the 1st of every month. The balance remaining in your account will reflect the amount available for future use.
  </Accordion>

  <Accordion title="How does the Bright Data billing cycle works?">
    Bright Data's billing cycle starts on the 1st of each month. This means that you will be billed for your monthly account commitment automatically at the 1st of every month as long as your account status is active.
  </Accordion>

  <Accordion title="What happens if I join Bright Data in the middle of the billing cycle (in the middle of the month)?">
    If you join Bright Data in the middle of the month, your first minimum account commitment payment will be charged on the day you join and usage will retroactively apply only to the days in which your account was active during the month.

    **Example**: You join the Bright Data Residential Network on the June 25th, your price plan has a \$500 minimum monthly commitment and you make your first payment of \$500.

    What will happen on July 1st?

    * Bright Data will see your account was active for only 6 days during June which are 20% of the month, so the relative part of the minimum monthly commitment will be \$100. Unless the cost of your usage was higher than that, \$100 will be your cost for June.
    * We will send you an invoice and take \$100 from your balance against June cost, leaving your balance with \$400.
    * Since on the 1st of every month your balance needs to comply with your minimum monthly commitment, we will now charge your credit card for \$100 in order to top it back to \$500 to comply with your minimum monthly commitment for July.
  </Accordion>

  <Accordion title="Will I receive an invoice?">
    Yes. You will receive an invoice by the third Israeli business day of the month. The invoice will provide details of your previous month's usage. It will breakdown how your usage related to your minimum account commitment (and if applicable, any additional funds that were added during the course of the month).
  </Accordion>

  <Accordion title="What is the time zone used for my billing cycle?">
    All billing calculations are made according to our dashboard timezone which is UTC+0. How this can effect your billing? You have the option to enable and disable your Zones. The time of enabling/disabling will be in UTC time therefore the daily charges will be applied accordingly.
  </Accordion>

  <Accordion title="I will not be using Bright Data on a daily basis but on a per-project basis. Do I still need to pay the entire minimum monthly commitment?">
    ### Proxy services billing

    Proxy services are either prepaid per amount of proxies (IP addresses) or per usage.

    | Network type          | Proxy type                | Payment type                    | Notes                                                                 |
    | --------------------- | ------------------------- | ------------------------------- | --------------------------------------------------------------------- |
    | Datacenter            | Shared pool               | per GB                          | No usage: no payment.                                                 |
    | Datacenter            | Shared unlimited          | Prepaid per IP                  | Resumes monthly by default                                            |
    | Datacenter            | Dedicated unlimited       | Prepaid per IP                  | Resumes monthly by default                                            |
    | ISP                   | Shared pool               | per GB                          | No usage: no payment.                                                 |
    | ISP                   | Shared unlimited          | Prepaid per IP                  | Resumes monthly by default                                            |
    | ISP                   | Dedicated unlimited       | Prepaid per IP                  | Resumes monthly by default                                            |
    | Residential shared    | All: IPv4,IPv4+IPv6, IPv6 | per GB                          | No usage, no payment                                                  |
    | Residential dedicated | Dedicated `gIP`s          | Fixed charge per `gIP` + per GB | `gIP` charges resume monthly by default, charged on the 1st, prorated |

    ### Non proxy services

    During time periods where you are not using Bright Data, you can turn off your Zones. Billing for service will only apply for the relative part of the month when the service was active. All billing calculations are made according to our dashboard timezone which is UTC+0. How this can effect your billing? You have the option to enable and disable your Zones. The time of enabling/disabling will be in UTC time therefore the daily charges will be applied accordingly.
  </Accordion>

  <Accordion title="What happens if I process a chargeback dispute?">
    In case you process a credit card chargeback or bank dispute and the reason is unjustified, Bright Data will charge a handling fee of \$150 per charge.
  </Accordion>

  <Accordion title="Why was my account blocked due to billing issues?">
    An account is blocked due to billing issues for one of the following reasons:

    * A discrepancy between payment method and personal details
    * The user has logged in from a country that differs from where the credit card is from
    * Too many attempts to process a declined payment
    * Failure to authenticate a credit card payment using 3D secure
  </Accordion>

  <Accordion title="How to add users to the invoice recipients list?">
    To add an email address to invoice recipients list, please follow the below guide

    <Steps>
      <Step title="Click the &#x22;Billing&#x22; button on the Control Panel sidebar" />

      <Step title="Scroll down the page" />

      <Step title="In the &#x22;Invoice recipients&#x22; screen, click on the &#x22;+ Add new recipient&#x22; button button">
        <Frame>
          <img alt="invoice_recipients_1.png" />
        </Frame>
      </Step>

      <Step title="Add name and email address">
        <Frame>
          <img alt="invoice_recipients_2.png" />
        </Frame>
      </Step>

      <Step title="Click on the &#x22;Add&#x22; button">
        <Frame>
          <img alt="invoice_recipients_3.png" />
        </Frame>
      </Step>
    </Steps>
  </Accordion>

  <Accordion title="What if my account is not in “active” status for the entire month?">
    If you have remaining funds in your balance during a month in which you were inactive, you will not lose your balance, but will be charged to bring that balance up to the minimum monthly commitment on the 1st day of the next month.

    <Frame>
      <img alt="suspend-account.gif" />
    </Frame>
  </Accordion>

  <Accordion title="How can I prevent suspension of my account?">
    To ensure that your account is never suspended, we highly recommend that you use our automatic recharging option. It can be activated in the “billing” section of your account and ensures uninterrupted service. Auto recharge starts to work when your available balance drops below 85% of the total account balance. The amount set is entirely up to you and can be of any denomination.

    <Frame>
      <img alt="billing.png" />

      <img alt="payment-settings.png" />

      <img alt="confirm.png" />
    </Frame>
  </Accordion>

  <Accordion title="How does the first deposit matching offer work?">
    When you make your first deposit into your account, we will match it dollar-for-dollar.
  </Accordion>

  <Accordion title="What is the maximum bonus I can receive?">
    We will match your deposit up to a maximum of \$500. For example, if you deposit \$500, you will receive an additional \$500 in promotional credits. If you deposit \$600, you will still receive the maximum of \$500 in credits.
  </Accordion>

  <Accordion title=" Is there a time limit to use the bonus credits?">
    Yes. The matched promotional credits must be used within 90 days from the date they are added to your account.
  </Accordion>

  <Accordion title=" Are there any requirements to keep the bonus credits active?">
    Yes. To maintain the bonus, you must have a minimum account usage of \$5 per month. If your usage drops below this amount, the remaining bonus credits may be forfeited.
  </Accordion>
</AccordionGroup>


# About the Bright Rewards program
Source: https://docs.brightdata.com/general/account/billing-and-pricing/bright-rewards-program

Earn Bright Points each month based on Bright Data spending and redeem them as account credit when adding funds. Higher monthly spend unlocks larger rewards.

## Earn & redeem points

The **Bright Rewards** program allows you to earn **points** based on your monthly spending. The more you use, the more you save!\
Key benefits:

* Earn rewards automatically based on your usage
* Redeem your credits easily when adding funds
* Higher spending unlocks greater rewards

### **How to Redeem Your Bright Rewards**

You have two ways to redeem your Bright Rewards points:\
Go to the [billing section](https://brightdata.com/cp/billing/overview) in the control panel, then:

* Click the "Redeem" button in the Bright Rewards section.

Or

* Use the "Add Funds" button to redeem your points.

<Frame>
  <img alt="earn-and-redeem-points.png" />
</Frame>

<Info>
  For more information [please see here](https://brightdata.com/bright-rewards)
</Info>


# Track your usage with Costs Explorer
Source: https://docs.brightdata.com/general/account/billing-and-pricing/costs-explorer

Use Costs Explorer in the Bright Data Control Panel to track usage and costs across all your APIs. Filter by product, date and proxy in 3 clicks.

## Where to Find the Cost Explorer

You can navigate to the costs explorer using [This Link](https://brightdata.com/cp/billing/costs).
Alternatively you can also easily access the Cost Explore feature in the **Billing** tab on the left bar of the control panel. Afterwards look for the dedicated tab clearly marked **"Cost Explorer"**.

## What the Cost Explorer Offers

The Cost Explore feature provides comprehensive usage statistics, which can be broken down by: each product, each zone, charge types etc. for each day or hour you have used our products during the selected time period.
You can also see a breakdown for funds that were used up by your Datasets and Collectors.
The data can be displayed in line chart, bar chart or table.

This allows you to see exactly where your funds are being allocated.

## How accurate the data is

All the information displayed in the Cost Explorer is accurate and updated in real time. This ensures that you always have the most current data at your fingertips.

## How to customize the view

The Cost Explorer offers extensive customization options, allowing you to tailor the insights to your specific needs. Whether you want to see a detailed breakdown of your usage or a high-level overview, Cost Explorer has you covered.

## Visual and User-Friendly

The data in the Cost Explorer is displayed in a visual, easily readable format. This makes it simple to understand your usage and costs at a glance. These tables and charts are also available for download as .csv files.

## Answering Your Questions

If you have any questions about your usage or wish to better understand your bill, Cost Explorer is the place to go. It provides all the answers you need, making it an invaluable resource for managing your expenses.


# Billing and pricing FAQs
Source: https://docs.brightdata.com/general/account/billing-and-pricing/faqs

FAQs about billing for Bright Data accounts, including credentials, cost structure and API management across 4 proxy network products.

<AccordionGroup>
  <Accordion title="Where can I find my credentials like host name, username and password?">
    Your credentials can be found in the "Overview" tab in each zone that you created.

    1. In the sidebar, click on "Proxies and Scraping" and
    2. You will see a table of all the existing products you have created.
    3. Click on each line to see the credentials for each product.
    4. Click the "Overview" tab and you will see the username and password that you need to access that product.
  </Accordion>

  <Accordion title="Does the cost structure differ by country?">
    No, all countries are charged the same rate per GB.
  </Accordion>

  <Accordion title="Am I been charged differently for different domains?">
    Some domains require special permissions or products.

    In case you are not sure which product to use for your use case, it's best to get your dedicated account manager or support team for a integration session.
  </Accordion>

  <Accordion title="Can I limit my daily usage?">
    Yes.

    In the [Zone](https://brightdata.com/cp/zones) page under the "Usage spent limit" column it is possible to limit your daily usage in 2 ways:

    * Bandwidth(bytes)
    * Money spent(Dollars)

    When you reach your daily limit, the zone is suspended, alerted, or both, depending on your configuration.

    <Frame>
      <img alt="limit-daily-usage.gif" />
    </Frame>

    <Tip>
      The Zone limit is calculated every 15 minutes and will not take effect immediately so a Zone might go over it's limit by 15 minutes of usage.
    </Tip>

    <Note>
      When the load is high statistics calculation may have a delay. In order to manually update the usage-statistics in your Zone, open the Zone by clicking on its name, go to the Statistics table, and press the `recalc` button near the desired date. Wait until the red "Loading..." notification at the top of the screen will disappear, and refresh the page. The stats will then be up-to-date.
    </Note>
  </Accordion>

  <Accordion title="Can I use Bright Data without monthly commitment?">
    Absolutely!

    You can use Bright Data datacenter, ISP, residential, and mobile networks without monthly commitment.\
    Simply click the pencil next to the zone name and adjust the plan to 'Pay-As-You-Go'

    <Note>
      In case the ip type is pay per ip/dedicated type or gips, you will be charged for the ips allocated to the zone.
    </Note>
  </Accordion>

  <Accordion title="Who is eligible for a Free Trial?">
    Everyone who signs up to Bright Data automatically gets a free trial, which can be used for all Bright Data products. Every new account also gets a recurring [free tier](/general/account/billing-and-pricing/free-tier) of 5,000 credits per month for the Web Unlocker API, SERP API, Web Scraper API and Scraper Studio, which renews monthly.

    For additional details, see [here](/general/faqs#what-is-playground-mode).

    <Info>
      to help with trial configurations.
    </Info>
  </Accordion>

  <Accordion title="Why can't I create a Proxy zone or Web Unlocker API?">
    If you signed up with a personal email and are using the free credit without a payment method on file, access to **Proxy Networks** and **Web Unlocker API** is restricted.

    To unlock these products, [add a payment method](https://brightdata.com/cp/billing_flow). You will **not** be charged, this is for verification only and earns you a **\$5 bonus credit**.

    For full details, see [Payment Verification](/general/account/billing-and-pricing/payment-verification).
  </Accordion>

  <Accordion title="Do you have any Advanced Pricing plans?">
    Yes, our datacenter and ISP plans cover unlimited data volume.

    <Info>
      Contact your account manager for unlimited traffic per month plan information
    </Info>
  </Accordion>

  <Accordion title="How do I manage my billing details?">
    To manage your billing details, visit [https://brightdata.com/cp/billing/settings](https://brightdata.com/cp/billing/settings). There, you can add new payment methods, delete existing ones, set a primary payment method for your account, and configure alerts for your balance.
  </Accordion>

  <Accordion title="What payment methods are supported?">
    Brightdata supports payment through the following methods:

    * PayPal
    * AliPay
    * Payoneer
    * Credit Card: VISA, MasterCard, American Express
    * Wire transfer
    * Amazon Marketplace

    We do **not** support payment through cryptocurrencies.
  </Accordion>

  <Accordion title="How is bandwidth calculated? ">
    Bandwidth is calculated based on the data transmitted through the proxy peer. For instance, if a webpage has a size of 100 KB, the billed bandwidth will include this 100 KB along with a minimal additional amount to account for network overhead, such as the TCP handshake and other related operations. Billing is precise and measured down to the megabyte (MB), with no rounding up of bandwidth usage. To see a detailed breakdown of your costs consumption, please see: [Billing Overview](https://brightdata.com/cp/billing/overview) and there click on the 'breakdown' link.

    <Note>
      If a request is passed through the super proxy it will not be billed
    </Note>
  </Accordion>

  <Accordion title="Why am I getting &#x22;payment failed&#x22; errors? ">
    The payment failed error could occur due to several reasons, to see the exact cause in your case you should check your [transactions table](https://brightdata.com/cp/billing/transactions), there you will find instructions on how to resolve your issue.  If you require any further assistance, you can contact or sales department at [sales@brightdata.com](mailto:sales@brightdata.com)
  </Accordion>

  <Accordion title="Why does my promo code does not apply getting &#x22;Reached maximum number of activations&#x22; error?">
    This means that there were too many activations of that promo code. Wait till the next day and try again or contact our support.
  </Accordion>
</AccordionGroup>


# Free tier
Source: https://docs.brightdata.com/general/account/billing-and-pricing/free-tier

Every new Bright Data account gets 5,000 free credits per month across Web Unlocker API, SERP API, Web Scraper API and Scraper Studio. No credit card required.

Every new Bright Data account gets **5,000 free credits per month** (\~\$7.50 value), usable across the Web Unlocker API, SERP API, Web Scraper API and Scraper Studio. No credit card, no promo code, no commitment.

## What is the Bright Data free tier?

The free tier is a recurring monthly credit allowance that applies automatically to every new account. Credits renew on the first of each month and draw from a single shared pool, so you can spend them on any combination of the four eligible products. The Web Unlocker API, SERP API and Web Scraper API cost one credit per request or record. Scraper Studio draws from the same pool and costs one credit per page load.

Bright Data operates on a **pre-paid wallet model**: you are only ever charged for funds you have explicitly deposited. A free tier account has a hard stop when credits are exhausted, never a surprise bill.

## What can I use the free credits on?

| Product              | What it does                                                                                                |
| -------------------- | ----------------------------------------------------------------------------------------------------------- |
| **Web Unlocker API** | Retrieve any web page, bypassing anti-bot protections automatically.                                        |
| **SERP API**         | Extract structured search results from Google, Bing and more.                                               |
| **Web Scraper API**  | Get structured data from popular websites using pre-built, maintained scrapers.                             |
| **Scraper Studio**   | Build and run custom scrapers in a cloud IDE or with an AI agent. One credit per page load, not per record. |

<Note>
  Proxy products (Datacenter, ISP and Residential proxies) and the Browser API are **not** included in the monthly free credits. New accounts receive a separate one-time **\$2 trial credit** (valid 7 days) to test these products, plus an additional **\$5 bonus** upon adding a payment method (valid 30 days).
</Note>

## How are free credits consumed?

Free credits are drawn from a **single shared pool of 5,000 credits per account**. The Web Unlocker API, SERP API and Web Scraper API consume one credit per request or record. Scraper Studio draws from the same pool and consumes one credit per page load, so its consumption depends on how many pages each scraper loads. Usage is metered and deducted from the same pool, regardless of which product made the call.

The Control Panel shows in real time whether you are drawing from free credits or your deposited balance.

<Note>
  Bright Data MCP server requests also draw from this pool. The MCP free tier of 5,000 requests per month is the same shared allowance, because the MCP server runs on the Web Unlocker API.
</Note>

<Note>
  Unused free credits do not roll over to the next month. Credits reset to 5,000 on the first of each month.
</Note>

## What happens when free credits run out?

There are two outcomes, depending on whether you have deposited funds:

* **With funds in your account:** usage transitions automatically to your pre-paid balance at your plan's PAYG rates. There is no interruption in service.
* **Without funds:** requests return an error and you are prompted to add funds to continue.

In both cases, your 5,000 free credits renew on the first of the following month.

<Note>
  Accounts operating on the free tier (unfunded) are restricted to a default rate limit of 1,000 requests per minute across the SERP API, Web Unlocker API and Proxy products. You can view this limit in the Control Panel, under the zone's Overview tab > Access details. This rate limit is automatically removed once you add funds to your account.
</Note>

### How do I keep service running after free credits?

Enable **auto-recharge** in your billing settings to ensure uninterrupted service. Auto-recharge triggers when your available balance drops below 85 percent of your configured amount and tops it back up automatically. You can set any denomination. Configure it in [Billing Settings](https://brightdata.com/cp/billing/settings).

## Who is eligible for the free tier?

The free tier is available to **all new accounts** and is applied automatically at signup.

The following account types are **not** eligible:

* Accounts on custom PAYG pricing plans
* Accounts on pre-commit (subscription) plans

<Note>
  If you upgrade to a pre-commit plan, recurring monthly free credits will no longer be issued. Any remaining unused free credits at the time of upgrade remain available to use.
</Note>

<Note>
  Adding a credit card is a verification step only. You will not be charged unless your free credits are exhausted and you have funds deposited in your account.
</Note>

## How do I monitor my free credit usage?

Track your free credit balance and consumption directly in the Control Panel:

1. Go to [Billing Overview](https://brightdata.com/cp/billing/overview).
2. The **Free Tier Credits** section displays your remaining credits and next renewal date.
3. To set up balance threshold alerts, go to [Billing Settings](https://brightdata.com/cp/billing/settings).

## How do I get support on a free tier account?

Free tier accounts can open a ticket with Bright Data Support or get help from **Sophie**, Bright Data's AI assistant. Both are available in the Control Panel.

## FAQ

### How many requests do 5,000 free credits cover?

One credit equals one API call for the Web Unlocker API, SERP API and Web Scraper API, so your 5,000 monthly free credits cover up to 5,000 calls in any combination across these three products. Scraper Studio also draws from the pool and consumes one credit per page load, so its credit consumption depends on how many pages each scraper loads rather than a per-record rate.

### Do free credits roll over?

No. Credits reset to 5,000 on the first of each month. Unused credits are forfeited.

### Will I be charged automatically when credits run out?

No. If you have no deposited funds, a hard stop is applied and no charges will occur. If you have pre-deposited funds, usage continues against your balance at standard PAYG rates. Enable [auto-recharge](https://brightdata.com/cp/billing/settings) to replenish your balance automatically.

### Can I use the free tier for proxies or the Browser API?

Not through the monthly free credits. A separate one-time \$2 trial credit is available for proxy products and the Browser API upon signup, with an additional \$5 bonus when you add a payment method.

### Can I use the free tier for Scraper Studio?

Yes. Scraper Studio is covered by the monthly free credits and draws from the same shared pool of 5,000 credits. In the free tier, Scraper Studio consumes one credit per page load, so credit consumption depends on how many pages your scrapers load rather than a per-record rate.

### What happens to unused credits if I upgrade to a pre-commit plan?

Recurring monthly free credits stop upon upgrading. Any remaining unused credits at the time of upgrade can still be consumed.

### Can I combine free credits with a promo code?

Yes. Free credits are consumed first. Promo code discounts apply to any PAYG usage that follows.

### How do I start using PAYG after the free tier?

Add funds to your account from the [Billing page](https://brightdata.com/cp/billing). There is no minimum commitment. You stay on PAYG and only pay for what you use.

## Related pages

* [Accepted payment methods](/general/account/billing-and-pricing/payment-methods)
* [Billing](/general/account/billing-and-pricing/billing)
* [Bright Data promo codes](/general/account/billing-and-pricing/promo-codes)


# Payment
Source: https://docs.brightdata.com/general/account/billing-and-pricing/payment

FAQs on payments for Bright Data accounts across 3 areas: prepayment, automatic recharging and the accepted payment methods on the platform.

<Info>
  All of the prices posted on our website are the US Dollar prices
</Info>

<AccordionGroup>
  <Accordion title="Do I need to sign in online to deposit the prepayment funds?">
    Yes, we send a prepayment billing request to your email which can be completed from the [billing page](https://brightdata.com/cp/billing).
  </Accordion>

  <Accordion title="How does automatic recharging work?">
    Users choose between 2 types of payment schedules:

    <Tabs>
      <Tab title="Monthly recharge">
        If you do not use automatic recharge or decide to turn it off, you will be charged on the 1st of each month for your new month's monthly commitment. If you don't have a plan with a minimum monthly commitment and are using the Pay as you go plan, your account will not be automatically recharged.
      </Tab>

      <Tab title="Recharge at a preset amount">
        When you choose this option, you will manually set a charged amount when your balance runs low (at 25% of the configured amount).

        For example, if you choose `$100`, you will be charged `$100`, and then you will get charged `$100` again when your balance reaches `$25`.
      </Tab>
    </Tabs>
  </Accordion>

  <Accordion title="What is your Payment Verification process?">
    Bright Data maintains high compliance standards based on the principles of deterrence, prevention, and enforcement of malicious activities to ensure that our network is both safe for customers and ethical. It is for this reason that we are requesting that you identify yourself using your preferred payment method. We will perform a per-authorization charge and reward you with an additional \$5 bonus for your help and cooperation.

    These authorizations happen so Bright Data can make sure the card is valid, and check that you have enough funds in your account to make the purchase.

    These are authorization requests and not charges. You don't pay for authorizations.

    Authorizations may stay in your account for 1-14 business days depending on your bank. If you still see the pending authorization after 14 business days, contact your bank for more information.
  </Accordion>

  <Accordion title="How many Zones can I open in my Bright Data account?">
    You can open up to 50 Zones in your Bright Data account, free of charge. Each extra Zone will cost \$5/month
  </Accordion>

  <Accordion title="Can I get a refund?">
    Generally - No, the subscription fees are non-refundable. But, exceptions can be made for specific cases - If you believe you are eligible for a refund you can request one by contacting the Bright Data support team or your account manager. Any funds that were added as a promotional bonus  not eligible for refund.
  </Accordion>
</AccordionGroup>


# Accepted payment methods
Source: https://docs.brightdata.com/general/account/billing-and-pricing/payment-methods

Pay for Bright Data services with 4 options (PayPal, credit card, wire transfer, crypto). Set your default from the billing page in the Control Panel.

<Tabs>
  <Tab title="PayPal">
    <Steps>
      <Step title="Go to the billing page">
        [Billing Page](https://brightdata.com/cp/billing) > Click on `Add Payment Method`.
      </Step>

      <Step title="Select &#x22;PayPal&#x22; as your payment method.">
        You will then be redirected to PayPal page.
      </Step>
    </Steps>
  </Tab>

  <Tab title="AliPay">
    <Steps>
      <Step title="Go to the billing page">
        [Billing Page](https://brightdata.com/cp/billing) > Click on `Add Payment Method`.
      </Step>

      <Step title="Select &#x22;AliPay&#x22; as your payment method.">
        You will then be redirected to AliPay page.
      </Step>
    </Steps>
  </Tab>

  <Tab title="Payoneer">
    <Steps>
      <Step title="Go to the billing page">
        [Billing Page](https://brightdata.com/cp/billing) > Click on `Add Payment Method`.
      </Step>

      <Step title="Select &#x22;Payoneer&#x22; as your payment method.">
        You will then be redirected to Payoneer page.
      </Step>
    </Steps>
  </Tab>

  <Tab title="Credit Card">
    <Steps>
      <Step title="Go to the billing page">
        [Billing Page](https://brightdata.com/cp/billing) > Click on `Add Payment Method`.
      </Step>

      <Step title="Select &#x22;Credit Card&#x22; as your payment method.">
        Now you can click the `Add Balance` button and make a payment with your credit card.
      </Step>
    </Steps>
  </Tab>

  <Tab title="Wire transfer">
    <Warning>
      Wire transfer payments are only available after a payment of \$5,000 is made.
    </Warning>

    <Steps>
      <Step title="Go to the billing page">
        [Billing Page](https://brightdata.com/cp/billing) > Click on `Add Payment Method`.
      </Step>

      <Step title="Select &#x22;Other&#x22; as your payment method." />

      <Step title="Select the &#x22;Wire transfer&#x22; option as your payment method.">
        Now you can click the "Add Balance" button and make a payment with Wire transfer.
      </Step>
    </Steps>
  </Tab>

  <Tab title="Amazon Marketplace">
    You can also buy subscription using Amazon Marketplace.

    To purchase the subscription via Amazon Marketplace, please send your account manager your Amazon marketplace ID (i.e. buy an Amazon Marketplace contract, follow the link, do not signup a new Bright Data account, instead, just send your ID). Your account manager will update the Amazon Marketplace ID on your account.

    <Warning>
      There a few limiation when you purchase a subscription using the Amazon Marketplace

      * You will be allowed to use only products purchased via Amazon marketplace.
      * We do not support paying for Cloud Proxy Manager via Amazon Marketplace.
      * All other payment methods will be removed from your account.
      * Auto-recharge will not be available
    </Warning>
  </Tab>
</Tabs>

<Note>
  To ensure your payment goes through smoothly, please disable any ad blockers before proceeding.
</Note>


# Payment method verification
Source: https://docs.brightdata.com/general/account/billing-and-pricing/payment-verification

Why a payment method is required to access Proxy Networks on a free trial across 4 product lines, and how to add one in 2 steps.

## Overview

When you sign up for Bright Data with a **personal email address** you receive a **free credit** to explore Bright Data. Certain products require you to **add a valid payment method** before you can create or use them.

<Note>
  Adding a payment method **does not trigger a charge**. It is used solely for identity verification and to unlock full product access.
</Note>

## Who is affected?

This requirement applies if **all** of the following are true:

| Condition          | Detail                                                                  |
| ------------------ | ----------------------------------------------------------------------- |
| **Email type**     | You signed up with a personal / freemail domain                         |
| **Payment status** | No valid payment method is on file, you are using the free credit only. |

<Tip>
  Users who signed up with a **business email** or who already have a payment method on file are **not** affected and can use all products immediately.
</Tip>

## Which products are gated?

| Gated products (payment method required) | Available on free credit |
| ---------------------------------------- | ------------------------ |
| Residential Proxy                        | SERP API                 |
| Mobile Proxy                             | Web Unlocker API         |
| ISP Proxy                                | Browser API              |
| Datacenter Proxy                         | Scrapers                 |
|                                          | Datasets Marketplace     |
|                                          | Scraper Studio           |

## What you will see in the Control Panel

### Zone Creation Wizard - Create Proxy

When creating a **Proxy zone**, the wizard includes an additional step:

<Steps>
  <Step title="Configure your zone">
    Choose your product type and assign a name as usual.
  </Step>

  <Step title="Set zone options">
    Configure any additional settings (geolocation, IP type, etc.).
  </Step>

  <Step title="Add payment method">
    Instead of the usual **Create Proxy** button, you will see **Add payment method**. Clicking it opens the payment method form.
  </Step>

  <Step title="Finalize creation">
    Once a valid payment method is saved, your zone is created automatically. If you leave the payment flow without completing it, the zone is **not** created, but your configuration is saved so you can resume later.
  </Step>
</Steps>

<Warning>
  Your zone will **not** be created until a payment method is successfully added.
</Warning>

### Network Dropdown - SERP API / Browser API configuration

If you are configuring an **allowed** product (SERP API or Browser API) and attempt to switch the underlying network to a gated product, the restricted networks appear **grayed out** in the dropdown:

* Residential
* Mobile
* ISP
* Datacenter

Hovering over a grayed-out option displays a tooltip:

> **"Add a payment method to unlock this product."**

The tooltip includes a link that opens the payment method form directly.

### Trial Credit Modal - "See Details"

In the credit breakdown modal, gated products display a **"Payment method required"** badge next to:

* **Proxy Networks** (covers Residential, Mobile, Datacenter, ISP)

The modal footer includes an **"Add payment method"** button (primary style) alongside the existing "Got it" button.

## How to add a payment method

<Steps>
  <Step title="Go to the Billing page">
    Navigate to [Billing Settings](https://brightdata.com/cp/billing/settings) or click **Add payment method** from any of the prompts described above.
  </Step>

  <Step title="Choose a payment method">
    Select one of the supported methods: **Credit Card**, **PayPal**, **AliPay**, or **Payoneer**. For details, see [Accepted Payment Methods](/general/account/billing-and-pricing/payment-methods).
  </Step>

  <Step title="Complete verification">
    Follow the on-screen steps. A temporary pre-authorization may appear on your statement, this is **not** a charge and will be released by your bank within 1–14 business days.
  </Step>

  <Step title="Access unlocked">
    After verification you will:

    * Have full access to **all** Bright Data products
    * Receive a **\$5 bonus credit**
    * Be upgraded to the **30-day Limited Trial**
  </Step>
</Steps>

## FAQs

<AccordionGroup>
  <Accordion title="Will I be charged when I add a payment method?">
    No. Adding a payment method triggers a temporary pre-authorization only. You are not charged until you actively add funds or set up auto-recharge.
  </Accordion>

  <Accordion title="I signed up with Gmail, can I change to a business email?">
    Yes. Go to **Account Settings** and update your email. Once verified with a business domain, the gating restriction is removed even without a payment method.
  </Accordion>

  <Accordion title="What happens to my free credit after I add a payment method?">
    Your existing free credit remains available **plus** you receive an additional \$5 verification bonus. Your trial is also extended to 30 days.
  </Accordion>

  <Accordion title="I started creating a zone but didn't finish adding payment, is my config lost?">
    No. Your zone configuration is saved. When you return and successfully add a payment method, the zone creation completes automatically.
  </Accordion>
</AccordionGroup>


# Premium IPs (deprecated)
Source: https://docs.brightdata.com/general/account/billing-and-pricing/premium-ips

Premium IPs are deprecated and no longer offered by Bright Data. Use 1 of 4 alternatives (Datacenter, ISP, Residential or Mobile) for equivalent IP quality.



# Bright Data promo codes
Source: https://docs.brightdata.com/general/account/billing-and-pricing/promo-codes

Find and apply Bright Data promo codes in 3 steps to get exclusive discounts on subscription plans, products and services across the platform.

Bright Data offers promo codes to save money on your subscription plans. You can get exclusive discounts on specific products or services by applying a promo code. This guide will show you everything you need to know about the promo codes.

## How to Apply a Promo Code

To apply a promo code to your subscription plan, follow the steps below:

### Step 1. Go to the Billing page

<Steps>
  <Step title="Go to the Bright Data website">
    Visit [Bright Data](https://brightdata.com/cp/start) page and sign in to your account.
  </Step>

  <Step title="Go to the &#x22;Billing&#x22; page">
    Click on the [Billing](https://brightdata.com/cp/billing) page on the left navigation bar.

    <Frame>
      <img alt="billing-button" />
    </Frame>
  </Step>
</Steps>

### Step 2. Apply the Promo Code

You can choose to apply the promo code in one of two ways:

<Tabs>
  <Tab title="Pay as you go plan">
    <Steps>
      <Step title="Click on &#x22;Apply a promo code&#x22;">
        <Frame>
          <img alt="click-on-apply-promo-code" />
        </Frame>
      </Step>

      <Step title="Enter the Promo Code">
        To activate the promotion, enter your code in the “Enter promo code” field, then click “Apply.”

        <Frame>
          <img alt="enter-promo-code" />
        </Frame>
      </Step>

      <Step title="Congratulations 🎉">
        You have successfully activated the promo code, and your new discounted rates have been applied to your plan.

        <Frame>
          <img alt="payg-promo-added.png" />
        </Frame>
      </Step>

      <Step title="View Updated Pricing">
        You can confirm the changes by going to the “Overview” tab on the “Billing” page, under “Your products” > “All Products,” to view the discounted prices for the relevant product(s). Or you can simply open a zone and get started!

        <Frame>
          <img alt="payg-confirm-discount" />
        </Frame>
      </Step>
    </Steps>
  </Tab>

  <Tab title="Subscription plan">
    <Steps>
      <Step title="Click on &#x22;Change Plan&#x22;">
        In [Overview](https://brightdata.com/cp/billing/overview) tab, click on the [Change Plan](https://brightdata.com/cp/pricing_packages) button.

        <Frame>
          <img alt="change-plan" />
        </Frame>
      </Step>

      <Step title="Select the Subscription">
        Select the subscription plan of your choice and click on the "Upgrade" button.

        <Frame>
          <img alt="subscription-plans" />
        </Frame>
      </Step>

      <Step title="Enter the Promo Code">
        To activate the promotion, enter your code in the “Enter promo code” field, then click “Apply.” Once you see confirmation of the promo code’s validity, click “Pay & Confirm Upgrade."

        <Frame>
          <img alt="apply-promo-code" />
        </Frame>
      </Step>

      <Step title="Congratulations 🎉">
        You have successfully activated the promo code, and your new discounted rates have been applied to your plan.

        <Frame>
          <img alt="sub-promo-added.png" />
        </Frame>
      </Step>

      <Step title="View Updated Pricing">
        You can confirm the changes by going to the “Overview” tab on the “Billing” page, under “Your products” > “All Products,” to view the discounted prices for the relevant product(s). Or you can simply open a zone and get started!

        <Frame>
          <img alt="sub-confirm-discount" />
        </Frame>
      </Step>
    </Steps>
  </Tab>
</Tabs>

## FAQs

<AccordionGroup>
  <Accordion title="Do the promo codes work with the 'dollar-for-dollar' first deposit matching promo?">
    Yes, you can use both a promo code and the dollar-for-dollar matching promotion together.

    The promo code will be applied directly to your subscription plan, reducing the cost of your plan. Additionally, we will match your first deposit dollar-for-dollar, up to \$500. The matched promotional credits are valid for 90 days. To maintain the bonus, a minimum monthly usage of \$5 is required.

    <Note>
      The matching dollar for dollar credit works for the first deposit only.
    </Note>
  </Accordion>
</AccordionGroup>


# Account management FAQs
Source: https://docs.brightdata.com/general/account/faqs

FAQs on Bright Data account management across 4 topics: how to re-verify, delete your account, and manage subscriptions on the platform.

<AccordionGroup>
  <Accordion title="How do I re-verify my account to clear a billing issue?">
    There are certain requirements that must be met before you’re allowed to deactivate or delete your Bright Data account. If you are unable to deactivate your account, please make sure all of the following conditions are satisfied:

    * **You must be the account owner:** Only the person who originally opened the account (the "owner") has the ability to delete it.
    * **It is not a Bright Data internal account:** (This is mostly relevant to internal use and not regular customers.)
    * **All bills must be paid:** Your account must have no outstanding payments or unpaid invoices.
    * **Real balance is exactly zero:** Your account’s real balance should be exactly \$0, no positive or negative balances. Note: Bonuses are not counted toward your real balance. Credits, often considered as a "loan" in some cases, may be treated differently; ensure your real balance is zero according to your billing section.
    * **No active long-term subscriptions (LTS):** If you have an ongoing LTS, you must cancel or complete it before deactivating your account.
    * **No monthly commitments:** Any monthly service commitments must be completed or canceled.
    * **No pending costs:** Your account should have no pending or unbilled usage ("pending costs"). For clarification of what qualifies as pending costs, please check your billing section or contact our support.

    If you are the account owner and you have met all the above criteria but still cannot deactivate your account, please contact our support team for further assistance.If your account was blocked, you will immediately receive an email explaining how to resolve the issue. Contact your dedicated account manager or Bright Data's compliance team at [compliance@brightdata.com](mailto:compliance@brightdata.com). To reinstate your blocked account, you will need to provide the following:

    <Tabs>
      <Tab title="Registered Companies">
        * A company registration form
        * A photo of the flagged payment method
      </Tab>

      <Tab title="Non Registered Companies">
        * Photo ID, driver's license, or passport
        * A photo of the flagged payment method
      </Tab>
    </Tabs>
  </Accordion>

  <Accordion title="Why was my account is suspended due to billing issues?">
    Bright Data may suspend your account (which prevents access to any zones in it) due to billing issues for one of the following reasons:

    * A discrepancy between payment method and personal details
    * The user has logged in from a country that differs from where the credit card is from
    * Too many attempts to process a declined payment
    * Failure to authenticate a credit card payment using 3D secure

    To enable your account again and exit the suspension state, review your billing details and fix missing or incorrect information. Once billing is resumed, your account will be active again automatically. If from some reason it doesn't - contact your account manager.
  </Accordion>

  <Accordion title="Why was my account is disabled?">
    Bright Data disables (note: disabled account differs from a suspended account) accounts that have been idle for 12 months. To re-enable your account you need to reach out to our staff, either through the Help & Support section in the control panel.
  </Accordion>

  <Accordion title="How can I set up a password for my account?">
    * Visit [https://brightdata.com/cp/setting/auth](https://brightdata.com/cp/setting/auth).
    * In the "Setup a password" section, enter your desired password.
    * Ensure your password includes digits, uppercase and lowercase letters, and at least one special character.
    * Confirm your password by re-entering it.
    * Click "Save password."
    * If prompted, enter your 2FA code to verify the action.
  </Accordion>

  <Accordion title="Why am I not receiving a password reset email?">
    <Note>
      If your organization has configured **enforced SSO** (via Microsoft Entra ID, Okta, or Google Workspace), password reset emails are **not** sent. Password-based authentication is disabled for accounts with enforced SSO.

      Sign in through your organization's identity provider instead:

      * **Microsoft Entra ID**: enter your email on the Bright Data login page; you'll be redirected to Entra automatically.
      * **Okta**: sign in via your Okta dashboard or the Bright Data Okta tile.
      * **Google Workspace**: use the "Sign in with Google" option on the Bright Data login page.

      Contact your account administrator if you need access restored. See also:

      * [Set up Azure SSO (Entra ID) with Bright Data](/general/authentication/How_to_set_up_Azure_SSO_Entra_ID_with_Bright_Data)
      * [Set up Okta SSO with Bright Data](/general/authentication/How_to_set_up_SSO_with_Okta_in_Bright_Data)
      * [Set up SSO with Google Workspace in Bright Data](/general/authentication/How_to_set_up_SSO_with_Google_Workspace_in_Bright_Data)
    </Note>

    If your account does **not** have enforced SSO and you're still not receiving a reset email:

    * Check your spam/junk folder.
    * Verify the email address on file at [Account settings → Profile](https://brightdata.com/cp/setting/customer_details).
    * Make sure your email provider isn't rate-limiting or blocking mail from `sendgrid.net` / Bright Data domains.
    * Contact [Bright Data support](https://brightdata.com/contact) if the issue persists.
  </Accordion>

  <Accordion title="How to add users to the invoice recipients list?">
    To add an email address to invoice recipients list, please follow the below guide

    <Steps>
      <Step title="Click the &#x22;Billing&#x22; button on the Control Panel sidebar" />

      <Step title="Click on &#x22;More ...&#x22; button on the top" />

      <Step title="In the opened menu, select &#x22;Invoice recipients&#x22;">
        <Frame>
          <img alt="invoice_recipients_1.png" />
        </Frame>
      </Step>

      <Step title="Inside the opened &#x22;Invoice recipients&#x22; screen, click on the &#x22;+ Add new recipient&#x22; button button">
        <Frame>
          <img alt="invoice_recipients_2.png" />
        </Frame>
      </Step>

      <Step title="Add name and email address" />

      <Step title="Click on the &#x22;Add&#x22; button">
        <Frame>
          <img alt="invoice_recipients_3.png" />
        </Frame>
      </Step>
    </Steps>
  </Accordion>

  <Accordion title="What if my account is not in “active” status for the entire month?">
    If you have remaining funds in your balance during a month in which you were inactive, you will not lose your balance, but will be charged to bring that balance up to the minimum monthly commitment on the 1st day of the next month.

    <Frame>
      <img alt="suspend-account.gif" />
    </Frame>
  </Accordion>

  <Accordion title="How can I prevent suspension of my account?">
    If your account suspended due to insuffecient funds, you can always charge funds to your account and the suspension will be removed immediately.

    To ensure that your account is never suspended, we highly recommend that you use our automatic recharging option. It can be activated in the “billing” section of your account and ensures uninterrupted service. Auto recharge starts to work when your available balance drops below 85% of the total account balance. The amount set is entirely up to you and can be of any denomination. You can find the auto recharge section [here](https://brightdata.com/cp/billing/settings).

    <Frame>
      <img alt="billing.png" />

      <img alt="payment-settings.png" />

      <img alt="confirm.png" />
    </Frame>
  </Accordion>

  <Accordion title="How can I invite users to my account?">
    To add users to your account follow the instructions:

    1. Navigate to the [Settings page](https://brightdata.com/cp/setting/users)
    2. Click the "New User" button to initiate the user addition process.
    3. Enter the details of the user you want to invite, such as their name and email address.
    4. Choose a permission level for the user from the following options:
       * Admin: Grants access to the entire account, including all settings and configurations.
       * Finance: Limits access to billing and financial pages only.
       * Ops: Provides access to the products but restricts billing access.
       * Limit: Allows the user to modify zone passwords and manage IP allowlists/denylists.
       * User: Grants API usage access without access to billing or product pages.
    5. Confirm and Send Invite: Review the details, confirm the permissions, and send the invite.

    The invitee will receive an email with instructions to join and access the account according to their permission level.

    Once added, the new user will have access to the account according to the granted permission. You can also edit the permissions later if needed.
  </Accordion>

  <Accordion title="Why can't I deactivate my account?">
    There are certain requirements that must be met before you’re allowed to deactivate or delete your Bright Data account. If you are unable to deactivate your account, please make sure all of the following conditions are satisfied:

    * **You must be the account owner:** Only the person who originally opened the account (the "owner") has the ability to delete it.
    * **All bills must be paid:** Your account must have no outstanding payments or unpaid invoices.
    * **Real balance is exactly zero:** Your account’s real balance should be exactly \$0, no positive or negative balances. Note: Bonuses are not counted toward your real balance. Credits, often considered as a "loan" in some cases, may be treated differently; ensure your real balance is zero according to your billing section.
    * **No active long-term subscriptions (LTS):** If you have an ongoing LTS, you must cancel or complete it before deactivating your account.
    * **No monthly commitments:** Any monthly service commitments must be completed or canceled.
    * **No pending costs:** Your account should have no pending or unbilled usage ("pending costs"). For clarification of what qualifies as pending costs, please check your billing section or contact our support.

    If you are the account owner and you have met all the above criteria but still cannot deactivate your account, please contact our support team for further assistance.
  </Accordion>
</AccordionGroup>


# Limited trial account restrictions
Source: https://docs.brightdata.com/general/account/limited-trial-restrictions

How rate limits and balance restrictions apply to Bright Data accounts in Limited Trial mode across 4 products, and how to remove them with verification.

## Overview

Accounts in Limited Trial mode are subject to certain restrictions to prevent abuse and ensure compliance with Bright Data's policies. These restrictions are automatically applied to accounts flagged or operating in Limited Trial mode and can be removed by completing the account verification process.

<Note>
  The "Limited Trial Account Restrictions" described on this page are **not the same as KYC (Know Your Customer) verification**.
  These restrictions only apply to accounts in Limited Trial mode.
</Note>

## Rate limiting restrictions

### Request rate limits

Accounts in Limited Trial mode are restricted to a maximum of **100 requests per minute** across all products.

#### What happens when you exceed the rate limit?

If you exceed this rate limit, your requests will be rejected with an **HTTP 429** error response:

```http theme={null}
HTTP/1.1 429 Too Many Requests
x-brd-error-code: client_10110
x-brd-error: Requests rate from account is too high
x-brd-err-msg: Your limited trial mode account exceeded the allowed rate limits. Reduce requests rate and try again or complete the verification process to remove rate limits.
```

<Warning>
  **You will not be charged for requests that are rejected due to rate limiting.**
</Warning>

#### How to resolve rate limit errors

<Steps>
  <Step title="Reduce your request rate">
    Temporarily reduce your requests to stay under 100 requests per minute while in trial mode.
  </Step>

  <Step title="Complete account verification">
    [Complete the account verification process](https://brightdata.com/cp/account_verification) to remove all rate limiting restrictions.
  </Step>
</Steps>

## Balance addition limits

### Maximum balance top-up

Accounts in Limited Trial mode can only add up to **\$100 to their balance at a time** until verification is completed.

<Info>
  This restriction applies per transaction. After completing verification, you can add any amount to your account balance.
</Info>

### Why this limit exists

The balance addition limit is in place to:

* Prevent fraudulent activity
* Ensure compliance with financial regulations
* Protect Bright Data from potential abuse

## How to remove these restrictions

All Limited Trial restrictions can be removed by completing the account verification process.

<Card title="Complete Account Verification" icon="shield-check" href="https://brightdata.com/cp/account_verification">
  Verify your account to unlock:

  * Unlimited request rates
  * No balance addition restrictions
  * Full access to all Bright Data products
  * Priority support
  * Add more than \$100 payments
</Card>

### Verification process steps

<Steps>
  <Step title="Navigate to Account Verification">
    Visit [https://brightdata.com/cp/account\_verification](https://brightdata.com/cp/account_verification)
  </Step>

  <Step title="Complete identity verification">
    Depending on your use case, you may be asked to provide additional information about your intended usage.
  </Step>

  <Step title="Wait for approval">
    Most verifications are completed instantly, but some may require manual review (1-2 business days).
  </Step>
</Steps>

## Frequently asked questions

<AccordionGroup>
  <Accordion title="How long does account verification take?">
    Most account verifications are instant. In some cases, manual review may be required, which typically takes 1-2 business days.
  </Accordion>

  <Accordion title="Can I use Bright Data while waiting for verification?">
    Yes! You can continue using Bright Data services in Limited Trial mode while your verification is being processed, subject to the rate and balance limits described above.
  </Accordion>

  <Accordion title="What if I receive a 429 error after verification?">
    If you continue to receive HTTP 429 errors after completing verification, it may be due to:

    * Domain-specific rate limits (error code: policy\_20220)
    * IP-specific rate limits (error code: policy\_20222)

    Contact [support@brightdata.com](mailto:support@brightdata.com) for assistance.
  </Accordion>
</AccordionGroup>

## Where to read more

* [Account Billing and Pricing FAQs](/general/account/billing-and-pricing/faqs)


# Account management overview
Source: https://docs.brightdata.com/general/account/overview

Manage your Bright Data account: SSL certificates, billing and pricing, team access, user permissions, API keys and security settings from the Control Panel.

<Card>
  <CardGroup>
    <Card title="SSL Certificate" icon="lock" href="/general/account/ssl-certificate">
      Secure your domains with HTTPS encryption using SSL certificates managed through your account.
    </Card>

    <Card title="Users Management" icon="users" href="/general/account/users-management">
      Control team access and permissions to streamline collaboration and ensure data security.
    </Card>

    <Card title="Billing & Pricing" icon="credit-card" href="/general/account/billing-and-pricing">
      View your current plan, track usage, download invoices, and manage payment methods.
    </Card>

    <Card title="Referral Program" icon="gift" href="/general/account/referral-program">
      Invite others and earn rewards, share your referral link and track your bonuses here.
    </Card>

    <Card title="Account Management FAQs" icon="book-open" href="/general/account/faqs">
      Find answers to common questions about managing your account, security, and preferences.
    </Card>

    <Card title="Account Management APIs" icon="code" href="/api-reference/account-management-api">
      Programmatically manage account details, users, and billing through our secure API endpoints.
    </Card>
  </CardGroup>
</Card>


# Referral program
Source: https://docs.brightdata.com/general/account/referral-program

Earn up to 50% of revenue from customers you refer to Bright Data. See how the referral program works, payout terms, and how it differs from affiliates.

Bright Data's referral program offers a straightforward way to earn rewards by introducing others to Bright Data. Here's how it works:

1. **Share Your Referral Link**: After joining the referral program, you'll receive a unique referral link. Share this link with individuals or businesses that could benefit from Bright Data's services.

2. **Earn Commissions**: When someone signs up through your link and subscribes to a paid plan, you earn a commission. Specifically, you'll receive a 50% revenue share, up to \$2,500 per customer.

3. **Receive Account Credits**: Alternatively, you can opt to receive credits to your Bright Data account, with an additional 5% bonus when selecting this option.

**Frequently Asked Questions**

* **How does the Bright Data referral program work?**
  Our referral program allows you to earn by sharing Bright Data with others. Share your unique referral link; when someone you refer signs up and spends \$100, you’ll earn a \$100 credit. Additionally, you can earn a 50% revenue share, up to \$2,500 per customer.

* **Where can I find my referral code?**
  After signing up for the referral program, your unique referral code will be available in your account dashboard. You can copy and share it with potential Bright Data users.

* **How do I earn money with the referral program?**
  You earn in two ways:

  * A \$100 credit when a referred customer spends \$100.

  * A 50% revenue share, up to \$2,500 per customer, as they continue to use Bright Data.

* **Can I track my referral earnings?**
  Yes, you can monitor your referral progress and earnings through your Bright Data account dashboard.

For more information or to join the referral program, visit our [referral page](https://brightdata.com/referral/).

**Referral Program vs. Affiliate Program – What’s the Difference?**
If you’re wondering whether this is the same as Bright Data’s affiliate program – it’s not. Here’s the key distinction:

* **Referral Program**: Ideal for existing users who want to recommend Bright Data to colleagues, friends, or businesses. You earn by directly inviting others to sign up.

* **Affiliate Program**: A broader approach suited for marketers, bloggers, and influencers who promote Bright Data to larger audiences through content, ads, or websites.

If you’re interested in the affiliate program, [click here to learn more](https://brightdata.com/affiliate).


# SSL certificate
Source: https://docs.brightdata.com/general/account/ssl-certificate

Install and use Bright Data's SSL certificate on port 44445 for end-to-end encrypted connections with Residential, Mobile, Unlocker and SERP APIs.

<Note>
  You can use Bright Data products without the SSL certificate:

  1. Using **Bright Data proxy API**. Read more: [API vs. native Access](/api-reference/authentication)
  2. Get your account **verified** with our [KYC process](/proxy-networks/residential/network-access#kyc-verification)
</Note>

The SSL certificate allows you to establish end-to-end encrypted connections when using [Residential Proxies](/proxy-networks/residential/introduction), [Web Unlocker API](/scraping-automation/web-unlocker/introduction) or the [SERP API](/scraping-automation/serp-api/introduction) in **native** proxy mode.

If you are just doing preliminary testing, you can also proceed without the SSL certificate and use it later.

Using the SSL certificate is straight forward. You download it, and choose how you want to use it in your environment.

## Download the SSL certificate

<Tip>
  Bright Data's current SSL certificate works with proxy port `44445` (introduced July 2026). The old certificates on ports `22225` and `33335` expire on September 25, 2026. See the [root certificate migration guide](/general/account/ssl-certificate-migration).
</Tip>

1. **Right click** on this [link](https://brightdata.com/static/brightdata_proxy_ca.zip) to "save as" the file to your hard drive.
2. **Unzip the file** and choose the certificate to use. Most users - espcially if they are new to Bright Data - should use the **new** SSL certificate.

## Bright Data new SSL Certificate

Bright Data's current SSL certificate is `brightdata_root_ca_44445.crt`, and native proxy connections use port `44445`. It is the certificate to use for all new setups. For a step-by-step move from an older port, see the [root certificate migration guide](/general/account/ssl-certificate-migration).

Port `44445` is required with the new certificate. The old certificates, on ports `22225` and `33335`, expire on September 25, 2026 at 00:00 UTC and cannot be extended or renewed. Traffic still relying on them after that date will fail. Read more in: [FAQ: Which port shall I use](/general/faqs#which-port-shall-i-use-22225-or-33335)

## Using the SSL certificate in your code

If you write scraping code, in most cases, you do not need to install the SSL certificate in your environment. Simply load the SSL certificate in your code. For example, for CURL:

```sh theme={null}
curl --proxy brd.superproxy.io:44445 --proxy-user brd-customer-<account-id>-zone-<zone-name>:<zone-password> --cacert <PATH TO CA.CRT> "https://geo.brdtest.com/mygeo.json"
```

You can refer to Bright Data sample code examples in the dashboard for exact syntax.

## Installation of the SSL certificate

In some cases, for example when using some third party tools that don't allow loading the certificate from your hard drive, you still need to install the SSL certificate on your computer.

### Where do I install the certificate?

The SSL certificate needs to be installed **on the host that is running the actual scraping code or application.**

In most cases this is your PC but, if you use a cloud-hosted server to run your code, you need to install the SSL certificate on the server itself.

### How to install the certificate

This takes 2 minutes - simply follow these instructions:

<Tabs>
  <Tab title="Windows">
    * If you didn't do so already, **Right click** on this [link](https://brightdata.com/static/brightdata_proxy_ca.zip) to "save as" the file to your hard drive.
    * Double click the ca.crt file
    * Follow the Windows instructions to install the certificate.
    * Reboot your computer
    * After rebooting, you will be able to connect to Bright Data product you needed (Residential Proxy, Web Unlocker API or SERP API)
  </Tab>

  <Tab title="Chrome">
    * Once you've download the [certificate](https://brightdata.com/static/brightdata_proxy_ca.zip) file (see the instruction on the top of this article)

    <AccordionGroup>
      <Accordion title="Go to Browser settings">
        <Frame>
          <img alt="browser-settings.png" />
        </Frame>
      </Accordion>

      <Accordion title="Go to Privacy and security and click on Security">
        <Frame>
          <img alt="privacy-and-security.png" />
        </Frame>
      </Accordion>

      <Accordion title="Scroll down and click on Manage certificate">
        <Frame>
          <img alt="manage-certificate.png" />
        </Frame>
      </Accordion>

      <Accordion title="Go to Trusted Certification Authorities and click Import">
        <Frame>
          <img alt="trusted-certification-authorities.png" />
        </Frame>
      </Accordion>

      <Accordion title="Click on Next">
        <Frame>
          <img alt="click-next.png" />
        </Frame>
      </Accordion>

      <Accordion title="Click Browse and select the certificate you just downloaded, and click Next">
        <Frame>
          <img alt="click-browse.png" />
        </Frame>
      </Accordion>

      <Accordion title="Select &#x22;Place all certificates in the following store&#x22; and click Next">
        <Frame>
          <img alt="place-all-certificates.png" />
        </Frame>
      </Accordion>

      <Accordion title="Make sure Certificate Store Selected by User is &#x22;Trusted Root Certification Authorities&#x22;, and click Finish">
        <Frame>
          <img alt="trusted-root-certification-authorities.png" />
        </Frame>
      </Accordion>

      <Accordion title="Click OK">
        <Frame>
          <img alt="click-ok.png" />
        </Frame>
      </Accordion>
    </AccordionGroup>
  </Tab>

  <Tab title="Firefox">
    * Type in the address bar: `about:preferences#advanced`
    * Under “Security” click “View Certificates”
    * Select the authorities tab, and click “Import” button below
    * Browse to the directory you downloaded the certificate file to, select the certificate file and click “Open”
    * In the popup box click the checkbox “Trust this CA to identify websites”
    * Click OK to complete the installation
    * Make sure Bright Data proxy is configured as Firefox's proxy, and browse thru proxy to a protected website
  </Tab>

  <Tab title="Linux">
    * Copy the downloaded certificate file `ca.crt` to the `/usr/local/share/ca-certificates/` folder.
    * Run `sudo update-ca-certificates`. The output of the command should state that 1 certificate was added.
    * Go to an SSL-protected website to check that everything is working as cted.
  </Tab>

  <Tab title="macOS">
    * Double-click the downloaded certificate file. You will see the "Keychain Access" application.
    * Double-click the "luminati.io" certificate to see a popup with certificate settings.
    * Select "Always Trust" in the "When using this certificate" dropdown.
    * Close the popup enter your credentials when asked.
    * Restart your browser and go to an SSL-protected website to check that everything is working as expected.
  </Tab>

  <Tab title="iOS">
    * Open up Safari
    * Navigate to this page and download the certificate using [this link](https://brightdata.com/static/brightdata_proxy_ca.zip), but first read the following two items.
    * Click Install and provide your passcode
    * Click Install in the top right corner and then Done
    * Go to iPhone "Settings"
    * Go to "About"
    * Go to "Certificate Trust Settings"
    * Enable the "luminati.io" certificate
    * You can now go to an SSL-protected website in any browser installed in your system to check that everything is working as expected.
  </Tab>

  <Tab title="Android">
    * Download the following [certificate](https://brightdata.com/static/brightdata_proxy_ca.zip) and save it on your phone.
    * On your phone, look for the downloaded zip through 'My files' and extract it.
    * Go yo Settings > Security and privacy > More security settings
    * Under 'Crednetial storage' click 'Install from device storage'
    * Select 'CA certificate' and click 'Install anyway'
    * Enter your password
    * Select the certificate you extracted from your files and click 'Done'
    * You can now go to an SSL-protected website in any browser installed in your system to check that everything is working as expected.
  </Tab>
</Tabs>

## How to ignore SSL errors?

In some cases you will need to install our certificate or ignore SSL errors in order to get access to specific products or features. In case you are not interested in installing our certificate, you can ignore SSL errors. Check out the following code snippets for different programming languages, the highlighted part is what needs to be added to your code in order to ignore SSL errors.

<CodeGroup>
  ```sh Curl theme={null}
  # Add -k to ignore ssl errors
  curl --proxy brd.superproxy.io:44445 --proxy-user brd-customer-<customer_id>-zone-<zone_name>:<zone_password> -k "http://brdtest.com/myip.json"
  ```

  ```js NodeJS theme={null}
  #!/usr/bin/env node

  const { ProxyAgent, setGlobalDispatcher } = require('undici');

  // Make sure you set rejectUnauthorized to false on the proxy's TLS options
  setGlobalDispatcher(new ProxyAgent({
    uri: 'http://brd-customer-<customer_id>-zone-<zone_name>:<zone_password>@brd.superproxy.io:44445',
    requestTls: { rejectUnauthorized: false },
  }));

  (async () => {
    const response = await fetch('http://brdtest.com/myip.json');
    console.log(await response.text());
  })();
  ```

  ```python Python theme={null}
  #!/usr/bin/env python
  print('If you get error "ImportError: No module named \'six\'" install six:\n'+\
      '$ sudo pip install six');

  import sys

  # Make sure you add these two line to ignore ssl error
  import ssl
  ssl._create_default_https_context = ssl._create_unverified_context


  if sys.version_info[0]==2:
      import six
      from six.moves.urllib import request
      opener = request.build_opener(
          request.ProxyHandler(
              {'http': 'http://brd-customer-<customer_id>-zone-<zone_name>:<zone_password>@brd.superproxy.io:44445',
              'https': 'http://brd-customer-<customer_id>-zone-<zone_name>:<zone_password>@brd.superproxy.io:44445'}))
      print(opener.open('http://brdtest.com/myip.json').read())

  if sys.version_info[0]==3:
      import urllib.request
      opener = urllib.request.build_opener(
          urllib.request.ProxyHandler(
              {'http': 'http://brd-customer-<customer_id>-zone-<zone_name>:<zone_password>@brd.superproxy.io:44445',
              'https': 'http://brd-customer-<customer_id>-zone-<zone_name>:<zone_password>@brd.superproxy.io:44445'}))
      print(opener.open('http://brdtest.com/myip.json').read())
  ```

  ```cs C# theme={null}
  using System;
  using System.Net;

  class Example
  {
      static void Main()
      {

          // Make sure you add this line to ignore ssl error
          ServicePointManager.ServerCertificateValidationCallback += (sender, cert, chain, sslPolicyErrors) => true;

          var client = new WebClient();
          client.Proxy = new WebProxy("brd.superproxy.io:44445");
          client.Proxy.Credentials = new NetworkCredential("brd-customer-<customer_id>-zone-<zone_name>", "<zone_password>");
          Console.WriteLine(client.DownloadString("http://brdtest.com/myip.json"));
      }
  }
  ```

  ```ruby Ruby theme={null}
  #!/usr/bin/ruby

  require 'uri'
  require 'net/http'
  require 'net/https'

  uri = URI.parse('http://brdtest.com/myip.json')
  proxy = Net::HTTP::Proxy('brd.superproxy.io', 44445, 'brd-customer-<customer_id>-zone-<zone_name>', '<zone_password>')

  req = Net::HTTP::Get.new(uri)

  # Make sure you add verify_mode => OpenSSL::SSL::VERIFY_NONE
  result = proxy.start(uri.host,uri.port, :use_ssl => uri.scheme == 'https', :verify_mode => OpenSSL::SSL::VERIFY_NONE) do |http|
      http.request(req)

  send

  puts result.body
  ```

  ```java Java theme={null}
  package example;

  import org.apache.http.HttpHost;
  import org.apache.http.client.fluent.*;

  public class Example {
      public static void main(String[] args) throws Exception {
          HttpHost proxy = new HttpHost("brd.superproxy.io", 44445);
          String res = Executor.newInstance()
              .auth(proxy, "brd-customer-<customer_id>-zone-<zone_name>", "<zone_password>")
              .execute(Request.Get("http://brdtest.com/myip.json").viaProxy(proxy))
              .returnContent().asString();
          System.out.println(res);
      }
  }

  /*In the above example, we are not explicitly ignoring SSL
  I will share with you a short code I wrote that does ignore SSL using JAVA (was taken from cloud proxy manager examples) */

  import java.io.*;
  import java.net.*;
  import java.security.cert.X509Certificate;
  import javax.net.ssl.*;
  import java.util.Base64;

  public class Example {
      public static void main(String[] args) throws Exception {
          // Disable restricted headers for proxy authentication
          System.setProperty("jdk.http.auth.tunneling.disabledSchemes", "");

          // Set up a TrustManager that does not validate certificate chains
          SSLContext sc = SSLContext.getInstance("SSL");

          TrustManager trust_manager = new X509TrustManager() {
              public X509Certificate[] getAcceptedIssuers() {
                  return null;
              }

              public void checkClientTrusted(X509Certificate[] certs, String authType) {
              }

              public void checkServerTrusted(X509Certificate[] certs, String authType) {
              }
          };
          TrustManager[] trust_all = new TrustManager[] { trust_manager };
          sc.init(null, trust_all, new java.security.SecureRandom());
          HttpsURLConnection.setDefaultSSLSocketFactory(sc.getSocketFactory());

          // Set up the proxy and open a connection
          URL url = new URL("https://geo.brdtest.com/mygeo.json");
          Proxy proxy = new Proxy(Proxy.Type.HTTP, new InetSocketAddress("brd.superproxy.io", 44445));
          URLConnection yc = url.openConnection(proxy);

          // Set default Authenticator for proxy authentication
          Authenticator.setDefault(new Authenticator() {
              @Override
              public PasswordAuthentication getPasswordAuthentication() {
                  return new PasswordAuthentication("brd-customer-<customer_id>-zone-<zone_name>", "<zone_password>".toCharArray());
              }
          });

          // Read and print the response from the server
          BufferedReader in = new BufferedReader(new InputStreamReader(yc.getInputStream()));
          String inputLine;
          while ((inputLine = in.readLine()) != null)
              System.out.println(inputLine);
          in.close();
      }
  }
  ```

  ```vba VBA theme={null}
  Imports System.Net

  Module Module1
      Sub Main()
        
          ' Make sure you add this line to ignore ssl error
          ServicePointManager.ServerCertificateValidationCallback = Function(se, cert, chain, sslerror) True

          Dim Client As New WebClient
          Client.Proxy = New WebProxy("http://brd.superproxy.io:44445")
          Client.Proxy.Credentials = New NetworkCredential("brd-customer-<customer_id>-zone-<zone_name>", "<zone_password>")
          Console.WriteLine(Client.DownloadString("http://brdtest.com/myip.json"))
      End Sub
  End Module
  ```

  ```php PHP theme={null}
  <?php
  $curl = curl_init('http://brdtest.com/myip.json');
  curl_setopt($curl, CURLOPT_PROXY, 'http://brd.superproxy.io:44445');
  curl_setopt($curl, CURLOPT_PROXYUSERPWD, 'brd-customer-<customer_id>-zone-<zone_name>:<zone_password>');

  // Make sure you add this line to ignore ssl error
  curl_setopt($curl, CURLOPT_SSL_VERIFYPEER, 0);

  curl_exec($curl);
  ?>
  ```

  ```perl Perl theme={null}
  #!/usr/bin/perl

  use LWP::UserAgent;

  # Make sure you add this line to ignore ssl error
  use IO::Socket::SSL qw( SSL_VERIFY_NONE );

  my $agent = LWP::UserAgent->new();
  $agent->proxy(['http', 'https'], "http://brd-customer-<customer_id>-zone-<zone_name>:<zone_password>\@brd.superproxy.io:44445");
  $agent->ssl_opts(verify_hostname => 0, SSL_verify_mode => SSL_VERIFY_NONE);
  print $agent->get('http://brdtest.com/myip.json')->content();
  ```
</CodeGroup>

## Bright Data Proxy Manager SSL analysis

Some features require the Proxy Manager to have access to HTTPS traffic. This can be done by enabling the **SSL Analyzing** option on the proxy port configuration page.

Once you allow Proxy Manager to terminate the SSL you will also need to [trust Bright Data Certificate Authority (CA)](https://brightdata.com/static/brightdata_proxy_ca.zip).

Under the hood Proxy Manager will create a secure encrypted HTTPS connection with the target site, decrypt the traffic to log requests and run rules based on your settings and then pass the response back to your client in an encrypted HTTPS connection with a certificate signed by our CA certificate.


# Root certificate migration
Source: https://docs.brightdata.com/general/account/ssl-certificate-migration

Migrate to Bright Data's new root certificate on proxy port 44445 before the old certificates on ports 22225 and 33335 expire on September 25, 2026.

Bright Data is replacing the SSL root certificate for `brd.superproxy.io`, and you must migrate to the new certificate on proxy port `44445` before the current certificates expire on **September 25, 2026 at 00:00 UTC** to avoid downtime.

<Warning>
  The current certificates cannot be extended or renewed. After September 25, 2026 at 00:00 UTC, any traffic still relying on the old certificates on ports `22225` or `33335` will fail. Complete the migration before this date.
</Warning>

## Who needs to migrate

You are affected if you use Bright Data proxies, SERP API or Web Unlocker API on port `22225` or `33335`, and/or your code references a Bright Data `.crt` certificate file.

You are not affected if you connect through the Bright Data proxy API instead of native proxy mode, or if your account is verified through the [KYC process](/proxy-networks/residential/network-access#kyc-verification) and you do not load the certificate. See [API vs. native access](/api-reference/authentication).

## Migration timeline

Port `44445` and the new root certificate went live in July 2026. Both the old and new certificates are operational during the transition window, so you can migrate at your own pace before the deadline. On **September 25, 2026 at 00:00 UTC** the old certificates on ports `22225` and `33335` expire, and traffic that still relies on them fails.

## What is changing

| Setting          | Before migration                                                                                | After migration                                                                      |
| ---------------- | ----------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------ |
| Root certificate | `brightdata_root_ca_33335.crt` or the port `22225` certificate (both expire September 25, 2026) | `brightdata_root_ca_44445.crt`                                                       |
| Proxy port       | `22225` or `33335`                                                                              | `44445`                                                                              |
| Certificate file | `brightdata_proxy_ca.zip`                                                                       | `brightdata_proxy_ca.zip` (updated bundle containing `brightdata_root_ca_44445.crt`) |

## Prerequisites

* Access to the host that runs your scraping code or application, where the certificate is loaded or installed
* The new certificate file from Bright Data
* Ability to open outbound traffic to `brd.superproxy.io` on port `44445` in your network or firewall

## How to migrate to the new certificate

1. **Open port `44445`** for outbound traffic to `brd.superproxy.io`. Ask your network or security administrator to allow this if outbound ports are restricted.
2. **Download the certificate bundle** from [brightdata.com/static/brightdata\_proxy\_ca.zip](https://brightdata.com/static/brightdata_proxy_ca.zip) and save `brightdata_root_ca_44445.crt` to the host that runs your code.
3. **Update your proxy port** from your current port (`22225` or `33335`) to `44445` in every place your code or tools connect to Bright Data. The new certificate must be used in conjunction with port `44445`.
4. **Load or install the new certificate** the same way you use the current one. For code that loads the certificate at runtime, point `--cacert` (or your language's equivalent) at the new file. For tools that require an installed certificate, follow the steps in [SSL certificate installation](/general/account/ssl-certificate#installation-of-the-ssl-certificate).
5. **Test one request** against `https://geo.brdtest.com/mygeo.json` to confirm the migration was successful before switching all traffic.

The following cURL example shows a request using the new port and certificate:

```sh theme={null}
curl --proxy brd.superproxy.io:44445 --proxy-user brd-customer-<account-id>-zone-<zone-name>:<zone-password> --cacert <PATH TO NEW CA.CRT> "https://geo.brdtest.com/mygeo.json"
```

## How to verify the migration worked

* A request to `https://geo.brdtest.com/mygeo.json` through port `44445` returns your geolocation JSON without an SSL error.
* Your existing scraping traffic continues to succeed after you switch the port and certificate.

If a request fails with an SSL error after migrating, confirm that the new certificate is the one loaded or installed on the host running the request, and that the request targets port `44445`.

## FAQ

### What happens if I do not migrate by September 25, 2026?

Any traffic that still relies on the old certificates on ports `22225` or `33335` fails after September 25, 2026 at 00:00 UTC. The old certificates cannot be extended or renewed.

### Can I use both certificates during the transition?

Yes. Both the old and new certificates are operational during the transition window, each on its own port, so you can migrate at your own pace before September 25, 2026. Use the certificate that matches the port you connect to.

### Which products does this migration apply to?

Bright Data proxies, SERP API and Web Unlocker API connections that use a Bright Data SSL certificate in native proxy mode on port `22225` or `33335`.


# Users management
Source: https://docs.brightdata.com/general/account/users-management

Manage Bright Data users and permissions across 3 access types: Control Panel users, proxy/API users and billing contacts, each with separate role scopes.

## Types of User Access

Bright Data has 3 main types of users, each refers to a different access channel:

1. Control panel users
2. API Users using API keys
3. Proxy manager users

Those 3 different access methods control the authentication prior to using any Bright Data services.

They are reflect in 3 users' and API keys' tables under the "Account settings" in the control panel.

## Control panel users

Control panel users can get access to Bright Data control panel as well as to other service per permissions assigned to them on creation.

<Note>
  The user signing up to Bright Data is the account manager and has admin permissions by default.
</Note>

### Permissions and allowed actions

| Permission | Actions                                                                                                                                                                                                                                                                    |
| ---------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Admin      | Full account control: create and delete account, add/remove/edit users, add/remove/edit financial and payments, add/remove/edit API key, add/remove/edit proxy manager users, set zone and user limits, add/remove/edit bright data services, consume bright data services |
| Finance    | add/remove/edit financial and payments                                                                                                                                                                                                                                     |
| Ops        | add/remove/edit bright data services                                                                                                                                                                                                                                       |
| User       | Consume Bright Data services                                                                                                                                                                                                                                               |
| Limit      | Edit account limit                                                                                                                                                                                                                                                         |
| User limit | Edit user usage limits                                                                                                                                                                                                                                                     |

## How to manage your API key

Each control panel user can have an API key assigned to him. The first API key is automatically created for the user creating the account. Users with admin permissions cannot display their API key in plain text.

## Proxy Manager users

Proxy manager users are allowed to access only Proxy Manager. The permissions as to which port they can access is done inside the proxy manager console. This is relevant only for users using proxy manager.


# Azure Entra ID SSO setup
Source: https://docs.brightdata.com/general/authentication/How_to_set_up_Azure_SSO_Entra_ID_with_Bright_Data

Step-by-step guide to configuring Azure Entra ID (formerly Azure Active Directory) SSO and SCIM provisioning with Bright Data in 6 steps.

* Prepare application

* Setup SSO

* Setup SCIM provisioning

## How to prepare the application

* Go to [https://entra.microsoft.com/](https://entra.microsoft.com/) and log in to your account.

* Create Enterprise application:

<img alt="Microsoft Entra admin center with the Create Enterprise application button" />

* Click “Create your own application”

* Enter name of your application

* Select “Integrate any other application you don't find in the gallery (Non-gallery)”

* Click “Create”

<img alt="Entra Create your own application dialog with non-gallery option selected" />

## How to set up SSO

<Warning>
  **Enforced Entra SSO disables password-based login.**

  When Entra SSO is enforced for your organization, password-based login and password reset emails are disabled for all users on the account. Users must sign in via Microsoft Entra.

  * Entering an email address on the Bright Data login page automatically redirects the user to the Entra sign-in page.
  * After a successful Entra sign-in, the user is redirected back to Bright Data.
  * Password reset requests will **not** generate an email.
</Warning>

* Go to [https://brightdata.com](https://brightdata.com) and log in to your account.

* Choose Settings->Account settings->Passwords & authentication in left side menu and toggle Microsoft Entra ID (Azur AD) switch

<img alt="Bright Data Passwords and authentication settings with the Microsoft Entra ID toggle" />

* From “App registrations” view select your application.

* Copy “Application (client) ID” to “Client ID”

* Copy “Directory (tenant) ID” to “OAuth2 issuer (tenant)”

* Go to “Add a certificate or secret”

<img alt="Entra App registrations overview showing Application client ID and Directory tenant ID" />

* At secrets screen click “New client secret”

* Fill Description

* Click “Add”

<img alt="Entra Add a client secret dialog with Description and Add button" />

* Once secret is created copy secret value to “Client secret”.

* Copy “Sign-in redirect URI” to be used at next step

<img alt="Bright Data Entra ID dialog with Sign-in redirect URI to copy" />

* At “Authentication” screen click “Add platform” and select “Web”

<img alt="Entra Authentication screen with Add platform dialog and Web option" />

* Paste previously copied “Sign-in redirect URI” to the “Redirect URIs” and save settings by clicking “Configure”:

<img alt="Entra Configure Web platform dialog with Sign-in redirect URI pasted in" />

* Activate EntraID integration at BrighData control panel and test login:

<img alt="Bright Data Entra ID integration activated and ready for test login" />

## Setup SCIM provisioning

* Copy “Auth token” from SCIM section of BrightData EntraID settings:

<img alt="Bright Data Entra ID SCIM section showing the Auth token to copy" />

* Select your application from “Enterprise Applications” view and go to “Provisioning” settings:

<img alt="Entra Enterprise Applications view with Bright Data application selected" />

* Select “Provisioning” under “Manage” menu:

<img alt="Entra Manage menu with Provisioning option highlighted" />

* Select “Automatic” Provisioning Mode

* Fill “Tenant URL” with [https://brightdata.com/users/auth/scim](https://brightdata.com/users/auth/scim) value

* Fill “Secret Token” with previously copied value from BrightData control panel settings

* Test Connection. You should see successful message in top right corner
  Save Settings

<img alt="Entra Provisioning settings with Tenant URL and Secret Token fields filled in" />

* Return to “Overview” tab and click “Start provisioning”.

* You can test provisioning at “Provision on demand” page, but first assign your users to BrightData application at “Users and groups” page:

<img alt="Entra Users and groups page with users assigned to the Bright Data application" />

## Troubleshooting

<AccordionGroup>
  <Accordion title="What should a user do if they are not receiving a password reset email?">
    If your organization has enabled **enforced Entra SSO**, password reset emails are not sent, because password-based authentication is disabled on accounts with enforced SSO.

    To sign in:

    1. Go to the [Bright Data sign-in page](https://brightdata.com/cp).
    2. Enter the user's email address.
    3. The user will be automatically redirected to the Microsoft Entra sign-in page.
    4. After a successful Entra sign-in, the user is redirected back to Bright Data.

    If access issues persist, contact your organization's IT / Entra administrator. They manage the Entra SSO configuration on your company's side.
  </Accordion>

  <Accordion title="Why is a user redirected to a Microsoft login page they do not recognize?">
    This is expected behavior when Entra SSO is enforced. The Bright Data login page detects the email domain associated with your organization's Entra tenant and redirects the user to your configured Microsoft Entra sign-in page.
  </Accordion>
</AccordionGroup>


# Google Workspace SSO setup
Source: https://docs.brightdata.com/general/authentication/How_to_set_up_SSO_with_Google_Workspace_in_Bright_Data

Configure Google Workspace OIDC SSO for Bright Data via a Google Cloud Console OAuth 2.0 client ID. Manual provisioning, hd-claim domain enforcement.

This guide explains how to set up Google Workspace SSO for Bright Data using OIDC, with the OAuth client ID created in the Google Cloud Console and users provisioned manually in the Bright Data Control Panel.

<Note>
  Google Workspace SSO for Bright Data is configured in the **Google Cloud Console** (`console.cloud.google.com`), not the Google Workspace Admin console. This is a separate feature from the public **Continue with Google** sign-in button.
</Note>

**Requirements**

* A Google Cloud project linked to your Google Workspace organization, with permission to configure the OAuth consent screen and create OAuth client IDs (typically a project owner or editor)
* A Bright Data account with admin permission
* All Bright Data users who will sign in via SSO must already exist in the Bright Data Control Panel under **Account Settings → Users**. Bright Data Google Workspace SSO uses manual provisioning. There is no SCIM or JIT provisioning.

<Warning>
  **Enforced Google Workspace SSO disables password-based login.**

  When Google Workspace SSO is enforced for your organization, password-based login and password reset emails are disabled for all users on the account. Users must sign in via Google. Contact your IT / Workspace administrator if access issues arise.
</Warning>

## Configure the OAuth consent screen

1. Sign in to the [Google Cloud Console](https://console.cloud.google.com/) with an account that has access to your Google Workspace organization's project.
2. In the left navigation, go to **APIs & Services → OAuth consent screen**.
3. Set **User type** to **Internal** so only members of your Workspace can sign in.
4. Fill in the required fields (app name, user support email, developer contact information).
5. Save.

## Create the OAuth client ID

6. In the Google Cloud Console, go to **APIs & Services → Credentials**.
7. Click **Create Credentials → OAuth client ID**.
8. Set **Application type** to **Web application**.
9. Name the client. We recommend `Bright Data Control Panel`.
10. Leave **Authorized redirect URIs** empty for now. You will paste in the Bright Data redirect URI in the next section.
11. Click **Create**. Google displays a dialog with your **Client ID** and **Client Secret**. Copy both values.

## Configure Bright Data

12. In a new tab, open the Bright Data [Control Panel](https://brightdata.com/cp/setting) and go to **Account Settings → Passwords & authentication**.
13. Under **Configure Single Sign-On**, click **Google Workspace**.
14. In the dialog, paste:
    * **Client ID** from step 11
    * **Client Secret** from step 11
    * **Workspace Domain**. The primary domain of your Google Workspace (for example, `yourcompany.com`).
15. Copy the read-only **Sign-in redirect URI** displayed in the dialog. It has the form `https://brightdata.com/users/auth/google_workspace/<customer_id>/done`.

## Paste the redirect URI back into Google

16. Return to the Google Cloud Console OAuth client ID you created in step 7.
17. Under **Authorized redirect URIs**, click **Add URI** and paste the **Sign-in redirect URI** from step 15.
18. Click **Save**.

## Activate and test

19. Return to the Bright Data Control Panel **Google Workspace** dialog.
20. Click **Activate**.
21. Test by signing out of Bright Data and signing back in via Google Workspace SSO. Use an account whose email is present in **both** your Google Workspace **and** the Bright Data Control Panel (**Account Settings → Users**).

## Add users for SSO sign-in

Bright Data Google Workspace SSO uses **manual provisioning**. There is no SCIM or JIT user creation. Before a user can sign in:

1. In the Bright Data Control Panel, go to **Account Settings → Users**.
2. Add the user's email address. The email must match the user's primary Google Workspace email.
3. Set the user's role.

When that user signs in via Google Workspace SSO for the first time, Bright Data creates the user record using the pre-added email.

## What else to know

* The OAuth consent screen **must** be set to **Internal** user type. An **External** consent screen would allow any Google account to attempt sign-in.
* The **Workspace Domain** field enforces the OIDC `hd` (hosted domain) claim. Only users whose Google account belongs to the configured Workspace Domain will succeed.
* Google Workspace SSO is a **separate feature** from the public **Continue with Google** sign-in button. They use different client IDs, redirect URIs, and provisioning flows. See [Google OAuth 2.0](/general/authentication/How_to_set_up_SSO_with_Okta_in_Bright_Data#google-oauth-20).
* If you rotate the Client Secret in Google Cloud Console, update it in the Bright Data dialog as well. Otherwise sign-in fails with an `invalid_client` error.
* The Sign-in redirect URI must match exactly between the Bright Data dialog and the Authorized redirect URIs list in Google Cloud Console. Mismatches return a `redirect_uri_mismatch` error.

***

## SSO technical reference

For the full enterprise SSO technical reference, including OIDC parameters and a comparison of provisioning methods across all supported identity providers, see the [SSO technical reference](/general/authentication/How_to_set_up_SSO_with_Okta_in_Bright_Data#sso-technical-reference) on the Okta SSO page.

### Google Workspace-specific parameters

| Parameter                 | Value                                                                                                      |
| ------------------------- | ---------------------------------------------------------------------------------------------------------- |
| Protocol                  | OpenID Connect (OIDC)                                                                                      |
| Application type          | Web application, created in Google Cloud Console → APIs & Services → Credentials                           |
| Required scopes           | `openid profile email`                                                                                     |
| User identifier           | `email` claim                                                                                              |
| Hosted domain enforcement | The `hd` claim is validated on every callback. Only emails from the configured Workspace Domain succeed.   |
| OAuth consent screen      | Must be **Internal** user type                                                                             |
| Provisioning              | Manual. Pre-add the user in Bright Data Control Panel (**Account Settings → Users**) before first sign-in. |


# Okta SSO setup with Bright Data
Source: https://docs.brightdata.com/general/authentication/How_to_set_up_SSO_with_Okta_in_Bright_Data

Step-by-step guide to configure Okta OIDC SSO with Bright Data in 5 steps, plus SSO technical reference for enterprise security questionnaires.

**Requirements**

* An Okta organization account with admin permission
* A Bright Data account with admin permission

<Warning>
  **Enforced Okta SSO disables password-based login.**

  When Okta SSO is enforced for your organization, password-based login and password reset emails are disabled for all users on the account. Users must sign in via Okta. Contact your IT / Okta administrator if access issues arise.
</Warning>

**Steps:**

1. On your Okta admin dashboard, choose '**Applications > Applications**'

```sh theme={null}
https://[your_domain]-admin.okta.com/admin/apps/active
```

2. Click '**Create App Integration**'

<img alt="Okta admin dashboard with Create App Integration button highlighted" />

3. Select '**OIDC - OpenID Connect**' as the Sign-in method,

4. Select'**Web Application**' as the Application type and click '**Next**'

<img alt="Okta Create new app integration dialog with OIDC and Web Application selected" />

5. At this point you should be redirected to a new web app integration page. Here you can name your app integration (we recommend to use "**Bright Data Control Panel**" name).

6. At ‘Grant type’ select **Implicit** along with **Authorization Code**

<img alt="Okta web app grant type settings with Implicit and Authorization Code selected" />

7. Go to Bright Data [Control Panel](https://brightdata.com/cp/setting)

8. Open OKTA configuration dialog

<img alt="Bright Data Control Panel settings page with the Okta SSO configuration dialog open" />

9. Copy **"Sign-in redirect URI"**

**<img alt="Bright Data Okta dialog with Sign-in redirect URI field highlighted for copying" />**

10. Paste it to according field in New App setup in OKTA

<img alt="Okta app integration page with Sign-in redirect URI pasted in" />

11. Repeat the same for **"Sign-out URI"**

12. At ‘Assignments’, select an access level as you want

<img alt="Okta app integration Assignments section showing access level options" />

13. Click '**Save**'

14. Now, you should land on your new app integration settings page.

Copy your **Client ID**, **Client Secret**, and **Okta domain** to OKTA setup dialog in your Bright Data Control Panel. 

<img alt="Okta app integration settings page showing Client ID, Client Secret, and Okta domain fields" />

<img alt="Bright Data Okta SSO dialog with Client ID, Client Secret, and Okta domain pasted in" />

15. Click **"Activate"**.

Skip step 16 if you selected "Allow everyone to access"

16. Go to **"Assignments"** tab and assign users allowed to use this integration

<img alt="Okta Assignments tab listing users assigned to the Bright Data integration" />

17. Go to Bright Data Settings page and make sure all required users presented.

We're working on users provisioning support, at the moment - you should manage it manually.

<img alt="Bright Data Settings users page listing users that can sign in via Okta" />

***The following steps are optional. They are for enabling your users to launch authentication from their dashboard or the Okta Chrome extension.***

18. Scroll down to ‘General Settings’ and click **Edit**

19. Set these settings:

* Login initiated by: **Either Okta or App**
* Application visibility: **Display application icon to users**
* Login flow: **Redirect to app to initiate login (OIDC Compliant)**
* Copy Initiate login URI from Control Panel

<img alt="Okta General Settings showing Login initiated by, Application visibility, and Login flow options" />

<img alt="Bright Data Control Panel showing the Initiate login URI to paste into Okta General Settings" />

20. Save changes. **Now the integration is ready to work.**

**Notes**

* Okta Domain should be the one that appears in your app integration settings (**yourcompany.okta.com**), NOT the one you are seeing as an admin (yourcompany-admin.okta.com)

* Make sure the **Credentials** provided to Bright Data are correct, we cannot check them on our side.

-  **Sign-in Redirect URI** is a must in order to make the SSO feature work correctly\
-  **Initiate login URI** is needed if the you wants to be able to use the feature from the Okta Chrome extension or the Okta dashboard

***

## SSO technical reference

This section is for enterprise security teams completing vendor SSO questionnaires.

### Which SSO protocol is supported

Bright Data supports SSO via **OpenID Connect (OIDC) only**. SAML 2.0 is not supported. There is no SAML metadata XML, Entity ID, or ACS URL.

### Supported identity providers

* Okta
* Microsoft Entra ID (Azure AD)
* Google Workspace

### Which OIDC parameters to configure

| Parameter       | Value                     |
| --------------- | ------------------------- |
| Protocol        | OpenID Connect (OIDC)     |
| User identifier | `email` claim             |
| Required scopes | `profile email`           |
| Required claims | `email`                   |
| Optional claims | `givenName`, `familyName` |

### How account provisioning works

| Identity provider  | Provisioning method                                                                                                                                                                                                                                                                        |
| ------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| Okta               | Manual. Add users in the Bright Data Control Panel. User record is created automatically on first sign-in.                                                                                                                                                                                 |
| Microsoft Entra ID | Automatic via SCIM.                                                                                                                                                                                                                                                                        |
| Google Workspace   | Manual. Add users in the Bright Data Control Panel. User record is created automatically on first sign-in. The OIDC `hd` claim enforces the configured Workspace Domain. See [Google Workspace SSO setup](/general/authentication/How_to_set_up_SSO_with_Google_Workspace_in_Bright_Data). |

### Other SSO details

* Password logins can be disabled entirely.
* Access is controlled by users added to the account, not by email domain.
* Different user roles are available to restrict access per user.

### Google OAuth 2.0

Bright Data also supports login via Google OAuth 2.0.

| Parameter            | Value                                                                                                                                            |
| -------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------ |
| Required scopes      | `https://www.googleapis.com/auth/userinfo.profile`, `https://www.googleapis.com/auth/userinfo.email`                                             |
| Account provisioning | User must be added to the account via the Bright Data Control Panel first. User record is created after signing up using "Continue with Google". |


# Snowflake delivery configuration guide
Source: https://docs.brightdata.com/general/cloud-providers/snowflake

Configure Snowflake as a delivery destination for Bright Data datasets (250+ domains), including connection setup and supported delivery options.

<Note>
  Snowflake configuration is available for 'Datasets' delivery and not available for data collectors (Web Scraper).
</Note>

## How to get started

In order to allow efficient delivery of Datasets to your Snowflake environment, we provide a step-by-step guide to set it up. Just follow these steps:

<Steps>
  <Step title="Select or Create a Database">
    Firstly, decide if you will use an existing database or create a new one. If you opt for a new database, here's the command you need:

    ```sql theme={null}
    CREATE DATABASE <database>;
    ```

    <Tip>
      Remember to replace `<database>` with the name you want for your database.
    </Tip>
  </Step>

  <Step title="Select or Create a Schema">
    Decide if you will use an existing schema or create a new one. By default every database has a PUBLIC schema. If you wish to use a different schema, here's the command you need:

    ```sql theme={null}
    CREATE SCHEMA <schema>;
    ```

    <Tip>
      Replace `<schema>` with your own schema name.
    </Tip>
  </Step>

  <Step title="Select or Create a Warehouse">
    Choose an existing warehouse or create a new one. When creating a new warehouse, consider Snowflake's recommendations for configuring a warehouse specifically for data loading. Use the following command to create a warehouse:

    ```sql theme={null}
    CREATE WAREHOUSE <warehouse>;
    ```

    <Tip>
      Replace `<warehouse>` with your desired warehouse name.
    </Tip>
  </Step>

  <Step title="Select or Create an Internal Named Stage">
    Next, choose an existing internal named stage or create a new one. To create a new stage, use this command:

    ```sql theme={null}
    CREATE STAGE <stage>;
    ```

    <Tip>
      Don't forget to replace `<stage>` with your preferred stage name.
    </Tip>
  </Step>

  <Step title="Create a Role">
    You'll need a role that can write to your chosen stage. To create one, use:

    ```sql theme={null}
    CREATE ROLE <role_name>;
    ```

    <Tip>Change `<role_name>` to your chosen role name.</Tip>
  </Step>

  <Step title="Grant Warehouse Rights to the Role">
    Now, grant your new role the necessary rights to operate on your chosen warehouse using:

    ```sql theme={null}
    GRANT OPERATE ON WAREHOUSE <warehouse> TO ROLE <role_name>;
    ```

    <Tip>
      Remember to replace `<warehouse>` and `<role_name>` with your specific warehouse and role name respectively.
    </Tip>
  </Step>

  <Step title="Enable Write Operations on the Stage for the Role">
    To enable your role to write on the stage, use the command:

    ```sql theme={null}
    GRANT WRITE ON STAGE <stage> TO ROLE <role_name>;
    ```

    <Tip>
      Again, replace `<stage>` and `<role_name>` with your chosen stage and role names.
    </Tip>
  </Step>

  <Step title="Create a BrightData User">
    Next, create a new user for BrightData that will be used to upload data directly into Snowflake. The command is as follows:

    ```sql theme={null}
    create user <user_name>
    PASSWORD = '<password>'
    LOGIN_NAME = <login>
    MUST_CHANGE_PASSWORD = FALSE
    DISABLED = FALSE
    COMMENT = 'user for BrightData to upload data directly into Snowflake'
    ```

    <Tip>
      Replace `<user_name>`, `<password>`, and `<login>` with your chosen username, password, and login name.
    </Tip>
  </Step>

  <Step title="Grant Role Privileges to the New User">
    Finally, grant your new user the privileges of the role you created:

    ```sql theme={null}
    GRANT ROLE <role_name> TO USER <user_name>;
    ```

    <Tip>
      Replace `<role_name>` and `<user_name>` with your role and user names.
    </Tip>
  </Step>

  <Step title="Allowlist IPs">
    If you have an active Network Policy applied in your Snowflake account you need to whiltelist following IPs:

    ```sql theme={null}
    ALTER NETWORK POLICY <policy_name>

    SET ALLOWED_IP_LIST=(
        <existing_allowlisted_ips>,
        '35.169.71.210',
        '34.233.211.38',
        '44.194.183.74',
        '54.243.177.151'
    );
    ```

    <Tip>
      Replace `<policy_name>` with your network policy name. \
      Replace `<existing_whiltelisted_ips>` with the list of existing allowlisted IPs.
    </Tip>

    And that's it! You have now configured your Snowflake environment to receive data from Bright Data.

    If you have any issues or need further assistance, please contact our support team.

    If you want to learn more about Data Loading Performance and Warehouse Size Considerations [click here](https://docs.snowflake.com/en/user-guide/warehouses-overview#impact-on-data-loading).
  </Step>
</Steps>


# Bright Data general FAQs
Source: https://docs.brightdata.com/general/faqs

FAQs about Bright Data accounts: proxy credentials, port 44445, SSL certificates and IP management across all proxy and API products.

<AccordionGroup>
  <Accordion title="Where is my proxy username and password?">
    You can find your username and password for your Bright Data product (e.g. proxy, Web Unlocker API, Browser API etc) in the "Overview" tab for product you created. You can create more than one password if you want.

    **Note**: the username and password you created for the Bright Data site are **NOT** used for accessing the actual products. It is only used for dashboard access.
  </Accordion>

  <Accordion title="Which proxy service port shall I use: 22225 or 33335?">
    In Bright Data we distinguish between our proxy service ports, to which you address your requests and the target ports which refer to the target website or host you are trying to reach.

    This entry refers to Proxy service ports, of our main host: [brd.superproxy.io](http://brd.superproxy.io)

    #### Proxy port

    When working with Bright Data proxies in Native mode, you need to provide a proxy port. This setting is redundant when working with proxy APIs - see more here of the differences between [API vs. native Access](/api-reference/authentication).

    #### Proxy port transition

    Bright Data now serves requests over native proxy port `44445`, introduced with the new root certificate in July 2026. The old certificates on ports `22225` and `33335` expire on September 25, 2026 at 00:00 UTC, and traffic still relying on them after that date will fail. For a step-by-step move, see the [root certificate migration guide](/general/account/ssl-certificate-migration).

    For proxy zones of types **Residential, Mobile, Web Unlocker API and SERP API** which require either [KYC](/proxy-networks/residential/network-access#kyc-verification) or [SSL Certificate](/general/account/ssl-certificate) it is essential to install the correct certificate which complies with port used.

    If you are still using port `22225` or `33335`, complete the transition to port `44445` before September 25, 2026.

    #### Supported settings

    | Port    | Certificate                  | Expiration               |
    | ------- | ---------------------------- | ------------------------ |
    | `44445` | New certificate (required)   | In effect from July 2026 |
    | `33335` | Old certificate (deprecated) | September 25, 2026       |
    | `22225` | Old certificate (deprecated) | September 25, 2026       |

    #### Working in Tandem

    The certificates operate in tandem and differ by port, so you can migrate gracefully. Use the certificate that matches the port you connect to. Port `44445` uses `brightdata_root_ca_44445.crt`.

    ### Transition steps

    To transition to port `44445` you should:

    1. Inform your network administrator or security administrator to open the domain `brd.superproxy.io` on port `44445` for outgoing communication.
    2. If you are using certificate: install the new certificate. See instructions on certificate installation here: [SSL Certificate](/general/account/ssl-certificate)
  </Accordion>

  <Accordion title="How do I set up a password for my account?">
    Even if you first signed in with 'magic link' or using a six-digit code, you can always create a password for your account. You can then save the password in your browser for faster access to the control panel.

    To set up a password for your Bright Data account, follow these steps:

    1. Access authentication settings: Click on "Settings" and go to the ['Passwords & authentication' tab](https://brightdata.com/cp/setting/auth)
    2. Create your password: Follow the instructions to create a password for your account. We recommend at least a 10-digit password with numbers and symbols.

    Remember, each user must set their own password. If you have other users on your account, they can configure their passwords individually if needed.

    Note: If you're authenticated via third-party service like Google or GitHub, please add a separate user and sign in through Bright Data's standard signup flow instead of using third-party services.
  </Accordion>

  <Accordion title="How to review IPs Allocated to Your Zone?">
    To review the list of IPs allocated to your zone, simply navigate to [**‘My proxies page’**](https://brightdata.com/cp/zones), **click** on your Proxy zone, scroll down to the **‘Allocated IPs’** section, then simply click **‘Show allocated IPs’** or **‘Download IPs list'.**

    <Note>
      Due to privacy and security concerns, this option is not available for Residential Shared Pay-Per-GB configuration. See `-session` flag instead.
    </Note>

    <img alt="review-allocated-ips.gif" />
  </Accordion>

  <Accordion title="How to view your zone's statistics?">
    There are 2 ways to view your zones statistics:

    <Tabs>
      <Tab title="via Control Panel">
        * To see stats across all your zones, go to your [dashboard](https://brightdata.com/cp/zones/dashboard):

          <img alt="statistics-via-control-panel.png" />
        * To see stats for a specific zone, click on "Proxies and Scraping" on the left navigation bar and go to the zone's settings and click the "statistics" tab:

          <img alt="specific-zone-statics.gif" />
      </Tab>

      <Tab title="via The API">
        * Please visit [this page](/api-reference/) to see all available API endpoints (in multiple languages) and example responses related to viewing statistics.
      </Tab>
    </Tabs>
  </Accordion>

  <Accordion title="How to set limits to bandwidth usage?">
    By default, all proxy zones have unlimited usage, and you can set a limit by one of 4 parameters:

    * \$/day
    * \$/month
    * bytes/day
    * bytes/month

    To set this limit on one of your zones, from Bright Data's ['My proxies page'](https://brightdata.com/cp/zones)

    <Steps>
      <Step title="Go to any of your zone's settings by clicking on that zone." />

      <Step title="Go to the &#x22;Access parameters&#x22; tab.">
        <img alt="access-parameters.png" />
      </Step>

      <Step title="Scroll down to &#x22;Limit&#x22;, the default value is &#x22;unlimited&#x22;" />

      <Step title="Click the &#x22;edit&#x22; button">
        <img alt="edit-limit.png" />
      </Step>

      <Step title="Enable the &#x22;spend limit&#x22; option.">
        <img alt="spend-limit-toggle.png" />
      </Step>

      <Step title="Set the parameters you wish to work with and click &#x22;update&#x22;" />

      <Step title="You'll see the change back in the Limit section and the proxies page, in the Usage/Spend Limit column." />
    </Steps>
  </Accordion>

  <Accordion title="How do I calculate the Cost effectiveness of residential IPs?">
    <img alt="cost-limits-table.png" />

    **How did we calculate this table?**

    Your company needs to collect information from the web by sending 1,000 http requests per hour to a specific website. You write the scraper code and run it through a server. The target website allows 50 requests per minute from the same IP before blocking your scraper. Now, you have to purchase more proxies.

    **Assuming you choose datacenter proxies:**\
    You don't want to share IPs, so you buy 200 dedicated data-center IPs. You code the integration of the scraper with the new data-center proxies for 2 hours and then run the new program. This time, it takes 3 days for your target website to detect your scraper. Once your proxies are detected, you'll have to purchase new proxies and repeat this process again, checking each day to make sure the proxies haven't been detected. Cost per month (all numbers are from real customers):

    * 200 dedicated IPs: \$500
    * Bandwidth: (1000 request X 20KB per request X 24 hours X 30 days = 14.5GB): \$3 per month
    * Developer (2 hours integration X 10 + 1 hour every 3 days for managing the proxies): \~3 days of work a month or \~\$900

    Your total cost per month will be at least \$1400 for just these things alone, and the salary of \$30 per hour for a developer is very conservative. Additionally, this doesn't account for a lack of information reliability if your target website sends misinformation before blocking you or if your information flow is cut every few days, which can be detrimental to your brand or your revenue stream.

    **Assuming you choose Bright Data residential proxies:** You buy a basic package of 40GB with access to unlimited residential IPs. It takes 2 hours to integrate your scraper. Due to Bright Data's pool of 400M+ residential IPs, your target website can't detect your scraper, allowing you to focus on other projects.

    The bandwidth and unlimited IPs cost just \$500 per month. Your information is always reliable because your requests are always successful and access is never cut in the middle of the month. When your business grows as a result of this scraping and your projects exceed 600MB each month, the difference in costs can be much higher than just \~\$1000.

    Bright Data also allows you to suspend your account when not in use, so your cost can be lower than \$500 per month. Start by using the \$5 voucher for free data-center traffic to test Bright Data's benefits and then ask for access to our residential network for cheap and reliable data collection.
  </Accordion>

  <Accordion title="What is the yellow warning icon next to my zone name?">
    > **This is a reminder to setup your allowlist access**

    To restrict your proxy zone access from unauthorized servers, we recommend you setup an IP allowlist. This will ensure only IPs you recognize will be allowed to access your proxy zone, for higher security and control.

    Consult your IT or networking specialist to make sure your outgoing IP is fixed and does not change, otherwise you may block yourself or other authorized users from your company to access the proxy zone.
  </Accordion>

  <Accordion title="How to restrict access using Token-based Authentication">
    This workflow is optimal when using multiple crawlers with rotating IPs that target the Proxy Manager installed remotely. This method requires you API key an Authentication token.

    Run From inside the remote server the next command in Terminal/CMD

    ```sh theme={null}
    curl -X GET "http://127.0.0.1:22999/api/gen_token" -H "accept: application/json"
    ```

    This will generate an API key as an authentication token for you:

    ```sh Output theme={null}
    "token":"<API_KEY>"
    ```

    Now you can simply send a request using the API key you just created:

    ```sh theme={null}
    curl -x token:<API_KEY>@<remote-server-IP>:<Port> "target-site.com"
    ```
  </Accordion>

  <Accordion title="Is there a way to know if my publicly-available data was collected by Bright Data's collection platform?">
    > **Yes**

    You can check if your public data was collected here: [https://brightdata.com/check\_your\_data](https://brightdata.com/check_your_data).
  </Accordion>

  <Accordion title="Do you only collect public data or do you also collect private data?">
    We never collect private data. We only collect publicly-available data.
  </Accordion>

  <Accordion title="What is Playground mode?">
    When you sign up, your account automatically enters a free trial "Playground mode" for the first 7 days, allowing you to instantly try different Bright Data solutions. No credit card or any other form of payment method is needed.

    Separately, every new account also gets a recurring [free tier](/general/account/billing-and-pricing/free-tier) of 5,000 credits per month for the Web Unlocker API, SERP API, Web Scraper API and Scraper Studio. These credits renew on the first of each month and do not expire with the trial.

    You can extend this free trial to **30 days** and **unlock Proxy and Web Unlocker API usage**. To do so and receive a \$5 free credit, [verify your account](https://brightdata.com/cp/billing_flow) to start our Limited 30-day trial. Note that the 30-day trial does not apply to certain countries.

    <Info>
      During Playground mode, **Proxy Networks** (Residential, Mobile, ISP, Datacenter) and **Web Unlocker API** are not available for accounts registered with personal email addresses and no payment method on file. Adding a payment method removes this restriction. See [Payment Verification](/general/account/billing-and-pricing/payment-verification).
    </Info>

    <Note>
      Playground mode is a free trial intended for small-scale testing and exploration, not for large-scale tests or production use. Product usage is subject to limitations such as speed, bandwidth, and requests per second until you [verify your account](https://brightdata.com/cp/billing_flow) and start our [Limited Trial](/general/faqs#what-is-limited-trial-mode).
    </Note>

    <Note>
      While operating in Playground mode (or any unfunded state), requests across the SERP API, Web Unlocker API and Proxies are subject to a default rate limit of 1,000 requests per minute. You can verify your current rate limit in the Control Panel, under the zone's Overview tab > Access details.
    </Note>
  </Accordion>

  <Accordion title="What is Limited Trial mode?">
    **Limited Trial** mode if a free trial period that allows you to freely explore our Bright Data proxy solutions without immediate payment. You'll receive a \$5 credit to use any of our proxy services for a period of 30 days, giving you a full month to test and experience our offerings.

    Note that the 30-day trial does not apply to certain countries. If you don't see this option, add funds to your account to start using Bright Data - you can add as little as \$10 to get started with a Pay as You Go plan.

    #### How do I verify my account to start the “Limited Trial” and receive a \$5 credit?

    Account verification is simple and free. Just [add a valid payment method](https://brightdata.com/cp/billing_flow) to your account to start **Limited Trial** mode and receive your \$5 credit. You will not be charged.

    #### What happens after the 30-day trial?

    At the end of the 30-day trial period, your \$5 proxy trial credit expires (if not already used), and you will need to add funds to your account to keep using the proxy products. The recurring [free tier](/general/account/billing-and-pricing/free-tier) of 5,000 credits per month for the Web Unlocker API, SERP API, Web Scraper API and Scraper Studio is unaffected and continues to renew monthly.

    #### Can I use the free credit on any of your proxy products?

    Yes, the \$5 trial credit can be used on any of our proxy products during the duration of the trial, allowing you to test the products that best fit your needs.
  </Accordion>

  <Accordion title="Why can't I connect to brightdata.com site or dashboard?">
    In rare cases, some ad-blocking program/extensions can block access to Bright Data sites. If you encounter any issues, allowlist brightdata.com or disable the ad-blocker.
  </Accordion>

  <Accordion title="Where can I see the list of country codes?">
    Below is the list of ISO 3166 country codes.  **Not** all the countries in the list have Bright Data proxies, most of the countries do.

    | Country Name                                               | Country code |
    | ---------------------------------------------------------- | ------------ |
    | Åland Islands                                              | ax           |
    | Zimbabwe                                                   | zw           |
    | Zambia                                                     | zm           |
    | Yemen                                                      | ye           |
    | Western Sahara                                             | eh           |
    | Wallis and Futuna                                          | wf           |
    | Virgin Islands (U.S.)                                      | vi           |
    | Virgin Islands (British)                                   | vg           |
    | Viet Nam                                                   | vn           |
    | Venezuela (Bolivarian Republic of)                         | ve           |
    | Vanuatu                                                    | vu           |
    | Uzbekistan                                                 | uz           |
    | Uruguay                                                    | uy           |
    | United States of America (the)                             | us           |
    | United States Minor Outlying Islands (the)                 | um           |
    | United Kingdom of Great Britain and Northern Ireland (the) | gb           |
    | United Arab Emirates (the)                                 | ae           |
    | Ukraine                                                    | ua           |
    | Uganda                                                     | ug           |
    | Tuvalu                                                     | tv           |
    | Turks and Caicos Islands (the)                             | tc           |
    | Turkmenistan                                               | tm           |
    | Turkey                                                     | tr           |
    | Tunisia                                                    | tn           |
    | Trinidad and Tobago                                        | tt           |
    | Tonga                                                      | to           |
    | Tokelau                                                    | tk           |
    | Togo                                                       | tg           |
    | Timor-Leste                                                | tl           |
    | Thailand                                                   | th           |
    | Tanzania, United Republic of                               | tz           |
    | Tajikistan                                                 | tj           |
    | Taiwan (Province of China)                                 | tw           |
    | Syrian Arab Republic                                       | sy           |
    | Switzerland                                                | ch           |
    | Sweden                                                     | se           |
    | Svalbard and Jan Mayen                                     | sj           |
    | Suriname                                                   | sr           |
    | Sudan (the)                                                | sd           |
    | Sri Lanka                                                  | lk           |
    | Spain                                                      | es           |
    | South Sudan                                                | ss           |
    | South Georgia and the South Sandwich Islands               | gs           |
    | South Africa                                               | za           |
    | Somalia                                                    | so           |
    | Solomon Islands                                            | sb           |
    | Slovenia                                                   | si           |
    | Slovakia                                                   | sk           |
    | Sint Maarten (Dutch part)                                  | sx           |
    | Singapore                                                  | sg           |
    | Sierra Leone                                               | sl           |
    | Seychelles                                                 | sc           |
    | Serbia                                                     | rs           |
    | Senegal                                                    | sn           |
    | Saudi Arabia                                               | sa           |
    | Sao Tome and Principe                                      | st           |
    | San Marino                                                 | sm           |
    | Samoa                                                      | ws           |
    | Saint Vincent and the Grenadines                           | vc           |
    | Saint Pierre and Miquelon                                  | pm           |
    | Saint Martin (French part)                                 | mf           |
    | Saint Lucia                                                | lc           |
    | Saint Kitts and Nevis                                      | kn           |
    | Saint Helena, Ascension and Tristan da Cunha               | sh           |
    | Saint Barthélemy                                           | bl           |
    | Réunion                                                    | re           |
    | Rwanda                                                     | rw           |
    | Romania                                                    | ro           |
    | Republic of North Macedonia                                | mk           |
    | Qatar                                                      | qa           |
    | Puerto Rico                                                | pr           |
    | Portugal                                                   | pt           |
    | Poland                                                     | pl           |
    | Pitcairn                                                   | pn           |
    | Philippines (the)                                          | ph           |
    | Peru                                                       | pe           |
    | Paraguay                                                   | py           |
    | Papua New Guinea                                           | pg           |
    | Panama                                                     | pa           |
    | Palestine, State of                                        | ps           |
    | Palau                                                      | pw           |
    | Pakistan                                                   | pk           |
    | Oman                                                       | om           |
    | Norway                                                     | no           |
    | Northern Mariana Islands (the)                             | mp           |
    | Norfolk Island                                             | nf           |
    | Niue                                                       | nu           |
    | Nigeria                                                    | ng           |
    | Niger (the)                                                | ne           |
    | Nicaragua                                                  | ni           |
    | New Zealand                                                | nz           |
    | New Caledonia                                              | nc           |
    | Netherlands (the)                                          | nl           |
    | Nepal                                                      | np           |
    | Nauru                                                      | nr           |
    | Namibia                                                    | na           |
    | Myanmar                                                    | mm           |
    | Mozambique                                                 | mz           |
    | Morocco                                                    | ma           |
    | Montserrat                                                 | ms           |
    | Montenegro                                                 | me           |
    | Mongolia                                                   | mn           |
    | Monaco                                                     | mc           |
    | Moldova (the Republic of)                                  | md           |
    | Micronesia (Federated States of)                           | fm           |
    | Mexico                                                     | mx           |
    | Mayotte                                                    | yt           |
    | Mauritius                                                  | mu           |
    | Mauritania                                                 | mr           |
    | Martinique                                                 | mq           |
    | Marshall Islands (the)                                     | mh           |
    | Malta                                                      | mt           |
    | Mali                                                       | ml           |
    | Maldives                                                   | mv           |
    | Malaysia                                                   | my           |
    | Malawi                                                     | mw           |
    | Madagascar                                                 | mg           |
    | Macao                                                      | mo           |
    | Luxembourg                                                 | lu           |
    | Lithuania                                                  | lt           |
    | Liechtenstein                                              | li           |
    | Libya                                                      | ly           |
    | Liberia                                                    | lr           |
    | Lesotho                                                    | ls           |
    | Lebanon                                                    | lb           |
    | Latvia                                                     | lv           |
    | Lao People's Democratic Republic (the)                     | la           |
    | Kyrgyzstan                                                 | kg           |
    | Kuwait                                                     | kw           |
    | Korea (the Republic of)                                    | kr           |
    | Korea (the Democratic People's Republic of)                | kp           |
    | Kiribati                                                   | ki           |
    | Kenya                                                      | ke           |
    | Kazakhstan                                                 | kz           |
    | Jordan                                                     | jo           |
    | Jersey                                                     | je           |
    | Japan                                                      | jp           |
    | Jamaica                                                    | jm           |
    | Italy                                                      | it           |
    | Israel                                                     | il           |
    | Isle of Man                                                | im           |
    | Ireland                                                    | ie           |
    | Iraq                                                       | iq           |
    | Iran (Islamic Republic of)                                 | ir           |
    | Indonesia                                                  | id           |
    | India                                                      | in           |
    | Iceland                                                    | is           |
    | Hungary                                                    | hu           |
    | Hong Kong                                                  | hk           |
    | Honduras                                                   | hn           |
    | Holy See (the)                                             | va           |
    | Heard Island and McDonald Islands                          | hm           |
    | Haiti                                                      | ht           |
    | Guyana                                                     | gy           |
    | Guinea-Bissau                                              | gw           |
    | Guinea                                                     | gn           |
    | Guernsey                                                   | gg           |
    | Guatemala                                                  | gt           |
    | Guam                                                       | gu           |
    | Guadeloupe                                                 | gp           |
    | Grenada                                                    | gd           |
    | Greenland                                                  | gl           |
    | Greece                                                     | gr           |
    | Gibraltar                                                  | gi           |
    | Ghana                                                      | gh           |
    | Germany                                                    | de           |
    | Georgia                                                    | ge           |
    | Gambia (the)                                               | gm           |
    | Gabon                                                      | ga           |
    | French Southern Territories (the)                          | tf           |
    | French Polynesia                                           | pf           |
    | French Guiana                                              | gf           |
    | France                                                     | fr           |
    | Finland                                                    | fi           |
    | Fiji                                                       | fj           |
    | Faroe Islands (the)                                        | fo           |
    | Falkland Islands (the) \[Malvinas]                         | fk           |
    | Ethiopia                                                   | et           |
    | Eswatini                                                   | sz           |
    | Estonia                                                    | ee           |
    | Eritrea                                                    | er           |
    | Equatorial Guinea                                          | gq           |
    | El Salvador                                                | sv           |
    | Egypt                                                      | eg           |
    | Ecuador                                                    | ec           |
    | Dominican Republic (the)                                   | do           |
    | Dominica                                                   | dm           |
    | Djibouti                                                   | dj           |
    | Denmark                                                    | dk           |
    | Côte d'Ivoire                                              | ci           |
    | Czechia                                                    | cz           |
    | Cyprus                                                     | cy           |
    | Curaçao                                                    | cw           |
    | Cuba                                                       | cu           |
    | Croatia                                                    | hr           |
    | Costa Rica                                                 | cr           |
    | Cook Islands (the)                                         | ck           |
    | Congo (the)                                                | cg           |
    | Congo (the Democratic Republic of the)                     | cd           |
    | Comoros (the)                                              | km           |
    | Colombia                                                   | co           |
    | Cocos (Keeling) Islands (the)                              | cc           |
    | Christmas Island                                           | cx           |
    | China                                                      | cn           |
    | Chile                                                      | cl           |
    | Chad                                                       | td           |
    | Central African Republic (the)                             | cf           |
    | Cayman Islands (the)                                       | ky           |
    | Canada                                                     | ca           |
    | Cameroon                                                   | cm           |
    | Cambodia                                                   | kh           |
    | Cabo Verde                                                 | cv           |
    | Burundi                                                    | bi           |
    | Burkina Faso                                               | bf           |
    | Bulgaria                                                   | bg           |
    | Brunei Darussalam                                          | bn           |
    | British Indian Ocean Territory (the)                       | io           |
    | Brazil                                                     | br           |
    | Bouvet Island                                              | bv           |
    | Botswana                                                   | bw           |
    | Bosnia and Herzegovina                                     | ba           |
    | Bonaire, Sint Eustatius and Saba                           | bq           |
    | Bolivia (Plurinational State of)                           | bo           |
    | Bhutan                                                     | bt           |
    | Bermuda                                                    | bm           |
    | Benin                                                      | bj           |
    | Belize                                                     | bz           |
    | Belgium                                                    | be           |
    | Belarus                                                    | by           |
    | Barbados                                                   | bb           |
    | Bangladesh                                                 | bd           |
    | Bahrain                                                    | bh           |
    | Bahamas (the)                                              | bs           |
    | Azerbaijan                                                 | az           |
    | Austria                                                    | at           |
    | Australia                                                  | au           |
    | Aruba                                                      | aw           |
    | Armenia                                                    | am           |
    | Argentina                                                  | ar           |
    | Antigua and Barbuda                                        | ag           |
    | Antarctica                                                 | aq           |
    | Anguilla                                                   | ai           |
    | Angola                                                     | ao           |
    | Andorra                                                    | ad           |
    | American Samoa                                             | as           |
    | Algeria                                                    | dz           |
    | Albania                                                    | al           |
    | Afghanistan                                                | af           |
  </Accordion>

  <Accordion title="Can I use Bright Data as a VPN for my PC?">
    Not really. Bright Data is a service for enterprise customers who want to collect public web data from the Internet, and is not designed for private users.

    In addition, using Bright Data does not encrypt your Internet traffic.

    If you want a free VPN, we recommend you check out [BrightVPN](https://brightvpn.com) - it is available for Windows and macOS.
  </Accordion>

  <Accordion title="Can I use the direct Bright Data API to manage my account?">
    Yes, we have extensive coverage of actions that can be performed programmatically via code by using our direct API to manage your account and proxies/zones - you can perform actions like adding or deleting zones, managing IP allowlists/denylists, fetch a list of IPs allocated to your zone, get billing balance and so on. For more detailed and accurate information, please see our API documentation section - [Account Management API Documentation](/api-reference/account-management-api)
  </Accordion>

  <Accordion title="How can I add my company details to the invoice?">
    You can add your company details in the [Account Settings](https://brightdata.com/cp/setting/customer_details), and your monthly invoices will be addressed to your company automatically.
  </Accordion>

  <Accordion title="How can I change/update the email address on my account?">
    You cannot directly "change" or "update" the email address in your account. But, you *can* create a new user with the new email address, and then delete the "old" user - this would achieve the same desired result as updating/changing/replacing your email address.
  </Accordion>

  <Accordion title="How to access proxies with IP allowlist only? (IP:PORT method)">
    To gain access your proxies by IP allowlist authentication only (IP:PORT), without using the API key authentication method or the USERNAME:PASSWORD authentication method, you can utilize the [Proxy Manager](/proxy-networks/proxy-manager/introduction) tool.
  </Accordion>

  <Accordion title="How much time does it take to get a KYC decision and how can I see my account verification status? ">
    It usually takes up to 2 business days to review your KYC request. However, if your submission does not include all the information, or the documentation submitted is unclear visually, outdated or incorrect the KYC can take longer.

    To check your account verification status browse to the control panel, under account settings -> Profile. In there you can see your verification status as one of: `not submitted` , `in progress` , `approved` or `denied`.

    Click this link to view the status: [https://brightdata.com/cp/setting/customer\_details](https://brightdata.com/cp/setting/customer_details)
  </Accordion>

  <Accordion title="Can I use personal email for KYC?">
    No, only company email addresses are accepted for KYC verification.
  </Accordion>

  <Accordion title="Where can I see the legal restrictions and policies of Bright Data?">
    To see our legal restrictions and policies, please see the following page: [Bright Data Master Service Agreement](https://brightdata.com/license)
  </Accordion>

  <Accordion title="How can I contact Bright Data Support/Account Manager/Sales/Compliance? ">
    If you need to reach out to our staff, you can do that either through the Help & Support section in the control panel - in the top right section of the screen under the question mark icon (?) or by emailing [sales@brightdata.com](mailto:sales@brightdata.com), [support@brightdata.com](mailto:support@brightdata.com) or [compliance@brightdata.com](mailto:compliance@brightdata.com)

    Note: assistance from our staff is only provided to paying customers or customers who are employees of an enterprise. If the option to contact support is not available via the control panel, please add funds to your account and the option will be unlocked.
  </Accordion>

  <Accordion title="What is zproxy.lum-superproxy.io? ">
    zproxy.lum-superproxy.io is a deprecated proxy integration endpoint that was used by Bright Data in the past - It should not be used anymore as it has been replaced with: `brd.superproxy.io`
  </Accordion>

  <Accordion title="When should i use scrapers and when should i use datasets?">
    **When should I use scrapers vs. datasets?**

    * Use Scrapers: When you need fresh or real-time data (e.g., prices, news, or live updates) or if the data isn’t available in existing datasets. Scrapers are ideal for tracking changes over time or gathering niche, specific information directly from websites.
    * Use Datasets: When you need historical data or pre-collected, and structured information. Datasets save time and effort, especially for machine learning, analytics, or research, but may not always be up-to-date.

    For ongoing projects, you can combine datasets for historical context and scrapers for real-time updates.
  </Accordion>

  <Accordion title="I want to DELETE my account">
    If you wish to completely delete your account:

    * Go to Settings -> Account Settings -> Profile.
    * Click on Delete account

    Notice that:

    * This action cannot be undone.
    * All your data and settings will be lost
    * All users will be logged out and lose access to the Bright Data Control Panel
  </Accordion>

  <Accordion title="How do I find my Bright Data account ID? ">
    Your Bright Data account ID is a component in your proxy username credentials, and when asking for support, you may need to provide it so a support engineer can provide a proper answer.

    Your account ID and login to Bright Data control panel **are not** your proxy logins. Each zone has its own username and password to access.

    You can see your bright data account ID if you click the User icon on the top right part of your control panel, or by browsing to : "Account settings" on the left menu and selecting the "Profile" tab. You can access the profile tab directly by using this link: [https://brightdata.com/cp/setting/customer\_details](https://brightdata.com/cp/setting/customer_details)
  </Accordion>

  <Accordion title="What do I need to do to submit KYC?">
    In order to submit a KYC you must register to [BrightData.com](http://BrightData.com) with a **company email** Free emails like `***@google`.com or `***@yahoo.com` com are not eligible to submit a KYC. Requests from free email providers are not allowed and rejected on the spot.

    During the process, you will be required to provide proof of identity, business identity and ownership/role as well as your business use cases.
  </Accordion>
</AccordionGroup>


# How consumers join the peers network
Source: https://docs.brightdata.com/general/policy/How_do_consumers_join_the_Bright_Data_network_of_peers_

How consumers join the Bright Data peer network of 400M+ residential IPs through partner apps, with full opt-in consent and resource usage protections.

Many applications (such as game applications), require their users to view a video advertisement at certain intervals, so that the game developer can generate revenues. This creates a particularly bad user experience, as it interferes with the experience of the application, wastes around 20MB of cellular data for the ad, and depletes the user's battery.

Bright Data offers an attractive alternative.

When these application vendors integrate the Bright SDK, their users are offered the alternative to not watch these video ads in return for opting in to the Bright Data network. Bright Data only uses their device as a node on the network when it is not in use (so never interferes with the user's experience), when the device is plugged in to power or charged, and always prefers WiFi over cellular data.

For every user that opts in to the Bright Data network, Bright Data pays a monthly fee to the application vendor, who passes that value on to the user by not displaying ads (or by not charging a premium for extra features in some cases).

That provides a much better user experience to the users, and thus the application vendor also enjoys a higher adoption rate of his/her product.

Users choose (opt in) to be a part of the Bright Data network, and may opt out at any time. Bright Data ensures that its application partners are fully compliant with this 'opt in' user flow.

View more on our [Bright SDK](https://bright-sdk.com/) page.


# What is Bright Data platform?
Source: https://docs.brightdata.com/general/policy/What_is_Bright_Data_platform

Overview of the Bright Data platform and how it provides businesses, researchers, and developers with compliant access to public web data.

The Bright Data Network provides you with the public web data you need to make the difference to your business, project research, or initiative.


# Acceptable use policy
Source: https://docs.brightdata.com/general/policy/acceptable-use-policy

Bright Data's Acceptable Use Policy defines permitted and prohibited platform uses across 4 product areas, including restrictions on illegal activity.

Bright Data’s platform, technology, and network (collectively, “Services”) are meant for legitimate and legal purposes only and are subject to the [Bright Data Master Service Agreement](https://brightdata.com/license).

Bright Data takes and will take firm action against illegal or non-compliant use of the Bright Data Services, and will assist law enforcement in investigating potentially abusive activities of the Bright Data Services.

Any use of the Bright Data Services for illegal, fraudulent, or abusive activities is strictly prohibited. Any such suspected use will be investigated.

Forbidden activities include, but are not limited to:

* Collection of nonpublic information (i.e data behind login)
* DDoS attacks
* Spam: mass posting any mail/message boards/IRC/comments messages and images
* Ad fraud or click fraud
* Impersonation or spoofing for fraudulent purposes
* Creating fake accounts or content
* Use of automatic ticket purchasing (ticket-bots)
* Raffles, lottery, or gambling
* Fake engagement (likes, comments, shares, etc.)
* Gaming or trading of in games items/currency
* Reselling of proxies without Bright Data’s prior written approval (see our [partners programs](https://brightdata.com/partners))
* Use of streaming related domains (videos, music or images streaming)
* Trading crypto/virtual currency or NFT
* Any Search Engine Optimization (SEO) manipulation (i.e: fake clicks in search engines results)
* Posting on classified, used, and resell sites (such as Craig’s list)
* Completion of surveys in return for a benefit or anything of value
* Any form of activity that is in violation of applicable law or regulations or any third party rights

Bright Data proactively blocks certain web content (i.e: Adult content, Governmental websites, Harmful domains, etc.), as determined by Bright Data in its sole and exclusive discretion. Bright Data reserves the right to add or retract, at any time and at its sole discretion, any web content blocking.

Use of Bright Data Services may be limited by Bright Data in its sole discretion in order to prevent any damage or service disruption to any third party computers or service. Bright Data shall not be liable towards Client for any limits imposed as described herein.

We encourage users to report any misuse or suspicious activity in our network through our dedicated email ([abuse@brightdata.com](mailto:abuse@brightdata.com)) or our reporting channel ([https://brightdata.com/report-abuse](https://brightdata.com/report-abuse)) .


# App privacy and security
Source: https://docs.brightdata.com/general/privacy/privacy-and-security-for-apps

How Bright Data ensures the privacy and security of users who install its apps across 3 protections: open-source SDK, sandboxing and user controls.

Bright Data takes the privacy and security of its users very seriously and has internal procedures and tests aimed specifically at this area that run 24/7. Aside from this we do several external audits a year that include all security and privacy aspects of the software running on the user's devices. However this wasn't enough for us. We want the security and privacy of our users to be clear, transparent and self-evident. We are working on these drastic steps that will be completed by the end of 2021:

* Making the Bright Peer SDK open source. Anyone can look at the code, breakdown our production releases and compare the code and validate it's identical. Every internal release we do is pushed out to open source for the public eye.
* Running the Bright SDK in a sandbox environment. No matter what privileges the user installs the Bright App with, it will always be constrained by the sandbox it's running in. So even if given root access it will not be able to actually collect anything from the user\`s private data.
* Adding full user control. Bright app users can now fully control when their devices will be available as peers on the network, what bandwidth will be allocated to it, resource levels and even low level control over the target domains that are allowed through the device. Everything is transparent and configurable.
* Collaboration with a known security company to secure the network traffic going through the residential network. Every target domain goes through real time updated denylists and sites that are marked as malicious, containing malware or any other illegal content are blocked before any traffic can be sent through the user\`s device


# Protecting end user resources
Source: https://docs.brightdata.com/general/privacy/protect-end-users-resources

How Bright Data's idle monitor technology protects end users' battery, bandwidth and data plan across 3 resource categories when the device is a network node.

Bright Data's patented idle monitor technology ensures that an end user's device is used under strict limitations so that battery power, bandwidth and data plan are preserved. These limitations consist of a monitor that restricts the usage of the device if being used by the end user, a minimum battery level threshold, a preference for use only when charging, a maximum daily allowed bandwidth usage per device and weekly maximum usage.

## Are Bright Data Apps exposed to the user's private network traffic?

> **No**

Bright Data Apps are not exposed to the users' private network traffic, don't gather it, log it, or send it anywhere. We are not interested in it, it's not our business and this was always the case.

In mobile operating systems Bright Data software is limited by the permissions infrastructure and so cannot access private data. On desktop operating systems Bright Data is in the process of releasing a new version of its software that will run inside a sandbox that will make it very clear that it does not have access to any User private information.


# How does Bright Data handle abuse report?
Source: https://docs.brightdata.com/general/security/abuse-report-handling

How Bright Data handles abuse reports: domain blocking, traffic investigation, and escalation to the compliance and legal team.

Each abuse report arrives to the compliance team. The validity and authenticity of the reporter is validated and an abuse procedure is opened. The procedure covers in detail who is responsible for the process, who does the investigation, who needs to be notified in and out of the company, etc.

First of all the domain that is allegedly being targeted is blocked as a preventive measure so that if there is real harm in progress we will stop it while investigating the claim.

The submitted logs are analyzed and traffic traced back to its source. If the abuse is validated all the information is transferred to the compliance officer and legal team to take the proper actions.

If the reporter wants to pursue legal action they can do so with the local authorities and Bright Data will cooperate with any official investigation.


# Allowlist and denylist IPs and domains
Source: https://docs.brightdata.com/general/security/allowlist-denylist-ips-domains

Configure allowlists and denylists for IPs and domains in your Bright Data proxy zone (port 44445) to control who can access it for traffic security.

## Key terms defined

* Allowlist is the list of IP addresses which are permitted accessing your zone.
* Denylist is the list of IP addresses which are denied accessing your zone.

<Note>
  The Allowlist shall include the IP addresses from which you **originate the requests** to the proxies in your company or cloud network. The list **should not** include the IPs of the proxies provided by Bright Data.
</Note>

## How to configure Allowslit and Denylist

There are two ways to configure the allowlist and the denylist: either by the control panel or by using Bright Data account management APIs.

### How to configure Allowlist and Denylist via the control panel

1. Log in to your Bright Data account control panel.
2. Select the zone which you want to modify and go to the **Overview** tab.
3. Under the overview tab, in the \*\*Access Details \*\*section, there is an edit icon to edit the lists.
4. Click the edit icon.

<img alt="editAllowlist.png" />

5. This will get you to the configuration tab, under security settings, to edit the lists:

<img alt="whitelist-blacklist.png" />

Add all the relevant IPs and domains you'll allow access to with your proxy zone.

### How to configure Allowlist and Denylist via Bright Data Account management APIs

The following APIs will enable you to control and manage your allowlist and denylist:

* [Add IP to Zone allowlist](/api-reference/account-management-api/allowlist-ip)
* [Remove IP from Zone allowlist](/api-reference/account-management-api/remove-ip-from-zone-allowlist)
* [Add IP to Zone denylist](/api-reference/account-management-api/denylist-ip)
* [Remove IP from Zone denylist](/api-reference/account-management-api/remove-ip-from-zone-denylist)
* [Remove domain from Zone allowlist/denylist](/api-reference/account-management-api/remove-domain-from-zone-allowlist-or-denylist)
* [Add domain to Zone allowlist/denylist](/api-reference/account-management-api/allowlist-or-denylist-domains)

## What are the best practices of allowlist and denylist definition?

*
* Accurate allowlist prevents abuse of your Bright Data proxies, protects your operations and funds. See more info within [this video.](https://brightdata.com/static/video/howto/blacklist_system_explanation.mp4?md5=153602994-22bce32a\&hver=2)
* There is **no limit** on how many IPs/domains you can add to the allowlist and we also support ranges of IPs.
* When you work from a public cloud, where your scrapers spawn on different IPs, the allowlist will need to constantly change and adjust to incoming requests origin IP. To prevent constant changes, we recommend that your setup a permanent outgoing IP for your cloud operations which interact with Bright Data. Consult you cloud provided on available solutions. Common solution is NAT gateway setup for outgoing communication.
* For easier management and control, we recommend to use wildcards and patterns to define domains or IP ranges in your list.

### Which wildcards and patterns do we support for allowlist and denylist configuration?

We support the following patterns for domain names and IPs/subnets/masks:

| Pattern             | Description                                                                                                              | Example                                                               |
| ------------------- | ------------------------------------------------------------------------------------------------------------------------ | --------------------------------------------------------------------- |
| `*`  (asterix)      | Mathced all strings                                                                                                      | \*  - Will match all IPs/domains                                      |
| `*`  (asterix)      | Embedded in string, will match all substrings (prefix)                                                                   | `*.mycompany.net` will match all domains ending with `.mycompany.net` |
| `*`  (asterix)      | Embedded in string, will match all substrings (suffix)                                                                   | `sub.mycompany.*` will match all suffixes (like net, com, us etc.)    |
| `a.b.c.d`           | a,b,c,d are all numbers between 0-255, this pattern represents a single IP address                                       | `195.55.35.112`                                                       |
| `a.b.c.0/24`        | This patterns represents a whole /24 subnet, which means all IP addresses with the a.b.c prefix and 0-255 as 'd' number. | `195.55.35.0/24 `                                                     |
| `a.b.c.d - x.y.z.w` | Range of IPs between a.b.c.d and x.y.z.w                                                                                 | `10.20.30.40-10.20.30.50`                                             |
| `a.b.c.d/x.y.z.w`   | Netmask: A netmask separates the IP address into network and host parts. Similar to the use of subnets.                  | `10.20.30.40/255.255.252.0`                                           |


# Bright Data network security
Source: https://docs.brightdata.com/general/security/network-security

How Bright Data secures its virtual ISP network across 4 layers: registration requirements, DDoS prevention, domain denylisting and traffic monitoring.

Most of the traffic that goes through both a regular ISP and a virtual ISP is encrypted with an SSL tunnel so its content is not visible to the ISP. Due to this the methods to secure the network and prevent illegal activities available to ISPs are limited and are mostly targeted at large scale DDoS prevention and domain denylists. However at Bright Data we do a lot more:

| Element                                                                                             | Bright Data Virtual ISP         | Regular ISP |
| --------------------------------------------------------------------------------------------------- | ------------------------------- | ----------- |
| Requires registration                                                                               | Yes                             | Yes         |
| Requires payment method                                                                             | Yes                             | Yes         |
| Methods and procedures for reporting abuse                                                          | Yes                             | Yes         |
| Online DDoS detection                                                                               | Yes                             | Yes         |
| Full block of the most popular DDoS methods <sup>[2](#myfootnote2)</sup>                            | Yes                             | No          |
| KYC procedure per customer                                                                          | Yes                             | No          |
| Compliance alert if customer starts targeting domains not reported during KYC                       | Yes                             | No          |
| Deploy active blocks for Ad frauds, fake reviews, fake likes, fake account creations, spamming, etc | Yes<sup>[1](#myfootnote1)</sup> | No          |
| Block service level abuse or attack with non web traffic <sup>[3](#myfootnote3)</sup>               | Yes                             | No          |

***

> **Bottom line**\
> Bright Data virtual ISP network is much safer and less likely to be used for attacks and abuse than a regular ISP.

<Warning>
  Bright Data does not allow using its products and systems to render any network resource unavailable to its intended users, including, without limitation, via Denial-of-Service (**DoS**) or Distributed Denial-of-Service (**DDoS**) attack
</Warning>

***

<sub><a name="myfootnote1">1</a>: Applied to 30% of the traffic and planned to reach > 90% by end of 2022</sub><br />
<sub><a name="myfootnote2">2</a>: Methods that were used in the top 90% of DDoS attacks of 2021: UDP fragmentation, DNS reflection, UDP volumetric, LDAP reflection, DNS query, NTP reflection, ICMP (volumetric),</sub><br />
<sub><a name="myfootnote3">3</a>: Non web traffic is any traffic that is not HTTP protocol or targeting ports different from the standard HTTP ports of `80/443`.</sub>


# Security & compliance
Source: https://docs.brightdata.com/general/security/security-overview

Bright Data security and compliance: ISO 27001, SOC 2, regular penetration testing and encryption, covering MCP server, Browser API and all Bright Data APIs.

<Note>
  All three ISO certifications are explicitly scoped to *"a public web data collection platform designed for high-scale collection, automation, and AI agent / RAG systems for web data access."* This directly covers use of Bright Data's MCP Server, Browser API, and all APIs in agentic workflows.
</Note>

## Certifications at a Glance

<CardGroup>
  <Card title="ISO/IEC 27001:2022" icon="certificate">
    Information Security Management System (ISMS)
    **Valid until:** Aug 11, 2028
    **No.** 1126059 - SII–QCD (ANAB Accredited)
  </Card>

  <Card title="ISO/IEC 27017:2015" icon="cloud">
    Cloud Security Controls
    **Valid until:** Jul 13, 2028
    **No.** 1125290 - SII–QCD
  </Card>

  <Card title="ISO/IEC 27018:2019" icon="user-shield">
    Protection of PII in Public Clouds
    **Valid until:** Jul 13, 2028
    **No.** 1125291 - SII–QCD
  </Card>

  <Card title="SOC 2 Type II" icon="file-shield">
    Available under NDA
    **Period:** Jun 1, 2024 – May 31, 2025
    Audited by Deloitte Global Network
  </Card>

  <Card title="SOC 3" icon="file-check">
    Publicly downloadable
    **Period:** Jun 1, 2024 – May 31, 2025
    Audited by Brightman Almagor Zohar & Co.
  </Card>

  <Card title="CSA STAR" icon="star">
    Cloud Security Alliance Registry
    [View listing →](https://cloudsecurityalliance.org/star/registry/bright-data/)
  </Card>
</CardGroup>

***

## How independent audits work

### SOC 3 Report - Deloitte

Conducted by **Brightman Almagor Zohar & Co., a firm in the Deloitte Global Network**, covering **June 1, 2024 – May 31, 2025**.

The audit examined controls across four trust service criteria:

<CardGroup>
  <Card title="Security" icon="lock">
    Protection against unauthorized access to systems and data
  </Card>

  <Card title="Availability" icon="signal">
    Uptime commitments and disaster recovery readiness
  </Card>

  <Card title="Confidentiality" icon="eye-slash">
    Data classification, encryption, and access controls
  </Card>

  <Card title="Privacy" icon="user-lock">
    GDPR/CCPA compliance and PII handling procedures
  </Card>
</CardGroup>

> *"In our opinion, management's assertion that the controls within the Service Organization's system were effective... to provide reasonable assurance that Bright Data's service commitments and system requirements were achieved based on the applicable trust services criteria is fairly stated, in all material respects."*
>
> * Brightman Almagor Zohar & Co. (Deloitte Global Network)

<Card title="Download SOC 3 Report (PDF)" icon="download" href="https://brightdata.com/static/Bright_Data_SOC_3_June_1_2024_May_31_2025_Updated.pdf">
  Full SOC 3 report covering June 1, 2024 – May 31, 2025
</Card>

***

### Penetration Test - Skylight Cyber Security

An independent penetration test and source code review was conducted by **Skylight Cyber Security Pty Ltd** (May–June 2025), covering the full Bright Data product surface.

**Products tested:**

| Product                                          | Coverage |
| ------------------------------------------------ | -------- |
| Control Panel & Public APIs                      | Full     |
| Datacenter, Residential, Mobile, and ISP Proxies | Full     |
| SERP API and Web Unlocker API                    | Full     |
| Web Scraper IDE, Marketplace, and API            | Full     |
| Web Archive API                                  | Full     |
| Dataset Marketplace and Custom Dataset API       | Full     |

**Three threat scenarios were in scope:**

1. Unauthenticated attacker attempting to compromise the entire platform
2. Malicious administrator attempting internal compromise
3. Unauthorized account access or proxy misuse

<Info>
  **Result:** All Critical and High severity findings were remediated. Skylight re-tested to confirm the findings were addressed and the risk was mitigated.
</Info>

<Card title="Download Penetration Test Attestation" icon="file-shield" href="https://brightdata.com/trustcenter">
  Attestation letter from Skylight Cyber Security Pty Ltd
</Card>

***

## How data encryption works

| Layer                | Standard                                           |
| -------------------- | -------------------------------------------------- |
| **Data in transit**  | TLS 1.3 (minimum TLS 1.2) with modern cipher suite |
| **Data at rest**     | AES-256 or better across all infrastructure        |
| **Credentials**      | Hashed and salted using a modern hash function     |
| **Database backups** | Encrypted; daily full backups, monthly snapshots   |
| **Backup storage**   | AWS Backup; snapshots distributed across locations |

***

## Infrastructure & Availability

<CardGroup>
  <Card title="Cloud Provider" icon="aws">
    Amazon Web Services (AWS), multi-Availability Zone deployment
  </Card>

  <Card title="Disaster Recovery" icon="rotate">
    DR site on AWS EU; annual large-scale DR drills; RCA for all high-severity incidents
  </Card>

  <Card title="Backup Frequency" icon="database">
    Full database backup every 5 minutes; daily AWS snapshots; critical backups on Microsoft Azure
  </Card>

  <Card title="DDoS & Monitoring" icon="shield">
    Active DDoS mitigation and rate limiting; continuous firewall monitoring by dedicated InfoSec team
  </Card>
</CardGroup>

***

## Access Control & Identity

| Control                     | Implementation                                                   |
| --------------------------- | ---------------------------------------------------------------- |
| **Least privilege**         | All IAM roles scoped to minimum required permissions             |
| **MFA**                     | Required for all AWS platform access by employees                |
| **Customer authentication** | Strong password (min. 8 chars) + email verification              |
| **RBAC**                    | Role-Based Access Control with regular user access reviews       |
| **Third-party access**      | Re-authorized annually; requires signed NDA and InfoSec approval |
| **Remote access**           | VPN with encryption required; host-check enforced                |

***

## Application & Development Security

* **CI/CD pipeline** - Controlled pipeline with end-to-end and unit testing, including authorization testing
* **Secure SDLC** - Based on the OWASP Top 10 framework; security requirements defined before development begins; annual developer security training
* **Change management** - Formal review and approval process for all infrastructure and application changes, including security risk evaluation at R\&D review stage
* **Third-party risk (TPRM)** - All vendors mapped and classified by risk tier; high-risk suppliers require security questionnaire and InfoSec sign-off before contract
* **Bug bounty** - Managed private program for responsible disclosure by independent security researchers

***

## Privacy & Regulatory Compliance

| Regulation / Standard                 | Status                                                 |
| ------------------------------------- | ------------------------------------------------------ |
| GDPR (EU)                             | ✅ Compliant - DPIAs conducted as part of product flows |
| CCPA (California)                     | ✅ Compliant                                            |
| UK Data Protection Act                | ✅ Compliant                                            |
| Virginia Privacy Law                  | ✅ Compliant                                            |
| Israeli Privacy Protection Law (1981) | ✅ Compliant                                            |
| ISO 27001:2022                        | ✅ Certified                                            |
| CSA STAR                              | ✅ Listed                                               |
| PCI DSS                               | ✅ Working compliance                                   |

* **Privacy policy** reviewed and updated annually - [brightdata.com/privacy](https://brightdata.com/privacy)
* **Customer data deletion** available at any time upon request
* **Data selling** - Bright Data does not sell or license customer data to any third party

***

## Information Security Policy

Bright Data maintains a formal, board-approved Information Security Policy aligned with **NIST, ISO 27001:2022, ISO 27017, and ISO 27018**.

<AccordionGroup>
  <Accordion title="Identity & Access Management">
    IAM policies enforcing least-privilege access across all systems, with regular audits and annual reviews.
  </Accordion>

  <Accordion title="Network & Encryption">
    Network segmentation, TLS 1.3 in transit, AES-256 at rest, and modern cipher suites throughout.
  </Accordion>

  <Accordion title="Endpoint & Server Hardening">
    CIS Benchmarks applied to all endpoints and servers.
  </Accordion>

  <Accordion title="Secure SDLC">
    Security requirements defined before development begins; OWASP Top 10 framework; annual developer training.
  </Accordion>

  <Accordion title="Third-Party & Vendor Security">
    All vendors classified by risk tier; high-risk suppliers require security questionnaire and InfoSec sign-off.
  </Accordion>

  <Accordion title="Data Classification">
    Three-tier classification: Sensitive, PII, and Public - with controls applied per tier.
  </Accordion>

  <Accordion title="Incident Response & Business Continuity">
    Incident reporting, RCA for high-severity events, annual DR drills, and a formal BCP.
  </Accordion>
</AccordionGroup>

***

## Security for AI Agents & MCP Users

Bright Data's MCP Server and Browser API operate under the same certified security infrastructure described on this page.

<Warning>
  Always treat scraped web content as **untrusted input**. Validate and filter data before passing it to an LLM prompt to mitigate prompt injection risks.
</Warning>

**Recommended practices when using Bright Data in agentic workflows:**

<Steps>
  <Step title="Treat web content as untrusted">
    Validate and filter web data before passing it to an LLM prompt - this mitigates prompt injection attacks.
  </Step>

  <Step title="Use structured extraction tools">
    Prefer `web_data_*` tools where available - they return pre-validated, schema-consistent data.
  </Step>

  <Step title="Store credentials securely">
    Store API keys as environment variables. Never hardcode credentials in agent code or prompts.
  </Step>

  <Step title="Scope API key permissions">
    Use API key permission scoping (five levels available) to enforce least-privilege access from your agent.
  </Step>
</Steps>

***

## Certifications & Reports

<CardGroup>
  <Card title="ISO 27001 + 27017 + 27018 Certificates" icon="certificate" href="https://brightdata.com/static/ISO-270012022_ISO-27017_ISO-27018.pdf">
    All three ISO certificates in a single PDF
  </Card>

  <Card title="SOC 3 Report" icon="file-check" href="https://brightdata.com/static/Bright_Data_SOC_3_June_1_2024_May_31_2025_Updated.pdf">
    Public SOC 3 - Jun 1, 2024 – May 31, 2025
  </Card>

  <Card title="SOC 2 Type II Report" icon="file-shield" href="mailto:security@brightdata.com">
    Available under NDA upon request
  </Card>

  <Card title="Trust Center" icon="shield-check" href="https://brightdata.com/trustcenter">
    Penetration test attestation and live trust documentation
  </Card>

  <Card title="Privacy Policy" icon="user-shield" href="https://brightdata.com/privacy">
    Updated annually; GDPR & CCPA aligned
  </Card>

  <Card title="Security Vulnerability Reward Program" icon="bug" href="https://brightdata.com/security-vulnerabilities-reward-program">
    Responsible disclosure program for security researchers
  </Card>
</CardGroup>

***

## Frequently Asked Questions

<AccordionGroup>
  <Accordion title="Is Bright Data ISO 27001 certified?">
    Yes. Bright Data holds **ISO/IEC 27001:2022, ISO 27017, and ISO 27018** certifications, valid until August 11–13, 2028, issued by SII–QCD (ANAB Accredited, IAF & IQNET member).
  </Accordion>

  <Accordion title="Does Bright Data have a SOC 2 report?">
    Yes. Bright Data has a **SOC 2 Type II** report available under NDA, and a publicly downloadable **SOC 3** report audited by the Deloitte firm (Brightman Almagor Zohar & Co.).
  </Accordion>

  <Accordion title="Is Bright Data GDPR compliant?">
    Yes. Bright Data has undergone a comprehensive GDPR and CCPA compliance program, conducts Data Privacy Impact Assessments (DPIAs) as part of all product flows, and maintains a publicly available privacy policy updated annually.
  </Accordion>

  <Accordion title="Does Bright Data do penetration testing?">
    Yes. Annual penetration tests and source code reviews are performed by independent third-party security firms. The most recent test (Skylight Cyber Security, May–June 2025) left no Critical or High severity findings unresolved.
  </Accordion>

  <Accordion title="Is Bright Data's infrastructure encrypted?">
    Yes. All data is encrypted in transit (**TLS 1.3**) and at rest (**AES-256**). Database backups are encrypted and distributed across multiple cloud locations.
  </Accordion>

  <Accordion title="Is Bright Data safe for enterprise deployments?">
    Yes. Bright Data is trusted by Fortune 500 companies, academic institutions, and 15,000+ organizations worldwide. Its security posture is independently validated through ISO 27001/27017/27018 certification and an annual Deloitte SOC 2 Type II audit.
  </Accordion>

  <Accordion title="Is Bright Data's MCP Server covered by these certifications?">
    Yes. All ISO certifications are explicitly scoped to include AI agent and RAG system use cases for web data access, which covers the MCP Server, Browser API, and related products.
  </Accordion>
</AccordionGroup>

***

*For security inquiries: [security@brightdata.com](mailto:security@brightdata.com)*
*For enterprise compliance reviews: [Contact sales](https://brightdata.com/contact)*


# Event log
Source: https://docs.brightdata.com/general/usage-monitoring/Event_log

How to read the Bright Data event log in the Zones dashboard to monitor recent proxy requests, IP usage, and zone activity at a glance.

For a quick overview of your usage, go to the event sign in your Zones page:

<Frame>
  <img alt="event-log-1.png" />
</Frame>

The event log will show you one line of data for the first request made with each unique IP in the past hour.

The presented data is:

* **Date:** Time and date of the request
* **Zone:** What Zone was used for the request
* **Source IP:** What IP the request was made from
* **URL:** The target site of the request
* **Result:** Success or Fail of the request

<Frame>
  <img alt="event-log-2.png" />
</Frame>


# Monitor your usage
Source: https://docs.brightdata.com/general/usage-monitoring/Monitoring_Residential_Network_Usage

How to monitor your Bright Data residential proxy bandwidth consumption in real time using the Statistics view in the Control Panel.

To review your current bandwidth consumption, simply browse to your [residential zone](https://brightdata.com/cp/zones), click on ‘Statistics’ in the top menu, in the ‘Metrics’ section, open the drop-down menu, and change the metric to ‘GB’.

<Frame>
  <img alt="monitor-your-usage.gif" />
</Frame>

## How Traffic Is Measured

Your usage of the residential proxy network is calculated via **bandwidth** consumption. Bandwidth is the amount of information that is sent over a connection and is being downloaded. Each request you send with your proxy consumes a certain amount of bandwidth. Your billing is calculated via \$ per # of bandwidth used.

See our [Billing & Pricing](/general/account/billing-and-pricing) page to learn more.


# Usage
Source: https://docs.brightdata.com/general/usage-monitoring/Usage

Manage and control Bright Data account usage across 4 zones, including disabling zones to pause billing and understanding pre-commit plan behavior.

<AccordionGroup>
  <Accordion title="How can I disable zones to control my account usage and balance?">
    You can easily disable any of your active zones if you want to stop using it for a while. Our billing system will not charge for days when your zones are disabled but rather only charge for the relative time they were active and for monthly precommit if applicable. You can activate them back at any given moment from your control panel.

    * Disabling all zones will also stop the pre-commit charges. However, as long as you have at least one active zone pre-commit plan will be applied and charged for.
    * Disabling Data center zones or residential zones with dedicated IPs will release all IPs to the pool

    <Note>
      If zone or a zone feature (e.g: city or country) was enabled and disabled on the same day, the charge calculation for the day will be as if it was enabled calculated according to the list price when traffic was consumed.
    </Note>
  </Accordion>

  <Accordion title="What happens when my usage goes beyond my minimum account commitment?">
    When you have used 85% of your account balance during a given month, you will receive an email requesting that you add funds to your account. If you do not add funds to your account, your account will continue to operate until you have used 100% of your account balance. Once you have reached usage amounting to 100% of your account balance, your account will be suspended unless additional funds are added. We recommend to turn on the "auto recharge" to keep your account active and working.
  </Accordion>

  <Accordion title="Will my funds roll over to the next month?">
    If your account remains in “active” status for the entire month, your monthly commitment will not roll over to the next month, regardless of whether your usage charges fell below the minimum commitment.\
    While in 'active' status, your usage and billing calculations start over fresh on the first day of each month according to your price plan and monthly commitment.
  </Accordion>

  <Accordion title="What is the limit for free zones?">
    Bright Data customers can open up to 50 zones free of charge, any additional zone will cost \$5/month.
  </Accordion>

  <Accordion title="Can I limit my daily usage?">
    Yes, in the [Zone](https://brightdata.com/cp/zones) page under the "Usage spent limit" column it is possible to limit your daily usage in 2 ways:

    * Bandwidth(bytes)
    * Money spent(Dollars)

    When you reach your daily limit, the zone is suspended, alerted, or both, depending on your configuration.

    <Note>
      The Zone limit is calculated every 15 minutes and will not take effect immediately so a Zone might go over it's limit by 15 minutes of usage.
    </Note>

    <img alt="usage-monitor.gif" />

    <Note>
      When the load is high statistics calculation may have a delay. In order to manually update the usage-statistics in your Zone, open the Zone by clicking on its name, go to the Statistics table, and press the `recalc` button near the desired date. Wait until the red "Loading..." notification at the top of the screen will disappear, and refresh the page. The stats will then be up-to-date.
    </Note>
  </Accordion>
</AccordionGroup>


# Bandwidth
Source: https://docs.brightdata.com/general/usage-monitoring/bandwidth

How Bright Data calculates bandwidth usage, including request and response headers, POST data, and how trial traffic is tracked and billed.

<AccordionGroup>
  <Accordion title="How is Bandwidth calculated?">
    The bandwidth is calculated according to the sum of data transmitted to and from the target site: request headers + request data (POST) + response headers+response data.\\

    <Note>
      The traffic used during your trial will be listed on your dashboard but will not be counted towards your bill.
    </Note>
  </Accordion>

  <Accordion title="How to get bandwith stats for a Zone">
    API endpoint: `GET /api/zone/bw`

    Optional parameters: `from=2018-07-01T00:00:00&to=2018-07-02T00:00:00`

    <CodeGroup>
      ```sh Shell theme={null}
      curl "https://api.brightdata.com/zone/bw?zone=ZONE" -H "Authorization: Bearer API_KEY"
      ```

      ```js Node.js theme={null}
      #!/usr/bin/env node

      (async () => {
        const response = await fetch('https://api.brightdata.com/zone/bw?zone=ZONE', {
          headers: { 'Authorization': 'Bearer API_KEY' },
        });
        console.log(await response.text());
      })();
      ```

      ```java Java theme={null}
      package example;

      import org.apache.http.HttpHost;
      import org.apache.http.client.fluent.\*;

      public class Example {
        public static void main(String[] args) throws Exception {
          String res = Executor.newInstance()
            .addHeader("Authorization", "Bearer API_KEY")
            .execute(Request.Get("https://api.brightdata.com/zone/bw?zone=ZONE"))
            .returnContent().asString();
          System.out.println(res)
        }
      }
      ```

      ```cs C# theme={null}
      using System;
      using System.Net;
      using System.Net.Http;
      using System.Net.Http.Headers;

      public class Program {
        public static async Task Main() {
          var client = new HttpClient();
          var requestMessage = new HttpRequestMessage {
            Method = HttpMethod.Get,
              RequestUri = new Uri("https://api.brightdata.com/zone/bw?zone=ZONE"),
              Headers = {
                {
                  "Authorization",
                  "Bearer API_KEY"
                }
              }
          };
          var response = await client.SendAsync(requestMessage);
          var responseString = await response.Content.ReadAsStringAsync();
          Console.WriteLine(responseString);
        }
      }
      ```

      ```python Python theme={null}
      #!/usr/bin/env python
      print(
          'If you get error "ImportError: No module named requests",',
          'please install it:\n$ sudo pip install requests'
      )
      import requests

      headers = {'Authorization': 'Bearer API_KEY'}

      r = requests.get(
          'https://api.brightdata.com/zone/bw?zone=ZONE',
          headers=headers
      )

      print(r.content)
      ```
    </CodeGroup>

    ```json Sample Response theme={null}
    {
      "ID:": {
        "customer_id": "customer_id",
        "from": "2022-10-01T00:00:00.000Z",
        "to": "2022-11-23T00:00:00.000Z",
        "data": {
          "static": {
            "bw_sum": [
                0, 745, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 
                0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 6960, 0, 0, 0,
                0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0
            ],
            "bw_dn": [
                0, 525, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0,
                0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 5990, 0, 0, 0,
                0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0
            ],
            "bw_up": [
                0, 220, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0,
                0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 970, 0, 0, 0,
                0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0
            ],
            "http_direct_req": [
                0, 1, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0,
                0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0,
                0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0
            ],
            "bw_sum_dc": [
                0, 745, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0,
                0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 6960, 0, 0, 0,
                0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0
            ],
            "bw_api": [
                0, 745, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0,
                0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 6960, 0, 0, 0,
                0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0
            ],
            "https_direct_req": [
                0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0,
                0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 1, 0, 0, 0, 0, 0,
                0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0
            ]
          }
        },
        "last_value_ts": "2022-11-19T19:1* Connection #0 to host brightdata.com left intact 8:51.546Z",
        "last_update_ts": "2022-11-22T11:35:32.122Z",
        "sums": {
          "static": {
            "back_m1": {
              "bw_sum": 745,
              "bw_dn": 525,
              "bw_up": 220,
              "http_direct_req": 1,
              "bw_sum_dc": 745,
              "bw_api": 745,
              "https_direct_req": 0
            },
            "back_m0": {
              "bw_sum": 6960,
              "bw_dn": 5990,
              "bw_up": 970,
              "http_direct_req": 0,
              "bw_sum_dc": 6960,
              "bw_api": 6960,
              "https_direct_req": 1
            },
            "back_d2": {
              "bw_sum": 0,
              "bw_dn": 0,
              "bw_up": 0,
              "http_direct_req": 0,
              "bw_sum_dc": 0,
              "bw_api": 0,
              "https_direct_req": 0
            },
            "back_d1": {
              "bw_sum": 0,
              "bw_dn": 0,
              "bw_up": 0,
              "http_direct_req": 0,
              "bw_sum_dc": 0,
              "bw_api": 0,
              "https_direct_req": 0
            },
            "back_d0": {
              "bw_sum": 0,
              "bw_dn": 0,
              "bw_up": 0,
              "http_direct_req": 0,
              "bw_sum_dc": 0,
              "bw_api": 0,
              "https_direct_req": 0
            }
          }
        }
      }
    }
    ```
  </Accordion>

  <Accordion title="How to get bandwith stats for all the Zones">
    API endpoint: `GET /api/customer/bw`

    Optional parameters: `from=2018-07-01T00:00:00&to=2018-07-02T00:00:00`

    <CodeGroup>
      ```sh Shell theme={null}
      curl "https://api.brightdata.com/customer/bw" -H "Authorization: Bearer API_KEY"
      ```

      ```js Node.js theme={null}
      #!/usr/bin/env node

      (async () => {
        const response = await fetch('https://api.brightdata.com/customer/bw', {
          headers: { 'Authorization': 'Bearer API_KEY' },
        });
        console.log(await response.text());
      })();
      ```

      ```java Java theme={null}
      package example;
      import org.apache.http.HttpHost;
      import org.apache.http.client.fluent.\*;
      public class Example {
       public static void main(String[] args) throws Exception {
       String res = Executor.newInstance()
       .addHeader("Authorization", "Bearer API_KEY")  
       .execute(Request.Get("https://api.brightdata.com/customer/bw"))  
       .returnContent().asString();
       System.out.println(res)
       }  
      }
      ```

      ```cs C# theme={null}
      using System;
      using System.Net;
      using System.Net.Http;
      using System.Net.Http.Headers;
      public class Program {
       public static async Task Main() {
       var client = new HttpClient();
       var requestMessage = new HttpRequestMessage {
       Method = HttpMethod.Get,  
       RequestUri = new Uri("https://api.brightdata.com/customer/bw"),
       Headers = {
       {"Authorization", "Bearer API_KEY"}
       }
       };
       var response = await client.SendAsync(requestMessage);
       var responseString = await response.Content.ReadAsStringAsync();
       Console.WriteLine(responseString);
       }
      }
      ```

      ```python Python theme={null}
      #!/usr/bin/env python
      print('If you get error "ImportError: No module named requests", please install it:\n$ sudo pip install requests');
      import requests
      headers = {'Authorization': 'Bearer API_KEY'}
      r = requests.get('https://api.brightdata.com/customer/bw', headers=headers)
      print(r.content)
      ```
    </CodeGroup>
  </Accordion>

  <Accordion title="How to get bandwidth and total cost for a Zone">
    API endpoint: `GET /api/zone/cost`

    Optional parameters: `from=2018-07-01T00:00:00&to=2018-07-02T00:00:00`

    <CodeGroup>
      ```sh Shell theme={null}
      curl "https://api.brightdata.com/zone/cost?zone=ZONE" -H "Authorization: Bearer API_KEY"
      ```

      ```js Node.js theme={null}
      #!/usr/bin/env node

      (async () => {
        const response = await fetch('https://api.brightdata.com/zone/cost?zone=ZONE', {
          headers: { 'Authorization': 'Bearer API_KEY' },
        });
        console.log(await response.text());
      })();
      ```

      ```java Java theme={null}
      package example;
      import org.apache.http.HttpHost;
      import org.apache.http.client.fluent.\*;
      public class Example {
       public static void main(String[] args) throws Exception {
       String res = Executor.newInstance()
       .addHeader("Authorization", "Bearer API_KEY")  
       .execute(Request.Get("https://api.brightdata.com/zone/cost?zone=ZONE"))  
       .returnContent().asString();
       System.out.println(res)
       }  
      }
      ```

      ```cs C# theme={null}
      using System;
      using System.Net;
      using System.Net.Http;
      using System.Net.Http.Headers;
      public class Program {
       public static async Task Main() {
       var client = new HttpClient();
       var requestMessage = new HttpRequestMessage {
       Method = HttpMethod.Get,  
       RequestUri = new Uri("https://api.brightdata.com/zone/cost?zone=ZONE"),
       Headers = {
       {"Authorization", "Bearer API_KEY"}
       }
       };
       var response = await client.SendAsync(requestMessage);
       var responseString = await response.Content.ReadAsStringAsync();
       Console.WriteLine(responseString);
       }
      }
      ```

      ```python Python theme={null}
      #!/usr/bin/env python
      print('If you get error "ImportError: No module named requests", please install it:\n$ sudo pip install requests');
      import requests
      headers = {'Authorization': 'Bearer API_KEY'}
      r = requests.get('https://api.brightdata.com/zone/cost?zone=ZONE', headers=headers)
      print(r.content)
      ```
    </CodeGroup>

    ```JSON Sample Response theme={null}
    Example response:  
    {
      "ID": {
        "back_m2": {
          "bw": 0,
          "cost": 0
        },
        "back_m1": {
          "bw": 36557298,
          "cost": 0
        },
        "back_m0": {
          "bw": 1219004,
          "cost": 0
        },
        "back_d2": {
          "bw": 82190,
          "cost": 0
        },
        "back_d1": {
          "bw": 0,
          "cost": 0
        },
        "back_d0": {
          "bw": 0,
          "cost": 0
        }
      }
    }
    ```
  </Accordion>
</AccordionGroup>


# Unlimited DC & ISP zones: fair use
Source: https://docs.brightdata.com/general/usage-monitoring/fair_use_allowance

Fair use allowance limits for Bright Data Datacenter and ISP unlimited proxies. Effective 1 September 2025 with thresholds and enforcement rules listed.

<Note>
  **Fair use policy updated on 1-Sep-2025**
</Note>

## How fair use applies

Bright Data's fair use policy for unlimited zones includes a monthly allowance of 100GB per proxy (IP). The fair use allowance is the same for both shared and dedicated proxies.

### How fair use is calculated and what is its scope?

Fair use for unlimited proxies is calculated on the zone type level.

It means that all datacenter proxies are sharing their fair use, and all ISP proxies are sharing their fair use. The fair use is calculated monthly, based on the calendar date, from 1st of the month to its last day.

#### How do we calculate fair use?

We sum up all the unlimited proxies of the same zone type, and multiply by 100GB.

So if for example you have 10 proxies in zone `datacenter_zone1` and 5 proxies in `datacenter_zone2` your overall fair use will be 1,500 GB for datecenter fair use.

### Is fair use multiplier different for Datacenter and ISP?

No. Fair use is 100GB (one hundred giga bytes) per proxy (IP), datacenter or ISP.

#### Can one zones unused fair use can be accounted another zone?

Yes. You can load proxies in `zone a` and the fair use will be seen in `zone b`. However we do not recommend doing so ; as traffic will spread on less IPs which may cause performance degredation.

#### If I use shared proxies, do others' usage count towards my fair use?

Absolutely not. Only your traffic is counted towards your fair use.

#### What happens when I exceed my fair use?

We send email alerts when you reach 85% of your fair use and 100% of your fair use. We do not stop your operations, and you will be charged for the data over the fair use allowance with our current "Pay as you go" rate. We consider those charges, exceeding fair use, as "overcharges" and they are marked as such in your billing details.

#### When does the fair use recharge?

Each unlimited zone recharges with fair on the first on the calendar month.

#### How do I avoid overcharges?

In order to avoid overcharge:

1. Plan in advance your usage and purchase enough proxies to cover the fair use.
2. Track your usage and top-up your zone with additional proxies when needed to remain under the fair use.
3. Define zone limit which halts the zone on reaching some usage limit.

Bright Data offers affordable plans for unlimited proxies, we recommend having some additional allowance margins for unpredicted surges in bandwidth consumption, and avoid overcharges.

#### I already incurred overcharges, can I top-up (add proxies) my zones with proxies to reverse it?

Our fair use policy does not allow dismissal or reversal of overcharges once applied. If from some reason you think the overcharge was applied wrongfully, please contact our support and we will gladly assist.

#### I reduced the number of proxies in my zones, how does this impact my fair use allowance?

Every proxy you remove, will immediately reduce your fair use allowance by 100GB. Currently, we do not allow reductions, which will have your account charged with overcharge due to fair use allowance breach.

If you attempt to do that, our control panel will show an Error:

<Warning>
  `Error: Cannot reduce number of proxies below fair use.`
</Warning>

#### Does Bright Data offer unlimited residential proxies?

No.


# SERP fair usage: rate limit
Source: https://docs.brightdata.com/general/usage-monitoring/serp-rate-limit

Bright Data SERP API fair usage policy: global 100 QPS rate limit applied from January 2026, HTTP 429 behavior, and how to request an increase.

Starting January 2026, Bright Data is applying a rate limit to its SERP services.

The global rate limit is set to 100 QPS (requests per second) for funded accounts. Unfunded accounts are subject to a rate limit of 1,000 req/min.

You can view the specific rate limit currently applied to your zone in the Control Panel, under the zone's Overview tab > Access details.

Upon breaching this rate limit, an HTTP error 429 will be returned. If you wish to extend this rate limit, add funds to your account or contact your sales agent.


# Webhook notifications
Source: https://docs.brightdata.com/general/webhook_notifications

Reference for every webhook notification event sent by Bright Data across 4 products, including event codes, categories and payload structure.

<table>
  <thead>
    <tr>
      <th>Category</th>
      <th>Subject</th>
      <th>Product</th>
      <th>Body</th>
      <th>Event code</th>
    </tr>
  </thead>

  <tbody>
    <tr>
      <td>Billing</td>
      <td>Account suspension due to insufficient funds</td>
      <td>N/A</td>
      <td>Your Bright Data account was suspended due to insufficient funds.</td>
      <td>1000 - Insufficient funds</td>
    </tr>

    <tr>
      <td>Billing</td>
      <td>Low balance</td>
      <td>N/A</td>
      <td>Your account balance is \$X and nearing its limit. Please recharge your account to avoid account suspension.</td>
      <td>1001 - Low balance</td>
    </tr>

    <tr>
      <td>Billing</td>
      <td>Auto recharge failed</td>
      <td>N/A</td>
      <td>Your payment method was declined and we were unable to add funds to your account using Auto-recharge. Please try again or use a different payment method.</td>
      <td>1002 - Auto recharge failed</td>
    </tr>

    <tr>
      <td>Compliance</td>
      <td>Account disabled due to TOS violation</td>
      <td>N/A</td>
      <td>We detected that your account has violated our TOS (Terms of Service). Please contact our Compliance team for more information: [compliance@brightdata.com](mailto:compliance@brightdata.com)</td>
      <td>2000 - Account disabled</td>
    </tr>

    <tr>
      <td>Compliance</td>
      <td>Account suspension due to validation fail</td>
      <td>N/A</td>
      <td>Your account has been suspended because it could not be validated. Contact your account manager for more information email.</td>
      <td>2001 - Account suspension due to validation fail</td>
    </tr>

    <tr>
      <td>Compliance</td>
      <td>New denylisted IPs</td>
      <td>N/A</td>
      <td>We have detected requests from suspicious IP addresses that are running through your zones. We have added these IPs to your Denylist.</td>
      <td>2002 - Denylisted IPs</td>
    </tr>

    <tr>
      <td>Network Health</td>
      <td>Web Unlocker API service disruption started</td>
      <td>Web Unlocker API</td>
      <td>Web Unlocker API is currently performing at a lower success rate for your targeted domains.</td>
      <td>4000 - Web Unlocker API service disruption start</td>
    </tr>

    <tr>
      <td>Network Health</td>
      <td>Web Unlocker API service disruption ended</td>
      <td>Web Unlocker API</td>
      <td>We have resolved the issue and Web Unlocker API is now showing high performance for your target domains.</td>
      <td>4001 - Web Unlocker API service disruption end</td>
    </tr>

    <tr>
      <td>Network Health</td>
      <td>Service disruption started</td>
      <td>Network</td>
      <td>Our network network is down. We are working on a fix and we will let you know as soon as it is up again.</td>
      <td>4002 - Outage start</td>
    </tr>

    <tr>
      <td>Network Health</td>
      <td>Service disruption ended</td>
      <td>Network</td>
      <td>We have fixed the issue and the insert network network is back up.</td>
      <td>4003 - Outage end</td>
    </tr>

    <tr>
      <td>Maintenance</td>
      <td>Scheduled IP replacement</td>
      <td>DC/ISP</td>
      <td>We are scheduling a change in the range of IPs in our DC and ISP networks on insert date and time add link to affected list (same as in email)</td>
      <td>5000 - Future IP replacement</td>
    </tr>

    <tr>
      <td>Maintenance</td>
      <td>IP replacement completed</td>
      <td>DC/ISP</td>
      <td>IP replacement was completed. add link to affected list (same as in email)</td>
      <td>5001 - IP replacement completed</td>
    </tr>

    <tr>
      <td>Maintenance</td>
      <td>Gips were released</td>
      <td>Residential/Mobile</td>
      <td>The following gips were released from your zone add link to affected list</td>
      <td>5004 - gips released</td>
    </tr>

    <tr>
      <td>Maintenance</td>
      <td>Gips were replaced</td>
      <td>Residential/Mobile</td>
      <td>The following gips were released from your zone and replaced with new ones add link to affected list</td>
      <td>5005 - gips were changed</td>
    </tr>

    <tr>
      <td>Maintenance</td>
      <td>Planned maintenance</td>
      <td>Any</td>
      <td>We are performing maintenance on XYZ that is scheduled for insert date and time.</td>
      <td>5002 - Future maintenance</td>
    </tr>

    <tr>
      <td>Maintenance</td>
      <td>Maintenance completed</td>
      <td>Any</td>
      <td>The maintenance on XYZ was completed.</td>
      <td>5003 - Maintenance completed</td>
    </tr>

    <tr>
      <td>TEST</td>
      <td>Test notification</td>
      <td>N/A</td>
      <td>This notification was sent from your control panel in order to test your webhook URL. If you can see this message it means it is working as expected</td>
      <td>9000 - Test notification</td>
    </tr>
  </tbody>
</table>


# Webmaster console
Source: https://docs.brightdata.com/general/webmaster-console

Configure BrightBot crawl behavior for your domains with a collectors.txt file in the Bright Data Webmaster Console. Allow IP range 82.97.199.0/24 for access.

## General

<Info>
  To enable BrightBot to function with your domain, make sure your firewall allows requests from the range **82.97.199.0/24** and the **Brightbot 1.0** User-Agent.

  *Note: If your firewall blocks BrightBot requests to allowed URLs, Bright Data temporarily suspends sending the BrightBot User-Agent to your domain for 7 days.*
</Info>

<Warning>
  **Network support:** Currently, the BrightBot User-Agent and `collectors.txt` rules are only applied to traffic routed through the **Web Unlocker**. Browser API and browser-based Data Collector jobs are not currently supported.
</Warning>

| Inputs                           | Description                                                                                                                                                                                                                      | Format                  |
| -------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------- |
| **Personal Information** (`pii`) | Endpoints containing information related to an identified or identifiable natural person. BrightBot will actively block collection from these endpoints.                                                                         | `URL / Document Object` |
| **Disallow** (`disallow`)        | List interactive endpoint patterns such as ad links, likes, reviews and posts. This instruction enables BrightBot to block these endpoints, aligning with Bright Data guidelines that prohibit data collection from these areas. | `URL / Document Object` |
| **Copyright** (`copyright`)      | Endpoints containing copyrighted materials. BrightBot will actively block collection from these endpoints.                                                                                                                       | `URL / Document Object` |
| **Private** (`private`)          | Internal or private endpoints. BrightBot will actively block collection from these endpoints.                                                                                                                                    | `URL / Document Object` |

## Examples

<CodeGroup>
  ```txt collectors.txt theme={null}
  // Optional, describe domain name
  service: example.com

  // Endpoints containing information related to an identified or identifiable natural person.
  pii: /personal_info_1
  pii: /personal_info_2

  // List interactive endpoint patterns such as ad links, likes, reviews and posts.
  disallow: /disallow_1
  disallow: /disallow_2

  // Endpoints containing copyrighted materials.
  copyright: /copyright_1
  copyright: /copyright_2

  // Wildcards (*) and end-of-string ($) characters function exactly like regular expressions across all directives.
  private: /*secret
  private: /private_2
  private: /private_3/*/private$
  ```
</CodeGroup>


# How do I scrape site XYZ?
Source: https://docs.brightdata.com/general/websites

Tips and tricks for getting information from specific websites across 4 categories of targets using Bright Data proxies and Scraper APIs.

<AccordionGroup>
  <Accordion title="How do I scrape Public Web Data from LinkedIn?">
    When it comes to gathering public web data from LinkedIn, you have two straightforward options to choose from. Both methods are effective, depending on your specific needs and resources.

    **Option 1: Ready-Made Datasets**

    The first option is to utilize ready-made datasets available on the Datasets Marketplace. You can access the Datasets Marketplace by going to "Web Data" from the sidebar, then selecting "Datasets Market" from the top menu.

    These datasets are pre-compiled collections of LinkedIn data, such as user profiles or company information. This option is ideal for those who want to save time and effort, as you can simply download the data you need without having to scrape it yourself. It’s a great solution for businesses or researchers looking for quick access to large volumes of data with minimal technical overhead.

    **Option 2: Use the Web Scraping API**

    This option lets you easily scrape LinkedIn in real-time via API. You can instantly scrape the information you need by going [here](https://brightdata.com/cp/scrapers/browse?domain=linkedin.com)

    Information is readily available for LinkedIn people profiles, company information etc.

    **Option 3: Web Unlocker API or Browser API**

    The third option is to actively scrape the data using either the Web Unlocker API or the Browser API to gather LinkedIn data on your own. This approach allows for more flexibility and customization. With Web Unlocker API or Browser API, you can target specific data points and update your data in real-time. This method is perfect for users who need tailored datasets that aren’t available in pre-made form or require fresh, up-to-date information.

    All methods have their own advantages. Ready-made datasets provide convenience and efficiency, while web scraping tools offer control and customization. Choose the one that best fits your needs, and get started with accessing LinkedIn data today!
  </Accordion>

  <Accordion title="How do I scrape Public Web Data from Instagram?">
    When it comes to gathering public web data from Instagram, you have two straightforward options to choose from. Both methods are effective, depending on your specific needs and resources.

    **Option 1: Ready-Made Datasets**

    The first option is to utilize ready-made datasets available on the Datasets Marketplace. You can access the Datasets Marketplace by going to "Web Data" from the sidebar, then selecting "Datasets Market" from the top menu.

    These datasets are pre-compiled collections of Instagram data, such as public profiles, posts, or engagement metrics. This option is perfect for those who want quick access to large volumes of data without the hassle of scraping it themselves. It’s a convenient solution for businesses, marketers, or researchers who need immediate access to data for analysis, trend spotting, or audience research.

    **Option 2: Use the Web Scraping API**

    This option lets you easily scrape Instagram in real-time via API. You can instantly scrape the information you need by going [here](https://brightdata.com/cp/scrapers/browse?domain=instagram.com)

    Information is readily available for Instagram people profiles, posts and more.

    **Option 3: Web Unlocker API or Browser API**

    The second option is to actively scrape the data using either the Web Unlocker API or the Browser API to collect Instagram data on your own. This approach offers more flexibility and control, allowing you to target specific data points, such as hashtags, user interactions, or recent posts. With Web Unlocker API or Browser API, you can customize your data collection to fit your exact needs and keep your datasets updated in real-time.

    Each of the methods has its own benefits. Ready-made datasets provide a quick and easy way to get started, while web scraping tools offer greater customization and up-to-date data. Choose the approach that best suits your goals, and start accessing Instagram data today!
  </Accordion>

  <Accordion title="How do I scrape Public Web Data from Google?">
    When it comes to gathering public web data from Google, there is a straightforward and powerful option available to you - the **SERP API**

    The most effective way to collect data from Google is by using the SERP API. The SERP API (Search Engine Results Page API) allows you to retrieve search engine results directly from Google without having to scrape the site manually. This option is particularly useful for anyone needing access to Google's search data, such as rankings, snippets, images, maps, and other search features.

    You can read more about SERP API and the customisation options in the [SERP API documentation](/scraping-automation/serp-api/introduction).

    Using the SERP API offers several advantages. Firstly, it simplifies the process of collecting search data, allowing you to focus on analyzing results rather than dealing with the technicalities of web scraping. Additionally, it provides a reliable way to access fresh, real-time search data, ensuring that the information you receive is up-to-date and accurate.

    The SERP API is also highly customizable, letting you specify parameters such as keywords, location, language, and device type. This flexibility makes it a powerful tool for marketers, SEO specialists, and researchers who need specific insights into Google's search results.

    While using the SERP API requires some setup and understanding of API requests, it's a more streamlined and reliable method than traditional web scraping, which can be challenging due to Google's frequent updates and anti-scraping measures.

    If you're looking to gather Google search data efficiently and effectively, the SERP API is the way to go. Start exploring its capabilities today to unlock valuable insights from Google search results!
  </Accordion>

  <Accordion title="How do I scrape Public Web Data from Shopee?">
    When it comes to gathering public web data from Shopee, you have 2 options:

    1. Use the [Web Unlocker API](/scraping-automation/web-unlocker/introduction)

    2. Buy a Dataset from the [Datasets marketplace](https://brightdata.com/cp/datasets/browse/gd_lk122xxgf86xf97py).

    ### Using the Web Unlocker API

    The most effective way to collect real-time data from Shopee is by using the Web Unlocker API - but note the data collection can often be slow due to specific restrictions on this domain.

    Note: In many cases, real time data is not needed! You may be able to get what you need from the data sets. See below.

    You can read more about Web Unlocker API and the customisation options in the [Web Unlocker API documentation](/scraping-automation/web-unlocker/introduction).

    ### Using a ready-made dataset

    Bright Data maintains a dataset of Shopee product description and prices.

    By definition, the dataset contains historical information, however it is important to note that **it is constantly being updated**.

    You can easily select the timeframe when featuring the data so you only receive information that was collected recently (e.g. in the last 24 hours.)

    You can instantly download the relevant parts of the data sets by going to the [Shopee Dataset](https://brightdata.com/cp/datasets/browse/gd_lk122xxgf86xf97py).
  </Accordion>

  <Accordion title="How do I scrape Public Web Data from Zillow?">
    When it comes to gathering public web data from Zillow, you have three options to choose from. Both methods are effective, depending on your specific needs and resources.

    **Option 1: Ready-Made Datasets**

    The first option is to utilize ready-made datasets available on the Datasets Marketplace. You can instantly download the relevant parts of the data sets by going to the [Real Estate Datasets](https://brightdata.com/cp/datasets/browse?category=real_estate)

    These datasets are pre-compiled collections of Zillow data, such as public profiles, property sale and rental prices etc. This option is perfect for those who want quick access to large volumes of data without the hassle of scraping it themselves. It is a convenient solution for businesses, marketers, or researchers who need immediate access to data for analysis, trend spotting, or audience research.

    **Option 2: Use the Web Scraping API**

    This option lets you easily scrape Zillow in real-time via API. You can instantly scrape the information you need by going here

    **Option 3: Web Unlocker API or Browser API**

    The second option is to actively scrape the data using either the Web Unlocker API or the Browser API to collect Zillow data on your own. This approach offers more flexibility and control, allowing you to target specific data points, such as hashtags, user interactions, or recent posts. With Web Unlocker API or Browser API, you can customize your data collection to fit your exact needs and keep your datasets updated in real-time.

    Each methods has its own benefits. Ready-made datasets provide a quick and easy way to get started, while web scraping tools offer greater customization and up-to-date data. Choose the approach that best suits your goals, and start accessing Zillow data today!
  </Accordion>

  <Accordion title="How do I scrape Public Web Data from HomeDepot?">
    When it comes to gathering public web data from HomeDepot, you have three options to choose from. Both methods are effective, depending on your specific needs and resources.

    **Option 1: Ready-Made Datasets**

    The first option is to utilize ready-made datasets available on the Datasets Marketplace. You can instantly download the relevant parts of the data sets by going [here](https://brightdata.com/cp/datasets/browse?search=homedepot)

    These datasets are pre-compiled collections of HomeDepot data. Information is ready available for HomeDepot Canada and United States.

    **Option 2: Use the Web Scraping API**

    This option lets you easily scrape HomeDepot in real-time via API. You can instantly scrape the information you need by going [here](https://brightdata.com/cp/scrapers/browse?domain=homedepot.com)

    Information is ready available for HomeDepot Canada and United States.

    **Option 3: Web Unlocker API or Browser API**

    The second option is to actively scrape the data using either the Web Unlocker API or the Browser API to collect HomeDepot data on your own. This approach offers more flexibility and control, allowing you to target specific data points, such as hashtags, user interactions, or recent posts. With Web Unlocker API or Browser API, you can customize your data collection to fit your exact needs and keep your datasets updated in real-time.

    Each methods has its own benefits. Ready-made datasets provide a quick and easy way to get started, while web scraping tools offer greater customization and up-to-date data. Choose the approach that best suits your goals, and start accessing HomeDepot data today!
  </Accordion>

  <Accordion title="How do I scrape Public Web Data from Amazon?">
    When it comes to gathering public web data from Amazon, you have three options to choose from. All methods are effective, depending on your specific needs and resources.

    **Option 1: Ready-Made Datasets**

    The first option is to utilize ready-made datasets available on the Datasets Marketplace. You can instantly download the relevant parts of the data sets by going [here](https://brightdata.com/cp/datasets/browse?search=amazon)

    These datasets are pre-compiled collections of Amazon data, which are periodically updated in order to keep them up to date. Information is readily available for Amazon domains from Canada, Germany, United States and all other amazon country stores.

    **Option 2: Use the Web Scraping API**

    This option lets you easily scrape Amazon in real-time via API. You can instantly scrape the information you need by going [here](https://brightdata.com/cp/scrapers/browse?domain=amazon.com)

    Information is readily available for Amazon domains from Canada, Germany, United States and all other amazon country stores.

    **Option 3: Web Unlocker API or Browser API**

    The second option is to actively scrape the data using either the Web Unlocker API or the Browser API to collect Amazon data on your own. This approach offers more flexibility and control, allowing you to target specific data points. With Web Unlocker API or Browser API, you can customize your data collection to fit your exact needs and keep your data  updated in real-time.

    Each methods has its own benefits. Ready-made datasets provide a quick and easy way to get started, while web scraping tools offer greater customization and up-to-date data. Choose the approach that best suits your goals, and start accessing Amazon data today!
  </Accordion>

  <Accordion title="How do I scrape Public Web Data from Facebook?">
    When it comes to gathering public web data from Facebook, you have three options to choose from. All methods are effective, depending on your specific needs and resources.

    **Option 1: Ready-Made Datasets**

    The first option is to utilize ready-made datasets available on the Datasets Marketplace. You can instantly download the relevant parts of the data sets by going [here](https://brightdata.com/cp/datasets/browse?search=facebook)

    These datasets are pre-compiled collections of Facebook data, which are periodically updated in order to keep them up to date. Information is readily available for Facebook domains from Canada, Germany, United States and all other Facebook localities.

    **Option 2: Use the Web Scraping API**

    This option lets you easily scrape Facebook in real-time via API. You can instantly scrape the information you need by going [here](https://brightdata.com/cp/data_api?search=facebook)

    Information is readily available for Facebook domains from Canada, Germany, United States and all other Facebook localities.

    **Option 3: Web Unlocker API or Browser API**

    The second option is to actively scrape the data using either the Web Unlocker API or the Browser API to collect Facebook data on your own. This approach offers more flexibility and control, allowing you to target specific data points. With Web Unlocker API or Browser API, you can customize your data collection to fit your exact needs and keep your data  updated in real-time.

    Each methods has its own benefits. Ready-made datasets provide a quick and easy way to get started, while web scraping tools offer greater customization and up-to-date data. Choose the approach that best suits your goals, and start accessing Facebook data today!
  </Accordion>

  <Accordion title="How do I scrape Public Web Data from Glassdoor?">
    When it comes to gathering public web data from Glassdoor, you have three options to choose from. All methods are effective, depending on your specific needs and resources.

    **Option 1: Ready-Made Datasets**

    The first option is to utilize ready-made datasets available on the Datasets Marketplace. You can instantly download the relevant parts of the data sets by going [here](https://brightdata.com/cp/datasets/browse?search=glassdoor)

    These datasets are pre-compiled collections of Glassdoor data, which are periodically updated in order to keep them up to date. Information is readily available for Glassdoor job listings, reviews and company information.

    **Option 2: Use the Web Scraping API**

    This option lets you easily scrape Glassdoor in real-time via API. You can instantly scrape the information you need by going [here](https://brightdata.com/cp/data_api?search=glassdoor)

    Information is readily available for Glassdoor job listings, reviews and company information.

    **Option 3: Web Unlocker API or Browser API**

    The second option is to actively scrape the data using either the Web Unlocker API or the Browser API to collect Glassdoor data on your own. This approach offers more flexibility and control, allowing you to target specific data points. With Web Unlocker API or Browser API, you can customize your data collection to fit your exact needs and keep your data  updated in real-time.

    Each methods has its own benefits. Ready-made datasets provide a quick and easy way to get started, while web scraping tools offer greater customization and up-to-date data. Choose the approach that best suits your goals, and start accessing Glassdoor data today!
  </Accordion>

  <Accordion title="How do I scrape Public Web Data from Shein?">
    When it comes to gathering public web data from Shein, you have three options to choose from. All methods are effective, depending on your specific needs and resources.

    **Option 1: Ready-Made Datasets**

    The first option is to utilize ready-made datasets available on the Datasets Marketplace. You can instantly download the relevant parts of the data sets by going [here](https://brightdata.com/cp/datasets/browse?search=shein)

    These datasets are pre-compiled collections of Shein data, which are periodically updated in order to keep them up to date. Information is readily available for Shein products.

    **Option 2: Use the Web Scraping API**

    This option lets you easily scrape Shein in real-time via API. You can instantly scrape the information you need by going [here](https://brightdata.com/cp/scrapers/browse?domain=us.shein.com)

    Information is readily available for Shein products and categories.

    **Option 3: Web Unlocker API or Browser API**

    The second option is to actively scrape the data using either the Web Unlocker API or the Browser API to collect Shein data on your own. This approach offers more flexibility and control, allowing you to target specific data points. With Web Unlocker API or Browser API, you can customize your data collection to fit your exact needs and keep your data  updated in real-time.

    Each methods has its own benefits. Ready-made datasets provide a quick and easy way to get started, while web scraping tools offer greater customization and up-to-date data. Choose the approach that best suits your goals, and start accessing Shein data today!
  </Accordion>

  <Accordion title="How do I scrape Public Web Data from G2?">
    When it comes to gathering public web data from G2, you have three options to choose from. All methods are effective, depending on your specific needs and resources.

    **Option 1: Ready-Made Datasets**

    The first option is to utilize ready-made datasets available on the Datasets Marketplace. You can instantly download the relevant parts of the data sets by going [here](https://brightdata.com/cp/datasets/browse?search=g2)

    These datasets are pre-compiled collections of G2 data, which are periodically updated in order to keep them up to date. Information is readily available for G2 product reviews.

    **Option 2: Use the Web Scraping API**

    This option lets you easily scrape G2 in real-time via API. You can instantly scrape the information you need by going [here](https://brightdata.com/cp/scrapers/browse?domain=g2.com)

    Information is readily available for G2 product reviews.

    **Option 3: Web Unlocker API or Browser API**

    The second option is to actively scrape the data using either the Web Unlocker API or the Browser API to collect G2 data on your own. This approach offers more flexibility and control, allowing you to target specific data points. With Web Unlocker API or Browser API, you can customize your data collection to fit your exact needs and keep your data  updated in real-time.

    Each methods has its own benefits. Ready-made datasets provide a quick and easy way to get started, while web scraping tools offer greater customization and up-to-date data. Choose the approach that best suits your goals, and start accessing G2 data today!
  </Accordion>
</AccordionGroup>


# How to set up Bright Data with Agno
Source: https://docs.brightdata.com/integrations/agno

Use Bright Data's MCP toolkit in Agno to give AI agents real-time web access and structured data extraction from 40+ platforms.

<Card title="Building an AI startup?" href="https://brightdata.com/ai/ai-startups-program" icon="rocket-launch">
  You might be eligible for our Startup Program. Get fully funded access to the infrastructure you're reading about right now (up to \$20K value).
</Card>

The Bright Data MCP toolkit is now available in Agno, bringing real-world web access to AI agents. This integration enables structured data extraction and web scraping from over 40 platforms, including Amazon, LinkedIn, TikTok, Instagram, and Facebook.

Agents can perform tasks like scraping product listings, capturing screenshots, running search queries, and accessing live structured data feeds, all with minimal setup. This makes it easy to build intelligent agents that can reason, act, and fetch real-time web data for research, automation, and monitoring.

## How to Integrate Bright Data With LangChain

<Steps>
  <Step title="Pre-requisites">
    * Bright Data API key
    * Active SERP Zone for search engine capabilities
    * Active Web Unlocker API zone for Scraping
  </Step>

  <Step title="Obtain Your Bright Data API Key">
    * Log in to your [Bright Data dashboard](https://brightdata.com/cp).
    * Go to [Account Settings](https://brightdata.com/cp/setting/users).
    * [Generate an API key](/api-reference/authentication#how-do-i-authenticate-with-api-key%3F) if you haven't already done so.
  </Step>

  <Step title="Install the Bright Data Integration">
    You can install the Bright Data integration directly from GitHub using the tool code available [here](https://github.com/agno-agi/agno/blob/main/libs/agno/agno/tools/brightdata.py).

    <Note>
      This integration will be published to **PyPI** by the end of the week. Once available, you’ll be able to install it using:

      ```sh theme={null}
      pip install agno
      ```
    </Note>
  </Step>

  <Step title="Set the environment variable">
    Set your Bright Data API key as an environment variable:

    ```python theme={null}
    import os


    os.environ["BRIGHT_DATA_API_KEY"] = "your-api-key"
    ```
  </Step>

  <Step title="Example usage">
    ```python theme={null}
    from agno.agent import Agent
    from agno.tools.brightdata import BrightDataTools 
    from agno.models.openai import OpenAIChat 
    from dotenv import load_dotenv 

    load_dotenv() 

    agent = Agent(
      tools=[
          BrightDataTools(
            serp_zone="serp",
            web_unlocker_zone="unlocker"
          )
        ],
      show_tool_calls=True,
      model=OpenAIChat(id="gpt-4o-mini"),
    ) 

    agent.print_response("Search for AAPL news", markdown=True)
    ```
  </Step>
</Steps>


# Overview
Source: https://docs.brightdata.com/integrations/ai-integrations

Connect Bright Data (1000+ pre-built scrapers) to AI and ML workflows for RAG pipelines, agent search and structured data collection via the MCP server.

<Card title="Building an AI startup?" href="https://brightdata.com/ai/ai-startups-program" icon="rocket-launch">
  You might be eligible for our Startup Program. Get fully funded access to the infrastructure you're reading about right now (up to \$20K value).
</Card>

## Which AI integrations are supported

<CardGroup>
  <Card title="LangChain" icon="https://mintcdn.com/brightdata/jeaQWxFKde5jgPN8/images/integrations/ai-integrations/langchain.png?fit=max&auto=format&n=jeaQWxFKde5jgPN8&q=85&s=c73d66ffa0b6a9f411e7c369d732ac47" href="/integrations/langchain">
    Connect LLMs with external data and agents using LangChain.
  </Card>

  <Card title="OpenClaw" icon="https://mintcdn.com/brightdata/jeaQWxFKde5jgPN8/images/integrations/ai-integrations/openclaw.png?fit=max&auto=format&n=jeaQWxFKde5jgPN8&q=85&s=504ea1dc94bc5e061df293d0bfdd174a" href="/integrations/openclaw">
    Give your OpenClaw AI agent web search, scraping, browser automation, and 50+ structured data tools.
  </Card>

  <Card title="OpenClaw on Railway" icon="https://mintcdn.com/brightdata/jeaQWxFKde5jgPN8/images/integrations/ai-integrations/openclaw.png?fit=max&auto=format&n=jeaQWxFKde5jgPN8&q=85&s=504ea1dc94bc5e061df293d0bfdd174a" href="/integrations/openclaw-railway">
    Deploy an OpenClaw agent with 66 Bright Data tools on Railway in one click.
  </Card>

  <Card title="Crew AI" icon="https://mintcdn.com/brightdata/jeaQWxFKde5jgPN8/images/integrations/ai-integrations/crew-ai.png?fit=max&auto=format&n=jeaQWxFKde5jgPN8&q=85&s=4bf84f44575e2469cea09fb8d9b70399" href="/integrations/crew-ai">
    Build and scale AI workflows with Crew AI.
  </Card>

  <Card title="Vercel AI SDK" icon="https://assets.vercel.com/image/upload/q_auto/front/favicon/vercel/favicon.ico" href="/integrations/vercel-ai-sdk">
    Build production-ready AI apps with Vercel AI SDK.
  </Card>

  <Card title="Yutori" icon="https://yutori.com/logo-dark.svg" href="/integrations/yutori">
    Browse the web autonomously with Yutori's n1 reasoning model and Bright Data's Scraping Browser
  </Card>

  <Card title="Haystack" icon="https://mintcdn.com/brightdata/jeaQWxFKde5jgPN8/images/integrations/ai-integrations/haystack.jpg?fit=max&auto=format&n=jeaQWxFKde5jgPN8&q=85&s=440249b2f8cef9244e60697eedf0243b" href="/integrations/haystack">
    Enhances your RAG pipelines and AI applications with Haystack.
  </Card>

  <Card title="Mastra" icon="https://mintcdn.com/brightdata/jeaQWxFKde5jgPN8/images/integrations/ai-integrations/mastra.png?fit=max&auto=format&n=jeaQWxFKde5jgPN8&q=85&s=fc987035364e7df036d203618a8f1258" href="/integrations/mastra">
    Build intelligent AI agents with web scraping, search, and data extraction capabilities.
  </Card>

  <Card title="Dify" icon="https://mintcdn.com/brightdata/jeaQWxFKde5jgPN8/images/integrations/ai-integrations/dify.png?fit=max&auto=format&n=jeaQWxFKde5jgPN8&q=85&s=f8d0159f3a7b28da23619aa8184a1dc6" href="/integrations/dify">
    Access real-time web data in Dify with Bright Data
  </Card>

  <Card title="Lindy.ai" icon="https://mintcdn.com/brightdata/jeaQWxFKde5jgPN8/images/integrations/ai-integrations/lindy-ai.webp?fit=max&auto=format&n=jeaQWxFKde5jgPN8&q=85&s=2665cf234bbeccb9f3762ab9759cdf24" href="/integrations/lindy-ai">
    Enhance your AI applications with Lindy.ai's powerful features.
  </Card>

  <Card title="LlamaIndex" icon="https://mintlify.s3.us-west-1.amazonaws.com/brightdata/images/integrations/ai-integrations/llamaindex.png" href="/integrations/llama-index">
    Simplify data retrieval and management for LLMs with LlamaIndex.
  </Card>

  <Card title="make.com" icon="https://mintcdn.com/brightdata/jeaQWxFKde5jgPN8/images/integrations/ai-integrations/make.com.png?fit=max&auto=format&n=jeaQWxFKde5jgPN8&q=85&s=e67579fa07705baa5bf3e807a50b8d73" href="/integrations/make">
    Automate workflows and connect apps with make.com.
  </Card>

  <Card title="n8n" icon="https://mintcdn.com/brightdata/jeaQWxFKde5jgPN8/images/integrations/ai-integrations/n8n.png?fit=max&auto=format&n=jeaQWxFKde5jgPN8&q=85&s=539f7a69b60084c42bd68b869940bdd0" href="/integrations/n8n">
    Create and automate workflows with n8n's powerful features.
  </Card>

  <Card title="Pica" icon="https://mintcdn.com/brightdata/jeaQWxFKde5jgPN8/images/integrations/ai-integrations/picaos.jpeg?fit=max&auto=format&n=jeaQWxFKde5jgPN8&q=85&s=844eb2e91d3ce126c69a589b446aa1a7" href="/integrations/pica">
    Build and scale AI workflows with Pica.
  </Card>

  <Card title="Strands" icon="https://mintcdn.com/brightdata/jeaQWxFKde5jgPN8/images/integrations/ai-integrations/strands.png?fit=max&auto=format&n=jeaQWxFKde5jgPN8&q=85&s=ea1bd38e74438e0b750e4af155a342d5" href="/integrations/strands">
    Orchestrate and manage multi-agent AI workflows with Strands.
  </Card>

  <Card title="xpander.ai" icon="https://mintcdn.com/brightdata/jeaQWxFKde5jgPN8/images/integrations/ai-integrations/xpander-ai.jpeg?fit=max&auto=format&n=jeaQWxFKde5jgPN8&q=85&s=3962687624e26fe3e80ddf3df5281278" href="/integrations/xpander-ai">
    Enhance your AI applications with xpander.ai's powerful features.
  </Card>

  <Card title="Agno" icon="https://mintcdn.com/brightdata/jeaQWxFKde5jgPN8/images/integrations/ai-integrations/agno.png?fit=max&auto=format&n=jeaQWxFKde5jgPN8&q=85&s=7852e6e5c458f92a633fed5f7dcc92fb" href="/integrations/agno">
    Build memory-powered, multimodal AI agents with Agno
  </Card>
</CardGroup>

***

<Card title="MCP Clients" icon="server" href="/ai/mcp-server/integrations">
  <p>Connect to our MCP clients for seamless integration.</p>
</Card>


# How to set up Bright Data on Android
Source: https://docs.brightdata.com/integrations/android

Configure Bright Data proxies on Android for both mobile data (APN) and Wi-Fi networks. Bright Data proxies span 195 countries.

<Accordion title="Expand to get your Bright Data Proxy Access Information">
  ### Your proxy access information

  Bright Data proxies are grouped in "Proxy zones". Each zone holds the configuration for the proxies it holds.

  To get access to the proxy zone:

  1. Login to Bright Data control panel
  2. Select the proxy zone or setup a new one
  3. Click on the new zone name, and select the **Overview** tab.
  4. In the overview tab, under **Access details** you can find the proxy access details, and copy them to clipboard on click.
  5. You will need: Proxy Host, Proxy Port, Proxy Zone username and Proxy Zone password.
  6. Click on the copy icons to copy the text to your clipboard and paste in your tool's proxy configuration.

  ### Access Details Section Example

  <img alt="" />

  ### Residential proxy access

  To access Bright Data's **Residential Proxies** you must be a KYC-verified business account. Complete KYC verification with the Bright Data compliance team; there is no automatic or no-KYC path. Without KYC, use ISP or Datacenter proxies. [Read more...](/proxy-networks/residential/network-access)

  ### Targeting search engines?

  If you target a search engine like google, bing or yandex, you need a special Search Engine Results Page (**SERP**) proxy API. Use Bright Data SERP API to target search engines.
  [Click here to read more about Bright Data SERP proxy API.](/scraping-automation/serp-api/introduction)

  ### Correct setup of proxy test to avoid "PROXY ERROR"

  In many tools you will see a "test proxy" function, which performs a conncectivity test to your proxy, and some add a geolocation test as well, to identify the location of the proxy.
  To correctly test your proxy you should target those search queries to:
  `https://geo.brdtest.com/welcome.txt` .

  Some tools use popular search engines (like google.com) as a default test target. Bright Data will block those requests and you tool will show **proxy error** although your proxy is perfectly fine.

  If your proxy test fails, this is probably the reason. Make sure that your test domain is not a search engine (this is done in the tool configuration, and not controlled by Bright Data).
</Accordion>

Setting up Bright Data on Android allows you to route your device traffic through secure proxy connections. You can configure Bright Data for **mobile data (APN)** or **Wi-Fi networks**, depending on your use case. Follow the instructions below based on your preferred network type.

***

## Prerequisites

Before you begin, ensure you have:

* An active **Bright Data account**
* Your Bright Data **proxy credentials** (host, port, username, password)
* An Android device with permission to edit network settings

***

## Configuring a Proxy for a Mobile Network (APN)

### Step 1. Access Network Settings

Open **Settings**, then navigate to **Network & Internet** (or **Connections**, depending on your device).

### Step 2. Locate APN Settings

Tap **Mobile Networks**, then select **Access Point Names (APNs)**.

<Frame>
  <img alt="Step 2. Locate APN Settings" />

  <img alt="Step 2. Locate APN Settings" />
</Frame>

### Step 3. Edit APN Details

Select your active APN and update the following fields:

<Frame>
  <img alt="Step 3. Edit APN Details" />
</Frame>

* **Proxy**: `brd.superproxy.io`
* **Port**: `44445`
* **Username**: Your Bright Data proxy username
* **Password**: Your Bright Data proxy password

<Frame>
  <img alt="Step 3. Edit APN Details" />
</Frame>

### Step 4. Save and Reconnect

Save the APN settings and toggle **Mobile Data** off and back on to apply the changes.

***

## Configuring a Proxy for a Wi-Fi Network

### Step 1. Access Wi-Fi Settings

Open **Settings** → **Network & Internet (or Connections)** → **Wi-Fi**.

<Frame>
  <img alt="Step 1. Access Wi-Fi Settings" />
</Frame>

### Step 2. Select Your Connected Network

Tap your connected Wi-Fi network and choose **Settings** or **Edit**.

<Frame>
  <img alt="Step 2. Select Your Connected Network" />
</Frame>

### Step 3. Enable Manual Proxy Configuration

Scroll to **Advanced options** and set **Proxy** to **Manual**.

### Step 4. Enter Proxy Details

Provide the following information:

* **Host**: `brd.superproxy.io`
* **Port**: `44445`

Tap **Save** to apply the configuration.

***

## Verify the Proxy Connection

After setup, open a browser on your device and visit:

[http://brdtest.com/myip.json](http://brdtest.com/myip.json)

Confirm that the displayed IP and location match your Bright Data proxy settings.

***

## Best Practices

* Use **ISP or Datacenter proxies** for better stability on mobile devices
* Avoid frequently switching networks when running proxy-dependent tasks
* Keep your Bright Data credentials secure
* Re-verify proxy settings after OS updates

***

## Conclusion

You’ve successfully configured **Bright Data on Android**. Your device traffic is now routed through secure, private proxy connections, ideal for privacy, geo-restricted access, and protected browsing. Enjoy a safer and more flexible mobile experience.


# Automation integrations
Source: https://docs.brightdata.com/integrations/automation-integrations

Use Bright Data proxies and web data APIs with workflow automation platforms including Zapier, n8n, Make and Lindy.ai for hands-off data flows.

<CardGroup>
  <Card title="Zapier" icon="https://mintcdn.com/brightdata/z2V3XghEDR2bikNt/images/integrations/zapier-action-setup.png?fit=max&auto=format&n=z2V3XghEDR2bikNt&q=85&s=77777d21d76a8e12f57c71827ef191de" href="/integrations/zapier">
    Automate workflows and connect apps with Bright Data via Zapier.
  </Card>

  <Card title="n8n" icon="https://mintcdn.com/brightdata/jeaQWxFKde5jgPN8/images/integrations/ai-integrations/n8n.png?fit=max&auto=format&n=jeaQWxFKde5jgPN8&q=85&s=539f7a69b60084c42bd68b869940bdd0" href="/integrations/n8n">
    Build and automate workflows with n8n's self-hosted platform.
  </Card>

  <Card title="make.com" icon="https://mintcdn.com/brightdata/jeaQWxFKde5jgPN8/images/integrations/ai-integrations/make.com.png?fit=max&auto=format&n=jeaQWxFKde5jgPN8&q=85&s=e67579fa07705baa5bf3e807a50b8d73" href="/integrations/make">
    Automate multi-step workflows with make.com (formerly Integromat).
  </Card>

  <Card title="Boomi" icon="https://mintcdn.com/brightdata/jeaQWxFKde5jgPN8/images/integrations/boomi.svg?fit=max&auto=format&n=jeaQWxFKde5jgPN8&q=85&s=05953b059444de9c39479cf2704fee84" href="/integrations/boomi">
    Connect Bright Data's scraping and data APIs to Boomi integration processes.
  </Card>

  <Card title="PhantomBuster" icon="https://mintcdn.com/brightdata/pq7wn7mJJj8UJsym/images/integrations/phantombuster1.png?fit=max&auto=format&n=pq7wn7mJJj8UJsym&q=85&s=1ceec79a02eb4fffc56d1e1410080ce7" href="/integrations/phantombuster">
    Automate LinkedIn, Instagram, and other social media data collection.
  </Card>

  <Card title="TexAu" icon="https://mintcdn.com/brightdata/z2V3XghEDR2bikNt/images/integrations/texau1.png?fit=max&auto=format&n=z2V3XghEDR2bikNt&q=85&s=dfbc4d053fd6b063b4b6d28f79d6aa2e" href="/integrations/texau">
    Automate web scraping and data enrichment workflows with TexAu.
  </Card>

  <Card title="Apify" icon="https://mintcdn.com/brightdata/jeaQWxFKde5jgPN8/images/integrations/apify1.png?fit=max&auto=format&n=jeaQWxFKde5jgPN8&q=85&s=774ba65eaa91546ec3627a5ff2df33a4" href="/integrations/apify">
    Run Apify actors using Bright Data proxies for reliable scraping.
  </Card>

  <Card title="SaleFreaks" icon="https://mintcdn.com/brightdata/jeaQWxFKde5jgPN8/images/integrations/SaleFreaks-4.png?fit=max&auto=format&n=jeaQWxFKde5jgPN8&q=85&s=d2210679975d1ffac389094e248ad654" href="/integrations/salefreaks">
    Power SaleFreaks dropshipping automation with Bright Data proxies.
  </Card>

  <Card title="Easync" icon="bolt" href="/integrations/easync">
    Automate e-commerce pricing and product data collection with Easync.
  </Card>

  <Card title="Capsolver" icon="https://mintcdn.com/brightdata/jeaQWxFKde5jgPN8/images/integrations/capsolver1.png?fit=max&auto=format&n=jeaQWxFKde5jgPN8&q=85&s=317c5dca43c093a2de663051aa21ff06" href="/integrations/capsolver">
    Solve CAPTCHAs automatically in your automation workflows.
  </Card>

  <Card title="OpenBullet" icon="https://mintcdn.com/brightdata/pq7wn7mJJj8UJsym/images/integrations/openbullet1.png?fit=max&auto=format&n=pq7wn7mJJj8UJsym&q=85&s=b5bd17e20685e2fb3f19c42f770a8e24" href="/integrations/openbullet">
    Configure Bright Data proxies in OpenBullet for credential testing.
  </Card>

  <Card title="Playwright" icon="code" href="/integrations/playwright">
    Use Bright Data proxies with Playwright browser automation scripts.
  </Card>

  <Card title="Puppeteer" icon="code" href="/integrations/puppeteer">
    Use Bright Data proxies with Puppeteer headless browser scripts.
  </Card>

  <Card title="Selenium" icon="code" href="/integrations/selenium">
    Use Bright Data proxies with Selenium WebDriver automation.
  </Card>

  <Card title="StablerSOLO" icon="https://mintcdn.com/brightdata/z2V3XghEDR2bikNt/images/integrations/stabler1.png?fit=max&auto=format&n=z2V3XghEDR2bikNt&q=85&s=79de6aba5243c73c596ee2636206cdab" href="/integrations/stablersolo">
    Configure proxies in StablerSOLO for sneaker and retail automation.
  </Card>

  <Card title="Nginx" icon="server" href="/integrations/nginx">
    Route traffic through Bright Data proxies using Nginx as a forward proxy.
  </Card>
</CardGroup>


# How to set up Bright Data with Boomi
Source: https://docs.brightdata.com/integrations/boomi

Learn how to connect Bright Data's scraping and data collection APIs to a Boomi process using the Bright Data Partner connector. Spans 195 countries.

The [Bright Data Partner connector](https://help.boomi.com/searchResults?q=bright%20data) lets you retrieve data from Bright Data's scraping and data collection APIs directly within a Boomi process. You can integrate with the SERP, Dataset, Scraper, and Web Unlocker APIs to build end-to-end public web data workflows without leaving the Boomi platform.

<Note>
  The Bright Data Partner connector is developed and maintained by Bright Data. Customer support is handled through the Boomi Support Portal, where tickets are triaged to Bright Data.
</Note>

## Which object types are supported

The connector supports the following object types, each accessed via the Execute action:

| Object   | Description                                                        |
| -------- | ------------------------------------------------------------------ |
| Dataset  | Access marketplace datasets with filtering and snapshot retrieval  |
| Scraper  | Submit web scraping jobs and retrieve results asynchronously       |
| Unlocker | Access protected web content via proxy and unblocking services     |
| SERP     | Retrieve search engine results pages from Google, Bing, and others |

## Prerequisites

Before you begin, ensure you have:

* A valid Bright Data account
* An API key generated from the [Bright Data Control Panel](https://brightdata.com/cp/setting/users) with permissions for the services you intend to use

## Connect your Bright Data account

<Steps>
  <Step title="Open the Connection configuration">
    In your Boomi process, add a new **Bright Data Partner connector** component and navigate to the **Connection** tab.
  </Step>

  <Step title="Set the Base URL">
    Enter the Bright Data API base URL:

    ```http theme={null}
    https://api.brightdata.com
    ```

    Customize this value only if you need to point to a different endpoint, such as for testing or regional deployments.
  </Step>

  <Step title="Enter your API key">
    Paste your Bright Data API key into the **API Token** field (Boomi's connector UI labels it this way). The connector uses this key for Bearer authentication.
  </Step>

  <Step title="Test the connection">
    Click **Test Connection** to verify your settings. If the test succeeds, save the connection. If it fails, review your Base URL and API key, then test again.
  </Step>
</Steps>

## Configure an operation

Each operation defines how the connector interacts with a specific Bright Data object. Create a separate operation component for each action/object combination your integration requires.

All object types use the **Execute** action.

### Options tab fields

| Field              | Description                                                                                                             |
| ------------------ | ----------------------------------------------------------------------------------------------------------------------- |
| Connector action   | Set to **Execute** for all Bright Data operations                                                                       |
| Object             | Import using the **Import** button. Choose Dataset, Scraper, Unlocker, or SERP                                          |
| Request profile    | A flexible XML/XSD schema that accepts dynamic content structures                                                       |
| Response profile   | A JSON profile returned by the connector                                                                                |
| Tracking direction | Select **Input Documents** or **Output Documents**                                                                      |
| Error behavior     | Enable to handle failed operations in your process rather than only reporting them                                      |
| Request Payload    | Optional document-level override for the request. Accepts JSON, URL query style, or newline-separated `key=value` pairs |

## How each object type behaves

### How the Dataset object works

The connector operates in one of two modes depending on whether a `snapshot_id` is present:

* **Mode A (Filter):** No `snapshot_id` provided. Filters marketplace datasets based on your query parameters.
* **Mode B (Snapshot):** A `snapshot_id` starting with `snap_` is provided. The connector polls every 10 seconds, up to 25 retries, until the snapshot is ready.

```json theme={null}
{
  "dataset_id": "gd_l1viktl72bvl7bjuj0",
  "filter": {
    "name": "name",
    "operator": "=",
    "value": "Kyle Lacy"
  }
}
```

### How the Scraper object works

* **Mode A (Trigger):** No `snapshot_id` provided. Submits a new scraping job and returns a `snapshot_id`.
* **Mode B (Snapshot):** A `snapshot_id` starting with `s_` is provided. The connector polls for completion and downloads results.

```json theme={null}
{
  "dataset_id": "gd_l1viktl72bvl7bjuj0",
  "url": "https://www.linkedin.com/in/kylelacy",
  "discover_by": "profile_url"
}
```

### How the Unlocker object works

Requires a `url` parameter to bypass website restrictions. Supports `method`, `country`, and `body` parameters.

```json theme={null}
{
  "zone": "web_unlocker1",
  "url": "https://geo.brdtest.com/welcome.txt",
  "format": "json",
  "method": "GET",
  "country": "us",
  "data_format": "markdown"
}
```

### How the SERP object works

Requires `engine` and `query` parameters. Supports multiple engines in a single request using a comma-separated list.

```json theme={null}
{
  "zone": "serp_api1",
  "url": "https://www.google.com/search?q=BrightData",
  "format": "json",
  "method": "GET",
  "country": "us",
  "data_format": "markdown"
}
```

<Note>
  The connector returns all data in JSON format. If the underlying API returns non-JSON content such as HTML or CSV, the connector wraps the raw content in a JSON structure for consistent processing in Boomi.
</Note>

## What's in each release

**Version 1.0.0**

Initial release. Supports Dataset, Scraper, Unlocker, and SERP object types via the Execute action.


# How to set up Bright Data with Capsolver
Source: https://docs.brightdata.com/integrations/capsolver

Integrate Bright Data proxies (195 countries) with Capsolver to solve reCAPTCHA, hCaptcha and image CAPTCHAs in automation and scraping workflows.

<Accordion title="Expand to get your Bright Data Proxy Access Information">
  ### Your proxy access information

  Bright Data proxies are grouped in "Proxy zones". Each zone holds the configuration for the proxies it holds.

  To get access to the proxy zone:

  1. Login to Bright Data control panel
  2. Select the proxy zone or setup a new one
  3. Click on the new zone name, and select the **Overview** tab.
  4. In the overview tab, under **Access details** you can find the proxy access details, and copy them to clipboard on click.
  5. You will need: Proxy Host, Proxy Port, Proxy Zone username and Proxy Zone password.
  6. Click on the copy icons to copy the text to your clipboard and paste in your tool's proxy configuration.

  ### Access Details Section Example

  <img alt="" />

  ### Residential proxy access

  To access Bright Data's **Residential Proxies** you must be a KYC-verified business account. Complete KYC verification with the Bright Data compliance team; there is no automatic or no-KYC path. Without KYC, use ISP or Datacenter proxies. [Read more...](/proxy-networks/residential/network-access)

  ### Targeting search engines?

  If you target a search engine like google, bing or yandex, you need a special Search Engine Results Page (**SERP**) proxy API. Use Bright Data SERP API to target search engines.
  [Click here to read more about Bright Data SERP proxy API.](/scraping-automation/serp-api/introduction)

  ### Correct setup of proxy test to avoid "PROXY ERROR"

  In many tools you will see a "test proxy" function, which performs a conncectivity test to your proxy, and some add a geolocation test as well, to identify the location of the proxy.
  To correctly test your proxy you should target those search queries to:
  `https://geo.brdtest.com/welcome.txt` .

  Some tools use popular search engines (like google.com) as a default test target. Bright Data will block those requests and you tool will show **proxy error** although your proxy is perfectly fine.

  If your proxy test fails, this is probably the reason. Make sure that your test domain is not a search engine (this is done in the tool configuration, and not controlled by Bright Data).
</Accordion>

## What is Capsolver?

Capsolver is a CAPTCHA-solving service that automates the process of bypassing common CAPTCHA challenges such as reCAPTCHA, hCaptcha, and image-based CAPTCHAs. It is commonly used in automation, scraping, and testing workflows where uninterrupted access to target websites is required. When combined with Bright Data proxies, Capsolver provides improved anonymity, geo-targeting, and reliability.

***

## Why Use Bright Data With Capsolver?

* **Enhanced Anonymity**: Hide your real IP address while solving CAPTCHAs.
* **Geo-Targeted Access**: Solve CAPTCHAs from specific countries or regions using localized proxies.
* **Improved Stability**: Reduce request failures and service interruptions.
* **Scalable Automation**: Safely handle high-volume CAPTCHA-solving workloads.

***

## How to Integrate Bright Data With Capsolver

### Prerequisites

Before starting, ensure you have:

* An active Capsolver account
* An active Bright Data account
* A configured Bright Data proxy zone (ISP or Data Center recommended)
* Your Bright Data proxy credentials (host, port, username, password)

***

### Step 1. Log In to Capsolver

* Visit the [Capsolver website](https://www.capsolver.com/) and log in to your account.
* Ensure your Capsolver API key and balance are active before proceeding.

***

### Step 2. Open Proxy Configuration

1. Open the **Capsolver Extension** in your browser.
2. Navigate to the **Settings** section.
3. Locate the **Proxy** option and toggle it **On** to enable proxy usage.

<Frame>
  <img alt="Step 2. Open Proxy Configuration" />
</Frame>

***

### Step 3. Add Your Bright Data Proxy Details

Enter your Bright Data proxy credentials in the proxy configuration fields:

* **Host**: `brd.superproxy.io`
* **Port**: `44445`
* **Username**: Your Bright Data username\
  *(Optionally append `-session-<id>` to maintain a consistent IP)*
* **Password**: Your Bright Data password

<Note>
  For geo-targeted proxies, format the username as\
  `your-username-country-XX` (for example, `your-username-country-US`)\
  to route CAPTCHA-solving traffic through a specific country.
</Note>

***

### Step 4. Save and Test the Proxy

* Save the proxy configuration.
* Run a test CAPTCHA task to verify that Capsolver is routing traffic through the Bright Data proxy.
* Confirm successful execution by checking Capsolver logs or task responses.

***

## Best Practices

* Use session-based usernames to maintain IP consistency during CAPTCHA-heavy workflows
* Assign dedicated proxies for sensitive or account-based tasks
* Avoid excessive parallel CAPTCHA requests from the same proxy
* Monitor Capsolver task logs for proxy-related errors
* Rotate sessions periodically for long-running operations

***

## Conclusion

By integrating Bright Data with Capsolver, you can run secure, anonymous, and scalable CAPTCHA-solving workflows. This setup minimizes detection risks, enables geo-specific operations, and ensures reliable performance across automation tasks. With your proxy configuration in place, you’re ready to handle CAPTCHA challenges efficiently and at scale.


# How to integrate Bright Data with CrewAI
Source: https://docs.brightdata.com/integrations/crew-ai

Integrate Bright Data Web Scraper API (1000+ scrapers) and SERP API into CrewAI agents to add live web data, search and unblocking to agentic workflows.

<Card title="Building an AI startup?" href="https://brightdata.com/ai/ai-startups-program" icon="rocket-launch">
  You might be eligible for our Startup Program. Get fully funded access to the infrastructure you're reading about right now (up to \$20K value).
</Card>

A comprehensive suite of CrewAI tools that leverage Bright Data's powerful infrastructure for web scraping, data extraction, and search operations. These tools provide three distinct capabilities:

## How to extract data with BrightDataDatasetTool

Extract structured data from popular data feeds (Amazon, LinkedIn, Instagram, etc.) using pre-built datasets

## How to search with BrightDataSearchTool

Perform web searches across multiple search engines with geo-targeting and device simulation

## How to scrape with BrightDataUnlockerAPITool

Scrape any website content while bypassing bot protection mechanisms

## Steps to Get Started

To effectively use the BrightData Tools, follow these steps:

<Steps>
  <Step title="Obtain Your Bright Data API Key">
    * Log in to your [Bright Data dashboard](https://brightdata.com/cp).
    * Go to [Account Settings](https://brightdata.com/cp/setting/users).
    * [Generate an API key](/api-reference/authentication#how-do-i-authenticate-with-api-key%3F) if you haven't already done so.
  </Step>

  <Step title="Install the Bright Data Integration">
    Install the Bright Data integration package for CrewAI, along with `aiohttp` and `requests` by running the following command:

    ```shell theme={null}
    pip install crewai[tools] aiohttp requests
    ```
  </Step>

  <Step title="Set the environment variable">
    Set your Bright Data API key as an environment variable:

    ```bash theme={null}
    export BRIGHT_DATA_API_KEY="your_api_key_here"
    export BRIGHT_DATA_ZONE="your_zone_here"
    ```
  </Step>

  <Step title="Select your preferred Bright Data tool">
    The Bright Data + CrewAI integration currently supports:

    <CodeGroup>
      ```python DatasetTool theme={null}
      # Dataset Tool - Extract Amazon Product Data
      from crewai_tools import BrightDataDatasetTool

      # Initialize with specific dataset and URL
      tool = BrightDataDatasetTool(
          dataset_type="amazon_product",
          url="https://www.amazon.com/dp/B08QB1QMJ5/"
      )
      result = tool.run()
      ```

      ```python SearchTool theme={null}
      # Search Tool - Perform Web Search
      from crewai_tools import BrightDataSearchTool

      # Initialize with search query
      tool = BrightDataSearchTool(
          query="latest AI trends 2025",
          search_engine="google",
          country="us"
      )
      result = tool.run()
      ```

      ```python UnlockerAPITool theme={null}
      # Web Unlocker API Tool - Scrape Website Content
      from crewai_tools import BrightDataWebUnlockerTool

      # Initialize with target URL
      tool = BrightDataWebUnlockerTool(
          url="https://example.com",
          data_format="markdown"
      )
      result = tool.run()
      ```
    </CodeGroup>
  </Step>
</Steps>

## Conclusion

By integrating BrightData Tools into your CrewAI agents, you gain access to reliable web scraping and data extraction capabilities. These tools handle complex challenges like bot protection, geo-restrictions, and data parsing, allowing you to focus on building your applications rather than managing scraping infrastructure.


# How to set up Bright Data with Dify
Source: https://docs.brightdata.com/integrations/dify

Add Bright Data's web scraping plugin to Dify to extract data from 50+ platforms including Amazon, LinkedIn and Instagram, plus search and markdown.

<Card title="Building an AI startup?" href="https://brightdata.com/ai/ai-startups-program" icon="rocket-launch">
  You might be eligible for our Startup Program. Get fully funded access to the infrastructure you're reading about right now (up to \$20K value).
</Card>

The Bright Data plugin for Dify pulls structured web data, search results and page markdown into your Dify workflows. Install it from the Dify Marketplace, add your Bright Data API key, and drop the scraping tools into any workflow. It covers 50+ platforms including Amazon, LinkedIn, Instagram and YouTube.

<Frame>
  ![Dify workflow using the Bright Data plugin to extract Amazon product data and summarize it with an LLM node](https://github.com/user-attachments/assets/5825d274-d47b-4fed-950f-65e6b7c63e58)
</Frame>

<Note>
  For the latest plugin updates, see the [Bright Data Dify plugin repository](https://github.com/brightdata/brightdata-dify-plugin/blob/main/BrightData/brightdata-dify-plugin/README.md).
</Note>

## Prerequisites

* A [Bright Data account](https://brightdata.com/cp) with an [API key](/api-reference/authentication#api-key)
* A Dify account with access to Dify Studio

## How to add the Bright Data plugin to Dify

<Steps>
  <Step title="Install the plugin">
    Install the Bright Data plugin from the [Dify Marketplace](https://marketplace.dify.ai/plugins/idanvilenski/brightdata).
  </Step>

  <Step title="Get your Bright Data API key">
    * Log in to your [Bright Data dashboard](https://brightdata.com/cp).
    * Go to [Account settings](https://brightdata.com/cp/setting/users).
    * [Generate an API key](/api-reference/authentication#api-key) if you do not have one.
  </Step>

  <Step title="Add a scraping tool to a workflow">
    1. Go to **Dify Studio** and open a **Workflow**.
    2. Add one of the Bright Data tools:
       * **Structured Data Feeds**: extract structured data from 50+ platforms
       * **Scrape As Markdown**: convert any webpage to clean markdown
       * **Search Engine**: get search results from Google, Bing or Yandex
    3. Enter your Bright Data API key when prompted.
    4. Connect an **LLM node** to process or summarize the scraped data.
  </Step>

  <Step title="Run an example workflow">
    The banner image above shows this workflow. To extract Amazon product information and summarize it:

    1. **START**: input a product URL
    2. **Structured Data Feeds**: extract product details
    3. **LLM**: summarize into readable text
    4. **END**: output a clean product summary

    <Note>
      Two tips for reliable workflows:

      * Reference every stage to the output of the previous stage
      * Set a high character limit on input fields (for the URL field, choose the "short paragraph" var option)
    </Note>
  </Step>
</Steps>

## Available tools

The plugin adds three tools to Dify.

### Structured data feeds

Extract structured data from popular platforms:

* **E-commerce**: Amazon, eBay, Walmart, Best Buy, Etsy, Zara
* **Social media**: Instagram, Facebook, TikTok, YouTube, X (Twitter)
* **Professional**: LinkedIn profiles, companies, jobs
* **Business**: Crunchbase, ZoomInfo
* **Maps and reviews**: Google Maps, booking sites
* **News**: news sources and articles

### Scrape as markdown

Convert any webpage into clean, readable markdown for:

* Content analysis
* Documentation extraction
* Article processing

### Search across engines

Get search results from major search engines:

* Google
* Bing
* Yandex and others

## Use cases

* **E-commerce monitoring**: track product prices and availability
* **Lead generation**: extract business information from LinkedIn
* **Content research**: gather articles and news for analysis
* **Market research**: monitor competitor websites and social media
* **SEO analysis**: track search engine results and rankings

## Advanced: use Bright Data MCP

The Dify plugin uses hosted APIs. For advanced workflows, you can also integrate the [Bright Data MCP server](/ai/mcp-server/overview), which exposes the full Bright Data scraping and automation toolset over the Model Context Protocol.

Call MCP tools from Dify using custom HTTP requests or external service nodes to add capabilities like browser automation and real-time scraping.

* [Explore MCP on GitHub](https://github.com/brightdata/brightdata-mcp/tree/main)
* [Try MCP in the Smithery Playground](https://smithery.ai/server/@luminati-io/brightdata-mcp/tools)


# How to set up Bright Data with Easync
Source: https://docs.brightdata.com/integrations/easync

Configure Bright Data proxies (port 44445) in Easync to route automated e-commerce operations through residential, datacenter, ISP or mobile IPs.

<Accordion title="Expand to get your Bright Data Proxy Access Information">
  ### Your proxy access information

  Bright Data proxies are grouped in "Proxy zones". Each zone holds the configuration for the proxies it holds.

  To get access to the proxy zone:

  1. Login to Bright Data control panel
  2. Select the proxy zone or setup a new one
  3. Click on the new zone name, and select the **Overview** tab.
  4. In the overview tab, under **Access details** you can find the proxy access details, and copy them to clipboard on click.
  5. You will need: Proxy Host, Proxy Port, Proxy Zone username and Proxy Zone password.
  6. Click on the copy icons to copy the text to your clipboard and paste in your tool's proxy configuration.

  ### Access Details Section Example

  <img alt="" />

  ### Residential proxy access

  To access Bright Data's **Residential Proxies** you must be a KYC-verified business account. Complete KYC verification with the Bright Data compliance team; there is no automatic or no-KYC path. Without KYC, use ISP or Datacenter proxies. [Read more...](/proxy-networks/residential/network-access)

  ### Targeting search engines?

  If you target a search engine like google, bing or yandex, you need a special Search Engine Results Page (**SERP**) proxy API. Use Bright Data SERP API to target search engines.
  [Click here to read more about Bright Data SERP proxy API.](/scraping-automation/serp-api/introduction)

  ### Correct setup of proxy test to avoid "PROXY ERROR"

  In many tools you will see a "test proxy" function, which performs a conncectivity test to your proxy, and some add a geolocation test as well, to identify the location of the proxy.
  To correctly test your proxy you should target those search queries to:
  `https://geo.brdtest.com/welcome.txt` .

  Some tools use popular search engines (like google.com) as a default test target. Bright Data will block those requests and you tool will show **proxy error** although your proxy is perfectly fine.

  If your proxy test fails, this is probably the reason. Make sure that your test domain is not a search engine (this is done in the tool configuration, and not controlled by Bright Data).
</Accordion>

## What is Easync?

**Easync** is an automation tool built for e-commerce businesses to streamline order fulfillment, inventory synchronization, price tracking, and marketplace operations across multiple platforms. By integrating Bright Data with Easync, you can improve automation reliability, protect your IP reputation, and access geo-specific marketplace data with reduced risk of blocks.

***

## Why Use Bright Data With Easync?

* **IP Anonymity**: Hide your real IP address during automated e-commerce operations
* **Geo-Targeted Access**: Access region-specific marketplaces and suppliers
* **Improved Stability**: Reduce IP bans and connection failures
* **Scalable Automation**: Safely handle high-volume order and inventory workflows

***

## How to Integrate Bright Data With Easync

### Prerequisites

Before starting, ensure you have:

* An active Easync account
* An active Bright Data account
* A configured Bright Data proxy zone (ISP or Data Center recommended)
* Bright Data proxy credentials (username, password)
* Administrator access to your operating system network settings

***

### Step 1. Configure Bright Data on Your Operating System

Easync uses the proxy settings configured at the **operating system level**.\
Follow the setup guide for your OS to configure Bright Data as a system proxy:

* [How to Set Up Bright Data on Windows](/integrations/windows)
* [How to Set Up Bright Data on macOS](/integrations/macos)

Once completed, all supported applications, including Easync, will route traffic through Bright Data automatically.

<Note>
  ISP or Data Center proxies are recommended for e-commerce automation due to their higher stability and lower block rates.
</Note>

***

### Step 2. Log In to Easync

1. Visit the [Easync website](https://easync.io/) and log in to your account.
2. Launch the Easync application or dashboard.
3. No additional proxy configuration is required inside Easync, as it inherits system-level proxy settings.

***

### Step 3. Test the Proxy Integration

After configuring Bright Data at the OS level, verify that Easync is using the proxy:

* Perform a lightweight action in Easync, such as:
  * Fetching product details
  * Syncing inventory
  * Placing a test order
* Confirm the task completes successfully without connectivity issues.

***

### Step 4. Verify and Monitor the Setup

1. Use a browser or visit `http://httpbin.org/ip` to confirm that traffic is routed through a Bright Data IP.
2. Monitor task execution inside Easync to ensure:
   * Orders are processed correctly
   * Inventory updates run smoothly
   * No proxy-related errors occur

***

## Best Practices

* Use **dedicated ISP proxies** for account-based marketplace automation
* Assign separate proxies for different seller accounts
* Avoid running too many concurrent tasks on a single proxy
* Monitor Easync logs for timeout or connection errors
* Rotate sessions periodically for long-running workflows

***

## Conclusion

By integrating Bright Data with Easync at the operating system level, you enable secure, anonymous, and stable e-commerce automation. This setup helps protect your IP reputation, reduces block risks, and ensures reliable performance across order processing, inventory management, and price monitoring workflows, allowing you to scale operations with confidence.


# How to set up Bright Data with Haystack
Source: https://docs.brightdata.com/integrations/haystack

Integrate Bright Data with Haystack to enhance RAG pipelines and AI applications with reliable, scalable web data extraction. Covers 45+ datasets.

<Card title="Building an AI startup?" href="https://brightdata.com/ai/ai-startups-program" icon="rocket-launch">
  You might be eligible for our Startup Program. Get fully funded access to the infrastructure you're reading about right now (up to \$20K value).
</Card>

Integrating Bright Data with Haystack enhances your RAG pipelines and AI applications with reliable, scalable web data extraction for real-world use cases.

The `haystack-brightdata` Python package is the official Haystack integration for Bright Data, including support for:

* **Bright Data Web Scraper** - Extract structured data from 45+ supported websites including Amazon, LinkedIn, Instagram, Facebook, TikTok, YouTube, and more using Bright Data's Dataset API.
* **Bright Data SERP** - Query search engines (Google, Bing, Yahoo) with geo-targeting and language customization for real-time search results.
* **Bright Data Unlocker** - Access geo-restricted and bot-protected websites, bypass CAPTCHAs and anti-bot measures to extract content in multiple formats.

## How to Integrate Bright Data With Haystack

<Steps>
  <Step title="Obtain Your Bright Data API Key">
    * Log in to your [Bright Data dashboard](https://brightdata.com/cp).
    * Go to [Account Settings](https://brightdata.com/cp/setting/users).
    * [Generate an API key](/api-reference/authentication#how-do-i-authenticate-with-api-key%3F) if you haven't already done so.
  </Step>

  <Step title="Install the Bright Data Integration">
    Install the Bright Data integration package for Haystack by running the following command:

    ```bash theme={null}
    pip install haystack-brightdata
    ```
  </Step>

  <Step title="Set the environment variable">
    Set your Bright Data API key as an environment variable:

    ```python theme={null}
    import os
    os.environ["BRIGHT_DATA_API_KEY"] = "your-api-key"
    ```
  </Step>

  <Step title="Select your preferred Bright Data component">
    The Bright Data + Haystack integration currently supports:

    <Tabs>
      <Tab title="BrightDataWebScraper">
        <Tip>
          **API reference**: [Scrapers Documentation](/datasets/scrapers/scrapers-library/overview)
        </Tip>

        Extract structured data from 45+ supported websites, including e-commerce, social media, and business intelligence platforms.

        <CodeGroup>
          ```python Basic Usage theme={null}
          from haystack_brightdata import BrightDataWebScraper
          import os

          # Set your API key
          os.environ["BRIGHT_DATA_API_KEY"] = "your-api-key"

          # Initialize the scraper
          scraper = BrightDataWebScraper()

          # Extract Amazon product data
          result = scraper.run(
              dataset="amazon_product",
              url="https://www.amazon.com/dp/B08N5WRWNW"
          )
          print(result["data"])
          ```

          ```python Advanced Usage - LinkedIn Profile theme={null}
          from haystack_brightdata import BrightDataWebScraper
          import os

          os.environ["BRIGHT_DATA_API_KEY"] = "your-api-key"

          scraper = BrightDataWebScraper()

          # Extract LinkedIn profile data
          result = scraper.run(
              dataset="linkedin_person_profile",
              url="https://www.linkedin.com/in/example-profile/"
          )
          print(result["data"])

          # Extract Instagram profile data
          result = scraper.run(
              dataset="instagram_profiles",
              url="https://www.instagram.com/username/"
          )
          print(result["data"])
          ```

          ```python List Supported Datasets theme={null}
          from haystack_brightdata import BrightDataWebScraper

          # Get all supported datasets
          datasets = BrightDataWebScraper.get_supported_datasets()
          for dataset in datasets:
              print(f"{dataset['id']}: {dataset['description']}")

          # Get info about a specific dataset
          info = BrightDataWebScraper.get_dataset_info("amazon_product")
          print(f"Description: {info['description']}")
          print(f"Required inputs: {info['inputs']}")
          ```
        </CodeGroup>
      </Tab>

      <Tab title="BrightDataSERP">
        <Tip>
          **API reference**: [SERP API Documentation](/scraping-automation/serp-api/introduction)
        </Tip>

        Collect search engine results with geo-targeting and language customization.

        <CodeGroup>
          ```python Basic Usage theme={null}
          from haystack_brightdata import BrightDataSERP
          import os

          # Set your API key
          os.environ["BRIGHT_DATA_API_KEY"] = "your-api-key"

          # Initialize SERP component
          serp = BrightDataSERP(
              default_search_engine="google",
              default_country="us",
              default_language="en"
          )

          # Execute a search query
          result = serp.run(
              query="machine learning tutorials",
              num_results=20,
              search_type="web"
          )
          print(result)
          ```

          ```python Advanced Usage with Geo-targeting theme={null}
          from haystack_brightdata import BrightDataSERP
          import os

          os.environ["BRIGHT_DATA_API_KEY"] = "your-api-key"

          serp = BrightDataSERP()

          # Search from a different country with different language
          result = serp.run(
              query="inteligencia artificial",
              country="es",
              language="es",
              num_results=10
          )
          print(result)
          ```
        </CodeGroup>
      </Tab>

      <Tab title="BrightDataUnlocker">
        <Tip>
          **API reference**: [Web Unlocker Documentation](/scraping-automation/web-unlocker/introduction)
        </Tip>

        Access any public website, even if it's bot-protected or geo-restricted.

        <CodeGroup>
          ```python Basic Usage theme={null}
          from haystack_brightdata import BrightDataUnlocker
          import os

          # Set your API key
          os.environ["BRIGHT_DATA_API_KEY"] = "your-api-key"

          # Initialize Web Unlocker
          unlocker = BrightDataUnlocker(default_output_format="markdown")

          # Access a website and get content as markdown
          result = unlocker.run(
              url="https://example.com/restricted-content",
              output_format="markdown"
          )
          print(result["content"])
          ```

          ```python Advanced Usage with Geo-targeting theme={null}
          from haystack_brightdata import BrightDataUnlocker
          import os

          os.environ["BRIGHT_DATA_API_KEY"] = "your-api-key"

          unlocker = BrightDataUnlocker()

          # Access from a specific country
          result = unlocker.run(
              url="https://example.com",
              country="gb",
              output_format="html"
          )
          print(result)

          # Get a screenshot
          result = unlocker.run(
              url="https://example.com",
              output_format="screenshot"
          )
          # result contains base64-encoded screenshot
          ```
        </CodeGroup>
      </Tab>
    </Tabs>
  </Step>
</Steps>

## RAG Pipeline Examples

### Product Data RAG Pipeline

Build a Retrieval-Augmented Generation (RAG) pipeline using Bright Data to extract product data from Amazon and answer questions about products:

```python theme={null}
import os
from haystack import Pipeline, Document
from haystack.components.builders import ChatPromptBuilder
from haystack.components.generators.chat import OpenAIChatGenerator
from haystack.components.embedders import OpenAIDocumentEmbedder, OpenAITextEmbedder
from haystack.components.retrievers.in_memory import InMemoryEmbeddingRetriever
from haystack.document_stores.in_memory import InMemoryDocumentStore
from haystack.dataclasses import ChatMessage
from haystack_brightdata import BrightDataWebScraper
import json

# Set API keys
os.environ["BRIGHT_DATA_API_KEY"] = "your-brightdata-api-key"
os.environ["OPENAI_API_KEY"] = "your-openai-api-key"

# Initialize components
scraper = BrightDataWebScraper()
document_store = InMemoryDocumentStore()
docs_embedder = OpenAIDocumentEmbedder()
text_embedder = OpenAITextEmbedder()
retriever = InMemoryEmbeddingRetriever(document_store)
generator = OpenAIChatGenerator()

# Scrape product data from multiple Amazon products
product_urls = [
    "https://www.amazon.com/dp/B0DRWBJDLJ",
    "https://www.amazon.com/dp/B08B8M5JGN",
    "https://www.amazon.com/dp/B09WTTWH1R",
]

documents = []
for url in product_urls:
    result = scraper.run(dataset="amazon_product", url=url)

    # Parse the response
    if isinstance(result["data"], str):
        product_data = json.loads(result["data"])
    else:
        product_data = result["data"]

    if not isinstance(product_data, list):
        product_data = [product_data]

    for product in product_data:
        content_parts = [
            f"Product: {product.get('title', 'N/A')}",
            f"Brand: {product.get('brand', 'N/A')}",
            f"Price: ${product.get('final_price', 'N/A')} {product.get('currency', '')}",
            f"Rating: {product.get('rating', 0)}/5",
            f"Reviews Count: {product.get('reviews_count', 0)}",
        ]

        if product.get('description'):
            content_parts.append(f"Description: {product.get('description')}")

        if product.get('features'):
            features_text = '\n  - '.join(product.get('features', []))
            content_parts.append(f"Features:\n  - {features_text}")

        content = '\n'.join(content_parts)

        documents.append(Document(
            content=content,
            meta={
                "url": product.get('url', url),
                "title": product.get('title', ''),
                "price": product.get('final_price', 0),
                "rating": product.get('rating', 0),
            }
        ))

# Embed and store documents
embeddings = docs_embedder.run(documents)
document_store.write_documents(embeddings["documents"])

# Create RAG pipeline with ChatPromptBuilder
messages = [
    ChatMessage.from_system("You are a helpful shopping assistant."),
    ChatMessage.from_user("""
Context:
{% for document in documents %}
    {{ document.content }}
{% endfor %}

Question: {{question}}
""")
]

prompt_builder = ChatPromptBuilder(template=messages)

# Build and connect pipeline
pipe = Pipeline()
pipe.add_component("embedder", text_embedder)
pipe.add_component("retriever", retriever)
pipe.add_component("prompt_builder", prompt_builder)
pipe.add_component("llm", generator)

pipe.connect("embedder.embedding", "retriever.query_embedding")
pipe.connect("retriever", "prompt_builder.documents")
pipe.connect("prompt_builder", "llm")

# Ask questions about the products
question = "Which product has the best rating?"
response = pipe.run({
    "embedder": {"text": question},
    "prompt_builder": {"question": question}
})

print(f"Answer: {response['llm']['replies'][0].text}")
```

### SERP + Web Content RAG Pipeline

Use SERP API to find relevant web pages, then use Web Unlocker to extract content for a RAG pipeline:

```python theme={null}
import os
from haystack import Pipeline, Document
from haystack.components.builders import ChatPromptBuilder
from haystack.components.generators.chat import OpenAIChatGenerator
from haystack.components.embedders import OpenAIDocumentEmbedder, OpenAITextEmbedder
from haystack.components.retrievers.in_memory import InMemoryEmbeddingRetriever
from haystack.document_stores.in_memory import InMemoryDocumentStore
from haystack.dataclasses import ChatMessage
from haystack_brightdata import BrightDataSERP, BrightDataUnlocker
import json

# Set API keys
os.environ["BRIGHT_DATA_API_KEY"] = "your-brightdata-api-key"
os.environ["OPENAI_API_KEY"] = "your-openai-api-key"

# Initialize components
serp = BrightDataSERP()
unlocker = BrightDataUnlocker(default_output_format="markdown", zone="unblocker")
document_store = InMemoryDocumentStore()
docs_embedder = OpenAIDocumentEmbedder()
text_embedder = OpenAITextEmbedder()
retriever = InMemoryEmbeddingRetriever(document_store)
generator = OpenAIChatGenerator(model="gpt-4")

# Search for information
search_query = "best practices for machine learning in production"
search_result = serp.run(query=search_query, num_results=5)
search_data = json.loads(search_result["results"])

# Extract URLs from search results
urls = []
for result in search_data.get("organic", [])[:5]:
    url = result.get("url") or result.get("link")
    if url:
        urls.append(url)

# Fetch content from each URL
documents = []
for url in urls:
    try:
        result = unlocker.run(url=url, output_format="markdown")
        content = result["content"]
        documents.append(Document(
            content=content,
            meta={"url": url}
        ))
    except Exception as e:
        print(f"Failed to fetch {url}: {e}")

# Embed and store documents
embeddings = docs_embedder.run(documents)
document_store.write_documents(embeddings["documents"])

# Create RAG pipeline
messages = [
    ChatMessage.from_system("You are a knowledgeable AI assistant."),
    ChatMessage.from_user("""
Context from web sources:
{% for document in documents %}
    Source: {{ document.meta.url }}
    {{ document.content }}
{% endfor %}

Question: {{question}}
""")
]

prompt_builder = ChatPromptBuilder(template=messages)

pipe = Pipeline()
pipe.add_component("embedder", text_embedder)
pipe.add_component("retriever", retriever)
pipe.add_component("prompt_builder", prompt_builder)
pipe.add_component("llm", generator)

pipe.connect("embedder.embedding", "retriever.query_embedding")
pipe.connect("retriever", "prompt_builder.documents")
pipe.connect("prompt_builder", "llm")

# Ask questions
question = "What are the main challenges of deploying ML models in production?"
response = pipe.run({
    "embedder": {"text": question},
    "prompt_builder": {"question": question}
})

print(f"Answer: {response['llm']['replies'][0].text}")
```

## Which datasets are supported

The `BrightDataWebScraper` component supports 45+ datasets across multiple categories:

| Category                  | Datasets                                                                                                                                                                                     |
| ------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **E-commerce**            | amazon\_product, amazon\_product\_reviews, amazon\_product\_search, walmart\_product, walmart\_seller, ebay\_product, homedepot\_products, zara\_products, etsy\_products, bestbuy\_products |
| **LinkedIn**              | linkedin\_person\_profile, linkedin\_company\_profile, linkedin\_job\_listings, linkedin\_posts, linkedin\_people\_search                                                                    |
| **Instagram**             | instagram\_profiles, instagram\_posts, instagram\_reels, instagram\_comments                                                                                                                 |
| **Facebook**              | facebook\_posts, facebook\_marketplace\_listings, facebook\_company\_reviews, facebook\_events                                                                                               |
| **TikTok**                | tiktok\_profiles, tiktok\_posts, tiktok\_shop, tiktok\_comments                                                                                                                              |
| **YouTube**               | youtube\_profiles, youtube\_videos, youtube\_comments                                                                                                                                        |
| **Search & Commerce**     | google\_maps\_reviews, google\_shopping, google\_play\_store, apple\_app\_store, zillow\_properties\_listing, booking\_hotel\_listings                                                       |
| **Business Intelligence** | crunchbase\_company, zoominfo\_company\_profile                                                                                                                                              |
| **Other**                 | github\_repository\_file, yahoo\_finance\_business, x\_posts, reddit\_posts                                                                                                                  |

<Tip>
  For detailed information about each dataset and its required parameters:

  ```python theme={null}
  from haystack_brightdata import BrightDataWebScraper

  # List all datasets
  datasets = BrightDataWebScraper.get_supported_datasets()
  for dataset in datasets:
      print(f"{dataset['id']}: {dataset['description']}")
  ```
</Tip>

## Use Cases

Bright Data's Haystack integration enables powerful use cases:

* **E-commerce Intelligence**: Price monitoring, product data extraction, and competitive analysis
* **Social Media Analytics**: Content monitoring and engagement analysis across platforms
* **Business Intelligence**: Company research and competitive landscape analysis
* **Search Analysis**: SEO/SEM research with geo-targeted search results
* **Content Aggregation**: Building RAG pipelines with real-time web data
* **Market Research**: Accessing geo-restricted content for global research


# Set up Bright Data with Smolagents
Source: https://docs.brightdata.com/integrations/hugging-face

Connect Smolagents to Bright Data (1000+ pre-built scrapers) so your agent can crawl sites, run web searches and access data from LinkedIn and Amazon.

<Card title="Building an AI startup?" href="https://brightdata.com/ai/ai-startups-program" icon="rocket-launch">
  You might be eligible for our Startup Program. Get fully funded access to the infrastructure you're reading about right now (up to \$20K value).
</Card>

## Why Use Bright Data With Smolagents?

The Bright Data tools for Smolagents provide the following capabilities:

<AccordionGroup>
  <Accordion title="Web Search">
    * **`search_tool`**\
      Search Google and get structured search results. This tool can search the web and return relevant results for your queries.

    ```python theme={null}
    from smolagents import Tool

    web_search = Tool.from_space(
        "BrightData/brightdata-search-tool",
        name="search_tool",
        description="search the web"
    )
    ```
  </Accordion>

  <Accordion title="Extract">
    * **`extract_tool`**\
      Scrape webpages and extract content as Markdown format. This tool can bypass CAPTCHA and bot detection to reliably extract data from any website.

    ```python theme={null}
    from smolagents import Tool

    extract = Tool.from_space(
        "BrightData/brightdata-scraper-tool",
        name="extract_tool",
        description="extract data from the web as markdown without getting blocked"
    )
    ```
  </Accordion>

  <Accordion title="Structured Data Feeds">
    * **`data_feeds_tool`**\
      Retrieve structured data from various platforms including LinkedIn, Amazon, Instagram, Facebook, X (Twitter), Zillow, and more.

    ```python theme={null}
    from smolagents import Tool

    data_feeds = Tool.from_space(
        "BrightData/brightdata-dataset-tool",
        name="data_feeds_tool",
        description="extract structured data from the web"
    )
    ```

    Supported platforms include:

    * LinkedIn (profiles and companies)
    * Amazon (products and reviews)
    * Instagram (profiles, posts, reels, comments)
    * Facebook (posts, marketplace listings, company reviews)
    * X/Twitter (posts)
    * Zillow (property listings)
    * Booking.com (hotel listings)
    * YouTube (videos)
    * And many more

    For more information, visit the [Bright Data documentation](/).
  </Accordion>
</AccordionGroup>

## How to Integrate Bright Data With Smolagents?

<Steps>
  <Step title="Obtain Your Bright Data API Key">
    * Log in to your [Bright Data dashboard](https://brightdata.com/cp).
    * Go to [Account Settings](https://brightdata.com/cp/setting/users).
    * [Generate an API key](/api-reference/authentication#how-do-i-authenticate-with-api-key%3F) if you haven't already done so.
  </Step>

  <Step title="Installation">
    Install the required packages. **Important:** As of December 9, 2025, these specific versions are mandatory to align with Smolagents:

    ```bash theme={null}
    pip install smolagents
    pip install --upgrade --force-reinstall "gradio_client<2.0.0" "gradio<6.0.0"
    ```
  </Step>

  <Step title="Configure API Key">
    Set your Bright Data API key as an environment variable:

    ```bash theme={null}
    export BRIGHTDATA_API_KEY="your-api-key"
    ```

    Or set it in your Python code:

    ```python theme={null}
    import os
    os.environ["BRIGHTDATA_API_KEY"] = "your-api-key"
    ```
  </Step>

  <Step title="Obtain Your Hugging Face API Token">
    When using `InferenceClientModel`, you need a Hugging Face token for authentication:

    * Visit [Hugging Face Settings - Tokens](https://hf.co/settings/tokens)
    * Create a new token with "Make calls to the serverless Inference API" permission
    * Set it as an environment variable:

    ```bash theme={null}
        export HF_TOKEN="your-hf-token"
    ```

    Or pass it directly when initializing the model:

    ```python theme={null}
        model = InferenceClientModel(
            model_id="Qwen/Qwen3-Next-80B-A3B-Thinking",
            token="your-hf-token"
        )
    ```

    **Note:** Free Hugging Face accounts include inference credits. Upgrade to PRO for higher rate limits.
  </Step>

  <Step title="Usage">
    Here's a complete example of how to use Bright Data tools with Smolagents:

    ```python theme={null}
    from smolagents import CodeAgent, InferenceClientModel, Tool

    # Load Bright Data tools from Hugging Face Spaces
    web_search = Tool.from_space(
        "BrightData/brightdata-search-tool",
        name="search_tool",
        description="search the web"
    )

    extract = Tool.from_space(
        "BrightData/brightdata-scraper-tool",
        name="extract_tool",
        description="extract data from the web as markdown without getting blocked"
    )

    data_feeds = Tool.from_space(
        "BrightData/brightdata-dataset-tool",
        name="data_feeds_tool",
        description="extract structured data from the web"
    )

    # Initialize the model
    model = InferenceClientModel(model_id="Qwen/Qwen3-Next-80B-A3B-Thinking")

    # Create the agent with Bright Data tools
    agent = CodeAgent(tools=[web_search, extract, data_feeds], model=model)

    # Run the agent
    response = agent.run(
        "Improve this prompt, then search the web for it.",
        additional_args={'user_prompt': 'who is elon musk'}
    )

    print(response)
    ```
  </Step>
</Steps>

## Example Use Cases

<AccordionGroup>
  <Accordion title="Web Research">
    Use the search tool to find information across the web:

    ```python theme={null}
    agent.run("Search for the latest developments in quantum computing")
    ```
  </Accordion>

  <Accordion title="Data Extraction">
    Scrape and extract content from websites:

    ```python theme={null}
    agent.run("Extract the main content from https://example.com/article")
    ```
  </Accordion>

  <Accordion title="Competitor Analysis">
    Extract structured data from e-commerce platforms:

    ```python theme={null}
    agent.run("Get product details and reviews for the top-rated laptops on Amazon")
    ```
  </Accordion>

  <Accordion title="Social Media Intelligence">
    Retrieve data from social media platforms:

    ```python theme={null}
    agent.run("Get the latest posts and engagement metrics from a LinkedIn company page")
    ```
  </Accordion>
</AccordionGroup>

## Tips for Best Results

* **Be specific** with your prompts to help the agent understand exactly what data you need
* **Combine tools** for complex tasks - the agent can use search, extract, and data feeds together

For more advanced configurations and detailed API documentation, visit [Bright Data's documentation](/).


# IBM Watsonx Orchestrate
Source: https://docs.brightdata.com/integrations/ibm-watsonx-orchestrate

Connect Bright Data's MCP server to IBM watsonx Orchestrate so agents can call live web scraping, search, and unblocking tools at runtime. Spans 195 countries.

## Overview

This integration provides your agents with web scraping and multi-engine search operations with bot protection bypass.

## Prerequisites

Before you begin, ensure you have:

* Access to IBM watsonx Orchestrate
* A Bright Data account with an active subscription
* Your Bright Data API key

## Steps to Get Started

<Steps>
  <Step title="Obtain Your Bright Data API Key">
    * Log in to your [Bright Data dashboard](https://brightdata.com/cp)
    * Navigate to [Account Settings](https://brightdata.com/cp/setting/users)
    * [Generate an API key](/api-reference/authentication#how-do-i-authenticate-with-api-key%3F) if you haven't already
    * Copy and securely store your API key for the next steps
  </Step>

  <Step title="Open the Agent Toolset">
    * Navigate to **Manage Agents** in IBM watsonx Orchestrate
    * Select your agent
    * In the left menu, click **Toolset**
    * Click **Add Tool**
      <img alt="Steps to Get Started" />
  </Step>

  <Step title="Add MCP Server Connection">
    In the "Add tool" dialog:

    <Frame>
      <img alt="Image" />
    </Frame>

    * Select **MCP server**

    * Click on the **Add MCP server** button:

      <Frame>
        <img alt="Add MCP server button in IBM watsonx Orchestrate" />
      </Frame>

    * Select **Remote MCP** and click **Next**:

      <Frame>
        <img alt="Selecting Remote MCP in IBM watsonx Orchestrate" />
      </Frame>

    * Choose a name for your Bright Data MCP server, add an optional description, and paste the MCP server URL including your API token, then click **Connect**:

      ```bash theme={null}
      https://mcp.brightdata.com/sse?token=<your_api_token>
      ```

      <Frame>
        <img alt="Bright Data MCP server connection details in IBM watsonx Orchestrate" />
      </Frame>
  </Step>

  <Step title="Enable Available Capabilities">
    Once installation completes, multiple capabilities will appear in your agent's toolset. Enable the following:

    `search_engine`

    `scrape_as_markdown`
  </Step>

  <Step title="Test Your Connection">
    Verify the integration is working:

    * Open your agent's chat interface
    * Ask the agent to perform a simple task (e.g., "Search for recent AI trends")
    * Confirm the agent successfully retrieves and processes data from Bright Data
  </Step>
</Steps>

## Example use cases

Once `search_engine` and `scrape_as_markdown` are enabled, your IBM watsonx Orchestrate agent can handle prompts like the ones below. Each example shows the user prompt, which Bright Data tool the agent will call, and the expected outcome.

### Search the live web with `search_engine`

Use `search_engine` when the agent needs fresh SERP results from Google, Bing or Yandex without being blocked.

<CodeGroup>
  ```text Market research theme={null}
  Find the top 10 results on Google for "enterprise RAG platforms 2026"
  and return the title, URL and snippet for each result as a table.
  ```

  ```text Geo-targeted SERP theme={null}
  Search Google for "best cloud GPU providers" as if I were located in
  Germany, then list the first page of organic results.
  ```

  ```text News monitoring theme={null}
  Search Bing News for "IBM watsonx Orchestrate" from the last 7 days
  and summarize the top 5 headlines with publication dates.
  ```
</CodeGroup>

**Expected behavior:** the agent calls `search_engine`, parses the SERP JSON, and replies with a structured summary. No proxy setup or CAPTCHA handling is required on your side.

### Extract page content with `scrape_as_markdown`

Use `scrape_as_markdown` when the agent needs the full content of a known URL, including pages protected by bot detection.

<CodeGroup>
  ```text Competitive intelligence theme={null}
  Scrape https://www.ibm.com/products/watsonx-orchestrate and summarize
  the key features and pricing tiers in a 5-bullet executive briefing.
  ```

  ```text Documentation lookup theme={null}
  Fetch the page at https://docs.brightdata.com/api-reference/MCP-Server
  and list every tool name with its one-line description.
  ```

  ```text Product page extraction theme={null}
  Scrape this product URL and return the title, price, rating and the
  first 3 customer reviews as JSON: https://www.example-store.com/item/123
  ```
</CodeGroup>

**Expected behavior:** the agent calls `scrape_as_markdown` with the URL, receives clean markdown, and extracts the requested fields. Pages that would normally trigger CAPTCHAs or 403 responses are handled by Bright Data's Unlocker infrastructure.

### Combine both tools in one task

The agent can chain `search_engine` and `scrape_as_markdown` to answer multi-step questions.

```text Research workflow theme={null}
Search Google for "top 5 vector databases 2026", then scrape the
homepage of each result and produce a comparison table with: product
name, pricing model, supported languages and a one-sentence positioning
statement.
```

The agent first calls `search_engine` to get the URLs, then calls `scrape_as_markdown` once per URL, then synthesizes the comparison. This pattern works for competitor analysis, lead enrichment and content aggregation flows.

## What you can do next

Your agent is now connected to Bright Data and ready to:

* Extract structured data from major platforms
* Perform geo-targeted web searches
* Scrape website content while bypassing bot protection
* Process large-scale data extraction tasks

## Where to get support

Need help? Contact Bright Data support or refer to the [Bright Data documentation](/) for detailed API references and troubleshooting guides.


# Integrations
Source: https://docs.brightdata.com/integrations/introduction

Connect Bright Data with your favorite tools, frameworks, and platforms. Browse by category to find setup guides for your stack.

<CardGroup>
  <Card title="AI Frameworks" icon="brain" href="/integrations/ai-integrations">
    LangChain, LlamaIndex, CrewAI, Dify, Haystack, and more AI frameworks and agents.
  </Card>

  <Card title="Automation" icon="bolt" href="/integrations/automation-integrations">
    Zapier, n8n, PhantomBuster, TexAu, Apify, and other workflow automation tools.
  </Card>

  <Card title="Scraping Tools" icon="spider" href="/integrations/scraping-tools-integrations">
    Scrapy, BeautifulSoup, Octoparse, ParseHub, Screaming Frog, and other scraping tools.
  </Card>

  <Card title="Anti-detect Browsers" icon="browser" href="/integrations/browser-integrations">
    GoLogin, Multilogin, AdsPower, Kameleo, and other anti-detect browsers.
  </Card>

  <Card title="Proxy Managers" icon="network-wired" href="/integrations/proxy-manager-integrations">
    FoxyProxy, Proxifier, SwitchyOmega, Shadowrocket, and other proxy managers.
  </Card>

  <Card title="Systems" icon="desktop" href="/integrations/systems-integrations">
    Android, iOS, macOS, Ubuntu, and Windows setup guides.
  </Card>

  <Card title="Testing" icon="flask" href="/integrations/testing-integrations">
    Postman and other API testing tools.
  </Card>

  <Card title="MCP Clients" icon="server" href="/ai/mcp-server/integrations/overview">
    Claude, Cursor, VS Code, n8n, and other MCP-compatible clients.
  </Card>
</CardGroup>


# How to use Bright Data on iOS
Source: https://docs.brightdata.com/integrations/ios

Step-by-step guide to configuring Bright Data proxies on iOS devices via Wi-Fi network settings for private and geo-targeted browsing. Spans 195 countries.

<Accordion title="Expand to get your Bright Data Proxy Access Information">
  ### Your proxy access information

  Bright Data proxies are grouped in "Proxy zones". Each zone holds the configuration for the proxies it holds.

  To get access to the proxy zone:

  1. Login to Bright Data control panel
  2. Select the proxy zone or setup a new one
  3. Click on the new zone name, and select the **Overview** tab.
  4. In the overview tab, under **Access details** you can find the proxy access details, and copy them to clipboard on click.
  5. You will need: Proxy Host, Proxy Port, Proxy Zone username and Proxy Zone password.
  6. Click on the copy icons to copy the text to your clipboard and paste in your tool's proxy configuration.

  ### Access Details Section Example

  <img alt="" />

  ### Residential proxy access

  To access Bright Data's **Residential Proxies** you must be a KYC-verified business account. Complete KYC verification with the Bright Data compliance team; there is no automatic or no-KYC path. Without KYC, use ISP or Datacenter proxies. [Read more...](/proxy-networks/residential/network-access)

  ### Targeting search engines?

  If you target a search engine like google, bing or yandex, you need a special Search Engine Results Page (**SERP**) proxy API. Use Bright Data SERP API to target search engines.
  [Click here to read more about Bright Data SERP proxy API.](/scraping-automation/serp-api/introduction)

  ### Correct setup of proxy test to avoid "PROXY ERROR"

  In many tools you will see a "test proxy" function, which performs a conncectivity test to your proxy, and some add a geolocation test as well, to identify the location of the proxy.
  To correctly test your proxy you should target those search queries to:
  `https://geo.brdtest.com/welcome.txt` .

  Some tools use popular search engines (like google.com) as a default test target. Bright Data will block those requests and you tool will show **proxy error** although your proxy is perfectly fine.

  If your proxy test fails, this is probably the reason. Make sure that your test domain is not a search engine (this is done in the tool configuration, and not controlled by Bright Data).
</Accordion>

## Why Use Bright Data on iOS?

Using Bright Data proxies on your iOS device allows you to:

* **Protect Your Privacy**: Hide your real IP address and browse securely.
* **Access Geo-Restricted Content**: Route traffic through different countries and regions.
* **Improve Connection Reliability**: Reduce detection risks and maintain stable, anonymous connections while browsing, shopping, or managing accounts.

***

## Prerequisites

Before you begin, ensure you have:

* **Bright Data Proxy Credentials**\
  Log in to your [Bright Data dashboard](https://brightdata.com/cp/zones) and note your **Host**, **Port**, **Username**, and **Password**.

* **An iPhone or iPad running iOS 10 or later**\
  The steps below apply to most modern iOS versions.

***

## Configuring a Proxy for a Wi-Fi Network

<Steps>
  <Step title="Open Wi-Fi Settings">
    1. Open **Settings** on your iOS device.
    2. Tap **Wi-Fi**, then select the **ⓘ (Info)** icon next to your connected network.

    <Frame>
      <img alt="iOS Settings app showing the Wi-Fi screen" />

      <img alt="iOS Wi-Fi network details with the info icon to open network configuration" />
    </Frame>
  </Step>

  <Step title="Change Proxy Settings to Manual">
    1. Scroll down to **HTTP Proxy**.
    2. Switch the setting from **Off** or **Automatic** to **Manual**.
    3. Toggle **Authentication** **On**.

    <Frame>
      <img alt="iOS Configure Proxy screen with Off, Automatic, and Manual options" />

      <img alt="iOS Manual proxy configuration with Server, Port, Authentication toggle, Username, and Password fields" />
    </Frame>
  </Step>

  <Step title="Enter Bright Data Proxy Credentials">
    Fill in the following details:

    * **Server**: `brd.superproxy.io`
    * **Port**: Use the port provided in your Bright Data dashboard
    * **Username**: Your Bright Data proxy username
    * **Password**: Your Bright Data proxy password

    Ensure all values are correct, then tap **Save** to apply the configuration.
  </Step>

  <Step title="Verify the Connection">
    1. Open **Safari** or any browser on your device.
    2. Visit:

    [http://httpbin.org/ip](http://httpbin.org/ip)

    3. Confirm that the displayed IP matches your Bright Data proxy IP.
  </Step>
</Steps>

***

## Best Practices

* Use **ISP or Datacenter proxies** for better stability on mobile devices
* Avoid switching Wi-Fi networks frequently when using proxies
* Keep your Bright Data credentials secure
* Re-check proxy settings after iOS updates

***

## Conclusion

You have successfully configured **Bright Data on iOS**. Your Wi-Fi traffic is now routed through secure and anonymous proxy connections, enabling private browsing and access to geo-restricted content. Enjoy a safer, more flexible browsing experience with Bright Data wherever you go.


# How to set up Bright Data with LangChain
Source: https://docs.brightdata.com/integrations/langchain

Integrate Bright Data with LangChain to give LLM-powered agents reliable, anonymous, and scalable web access for real-world data tasks. Spans 195 countries.

<Card title="Building an AI startup?" href="https://brightdata.com/ai/ai-startups-program" icon="rocket-launch">
  You might be eligible for our Startup Program. Get fully funded access to the infrastructure you're reading about right now (up to \$20K value).
</Card>

Integrating Bright Data with LangChain enhances LLM-powered agents with reliable, anonymous, and scalable web access for real-world applications.\
You can do it either by using the `langchain-brightdata` Python package is the official LangChain integration for Bright Data, including support for:

* **BrightDataSERP** - Bright Data provides a powerful SERP API that allows you to query search engines (Google,Bing, DuckDuckGo,Yandex) with geo-targeting and advanced customization options, particularly useful for AI agents requiring real-time web information.
* **BrightDataUnlockerAPI** - Bright Data provides a powerful Web Unlocker API that allows you to access websites that might be protected by anti-bot measures, geo-restrictions, or other access limitations, making it particularly useful for AI agents requiring reliable web content extraction.
* **BrightDataWebScraperAPI** - Bright Data provides a powerful Scrapers that allows you to extract structured data from 100+ ppular domains, including Amazon product details, LinkedIn profiles, and more, making it particularly useful for AI agents requiring reliable structured web data feeds.

Or by [**Bright Data’s MCP (Model Context Protocol)**](/ai/mcp-server/overview#configuration) - a local server that exposes a wide range of scraping and automation tools. While not part of the `langchain-brightdata` package, it can be integrated manually using LangChain’s `Tool` or `RequestsWrapper`.

## How to Integrate Bright Data With LangChain

<Steps>
  <Step title="Obtain Your Bright Data API Key">
    * Log in to your [Bright Data dashboard](https://brightdata.com/cp).
    * Go to [Account Settings](https://brightdata.com/cp/setting/users).
    * [Generate an API key](/api-reference/authentication#how-do-i-authenticate-with-api-key%3F) if you haven't already done so.
  </Step>

  <Step title="Install the Bright Data Integration">
    Install the Bright Data integration package for LangChain by running the following command:

    ```bash theme={null}
    pip install langchain-brightdata
    ```
  </Step>

  <Step title="Set the environment variable">
    Set your Bright Data API key as an environment variable:

    ```python theme={null}
    import os
    os.environ["BRIGHT_DATA_API_KEY"] = "your-api-key"
    ```

    <Tip>
      Or pass it directly when initializing tools:

      ```python theme={null}
      from langchain_bright_data import BrightDataSERP

      tool = BrightDataSERP(bright_data_api_key="your-api-key")
      ```
    </Tip>
  </Step>

  <Step title="Select your preferred Bright Data tool">
    The Bright Data + LangChain integration currently supports:

    <Tabs>
      <Tab title="BrightDataSERP">
        <Tip>
          **API reference**: [SERP API Documentation](/scraping-automation/serp-api/introduction)
        </Tip>

        Collect search engine results with geo-targeting

        <CodeGroup>
          ```python Basic Usage theme={null}
          from langchain_brightdata import BrightDataSERP

          # Initialize the tool
          serp_tool = BrightDataSERP(
              bright_data_api_key="your-api-key"  # Optional if set in environment variables
          )

          # Run a basic search
          results = serp_tool.invoke("latest AI research papers")

          print(results)
          ```

          ```python Advanced Usage with Parameters theme={null}
          from langchain_brightdata import BrightDataSERP

          # Initialize with default parameters
          serp_tool = BrightDataSERP(
              bright_data_api_key="your-api-key",
              search_engine="google",  # Default
              country="us",  # Default
              language="en",  # Default
              results_count=10,  # Default
              parse_results=True,  # Get structured JSON results
          )

          # Use with specific parameters for this search
          results = serp_tool.invoke(
              {
                  "query": "best electric vehicles",
                  "country": "de",  # Get results as if searching from Germany
                  "language": "de",  # Get results in German
                  "search_type": "shop",  # Get shopping results
                  "device_type": "mobile",  # Simulate a mobile device
                  "results_count": 15,
              }
          )

          print(results)
          ```

          ```python Use within an agent theme={null}
          from langchain_brightdata import BrightDataSERP
          from langchain_google_genai import ChatGoogleGenerativeAI
          from langgraph.prebuilt import create_react_agent

          # Initialize the LLM
          llm = ChatGoogleGenerativeAI(model="gemini-2.0-flash", google_api_key="your-api-key")

          # Initialize the Bright Data SERP tool
          serp_tool = BrightDataSERP(
              bright_data_api_key="your-api-key",
              search_engine="google",
              country="us",
              language="en",
              results_count=10,
              parse_results=True,
          )

          # Create the agent
          agent = create_react_agent(llm, [serp_tool])

          # Provide a user query
          user_input = "Search for 'best electric vehicles' shopping results in Germany in German using mobile."

          # Stream the agent's output step-by-step
          for step in agent.stream(
              {"messages": user_input},
              stream_mode="values",
          ):
              step["messages"][-1].pretty_print()
          ```
        </CodeGroup>
      </Tab>

      <Tab title="BrightDataUnblocker">
        <Tip>
          **API reference**: [Web Unlocker API Documentation](/scraping-automation/web-unlocker/introduction)
        </Tip>

        Access any public website, even if it’s bot-protected or geo-restricted.

        <CodeGroup>
          ```python Basic Usage theme={null}
          from langchain_brightdata import BrightDataUnlocker

          # Initialize the tool
          unlocker_tool = BrightDataUnlocker(
              bright_data_api_key="your-api-key"  # Optional if set in environment variables
          )

          # Access a webpage
          result = unlocker_tool.invoke("https://example.com")

          print(result)
          ```

          ```python Advanced Usage with Parameters theme={null}
          from langchain_brightdata import BrightDataUnlocker

          unlocker_tool = BrightDataUnlocker(
              bright_data_api_key="your-api-key",
          )

          # Access a webpage with specific parameters
          result = unlocker_tool.invoke(
              {
                  "url": "https://example.com/region-restricted-content",
                  "country": "gb",  # Access as if from Great Britain
                  "data_format": "html",  # Get content in markdown format
                  "zone": "unlocker",  # Use the unlocker zone
              }
          )

          print(result)
          ```

          ```python Use within an agent theme={null}
          from langchain_brightdata import BrightDataUnlocker
          from langchain_google_genai import ChatGoogleGenerativeAI
          from langgraph.prebuilt import create_react_agent

          # Initialize the LLM
          llm = ChatGoogleGenerativeAI(model="gemini-2.0-flash", google_api_key="your-api-key")

          # Initialize the tool
          bright_data_tool = BrightDataUnlocker(bright_data_api_key="your-api-key")

          # Create the agent
          agent = create_react_agent(llm, [bright_data_tool])

          # Input URLs or prompt
          user_input = "Get the content from https://example.com/region-restricted-page - access it from GB"

          # Stream the agent's output step by step
          for step in agent.stream(
              {"messages": user_input},
              stream_mode="values",
          ):
              step["messages"][-1].pretty_print()
          ```
        </CodeGroup>
      </Tab>

      <Tab title="BrightDataWebScraperAPI">
        <Tip>
          **API reference**: [Scrapers Documentation](/datasets/scrapers/scrapers-library/overview)
        </Tip>

        Extract structured data from over 100 supported domains like Amazon, LinkedIn, and more.

        <CodeGroup>
          ```python Basic Usage theme={null}
          from langchain_brightdata import BrightDataWebScraperAPI

          # Initialize the tool
          scraper_tool = BrightDataWebScraperAPI(
              bright_data_api_key="your-api-key"  # Optional if set in environment variables
          )

          # Extract Amazon product data
          results = scraper_tool.invoke(
              {"url": "https://www.amazon.com/dp/B08L5TNJHG", "dataset_type": "amazon_product"}
          )

          print(results)
          ```

          ```python Advanced Usage with Parameters theme={null}
          from langchain_brightdata import BrightDataWebScraperAPI

          # Initialize with default parameters
          scraper_tool = BrightDataWebScraperAPI(bright_data_api_key="your-api-key")

          # Extract Amazon product data with location-specific pricing
          results = scraper_tool.invoke(
              {
                  "url": "https://www.amazon.com/dp/B08L5TNJHG",
                  "dataset_type": "amazon_product",
                  "zipcode": "10001",  # Get pricing for New York City
              }
          )

          print(results)

          # Extract LinkedIn profile data
          linkedin_results = scraper_tool.invoke(
              {
                  "url": "https://www.linkedin.com/in/satyanadella/",
                  "dataset_type": "linkedin_person_profile",
              }
          )

          print(linkedin_results)
          ```

          ```python Use within an agent theme={null}
          from langchain_brightdata import BrightDataWebScraperAPI
          from langchain_google_genai import ChatGoogleGenerativeAI
          from langgraph.prebuilt import create_react_agent

          # Initialize the LLM
          llm = ChatGoogleGenerativeAI(model="gemini-2.0-flash", google_api_key="your-api-key")

          # Initialize the Bright Data Scrapers tool
          scraper_tool = BrightDataWebScraperAPI(bright_data_api_key="your-api-key")

          # Create the agent with the tool
          agent = create_react_agent(llm, [scraper_tool])

          # Provide a user query
          user_input = "Scrape Amazon product data for https://www.amazon.com/dp/B0D2Q9397Y?th=1 in New York (zipcode 10001)."

          # Stream the agent's step-by-step output
          for step in agent.stream(
              {"messages": user_input},
              stream_mode="values",
          ):
              step["messages"][-1].pretty_print()
          ```
        </CodeGroup>
      </Tab>
    </Tabs>
  </Step>
</Steps>


# How to set up Bright Data with Lindy.ai
Source: https://docs.brightdata.com/integrations/lindy-ai

Connect Bright Data (1000+ scrapers) to Lindy.ai to automate web data workflows: trigger real-time collection, call APIs and feed results into business apps.

<Card title="Building an AI startup?" href="https://brightdata.com/ai/ai-startups-program" icon="rocket-launch">
  You might be eligible for our Startup Program. Get fully funded access to the infrastructure you're reading about right now (up to \$20K value).
</Card>

<Accordion title="Expand to get your Bright Data Proxy Access Information">
  ### Your proxy access information

  Bright Data proxies are grouped in "Proxy zones". Each zone holds the configuration for the proxies it holds.

  To get access to the proxy zone:

  1. Login to Bright Data control panel
  2. Select the proxy zone or setup a new one
  3. Click on the new zone name, and select the **Overview** tab.
  4. In the overview tab, under **Access details** you can find the proxy access details, and copy them to clipboard on click.
  5. You will need: Proxy Host, Proxy Port, Proxy Zone username and Proxy Zone password.
  6. Click on the copy icons to copy the text to your clipboard and paste in your tool's proxy configuration.

  ### Access Details Section Example

  <img alt="" />

  ### Residential proxy access

  To access Bright Data's **Residential Proxies** you must be a KYC-verified business account. Complete KYC verification with the Bright Data compliance team; there is no automatic or no-KYC path. Without KYC, use ISP or Datacenter proxies. [Read more...](/proxy-networks/residential/network-access)

  ### Targeting search engines?

  If you target a search engine like google, bing or yandex, you need a special Search Engine Results Page (**SERP**) proxy API. Use Bright Data SERP API to target search engines.
  [Click here to read more about Bright Data SERP proxy API.](/scraping-automation/serp-api/introduction)

  ### Correct setup of proxy test to avoid "PROXY ERROR"

  In many tools you will see a "test proxy" function, which performs a conncectivity test to your proxy, and some add a geolocation test as well, to identify the location of the proxy.
  To correctly test your proxy you should target those search queries to:
  `https://geo.brdtest.com/welcome.txt` .

  Some tools use popular search engines (like google.com) as a default test target. Bright Data will block those requests and you tool will show **proxy error** although your proxy is perfectly fine.

  If your proxy test fails, this is probably the reason. Make sure that your test domain is not a search engine (this is done in the tool configuration, and not controlled by Bright Data).
</Accordion>

## What is Lindy.ai?

Lindy.ai is a no-code AI automation platform that enables users to create and deploy AI-powered agents, often referred to as "AI employees," to automate a wide range of business tasks. These agents can handle functions such as email management, customer support, scheduling, CRM data entry, lead generation, and more, integrating seamlessly with over 200 applications including Gmail, Slack, Zoom, and HubSpot.

## Why Use Bright Data With Lindy.ai?

**Automate Web Data Collection Workflows**

* Bright Data can scrape real-time data from websites (e.g., eCommerce, job boards, social media).
* Lindy.ai can automate when, how, and where that data is used (e.g., daily digests, alerts, CRM updates).

**No-Code Integration of Complex Data Pipelines**

* No need for developers or manual scripting.
* Build workflows visually in Lindy.ai using HTTP blocks to call Bright Data APIs.

**Trigger Actions Based on Live Data**

* **Example**: Scrape prices from competitor websites → If a product is cheaper than yours → Trigger a Slack alert or email team.
* **Example**: Monitor job postings → If a new listing matches your criteria → Add to Google Sheet or notify via SMS.

**Boost Operational Efficiency**

* Eliminate repetitive tasks like manual monitoring or copy-pasting scraped data.
* Your Lindy agents can act on web data automatically, 24/7.

**Scalable & Reliable**

* Bright Data handles proxy management, anti-bot bypassing, and data quality.
* Lindy handles logic, scheduling, and integrations with 200+ apps (CRM, Notion, Airtable, etc.).

## How to Integrate Bright Data With Lindy.ai?

<Steps>
  <Step title="Prerequisites">
    Before starting, make sure you have:

    * A **Bright Data** account with access to APIs (e.g., Browser API, Web Unlocker API, or DCA)
    * Your **Bright Data API key**
    * A **Lindy.ai** account
    * A basic understanding of APIs and HTTP requests
  </Step>

  <Step title="Choose and Configure Your Bright Data API">
    Depending on your use case, select the appropriate Bright Data API:

    * **Browser API** – For rendering JavaScript-heavy pages
    * **Data Collector API (DCA)** – For prebuilt scrapers
    * **Web Unlocker API** – For bypassing anti-bot mechanisms

    > 🔗 Example API endpoint (DCA):

    ```http theme={null}
    POST https://api.brightdata.com/dca/trigger
    ```
  </Step>

  <Step title="Get Your Bright Data API Key">
    1. Log in to your [Bright Data dashboard](https://brightdata.com/).
    2. Navigate to **API settings**.
    3. Copy your **API key**.
  </Step>

  <Step title="Create a New Workflow in Lindy.ai">
    1. Go to [Lindy.ai](https://lindy.ai) and log in.
    2. Click **Create Agent** or **New Workflow**.
    3. Choose a **Blank Workflow** or start from a use-case template.
  </Step>

  <Step title="Add an HTTP Request Block">
    1. Click “+” to add a block in your workflow.
    2. Select **HTTP Request**.

    > Configure as follows:
    >
    > * **Method**: `POST` or `GET` (depends on API)
    > * **URL**: Bright Data API endpoint (e.g., DCA trigger endpoint)
    > * **Headers**:
    >   * `Authorization`: `Bearer <your_api_key>`
    >   * `Content-Type`: `application/json`
    > * **Body** (if POST): JSON payload for your API

    ### Example: Trigger a Data Collector

    **HTTP Request Body:**

    ```json theme={null}
    {
      "collector_id": "clt_123456789",
      "start_url": "https://example.com/products"
    }
    ```

    **Response**: Bright Data returns a `collection_id`, which you can use in another step fetch the results."
  </Step>

  <Step title="Add Logic to Handle API Response">
    * Use Lindy's built-in blocks to:
      * Store the response
      * Parse data (e.g., JSON extract)
      * Trigger next steps (e.g., email, CRM update, Slack alert)
  </Step>

  <Step title="Test & Deploy">
    * Run the workflow with test data.
    * Check response logs and tweak headers or body if needed.
    * Once successful, activate the workflow or schedule it on a timer.
  </Step>
</Steps>

<Tip>
  ### 🎯 Bonus Use Case Example: Scrape + Notify

  1. Use Bright Data to scrape job listings.
  2. Use Lindy to filter for roles with keywords (e.g., “remote”, “Python”).
  3. Automatically email the relevant listings to your hiring team daily.
</Tip>


# How to set up Bright Data with LlamaIndex
Source: https://docs.brightdata.com/integrations/llama-index

Connect Bright Data to LlamaIndex to enable your agent to crawl websites, search the web, and extract structured data from major platforms. Spans 195 countries.

<Card title="Building an AI startup?" href="https://brightdata.com/ai/ai-startups-program" icon="rocket-launch">
  You might be eligible for our Startup Program. Get fully funded access to the infrastructure you're reading about right now (up to \$20K value).
</Card>

This tool connects to [Bright Data](https://brightdata.com/) to enable your agent to crawl websites, search the web, and access structured data from platforms like LinkedIn, Amazon, and social media.

Bright Data's tools provide robust web scraping capabilities with built-in CAPTCHA solving and bot detection avoidance, allowing you to reliably extract data from the web.

## Why Use Bright Data With LlamaIndex?

The Bright Data tool provides the following capabilities:

<AccordionGroup>
  <Accordion title="Web Scraping">
    * **`scrape_as_markdown`**\
      Scrape a webpage and convert the content to Markdown format. This tool can bypass CAPTCHA and bot detection.

    ```python theme={null}
    result = brightdata_tool.scrape_as_markdown("https://example.com")
    print(result.text)    
    ```
  </Accordion>

  <Accordion title="Visual Capture">
    * **`get_screenshot`**\
      Take a screenshot of a webpage and save it to a file.

    ```python theme={null}
    screenshot_path = brightdata_tool.get_screenshot(
        "https://example.com", output_path="example_screenshot.png"
    )
    ```
  </Accordion>

  <Accordion title="Search Engine Access">
    * **`search_engine`**\
      Search Google, Bing, or Yandex and get structured search results as JSON or Markdown. Supports advanced parameters for more specific searches.

    ```python theme={null}
    search_results = brightdata_tool.search_engine(
        query="climate change solutions",
        engine="google",
        language="en",
        country_code="us",
        num_results=20,
    )
    print(search_results.text)
    ```
  </Accordion>

  <Accordion title="Structured Web Data Extraction">
    * **`web_data_feed`**\
      Retrieve structured data from various platforms including LinkedIn, Amazon, Instagram, Facebook, X (Twitter), Zillow, and more.

    ```python theme={null}
    linkedin_profile = brightdata_tool.web_data_feed(
        source_type="linkedin_person_profile",
        url="https://www.linkedin.com/in/username/",
    )
    print(linkedin_profile)

    amazon_product = brightdata_tool.web_data_feed(
        source_type="amazon_product", url="https://www.amazon.com/dp/B08N5KWB9H"
    )
    print(amazon_product)
    ```
  </Accordion>

  <Accordion title="Advanced Configuration">
    The Bright Data tool offers various configuration options for specialized use cases:

    ### Search Engine Parameters

    The `search_engine` function supports advanced parameters like:

    * Language targeting (`language` parameter)
    * Country-specific search (`country_code` parameter)
    * Different search types (images, shopping, news, etc.)
    * Pagination controls
    * Mobile device emulation
    * Geolocation targeting
    * Hotel search parameters

    ```python theme={null}
    results = brightdata_tool.search_engine(
        query="best hotels in paris",
        engine="google",
        language="fr",
        country_code="fr",
        search_type="shopping",
        device="mobile",
        hotel_dates="2025-06-01,2025-06-05",
        hotel_occupancy=2,
    )
    ```

    ### Supported Web Data Sources

    The `web_data_feed` function supports retrieving structured data from:

    * LinkedIn (profiles and companies)
    * Amazon (products and reviews)
    * Instagram (profiles, posts, reels, comments)
    * Facebook (posts, marketplace listings, company reviews)
    * X/Twitter (posts)
    * Zillow (property listings)
    * Booking.com (hotel listings)
    * YouTube (videos)
    * ZoomInfo (company profiles)

    For more information, visit the [Bright Data documentation](/).
  </Accordion>
</AccordionGroup>

## How to Integrate Bright Data With LlamaIndex?

<Steps>
  <Step title="Obtain Your Bright Data API Key">
    * Log in to your [Bright Data dashboard](https://brightdata.com/cp).
    * Go to [Account Settings](https://brightdata.com/cp/setting/users).
    * [Generate an API key](/api-reference/authentication#how-do-i-authenticate-with-api-key%3F) if you haven't already done so.
  </Step>

  <Step title="Installation">
    Install the required packages:

    ```bash theme={null}
    pip install llama-index llama-index-core llama-index-tools-brightdata
    ```
  </Step>

  <Step title="Usage">
    Here's an example of how to use the BrightDataToolSpec with LlamaIndex:

    ```python theme={null}
    llm = OpenAI(model="gpt-4o", api_key="your-api-key")

    brightdata_tool = BrightDataToolSpec(api_key="your-api-key", zone="unlocker")

    tool_list = brightdata_tool.to_tool_list()

    for tool in tool_list:
        tool.original_description = tool.metadata.description
        tool.metadata.description = "Bright Data web scraping tool"

    agent = OpenAIAgent.from_tools(tools=tool_list, llm=llm)

    query = (
        "Find and summarize the latest news about AI from major tech news sites"
    )
    tool_descriptions = "\n\n".join(
        [
            f"Tool Name: {tool.metadata.name}\nTool Description: {tool.original_description}"
            for tool in tool_list
        ]
    )

    query_with_descriptions = f"{tool_descriptions}\n\nQuery: {query}"

    response = agent.chat(query_with_descriptions)
    print(response)
    ```
  </Step>
</Steps>


# How to use Bright Data on macOS
Source: https://docs.brightdata.com/integrations/macos

Step-by-step guide to configuring Bright Data proxies in macOS system network settings for system-wide geo-targeted browsing. Spans 195 countries.

<Accordion title="Expand to get your Bright Data Proxy Access Information">
  ### Your proxy access information

  Bright Data proxies are grouped in "Proxy zones". Each zone holds the configuration for the proxies it holds.

  To get access to the proxy zone:

  1. Login to Bright Data control panel
  2. Select the proxy zone or setup a new one
  3. Click on the new zone name, and select the **Overview** tab.
  4. In the overview tab, under **Access details** you can find the proxy access details, and copy them to clipboard on click.
  5. You will need: Proxy Host, Proxy Port, Proxy Zone username and Proxy Zone password.
  6. Click on the copy icons to copy the text to your clipboard and paste in your tool's proxy configuration.

  ### Access Details Section Example

  <img alt="" />

  ### Residential proxy access

  To access Bright Data's **Residential Proxies** you must be a KYC-verified business account. Complete KYC verification with the Bright Data compliance team; there is no automatic or no-KYC path. Without KYC, use ISP or Datacenter proxies. [Read more...](/proxy-networks/residential/network-access)

  ### Targeting search engines?

  If you target a search engine like google, bing or yandex, you need a special Search Engine Results Page (**SERP**) proxy API. Use Bright Data SERP API to target search engines.
  [Click here to read more about Bright Data SERP proxy API.](/scraping-automation/serp-api/introduction)

  ### Correct setup of proxy test to avoid "PROXY ERROR"

  In many tools you will see a "test proxy" function, which performs a conncectivity test to your proxy, and some add a geolocation test as well, to identify the location of the proxy.
  To correctly test your proxy you should target those search queries to:
  `https://geo.brdtest.com/welcome.txt` .

  Some tools use popular search engines (like google.com) as a default test target. Bright Data will block those requests and you tool will show **proxy error** although your proxy is perfectly fine.

  If your proxy test fails, this is probably the reason. Make sure that your test domain is not a search engine (this is done in the tool configuration, and not controlled by Bright Data).
</Accordion>

<Warning>
  **Account management is not a supported use case** on the Bright Data platform as of April 1, 2026. This includes managing accounts on platforms like TikTok, Instagram, or similar services. Bright Data proxies cannot be used for this purpose. See [Acceptable Use Policy](https://brightdata.com/acceptable-use-policy) for details.
</Warning>

<Tip>
  Maintain a consistent IP throughout your browsing session by using the `-session` parameter in your username. Bright Data proxies rotate IPs by default.\
  [Learn more](/proxy-networks/faqs#how-to-use-the-same-ip-for-an-extended-period-of-time-and-how-long-can-i-keep-it-long-session)

  New users should begin with ISP or Datacenter proxies, which need no KYC. Residential proxies require a [KYC-verified business account](/proxy-networks/residential/network-access).
</Tip>

## Why Use Bright Data on macOS?

Adding Bright Data proxies to your macOS network settings enables you to:

* **Enhance Privacy**: Hide your real IP address and browse securely
* **Access Geo-Restricted Content**: Route traffic through different countries and regions
* **Maintain Stable Connections**: Reduce detection risks across browsers and desktop applications
* **System-Wide Coverage**: Apply proxy routing to all apps that respect macOS network settings

***

## Setting Up Bright Data on macOS

<Steps>
  <Step title="Prerequisites">
    Before you begin, ensure you have:

    * **Bright Data Proxy Credentials**\
      Log in to your [Bright Data dashboard](https://brightdata.com/cp/zones) to retrieve:
      * Host
      * Port
      * Username
      * Password\
        Also confirm whether you are using `HTTP`, `HTTPS`, or `SOCKS5` proxies.

    * **A macOS device running macOS 10.12 (Sierra) or later**
  </Step>

  <Step title="Open Network Settings">
    1. Click the **Apple menu** in the top-left corner of your screen.
    2. Select **System Settings** (or **System Preferences** on older macOS versions).

    <Frame>
      <img alt="macOS Apple menu open with System Settings option highlighted" />
    </Frame>

    3. Open **Network** and select the connection you want to configure (for example, **Wi-Fi** or **Ethernet**).

    <Frame>
      <img alt="macOS Network settings with Wi-Fi connection selected" />
    </Frame>
  </Step>

  <Step title="Open Advanced Network Options">
    1. Click **Details…** (or **Advanced…** on older versions).

    <Frame>
      <img alt="macOS Wi-Fi network details panel with Details button to open advanced options" />
    </Frame>

    2. Navigate to the **Proxies** tab.

    <Frame>
      <img alt="macOS Network advanced settings showing the Proxies tab" />
    </Frame>
  </Step>

  <Step title="Select the Proxy Type">
    Choose the proxy protocol based on your Bright Data setup:

    * **Web Proxy (HTTP)** for HTTP proxies
    * **Secure Web Proxy (HTTPS)** for HTTPS proxies
    * **SOCKS Proxy** for SOCKS5 proxies

    <Frame>
      <img alt="macOS Proxies tab with Web Proxy, Secure Web Proxy, and SOCKS Proxy options" />
    </Frame>
  </Step>

  <Step title="Enter Bright Data Proxy Details">
    Fill in the proxy configuration fields:

    * **Server**: `brd.superproxy.io`
    * **Port**: Use the port provided in your Bright Data dashboard
    * Enable **Proxy server requires password**
    * **Username**: Your Bright Data username\
      *(Optionally append `-session-<id>` for IP persistence or `-country-XX` for geo-targeting)*
    * **Password**: Your Bright Data proxy password

    Click **OK**, then **Apply** to save the configuration.
  </Step>

  <Step title="Verify the Proxy Connection">
    1. Open **Safari**, **Chrome**, or another browser.
    2. Visit:

    [http://httpbin.org/ip](http://httpbin.org/ip)

    3. Confirm the displayed IP matches your Bright Data proxy IP.
  </Step>
</Steps>

***

## Best Practices

* Use **ISP or Datacenter proxies** for long-running desktop workflows
* Avoid frequently switching networks when using proxies
* Keep credentials secure and rotate sessions periodically
* Recheck proxy settings after macOS updates
* Use one proxy per account for account-based tasks

***

## Conclusion

You’ve successfully configured **Bright Data on macOS**. Your system traffic is now routed through secure, anonymous proxy connections, enabling private browsing and geo-flexible access across applications. With Bright Data in place, your Mac is ready for safer, more reliable online operations.


# How to set up Bright Data with Make.com
Source: https://docs.brightdata.com/integrations/make

Connect Bright Data (1000+ scrapers) to Make.com for no-code data workflows: trigger scrapers, deliver to Google Sheets, Notion or any HTTP webhook.

<Card title="Building an AI startup?" href="https://brightdata.com/ai/ai-startups-program" icon="rocket-launch">
  You might be eligible for our Startup Program. Get fully funded access to the infrastructure you're reading about right now (up to \$20K value).
</Card>

## What is Make.com?

[Make](https://www.make.com/en/integrations/brightdata) (formerly Integromat) is a visual automation platform that lets you connect various apps and services to create powerful workflows, without writing any code.

Bright Data's integration with Make enables seamless web data collection and processing. With this integration, you can automate tasks like scraping websites, retrieving datasets, and making API calls.

Bright Data offers the following six modules in Make:

1. **Run an Web Unlocker API** – Access and extract data from sites that block bots.
2. **Download a Snapshot Content** – Retrieve the full content of a previously captured dataset.
3. **Filter a Dataset** – Apply filters to datasets and generate refined snapshots.
4. **Get a Snapshot Metadata** – Fetch detailed metadata for a snapshot.
5. **Get a Snapshot Part** – Retrieve a specific section of a snapshot.
6. **Make an API Call** – Execute any authorized request to Bright Data’s API.

## Why Use Bright Data With Make.com?

Integrating Bright Data with [Make](https://www.make.com/en/integrations/brightdata) allows you to build sophisticated web data pipelines, without writing a single line of code.

You can visually design and automate workflows that connect Bright Data with over 2,000 other apps and services. For example, you can:

* Extract data from websites using **Web Unlocker API**.
* Download and store snapshot content.
* Apply filters to datasets dynamically.
* Retrieve snapshot metadata or specific parts.
* Trigger authorized Bright Data API calls.

These capabilities let you build end-to-end data flows that connect Bright Data with tools like Google Sheets, Airtable, Notion, Slack, or your internal systems.

## How to Integrate Bright Data With Make.com

<Steps>
  <Step title="Obtain Your Bright Data API Key">
    * Log in to your [Bright Data dashboard](https://brightdata.com/cp).
    * Go to [Account Settings](https://brightdata.com/cp/setting/users).
    * [Generate an API key](/api-reference/authentication#how-do-i-authenticate-with-api-key%3F) if you haven't already.
  </Step>

  <Step title="Create a New Scenario">
    * Log in to your Make.com account.
    * Click **Create a new scenario** in the top-left corner.
    * Choose the **Build from scratch** option.
  </Step>

  <Step title="Add the Bright Data Module to the Scenario">
    * Click the **+** button to add a module.
    * Search for and select **Bright Data** from the list.
  </Step>

  <Step title="Configure the 'Run an Web Unlocker API' Module">
    * Select the **Run an Web Unlocker API** module.
    * Click **Create a connection**.
    * Enter a descriptive connection name.
    * Paste your Bright Data API key into the **API Token** field.
    * Set parameters such as `zone`, `url`, `format`, `method`, `country`, and `async`.
    * Click **Save**.
  </Step>

  <Step title="Wait for Task Completion">
    * Add a delay or use a scheduling mechanism to allow the Web Unlocker API task to finish before proceeding.
  </Step>

  <Step title="Download the Snapshot Content">
    * Add the **Download a Snapshot Content** module.
    * Configure it to fetch the results of the completed Web Unlocker API task.
  </Step>

  <Step title="Store Data in Google Sheets">
    * Add a **Google Sheets** module.
    * Use it to insert the extracted data into your spreadsheet.
  </Step>
</Steps>

This setup builds a no-code data extraction pipeline that automates the process of collecting and storing data, perfect for use cases like price monitoring or competitor tracking.


# How to set up Bright Data with Mastra
Source: https://docs.brightdata.com/integrations/mastra

Integrate Bright Data's SDK with Mastra to add web scraping and structured data extraction from 40+ platforms to your AI agents.

<Card title="Building an AI startup?" href="https://brightdata.com/ai/ai-startups-program" icon="rocket-launch">
  You might be eligible for our Startup Program. Get fully funded access to the infrastructure you're reading about right now (up to \$20K value).
</Card>

The Bright Data SDK integration is now available in Mastra, bringing powerful web scraping and data extraction capabilities to AI agents. This integration enables structured data extraction from over 40 platforms, including Amazon, LinkedIn, and major search engines like Google, Bing, and Yandex.

Mastra agents can perform tasks like web scraping with anti-bot protection, running search queries, extracting Amazon product data, and collecting LinkedIn profiles-all with minimal setup. This makes it easy to build intelligent agents that can reason, act, and fetch real-time web data for research, automation, and competitive analysis.

## How to Integrate Bright Data With Mastra

<Steps>
  <Step title="Prerequisites">
    * Node.js
    * npm (latest version)
    * Bright Data API key
    * OpenAI API key (for GPT-4o-mini)
    * Bright Data zones will be auto-created if needed
  </Step>

  <Step title="Obtain Your Bright Data API Key">
    * Log in to your [Bright Data dashboard](https://brightdata.com/cp).
    * Go to [Account Settings](https://brightdata.com/cp/setting/users).
    * [Generate an API key](/api-reference/authentication#how-do-i-authenticate-with-api-key%3F) if you haven't already done so.
    * Enable SDK access for your API key
  </Step>

  <Step title="Obtain Your OpenAI API Key">
    * Go to [OpenAI Platform](https://platform.openai.com)
    * Navigate to the API keys section
    * Create a new API key
    * Ensure you have access to the GPT-4o-mini model
  </Step>

  <Step title="Create a New Mastra Project Using the Template">
    Create a new project using the Bright Data Mastra template:

    ```bash theme={null}
    npx create-mastra@latest --template brightdata-mastra-tools
    cd brightdata-mastra-tools
    npm install
    ```

    <Note>
      Alternatively, you can clone the repository directly:

      ```bash theme={null}
      git clone https://github.com/brightdata/brightdata-mastra-tools
      cd brightdata-mastra-tools
      npm install
      ```
    </Note>
  </Step>

  <Step title="Configure Environment Variables">
    Edit `.env` and add your API keys:

    ```env theme={null}
    OPENAI_API_KEY=your_openai_api_key_here
    BRIGHTDATA_API_KEY=your_brightdata_api_key_here
    ```
  </Step>

  <Step title="Start the Development Server">
    Run the Mastra development server with hot reloading:

    ```bash theme={null}
    npm run dev
    ```

    Your Bright Data-powered web agent is now ready to use!
  </Step>

  <Step title="Example Usage">
    The web agent comes pre-configured with four powerful tools. Here's how the agent works:

    ```typescript theme={null}
    import { Agent } from '@mastra/core/agent';
    import { Memory } from '@mastra/memory';
    import { LibSQLStore } from '@mastra/libsql';
    import { brightDataTools } from './tools/web-tools';

    const apiKey = process.env.BRIGHTDATA_API_KEY ?? '';
    const brightTools = brightDataTools({ apiKey });

    export const webAgent = new Agent({
      name: 'Web Agent',
      instructions: `
        You are a general-purpose web research assistant with Bright Data capabilities.
        
        Tool usage guidelines:
        - Start with the search tool to build context or surface credible sources.
        - Use the scrape tool to pull detailed content from specific pages.
        - Call the Amazon product tool for pricing, availability, or review summaries.
        - Fetch LinkedIn profile details when users need professional background information.
      `,
      model: 'openai/gpt-4o-mini',
      tools: {
        searchTool: brightTools.search!,
        scrapeTool: brightTools.scrape!,
        amazonProductTool: brightTools.amazonProduct!,
        linkedinCollectProfilesTool: brightTools.linkedinCollectProfiles!,
      },
      memory: new Memory({
        storage: new LibSQLStore({
          url: 'file:../mastra.db',
        }),
      }),
    });
    ```

    **Example queries you can ask the agent:**

    * "Search for the latest developments in quantum computing"
    * "Scrape the pricing information from example.com"
    * "Get details and reviews for this Amazon product: \[URL]"
    * "Collect LinkedIn profiles for executives at \[company name]"
  </Step>

  <Step title="Available Tools">
    The integration provides four powerful tools:

    **1. Search Tool**

    * Search across Google, Bing, or Yandex
    * Returns results in markdown or HTML format
    * Automatic anti-bot protection bypass
    * Supports localized results with country codes

    **2. Scrape Tool**

    * Extract website content in clean markdown format
    * Automatic CAPTCHA and bot detection bypass
    * Country-specific proxy support

    **3. Amazon Product Tool**

    * Get pricing, ratings, reviews, and specifications
    * Location-specific data with ZIP code support
    * Comprehensive product information

    **4. LinkedIn Collect Profiles Tool**

    * Fetch professional background, experience, and education
    * Batch processing for multiple profiles
    * Detailed skills and work history
  </Step>

  <Step title="Customizing Tools">
    You can selectively enable or disable tools:

    ```typescript theme={null}
    const brightTools = brightDataTools({
      apiKey: process.env.BRIGHTDATA_API_KEY!,
      excludeTools: ['linkedinCollectProfiles'] // Disable specific tools
    });
    ```
  </Step>
</Steps>

## How the project is structured

```text theme={null}
your-project/
├── src/
│   └── mastra/
│       ├── agents/
│       │   └── web-agent.ts           # Main AI agent
│       ├── tools/
│       │   └── web-tools.ts           # Bright Data SDK tools
│       └── index.ts                   # Mastra configuration
├── .env                               # Your API keys (do not commit)
├── .env.example                       # Environment template
├── package.json                       # Dependencies
└── tsconfig.json                      # TypeScript config
```

## Key Features

* **AI-Powered Intelligence**: Uses OpenAI GPT-4o-mini for intelligent reasoning
* **Bright Data SDK Integration**: Direct integration with Bright Data's web data tools
* **Multiple Data Sources**: Search engines, web scraping, Amazon, LinkedIn
* **Anti-Bot Protection**: Automatic CAPTCHA and bot detection bypass
* **Persistent Memory**: Maintains conversation history using LibSQL
* **TypeScript Support**: Fully typed for better development experience

## How to deploy to production

Build and start your production server:

```bash theme={null}
npm run build
npm run start
```

## Troubleshooting

**"Bright Data API key is required to initialize tools"**

* Ensure `.env` file exists with a valid `BRIGHTDATA_API_KEY`
* Verify the API key has SDK access permissions
* Check that the API key is not expired

**"OpenAI API key not found"**

* Verify `OPENAI_API_KEY` in `.env`
* Ensure the API key has access to GPT-4o-mini model
* Check your OpenAI account has available credits

**Tool initialization failures**

* The integration uses `autoCreateZones: true` to automatically create zones
* Check that the zones were created in your Bright Data account

## Where to learn more

* [Mastra Documentation](https://mastra.ai/en/docs)
* [Bright Data SDK Documentation](/api-reference/SDK-JS)
* [GitHub Repository](https://github.com/brightdata/brightdata-mastra-tools)


# How to set up Bright Data with n8n
Source: https://docs.brightdata.com/integrations/n8n

Connect Bright Data to n8n to build automated, no-code data workflows with native nodes for SERP, Web Unlocker and Web Scraper API in your self-hosted instance.

<Card title="Building an AI startup?" href="https://brightdata.com/ai/ai-startups-program" icon="rocket-launch">
  You might be eligible for our Startup Program. Get fully funded access to the infrastructure you're reading about right now (up to \$20K value).
</Card>

## What is n8n?

[n8n](https://n8n.io) is a powerful workflow automation tool that allows you to connect apps and APIs with ease using a visual interface. It supports custom logic, API integrations, and now, thanks to the community, Bright Data’s Web Unlocker API.

With the new [n8n-nodes-brightdata](https://www.npmjs.com/package/n8n-nodes-brightdata) node, you can automate your web scraping pipelines using Bright Data’s advanced proxy and CAPTCHA-solving infrastructure directly inside your n8n workflows.\
\
For advanced use cases, you can also integrate [**Bright Data MCP**](/ai/mcp-server/overview) via custom HTTP request nodes to access structured data tools, browser automation, and real-time scraping capabilities.

## Why Use Bright Data With n8n?

Integrating Bright Data with n8n lets you create advanced, resilient web scrapers without writing code. Benefits include:

* Scrape websites without getting blocked
* Emulate real-user behavior with headers, IP rotation, and fingerprinting
* Bypass CAPTCHA automatically
* Run headless scraping jobs reliably
* Chain the data into any of n8n’s 350+ supported services (Google Sheets, Airtable, Notion, and more)

For teams without proxy infrastructure or those scraping premium/anti-bot domains, this integration is a game-changer.

## How to Integrate Bright Data With n8n

This is a sample n8n workflow that automates the process of collecting and delivering the "Deals of the Day" from MediaMarkt, specifically tailored to user preferences, and sends those deals via email.

<Frame>
  <img alt="n8n-workflow-sample" />
</Frame>

**Workflow Structure:**

1. Webhook Trigger (User Form Submission)
2. Bright Data (Data Scraping)
3. HTML Extract (Content Extraction)
4. OpenAI (Recommendation Generation)
5. Split Out (Deal Item Separation)
6. Document Generator (HTML Document Creation)
7. SMTP Email Send (Email Delivery)

<Steps>
  <Step title="Prerequisites">
    * [Bright Data API key](/api-reference/authentication#api-key): For scraping data from MediaMarkt.
    * **OpenAI API**: To generate the list of recommended deals using GPT-4o-mini.
    * **SMTP credentials**: For sending the email with the deals.
    * The following community nodes installed in your n8n instance:
      * `n8n-nodes-base.brightdata`
      * `n8n-nodes-base.documentGenerator`
  </Step>

  <Step title="Form Submission (Webhook)">
    This node will be the entry point of your workflow, triggered by a form submission.

    * Drag and drop a Webhook node onto your canvas.
    * Request body includes:
      * `email`: User's email
      * `categories`: Array of categories like `"phones"`, `"appliances"`

    **Webhook Settings**

    * HTTP Method: `POST`
    * Path: `recommend-deals`
  </Step>

  <Step title="Scrape Deals with Bright Data">
    This node will connect to Bright Data to scrape the MediaMarkt website.

    * Drag and drop a **Bright Data** community node onto your canvas and connect it to the Webhook node.
    * Set Service to `Web Unlocker API`
    * Use method `GET` with the following request settings:
      * URL: `https://www.mediamarkt.es/es/campaign/campanas-y-ofertas`
      * Zone: Your Bright Data zone
      * Country: The country of your choosing for example: `es` (Spain)
      * API Token: Your Bright Data API key
  </Step>

  <Step title="Extract HTML Content">
    This node will extract specific HTML content from the raw data returned by Bright Data.

    * Drag and drop an HTML Extract node onto your canvas and connect it to the Bright Data node.
    * Use a **Set** or **Function** node to extract `title` and `body` from the HTML.

    You can optionally use the **HTML Extract** node if parsing specific sections.
  </Step>

  <Step title="Generate Recommendations with OpenAI">
    This node will use GPT-4o-mini to process the extracted data and generate recommended deals.

    * Drag and drop an OpenAI node onto your canvas and connect it to the HTML Extract node.
    * Authentication:
      * Credential Type: Select "API Key".
      * API Key: Enter your OpenAI API Key.
      * Model: Select `gpt-4o-mini`.
      * Temperature: 0.7 (Adjust as needed)
    * Prompt it with:

    ```text theme={null}
    You are an AI assistant. Based on the following HTML content, extract and recommend the best deals related to the categories: {{ $json["categories"].join(", ") }}.

    Respond in JSON array with keys: name, description, price, link.

    Content: {{ $json["html"] }}
    ```
  </Step>

  <Step title="Split Recommendations">
    This node will split the JSON array of deals generated by OpenAI into individual items for further processing.

    * Drag and drop a Split Out node onto your canvas and connect it to the OpenAI node.
    * Use a **SplitOut** node to split the response from OpenAI (JSON array) into individual deals.

      **Split Type**: Items in an array\
      **Input Path**: `$.json.deals`
  </Step>

  <Step title="Create HTML Document">
    This node will create an HTML document from a template, populating it with the recommended deals.

    * Drag and drop a Document Generator community node onto your canvas and connect it to the Split Out node.

    **Input**

    * Title: "Your Personalized Deals from MediaMarkt"
    * Template: Custom HTML with deal cards (include name, description, price, and link)

    **Optional**

    * Loop over split items to render a card per deal
  </Step>

  <Step title="Send Email with Deals">
    This node will send the generated HTML document as an email to the user.

    * Drag and drop an SMTP Email Send node onto your canvas and connect it to the Document Generator node.

    **Settings**

    * To: `{{$json["email"]}}`
    * Subject: "🔥 Your Personalized MediaMarkt Deals"
    * Message: Embed the generated HTML document
  </Step>
</Steps>

<Note>
  * The Bright Data community node in n8n is designed specifically for integrating with the Web Unlocker API only
  * This node is not officially developed by Bright Data - it's a community contribution
  * For more information and community support, visit: [n8n Community Discussion](https://community.n8n.io/t/bright-data-community-node-for-scrapping-anything/92011)
</Note>


# How to set up Bright Data with NGINX
Source: https://docs.brightdata.com/integrations/nginx

Step-by-step guide to configuring NGINX with Bright Data proxies for upstream traffic routing, domain masking, and connection management. Spans 195 countries.

<Accordion title="Expand to get your Bright Data Proxy Access Information">
  ### Your proxy access information

  Bright Data proxies are grouped in "Proxy zones". Each zone holds the configuration for the proxies it holds.

  To get access to the proxy zone:

  1. Login to Bright Data control panel
  2. Select the proxy zone or setup a new one
  3. Click on the new zone name, and select the **Overview** tab.
  4. In the overview tab, under **Access details** you can find the proxy access details, and copy them to clipboard on click.
  5. You will need: Proxy Host, Proxy Port, Proxy Zone username and Proxy Zone password.
  6. Click on the copy icons to copy the text to your clipboard and paste in your tool's proxy configuration.

  ### Access Details Section Example

  <img alt="" />

  ### Residential proxy access

  To access Bright Data's **Residential Proxies** you must be a KYC-verified business account. Complete KYC verification with the Bright Data compliance team; there is no automatic or no-KYC path. Without KYC, use ISP or Datacenter proxies. [Read more...](/proxy-networks/residential/network-access)

  ### Targeting search engines?

  If you target a search engine like google, bing or yandex, you need a special Search Engine Results Page (**SERP**) proxy API. Use Bright Data SERP API to target search engines.
  [Click here to read more about Bright Data SERP proxy API.](/scraping-automation/serp-api/introduction)

  ### Correct setup of proxy test to avoid "PROXY ERROR"

  In many tools you will see a "test proxy" function, which performs a conncectivity test to your proxy, and some add a geolocation test as well, to identify the location of the proxy.
  To correctly test your proxy you should target those search queries to:
  `https://geo.brdtest.com/welcome.txt` .

  Some tools use popular search engines (like google.com) as a default test target. Bright Data will block those requests and you tool will show **proxy error** although your proxy is perfectly fine.

  If your proxy test fails, this is probably the reason. Make sure that your test domain is not a search engine (this is done in the tool configuration, and not controlled by Bright Data).
</Accordion>

## What is NGINX?

**NGINX** is a high-performance web server and reverse proxy used for load balancing, caching, and securing connections. By integrating NGINX with **Bright Data**, you can mask proxy domains, route traffic seamlessly, and optimize your infrastructure for better performance.

## How to Set Up Bright Data With NGINX

<Steps>
  <Step title="Install NGINX">
    1. Install **NGINX** on your server following the [official installation guide](https://nginx.org/en/download.html).
    2. Ensure you’re using version **1.15.10 or higher**.
    3. Verify that your server’s IP is **not** added to the Bright Data proxy allowlist to avoid conflicts.
  </Step>

  <Step title="Configure the NGINX Core Settings">
    1. Open the main NGINX configuration file:

    ```bash theme={null}
    sudo nano /etc/nginx/nginx.conf   
    ```

    2. Update the following parameters:
       * **Set `worker_processes`** to `auto` for dynamic optimization.
       * **Set `worker_connections`** to `200` (or more, depending on your required number of ports).

    3. At the end of the `http` section, add:

    ```nginx theme={null}
    include /etc/nginx/sites-enabled/*;
    ```

    4. Save the changes and exit the editor.
    5. Your updated `nginx.conf` should look like this:

    ```nginx theme={null}
    worker_processes  auto;
    user              www-data;

    error_log         /var/log/nginx/error.log info;
    events {
        worker_connections 200;
    }

    http {
        include         /etc/nginx/mime.types;
        access_log      /var/log/nginx/access.log combined;

        server {
            server_name   localhost;
            listen        127.0.0.1:80;
            error_page    500 502 503 504  /50x.html;
        }

        include /etc/nginx/sites-enabled/*;
    }
    ```
  </Step>

  <Step title="Create a Proxy Configuration File">
    1. Create the directory for custom configurations:

    ```bash theme={null}
    sudo mkdir -p /etc/nginx/sites-enabled
    ```

    2. Create a new configuration file:

    ```bash theme={null}
    sudo nano /etc/nginx/sites-enabled/brightdata.conf
    ```

    3. Add the following configuration to the file, adjusting the port range as needed:

    ```nginx theme={null}
    server {
        listen 24000-24100;
        location / {
            resolver 8.8.8.8;
            proxy_pass http://127.0.0.1:$server_port;
            proxy_set_header Host $host;
            proxy_set_header X-Real-IP $remote_addr;
        }
    }
    ```

    3. Save and close the file.
  </Step>

  <Step title="Restart NGINX">
    1. Apply the changes by restarting NGINX:

    ```bash theme={null}
    sudo service nginx restart
    ```
  </Step>

  <Step title="Test the Proxy Configuration">
    1. Verify the proxy connection with the following command, replacing `10.0.2.15` with your server's IP:

    ```bash theme={null}
    curl --proxy http://10.0.2.15:24000 "http://brdtest.com/myip.json" -v
    ```

    2. Confirm that the response includes the expected proxy IP and location.

       **Expected output:**

       ```json theme={null}
       {
         "ip": "43.252.31.41",
         "country": "US",
         "asn": {
           "asnum": 207990,
           "org_name": "HostRoyale Technologies Pvt Ltd"
         },
         "geo": {
           "city": "Chicago",
           "region": "IL",
           "region_name": "Illinois",
           "postal_code": "60602",
           "latitude": 41.8874,
           "longitude": -87.6318,
           "tz": "America/Chicago",
           "lum_city": "chicago",
           "lum_region": "il"
         }
       }
       ```
  </Step>

  <Step title="Restart NGINX">
    1. To ensure that traffic routes through NGINX, monitor your proxy manager logs.
    2. Confirm that the "sent from" IP matches your NGINX server’s IP address.
  </Step>
</Steps>

Your **Bright Data** are now successfully integrated with **NGINX**, providing secure, efficient traffic routing and domain masking. This setup is ideal for optimizing web scraping, load balancing, and secure proxy management. Enjoy streamlined operations!


# How to set up Bright Data with OpenBullet
Source: https://docs.brightdata.com/integrations/openbullet

Configure Bright Data proxies (port 44445) in OpenBullet to run HTTP automation and testing workflows with geo-targeted IPs and reduced detection risk.

<Accordion title="Expand to get your Bright Data Proxy Access Information">
  ### Your proxy access information

  Bright Data proxies are grouped in "Proxy zones". Each zone holds the configuration for the proxies it holds.

  To get access to the proxy zone:

  1. Login to Bright Data control panel
  2. Select the proxy zone or setup a new one
  3. Click on the new zone name, and select the **Overview** tab.
  4. In the overview tab, under **Access details** you can find the proxy access details, and copy them to clipboard on click.
  5. You will need: Proxy Host, Proxy Port, Proxy Zone username and Proxy Zone password.
  6. Click on the copy icons to copy the text to your clipboard and paste in your tool's proxy configuration.

  ### Access Details Section Example

  <img alt="" />

  ### Residential proxy access

  To access Bright Data's **Residential Proxies** you must be a KYC-verified business account. Complete KYC verification with the Bright Data compliance team; there is no automatic or no-KYC path. Without KYC, use ISP or Datacenter proxies. [Read more...](/proxy-networks/residential/network-access)

  ### Targeting search engines?

  If you target a search engine like google, bing or yandex, you need a special Search Engine Results Page (**SERP**) proxy API. Use Bright Data SERP API to target search engines.
  [Click here to read more about Bright Data SERP proxy API.](/scraping-automation/serp-api/introduction)

  ### Correct setup of proxy test to avoid "PROXY ERROR"

  In many tools you will see a "test proxy" function, which performs a conncectivity test to your proxy, and some add a geolocation test as well, to identify the location of the proxy.
  To correctly test your proxy you should target those search queries to:
  `https://geo.brdtest.com/welcome.txt` .

  Some tools use popular search engines (like google.com) as a default test target. Bright Data will block those requests and you tool will show **proxy error** although your proxy is perfectly fine.

  If your proxy test fails, this is probably the reason. Make sure that your test domain is not a search engine (this is done in the tool configuration, and not controlled by Bright Data).
</Accordion>

## What is OpenBullet?

**OpenBullet** is an automation and testing framework used to manage HTTP requests, perform automated workflows, and validate responses at scale. It is commonly used for scraping, testing, and automation scenarios that require precise control over requests and proxy usage. When combined with Bright Data, OpenBullet gains improved anonymity, geo-targeting, and reduced detection risk.

***

## Why Use Bright Data With OpenBullet?

* **Enhanced Anonymity**: Mask your real IP address during automated workflows
* **Geo-Targeting**: Route traffic through specific countries or regions
* **Improved Stability**: Reduce connection errors and IP bans
* **Scalable Automation**: Safely handle large volumes of automated requests

***

## How to Set Up Bright Data With OpenBullet

Follow the steps below to integrate Bright Data proxies into OpenBullet.

<Steps>
  <Step title="Prerequisites">
    Before you begin, ensure you have:

    * An active Bright Data account
    * A configured Bright Data proxy zone (ISP or Datacenter recommended)
    * Your Bright Data proxy credentials (host, port, username, password)
    * OpenBullet installed on your system
  </Step>

  <Step title="Install OpenBullet">
    1. Visit the [OpenBullet GitHub page](https://github.com/openbullet/OpenBullet2) and download the latest release.
    2. Extract the downloaded archive.
    3. Launch the OpenBullet application on your system.
  </Step>

  <Step title="Create a Proxy Group">
    1. Open OpenBullet and navigate to the **Proxies** tab.
    2. Click **Add Group** to create a new proxy group.

    <Frame>
      <img alt="How to Set Up Bright Data With OpenBullet" />
    </Frame>

    3. Enter a descriptive name for the group (for example, `brightdata-dc`).
    4. Click **Accept** to save the group.

    <Frame>
      <img alt="How to Set Up Bright Data With OpenBullet" />
    </Frame>
  </Step>

  <Step title="Add Your Bright Data Proxy Details">
    1. Select the proxy group you created.
    2. Click **Import** to open the proxy import panel.

    <Frame>
      <img alt="How to Set Up Bright Data With OpenBullet" />
    </Frame>

    3. In the **Import proxies** dialog:
       * Switch to the **Paste** tab.
       * Paste your proxy credentials using the format:\
         `HOST:PORT:USERNAME:PASSWORD`
       * Click **Accept** to import the proxies.

    <Note>
      To maintain a consistent IP, append a session parameter to the username\
      (for example, `your-username-session-1`).

      For geo-targeting, format the username as\
      `your-username-country-XX` (for example, `your-username-country-US`).
    </Note>
  </Step>

  <Step title="Validate Proxy Connectivity">
    1. Select the imported proxy group.
    2. Use OpenBullet’s built-in proxy checker to test connectivity.
    3. Confirm that proxies return valid responses before running automation jobs.
  </Step>
</Steps>

***

## Best Practices

* Use **ISP or Datacenter proxies** for long-running automation
* Assign separate proxy groups for different projects
* Avoid excessive parallel requests from a single proxy
* Rotate sessions periodically for high-volume workflows
* Monitor OpenBullet logs for proxy-related failures

***

## Conclusion

By integrating Bright Data with OpenBullet, you create a secure and scalable automation environment. This setup protects your identity, enables geo-specific workflows, and improves reliability across automated tasks. With Bright Data proxies configured, you can run OpenBullet workflows with confidence and consistency.


# Set up Bright Data with OpenClaw
Source: https://docs.brightdata.com/integrations/openclaw

Give your OpenClaw AI agent real-time web search, bot-bypass scraping, browser automation, and 50+ structured data tools powered by Bright Data.

<Warning>
  **Account management is not a supported use case** on the Bright Data platform as of April 1, 2026. This includes managing accounts on platforms like TikTok, Instagram, or similar services. Bright Data proxies cannot be used for this purpose. See [Acceptable Use Policy](https://brightdata.com/acceptable-use-policy) for details.
</Warning>

<Card title="Building an AI startup?" href="https://brightdata.com/ai/ai-startups-program" icon="rocket-launch">
  You might be eligible for our Startup Program. Get fully funded access to the infrastructure you're reading about right now (up to \$20K value).
</Card>

[OpenClaw](https://openclaw.ai/) is a self-hosted AI assistant gateway that connects messaging apps like WhatsApp, Telegram, Discord, and iMessage to AI coding agents. It features a plugin system that lets you extend your agent with new tools and capabilities.

The **Bright Data plugin for OpenClaw** brings the full power of Bright Data's web data infrastructure directly into your OpenClaw agent. Install once, and your agent gains:

* **Real-time web search** via Google, Bing, and Yandex with geo-targeting
* **Bot-bypass scraping** through Web Unlocker, which handles CAPTCHAs, JS rendering, and rate limits automatically
* **Full browser automation** via a real Chromium instance routed through Bright Data's residential proxy network
* **50+ structured data tools** for Amazon, LinkedIn, Instagram, TikTok, YouTube, Reddit, and more

<Note>
  The plugin registers **66 tools** across five categories: search, scrape, batch operations, browser automation, and structured web data.
</Note>

## Steps to Get Started

<Steps>
  <Step title="Prerequisites">
    * [OpenClaw](https://openclaw.ai/) installed and running
    * A [Bright Data account](https://brightdata.com) with an API key
    * Node.js 22+ (managed by OpenClaw)
  </Step>

  <Step title="Obtain Your Bright Data API Key">
    * Log in to your [Bright Data dashboard](https://brightdata.com/cp).
    * Go to [Account Settings](https://brightdata.com/cp/setting/users).
    * [Generate an API key](/api-reference/authentication#how-do-i-authenticate-with-api-key%3F) if you haven't already done so.
  </Step>

  <Step title="Install the Bright Data Plugin">
    Install the plugin using the OpenClaw CLI:

    ```bash theme={null}
    openclaw plugins install @brightdata/brightdata-plugin
    ```

    Verify the installation:

    ```bash theme={null}
    openclaw plugins inspect brightdata
    ```

    You should see the plugin ID `brightdata` along with all registered tools.
  </Step>

  <Step title="Configure Your API Key">
    Choose one of the following methods to provide your Bright Data API key:

    <Tabs>
      <Tab title="Environment Variable (recommended for local dev)">
        ```bash theme={null}
        export BRIGHTDATA_API_TOKEN=your_token_here
        ```
      </Tab>

      <Tab title="OpenClaw Config (recommended for persistent setups)">
        ```bash theme={null}
        openclaw config set plugins.entries.brightdata.config.webSearch.apiKey your_token_here
        ```
      </Tab>
    </Tabs>

    <Tip>
      The plugin automatically creates two proxy zones on first use: `mcp_unlocker` (Web Unlocker) and `mcp_browser` (Browser API). No manual zone setup is required.
    </Tip>

    To use existing zones instead:

    ```bash theme={null}
    export BRIGHTDATA_UNLOCKER_ZONE=my_existing_zone
    export BRIGHTDATA_BROWSER_ZONE=my_existing_browser_zone
    ```
  </Step>

  <Step title="Enable the Plugin">
    Enable the plugin and restart the gateway:

    ```bash theme={null}
    openclaw plugins enable brightdata
    openclaw gateway restart
    ```

    <Note>
      If the plugin tools are not being exposed to your agent, you may need to explicitly allow plugin tools:

      ```bash theme={null}
      openclaw config set tools.alsoAllow '["group:plugins"]'
      ```
    </Note>
  </Step>

  <Step title="Start Using the Tools">
    Your OpenClaw agent now has access to all 66 Bright Data tools. Try these example prompts:

    ```text Search the web theme={null}
    Use the brightdata_search tool to search for "latest AI news" and return the top 5 results.
    ```

    ```text Scrape a webpage theme={null}
    Use the brightdata_scrape tool on https://example.com and summarize the page in 3 bullets.
    ```

    ```text Automate a browser theme={null}
    Use brightdata_browser_navigate to open https://example.com, then use brightdata_browser_get_text to return the visible page text.
    ```

    ```text Get structured data theme={null}
    Use brightdata_amazon_product to get details for https://www.amazon.com/dp/B0D2Q9397Y
    ```
  </Step>
</Steps>

## Available Tools

### How to search the web

| Tool                      | Description                                                                                            |
| ------------------------- | ------------------------------------------------------------------------------------------------------ |
| `brightdata_search`       | Search Google, Bing, or Yandex with geo-targeting. Returns structured results with pagination support. |
| `brightdata_search_batch` | Run up to 5 search queries in parallel. Partial failures are returned inline.                          |

**Parameters for `brightdata_search`:**

| Parameter      | Type                                 | Description                                 |
| -------------- | ------------------------------------ | ------------------------------------------- |
| `query`        | `string`                             | **Required.** Search query                  |
| `engine`       | `"google"` \| `"bing"` \| `"yandex"` | Search engine (default: `google`)           |
| `count`        | `number`                             | Results to return, 1-10                     |
| `cursor`       | `string`                             | Pagination cursor for next page             |
| `geo_location` | `string`                             | 2-letter ISO country code (e.g. `us`, `de`) |

### Scrape

| Tool                      | Description                                                                                                       |
| ------------------------- | ----------------------------------------------------------------------------------------------------------------- |
| `brightdata_scrape`       | Fetch any page through Web Unlocker. Works on bot-protected sites, JS-rendered pages, and geo-restricted content. |
| `brightdata_scrape_batch` | Scrape up to 5 URLs in parallel with the same extraction options.                                                 |

**Parameters for `brightdata_scrape`:**

| Parameter     | Type                                 | Description                             |
| ------------- | ------------------------------------ | --------------------------------------- |
| `url`         | `string`                             | **Required.** HTTP/HTTPS URL to scrape  |
| `extractMode` | `"markdown"` \| `"text"` \| `"html"` | Output format (default: `markdown`)     |
| `maxChars`    | `number`                             | Maximum characters to return (min: 100) |

### How to automate the browser

Full Chromium browser control routed through Bright Data's residential proxy network. Sessions idle-timeout after 10 minutes.

| Tool                                  | Description                                            |
| ------------------------------------- | ------------------------------------------------------ |
| `brightdata_browser_navigate`         | Navigate to a URL with optional country routing        |
| `brightdata_browser_snapshot`         | Capture an ARIA snapshot with interactive element refs |
| `brightdata_browser_click`            | Click an element by its snapshot ref                   |
| `brightdata_browser_type`             | Type into a field by ref (optional Enter to submit)    |
| `brightdata_browser_fill_form`        | Fill multiple form fields in a single operation        |
| `brightdata_browser_screenshot`       | Take a viewport or full-page screenshot                |
| `brightdata_browser_get_html`         | Get current page HTML                                  |
| `brightdata_browser_get_text`         | Get current page text content                          |
| `brightdata_browser_scroll`           | Scroll to the bottom of the page                       |
| `brightdata_browser_scroll_to`        | Scroll to a specific element by ref                    |
| `brightdata_browser_wait_for`         | Wait for an element to become visible                  |
| `brightdata_browser_network_requests` | List network requests since page load                  |
| `brightdata_browser_go_back`          | Navigate back                                          |
| `brightdata_browser_go_forward`       | Navigate forward                                       |

### Structured Web Data (50+ Platforms)

Each tool accepts a `url` or `keyword` and returns clean, typed JSON. No scraping or parsing required.

<AccordionGroup>
  <Accordion title="E-commerce (10 tools)">
    | Tool                                | Data                             |
    | ----------------------------------- | -------------------------------- |
    | `brightdata_amazon_product`         | Product details, pricing, specs  |
    | `brightdata_amazon_product_reviews` | Customer reviews and ratings     |
    | `brightdata_amazon_product_search`  | Search results with rankings     |
    | `brightdata_walmart_product`        | Product details and availability |
    | `brightdata_walmart_seller`         | Seller profile and metrics       |
    | `brightdata_ebay_product`           | Listing details and bids         |
    | `brightdata_homedepot_products`     | Product catalog and pricing      |
    | `brightdata_zara_products`          | Fashion catalog data             |
    | `brightdata_etsy_products`          | Handmade and vintage listings    |
    | `brightdata_bestbuy_products`       | Electronics catalog and deals    |
  </Accordion>

  <Accordion title="Professional Networks (7 tools)">
    | Tool                                  | Data                         |
    | ------------------------------------- | ---------------------------- |
    | `brightdata_linkedin_person_profile`  | Full person profile          |
    | `brightdata_linkedin_company_profile` | Company overview and stats   |
    | `brightdata_linkedin_job_listings`    | Open positions with details  |
    | `brightdata_linkedin_posts`           | Post content and engagement  |
    | `brightdata_linkedin_people_search`   | People search results        |
    | `brightdata_crunchbase_company`       | Funding, investors, founders |
    | `brightdata_zoominfo_company_profile` | Company intelligence data    |
  </Accordion>

  <Accordion title="Social Media (17 tools)">
    **Instagram**

    | Tool                            | Data                        |
    | ------------------------------- | --------------------------- |
    | `brightdata_instagram_profiles` | Profile stats and bio       |
    | `brightdata_instagram_posts`    | Post content and engagement |
    | `brightdata_instagram_reels`    | Reel metadata and views     |
    | `brightdata_instagram_comments` | Comment threads             |

    **Facebook**

    | Tool                                       | Data                         |
    | ------------------------------------------ | ---------------------------- |
    | `brightdata_facebook_posts`                | Post content and reactions   |
    | `brightdata_facebook_marketplace_listings` | Marketplace items            |
    | `brightdata_facebook_company_reviews`      | Page reviews and ratings     |
    | `brightdata_facebook_events`               | Event details and attendance |

    **TikTok**

    | Tool                         | Data                      |
    | ---------------------------- | ------------------------- |
    | `brightdata_tiktok_profiles` | Creator profile and stats |
    | `brightdata_tiktok_posts`    | Video content and metrics |
    | `brightdata_tiktok_shop`     | TikTok Shop product data  |
    | `brightdata_tiktok_comments` | Comment threads           |

    **X (Twitter)**

    | Tool                         | Data                     |
    | ---------------------------- | ------------------------ |
    | `brightdata_x_posts`         | Post content and metrics |
    | `brightdata_x_profile_posts` | Profile post history     |

    **YouTube & Reddit**

    | Tool                          | Data                      |
    | ----------------------------- | ------------------------- |
    | `brightdata_youtube_profiles` | Channel stats and info    |
    | `brightdata_youtube_videos`   | Video details and metrics |
    | `brightdata_youtube_comments` | Comment threads           |
    | `brightdata_reddit_posts`     | Post content and scores   |
  </Accordion>

  <Accordion title="Maps, Shopping & Apps (4 tools)">
    | Tool                             | Data                         |
    | -------------------------------- | ---------------------------- |
    | `brightdata_google_maps_reviews` | Location reviews and ratings |
    | `brightdata_google_shopping`     | Shopping results and prices  |
    | `brightdata_google_play_store`   | App details and reviews      |
    | `brightdata_apple_app_store`     | App details and reviews      |
  </Accordion>

  <Accordion title="Finance, News & Code (3 tools)">
    | Tool                                | Data                        |
    | ----------------------------------- | --------------------------- |
    | `brightdata_yahoo_finance_business` | Company financials and news |
    | `brightdata_github_repository_file` | Repository file contents    |
  </Accordion>

  <Accordion title="Real Estate & Travel (2 tools)">
    | Tool                                   | Data                            |
    | -------------------------------------- | ------------------------------- |
    | `brightdata_zillow_properties_listing` | Property listings and estimates |
    | `brightdata_booking_hotel_listings`    | Hotel listings and pricing      |
  </Accordion>

  <Accordion title="AI Insights (3 tools)">
    | Tool                                | Data                 |
    | ----------------------------------- | -------------------- |
    | `brightdata_chatgpt_ai_insights`    | ChatGPT responses    |
    | `brightdata_grok_ai_insights`       | Grok responses       |
    | `brightdata_perplexity_ai_insights` | Perplexity responses |
  </Accordion>
</AccordionGroup>

## Web Search Provider Integration

The plugin also registers as an OpenClaw **web search provider**. To set Bright Data as your default search provider:

```bash theme={null}
openclaw config set tools.web.search.provider brightdata
```

Once set, any generic web search your agent performs will route through Bright Data's search infrastructure.

## Which settings to configure

All settings can be provided via environment variable or OpenClaw config. Environment variables take priority.

| Setting         | Environment Variable       | OpenClaw Config Path                                                | Default                      |
| --------------- | -------------------------- | ------------------------------------------------------------------- | ---------------------------- |
| API Key         | `BRIGHTDATA_API_TOKEN`     | `plugins.entries.brightdata.config.webSearch.apiKey`                | **required**                 |
| Base URL        | `BRIGHTDATA_BASE_URL`      | `plugins.entries.brightdata.config.webSearch.baseUrl`               | `https://api.brightdata.com` |
| Unlocker Zone   | `BRIGHTDATA_UNLOCKER_ZONE` | `plugins.entries.brightdata.config.webSearch.unlockerZone`          | `mcp_unlocker`               |
| Browser Zone    | `BRIGHTDATA_BROWSER_ZONE`  | `plugins.entries.brightdata.config.webSearch.browserZone`           | `mcp_browser`                |
| Request Timeout | -                          | `plugins.entries.brightdata.config.webSearch.timeoutSeconds`        | `30s` search / `60s` scrape  |
| Polling Timeout | -                          | `plugins.entries.brightdata.config.webSearch.pollingTimeoutSeconds` | `600s`                       |

## How to manage the plugin

```bash theme={null}
# Verify installation and loaded tools
openclaw plugins inspect brightdata

# Update to latest version
openclaw plugins update brightdata

# Temporarily disable
openclaw plugins disable brightdata

# Re-enable
openclaw plugins enable brightdata

# Uninstall
openclaw plugins uninstall brightdata
```

## Troubleshooting

**Plugin not found after install**

* Run `openclaw plugins list` to verify the plugin is installed.
* Check that the plugin ID is `brightdata` with `openclaw plugins inspect brightdata`.
* Run `openclaw plugins doctor` for diagnostic information.

**Tools not registering**

* Ensure the plugin is enabled: `openclaw plugins enable brightdata`.
* Restart the gateway: `openclaw gateway restart`.

**Authentication errors**

* Verify your API key is set correctly via env var or config.
* Check that the token has not expired in your [Bright Data dashboard](https://brightdata.com/cp/setting/users).

**Zone creation failures**

* The plugin auto-creates `mcp_unlocker` and `mcp_browser` zones on first use.
* If auto-creation fails, create the zones manually in your Bright Data dashboard and set them via environment variables.

## Where to learn more

* [OpenClaw Documentation](https://docs.openclaw.ai)
* [OpenClaw Plugin CLI Reference](https://openclawlab.com/en/docs/cli/plugins/)
* [Bright Data API Documentation](/)
* [Plugin Source Code on GitHub](https://github.com/brightdata/openclaw-plugin)


# Deploy Bright Data + OpenClaw on Railway
Source: https://docs.brightdata.com/integrations/openclaw-railway

Deploy an OpenClaw AI agent preloaded with 66 Bright Data web tools on Railway in one click, with no CLI setup or manual plugin install.

<Warning>
  **Account management is not a supported use case** on the Bright Data platform as of April 1, 2026. This includes managing accounts on platforms like TikTok, Instagram, or similar services. Bright Data proxies cannot be used for this purpose. See [Acceptable Use Policy](https://brightdata.com/acceptable-use-policy) for details.
</Warning>

<Card title="Building an AI startup?" href="https://brightdata.com/ai/ai-startups-program" icon="rocket-launch">
  You might be eligible for our Startup Program. Get fully funded access to the infrastructure you're reading about right now (up to \$20K value).
</Card>

This guide shows you how to deploy an [OpenClaw](https://openclaw.ai/) AI agent with the official Bright Data plugin on Railway using a one-click template, so your agent gets 66 Bright Data web tools with no CLI setup and no manual plugin installation.

[![Deploy on Railway](https://railway.com/button.svg)](https://railway.com/deploy/openclaw-bright-data)

The Railway template bundles the **Bright Data plugin for OpenClaw** pre-installed and pre-configured. On first boot, the container installs the plugin, registers all tools and generates a persistent gateway token, giving your agent real-time web search, bot-bypass scraping, browser automation and 50+ structured data tools across platforms like Amazon, LinkedIn and Instagram.

<Note>
  The plugin registers **66 tools** across five categories: search, scrape, batch operations, browser automation and structured web data.
</Note>

<Tip>
  Prefer to install the plugin yourself on an existing OpenClaw instance? Use the manual CLI install in [Set up Bright Data with OpenClaw](/integrations/openclaw).
</Tip>

## Prerequisites

* A [Bright Data account](https://brightdata.com) with an API key
* A [Railway account](https://railway.com) (free trial available)
* An AI provider API key: [OpenRouter](https://openrouter.ai/keys) (free), OpenAI, Anthropic or Gemini

<Note>
  OpenRouter is recommended. Its free Nemotron model provides the 262K context window required to handle the 66-tool plugin manifest without rate limit errors.
</Note>

## How to deploy the template on Railway

<Steps>
  <Step title="Get your Bright Data API key">
    * Log in to your [Bright Data dashboard](https://brightdata.com/cp).
    * Go to [Account Settings](https://brightdata.com/cp/setting/users).
    * [Generate an API key](/api-reference/authentication#how-do-i-authenticate-with-api-key%3F) if you haven't already done so.
  </Step>

  <Step title="Deploy on Railway">
    Click **Deploy on Railway**. Railway creates a new project from the template.

    <Warning>
      Add a **persistent volume mounted at `/data`** in your service settings before or immediately after deploying. Without it, the gateway cannot store its configuration.
    </Warning>
  </Step>

  <Step title="Set environment variables">
    Set the following variables in the Railway **Variables** tab:

    | Variable                                                  | Description                           | Required     |
    | --------------------------------------------------------- | ------------------------------------- | ------------ |
    | `BRIGHTDATA_API_TOKEN`                                    | Your Bright Data API key              | **Required** |
    | `SETUP_PASSWORD`                                          | Password for the `/setup` status page | **Required** |
    | `OPENROUTER_API_KEY`                                      | Recommended AI provider               | Recommended  |
    | `OPENAI_API_KEY` / `ANTHROPIC_API_KEY` / `GEMINI_API_KEY` | Alternative AI providers              | Optional     |
  </Step>

  <Step title="Wait for initialization">
    First boot takes three to five minutes. The container installs the plugin, registers all 66 tools and generates a persistent gateway token.
  </Step>

  <Step title="Open the setup page and copy the gateway token">
    Open `https://your-app.up.railway.app/setup`, enter your `SETUP_PASSWORD` and wait for status **DONE**. Copy the **gateway token**.
  </Step>

  <Step title="Connect the OpenClaw UI">
    Open the OpenClaw UI from the setup page and paste the gateway token. All 66 Bright Data tools are available immediately.
  </Step>
</Steps>

## Which Bright Data tools are included?

The plugin registers 66 tools across five categories: search, scrape, batch operations, browser automation and structured web data (Amazon, LinkedIn, Instagram, TikTok, YouTube, Reddit, Zillow and more).

For the full list of tools, parameters and example prompts, see the [tool reference on the OpenClaw integration page](/integrations/openclaw#available-tools).

## Troubleshooting

**Do I need to add a volume?**

Yes. Add a persistent volume mounted at `/data` before or immediately after deploying. Without it, the OpenClaw gateway cannot store its configuration and will not retain the gateway token across restarts.

**Why is OpenRouter recommended over other providers?**

The free Nemotron model on OpenRouter provides a 262K context window, which is required to handle the 66-tool plugin manifest without rate limit errors. OpenAI, Anthropic and Gemini also work if you set their API keys instead.

**The setup page is not showing my tools yet**

Wait for the `/setup` page to report status **DONE** before opening the OpenClaw UI. First boot takes three to five minutes while the container installs the plugin, registers all 66 tools and generates the gateway token.

## Additional resources

* [Set up Bright Data with OpenClaw](/integrations/openclaw): manual CLI install for an existing OpenClaw instance
* [AI integrations overview](/integrations/ai-integrations)
* [OpenClaw documentation](https://docs.openclaw.ai)
* [Template source code on GitHub](https://github.com/ReallyGreatTech/brightdata-railway)


# Set up Bright Data with PhantomBuster
Source: https://docs.brightdata.com/integrations/phantombuster

Step-by-step guide to configuring Bright Data proxies in PhantomBuster automations for safer, higher-success-rate data gathering workflows. Spans 195 countries.

<Accordion title="Expand to get your Bright Data Proxy Access Information">
  ### Your proxy access information

  Bright Data proxies are grouped in "Proxy zones". Each zone holds the configuration for the proxies it holds.

  To get access to the proxy zone:

  1. Login to Bright Data control panel
  2. Select the proxy zone or setup a new one
  3. Click on the new zone name, and select the **Overview** tab.
  4. In the overview tab, under **Access details** you can find the proxy access details, and copy them to clipboard on click.
  5. You will need: Proxy Host, Proxy Port, Proxy Zone username and Proxy Zone password.
  6. Click on the copy icons to copy the text to your clipboard and paste in your tool's proxy configuration.

  ### Access Details Section Example

  <img alt="" />

  ### Residential proxy access

  To access Bright Data's **Residential Proxies** you must be a KYC-verified business account. Complete KYC verification with the Bright Data compliance team; there is no automatic or no-KYC path. Without KYC, use ISP or Datacenter proxies. [Read more...](/proxy-networks/residential/network-access)

  ### Targeting search engines?

  If you target a search engine like google, bing or yandex, you need a special Search Engine Results Page (**SERP**) proxy API. Use Bright Data SERP API to target search engines.
  [Click here to read more about Bright Data SERP proxy API.](/scraping-automation/serp-api/introduction)

  ### Correct setup of proxy test to avoid "PROXY ERROR"

  In many tools you will see a "test proxy" function, which performs a conncectivity test to your proxy, and some add a geolocation test as well, to identify the location of the proxy.
  To correctly test your proxy you should target those search queries to:
  `https://geo.brdtest.com/welcome.txt` .

  Some tools use popular search engines (like google.com) as a default test target. Bright Data will block those requests and you tool will show **proxy error** although your proxy is perfectly fine.

  If your proxy test fails, this is probably the reason. Make sure that your test domain is not a search engine (this is done in the tool configuration, and not controlled by Bright Data).
</Accordion>

## What is PhantomBuster?

PhantomBuster is a cloud-based automation platform designed to handle repetitive online tasks at scale. It enables you to automate actions across social networks, websites, and online services without managing infrastructure or writing complex scripts. By combining PhantomBuster with Bright Data proxies, you gain higher reliability, improved anonymity, and better protection against blocks.

<Tip>
  Maintain a consistent IP throughout your browser session by using the `-session` parameter in your username. Bright Data proxies rotate IPs by default.\
  [Learn more](/proxy-networks/faqs#how-to-use-the-same-ip-for-an-extended-period-of-time-and-how-long-can-i-keep-it-long-session)

  New users should begin with ISP or Datacenter proxies, which need no KYC. Residential proxies require a [KYC-verified business account](/proxy-networks/residential/network-access).
</Tip>

***

## How to Integrate Bright Data With PhantomBuster

Integrating Bright Data proxies into PhantomBuster helps you maintain anonymity, reduce the risk of blocks, and improve automation stability. Follow the steps below to complete the setup.

<Steps>
  <Step title="Prerequisites">
    Before you begin, ensure you have:

    * An active PhantomBuster account
    * An active Bright Data account
    * A configured Bright Data proxy zone (ISP or Data Center recommended)
    * Your Bright Data proxy credentials (host, port, username, password)
  </Step>

  <Step title="Open the Proxies Settings">
    Log in to your [PhantomBuster account](https://phantombuster.com/) and navigate to **Settings → Proxies**.\
    This section allows you to manage proxy pools used by your Phantoms.

    <Frame>
      <img alt="How to Integrate Bright Data With PhantomBuster" />
    </Frame>
  </Step>

  <Step title="Create a New Proxy Pool">
    Click **New proxy pool** to create a dedicated pool for Bright Data proxies.\
    Using separate proxy pools for different projects helps isolate workflows and reduce detection risk.

    <Frame>
      <img alt="How to Integrate Bright Data With PhantomBuster" />
    </Frame>
  </Step>

  <Step title="Name Your Proxy Pool">
    Assign a clear and descriptive name to your proxy pool (for example, `brightdata-isp-eu`).\
    This makes it easier to identify and reuse the pool across multiple Phantoms.

    <Frame>
      <img alt="How to Integrate Bright Data With PhantomBuster" />
    </Frame>
  </Step>

  <Step title="Add Your Bright Data Proxy Details">
    Enter your Bright Data proxy credentials using the following format:

    `host:port:username:password`

    You can find these details in your [Bright Data dashboard](https://brightdata.com/cp/zones/page/plans).

    After entering the credentials, click **Add proxy** to save them to the pool.

    <Frame>
      <img alt="How to Integrate Bright Data With PhantomBuster" />
    </Frame>
  </Step>

  <Step title="Configure Advanced Phantom Settings">
    Open the Phantom you want to run and expand the **Advanced settings** section.\
    This is where you define network and execution behavior for your workflow.

    <Frame>
      <img alt="How to Integrate Bright Data With PhantomBuster" />
    </Frame>
  </Step>

  <Step title="Apply the Proxy Pool">
    In **Advanced settings**, select the Bright Data proxy pool you created.\
    Click **Save settings** to apply the configuration.

    From this point forward, the Phantom will route all traffic through Bright Data proxies.

    <Frame>
      <img alt="How to Integrate Bright Data With PhantomBuster" />
    </Frame>
  </Step>

  <Step title="Run and Monitor Your Phantom">
    Start your Phantom and monitor execution logs.\
    If you encounter blocks or slowdowns:

    * Reduce execution frequency
    * Use session-based usernames for IP consistency
    * Assign dedicated proxies to sensitive accounts
  </Step>
</Steps>

***

## Best Practices

* Use one proxy pool per platform or account type
* Avoid running too many Phantoms concurrently from the same pool
* Prefer ISP proxies for logged-in or session-based workflows
* Monitor Phantom execution logs for proxy-related errors
* Rotate sessions periodically for long-running workflows

***

## Conclusion

Your Bright Data proxies are now fully integrated with PhantomBuster. This setup enables more reliable automation, stronger anonymity, and reduced block rates across your workflows. With the technical foundation in place, you can focus on scaling outreach, data collection, and growth initiatives with confidence.


# How to set up Bright Data with Pica
Source: https://docs.brightdata.com/integrations/pica

Integrate Bright Data with Pica to give AI agent workflows reliable, anonymous web access and scalable data collection from the public web. Spans 195 countries.

<Card title="Building an AI startup?" href="https://brightdata.com/ai/ai-startups-program" icon="rocket-launch">
  You might be eligible for our Startup Program. Get fully funded access to the infrastructure you're reading about right now (up to \$20K value).
</Card>

[Pica](https://www.picaos.com/) is a platform designed to enhance AI agent workflows by providing reliable, anonymous, and scalable web access for real-world data automation. Integrating Pica with Bright Data allows AI agents to leverage Bright Data's advanced web scraping and proxy network capabilities, enabling them to collect and process data from the web efficiently and effectively.

## Available Bright Data Tools

Bright Data offers the following tools for integration with Pica:

* **Scrapers**: Automate web data extraction with Bright Data's powerful Scrapers.
* **Web Unlocker API**: Access and retrieve data from websites that employ advanced anti-bot measures.

## How to Integrate Bright Data With Pica

<Steps>
  <Step title="Obtain Your Bright Data API Key">
    * Log in to your [Bright Data dashboard](https://brightdata.com/cp).
    * Go to [Account Settings](https://brightdata.com/cp/setting/users).
    * [Generate an API key](/api-reference/authentication#how-do-i-authenticate-with-api-key%3F) if you haven't already done so.
  </Step>

  <Step title="Install the Bright Data Integration">
    Install the Bright Data integration package for Pica by running the following command:

    ```sh theme={null}
    pip install pica-langchain
    ```

    <Note>
      Other available integrations include:

      * [Vercel AI SDK](https://docs.picaos.com/sdk/vercel-ai)
      * [MCP](https://docs.picaos.com/sdk/mcp)
    </Note>
  </Step>

  <Step title="Select your preferred Bright Data tool">
    [Pica connectors](https://www.picaos.com/community/connectors) for Bright Data include two main tools for integration:

    <CodeGroup>
      ```python Scrapers endpoint using Pica With LangChain theme={null}
      import os
      from langchain_openai import ChatOpenAI
      from langchain.agents import AgentType
      from pica_langchain import PicaClient, create_pica_agent
      from pica_langchain.models import PicaClientOptions

      def main():
        try:
            pica_client = PicaClient(
                secret=os.environ["PICA_SECRET"],
                options=PicaClientOptions(
                    connectors=["test::bright-data::default::fd583f2344fa414293bdda4f240258c1"] # Initialize all available connections or pass specific connector keys
                )
            )

            pica_client.initialize()
            
            llm = ChatOpenAI(
                temperature=0,
                model="gpt-4o",
            )

            # Create an agent with Pica tools
            agent = create_pica_agent(
                client=pica_client,
                llm=llm,
                agent_type=AgentType.OPENAI_FUNCTIONS,
            )

            # Execute a multi-step workflow using the GitHub Connector
            result = agent.invoke({
                "input": (
                    "Trigger Synchronous Web Scraping and Retrieve Results, use this dataset ID : gd_l7q7dkf244hwjntr0 and search for this URL : https://www.amazon.com/dp/B0D2Q9397Y?th=1&psc=1"
                )
            })
            
            print(f"\nWorkflow Result:\n {result}")
        
        except Exception as e:
            print(f"ERROR: An unexpected error occurred: {e}")


      if __name__ == "__main__":
        main()

      ```

      ```python Web Unlocker API through Pica & LangChain theme={null}
      import os
      from langchain_openai import ChatOpenAI
      from langchain.agents import AgentType
      from pica_langchain import PicaClient, create_pica_agent
      from pica_langchain.models import PicaClientOptions

      def main():
        try:
            pica_client = PicaClient(
                secret=os.environ["PICA_SECRET"],
                options=PicaClientOptions(
                    connectors=["test::bright-data::default::fd583f2344fa414293bdda4f240258c1"] # Initialize all available connections or pass specific connector keys
                )
            )

            pica_client.initialize()
            
            llm = ChatOpenAI(
                temperature=0,
                model="gpt-4o",
            )

            # Create an agent with Pica tools
            agent = create_pica_agent(
                client=pica_client,
                llm=llm,
                agent_type=AgentType.OPENAI_FUNCTIONS,
            )

            # Execute a multi-step workflow using the GitHub Connector
            result = agent.invoke({
                "input": (
                    "Unlock this site and provide me with the data : https://www.amazon.com/dp/B0D2Q9397Y?th=1&psc=1"
                )
            })
            
            print(f"\nWorkflow Result:\n {result}")
        
        except Exception as e:
            print(f"ERROR: An unexpected error occurred: {e}")


      if __name__ == "__main__":
        main()
      ```
    </CodeGroup>
  </Step>
</Steps>


# How to set up Bright Data with Playwright
Source: https://docs.brightdata.com/integrations/playwright

Configure Bright Data proxies (port 44445) in Playwright to route automated browser tests and scraping jobs through residential, datacenter or mobile IPs.

<Accordion title="Expand to get your Bright Data Proxy Access Information">
  ### Your proxy access information

  Bright Data proxies are grouped in "Proxy zones". Each zone holds the configuration for the proxies it holds.

  To get access to the proxy zone:

  1. Login to Bright Data control panel
  2. Select the proxy zone or setup a new one
  3. Click on the new zone name, and select the **Overview** tab.
  4. In the overview tab, under **Access details** you can find the proxy access details, and copy them to clipboard on click.
  5. You will need: Proxy Host, Proxy Port, Proxy Zone username and Proxy Zone password.
  6. Click on the copy icons to copy the text to your clipboard and paste in your tool's proxy configuration.

  ### Access Details Section Example

  <img alt="" />

  ### Residential proxy access

  To access Bright Data's **Residential Proxies** you must be a KYC-verified business account. Complete KYC verification with the Bright Data compliance team; there is no automatic or no-KYC path. Without KYC, use ISP or Datacenter proxies. [Read more...](/proxy-networks/residential/network-access)

  ### Targeting search engines?

  If you target a search engine like google, bing or yandex, you need a special Search Engine Results Page (**SERP**) proxy API. Use Bright Data SERP API to target search engines.
  [Click here to read more about Bright Data SERP proxy API.](/scraping-automation/serp-api/introduction)

  ### Correct setup of proxy test to avoid "PROXY ERROR"

  In many tools you will see a "test proxy" function, which performs a conncectivity test to your proxy, and some add a geolocation test as well, to identify the location of the proxy.
  To correctly test your proxy you should target those search queries to:
  `https://geo.brdtest.com/welcome.txt` .

  Some tools use popular search engines (like google.com) as a default test target. Bright Data will block those requests and you tool will show **proxy error** although your proxy is perfectly fine.

  If your proxy test fails, this is probably the reason. Make sure that your test domain is not a search engine (this is done in the tool configuration, and not controlled by Bright Data).
</Accordion>

<Warning>
  **Account management is not a supported use case** on the Bright Data platform as of April 1, 2026. This includes managing accounts on platforms like TikTok, Instagram, or similar services. Bright Data proxies cannot be used for this purpose. See [Acceptable Use Policy](https://brightdata.com/acceptable-use-policy) for details.
</Warning>

## What is Playwright?

Playwright is a versatile Node.js toolkit for automating popular browsers in one go. Whether you’re scraping data, testing applications, or building seamless automation flows, Playwright’s unified interface and robust features help you get more done in less time, without compromising quality.

<Tip>
  Maintain a consistent IP throughout your browser session by using the `-session` parameter in your username. This is essential because BrightData proxies default to rotating IPs with each request. [Learn more](/proxy-networks/faqs#how-to-use-the-same-ip-for-an-extended-period-of-time-and-how-long-can-i-keep-it-long-session)

  New users should begin with ISP or Datacenter proxies, which need no KYC. Residential proxies require a [KYC-verified business account](/proxy-networks/residential/network-access).
</Tip>

## How to Integrate Bright Data With Playwright

### Prerequisites

1. **Node.js**: Download and install the latest version from [nodejs.org](https://nodejs.org/).

2. **Playwright Package**: Add Playwright to your project:

3. **Bright Data Account**: You must have an active Bright Data account with at least one enabled proxy zone.\
   For browser automation use cases, **ISP or Data Center proxies are recommended** for better stability.

4. **Proxy Access Permissions**: Ensure your IP is allowlisted in the Bright Data dashboard (if IP whitelisting is enabled) and that your proxy zone is active.

5. **Supported Operating System**: Playwright is supported on the following operating systems:

   * macOS
   * Linux
   * Windows

   Make sure your system meets Playwright’s browser runtime requirements.

6. **Basic JavaScript Knowledge**: Familiarity with JavaScript, Node.js, and `async/await` syntax is recommended to correctly configure and manage Playwright scripts.

7. **Network Stability**: A stable internet connection is required to download browser binaries and maintain proxy connections during automation tasks.

```bash theme={null}
npm install playwright
```

### Get Your Bright Data Credentials

Log in to your [Bright Data dashboard](https://brightdata.com/cp/zones/page/plans) and note the following details:

* **Host**: [http://brd.superproxy.io/](http://brd.superproxy.io/)
* **Port**: `44445`
* **Username**: Enter your Bright Data `username`.
* **Password**: Enter your Bright Data `password`.

You’ll need these for proxy authentication.

### Configure Playwright to Use Bright Data

<Note>
  If you want to use Playwright with Bright Data's Browser API, please refer to the [Browser API documentation](/scraping-automation/scraping-browser/introduction) for correct setup and code examples. Proxy Integration guides below are for direct proxy integration, not for Browser API.
</Note>

1. **Set the Proxy Server**: Include your Bright Data host and port in the browser launch options. Use the format `host:port`.
2. **Add Authentication**: Provide your Bright Data **username** and **password** to ensure secure access.

### Ignoring SSL Errors

If you get SSL errors working our residential proxies or Web Unlocker API set: `ignoreHTTPSErrors: True` in your JS code. Alternatively - you can setup our certificate on your system or import it into your code. More access information can be found [here](/integrations/playwright#expand-to-get-your-bright-data-proxy-access-information).

### Example Code

```javascript theme={null}
import { chromium } from 'playwright';

// Bright Data proxy configuration
const BRIGHTDATA_HOST = process.env.BRIGHTDATA_HOST || 'brd.superproxy.io';
const BRIGHTDATA_PORT = process.env.BRIGHTDATA_PORT || '44445';
const BRIGHTDATA_USERNAME = process.env.BRIGHTDATA_USERNAME;
const BRIGHTDATA_PASSWORD = process.env.BRIGHTDATA_PASSWORD;

// Optional: use session to keep the same IP
const SESSION_ID = 'session_1';

(async () => {
  const browser = await chromium.launch({
    headless: true, // set to false for debugging
    proxy: {
      server: `http://${BRIGHTDATA_HOST}:${BRIGHTDATA_PORT}`,
      username: `${BRIGHTDATA_USERNAME}-session-${SESSION_ID}`,
      password: BRIGHTDATA_PASSWORD,
    },
  });

  const context = await browser.newContext({
    ignoreHTTPSErrors: true, // prevents SSL issues with residential / Unlocker proxies
  });

  const page = await context.newPage();

  // Verify proxy connection
  await page.goto('https://brdtest.com/myip.json', {
    waitUntil: 'networkidle',
    timeout: 60000,
  });

  const ipInfo = await page.textContent('pre');
  console.log('Proxy IP info:', ipInfo);

  // Navigate to target website
  await page.goto('https://example.com', {
    waitUntil: 'domcontentloaded',
  });

  console.log('Page title:', await page.title());

  // Optional screenshot for validation
  await page.screenshot({ path: 'playwright-brightdata.png' });

  await browser.close();
})();
```

With **Bright Data** integrated into **Playwright**, your automation is both secure and discreet. Enjoy faster workflows, reduced detection risks, and greater peace of mind as you scrape, test, and automate online tasks.


# How to set up Bright Data with Puppeteer
Source: https://docs.brightdata.com/integrations/puppeteer

Configure Bright Data proxies (port 44445) in Puppeteer to run headless Chrome with geo-targeted IPs for web scraping and automated testing in Node.js.

<Accordion title="Expand to get your Bright Data Proxy Access Information">
  ### Your proxy access information

  Bright Data proxies are grouped in "Proxy zones". Each zone holds the configuration for the proxies it holds.

  To get access to the proxy zone:

  1. Login to Bright Data control panel
  2. Select the proxy zone or setup a new one
  3. Click on the new zone name, and select the **Overview** tab.
  4. In the overview tab, under **Access details** you can find the proxy access details, and copy them to clipboard on click.
  5. You will need: Proxy Host, Proxy Port, Proxy Zone username and Proxy Zone password.
  6. Click on the copy icons to copy the text to your clipboard and paste in your tool's proxy configuration.

  ### Access Details Section Example

  <img alt="" />

  ### Residential proxy access

  To access Bright Data's **Residential Proxies** you must be a KYC-verified business account. Complete KYC verification with the Bright Data compliance team; there is no automatic or no-KYC path. Without KYC, use ISP or Datacenter proxies. [Read more...](/proxy-networks/residential/network-access)

  ### Targeting search engines?

  If you target a search engine like google, bing or yandex, you need a special Search Engine Results Page (**SERP**) proxy API. Use Bright Data SERP API to target search engines.
  [Click here to read more about Bright Data SERP proxy API.](/scraping-automation/serp-api/introduction)

  ### Correct setup of proxy test to avoid "PROXY ERROR"

  In many tools you will see a "test proxy" function, which performs a conncectivity test to your proxy, and some add a geolocation test as well, to identify the location of the proxy.
  To correctly test your proxy you should target those search queries to:
  `https://geo.brdtest.com/welcome.txt` .

  Some tools use popular search engines (like google.com) as a default test target. Bright Data will block those requests and you tool will show **proxy error** although your proxy is perfectly fine.

  If your proxy test fails, this is probably the reason. Make sure that your test domain is not a search engine (this is done in the tool configuration, and not controlled by Bright Data).
</Accordion>

<Warning>
  **Account management is not a supported use case** on the Bright Data platform as of April 1, 2026. This includes managing accounts on platforms like TikTok, Instagram, or similar services. Bright Data proxies cannot be used for this purpose. See [Acceptable Use Policy](https://brightdata.com/acceptable-use-policy) for details.
</Warning>

## What is Puppeteer?

Think of Puppeteer as a remote control for headless browsers. With just a few lines of Node.js code, you can direct browsers to gather information, run tests, and automate routine actions. It’s all about turning tough, time-consuming workflows into quick, manageable steps.

<Tip>
  Maintain a consistent IP throughout your browser session by using the `-session` parameter in your username. This is essential because BrightData proxies default to rotating IPs with each request. [Learn more](/proxy-networks/faqs#how-to-use-the-same-ip-for-an-extended-period-of-time-and-how-long-can-i-keep-it-long-session)

  New users should begin with ISP or Datacenter proxies, which need no KYC. Residential proxies require a [KYC-verified business account](/proxy-networks/residential/network-access).
</Tip>

## How to Integrate Bright Data With Puppeteer

### How to get started

Before integrating Bright Data, ensure you have the essentials:

1. **Node.js**: Install the latest version from [nodejs.org](https://nodejs.org/).

2. **Project Setup**: Use a code editor you prefer (such as VS Code) and initialize a Node.js project.

3. **Bright Data Account**: You must have an active Bright Data account with at least one enabled proxy zone.\
   For browser automation use cases, **ISP or Data Center proxies are recommended** for better stability.

4. **Basic JavaScript Knowledge**: Familiarity with JavaScript, Node.js, and `async/await` syntax is recommended to correctly configure and manage Playwright scripts.

5. **Network Stability**: A stable internet connection is required to download browser binaries and maintain proxy connections during automation tasks.

6. **Puppeteer**: Add Puppeteer to your project by running:

```bash theme={null}
npm install puppeteer
```

### Retrieve Your Bright Data Credentials

Sign in to your [Bright Data dashboard](https://brightdata.com/cp/zones/page/plans) and note down your proxy details:

• **Host**

• **Port**

• **Username**

• **Password**

These credentials will let Puppeteer route traffic through Bright Data’s secure, anonymous proxy network.

### Configure Puppeteer for Bright Data

<Note>
  If you want to use Puppeteer with Bright Data's Browser API, please refer to the [Browser API documentation](/scraping-automation/scraping-browser/introduction) for correct setup and code examples. Proxy Integration guides below are for direct proxy integration, not for Browser API.
</Note>

To connect Puppeteer with Bright Data:

1. **Set the Proxy Server**: Add `--proxy-server=[HOST]:[PORT]` to Puppeteer’s launch arguments.

2. **Authenticate**: Use `page.authenticate()` in Puppeteer to provide your Bright Data **username** and **password**.

### Example Code

Here’s a sample script to guide you:

```javascript theme={null}
const puppeteer = require('puppeteer');

const BRIGHTDATA_HOST = process.env.BRIGHTDATA_HOST || 'brd.superproxy.io';
const BRIGHTDATA_PORT = process.env.BRIGHTDATA_PORT || '44445';
const BRIGHTDATA_USERNAME = process.env.BRIGHTDATA_USERNAME;
const BRIGHTDATA_PASSWORD = process.env.BRIGHTDATA_PASSWORD;

// Optional: use a session to maintain the same IP
const SESSION_ID = 'session_1';

(async () => {
  const browser = await puppeteer.launch({
    headless: true, // set to false for debugging
    args: [
      `--proxy-server=http://${BRIGHTDATA_HOST}:${BRIGHTDATA_PORT}`
    ]
  });

  const page = await browser.newPage();

  // Authenticate with Bright Data
  await page.authenticate({
    username: `${BRIGHTDATA_USERNAME}-session-${SESSION_ID}`,
    password: BRIGHTDATA_PASSWORD,
  });

  // Verify proxy connection
  await page.goto('https://brdtest.com/myip.json', {
    waitUntil: 'networkidle2',
    timeout: 60000,
  });

  const ipInfo = await page.evaluate(() => document.body.innerText);
  console.log('Proxy IP info:', ipInfo);

  // Navigate to target website
  await page.goto('https://example.com', {
    waitUntil: 'domcontentloaded',
  });

  console.log('Page title:', await page.title());

  // Optional screenshot for verification
  await page.screenshot({ path: 'puppeteer-brightdata.png' });

  await browser.close();
})();
```

With Bright Data proxies integrated into Puppeteer, you gain secure and private browsing for all your automated tasks. Enjoy smoother data collection, reduced detection risks, and a more reliable workflow, so you can focus on insights and results, not on technical roadblocks.


# How to set up Bright Data with SaleFreaks
Source: https://docs.brightdata.com/integrations/salefreaks

Integrate Bright Data proxies (400M+ IPs) with SaleFreaks to manage dropshipping automation securely, protect seller accounts and reduce IP-related risks.

<Warning>
  **Account management is not a supported use case** on the Bright Data platform as of April 1, 2026. This includes managing accounts on platforms like TikTok, Instagram, or similar services. Bright Data proxies cannot be used for this purpose. See [Acceptable Use Policy](https://brightdata.com/acceptable-use-policy) for details.
</Warning>

<Accordion title="Expand to get your Bright Data Proxy Access Information">
  ### Your proxy access information

  Bright Data proxies are grouped in "Proxy zones". Each zone holds the configuration for the proxies it holds.

  To get access to the proxy zone:

  1. Login to Bright Data control panel
  2. Select the proxy zone or setup a new one
  3. Click on the new zone name, and select the **Overview** tab.
  4. In the overview tab, under **Access details** you can find the proxy access details, and copy them to clipboard on click.
  5. You will need: Proxy Host, Proxy Port, Proxy Zone username and Proxy Zone password.
  6. Click on the copy icons to copy the text to your clipboard and paste in your tool's proxy configuration.

  ### Access Details Section Example

  <img alt="" />

  ### Residential proxy access

  To access Bright Data's **Residential Proxies** you must be a KYC-verified business account. Complete KYC verification with the Bright Data compliance team; there is no automatic or no-KYC path. Without KYC, use ISP or Datacenter proxies. [Read more...](/proxy-networks/residential/network-access)

  ### Targeting search engines?

  If you target a search engine like google, bing or yandex, you need a special Search Engine Results Page (**SERP**) proxy API. Use Bright Data SERP API to target search engines.
  [Click here to read more about Bright Data SERP proxy API.](/scraping-automation/serp-api/introduction)

  ### Correct setup of proxy test to avoid "PROXY ERROR"

  In many tools you will see a "test proxy" function, which performs a conncectivity test to your proxy, and some add a geolocation test as well, to identify the location of the proxy.
  To correctly test your proxy you should target those search queries to:
  `https://geo.brdtest.com/welcome.txt` .

  Some tools use popular search engines (like google.com) as a default test target. Bright Data will block those requests and you tool will show **proxy error** although your proxy is perfectly fine.

  If your proxy test fails, this is probably the reason. Make sure that your test domain is not a search engine (this is done in the tool configuration, and not controlled by Bright Data).
</Accordion>

## What is SaleFreaks?

SaleFreaks is an automation platform built for dropshippers to manage online stores more efficiently. It helps automate key workflows such as product sourcing, order fulfillment, and inventory synchronization. SaleFreaks commonly integrates with marketplaces like eBay and Amazon, where stable IP usage is critical to avoid account flags or suspensions.

Using Bright Data proxies with SaleFreaks improves account safety, enables geo-targeted operations, and ensures long-term automation stability.

***

## Why Use Bright Data With SaleFreaks?

* **Account Protection**: Reduce the risk of marketplace bans by using dedicated, consistent IPs
* **Geo-Targeting**: Operate seller accounts from specific countries or cities
* **High Stability**: Dedicated datacenter or ISP proxies ensure uninterrupted automation
* **Scalability**: Manage multiple seller accounts with isolated proxy identities

***

## Steps to Integrate SaleFreaks With Bright Data Proxies

### Step 1. Sign Up to Bright Data

1. Log in to your Bright Data dashboard
2. Navigate to **Proxy & Scraping Infrastructure**
3. Click **Add** to create a new proxy **Zone**

<Frame>
  <img alt="add-zone-2.png" />
</Frame>

***

### Step 2. Select Proxy Type

For SaleFreaks, **Datacenter or ISP proxies** are recommended for maximum account stability.

<Frame>
  <img alt="Step 2. Select Proxy Type" />
</Frame>

***

### Step 3. Name the Proxy Zone

Choose a clear name for your proxy zone (for example, `salefreaks-ebay-us`).

<Frame>
  <img alt="select-ip-type.png" />
</Frame>

***

### Step 4. Select IP Count

Specify the number of IPs required.\
Best practice: **one IP per seller account**.

<Frame>
  <img alt="number-of-ips-1.png" />
</Frame>

***

### Step 5. Country & City Selection

Select the country and city that best match your marketplace region.

<Frame>
  <img alt="city-ip.png" />
</Frame>

***

### Step 6. Add the Zone

Click **Add** to create and activate the proxy zone.

<Frame>
  <img alt="click-add.png" />
</Frame>

***

### Step 7. Zone Is Ready

Click on the zone name to view configuration details.\
You can edit settings or add more proxies from the **Configuration** page.

<Frame>
  <img alt="zone-ready.png" />
</Frame>

***

### Step 8. Add a New Proxy Password

Navigate to **Access parameters** and click **Add password** to generate a new proxy password.

<Frame>
  <img alt="adding-new-pass.png" />
</Frame>

***

### Step 9. Open the Configuration Page

After adding a password, go back to the configuration page to manage IP access.

<Frame>
  <img alt="proxy-config.png" />
</Frame>

***

### Step 10. Review Allocated IPs

Click **Show allocated IPs** to view your assigned IP addresses.

<Frame>
  <img alt="allocated-ips.png" />
</Frame>

***

### Step 11. Download the IP List

Download the allocated IPs list for use in SaleFreaks.

<Frame>
  <img alt="download-ips.png" />
</Frame>

<Tip>
  If you added a new password, wait a few minutes before downloading the IP list to allow the password to sync correctly.
</Tip>

***

### Step 12. Open the IP File

Open the downloaded file in a text editor of your choice.

<Frame>
  <img alt="file-editor.png" />
</Frame>

***

### Step 13. Review Required Proxy Fields

Use the following values when configuring SaleFreaks:

* **Proxy Type**: `HTTP`
* **Proxy IP / Host**: `brd.superproxy.io`
* **Proxy Port**: `44445`
* **Proxy Username**:\
  `lum-customer-{your_customer_id}-zone-{your_zone}-ip-{allocated_ip}`
* **Proxy Password**:\
  Your generated proxy password

<Frame>
  <img alt="requried-fileds.png" />
</Frame>

***

### Step 14. Log In to SaleFreaks

Log in to your SaleFreaks account.\
When prompted to add a marketplace account, choose **Provide my own proxy**.

<Frame>
  <img alt="salefreaks-logins.png" />
</Frame>

***

### Step 15. Enter Proxy Details in SaleFreaks

Paste the proxy details from the Bright Data IP file into the SaleFreaks proxy fields.

<Frame>
  <img alt="fill-in-info.png" />
</Frame>

***

### Step 16. Enable Auto-Recharge (Recommended)

To avoid losing access to allocated IPs, enable **auto-recharge** in your Bright Data billing settings.

<Frame>
  <img alt="autorecharge.png" />
</Frame>

***

<Warning>
  **Important Note**

  If you are using Bright Data **Residential Proxies**, **Web Unlocker API**, or **SERP API**, you must install an SSL certificate to enable secure connections.

  Follow the instructions in this guide to complete the setup:\
  [https://docs.brightdata.com/general/account/ssl-certificate#installation-of-the-ssl-certificate](https://docs.brightdata.com/general/account/ssl-certificate#installation-of-the-ssl-certificate)
</Warning>

***

## Best Practices

* Use **one dedicated IP per seller account**
* Avoid reusing IPs across multiple marketplaces
* Monitor SaleFreaks logs for proxy-related errors
* Use ISP or Datacenter proxies for long-term account safety
* Keep auto-recharge enabled to prevent service interruptions

***

## Conclusion

By integrating Bright Data proxies with SaleFreaks, you create a stable and secure automation environment for dropshipping operations. This setup protects seller accounts, enables geo-specific workflows, and ensures reliable performance across sourcing, fulfillment, and inventory management, allowing you to scale your business with confidence.


# How to use Selenium with Bright Data
Source: https://docs.brightdata.com/integrations/selenium

Configure Bright Data proxies (port 44445) in Selenium Python to run browser automation with geo-targeted IPs across Chrome, Firefox and other webdrivers.

<Accordion title="Expand to get your Bright Data Proxy Access Information">
  ### Your proxy access information

  Bright Data proxies are grouped in "Proxy zones". Each zone holds the configuration for the proxies it holds.

  To get access to the proxy zone:

  1. Login to Bright Data control panel
  2. Select the proxy zone or setup a new one
  3. Click on the new zone name, and select the **Overview** tab.
  4. In the overview tab, under **Access details** you can find the proxy access details, and copy them to clipboard on click.
  5. You will need: Proxy Host, Proxy Port, Proxy Zone username and Proxy Zone password.
  6. Click on the copy icons to copy the text to your clipboard and paste in your tool's proxy configuration.

  ### Access Details Section Example

  <img alt="" />

  ### Residential proxy access

  To access Bright Data's **Residential Proxies** you must be a KYC-verified business account. Complete KYC verification with the Bright Data compliance team; there is no automatic or no-KYC path. Without KYC, use ISP or Datacenter proxies. [Read more...](/proxy-networks/residential/network-access)

  ### Targeting search engines?

  If you target a search engine like google, bing or yandex, you need a special Search Engine Results Page (**SERP**) proxy API. Use Bright Data SERP API to target search engines.
  [Click here to read more about Bright Data SERP proxy API.](/scraping-automation/serp-api/introduction)

  ### Correct setup of proxy test to avoid "PROXY ERROR"

  In many tools you will see a "test proxy" function, which performs a conncectivity test to your proxy, and some add a geolocation test as well, to identify the location of the proxy.
  To correctly test your proxy you should target those search queries to:
  `https://geo.brdtest.com/welcome.txt` .

  Some tools use popular search engines (like google.com) as a default test target. Bright Data will block those requests and you tool will show **proxy error** although your proxy is perfectly fine.

  If your proxy test fails, this is probably the reason. Make sure that your test domain is not a search engine (this is done in the tool configuration, and not controlled by Bright Data).
</Accordion>

<Warning>
  **Account management is not a supported use case** on the Bright Data platform as of April 1, 2026. This includes managing accounts on platforms like TikTok, Instagram, or similar services. Bright Data proxies cannot be used for this purpose. See [Acceptable Use Policy](https://brightdata.com/acceptable-use-policy) for details.
</Warning>

## What is Selenium?

Selenium is a powerful, open-source tool for automating web browsers. It supports multiple programming languages, including JavaScript, Python, and Java, and provides a robust API for controlling browser actions.

Selenium is widely used for:

* Web scraping
* Automated testing
* Browser-based workflows

With its flexibility and cross-browser compatibility, Selenium is an essential tool for developers and testers alike.

<Tip>
  Maintain a consistent IP throughout your browser session by using the <code>-session</code> parameter in your username.\
  This is essential because Bright Data proxies rotate IPs by default.

  Learn more:\
  [https://docs.brightdata.com/proxy-networks/faqs#how-to-use-the-same-ip-for-an-extended-period-of-time-and-how-long-can-i-keep-it-long-session](https://docs.brightdata.com/proxy-networks/faqs#how-to-use-the-same-ip-for-an-extended-period-of-time-and-how-long-can-i-keep-it-long-session)

  <br />

  <br />

  New users should begin with **ISP** or **Datacenter** proxies, which need no KYC.\
  Residential proxies require a KYC-verified business account:
  [https://docs.brightdata.com/proxy-networks/residential/network-access](https://docs.brightdata.com/proxy-networks/residential/network-access)
</Tip>

## How to Integrate Bright Data with Selenium

### Step 0: Prerequisites

Before starting, ensure you have the following:

1. **Python installed**\
   Download the latest version from [https://www.python.org/](https://www.python.org/)

2. **Install Selenium**
   ```bash theme={null}
   pip install selenium
   ```

3. **Bright Data proxy credentials**\
   Get your host, port, username, and password from the [Bright Data Control Panel](https://brightdata.com/cp/zones/page/plans)

4. **WebDriver installed**\
   Download the appropriate driver for your browser\
   Example (Chrome): [https://developer.chrome.com/docs/chromedriver/](https://developer.chrome.com/docs/chromedriver/)

5. **Optional: WebDriver Manager**\
   For easier driver setup:
   ```bash theme={null}
   pip install webdriver-manager
   ```

<Note>
  If you want to use Selenium with Bright Data's **Browser API**, refer to the official documentation: [https://docs.brightdata.com/scraping-automation/scraping-browser/introduction](https://docs.brightdata.com/scraping-automation/scraping-browser/introduction)

  The steps below apply to direct proxy integration, not Browser API usage.
</Note>

### Step 1: Import Required Libraries

```python theme={null}
from selenium import webdriver
from selenium.webdriver.chrome.service import Service
from selenium.webdriver.chrome.options import Options
from webdriver_manager.chrome import ChromeDriverManager
```

### Step 2: Configure Your Bright Data Proxy

```python theme={null}
# Bright Data Proxy Configuration
proxy_host = "brd.superproxy.io"
proxy_port = "port"          # Replace with your port
proxy_username = "username"  # Replace with your Bright Data username
proxy_password = "password"  # Replace with your Bright Data password
 
# Full proxy URL
proxy = f"http://{proxy_username}:{proxy_password}@{proxy_host}:{proxy_port}"
```

### Step 3: Set Up Chrome Options

```python theme={null}
chrome_options = Options()
chrome_options.add_argument(f"--proxy-server={proxy}")
```

### Step 4: Initialize the WebDriver

```python theme={null}
service = Service(ChromeDriverManager().install())
driver = webdriver.Chrome(service=service, options=chrome_options)
```

### Step 5: Test the Proxy Connection

```python theme={null}
print("Connecting to target website...")
driver.get("http://httpbin.org/ip")
 
print("Page content:")
print(driver.page_source)
 
driver.quit()
```

### Step 6: Verify the Output

If the proxy is working correctly, you'll see an IP address similar to:

```json theme={null}
{
  "origin": "123.45.67.89"
}
```

## Summary

By integrating Bright Data proxies with Selenium, you can automate browser workflows securely and efficiently.

This setup is ideal for:

* Testing web applications
* Scraping dynamic content
* Accessing geo-restricted websites

Bright Data ensures reliability, anonymity, and scalability, helping you build smarter automation workflows with Selenium.


# Set up Bright Data with StablerSOLO
Source: https://docs.brightdata.com/integrations/stablersolo

Configure Bright Data proxies (400M+ IPs) inside StablerSOLO antidetect profiles to run sneaker and ecommerce automation with geo-targeted residential IPs.

<Warning>
  **Account management is not a supported use case** on the Bright Data platform as of April 1, 2026. This includes managing accounts on platforms like TikTok, Instagram, or similar services. Bright Data proxies cannot be used for this purpose. See [Acceptable Use Policy](https://brightdata.com/acceptable-use-policy) for details.
</Warning>

<Accordion title="Expand to get your Bright Data Proxy Access Information">
  ### Your proxy access information

  Bright Data proxies are grouped in "Proxy zones". Each zone holds the configuration for the proxies it holds.

  To get access to the proxy zone:

  1. Login to Bright Data control panel
  2. Select the proxy zone or setup a new one
  3. Click on the new zone name, and select the **Overview** tab.
  4. In the overview tab, under **Access details** you can find the proxy access details, and copy them to clipboard on click.
  5. You will need: Proxy Host, Proxy Port, Proxy Zone username and Proxy Zone password.
  6. Click on the copy icons to copy the text to your clipboard and paste in your tool's proxy configuration.

  ### Access Details Section Example

  <img alt="" />

  ### Residential proxy access

  To access Bright Data's **Residential Proxies** you must be a KYC-verified business account. Complete KYC verification with the Bright Data compliance team; there is no automatic or no-KYC path. Without KYC, use ISP or Datacenter proxies. [Read more...](/proxy-networks/residential/network-access)

  ### Targeting search engines?

  If you target a search engine like google, bing or yandex, you need a special Search Engine Results Page (**SERP**) proxy API. Use Bright Data SERP API to target search engines.
  [Click here to read more about Bright Data SERP proxy API.](/scraping-automation/serp-api/introduction)

  ### Correct setup of proxy test to avoid "PROXY ERROR"

  In many tools you will see a "test proxy" function, which performs a conncectivity test to your proxy, and some add a geolocation test as well, to identify the location of the proxy.
  To correctly test your proxy you should target those search queries to:
  `https://geo.brdtest.com/welcome.txt` .

  Some tools use popular search engines (like google.com) as a default test target. Bright Data will block those requests and you tool will show **proxy error** although your proxy is perfectly fine.

  If your proxy test fails, this is probably the reason. Make sure that your test domain is not a search engine (this is done in the tool configuration, and not controlled by Bright Data).
</Accordion>

## What is StablerSOLO?

**StablerSOLO** is a low-code data extraction and web scraping platform that allows developers, analysts, and data teams to configure and run scrapers without writing custom code for every target. It simplifies large-scale data collection while maintaining flexibility for advanced scraping needs.

When combined with Bright Data proxies, StablerSOLO delivers higher success rates, stronger anonymity, and reliable access to geo-restricted content.

***

## Why Use Bright Data With StablerSOLO?

* **Enhanced Anonymity**: Protect your real IP address during scraping operations
* **Geo-Targeted Access**: Collect region-specific data using country- or city-level proxies
* **Higher Success Rates**: Reduce blocks and CAPTCHAs with premium proxy IPs
* **Scalable Extraction**: Run large-scale scraping tasks reliably

***

## How to Integrate Bright Data With StablerSOLO

<Steps>
  <Step title="Prerequisites">
    Before you begin, ensure you have:

    * An active StablerSOLO account
    * An active Bright Data account
    * A configured Bright Data proxy zone (ISP or Datacenter recommended)
    * Your Bright Data proxy credentials (host, port, username, password)
  </Step>

  <Step title="Access StablerSOLO Proxy Configuration">
    1. Log in to your [StablerSOLO account](https://stabler.tech/).
    2. From the main dashboard, scroll down to the **Recent Proxies** section.
    3. Click **New Proxy** to open the proxy configuration window.

    <Frame>
      <img alt="How to Integrate Bright Data With StablerSOLO" />
    </Frame>
  </Step>

  <Step title="Add Bright Data Proxy Details">
    1. In the proxy configuration window:
       * Switch to the **Proxies List** tab.
       * Enter your Bright Data proxy credentials in the following format:

    Example:

    2. Click **Test a Proxy Randomly** to verify connectivity.
    3. Once the test succeeds, click **Add New Proxy** to save the proxy.

    <Note>
      To maintain a consistent IP, append a session parameter to your username\
      (for example, `username-session-1`).

      For geo-targeted scraping, format the username as\
      `username-country-XX` (for example, `username-country-US`).
    </Note>
  </Step>

  <Step title="Apply the Proxy to Scraping Jobs">
    1. Select the newly added proxy when configuring your scraping tasks.
    2. Run a small test extraction to confirm successful data retrieval.
    3. Monitor execution logs for stability and performance.
  </Step>
</Steps>

***

## Best Practices

* Use **ISP or Datacenter proxies** for long-running scraping jobs
* Assign separate proxies for different target websites or regions
* Avoid excessive parallel requests from a single proxy
* Rotate sessions periodically for large-scale extraction
* Monitor StablerSOLO logs for proxy-related errors

***

## Conclusion

By integrating Bright Data with StablerSOLO, you create a secure, scalable, and geo-flexible data extraction setup. This integration improves scraping success rates, minimizes detection risks, and enables reliable data collection across regions and platforms. With your proxy configuration complete, you’re ready to scale your data workflows with confidence.


# Set up Bright Data with Strands Agents
Source: https://docs.brightdata.com/integrations/strands

Use Bright Data with Strands Agents to add reliable web scraping and proxy capabilities to open-source Python AI agent workflows.

<Card title="Building an AI startup?" href="https://brightdata.com/ai/ai-startups-program" icon="rocket-launch">
  You might be eligible for our Startup Program. Get fully funded access to the infrastructure you're reading about right now (up to \$20K value).
</Card>

Strands Agents is an open-source Python library that provides a unified toolkit for developing autonomous AI agents. It bridges the gap between large language models and practical applications by offering ready-to-use tools for file operations, system execution, API interactions, mathematical operations, and more.

## Steps to Get Started

<Steps>
  <Step title="Prerequisites">
    * Bright Data API Key
    * Python 3.10+
  </Step>

  <Step title="Installation">
    Set up the strands-agents-tools package by either using the quick pip install or the full development installation with virtual environment and pre-commit hooks.

    ```bash Quick Install theme={null}
    pip install strands-agents-tools
    ```
  </Step>

  <Step title="Set the environment variable">
    Set your Bright Data API key and unlocker zone as an environment variables:

    ```bash theme={null}
    export BRIGHT_DATA_API_KEY="your_api_key_here"
    export BRIGHT_DATA_ZONE="your_unlocker_zone_here"
    ```
  </Step>

  <Step title="Bright Data Usage Examples">
    <Tabs>
      <Tab title="Using bright data tools within an agent">
        <CodeGroup>
          ```py Sample Code theme={null}
          from strands import Agent
          from strands.models.litellm import LiteLLMModel
          import strands_tools.bright_data as bright_data
          import os
          from dotenv import load_dotenv


          load_dotenv()


          def main():
          load_dotenv()
          print("🔍 Testing Bright Data Tool with OpenAI GPT-4o via LiteLLM")
          print("=" * 50)

          # Configure OpenAI model via LiteLLM
          openai_model = LiteLLMModel(
              client_args={
                  "api_key": os.getenv("OPENAI_API_KEY"), 
              },
              model_id="openai/gpt-4o",
          )

          # Create agent with LiteLLM model and bright_data tool
          agent = Agent(
              model=openai_model,
              tools=[bright_data],
              system_prompt="you are a helpful Web Search assistant, whenever user asks you to search the web you will use avilable tools, always set zone name to 'unlocker'"
          )

          # Test the bright_data tool with a relevant query
          print("Testing web scraping...")
          result = agent("Please scrape the content from https://example.com and return it as markdown")
          print(f'\n\nScraping Result:\n{result}')

          print("\n" + "=" * 50)
          print("Testing web search...")
          result2 = agent("Please search Google for 'Python programming tutorials")
          print(f'\n\nSearch Result:\n{result2}')


          if __name__ == "__main__":
          main()
          ```

          ```md Sample Output theme={null}
          🔍 Testing Bright Data Tool with OpenAI GPT-4o via LiteLLM
          =================================================
          Testing web scraping...

          Tool #1: bright_data  
          [Bright Data] Request: https://example.com/  
          Here is the scraped content from [example.com](https://example.com/) in Markdown format:

          # Example Domain

          This domain is for use in illustrative examples in documents. You may use this domain in literature without prior coordination or asking for permission.

          [More information...](https://www.iana.org/domains/example)

          Scraping Result:  
          Here is the scraped content from [example.com](https://example.com/) in Markdown format:

          # Example Domain

          This domain is for use in illustrative examples in documents. You may use this domain in literature without prior coordination or asking for permission.

          [More information...](https://www.iana.org/domains/example)

          ==================================================
          Testing web search...

          Tool #2: bright_data  
          [Bright Data] Request: https://www.google.com/search?q=Python%20programming%20tutorials&num=10

          Here are some search results for "Python programming tutorials" from Google:
          1. **The Python Tutorial | Python documentation** - This is an official tutorial from the Python documentation introducing basic concepts and features of the Python language. [Link to tutorial](https://docs.python.org/3/tutorial/index.html).
          2. **Python Tutorial | W3Schools** - A popular platform to learn Python, covering everything from basic syntax to more advanced topics. Start learning Python now. [Link to W3Schools Python](https://www.w3schools.com/python/).
          3. **Python Full Course for Beginners | YouTube by Programming with Mosh** - A comprehensive YouTube tutorial to learn Python from scratch. [Watch on YouTube](https://www.youtube.com/watch?v=K5KVEU3aaeQ).
          4. **Python For Beginners | Python.org** - Contains a list of tutorials suitable for experienced programmers on the BeginnersGuide/Tutorials page. [Getting started with Python](https://www.python.org/about/gettingstarted/).
          5. **Learn Python - Free Interactive Python Tutorial** - An interactive coding environment provided by DataCamp to learn Python with hands-on challenges. [Explore LearnPython.org](https://www.learnpython.org).
          6. **Python Tutorial | TutorialsPoint** - Offers a complete understanding of Python programming language from basic concepts to more advanced. [Read more on TutorialsPoint](https://www.tutorialspoint.com/python/index.htm).
          7. **Python Tutorial | GeeksforGeeks** - Provides the latest Python 3.13 version compiler and tutorials, where you can edit and compile code directly. [Visit GeeksforGeeks Python Tutorial](https://www.geeksforgeeks.org/python/python-programming-language-tutorial/).

          These resources should help you get started with Python programming or deepen your existing knowledge.
          ```
        </CodeGroup>
      </Tab>

      <Tab title="Direct tool invocation">
        ```py theme={null}
        from strands import Agent
        from strands.models.litellm import LiteLLMModel
        import strands_tools.bright_data as bright_data
        import os
        from dotenv import load_dotenv


        load_dotenv()


        def main():
          load_dotenv()
          print("🔍 Testing Bright Data Tool with OpenAI GPT-4o via LiteLLM")
          print("=" * 50)
          
          # Configure OpenAI model via LiteLLM
          openai_model = LiteLLMModel(
              client_args={
                  "api_key": os.getenv("OPENAI_API_KEY"), 
              },
              model_id="openai/gpt-4o",
          )
          
          # Create agent with LiteLLM model and bright_data tool
          agent = Agent(
              model=openai_model,
              tools=[bright_data],
              system_prompt="you are a helpful Web Search assistant, whenever user asks you to search the web you will use avilable tools, always set zone name to 'unblocker'"
          )
          
          # Test the bright_data tool with a relevant query
          print("Testing web scraping...")
          result = agent.tool.bright_data(
          action="scrape_as_markdown",
          url="https://example.com",
          zone="unblocker"
        )
          print(f'\n\nScraping Result:\n{result}')
          
          print("\n" + "=" * 50)
          print("Testing web search...")
          result2 = agent.tool.bright_data(
          action="search_engine",
          query="Python programming tutorials",
          engine="google",
          zone="unblocker"
          )
          print(f'\n\nSearch Result:\n{result2}')


          result5 = agent.tool.bright_data(
              action="web_data_feed",
              source_type="amazon_product",
              url="https://www.amazon.com/dp/B0D2Q9397Y?th=1"
          )
          print(f'\n\nAmazon Product Data:\n{result5}')


        if __name__ == "__main__":
          main()
        ```
      </Tab>
    </Tabs>
  </Step>
</Steps>


# Systems integrations
Source: https://docs.brightdata.com/integrations/systems-integrations

Configure Bright Data proxies at the operating system level for device-wide routing on Android, iOS, Windows and macOS, with step-by-step setup per platform.

<CardGroup>
  <Card title="Android" icon="https://mintcdn.com/brightdata/jeaQWxFKde5jgPN8/images/integrations/android1.png?fit=max&auto=format&n=jeaQWxFKde5jgPN8&q=85&s=ed6ff1b2944f28968813081ee5df151c" href="/integrations/android">
    Set up Bright Data proxies on Android devices for mobile traffic routing.
  </Card>

  <Card title="iOS" icon="https://mintcdn.com/brightdata/pq7wn7mJJj8UJsym/images/integrations/iphone1.png?fit=max&auto=format&n=pq7wn7mJJj8UJsym&q=85&s=6513a41e615963d671f44a3a11aa9a9e" href="/integrations/ios">
    Configure Bright Data proxies on iPhone and iPad devices.
  </Card>

  <Card title="macOS" icon="https://mintcdn.com/brightdata/pq7wn7mJJj8UJsym/images/integrations/macos1.png?fit=max&auto=format&n=pq7wn7mJJj8UJsym&q=85&s=f2c5b563ce602aeb7118d2295c9814cc" href="/integrations/macos">
    Set up system-wide proxy routing on macOS with Bright Data.
  </Card>

  <Card title="Ubuntu" icon="linux" href="/integrations/ubuntu">
    Configure Bright Data proxies on Ubuntu and Debian-based Linux systems.
  </Card>

  <Card title="Windows" icon="https://mintcdn.com/brightdata/z2V3XghEDR2bikNt/images/integrations/windows1.png?fit=max&auto=format&n=z2V3XghEDR2bikNt&q=85&s=10ee3b06b6304857e1fc7198d749fe6b" href="/integrations/windows">
    Set up system-wide proxy routing on Windows with Bright Data.
  </Card>
</CardGroup>


# How to set up Bright Data with TexAu
Source: https://docs.brightdata.com/integrations/texau

Configure Bright Data proxies (400M+ IPs) in TexAu to scale social outreach and lead-gen automations with geo-targeted IPs and reduced ban risk.

<Accordion title="Expand to get your Bright Data Proxy Access Information">
  ### Your proxy access information

  Bright Data proxies are grouped in "Proxy zones". Each zone holds the configuration for the proxies it holds.

  To get access to the proxy zone:

  1. Login to Bright Data control panel
  2. Select the proxy zone or setup a new one
  3. Click on the new zone name, and select the **Overview** tab.
  4. In the overview tab, under **Access details** you can find the proxy access details, and copy them to clipboard on click.
  5. You will need: Proxy Host, Proxy Port, Proxy Zone username and Proxy Zone password.
  6. Click on the copy icons to copy the text to your clipboard and paste in your tool's proxy configuration.

  ### Access Details Section Example

  <img alt="" />

  ### Residential proxy access

  To access Bright Data's **Residential Proxies** you must be a KYC-verified business account. Complete KYC verification with the Bright Data compliance team; there is no automatic or no-KYC path. Without KYC, use ISP or Datacenter proxies. [Read more...](/proxy-networks/residential/network-access)

  ### Targeting search engines?

  If you target a search engine like google, bing or yandex, you need a special Search Engine Results Page (**SERP**) proxy API. Use Bright Data SERP API to target search engines.
  [Click here to read more about Bright Data SERP proxy API.](/scraping-automation/serp-api/introduction)

  ### Correct setup of proxy test to avoid "PROXY ERROR"

  In many tools you will see a "test proxy" function, which performs a conncectivity test to your proxy, and some add a geolocation test as well, to identify the location of the proxy.
  To correctly test your proxy you should target those search queries to:
  `https://geo.brdtest.com/welcome.txt` .

  Some tools use popular search engines (like google.com) as a default test target. Bright Data will block those requests and you tool will show **proxy error** although your proxy is perfectly fine.

  If your proxy test fails, this is probably the reason. Make sure that your test domain is not a search engine (this is done in the tool configuration, and not controlled by Bright Data).
</Accordion>

<Warning>
  **Account management is not a supported use case** on the Bright Data platform as of April 1, 2026. This includes managing accounts on platforms like TikTok, Instagram, or similar services. Bright Data proxies cannot be used for this purpose. See [Acceptable Use Policy](https://brightdata.com/acceptable-use-policy) for details.
</Warning>

## What is TexAu?

TexAu is a growth automation platform designed to help marketers and businesses scale lead generation, outreach, and online engagement. It automates actions across social networks and websites, allowing you to run workflows efficiently without manual intervention. When combined with Bright Data proxies, TexAu provides improved anonymity, geo-targeting capabilities, and reduced risk of IP bans.

<Tip>
  Maintain a consistent IP throughout your automation session by using the `-session` parameter in your username. Bright Data proxies rotate IPs by default.\
  [Learn more](/proxy-networks/faqs#how-to-use-the-same-ip-for-an-extended-period-of-time-and-how-long-can-i-keep-it-long-session)

  New users should begin with ISP or Datacenter proxies, which need no KYC. Residential proxies require a [KYC-verified business account](/proxy-networks/residential/network-access).
</Tip>

***

## Why Use Bright Data With TexAu?

* **Enhanced Privacy**: Hide your real IP address while running automation tasks.
* **Geo-Targeted Access**: Collect location-specific data using country- or city-level proxies.
* **Improved Stability**: Reduce blocks and interruptions during long-running workflows.
* **Account Safety**: Isolate accounts with dedicated IPs to minimize risk.

***

## How to Integrate Bright Data With TexAu

Follow the steps below to configure Bright Data proxies in TexAu.

### Prerequisites

Before you begin, ensure you have:

* An active TexAu account
* An active Bright Data account
* A configured Bright Data proxy zone (ISP or Data Center recommended)
* Your Bright Data proxy credentials (host, port, username, password)

***

### Step 1. Log In to TexAu

1. Visit the [TexAu website](https://texau.com/) and sign in to your account.
2. From the dashboard, access your automation workspace.

***

### Step 2. Open Proxy Configuration Settings

1. From the dashboard, navigate to **Preferences** in the left-hand menu.
2. Select the **Proxies** tab.
3. Click **New Proxy** to add a new proxy configuration.

<Frame>
  <img alt="Step 2. Open Proxy Configuration Settings" />
</Frame>

***

### Step 3. Add Your Bright Data Proxy Details

Fill in the proxy details using the information from your Bright Data dashboard:

* **Host**: `brd.superproxy.io`
* **Port**: Use the port assigned to your proxy zone
* **Username**: Your Bright Data username\
  *(Optionally append `-session-<id>` to maintain a consistent IP)*
* **Password**: Your Bright Data password

After entering the details, click **Test Proxy** to verify the connection.

<Note>
  If you are using geo-targeted proxies, format your username as\
  `your-username-country-XX` (for example, `your-username-country-US`)\
  to target a specific country.
</Note>

***

### Step 4. Save and Apply the Proxy

Once the proxy test is successful:

1. Click **Save** to store the proxy configuration.
2. Assign the proxy to your automation workflows or accounts as needed.

TexAu will now route all automation traffic through Bright Data proxies.

***

## Best Practices

* Use one proxy per account for account-based automation
* Avoid running too many automations concurrently on the same proxy
* Start with low execution limits and scale gradually
* Monitor TexAu logs for proxy-related errors
* Rotate sessions periodically for long-running workflows

***

## Conclusion

By integrating Bright Data with TexAu, you gain a secure, reliable, and scalable automation setup. This combination helps protect your identity, access geo-specific data, and maintain stable performance across all your growth and engagement workflows. With the technical setup complete, you can focus on driving results with confidence.


# How to set up Bright Data on Ubuntu
Source: https://docs.brightdata.com/integrations/ubuntu

Step-by-step guide to configuring Bright Data proxies (port 44445) on Ubuntu for terminal commands and apps, with environment variables and system-wide setup.

<Accordion title="Expand to get your Bright Data Proxy Access Information">
  ### Your proxy access information

  Bright Data proxies are grouped in "Proxy zones". Each zone holds the configuration for the proxies it holds.

  To get access to the proxy zone:

  1. Login to Bright Data control panel
  2. Select the proxy zone or setup a new one
  3. Click on the new zone name, and select the **Overview** tab.
  4. In the overview tab, under **Access details** you can find the proxy access details, and copy them to clipboard on click.
  5. You will need: Proxy Host, Proxy Port, Proxy Zone username and Proxy Zone password.
  6. Click on the copy icons to copy the text to your clipboard and paste in your tool's proxy configuration.

  ### Access Details Section Example

  <img alt="" />

  ### Residential proxy access

  To access Bright Data's **Residential Proxies** you must be a KYC-verified business account. Complete KYC verification with the Bright Data compliance team; there is no automatic or no-KYC path. Without KYC, use ISP or Datacenter proxies. [Read more...](/proxy-networks/residential/network-access)

  ### Targeting search engines?

  If you target a search engine like google, bing or yandex, you need a special Search Engine Results Page (**SERP**) proxy API. Use Bright Data SERP API to target search engines.
  [Click here to read more about Bright Data SERP proxy API.](/scraping-automation/serp-api/introduction)

  ### Correct setup of proxy test to avoid "PROXY ERROR"

  In many tools you will see a "test proxy" function, which performs a conncectivity test to your proxy, and some add a geolocation test as well, to identify the location of the proxy.
  To correctly test your proxy you should target those search queries to:
  `https://geo.brdtest.com/welcome.txt` .

  Some tools use popular search engines (like google.com) as a default test target. Bright Data will block those requests and you tool will show **proxy error** although your proxy is perfectly fine.

  If your proxy test fails, this is probably the reason. Make sure that your test domain is not a search engine (this is done in the tool configuration, and not controlled by Bright Data).
</Accordion>

<Warning>
  **Account management is not a supported use case** on the Bright Data platform as of April 1, 2026. This includes managing accounts on platforms like TikTok, Instagram, or similar services. Bright Data proxies cannot be used for this purpose. See [Acceptable Use Policy](https://brightdata.com/acceptable-use-policy) for details.
</Warning>

## Why Use Bright Data on Ubuntu?

Routing traffic through Bright Data proxies on Ubuntu gives you enhanced privacy and the ability to access content from specific locations. Whether you're running scripts, managing remote servers, or using CLI tools, Bright Data ensures secure and efficient connections.

<Tip>
  Maintain a consistent IP throughout your browser session by using the `-session` parameter in your username. This is essential because BrightData proxies default to rotating IPs with each request. [Learn more](/proxy-networks/faqs#how-to-use-the-same-ip-for-an-extended-period-of-time-and-how-long-can-i-keep-it-long-session) <br />

  New users should begin with ISP or Datacenter proxies, which need no KYC. Residential proxies require a [KYC-verified business account](/proxy-networks/residential/network-access).
</Tip>

## How to set up Bright Data on Ubuntu

<Step title="Prerequisites">
  Before you begin, ensure you have:

  * An Ubuntu system (18.04 or later recommended)
  * An active Bright Data account
  * Bright Data proxy credentials (host, port, username, password)
</Step>

**Step 1. Open Your Terminal**

1. Press **Ctrl+Alt+T** to open the Terminal.

**Step 2. Set Proxy Environment Variables**

1. Replace `[HOST]`, `[PORT]`, `[USERNAME]`, and `[PASSWORD]` with your Bright Data details.
2. Run the following commands:

```bash theme={null}
export http_proxy="http://[USERNAME]:[PASSWORD]@[HOST]:[PORT]"
export https_proxy="http://[USERNAME]:[PASSWORD]@[HOST]:[PORT]"
```

Use the following commands for SOCKS5 configuration:

```bash theme={null}
export socks_proxy="socks5://[USERNAME]:[PASSWORD]@[HOST]:[PORT]"
```

If you need a country-specific exit node, modify `[USERNAME]` accordingly (e.g., `your-username-country-US`).

**Step 3. Verify Your Proxy Configuration**&#x20;

1. Test the proxy setup by running:

```bash theme={null}
curl http://httpbin.org/ip
```

2. The output should display the IP address assigned by Bright Data.

**Step 4. Make Proxy Settings Persistent (Optional)**

To apply the proxy settings across sessions:

1. Open the `.bashrc` file in your home directory:

```bash theme={null}
nano ~/.bashrc
```

2. Add the following lines at the end of the file:

```bash theme={null}
export http_proxy="http://[USERNAME]:[PASSWORD]@[HOST]:[PORT]"
export https_proxy="http://[USERNAME]:[PASSWORD]@[HOST]:[PORT]"
export socks_proxy="socks5://[USERNAME]:[PASSWORD]@[HOST]:[PORT]"
```

3. Save and exit (`Ctrl+O`, `Enter`, `Ctrl+X`).
4. Reload the file to apply the changes:

```bash theme={null}
source ~/.bashrc
```

## Best Practices

* Use **ISP or Datacenter proxies** for long-running scripts
* Append `-session-<id>` to usernames for IP consistency
* Avoid committing proxy credentials to version control
* Reapply proxy settings after system updates

By integrating Bright Data with Ubuntu, you can seamlessly manage your connections with enhanced privacy and security. Whether you're performing routine tasks or accessing geo-specific content, Bright Data ensures a smooth and reliable experience. Try it out and enjoy worry-free browsing!


# Set up Bright Data with Vercel AI SDK
Source: https://docs.brightdata.com/integrations/vercel-ai-sdk

How to integrate Bright Data's web scraping and proxy capabilities with Vercel AI SDK to add real-time web data access to AI applications. Spans 195 countries.

<Card title="Building an AI startup?" href="https://brightdata.com/ai/ai-startups-program" icon="rocket-launch">
  You might be eligible for our Startup Program. Get fully funded access to the infrastructure you're reading about right now (up to \$50K value).
</Card>

Vercel AI SDK is a TypeScript toolkit for building AI applications with React, Next.js, Vue, Svelte, Node.js, and more. It provides a unified API for working with different AI providers and includes utilities for streaming, function calling, and building conversational interfaces.

The `@brightdata/ai-sdk` package gives you drop-in tools for web scraping, search, and structured dataset collection, no manual wiring required.

## Steps to Get Started

<Steps>
  <Step title="Prerequisites">
    * Bright Data API Key, get yours from the [Bright Data Dashboard](https://brightdata.com/cp)
    * Node.js 18+
    * TypeScript (recommended)
  </Step>

  <Step title="Installation">
    Install the Bright Data AI SDK package alongside the Vercel AI SDK:

    ```bash theme={null} theme={null}
    npm install @brightdata/ai-sdk ai zod
    ```

    Set your API key as an environment variable:

    ```bash .env.local theme={null} theme={null}
    BRIGHTDATA_API_KEY=your_api_key_here
    ```
  </Step>

  <Step title="Import and Use">
    Import the tools you need directly from `@brightdata/ai-sdk` and pass them to any Vercel AI SDK call.
    No additional setup files or wrappers needed, each tool is a factory function that reads your API key
    automatically from `BRIGHTDATA_API_KEY`.

    ```typescript theme={null} theme={null}
    import { scrape, search, amazon_product, linkedin_profile } from '@brightdata/ai-sdk'
    import { generateText, stepCountIs } from 'ai'
    import { openai } from '@ai-sdk/openai'

    const { text } = await generateText({
      model: openai('gpt-4o'),
      prompt: 'Scrape https://news.ycombinator.com and summarize the top 5 stories',
      tools: {
        scrape: scrape(),
      },
      stopWhen: stepCountIs(5),
    })

    console.log(text)
    ```
  </Step>

  <Step title="Usage Examples">
    <Tabs>
      <Tab title="Next.js App Router">
        Create an API route that uses Bright Data tools with any AI provider:

        ```typescript app/api/chat/route.ts theme={null} theme={null}
        import { openai } from '@ai-sdk/openai'
        import { streamText, stepCountIs } from 'ai'
        import { scrape, search } from '@brightdata/ai-sdk'

        export const maxDuration = 60

        export async function POST(req: Request) {
          const { messages } = await req.json()

          const result = streamText({
            model: openai('gpt-4o'),
            messages,
            tools: {
              scrape: scrape(),
              search: search(),
            },
            stopWhen: stepCountIs(10),
          })

          return result.toDataStreamResponse()
        }
        ```

        Then use it in your component:

        ```typescript app/page.tsx theme={null} theme={null}
        'use client'

        import { useChat } from 'ai/react'

        export default function Chat() {
          const { messages, input, handleInputChange, handleSubmit } = useChat()

          return (
            <div className="flex flex-col h-screen">
              <div className="flex-1 overflow-y-auto p-4">
                {messages.map((m) => (
                  <div key={m.id} className="mb-4">
                    <strong>{m.role === 'user' ? 'You: ' : 'AI: '}</strong>
                    {m.content}
                  </div>
                ))}
              </div>
              <form onSubmit={handleSubmit} className="p-4 border-t">
                <input
                  value={input}
                  onChange={handleInputChange}
                  placeholder="Try: 'Scrape https://example.com' or 'Search for best laptops 2025'"
                  className="w-full p-2 border rounded"
                />
              </form>
            </div>
          )
        }
        ```
      </Tab>

      <Tab title="Node.js Script">
        ```typescript script.ts theme={null} theme={null}
        import { anthropic } from '@ai-sdk/anthropic'
        import { generateText, stepCountIs } from 'ai'
        import { scrape, search, amazon_product } from '@brightdata/ai-sdk'

        async function main() {
          // Example 1: Scrape a website
          console.log('=== Example 1: Web Scraping ===')
          const scrapeResult = await generateText({
            model: anthropic('claude-opus-4-6'),
            tools: { scrape: scrape() },
            stopWhen: stepCountIs(10),
            prompt: 'Scrape https://news.ycombinator.com and summarize the top 5 stories',
          })
          console.log(scrapeResult.text)

          // Example 2: Web search
          console.log('\n=== Example 2: Web Search ===')
          const searchResult = await generateText({
            model: anthropic('claude-opus-4-6'),
            tools: { search: search() },
            stopWhen: stepCountIs(10),
            prompt: 'Search for the latest JavaScript frameworks and tell me about the top 3',
          })
          console.log(searchResult.text)

          // Example 3: Amazon product research
          console.log('\n=== Example 3: Amazon Product ===')
          const amazonResult = await generateText({
            model: anthropic('claude-opus-4-6'),
            tools: { amazon_product: amazon_product() },
            stopWhen: stepCountIs(10),
            prompt: "Get details about this product: https://www.amazon.com/dp/B0D2Q9397Y and tell me if it's worth buying",
          })
          console.log(amazonResult.text)
        }

        main()
        ```
      </Tab>

      <Tab title="Custom API Key">
        Pass the API key directly to any tool instead of relying on the environment variable:

        ```typescript theme={null} theme={null}
        import { scrape, search } from '@brightdata/ai-sdk'
        import { generateText, stepCountIs } from 'ai'
        import { openai } from '@ai-sdk/openai'

        const { text } = await generateText({
          model: openai('gpt-4o'),
          prompt: 'Search for AI news today',
          tools: {
            scrape: scrape({ api_key: 'your-api-key-here' }),
            search: search({ api_key: 'your-api-key-here' }),
          },
          stopWhen: stepCountIs(5),
        })
        ```
      </Tab>

      <Tab title="Social & Dataset Tools">
        Use the structured dataset tools for LinkedIn, Instagram, Facebook, and more:

        ```typescript theme={null} theme={null}
        import { linkedin_profile, linkedin_jobs, instagram_profile, facebook_profile } from '@brightdata/ai-sdk'
        import { generateText, stepCountIs } from 'ai'
        import { openai } from '@ai-sdk/openai'

        const { text } = await generateText({
          model: openai('gpt-4o'),
          prompt: 'Find AI engineering jobs in San Francisco on LinkedIn',
          tools: {
            linkedin_profile: linkedin_profile(),
            linkedin_jobs: linkedin_jobs(),
            instagram_profile: instagram_profile(),
            facebook_profile: facebook_profile(),
          },
          stopWhen: stepCountIs(10),
        })
        ```
      </Tab>
    </Tabs>
  </Step>
</Steps>

## Available Tools

All tools are factory functions, call them with an optional config object (or no arguments at all to use env defaults):

| Tool                  | Import                                                   | Description                                                                              |
| --------------------- | -------------------------------------------------------- | ---------------------------------------------------------------------------------------- |
| `scrape()`            | `import { scrape } from '@brightdata/ai-sdk'`            | Scrape any website and return clean markdown. Bypasses anti-bot protection and CAPTCHAs. |
| `search()`            | `import { search } from '@brightdata/ai-sdk'`            | Search Google, Bing, or Yandex with anti-bot bypass. Returns markdown results.           |
| `amazon_product()`    | `import { amazon_product } from '@brightdata/ai-sdk'`    | Get detailed Amazon product info: price, ratings, reviews, and specs.                    |
| `linkedin_profile()`  | `import { linkedin_profile } from '@brightdata/ai-sdk'`  | Fetch LinkedIn profile data including experience, education, and skills.                 |
| `linkedin_jobs()`     | `import { linkedin_jobs } from '@brightdata/ai-sdk'`     | Search LinkedIn job postings by location and keyword.                                    |
| `instagram_profile()` | `import { instagram_profile } from '@brightdata/ai-sdk'` | Get Instagram profile info and recent posts.                                             |
| `facebook_profile()`  | `import { facebook_profile } from '@brightdata/ai-sdk'`  | Collect Facebook profile data from a profile URL.                                        |
| `chatgpt()`           | `import { chatgpt } from '@brightdata/ai-sdk'`           | Query ChatGPT via Bright Data's dataset API with optional web search mode.               |

## How each tool works

### `scrape(options?)`

Scrape any public webpage and get back clean markdown (or HTML).

```typescript theme={null} theme={null}
import { scrape } from '@brightdata/ai-sdk'

const tool = scrape({
  api_key: 'optional — defaults to BRIGHTDATA_API_KEY env var',
  data_format: 'markdown', // or 'html'
  country: 'us',           // default proxy country (2-letter code)
})
```

**LLM input schema:**

| Parameter | Type     | Required | Description                                   |
| --------- | -------- | -------- | --------------------------------------------- |
| `url`     | `string` | Yes      | The URL to scrape                             |
| `country` | `string` | No       | 2-letter country code for the proxy exit node |

***

### `search(options?)`

Search the web via Google, Bing, or Yandex.

```typescript theme={null} theme={null}
import { search } from '@brightdata/ai-sdk'

const tool = search({
  api_key: 'optional',
  search_engine: 'google', // 'google' | 'bing' | 'yandex'
  data_format: 'markdown', // or 'html'
  country: 'us',
})
```

**LLM input schema:**

| Parameter       | Type     | Required | Description                                   |
| --------------- | -------- | -------- | --------------------------------------------- |
| `query`         | `string` | Yes      | The search query                              |
| `search_engine` | `string` | No       | `'google'` (default), `'bing'`, or `'yandex'` |
| `country`       | `string` | No       | 2-letter country code for localized results   |
| `data_format`   | `string` | No       | `'markdown'` (default) or `'html'`            |

***

### `amazon_product(options?)`

Retrieve structured Amazon product data.

```typescript theme={null} theme={null}
import { amazon_product } from '@brightdata/ai-sdk'

const tool = amazon_product({ api_key: 'optional' })
```

**LLM input schema:**

| Parameter | Type     | Required | Description                                                |
| --------- | -------- | -------- | ---------------------------------------------------------- |
| `url`     | `string` | Yes      | Amazon product URL (must include `/dp/` or `/gp/product/`) |
| `zipcode` | `string` | No       | ZIP code for location-specific pricing                     |

***

### `linkedin_profile(options?)`

Collect detailed LinkedIn profile data for one or more profiles.

```typescript theme={null} theme={null}
import { linkedin_profile } from '@brightdata/ai-sdk'

const tool = linkedin_profile({
  api_key: 'optional',
  format: 'json', // 'json' | 'jsonl'
})
```

**LLM input schema:**

| Parameter | Type       | Required | Description                            |
| --------- | ---------- | -------- | -------------------------------------- |
| `urls`    | `string[]` | Yes      | Array of LinkedIn profile URLs (min 1) |

***

### `linkedin_jobs(options?)`

Search LinkedIn job postings by location and keyword.

```typescript theme={null} theme={null}
import { linkedin_jobs } from '@brightdata/ai-sdk'

const tool = linkedin_jobs({ api_key: 'optional' })
```

**LLM input schema:**

| Parameter  | Type     | Required | Description                         |
| ---------- | -------- | -------- | ----------------------------------- |
| `location` | `string` | Yes      | Job location, e.g. `"New York, NY"` |
| `keyword`  | `string` | No       | Job title or search keyword         |
| `country`  | `string` | No       | 2-letter country code               |

***

### `instagram_profile(options?)`

Fetch Instagram profile info and recent posts.

```typescript theme={null} theme={null}
import { instagram_profile } from '@brightdata/ai-sdk'

const tool = instagram_profile({ api_key: 'optional' })
```

**LLM input schema:**

| Parameter | Type     | Required | Description           |
| --------- | -------- | -------- | --------------------- |
| `url`     | `string` | Yes      | Instagram profile URL |

***

### `facebook_profile(options?)`

Collect Facebook profile data.

```typescript theme={null} theme={null}
import { facebook_profile } from '@brightdata/ai-sdk'

const tool = facebook_profile({
  api_key: 'optional',
  format: 'json', // 'json' | 'jsonl'
})
```

**LLM input schema:**

| Parameter | Type     | Required | Description          |
| --------- | -------- | -------- | -------------------- |
| `url`     | `string` | Yes      | Facebook profile URL |

***

### `chatgpt(options?)`

Query ChatGPT via Bright Data's ChatGPT dataset API with optional web search.

```typescript theme={null} theme={null}
import { chatgpt } from '@brightdata/ai-sdk'

const tool = chatgpt({
  api_key: 'optional',
  format: 'json', // 'json' | 'jsonl'
})
```

**LLM input schema:**

| Parameter           | Type      | Required | Description                    |
| ------------------- | --------- | -------- | ------------------------------ |
| `prompt`            | `string`  | Yes      | Prompt to send to ChatGPT      |
| `additional_prompt` | `string`  | No       | Optional follow-up prompt      |
| `country`           | `string`  | No       | 2-letter country code          |
| `require_sources`   | `boolean` | No       | Fail when no sources are found |
| `web_search`        | `boolean` | No       | Enable ChatGPT web search mode |

***

## Example Output

### Example: scrape a webpage

**Prompt:** "Scrape [https://example.com](https://example.com) and tell me what it's about"

**AI Response:**

```text theme={null}
I've scraped the website. Here's what I found:

# Example Domain

This domain is for use in illustrative examples in documents. You may use this
domain in literature without prior coordination or asking for permission.

The website appears to be a placeholder domain used for documentation and
examples. It's maintained by IANA (Internet Assigned Numbers Authority) and
serves as a standard example domain that can be referenced in documentation
without needing permission.
```

### Example: run a Google search

**Prompt:** "Search for best mechanical keyboards 2025"

**AI Response:**

```text theme={null}
I found several highly-rated mechanical keyboards for 2025:

1. **Keychron Q1 Pro** — Premium 75% layout, hot-swappable switches,
   wireless. ~$200.

2. **Wooting 60HE** — Analog switches with adjustable actuation points,
   popular among gamers.

3. **GMMK Pro** — 75% gasket-mounted, extensive customization options.
```

### Amazon Product Example

**Prompt:** "Get info about [https://www.amazon.com/dp/B0D2Q9397Y](https://www.amazon.com/dp/B0D2Q9397Y)"

**AI Response:**

```text theme={null}
Product: Logitech MX Master 3S Wireless Mouse
Price: $99.99
Rating: 4.6/5 (8,234 reviews)

Key Features:
- 8K DPI sensor
- Quiet clicks
- USB-C charging
- Connects to up to 3 devices

Verdict: Excellent choice for productivity users. Premium price, but
justified by ergonomics and multi-device support.
```

## Best Practices

1. **API key management**, Use `BRIGHTDATA_API_KEY` in your environment; avoid hardcoding keys.
2. **Error handling**, All tools catch errors internally and return a descriptive string, so LLM loops won't crash.
3. **Data format**, Use `markdown` for scraping to get clean, LLM-friendly content.
4. **Multi-step agents**, Set `stopWhen: stepCountIs(N)` to let the model chain tool calls autonomously.
5. **Country targeting**, Pass a 2-letter country code to get geo-specific results or pricing.
6. **Async datasets**, For large dataset jobs (many LinkedIn profiles, etc.), consider setting `async: true` in the underlying SDK client to avoid timeouts.

## Which environment variables to set

```bash .env.local theme={null} theme={null}
BRIGHTDATA_API_KEY=your_api_key_here
```

Get your API key from the [Bright Data Dashboard](https://brightdata.com/cp).


# How to set up Bright Data with xpander.ai
Source: https://docs.brightdata.com/integrations/xpander-ai

Integrate Bright Data with xpander.ai to give enterprise AI agents reliable web access and structured data extraction from public websites. Spans 195 countries.

<Card title="Building an AI startup?" href="https://brightdata.com/ai/ai-startups-program" icon="rocket-launch">
  You might be eligible for our Startup Program. Get fully funded access to the infrastructure you're reading about right now (up to \$20K value).
</Card>

[xpander.ai](https://xpander.ai/) is a Backend-as-a-Service platform for building autonomous AI agents. It is a no-code solution designed to help enterprise developers efficiently build, test, and deploy AI agents. It also comes with an open-source SDK to programmatically build and run AI agents.

## Available Bright Data Tools

<Card>
  <CardGroup>
    <Card title="Start Data Collection Job by Dataset ID" icon="1">
      Launches a scraping job for a specified dataset using the Scraperss.
    </Card>

    <Card title="Execute Proxy Request by URL" icon="2">
      Sends an HTTP request through Bright Data’s proxy network for accessing the content of any web page.
    </Card>

    <Card title="Download Dataset Snapshot by ID" icon="3">
      Downloads a snapshot of a dataset in various formats, passing the data to the AI.
    </Card>
  </CardGroup>
</Card>

## How to Integrate Bright Data With xpander.ai

<Steps>
  <Step title="Prerequisites">
    * [xpander.ai account](https://app.xpander.ai/login)
    * [Bright Data API key](/api-reference/authentication#api-key)
  </Step>

  <Step title="Create a new agent">
    1. In your [profile dashboard](https://app.xpander.ai/agents) and press the “New Agent” button to add a new agent:

    <Frame>
      <img alt="Clicking the “Agents > New Agent” button" />
    </Frame>
  </Step>

  <Step title="Basic Configuration">
    1. Choose an appropriate name for your agent. For example, if you want to create a web scraping agent, you can call it “Web Scraper Agent”.

    <Frame>
      <img alt="Calling the new agent “Web Scraper Agent”" />
    </Frame>

    2. Leave all other settings in the “General” tab as they are. The defaults are enough for a simple setup like this one. By default, xpander.ai will use [OpenAI’s GPT-4o as the LLM model](https://openai.com/index/hello-gpt-4o/).
  </Step>

  <Step title="Add Bright Data integration tools">
    1. Go to the “Tools” tab on your agent’s page, then click the “Add tools” button:

    <Frame>
      <img alt="Clicking the “Add tools” button" />
    </Frame>

    2. Search for “bright data” on the right side panel and select the Bright Data integration:

    <Frame>
      <img alt="Selecting the Bright Data connector" />
    </Frame>
  </Step>

  <Step title="Configure the Bright Data Connector">
    The following modal will show up:

    <Frame>
      <img alt="Filling out the Bright Data connector configuration form" />
    </Frame>

    Fill it out as follows:

    | Configuration Option | Value                                          |
    | :------------------- | :--------------------------------------------- |
    | Connector name       | Bright Data Connector (or any name you prefer) |
    | Authentication mode  | API Key                                        |
    | Authentication scope | Integration user                               |
    | API Key              | \[Your Bright Data API key]                    |
    | Authentication type  | Bearer                                         |

    Once everything is filled in, press the “Save” button.
  </Step>

  <Step title="Select the Bright Data Tools">
    Now, you will be prompted to select the specific Bright Data tools you want to enable in your agent:

    <Frame>
      <img alt="Selecting the Bright Data tools to enable" />
    </Frame>

    We recommend selecting all tools to unlock full web scraping capabilities. As of this writing, the available tools are:

    * **Start Data Collection Job by Dataset ID**: Launches a scraping job for a specified dataset using the [Scraperss](https://brightdata.com/products/web-scraper).
    * **Execute Proxy Request by URL**: Sends an HTTP request through [Bright Data’s proxy network](https://brightdata.com/proxy-types/) for accessing the content of any web page.
    * **Download Dataset Snapshot by ID**: Downloads a snapshot of a dataset in various formats, passing the data to the AI.
  </Step>

  <Step title="Add the Tools to Your Agent">
    Once you have selected the desired tools, click the “Add to agent” button in the bottom-right corner:

    <Frame>
      <img alt="Clicking the “Add to agent” button" />
    </Frame>

    The “Tools” tab of your agent will now show the Bright Data connector with the tools you configured:

    <Frame>
      <img alt="Note the configured Bright Data tools" />
    </Frame>

    Notice that you can click on any tool to view or adjust its configuration.

    Fantastic! Your AI agent is now fully integrated with Bright Data tools and ready to scrape the web.
  </Step>

  <Step title="Specialize Your AI Scraping Agent">
    Now that your agent has access to the Bright Data tools for web scraping, give it a custom [system prompt](https://www.promptlayer.com/glossary/system-prompt). This tells the agent what it is and how it should operate.

    To do this, click on the “Instructions” tab and paste something like the following into the “System prompt” textarea:

    ```text theme={null}
    You are an AI agent capable of grounding your responses by scraping data from the web
    ```

    <Frame>
      <img alt="Adding a system prompt to your agent" />
    </Frame>

    For more specialized agents, you can also add custom rules and goals.

    Amazing! Your xpander scraping agent is ready.
  </Step>

  <Step title="View the Agent Graph">
    Click on the “Agent graph” button to view your current AI agent workflow:

    <Frame>
      <img alt="The agent graph" />
    </Frame>

    You will see a single agent with access to the three configured Bright Data tools for web scraping.

    Well done! All that is left is to test the agent and see it in action.
  </Step>

  <Step title="Send a Prompt to Your Agent">
    Go back to the “Tester Chat” tab and try out your agent with a prompt like this:

    ```text theme={null}
    Search for top 3 headphones under $100 and provide me info from their PDP's
    ```

    This instructs your web scraping agent to dynamically look online for the top 3 headphones priced under \$100 and retrieve information directly from their [product detail pages (PDPs)](https://www.dynamicyield.com/glossary/product-detail-page/).

    As you can imagine, a standard LLM would be able to handle this kind of task without access to dedicated scraping tools like those provided by Bright Data.

    Paste the prompt into the chat input and send it to your agent:

    <Frame>
      <img alt="The AI scraping agent in action" />
    </Frame>
  </Step>

  <Step title="Analyze the Agent's Response">
    The agent uses the LLM and Bright Data tools to:

    1. Perform a web search and find the top 3 headphones.
    2. For each product, start a data collection job and download data from Amazon.
    3. Summarize the information into a short, accurate response, complete with real-world links to the Amazon product detail pages.
  </Step>

  <Step title="Inspect the Tool Calls">
    If you expand one of the tool sections in the interface, you will see something like this:

    <Frame>
      <img alt="The I/O details from a tool call" />
    </Frame>

    This proves that, behind the scenes, the AI agent automatically detected which Bright Data tools to use to complete the task. In detail, it called them with the right parameters to fetch fresh scraped data (in this case, directly from Amazon product pages).
  </Step>
</Steps>

Et voilà! You now have a fully functional scraping agent on xpander.ai, powered by Bright Data’s AI data infrastructure.


# How to set up Bright Data with Zapier
Source: https://docs.brightdata.com/integrations/zapier

Connect Bright Data (1000+ scrapers) to Zapier to automate web data collection and route results into Google Sheets, Slack, Trello, Airtable and Salesforce.

Bright Data’s Zapier integration enables you to automate web data collection and seamlessly route structured data into apps like Google Sheets, Slack, Trello, Airtable, and Salesforce, without writing a single line of code.

## Available Zap Actions

The following actions are currently supported via the Bright Data Zapier integration:

| Actions                              | Description                                                                             |
| :----------------------------------- | :-------------------------------------------------------------------------------------- |
| Scrape Amazon                        | Create a new scraping request for Amazon data, waits for data to be received            |
| Scrape Crunchbase                    | Create a new scraping request for Crunchbase data, waits for data to be received        |
| Scrape Facebook                      | Scrape data from a Facebook Post, Comment or Reel                                       |
| Scrape Google Play Store             | Create a new scraping request for Google Play Store data, waits for data to be received |
| Scrape Instagram                     | Creates a new scraping request for Instagram data, waits for data to be received        |
| Scrape Pinterest                     | Create a new scraping request for Pinterest data, waits for data to be received         |
| Run an Web Unlocker API              | Creates an Web Unlocker API run                                                         |
| Scrape Vimeo                         | Create a new scraping request for Vimeo data, waits for data to be received             |
| Scrape Yelp                          | Create a new scraping request for Yelp data, waits for data to be received              |
| Scrape ChatGPT                       | Create a new scraping request for ChatGPT data, waits for data to be received           |
| Download Snapshot Content (Scrapers) | Download snapshot content (Scrapers)                                                    |
| Scrape Glassdoor                     | Create a new scraping request for Glassdoor data, waits for data to be received         |
| Scrape Indeed                        | Create a new scraping request for Indeed data, waits for data to be received            |
| Scrape LinkedIn                      | Create a new scraping request for LinkedIn data, waits for data to be received          |
| Scrape Pitchbook                     | Create a new scraping request for Pitchbook data, waits for data to be received         |
| Scrape TikTok                        | Create a new scraping request for TikTok data, waits for data to be received            |
| Scrape X (Twitter)                   | Create a new scraping request for X data, waits for data to be received                 |
| Scrape YouTube                       | Create a new scraping request for YouTube data, waits for data to be received           |

***

## How to Integrate Bright Data With Zapier

<Steps>
  <Step title="Prerequisites">
    Before you begin, ensure you have the following:

    * A valid Bright Data API Key
    * An active Zapier account
    * Access to the Bright Data Zapier app
    * A clear understanding of what data you want to scrape and where it should be sent
  </Step>

  <Step title="Create a Zap">
    Log in to your Zapier account, navigate to the **Zaps** section, and click **Create Zap** to start building your automation workflow.
  </Step>

  <Step title="Set Up a Trigger">
    Choose a trigger app and event that fits your use case. Common examples include:

    * **Schedule by Zapier**, run a scraper hourly, daily, or weekly
    * **New Row in Google Sheets**, trigger scraping when new input data is added
    * **Webhooks or Form Submissions**, trigger scrapers dynamically using real-time inputs
  </Step>

  <Step title="Add Bright Data as an Action">
    In the **Action** step, search for and select **Bright Data**. You will then be prompted to choose one of the available scraping or Unlocker actions.

    <Frame>
      <img alt="zapier-action-setup" />
    </Frame>
  </Step>

  <Step title="Select an Action Event">
    Choose the Bright Data action that matches your target platform.\
    For example:

    * Select **Scrape Amazon** to collect product data
    * Select **Scrape LinkedIn** to extract profile or company information
    * Select **Run an Web Unlocker API** for advanced dynamic website access
  </Step>

  <Step title="Connect Your Bright Data Account">
    Click **Sign In** next to the Bright Data connection field.\
    Enter your Bright Data API key to authorize Zapier to run scraping actions on your behalf.

    <Frame>
      <img alt="zapier-api-key" />
    </Frame>
  </Step>

  <Step title="Configure Action Parameters">
    Configure the required input fields for the selected action.\
    Depending on the scraper, this may include:

    * Target URLs or search terms
    * Country or localization settings
    * Result limits or pagination options
    * Output format preferences
  </Step>

  <Step title="Test the Action">
    Click **Test Action** to validate your configuration.\
    Zapier will execute a sample scrape and return example output so you can confirm:

    * Data is returned successfully
    * Fields are mapped correctly
    * The response matches your expectations
  </Step>

  <Step title="Add Downstream Actions (Optional)">
    After the Bright Data action, you can chain additional steps, such as:

    * Save results to Google Sheets or Airtable
    * Send alerts to Slack or Email
    * Push structured data into CRMs or internal tools
  </Step>

  <Step title="Publish and Monitor Your Zap">
    Once everything is verified, click **Publish Zap** to activate it.

    After publishing:

    * Monitor task history in Zapier
    * Adjust triggers or scraping parameters as needed
    * Scale workflows by duplicating Zaps for other platforms
  </Step>
</Steps>

***

## Best Practices

* Start with low-frequency triggers and scale gradually
* Validate output fields before sending data to production tools
* Use scheduling triggers for predictable workloads
* Monitor Zapier task usage and Bright Data API limits
* Keep API keys secure and rotate them periodically

***

## Conclusion

With Bright Data’s Zapier integration, you can automate web data collection without writing code. From scheduled scrapes to real-time triggers, this setup enables flexible, scalable workflows that seamlessly deliver structured data into your favorite tools, powering analytics, monitoring, and business operations with ease.


# How to set up Bright Data with AdsPower
Source: https://docs.brightdata.com/integrations/adspower

Pair Bright Data (400M+ residential IPs) with AdsPower to stay secure and undetectable for privacy-focused research and market intelligence at scale.

<Warning>
  **Account management is not a supported use case** on the Bright Data platform as of April 1, 2026. This includes managing accounts on platforms like TikTok, Instagram, or similar services. Bright Data proxies cannot be used for this purpose. See [Acceptable Use Policy](https://brightdata.com/acceptable-use-policy) for details.
</Warning>

<Accordion title="Expand to get your Bright Data Proxy Access Information">
  ### Your proxy access information

  Bright Data proxies are grouped in "Proxy zones". Each zone holds the configuration for the proxies it holds.

  To get access to the proxy zone:

  1. Login to Bright Data control panel
  2. Select the proxy zone or setup a new one
  3. Click on the new zone name, and select the **Overview** tab.
  4. In the overview tab, under **Access details** you can find the proxy access details, and copy them to clipboard on click.
  5. You will need: Proxy Host, Proxy Port, Proxy Zone username and Proxy Zone password.
  6. Click on the copy icons to copy the text to your clipboard and paste in your tool's proxy configuration.

  ### Access Details Section Example

  <img alt="" />

  ### Residential proxy access

  To access Bright Data's **Residential Proxies** you must be a KYC-verified business account. Complete KYC verification with the Bright Data compliance team; there is no automatic or no-KYC path. Without KYC, use ISP or Datacenter proxies. [Read more...](/proxy-networks/residential/network-access)

  ### Targeting search engines?

  If you target a search engine like google, bing or yandex, you need a special Search Engine Results Page (**SERP**) proxy API. Use Bright Data SERP API to target search engines.
  [Click here to read more about Bright Data SERP proxy API.](/scraping-automation/serp-api/introduction)

  ### Correct setup of proxy test to avoid "PROXY ERROR"

  In many tools you will see a "test proxy" function, which performs a conncectivity test to your proxy, and some add a geolocation test as well, to identify the location of the proxy.
  To correctly test your proxy you should target those search queries to:
  `https://geo.brdtest.com/welcome.txt` .

  Some tools use popular search engines (like google.com) as a default test target. Bright Data will block those requests and you tool will show **proxy error** although your proxy is perfectly fine.

  If your proxy test fails, this is probably the reason. Make sure that your test domain is not a search engine (this is done in the tool configuration, and not controlled by Bright Data).
</Accordion>

## What is AdsPower?

AdsPower is a versatile anti-detect browser perfect for marketers, researchers, and data professionals who need a secure, efficient way to manage multiple browser profiles. Each profile runs in its own isolated environment, keeping your activities discreet and safe from detection.

With AdsPower, you get unique digital fingerprints for every profile, things like IP address, device type, and user agent, ensuring your actions stay under the radar. Whether you’re collecting web data, conducting market research, or working on affiliate marketing, AdsPower keeps your browsing profiles secure and private.

<Tip>
  Maintain a consistent IP throughout your browser session by using the `-session` parameter in your username. This is essential because BrightData proxies default to rotating IPs with each request. [Learn more](/proxy-networks/faqs#how-to-use-the-same-ip-for-an-extended-period-of-time-and-how-long-can-i-keep-it-long-session) <br />

  New users should begin with ISP or Datacenter proxies, which need no KYC. Residential proxies require a [KYC-verified business account](/proxy-networks/residential/network-access).<br />
</Tip>

## AdsPower Proxy Integration

Integrating Bright Data proxies with AdsPower is quick and easy. Let’s set you up in a few simple steps:

Step 1. **Download AdsPower**. Head over to the [AdsPower website](https://www.adspower.com/download) to download and install the app.

Step 2. **Create a New Profile.** Once the app is installed, open it and click **New Profile** to create your first browser profile.

<Frame>
  <img alt="AdsPower Proxy Integration" />
</Frame>

Step 3. **Configure Your Proxies**. Now, let’s set up your Bright Data proxy. Follow these simple steps:

* **Proxy Type**: Choose from`HTTP`,`HTTPS`, or`SOCKS5`(based on your proxy type).

* **Proxy Host**: Enter[`http://brd.superproxy.io/`.](http://brd.superproxy.io/.)

* **Proxy Port**: 44445

* **Proxy Username**: Enter your Bright Data proxy zone`username`.

* **Proxy Password**: Enter your Bright Data proxy zone`password`.

Step 4: Click **Check Proxy** to ensure everything is working.

<Note>
  Some versions of AdsPower use `google.com` as their default test site. Bright data proxies are blocking `google.com`. Validate this is not a search engine website.
</Note>

<Note>
  If you chose either Residential or Mobile proxies you must install Bright Data SSL certificate to secure your end to end communication. **Otherwise you will encounter Errors**.
  SSL installation instructions can be found [here](/general/account/ssl-certificate#ssl-certificate)
  Alternatively, you can ignore SSL verification on AdsPower: Go to advanced settings when setting up a profile and paste: `--ignore-certificate-errors` in launch args.
</Note>

<Info>
  **For country-specific proxies, you can enter a format like `your-username-country-us` to receive a United States exit node.**
</Info>

Once everything is in place, click **OK** to save your settings.

Step 5. **Launch the Browser**.\
Click **Open** under **Tags** to launch your browser with the configured proxy.

<Frame>
  <img alt="AdsPower Proxy Integration" />
</Frame>

That’s it! You’ve successfully integrated Bright Data proxies with AdsPower, and you’re ready to go.


# How to set up Bright Data with Aezakmi
Source: https://docs.brightdata.com/integrations/aezakmi

Configure Bright Data proxies in Aezakmi to route browser profile traffic through residential, datacenter, ISP, or mobile IPs. Spans 195 countries.

<Warning>
  **Account management is not a supported use case** on the Bright Data platform as of April 1, 2026. This includes managing accounts on platforms like TikTok, Instagram, or similar services. Bright Data proxies cannot be used for this purpose. See [Acceptable Use Policy](https://brightdata.com/acceptable-use-policy) for details.
</Warning>

<Accordion title="Expand to get your Bright Data Proxy Access Information">
  ### Your proxy access information

  Bright Data proxies are grouped in "Proxy zones". Each zone holds the configuration for the proxies it holds.

  To get access to the proxy zone:

  1. Login to Bright Data control panel
  2. Select the proxy zone or setup a new one
  3. Click on the new zone name, and select the **Overview** tab.
  4. In the overview tab, under **Access details** you can find the proxy access details, and copy them to clipboard on click.
  5. You will need: Proxy Host, Proxy Port, Proxy Zone username and Proxy Zone password.
  6. Click on the copy icons to copy the text to your clipboard and paste in your tool's proxy configuration.

  ### Access Details Section Example

  <img alt="" />

  ### Residential proxy access

  To access Bright Data's **Residential Proxies** you must be a KYC-verified business account. Complete KYC verification with the Bright Data compliance team; there is no automatic or no-KYC path. Without KYC, use ISP or Datacenter proxies. [Read more...](/proxy-networks/residential/network-access)

  ### Targeting search engines?

  If you target a search engine like google, bing or yandex, you need a special Search Engine Results Page (**SERP**) proxy API. Use Bright Data SERP API to target search engines.
  [Click here to read more about Bright Data SERP proxy API.](/scraping-automation/serp-api/introduction)

  ### Correct setup of proxy test to avoid "PROXY ERROR"

  In many tools you will see a "test proxy" function, which performs a conncectivity test to your proxy, and some add a geolocation test as well, to identify the location of the proxy.
  To correctly test your proxy you should target those search queries to:
  `https://geo.brdtest.com/welcome.txt` .

  Some tools use popular search engines (like google.com) as a default test target. Bright Data will block those requests and you tool will show **proxy error** although your proxy is perfectly fine.

  If your proxy test fails, this is probably the reason. Make sure that your test domain is not a search engine (this is done in the tool configuration, and not controlled by Bright Data).
</Accordion>

## What is Aezakmi?

Aezakmi is a browser automation tool designed for marketers, researchers, and developers who require multiple browser profiles with unique configurations. With Bright Data, you can ensure secure, anonymous, and location-targeted browsing while avoiding IP bans and tracking.

<Tip>
  Maintain a consistent IP throughout your browser session by using the `-session` parameter in your username. This is essential because BrightData proxies default to rotating IPs with each request. [Learn more](/proxy-networks/faqs#how-to-use-the-same-ip-for-an-extended-period-of-time-and-how-long-can-i-keep-it-long-session) <br />

  New users should begin with ISP or Datacenter proxies, which need no KYC. Residential proxies require a [KYC-verified business account](/proxy-networks/residential/network-access).<br />
</Tip>

## Why Use Bright Data With Aezakmi?

* **Enhanced Privacy**: Mask your real IP address for secure browsing.

* **Geo-Targeting**: Access region-specific content with country-specific proxies.

* **Consistent Performance**: Ensure reliable and uninterrupted connections for all your browser profiles.

## How to Integrate Bright Data With Aezakmi

Follow these steps to configure Bright Data proxies in Aezakmi:

**Step 1. Install and Log In to Aezakmi**

1\. Download and install Aezakmi from the [official website](https://aezakmi.run/).

2\. Open the application and log in with your account credentials.

**Step 2. Create a New Browser Profile**

1\. Navigate to your [dashboard](https://account.aezakmi.run/#/dashboard) or click **Create New Profile** in the **Aezakmi Extension**.

2\. Configure your profile by selecting parameters such as:

* **Operating System**

* **Browser**

* **Screen Resolution**

* **Videocard Model**

3\. Click **Generate Fingerprint** to create a unique browser fingerprint profile tailored to your setup.

<Frame>
  <img alt="How to Integrate Bright Data With Aezakmi" />
</Frame>

**Step 3. Enable Proxy for Your Profile**

1\. In the profile setup screen, enter a descriptive name in the **Profile Name** field to easily identify the profile later.

2\. Toggle **Enable Proxy** to *On* to activate the proxy configuration options.

<Frame>
  <img alt="How to Integrate Bright Data With Aezakmi" />
</Frame>

**Step 4. Configure Proxy Settings**

1\.  Under the proxy settings section, enter your Bright Data proxy details:

* **Protocol**: Choose HTTP, HTTPS, or SOCKS5 based on your proxy type.

* **Address**: Enter [`http://brd.superproxy.io/`.](http://brd.superproxy.io/.)

* **Port**:  44445

* **User**: Input your Bright Data username.

* **Password**: Input your Bright Data password.

2\. Click **Check Proxy** to verify your connection. Ensure the test completes successfully.

<Note>
  For geo-targeted proxies, include the country code in the username, formatted as `your-username-country-XX` (e.g., `your-username-country-US`).
</Note>

**Step 5. Save and Launch**

* Once your proxy details are verified, click **Save Fingerprint** to apply the settings and save the profile.

By integrating Bright Data with Aezakmi, you can unlock a secure and efficient browsing experience. Whether scraping data, conducting market research, or accessing geo-restricted content, Bright Data ensures privacy, reliability, and performance. Get started today to maximize your productivity!


# How to set up Bright Data with Antik
Source: https://docs.brightdata.com/integrations/antik

Step-by-step guide to configuring Bright Data proxies in Antik for managing multiple browser profiles with geo-targeted IP routing. Spans 195 countries.

<Warning>
  **Account management is not a supported use case** on the Bright Data platform as of April 1, 2026. This includes managing accounts on platforms like TikTok, Instagram, or similar services. Bright Data proxies cannot be used for this purpose. See [Acceptable Use Policy](https://brightdata.com/acceptable-use-policy) for details.
</Warning>

<Accordion title="Expand to get your Bright Data Proxy Access Information">
  ### Your proxy access information

  Bright Data proxies are grouped in "Proxy zones". Each zone holds the configuration for the proxies it holds.

  To get access to the proxy zone:

  1. Login to Bright Data control panel
  2. Select the proxy zone or setup a new one
  3. Click on the new zone name, and select the **Overview** tab.
  4. In the overview tab, under **Access details** you can find the proxy access details, and copy them to clipboard on click.
  5. You will need: Proxy Host, Proxy Port, Proxy Zone username and Proxy Zone password.
  6. Click on the copy icons to copy the text to your clipboard and paste in your tool's proxy configuration.

  ### Access Details Section Example

  <img alt="" />

  ### Residential proxy access

  To access Bright Data's **Residential Proxies** you must be a KYC-verified business account. Complete KYC verification with the Bright Data compliance team; there is no automatic or no-KYC path. Without KYC, use ISP or Datacenter proxies. [Read more...](/proxy-networks/residential/network-access)

  ### Targeting search engines?

  If you target a search engine like google, bing or yandex, you need a special Search Engine Results Page (**SERP**) proxy API. Use Bright Data SERP API to target search engines.
  [Click here to read more about Bright Data SERP proxy API.](/scraping-automation/serp-api/introduction)

  ### Correct setup of proxy test to avoid "PROXY ERROR"

  In many tools you will see a "test proxy" function, which performs a conncectivity test to your proxy, and some add a geolocation test as well, to identify the location of the proxy.
  To correctly test your proxy you should target those search queries to:
  `https://geo.brdtest.com/welcome.txt` .

  Some tools use popular search engines (like google.com) as a default test target. Bright Data will block those requests and you tool will show **proxy error** although your proxy is perfectly fine.

  If your proxy test fails, this is probably the reason. Make sure that your test domain is not a search engine (this is done in the tool configuration, and not controlled by Bright Data).
</Accordion>

## What is Antik?

Antik is a browser-based automation tool designed for users managing multiple accounts, web scraping, and geo-targeted activities. With Bright Data, Antik ensures a secure and private environment for all your automation and browsing needs.

<Tip>
  Maintain a consistent IP throughout your browser session by using the `-session` parameter in your username. This is essential because BrightData proxies default to rotating IPs with each request. [Learn more](/proxy-networks/faqs#how-to-use-the-same-ip-for-an-extended-period-of-time-and-how-long-can-i-keep-it-long-session) <br />

  New users should begin with ISP or Datacenter proxies, which need no KYC. Residential proxies require a [KYC-verified business account](/proxy-networks/residential/network-access).
</Tip>

## Why Use Bright Data With Antik?

* **Privacy**: Protect your IP address and online identity.

* **Geo-Targeting**: Access region-specific content with Bright Data’s country-specific proxies.

* **Reliability**: Enjoy stable connections for uninterrupted workflows.

## How to Integrate Bright Data With Antik

**Step 1. Download and Log In to Antik**

1\. Visit the [official Antik website](https://antik.io/) and download the application.

2\. Install the software and log in using your account credentials.

**Step 2. Create a New Browser Profile**

1\. From the Antik dashboard, navigate to the **Profiles** tab.

2\. Click **Create** to start configuring a new browser profile.

<Frame>
  <img alt="How to Integrate Bright Data With Antik" />
</Frame>

**Step 3. Enable Proxy Settings**

1\. Under the **General Settings** tab, locate the **Name** field and enter a recognizable name for your profile to help you identify it later.

2\. Navigate to the **New Proxy** tab.

<Frame>
  <img alt="How to Integrate Bright Data With Antik" />
</Frame>

**Step 4. Add Your Bright Data Proxy Details**

1\. Go to your [Bright Data dashboard](https://brightdata.com/cp/zones) and click on the your proxy zone.

2\. Under the **Overview** tab, copy the proxy information in the format of:&#x20;

`host : port : username : passoword `(no spaces).&#x20;

3\. Paste this access information into the **Proxy** field in Antik.

4\. Once the proxy configuration is verified, click **Create** to save your proxy settings.

<Note>
  For geo-targeted proxies, format your username as `your-username-country-XX` (e.g., `your-username-country-US`) to specify a location.
</Note>

**Step 5. Save and Launch**

1\. Go to the **Profiles** tab and select your newly created profile.

2\. Click **Start** to launch the browser with the configured Bright Data settings.

<Frame>
  <img alt="How to Integrate Bright Data With Antik" />
</Frame>

By integrating Bright Data with Antik, you ensure secure and efficient browsing, making your workflows smooth and private. Whether managing multiple accounts or targeting specific regions, Bright Data provides the reliability you need to stay ahead. Get started today for a seamless browsing experience!


# How to use Bright Data with Apify
Source: https://docs.brightdata.com/integrations/apify

Step-by-step guide to configuring Bright Data (400M+ IPs) in Apify actors to bypass IP bans, geo-restrictions and CAPTCHAs in scraping workflows.

<Accordion title="Expand to get your Bright Data Proxy Access Information">
  ### Your proxy access information

  Bright Data proxies are grouped in "Proxy zones". Each zone holds the configuration for the proxies it holds.

  To get access to the proxy zone:

  1. Login to Bright Data control panel
  2. Select the proxy zone or setup a new one
  3. Click on the new zone name, and select the **Overview** tab.
  4. In the overview tab, under **Access details** you can find the proxy access details, and copy them to clipboard on click.
  5. You will need: Proxy Host, Proxy Port, Proxy Zone username and Proxy Zone password.
  6. Click on the copy icons to copy the text to your clipboard and paste in your tool's proxy configuration.

  ### Access Details Section Example

  <img alt="" />

  ### Residential proxy access

  To access Bright Data's **Residential Proxies** you must be a KYC-verified business account. Complete KYC verification with the Bright Data compliance team; there is no automatic or no-KYC path. Without KYC, use ISP or Datacenter proxies. [Read more...](/proxy-networks/residential/network-access)

  ### Targeting search engines?

  If you target a search engine like google, bing or yandex, you need a special Search Engine Results Page (**SERP**) proxy API. Use Bright Data SERP API to target search engines.
  [Click here to read more about Bright Data SERP proxy API.](/scraping-automation/serp-api/introduction)

  ### Correct setup of proxy test to avoid "PROXY ERROR"

  In many tools you will see a "test proxy" function, which performs a conncectivity test to your proxy, and some add a geolocation test as well, to identify the location of the proxy.
  To correctly test your proxy you should target those search queries to:
  `https://geo.brdtest.com/welcome.txt` .

  Some tools use popular search engines (like google.com) as a default test target. Bright Data will block those requests and you tool will show **proxy error** although your proxy is perfectly fine.

  If your proxy test fails, this is probably the reason. Make sure that your test domain is not a search engine (this is done in the tool configuration, and not controlled by Bright Data).
</Accordion>

## What is Apify?

Apify is a powerful platform for web scraping and automation. It enables developers to create and run custom web scraping tools, called **Actors**, which automate data collection and processing tasks. By integrating Bright Data proxies, you can enhance the anonymity, stability, and efficiency of your Apify workflows, ensuring your tasks run smoothly.

## How to Integrate Bright Data with Apify

For this guide, we’ll use the [**Web Scraper**](https://apify.com/apify/web-scraper) actor as an example.

**Step 1. Access Your Apify Dashboard and Tools**

1\. Log in to your [Apify account](https://apify.com/) using your credentials.

2\. From the dashboard, navigate to the **Apify Store** to explore available tools. Use the search bar or browse categories to locate the Web Scraper actor.

**Step 2. Launch the Web Scraper Actor**

1\. From the **Actors** section in the left-hand menu, locate the **Web Scraper actor**.

2\. Click on it to open the configuration page.

<Frame>
  <img alt="How to Integrate Bright Data with Apify" />
</Frame>

**Step 3. Define Target URLs for Scraping**

1\. In the **Input** tab, find the **Basic Configuration** section.

2\. Enter the target URLs of the web pages you want to scrape.

3\. Add one or multiple URLs depending on your scraping requirements.

<Frame>
  <img alt="How to Integrate Bright Data with Apify" />
</Frame>

<Note>
  Bright Data compliance allows access to search engines like `google` only from SERP proxy zones. To test, use non search engine targets
</Note>

**Step 4.** **Set Up Custom Proxy Options**

1\. Scroll down to the **Proxy and Browser Configuration** section.

2\. Select **Own proxies** to enable custom proxy settings.

3\. Enter your [Bright Data proxy details](https://brightdata.com/cp/zones) in the following format:

```basic theme={null}
http://[USERNAME]:[PASSWORD]@[HOST]:[PORT]
```

4\. Use your Bright Data credentials, and if needed, modify the username for geo-specific access (e.g., `your-username-country-US`).

<Frame>
  <img alt="How to Integrate Bright Data with Apify" />
</Frame>

**Step 5. Start and Validate Your Actor Task**

1\. Once the proxy configuration is complete, click **Save & Start** to launch the actor.

2\. Check the logs to ensure the task runs smoothly and that the Bright Data proxy is active.

<Frame>
  <img alt="How to Integrate Bright Data with Apify" />
</Frame>

With Bright Data proxies integrated into Apify, you can run powerful, anonymous, and geo-targeted automation workflows. Whether you’re scraping data, processing information, or managing large-scale projects, Bright Data ensures smooth and reliable operations on Apify. Start building smarter automation today!


# How to use Bright Data with BeautifulSoup
Source: https://docs.brightdata.com/integrations/beautifulsoup

Step-by-step guide to configuring Bright Data proxies in Python BeautifulSoup scripts for reliable, anonymous web scraping. Spans 195 countries.

<Accordion title="Expand to get your Bright Data Proxy Access Information">
  ### Your proxy access information

  Bright Data proxies are grouped in "Proxy zones". Each zone holds the configuration for the proxies it holds.

  To get access to the proxy zone:

  1. Login to Bright Data control panel
  2. Select the proxy zone or setup a new one
  3. Click on the new zone name, and select the **Overview** tab.
  4. In the overview tab, under **Access details** you can find the proxy access details, and copy them to clipboard on click.
  5. You will need: Proxy Host, Proxy Port, Proxy Zone username and Proxy Zone password.
  6. Click on the copy icons to copy the text to your clipboard and paste in your tool's proxy configuration.

  ### Access Details Section Example

  <img alt="" />

  ### Residential proxy access

  To access Bright Data's **Residential Proxies** you must be a KYC-verified business account. Complete KYC verification with the Bright Data compliance team; there is no automatic or no-KYC path. Without KYC, use ISP or Datacenter proxies. [Read more...](/proxy-networks/residential/network-access)

  ### Targeting search engines?

  If you target a search engine like google, bing or yandex, you need a special Search Engine Results Page (**SERP**) proxy API. Use Bright Data SERP API to target search engines.
  [Click here to read more about Bright Data SERP proxy API.](/scraping-automation/serp-api/introduction)

  ### Correct setup of proxy test to avoid "PROXY ERROR"

  In many tools you will see a "test proxy" function, which performs a conncectivity test to your proxy, and some add a geolocation test as well, to identify the location of the proxy.
  To correctly test your proxy you should target those search queries to:
  `https://geo.brdtest.com/welcome.txt` .

  Some tools use popular search engines (like google.com) as a default test target. Bright Data will block those requests and you tool will show **proxy error** although your proxy is perfectly fine.

  If your proxy test fails, this is probably the reason. Make sure that your test domain is not a search engine (this is done in the tool configuration, and not controlled by Bright Data).
</Accordion>

## What is BeautifulSoup?

BeautifulSoup is a Python library that simplifies the process of extracting and organizing data from HTML and XML documents. Combined with Bright Data proxies, it enables you to scrape data securely and anonymously while reducing the risk of detection and blocking.

## How to Integrate Bright Data with BeautifulSoup

**Step 0. Prerequisites**

Before you start:

* Download the latest Python version from [python.org](https://www.python.org/).

* Install BeautifulSoup and the `requests` library:

```bash theme={null}
     pip install beautifulsoup4 requests
```

**Step 1. Set Up the Proxy**

Login to bright data account, and select the proxy zone you with to use. In the **Overview,** under **Access details**, you can find the required information to get your access information. \*\*\*\*&#x20;

1. Log in to your [Bright Data account](https://brightdata.com/cp/zones) and retrieve your proxy credentials:

   * **Host**: [`http://brd.superproxy.io/`](http://brd.superproxy.io/)

   * **Port**: 44445

   * **Username**: Your Bright Data username. Modify it for geo-specific proxies if needed (e.g., `your-username-country-US`).

   * **Password**: Your Bright Data proxy zone password.

2. Define your proxy details in your script:

```python theme={null}
proxy = {
  "http": "http://[USERNAME]:[PASSWORD]@[HOST]:[PORT]"
}
```

**Step 2. Implement Proxy Settings with requests and Parse Data Using BeautifulSoup**

Here’s a comprehensive script that demonstrates how to integrate Bright Data with BeautifulSoup for secure data retrieval and parsing:

```python theme={null}
import requests
from bs4 import BeautifulSoup

# Bright Data Proxy Configuration
proxy = {
    "http": "http://[USERNAME]:[PASSWORD]@[HOST]:[PORT]",
    "https": "http://[USERNAME]:[PASSWORD]@[HOST]:[PORT]"
}

# Target URL to verify the proxy
url = "https://httpbin.org/ip" 

try:
    # Send the request using the proxy
    response = requests.get(url, proxies=proxy, timeout=10)
    response.raise_for_status()  # Handle HTTP errors

    # Parse the HTML content
    soup = BeautifulSoup(response.text, "html.parser")

    # Print the formatted page content
    print("Response Content (IP Address):")
    print(soup.prettify())

except requests.exceptions.RequestException as e:
    print("Error occurred while using the proxy:", e)

```

**Step 3. Verify the Output**

If the Bright Data proxy is configured correctly, you should see the IP address of the proxy displayed in the output:

```json theme={null}
{
  "origin": "123.45.67.89"
}
```

Integrating Bright Data proxies with BeautifulSoup allows you to scrape data securely, anonymously, and efficiently. Whether you’re extracting structured data, accessing geo-restricted content, or managing large-scale scraping tasks, Bright Data ensures reliability and privacy for all your scraping needs. Start scraping smarter with Bright Data and BeautifulSoup today!


# How to use Bright Data with BitBrowser
Source: https://docs.brightdata.com/integrations/bitbrowser

Step-by-step guide to configuring Bright Data proxies in BitBrowser for managing multiple browser profiles with geo-targeted IP routing. Spans 195 countries.

<Warning>
  **Account management is not a supported use case** on the Bright Data platform as of April 1, 2026. This includes managing accounts on platforms like TikTok, Instagram, or similar services. Bright Data proxies cannot be used for this purpose. See [Acceptable Use Policy](https://brightdata.com/acceptable-use-policy) for details.
</Warning>

<Accordion title="Expand to get your Bright Data Proxy Access Information">
  ### Your proxy access information

  Bright Data proxies are grouped in "Proxy zones". Each zone holds the configuration for the proxies it holds.

  To get access to the proxy zone:

  1. Login to Bright Data control panel
  2. Select the proxy zone or setup a new one
  3. Click on the new zone name, and select the **Overview** tab.
  4. In the overview tab, under **Access details** you can find the proxy access details, and copy them to clipboard on click.
  5. You will need: Proxy Host, Proxy Port, Proxy Zone username and Proxy Zone password.
  6. Click on the copy icons to copy the text to your clipboard and paste in your tool's proxy configuration.

  ### Access Details Section Example

  <img alt="" />

  ### Residential proxy access

  To access Bright Data's **Residential Proxies** you must be a KYC-verified business account. Complete KYC verification with the Bright Data compliance team; there is no automatic or no-KYC path. Without KYC, use ISP or Datacenter proxies. [Read more...](/proxy-networks/residential/network-access)

  ### Targeting search engines?

  If you target a search engine like google, bing or yandex, you need a special Search Engine Results Page (**SERP**) proxy API. Use Bright Data SERP API to target search engines.
  [Click here to read more about Bright Data SERP proxy API.](/scraping-automation/serp-api/introduction)

  ### Correct setup of proxy test to avoid "PROXY ERROR"

  In many tools you will see a "test proxy" function, which performs a conncectivity test to your proxy, and some add a geolocation test as well, to identify the location of the proxy.
  To correctly test your proxy you should target those search queries to:
  `https://geo.brdtest.com/welcome.txt` .

  Some tools use popular search engines (like google.com) as a default test target. Bright Data will block those requests and you tool will show **proxy error** although your proxy is perfectly fine.

  If your proxy test fails, this is probably the reason. Make sure that your test domain is not a search engine (this is done in the tool configuration, and not controlled by Bright Data).
</Accordion>

## What is BitBrowser?

BitBrowser is a multi-profile browser solution designed for managing multiple online identities securely and efficiently. Each profile operates in an isolated environment, enabling you to run multiple accounts while minimizing detection risks. Integrating Bright Data proxies adds an extra layer of anonymity and ensures seamless connections for your workflows.

<Tip>
  Maintain a consistent IP throughout your browser session by using the `-session` parameter in your username. This is essential because BrightData proxies default to rotating IPs with each request. [Learn more](/proxy-networks/faqs#how-to-use-the-same-ip-for-an-extended-period-of-time-and-how-long-can-i-keep-it-long-session) <br />

  New users should begin with ISP or Datacenter proxies, which need no KYC. Residential proxies require a [KYC-verified business account](/proxy-networks/residential/network-access).<br />
</Tip>

<Warning>
  Connections to the following social networks are not supported on Data Center and ISP proxy networks: Facebook, TikTok, Instagram, X (Twitter), LinkedIn, YouTube, Reddit, Pinterest, Snapchat, and Discord.
</Warning>

## Why Use Bright Data with BitBrowser?

* **Enhanced Privacy**: Mask your IP address to keep your online activities anonymous.

* **Geo-Targeted Browsing**: Access region-specific content using Bright Data’s country-specific proxies.

* **Stable Connections**: Enjoy consistent and reliable connections for managing multiple profiles.

## How to Use Bright Data with BitBrowser

**Step 1. Download and Install BitBrowser**

1\. Visit the official [BitBrowser website](https://www.bitbrowser.net/) and download the application for your device.

2\. Follow the installation instructions and launch the application once installed.

3\. Log in to your BitBrowser account using your credentials.

**Step 2. Navigate to Browser Profiles**

1\. After logging in, you’ll land on the home screen of BitBrowser.

2\. Look for the **"Browser Profiles"** section in the menu or dashboard.

<Frame>
  <img alt="How to Use Bright Data with BitBrowser" />
</Frame>

**Step 3. Create a New Browser Profile**

1\. Click the **“+ Add”** button to create a new browser profile.

2\. In the profile setup window, assign a clear and descriptive name to the profile to help you identify it later.

<Frame>
  <img alt="How to Use Bright Data with BitBrowser" />
</Frame>

**Step 4. Enter Bright Data Proxy Details**

Login to bright data account, and select the proxy zone you with to use. In the **Overview,** under **Access details**, you can find the required information to get your access information. \*\*\*\*&#x20;

1\. Scroll down to the **"Proxy"** section of the profile configuration page.

2\. Enter your Bright Data proxy details as follows:

* **Type**: Select the proxy protocol (`HTTP`, `HTTPS`, or `SOCKS5`) based on the Bright Data proxy type you’re using.

* **Host**: Input [`http://brd.superproxy.io/`](http://brd.superproxy.io/) as the server address.

* **Port**: 44445

* **Username**: Enter your Bright Data proxy username. For region-specific proxies, modify the username format (e.g., `your-username-country-US`).

* **Password**: Type in your Bright Data proxy password.

3\. Double-check all entries to ensure accuracy.

**Step 5. Test and Save Your Proxy Settings**

1\. Click the **"Check Proxy"** or equivalent button to verify the connection.

2\. If the test is successful, click **"Confirm"** to save your profile settings.

**Step 6. Launch the Profile and Verify the Setup**

1\. From the Browser Profiles dashboard, locate your newly created profile and click **"Open"**.

2\. Once the browser launches, navigate to [httpbin.org/ip](http://httpbin.org/ip) to confirm that the displayed IP matches your Bright Data proxy’s IP.

3\. If the IP matches, your proxy is successfully integrated, and your profile is ready for secure and private browsing.

<Frame>
  <img alt="How to Use Bright Data with BitBrowser" />
</Frame>

By integrating **Bright Data** proxies with **BitBrowser**, you’re equipped to manage multiple online identities securely and efficiently. Whether you’re scraping data, conducting market research, or accessing geo-specific content, Bright Data ensures stable, private, and geo-flexible browsing. Enjoy smooth workflows and enhanced anonymity with Bright Data on BitBrowser!


# Anti-detect browser integrations
Source: https://docs.brightdata.com/integrations/browser-integrations

Configure Bright Data proxies (400M+ residential IPs) in anti-detect browsers like GoLogin, MuLogin and XLogin for multi-account fingerprint management.

Anti-detect browsers let you manage multiple browser profiles with unique fingerprints. Adding Bright Data proxies gives each profile a distinct, trusted IP address.

<CardGroup>
  <Card title="GoLogin" icon="https://mintcdn.com/brightdata/pq7wn7mJJj8UJsym/images/integrations/gologin1.png?fit=max&auto=format&n=pq7wn7mJJj8UJsym&q=85&s=55c444e98d731a7ae0963f86406d2da7" href="/integrations/gologin">
    Assign Bright Data proxies to GoLogin browser profiles.
  </Card>

  <Card title="Multilogin" icon="browser" href="/integrations/multilogin">
    Configure Bright Data proxies in Multilogin browser profiles.
  </Card>

  <Card title="AdsPower" icon="https://mintcdn.com/brightdata/jeaQWxFKde5jgPN8/images/integrations/adspower1.png?fit=max&auto=format&n=jeaQWxFKde5jgPN8&q=85&s=bd012b7b56effe44847cf6b32cadefda" href="/integrations/adspower">
    Set up Bright Data proxies in AdsPower for multi-account management.
  </Card>

  <Card title="Kameleo" icon="browser" href="/integrations/kameleo">
    Add Bright Data proxies to Kameleo browser profiles.
  </Card>

  <Card title="Dolphin Anty" icon="browser" href="/integrations/dolphin-anty">
    Configure Bright Data proxies in Dolphin Anty profiles.
  </Card>

  <Card title="Incogniton" icon="https://mintcdn.com/brightdata/pq7wn7mJJj8UJsym/images/integrations/maskfog1.png?fit=max&auto=format&n=pq7wn7mJJj8UJsym&q=85&s=66098359f4a870aa4bbad388c0b0d054" href="/integrations/incogniton">
    Use Bright Data proxies with Incogniton anti-detect browser.
  </Card>

  <Card title="Undetectable" icon="https://mintcdn.com/brightdata/z2V3XghEDR2bikNt/images/integrations/undetectable1.png?fit=max&auto=format&n=z2V3XghEDR2bikNt&q=85&s=6d1b626060b47e0a5e85fb3d55272cc1" href="/integrations/undetectable">
    Set up Bright Data proxies in Undetectable browser profiles.
  </Card>

  <Card title="Ghost Browser" icon="https://mintcdn.com/brightdata/pq7wn7mJJj8UJsym/images/integrations/ghostbrowser1.png?fit=max&auto=format&n=pq7wn7mJJj8UJsym&q=85&s=e0ccf5a905b9a6c4c28c4cb9709aebfb" href="/integrations/ghost-browser">
    Add Bright Data proxies to Ghost Browser workspaces.
  </Card>

  <Card title="Octo Browser" icon="browser" href="/integrations/octobrowser">
    Configure Bright Data proxies in Octo Browser profiles.
  </Card>

  <Card title="SessionBox" icon="https://mintcdn.com/brightdata/z2V3XghEDR2bikNt/images/integrations/sessionbox1.png?fit=max&auto=format&n=z2V3XghEDR2bikNt&q=85&s=766b1c7d627d5e7c0ac68d98dfe181db" href="/integrations/sessionbox">
    Use Bright Data proxies with SessionBox multi-session management.
  </Card>

  <Card title="Aezakmi" icon="https://mintcdn.com/brightdata/jeaQWxFKde5jgPN8/images/integrations/aezakmi1.png?fit=max&auto=format&n=jeaQWxFKde5jgPN8&q=85&s=0dc409873f10c2c9ceb284a65b887487" href="/integrations/aezakmi">
    Set up Bright Data proxies in Aezakmi browser profiles.
  </Card>

  <Card title="BitBrowser" icon="https://mintcdn.com/brightdata/jeaQWxFKde5jgPN8/images/integrations/bitbrowser1.png?fit=max&auto=format&n=jeaQWxFKde5jgPN8&q=85&s=8fb6d555996ba73da9f2a5af9822ae94" href="/integrations/bitbrowser">
    Configure Bright Data proxies in BitBrowser profiles.
  </Card>

  <Card title="ClonBrowser" icon="https://mintcdn.com/brightdata/jeaQWxFKde5jgPN8/images/integrations/clonbrowser1.png?fit=max&auto=format&n=jeaQWxFKde5jgPN8&q=85&s=ed40825101578866106191ee5d3dbf9e" href="/integrations/clonbrowser">
    Add Bright Data proxies to ClonBrowser sessions.
  </Card>

  <Card title="DICloak" icon="browser" href="/integrations/dicloak">
    Use Bright Data proxies with DICloak anti-detect browser.
  </Card>

  <Card title="Geelark" icon="https://mintcdn.com/brightdata/pq7wn7mJJj8UJsym/images/integrations/geelark1.png?fit=max&auto=format&n=pq7wn7mJJj8UJsym&q=85&s=158f9dc832276c407c9b8c1f6687ae45" href="/integrations/geelark">
    Configure Bright Data proxies in Geelark cloud phone profiles.
  </Card>

  <Card title="GenLogin" icon="https://mintcdn.com/brightdata/pq7wn7mJJj8UJsym/images/integrations/genlogin1.png?fit=max&auto=format&n=pq7wn7mJJj8UJsym&q=85&s=245fc0ebe89bd6afa5beb7e73c5d98d7" href="/integrations/genlogin">
    Set up Bright Data proxies in GenLogin browser profiles.
  </Card>

  <Card title="HideMyAcc" icon="https://mintcdn.com/brightdata/pq7wn7mJJj8UJsym/images/integrations/hidemyacc1.png?fit=max&auto=format&n=pq7wn7mJJj8UJsym&q=85&s=9de473f20401802c05b4b25d896f73e5" href="/integrations/hidemyacc">
    Add Bright Data proxies to HideMyAcc browser profiles.
  </Card>

  <Card title="IXBrowser" icon="https://mintcdn.com/brightdata/pq7wn7mJJj8UJsym/images/integrations/ixbrowser1.png?fit=max&auto=format&n=pq7wn7mJJj8UJsym&q=85&s=dff907199d2e46177f8ccc24db657ea5" href="/integrations/ixbrowser">
    Configure Bright Data proxies in IXBrowser profiles.
  </Card>

  <Card title="Lalicat" icon="https://mintcdn.com/brightdata/pq7wn7mJJj8UJsym/images/integrations/lalicat1.png?fit=max&auto=format&n=pq7wn7mJJj8UJsym&q=85&s=61fb5af29351a62b2c74a438dd2a0867" href="/integrations/lalicat">
    Use Bright Data proxies with Lalicat anti-detect browser.
  </Card>

  <Card title="MarketerBrowser" icon="https://mintcdn.com/brightdata/pq7wn7mJJj8UJsym/images/integrations/marketerbrowser1.png?fit=max&auto=format&n=pq7wn7mJJj8UJsym&q=85&s=8252cdbb0021120499c04182a8900be7" href="/integrations/marketerbrowser">
    Add Bright Data proxies to MarketerBrowser profiles.
  </Card>

  <Card title="Maskfog" icon="https://mintcdn.com/brightdata/pq7wn7mJJj8UJsym/images/integrations/maskfog1.png?fit=max&auto=format&n=pq7wn7mJJj8UJsym&q=85&s=66098359f4a870aa4bbad388c0b0d054" href="/integrations/maskfog">
    Configure Bright Data proxies in Maskfog browser profiles.
  </Card>

  <Card title="MoreLogin" icon="https://mintcdn.com/brightdata/pq7wn7mJJj8UJsym/images/integrations/morelogin1.png?fit=max&auto=format&n=pq7wn7mJJj8UJsym&q=85&s=49efd4ff85818aa0fc7f286f4869ac92" href="/integrations/morelogin">
    Set up Bright Data proxies in MoreLogin browser profiles.
  </Card>

  <Card title="MuLogin" icon="https://mintcdn.com/brightdata/pq7wn7mJJj8UJsym/images/integrations/mulogin1.png?fit=max&auto=format&n=pq7wn7mJJj8UJsym&q=85&s=2d7dbdc8466dbb50ed4ccc114a9cfbc9" href="/integrations/mulogin">
    Add Bright Data proxies to MuLogin browser profiles.
  </Card>

  <Card title="SMLogin" icon="https://mintcdn.com/brightdata/z2V3XghEDR2bikNt/images/integrations/smlogin2.png?fit=max&auto=format&n=z2V3XghEDR2bikNt&q=85&s=3e93ff6aa65b6fe93ec80d7446f3c882" href="/integrations/smlogin">
    Configure Bright Data proxies in SMLogin browser profiles.
  </Card>

  <Card title="Sphere Browser" icon="https://mintcdn.com/brightdata/z2V3XghEDR2bikNt/images/integrations/sphere-browser1.png?fit=max&auto=format&n=z2V3XghEDR2bikNt&q=85&s=d385277e6efd50fb662c50a8c45b01de" href="/integrations/sphere-browser">
    Use Bright Data proxies with Sphere anti-detect browser.
  </Card>

  <Card title="VMLogin" icon="https://mintcdn.com/brightdata/z2V3XghEDR2bikNt/images/integrations/vmlogin1.png?fit=max&auto=format&n=z2V3XghEDR2bikNt&q=85&s=e43349f255b24958eafc4a6433ed1284" href="/integrations/vmlogin">
    Add Bright Data proxies to VMLogin browser profiles.
  </Card>

  <Card title="XLogin" icon="https://mintcdn.com/brightdata/z2V3XghEDR2bikNt/images/integrations/xlogin1.png?fit=max&auto=format&n=z2V3XghEDR2bikNt&q=85&s=e780377078d05097c518c0ba646becc3" href="/integrations/xlogin">
    Configure Bright Data proxies in XLogin browser profiles.
  </Card>

  <Card title="Antik" icon="https://mintcdn.com/brightdata/jeaQWxFKde5jgPN8/images/integrations/antik1.png?fit=max&auto=format&n=jeaQWxFKde5jgPN8&q=85&s=07de9399ef81d37c5f6211d3ca9a8e18" href="/integrations/antik">
    Set up Bright Data proxies in Antik browser profiles.
  </Card>

  <Card title="Insomniac" icon="browser" href="/integrations/insomniac">
    Configure Bright Data proxies in Insomniac browser.
  </Card>

  <Card title="Chrome" icon="https://mintcdn.com/brightdata/jeaQWxFKde5jgPN8/images/integrations/chrome1.png?fit=max&auto=format&n=jeaQWxFKde5jgPN8&q=85&s=8b62de64984b10e89b0a8121e96680f7" href="/integrations/chrome">
    Configure Bright Data proxies directly in Google Chrome.
  </Card>

  <Card title="Firefox" icon="https://mintcdn.com/brightdata/pq7wn7mJJj8UJsym/images/integrations/firefox1.png?fit=max&auto=format&n=pq7wn7mJJj8UJsym&q=85&s=32492262d4b037fd13e11c83c73bbf0f" href="/integrations/firefox">
    Set up Bright Data proxies in Mozilla Firefox.
  </Card>
</CardGroup>


# Set up Bright Data with ChangeDetection
Source: https://docs.brightdata.com/integrations/changedetection

Integrate Bright Data proxies (400M+ IPs) with ChangeDetection to monitor competitor prices, product availability and content changes across multiple sites.

<Accordion title="Expand to get your Bright Data Proxy Access Information">
  ### Your proxy access information

  Bright Data proxies are grouped in "Proxy zones". Each zone holds the configuration for the proxies it holds.

  To get access to the proxy zone:

  1. Login to Bright Data control panel
  2. Select the proxy zone or setup a new one
  3. Click on the new zone name, and select the **Overview** tab.
  4. In the overview tab, under **Access details** you can find the proxy access details, and copy them to clipboard on click.
  5. You will need: Proxy Host, Proxy Port, Proxy Zone username and Proxy Zone password.
  6. Click on the copy icons to copy the text to your clipboard and paste in your tool's proxy configuration.

  ### Access Details Section Example

  <img alt="" />

  ### Residential proxy access

  To access Bright Data's **Residential Proxies** you must be a KYC-verified business account. Complete KYC verification with the Bright Data compliance team; there is no automatic or no-KYC path. Without KYC, use ISP or Datacenter proxies. [Read more...](/proxy-networks/residential/network-access)

  ### Targeting search engines?

  If you target a search engine like google, bing or yandex, you need a special Search Engine Results Page (**SERP**) proxy API. Use Bright Data SERP API to target search engines.
  [Click here to read more about Bright Data SERP proxy API.](/scraping-automation/serp-api/introduction)

  ### Correct setup of proxy test to avoid "PROXY ERROR"

  In many tools you will see a "test proxy" function, which performs a conncectivity test to your proxy, and some add a geolocation test as well, to identify the location of the proxy.
  To correctly test your proxy you should target those search queries to:
  `https://geo.brdtest.com/welcome.txt` .

  Some tools use popular search engines (like google.com) as a default test target. Bright Data will block those requests and you tool will show **proxy error** although your proxy is perfectly fine.

  If your proxy test fails, this is probably the reason. Make sure that your test domain is not a search engine (this is done in the tool configuration, and not controlled by Bright Data).
</Accordion>

<Warning>
  **Account management is not a supported use case** on the Bright Data platform as of April 1, 2026. This includes managing accounts on platforms like TikTok, Instagram, or similar services. Bright Data proxies cannot be used for this purpose. See [Acceptable Use Policy](https://brightdata.com/acceptable-use-policy) for details.
</Warning>

## What is ChangeDetection?

**ChangeDetection** is a powerful tool for monitoring website updates. It allows you to track content changes, receive notifications, and analyze updates in real-time. Whether you’re monitoring competitors, prices, or product availability, ChangeDetection ensures you’re always informed. By integrating **Bright Data**, you can enhance privacy, bypass restrictions, and manage multiple monitoring tasks seamlessly.

<Tip>
  Maintain a consistent IP throughout your browser session by using the `-session` parameter in your username. This is essential because BrightData proxies default to rotating IPs with each request. [Learn more](/proxy-networks/faqs#how-to-use-the-same-ip-for-an-extended-period-of-time-and-how-long-can-i-keep-it-long-session) <br />

  New users should begin with ISP or Datacenter proxies, which need no KYC. Residential proxies require a [KYC-verified business account](/proxy-networks/residential/network-access).
</Tip>

### How to Integrate Bright Data With ChangeDetection

**Step 1. Install and Launch ChangeDetection**

1\. Visit the [ChangeDetection website](https://changedetection.io/) and download the application for your operating system.\
2\. Install ChangeDetection and launch the application.\
3\. Log in to your account to access the dashboard.

**Step 2. Configure Proxy Settings**

1\. Open the **Settings** menu from the ChangeDetection dashboard.\
2\. Navigate to the **Network Settings** or **Proxy Settings** section.

**Step 3. Enter Your Bright Data Proxy Details**

1. In the proxy configuration field, input your Bright Data proxy details:

   * **Protocol**: Select HTTP, HTTPS, or SOCKS5 depending on your proxy type.

   * **Host**: Enter [`http://brd.superproxy.io/`.](http://brd.superproxy.io/.)

   * **Port**: Use the port number provided in your [Bright Data dashboard](https://brightdata.com/cp/zones).

   * **Username**: Enter your Bright Data username.

   * **Password**: Enter your Bright Data password.

<Note>
  **For geo-targeted proxies, include the country code in your username (e.g., `your-username-country-US` for a US-based proxy).**
</Note>

**Step 4. Verify the Proxy Connection**

1. Test the proxy connection to ensure it is active:

   * In the same settings menu, look for a **Test Proxy** or **Validate Proxy** button.

   * Run the test to confirm that the proxy is working as expected.

2. Save your settings to apply the configuration.

**Step 5. Monitor Websites With Bright Data**

1. Return to the ChangeDetection dashboard and start adding websites to monitor.

2. Configure individual tasks as needed, ensuring they utilize the proxy settings for privacy and efficiency.

With **Bright Data** integrated into **ChangeDetection**, you can monitor websites securely, bypass geographical restrictions, and manage multiple tasks with ease. Enjoy seamless tracking and privacy for all your web monitoring needs!


# How to configure proxy settings in Chrome
Source: https://docs.brightdata.com/integrations/chrome

Step-by-step guide to configuring Bright Data proxies (port 44445) in Chrome for privacy, geo-bypass and managing multiple browser sessions or accounts.

<Accordion title="Expand to get your Bright Data Proxy Access Information">
  ### Your proxy access information

  Bright Data proxies are grouped in "Proxy zones". Each zone holds the configuration for the proxies it holds.

  To get access to the proxy zone:

  1. Login to Bright Data control panel
  2. Select the proxy zone or setup a new one
  3. Click on the new zone name, and select the **Overview** tab.
  4. In the overview tab, under **Access details** you can find the proxy access details, and copy them to clipboard on click.
  5. You will need: Proxy Host, Proxy Port, Proxy Zone username and Proxy Zone password.
  6. Click on the copy icons to copy the text to your clipboard and paste in your tool's proxy configuration.

  ### Access Details Section Example

  <img alt="" />

  ### Residential proxy access

  To access Bright Data's **Residential Proxies** you must be a KYC-verified business account. Complete KYC verification with the Bright Data compliance team; there is no automatic or no-KYC path. Without KYC, use ISP or Datacenter proxies. [Read more...](/proxy-networks/residential/network-access)

  ### Targeting search engines?

  If you target a search engine like google, bing or yandex, you need a special Search Engine Results Page (**SERP**) proxy API. Use Bright Data SERP API to target search engines.
  [Click here to read more about Bright Data SERP proxy API.](/scraping-automation/serp-api/introduction)

  ### Correct setup of proxy test to avoid "PROXY ERROR"

  In many tools you will see a "test proxy" function, which performs a conncectivity test to your proxy, and some add a geolocation test as well, to identify the location of the proxy.
  To correctly test your proxy you should target those search queries to:
  `https://geo.brdtest.com/welcome.txt` .

  Some tools use popular search engines (like google.com) as a default test target. Bright Data will block those requests and you tool will show **proxy error** although your proxy is perfectly fine.

  If your proxy test fails, this is probably the reason. Make sure that your test domain is not a search engine (this is done in the tool configuration, and not controlled by Bright Data).
</Accordion>

<Warning>
  **Account management is not a supported use case** on the Bright Data platform as of April 1, 2026. This includes managing accounts on platforms like TikTok, Instagram, or similar services. Bright Data proxies cannot be used for this purpose. See [Acceptable Use Policy](https://brightdata.com/acceptable-use-policy) for details.
</Warning>

<Tip>
  Maintain a consistent IP throughout your browser session by using the `-session` parameter in your username. This is essential because BrightData proxies default to rotating IPs with each request. [Learn more](/proxy-networks/faqs#how-to-use-the-same-ip-for-an-extended-period-of-time-and-how-long-can-i-keep-it-long-session) <br />

  New users should begin with ISP or Datacenter proxies, which need no KYC. Residential proxies require a [KYC-verified business account](/proxy-networks/residential/network-access).
</Tip>

## Changing Proxy Settings in Chrome

Ready to unlock the power of proxies in Chrome? It’s simple, just follow these steps and you’re good to go:

### Step 1. **Access Chrome Settings**

Open Chrome, click on the **three-dot menu** in the top-right corner, and choose **Settings** from the dropdown.

<Frame>
  <img alt="Step 1. Access Chrome Settings." />
</Frame>

### Step 2. **Open System Proxy Settings**

Navigate to the **System** section and select **Open your computer’s proxy settings** to proceed.

<Frame>
  <img alt="Step 2. Open System Proxy Settings." />
</Frame>

### Step 3. **Configure Proxy in Your Operating System**

Since Chrome uses your operating system’s proxy settings, you’ll be redirected to the system configuration screen. Follow these steps based on your OS:

* **On Windows**: Enable “Use a proxy server,” then enter the proxy address and port provided in your [Bright Data dashboard](https://brightdata.com/cp/zones).
* **On macOS**: Select the appropriate protocol (like HTTP or SOCKS5) and input the proxy address, port, and credentials. It’s quick and straightforward!

All done! Your Chrome browser is now set up with **Bright Data**. Whether you’re managing accounts, shopping worldwide, or browsing privately, you’re ready for a secure and seamless experience.


# Set up Bright Data with ClonBrowser
Source: https://docs.brightdata.com/integrations/clonbrowser

Configure Bright Data proxies in ClonBrowser to route browsing and automation profiles through residential, datacenter, ISP, or mobile IPs. Spans 195 countries.

<Warning>
  **Account management is not a supported use case** on the Bright Data platform as of April 1, 2026. This includes managing accounts on platforms like TikTok, Instagram, or similar services. Bright Data proxies cannot be used for this purpose. See [Acceptable Use Policy](https://brightdata.com/acceptable-use-policy) for details.
</Warning>

<Accordion title="Expand to get your Bright Data Proxy Access Information">
  ### Your proxy access information

  Bright Data proxies are grouped in "Proxy zones". Each zone holds the configuration for the proxies it holds.

  To get access to the proxy zone:

  1. Login to Bright Data control panel
  2. Select the proxy zone or setup a new one
  3. Click on the new zone name, and select the **Overview** tab.
  4. In the overview tab, under **Access details** you can find the proxy access details, and copy them to clipboard on click.
  5. You will need: Proxy Host, Proxy Port, Proxy Zone username and Proxy Zone password.
  6. Click on the copy icons to copy the text to your clipboard and paste in your tool's proxy configuration.

  ### Access Details Section Example

  <img alt="" />

  ### Residential proxy access

  To access Bright Data's **Residential Proxies** you must be a KYC-verified business account. Complete KYC verification with the Bright Data compliance team; there is no automatic or no-KYC path. Without KYC, use ISP or Datacenter proxies. [Read more...](/proxy-networks/residential/network-access)

  ### Targeting search engines?

  If you target a search engine like google, bing or yandex, you need a special Search Engine Results Page (**SERP**) proxy API. Use Bright Data SERP API to target search engines.
  [Click here to read more about Bright Data SERP proxy API.](/scraping-automation/serp-api/introduction)

  ### Correct setup of proxy test to avoid "PROXY ERROR"

  In many tools you will see a "test proxy" function, which performs a conncectivity test to your proxy, and some add a geolocation test as well, to identify the location of the proxy.
  To correctly test your proxy you should target those search queries to:
  `https://geo.brdtest.com/welcome.txt` .

  Some tools use popular search engines (like google.com) as a default test target. Bright Data will block those requests and you tool will show **proxy error** although your proxy is perfectly fine.

  If your proxy test fails, this is probably the reason. Make sure that your test domain is not a search engine (this is done in the tool configuration, and not controlled by Bright Data).
</Accordion>

## What is ClonBrowser?

**ClonBrowser** is a multi-account browser designed for privacy-focused users, marketers, and automation experts. It enables you to manage multiple profiles while maintaining anonymity, making it ideal for managing campaigns, scraping, and other online tasks.

<Tip>
  Maintain a consistent IP throughout your browser session by using the `-session` parameter in your username. This is essential because BrightData proxies default to rotating IPs with each request. [Learn more](/proxy-networks/faqs#how-to-use-the-same-ip-for-an-extended-period-of-time-and-how-long-can-i-keep-it-long-session) <br />

  New users should begin with ISP or Datacenter proxies, which need no KYC. Residential proxies require a [KYC-verified business account](/proxy-networks/residential/network-access).<br />
</Tip>

<Warning>
  Connections to the following social networks are not supported on Data Center and ISP proxy networks: Facebook, TikTok, Instagram, X (Twitter), LinkedIn, YouTube, Reddit, Pinterest, Snapchat, and Discord.
</Warning>

## How to Integrate Bright Data With ClonBrowser

**Step 1. Download and Install ClonBrowser**

1\. Visit the [ClonBrowser website](https://www.clonbrowser.com/) and download the application for your operating system.

2\. Install the application and log in with your account credentials.

**Step 2. Set Up a New Browser Profile**

1\. Navigate to the **Proxy** tab within the profile management section.

2\. Click **New** to start creating a new browser profile.

<Frame>
  <img alt="How to Integrate Bright Data With ClonBrowser" />
</Frame>

**Step 3. Configure Proxy Details**

1\. Go to your [Bright Data dashboard](https://brightdata.com/cp/zones) 

2\. Create a ':' delimited string by combining: `Proxy Host:Proxy Port:Proxy Zone username:Proxy Zone password`

3\. Paste the proxy string code into the designated field in ClonBrowser.

4\. Click **Parse** to automatically fill in the required fields (Host, Port, Username, Password).

5\. Test the connection by clicking **Connect Test**.

6\. Once verified, click **Save** to apply the proxy settings.

<Note>
  For geo-targeted proxies, include the country code in your username (e.g., `your-username-country-US`) to access proxies from a specific region.
</Note>

**Step 4. Finalize and Start Browsing**

1\. Go back to the **Proxy** tab and locate your newly configured profile.

2\. Click **Ping** to ensure the proxy is working correctly.

<Frame>
  <img alt="How to Integrate Bright Data With ClonBrowser" />
</Frame>

By following these steps, you can seamlessly integrate Bright Data with ClonBrowser, ensuring a secure and efficient browsing experience tailored to your needs.


# How to set up Bright Data with DICloak
Source: https://docs.brightdata.com/integrations/dicloak

Set up Bright Data proxies in DICloak anti-detect browser for anonymous browsing with dynamic fingerprinting and profile management. Covers 195+ countries.

<Warning>
  **Account management is not a supported use case** on the Bright Data platform as of April 1, 2026. This includes managing accounts on platforms like TikTok, Instagram, or similar services. Bright Data proxies cannot be used for this purpose. See [Acceptable Use Policy](https://brightdata.com/acceptable-use-policy) for details.
</Warning>

## DICloak Proxy Integration

DICloak is a powerful anti-detect browser designed to provide secure and anonymous internet browsing. It offers dynamic fingerprinting, profile management, and robust proxy support, making it an essential tool for professionals seeking enhanced privacy and data collection capabilities.

## DICloak and Bright Data: A Powerful Integration for Secure Browsing

Integrating DICloak with Bright Data’s proxy solutions creates a robust combination for privacy-focused professionals. Here’s how Bright Data enhances DICloak:

* **Global Proxy Coverage:** Access 400M+ monthly residential IPs across 195+ countries for region-specific browsing, the largest proxy network in the world.
* **Enhanced Privacy:** Secure and anonymous browsing with reliable proxy support.
* **Geo-Bypassing:** Easily access restricted content for international projects.
* **Optimized Speed:** High-performance proxies ensure fast connections.
* **Versatile Applications:** Suitable for web scraping, data collection, and more.

Integrating DICloak with Bright Data's proxy services ensures optimal performance and security for your web scraping and browsing tasks. This article provides a step-by-step guide to integrate Bright Data with DICloak seamlessly.

## How to Integrate Bright Data With DICloak

<Steps>
  <Step title="Download and Install DICloak">
    1. [Download](https://dicloak.com/download) the DICloak browser suitable for your operating system.

    <Frame>
      <img alt="download-dicloak" />
    </Frame>

    2. Install DICloak and launch the app.

    <Frame>
      <img alt="launch-dicloak" />
    </Frame>
  </Step>

  <Step title="Create a New Profile">
    1. Click on the **+ Create Profile** button.

    <Frame>
      <img alt="create-profile" />
    </Frame>

    2. Set up the basic profile:

    * Enter a **Profile Name**.
    * Choose the browser and operating system.

    <Frame>
      <img alt="setup-basic-profile" />
    </Frame>
  </Step>

  <Step title="Proxy Configuration in DICloak">
    1. Scroll down to the **Proxy** section and set proxy details:

    * From the **Proxy Type** dropdown, select `HTTP`.

    <Frame>
      <img alt="proxy-config" />
    </Frame>

    2. Enter the following details:

       * **Host:** `brd.superproxy.io`
       * **Port:** `44445`
       * **Account Name:** Enter your Bright Data username.
       * **Password:** Enter your Bright Data password.

       <Tip>
         Learn how to find your Bright Data username and password in [this guide](/integrations/bright-data).
       </Tip>

    <Frame>
      <img alt="proxy-connection" />
    </Frame>
  </Step>

  <Step title="Test your Proxy">
    1. Click on the **Check Proxy** button to test the connection.

    <Frame>
      <img alt="check-proxy" />
    </Frame>

    2. Ensure the connection test is successful and confirm the settings.

    <Frame>
      <img alt="proxy-test-success" />
    </Frame>
  </Step>

  <Step title="Start Browsing">
    1. To use the proxy, click on the **Open** button.

    <Frame>
      <img alt="open-browser" />
    </Frame>

    2. A browser will open with your preferred settings and the configured proxy.

    <Frame>
      <img alt="browser-open" />
    </Frame>
  </Step>
</Steps>

***

## What else to keep in mind

* **Session Control:** Bright Data allows session customization. Configure session persistence to maintain the same IP or rotate IPs as needed for your tasks.
* **Proxy Pooling:** Utilize Bright Data’s proxy pool for larger data collection projects.
* **DICloak Enhancements:** Leverage DICloak’s unique anti-detect features to mimic human-like browsing behavior.

By following this guide, you can effectively integrate Bright Data with DICloak for secure, efficient, and anonymous browsing and data collection.


# Set up Bright Data with Dolphin Anty
Source: https://docs.brightdata.com/integrations/dolphin-anty

Configure Bright Data proxies (400M+ IPs) in Dolphin Anty to add anti-detection-grade IP rotation to your multi-account browsing and data collection.

<Warning>
  **Account management is not a supported use case** on the Bright Data platform as of April 1, 2026. This includes managing accounts on platforms like TikTok, Instagram, or similar services. Bright Data proxies cannot be used for this purpose. See [Acceptable Use Policy](https://brightdata.com/acceptable-use-policy) for details.
</Warning>

<Accordion title="Expand to get your Bright Data Proxy Access Information">
  ### Your proxy access information

  Bright Data proxies are grouped in "Proxy zones". Each zone holds the configuration for the proxies it holds.

  To get access to the proxy zone:

  1. Login to Bright Data control panel
  2. Select the proxy zone or setup a new one
  3. Click on the new zone name, and select the **Overview** tab.
  4. In the overview tab, under **Access details** you can find the proxy access details, and copy them to clipboard on click.
  5. You will need: Proxy Host, Proxy Port, Proxy Zone username and Proxy Zone password.
  6. Click on the copy icons to copy the text to your clipboard and paste in your tool's proxy configuration.

  ### Access Details Section Example

  <img alt="" />

  ### Residential proxy access

  To access Bright Data's **Residential Proxies** you must be a KYC-verified business account. Complete KYC verification with the Bright Data compliance team; there is no automatic or no-KYC path. Without KYC, use ISP or Datacenter proxies. [Read more...](/proxy-networks/residential/network-access)

  ### Targeting search engines?

  If you target a search engine like google, bing or yandex, you need a special Search Engine Results Page (**SERP**) proxy API. Use Bright Data SERP API to target search engines.
  [Click here to read more about Bright Data SERP proxy API.](/scraping-automation/serp-api/introduction)

  ### Correct setup of proxy test to avoid "PROXY ERROR"

  In many tools you will see a "test proxy" function, which performs a conncectivity test to your proxy, and some add a geolocation test as well, to identify the location of the proxy.
  To correctly test your proxy you should target those search queries to:
  `https://geo.brdtest.com/welcome.txt` .

  Some tools use popular search engines (like google.com) as a default test target. Bright Data will block those requests and you tool will show **proxy error** although your proxy is perfectly fine.

  If your proxy test fails, this is probably the reason. Make sure that your test domain is not a search engine (this is done in the tool configuration, and not controlled by Bright Data).
</Accordion>

## What is Dolphin Anty?

Dolphin Anty is an easy-to-use, anti-detection browser built for marketers, researchers, and data professionals who need secure, anonymous browsing for data collection and competitive intelligence. It creates unique digital fingerprints for each profile, like IP addresses and device types, so platforms can’t link profiles to the same user. With Dolphin Anty, you can securely collect web data, conduct market research, and manage affiliate marketing workflows, all without worrying about blocks or detection.

<Tip>
  Maintain a consistent IP throughout your browser session by using the `-session` parameter in your username. This is essential because BrightData proxies default to rotating IPs with each request. [Learn more](/proxy-networks/faqs#how-to-use-the-same-ip-for-an-extended-period-of-time-and-how-long-can-i-keep-it-long-session) <br />

  New users should begin with ISP or Datacenter proxies, which need no KYC. Residential proxies require a [KYC-verified business account](/proxy-networks/residential/network-access).<br />
</Tip>

## Dolphin Anty Proxy Integration

Here’s a quick guide to get you started:

### Step 1. **Download Dolphin Anty.**

Visit the [Dolphin Anty website](https://dolphin-anty.com/) to download and install the software.

### Step 2. **Create and Log into Your Account.**

After installing Dolphin Anty, open the app, create your account, and log in.

### Step 3. **Create a New Profile.**

Click on **+ CREATE PROFILE** to start setting up your new browsing environment.

### Step 4. **Add a New Proxy.**

Scroll down to the **NEW PROXY** section to begin configuring your Bright Data proxy.

### Step 5. **Configure Your Bright Data Proxy.**

Follow this format for entering your proxy details: `type://host:port:username:password`

* **Type**: Choose `HTTP` or `SOCKS5` (based on your proxy type).
* **Host**: Enter [`http://brd.superproxy.io/`.](http://brd.superproxy.io/.)
* **Port**: Use the port number provided in your [Bright Data dashboard](https://brightdata.com/cp/zones).
* **Username**: Enter your Bright Data proxy `username`.
* **Password**: Enter your Bright Data proxy `password`.

Click the **⮂ Test Connection** button to verify the connection.

<Info>
  **For country-specific proxies, you can enter a format like `your-username-country-US` to receive a US exit node.**
</Info>

### Step 6. **Save Your Settings.**

Once everything is in place, click **+ CREATE** to save your profile.

***

And you're all set! You've successfully integrated Bright Data proxies with Dolphin Anty.


# Firefox proxy configuration
Source: https://docs.brightdata.com/integrations/firefox

Step-by-step guide to configuring Bright Data proxies (port 44445) in Firefox for privacy, geo-bypass and managing multiple browser sessions or accounts.

<Accordion title="Expand to get your Bright Data Proxy Access Information">
  ### Your proxy access information

  Bright Data proxies are grouped in "Proxy zones". Each zone holds the configuration for the proxies it holds.

  To get access to the proxy zone:

  1. Login to Bright Data control panel
  2. Select the proxy zone or setup a new one
  3. Click on the new zone name, and select the **Overview** tab.
  4. In the overview tab, under **Access details** you can find the proxy access details, and copy them to clipboard on click.
  5. You will need: Proxy Host, Proxy Port, Proxy Zone username and Proxy Zone password.
  6. Click on the copy icons to copy the text to your clipboard and paste in your tool's proxy configuration.

  ### Access Details Section Example

  <img alt="" />

  ### Residential proxy access

  To access Bright Data's **Residential Proxies** you must be a KYC-verified business account. Complete KYC verification with the Bright Data compliance team; there is no automatic or no-KYC path. Without KYC, use ISP or Datacenter proxies. [Read more...](/proxy-networks/residential/network-access)

  ### Targeting search engines?

  If you target a search engine like google, bing or yandex, you need a special Search Engine Results Page (**SERP**) proxy API. Use Bright Data SERP API to target search engines.
  [Click here to read more about Bright Data SERP proxy API.](/scraping-automation/serp-api/introduction)

  ### Correct setup of proxy test to avoid "PROXY ERROR"

  In many tools you will see a "test proxy" function, which performs a conncectivity test to your proxy, and some add a geolocation test as well, to identify the location of the proxy.
  To correctly test your proxy you should target those search queries to:
  `https://geo.brdtest.com/welcome.txt` .

  Some tools use popular search engines (like google.com) as a default test target. Bright Data will block those requests and you tool will show **proxy error** although your proxy is perfectly fine.

  If your proxy test fails, this is probably the reason. Make sure that your test domain is not a search engine (this is done in the tool configuration, and not controlled by Bright Data).
</Accordion>

<Warning>
  **Account management is not a supported use case** on the Bright Data platform as of April 1, 2026. This includes managing accounts on platforms like TikTok, Instagram, or similar services. Bright Data proxies cannot be used for this purpose. See [Acceptable Use Policy](https://brightdata.com/acceptable-use-policy) for details.
</Warning>

<Tip>
  Maintain a consistent IP throughout your browser session by using the `-session` parameter in your username. This is essential because BrightData proxies default to rotating IPs with each request. [Learn more](/proxy-networks/faqs#how-to-use-the-same-ip-for-an-extended-period-of-time-and-how-long-can-i-keep-it-long-session)

  New users should begin with ISP or Datacenter proxies, which need no KYC. Residential proxies require a [KYC-verified business account](/proxy-networks/residential/network-access).
</Tip>

## Changing Proxy Settings in Firefox

Take control of your Firefox browsing experience! Setting up proxies is easy, just follow these clear steps to get started:

<Steps>
  <Step title="Access Firefox Settings">
    Launch Firefox and click on the **menu icon** (three horizontal lines) located in the top-right corner.\
    From the dropdown, select **Settings** to access the browser's configuration menu.

    <Frame>
      <img alt="Changing Proxy Settings in Firefox" />
    </Frame>
  </Step>

  <Step title="Go to Network Settings">
    Scroll down within the settings menu until you find the **Network Settings** section.\
    Click on **Settings** to open the proxy configuration window.

    <Frame>
      <img alt="Changing Proxy Settings in Firefox" />
    </Frame>
  </Step>

  <Step title="Set Up Proxy Configuration">
    In the proxy settings window, do the following:

    1. Select **Manual proxy configuration** to enable custom proxy settings.
    2. Provide the necessary information:

    * **HTTP Proxy**: Input `http://brd.superproxy.io/`.
    * **Port**: Enter the port number displayed in your [Bright Data dashboard](https://brightdata.com/cp/zones).

    1. (Optional) Enable **Use this proxy server for all protocols** to apply the same proxy across all connection types.
    2. For SOCKS proxies, select **SOCKS v5** and fill in the appropriate server details.
  </Step>

  <Step title="Authenticate When Needed">
    When you access a website, Firefox might ask you for authentication credentials.\
    Enter your **Username** and **Password** from your Bright Data account when prompted.
  </Step>
</Steps>

### Getting "Software is Preventing Firefox From Safely Connecting to this site" Error?

You are probably trying to access a website which is blocked by Bright Data policy. We often see this when trying to access [google.com](http://google.com) via our datacenter, ISP, residential or mobile proxies. Try a a different website ; we recommend to test your proxy connection with our test website: [https://geo.brdtest.com/welcome.txt](https://geo.brdtest.com/welcome.txt) .

And that’s it! Your Firefox browser is now configured with **Bright Data**, opening the door to a secure and private browsing experience. Whether you’re managing accounts, running essential tasks, or simply enjoying unrestricted access to the web, you’re all set for a faster, safer, and more reliable online journey.


# How to set up Bright Data with FoxyProxy
Source: https://docs.brightdata.com/integrations/foxyproxy

Step-by-step guide to configuring Bright Data proxies (port 44445) in FoxyProxy for browser-based scraping, app testing and rule-based proxy switching.

<Accordion title="Expand to get your Bright Data Proxy Access Information">
  ### Your proxy access information

  Bright Data proxies are grouped in "Proxy zones". Each zone holds the configuration for the proxies it holds.

  To get access to the proxy zone:

  1. Login to Bright Data control panel
  2. Select the proxy zone or setup a new one
  3. Click on the new zone name, and select the **Overview** tab.
  4. In the overview tab, under **Access details** you can find the proxy access details, and copy them to clipboard on click.
  5. You will need: Proxy Host, Proxy Port, Proxy Zone username and Proxy Zone password.
  6. Click on the copy icons to copy the text to your clipboard and paste in your tool's proxy configuration.

  ### Access Details Section Example

  <img alt="" />

  ### Residential proxy access

  To access Bright Data's **Residential Proxies** you must be a KYC-verified business account. Complete KYC verification with the Bright Data compliance team; there is no automatic or no-KYC path. Without KYC, use ISP or Datacenter proxies. [Read more...](/proxy-networks/residential/network-access)

  ### Targeting search engines?

  If you target a search engine like google, bing or yandex, you need a special Search Engine Results Page (**SERP**) proxy API. Use Bright Data SERP API to target search engines.
  [Click here to read more about Bright Data SERP proxy API.](/scraping-automation/serp-api/introduction)

  ### Correct setup of proxy test to avoid "PROXY ERROR"

  In many tools you will see a "test proxy" function, which performs a conncectivity test to your proxy, and some add a geolocation test as well, to identify the location of the proxy.
  To correctly test your proxy you should target those search queries to:
  `https://geo.brdtest.com/welcome.txt` .

  Some tools use popular search engines (like google.com) as a default test target. Bright Data will block those requests and you tool will show **proxy error** although your proxy is perfectly fine.

  If your proxy test fails, this is probably the reason. Make sure that your test domain is not a search engine (this is done in the tool configuration, and not controlled by Bright Data).
</Accordion>

## What is FoxyProxy?

**FoxyProxy** is a versatile browser extension available for Chrome and Firefox, designed to simplify proxy management. With just a few clicks, it lets you switch between multiple proxy servers while leveraging the browser's built-in proxy API. Whether you're scraping data, testing applications, or enhancing your online privacy, FoxyProxy offers an intuitive and efficient solution to handle proxies with ease.

## How to Integrate Bright Data With FoxyProxy

<Steps>
  <Step title="Install FoxyProxy Extension">
    1. **For Chrome**: Visit the [Chrome Web Store](https://chromewebstore.google.com/detail/foxyproxy/gcknhkkoolaabfmlnjonogaaifnjlfnp) and click **Add to Chrome**.
    2. **For Firefox**: Go to the [Mozilla Add-ons page](https://addons.mozilla.org/en-US/firefox/addon/foxyproxy-standard/) and select **Add to Firefox**.

    Once installed, you’ll see the FoxyProxy icon in your browser’s toolbar.
  </Step>

  <Step title="Open FoxyProxy Settings">
    1. Click on the FoxyProxy icon in the toolbar and choose **Options** from the dropdown menu.
    2. This will open the FoxyProxy settings page where you can manage your proxy configurations.

    <Frame>
      <img alt="How to Integrate Bright Data With FoxyProxy" />
    </Frame>
  </Step>

  <Step title="Add a New Proxy Configuration">
    1. Navigate to the **Proxies** tab in the FoxyProxy settings menu.
    2. Click on the **Add** button to open the proxy configuration window.

    <Frame>
      <img alt="How to Integrate Bright Data With FoxyProxy" />
    </Frame>
  </Step>

  <Step title="Input Bright Data Proxy Details">
    1. In the proxy setup form, enter your Bright Data credentials as follows:
       * **Type**: Select `HTTP`, `HTTPS`, or `SOCKS5` based on your proxy type.
       * **Hostname**: Enter `http://brd.superproxy.io/`.
       * **Port**: Use the port number provided in your [Bright Data dashboard](https://brightdata.com/cp/zones/page/plans).
       * **Username**: Enter your Bright Data username.
       * **Password**: Enter your Bright Data password.
    2. Once all details are entered, click **Save** to store the proxy configuration.

    <Note>
      To use a proxy from a specific location, add the country code to your username (e.g., `your-username-country-US` for a US-based proxy).
    </Note>
  </Step>

  <Step title="Activate and Test Your Proxy">
    1. To enable your configured proxy, click the FoxyProxy icon in your toolbar and select the proxy you just created.
    2. Verify the connection by visiting [httpbin.org/ip](http://httpbin.org/ip). The IP address displayed should match your Bright Data proxy.
    3. Note: if you are working with Bright Data Datacenter and ISP proxies you will be allowed to see the proxy IP address. Residential proxies may be blocked by our policy, and you may receive an error. To see your residential proxy details (including location) browse to: [https://geo.brdtest.com/welcome.txt?product=resi\&method=native](https://geo.brdtest.com/welcome.txt?product=resi\&method=native).

    <Frame>
      <img alt="How to Integrate Bright Data With FoxyProxy" />
    </Frame>
  </Step>
</Steps>

With FoxyProxy and Bright Data configured, you’re now set to enjoy secure, seamless browsing and efficient web operations. Whether you're conducting tests, scraping data, or simply enhancing your privacy, this setup makes proxy management effortless.


# How to use Bright Data with Geelark
Source: https://docs.brightdata.com/integrations/geelark

Integrate Bright Data proxies (195 countries) with Geelark cloud phones to run anonymous, geo-targeted mobile sessions for multi-account workflows.

<Warning>
  **Account management is not a supported use case** on the Bright Data platform as of April 1, 2026. This includes managing accounts on platforms like TikTok, Instagram, or similar services. Bright Data proxies cannot be used for this purpose. See [Acceptable Use Policy](https://brightdata.com/acceptable-use-policy) for details.
</Warning>

<Accordion title="Expand to get your Bright Data Proxy Access Information">
  ### Your proxy access information

  Bright Data proxies are grouped in "Proxy zones". Each zone holds the configuration for the proxies it holds.

  To get access to the proxy zone:

  1. Login to Bright Data control panel
  2. Select the proxy zone or setup a new one
  3. Click on the new zone name, and select the **Overview** tab.
  4. In the overview tab, under **Access details** you can find the proxy access details, and copy them to clipboard on click.
  5. You will need: Proxy Host, Proxy Port, Proxy Zone username and Proxy Zone password.
  6. Click on the copy icons to copy the text to your clipboard and paste in your tool's proxy configuration.

  ### Access Details Section Example

  <img alt="" />

  ### Residential proxy access

  To access Bright Data's **Residential Proxies** you must be a KYC-verified business account. Complete KYC verification with the Bright Data compliance team; there is no automatic or no-KYC path. Without KYC, use ISP or Datacenter proxies. [Read more...](/proxy-networks/residential/network-access)

  ### Targeting search engines?

  If you target a search engine like google, bing or yandex, you need a special Search Engine Results Page (**SERP**) proxy API. Use Bright Data SERP API to target search engines.
  [Click here to read more about Bright Data SERP proxy API.](/scraping-automation/serp-api/introduction)

  ### Correct setup of proxy test to avoid "PROXY ERROR"

  In many tools you will see a "test proxy" function, which performs a conncectivity test to your proxy, and some add a geolocation test as well, to identify the location of the proxy.
  To correctly test your proxy you should target those search queries to:
  `https://geo.brdtest.com/welcome.txt` .

  Some tools use popular search engines (like google.com) as a default test target. Bright Data will block those requests and you tool will show **proxy error** although your proxy is perfectly fine.

  If your proxy test fails, this is probably the reason. Make sure that your test domain is not a search engine (this is done in the tool configuration, and not controlled by Bright Data).
</Accordion>

<Tip>
  Maintain a consistent IP throughout your browser session by using the `-session` parameter in your username. This is essential because BrightData proxies default to rotating IPs with each request. [Learn more](/proxy-networks/faqs#how-to-use-the-same-ip-for-an-extended-period-of-time-and-how-long-can-i-keep-it-long-session) <br />

  New users should begin with ISP or Datacenter proxies, which need no KYC. Residential proxies require a [KYC-verified business account](/proxy-networks/residential/network-access).<br />
</Tip>

## What is Geelark?

**Geelark** is a versatile browser profile management tool designed for privacy-conscious users and professionals. It allows you to create isolated browser environments, manage multiple browser profiles, and customize browsing to suit your needs. With Bright Data, you can take your Geelark profiles to the next level by ensuring anonymity, bypassing restrictions, and accessing geo-specific content.

## How to Integrate Bright Data With Geelark

<Steps>
  <Step title="Prerequisites">
    1. **Bright Data Proxy Credentials**:
       * Log in to your [Bright Data dashboard](https://brightdata.com/cp/zones) to get your **Host**, **Port**, **Username**, and **Password**.
       * Use a geo-specific username if you need a proxy from a specific location (e.g., `your-username-country-US`).

    2. **Geelark Installed**:
       * Download and install Geelark from [geelark.com](https://geelark.com/).
       * Launch Geelark and log in using your account credentials.
       * If you don’t have an account, click on **Sign Up** to create one.
  </Step>

  <Step title="Create and Configure a New Profile">
    1. On the Geelark dashboard, click on **New Profile**.
    2. Enter a **Name** and select the desired operating system for the profile.

    <Frame>
      <img alt="How to Integrate Bright Data With Geelark" />
    </Frame>
  </Step>

  <Step title="Configure Proxy Settings">
    1. In the **Proxy Settings** section, select the **Custom** option.

    2. Choose the **Proxy Type** (HTTP, HTTPS, or SOCKS5) based on your Bright Data configuration.

    3. Enter the following Bright Data proxy details:
       * **Proxy Host**: `http://brd.superproxy.io/`.
       * **Port**: Use the port number provided in your [Bright Data dashboard](https://brightdata.com/cp/zones).
       * **Username**: Your Bright Data `username`.
       * **Password**: Your Bright Data `password`.

    4. Click on **Check Proxy** to verify the proxy settings. Ensure the connection is successful before proceeding.
  </Step>

  <Step title="Save and Launch the Profile">
    1. After configuring the proxy settings, click on **OK** to save the profile.
    2. On the Geelark dashboard, locate the newly created profile and click on **Start** to launch it.

    <Frame>
      <img alt="How to Integrate Bright Data With Geelark" />
    </Frame>
  </Step>

  <Step title="Test Your Setup">
    1. Within the launched profile, open a web browser.
    2. Navigate to [httpbin.org/ip](http://httpbin.org/ip) to verify that your IP address reflects the Bright Data, confirming that the setup is successful.
  </Step>
</Steps>

Integrating Bright Data with Geelark gives you a powerful combination of privacy, control, and efficiency. Whether you’re managing multiple browser profiles, accessing geo-restricted content, or ensuring secure connections, Bright Data helps you achieve your goals seamlessly. Try it out today and elevate your Geelark experience!


# How to use Bright Data with GenLogin
Source: https://docs.brightdata.com/integrations/genlogin

Configure Bright Data proxies (400M+ IPs) in GenLogin to manage multiple browser profiles with isolated fingerprints and geo-targeted IPs.

<Warning>
  **Account management is not a supported use case** on the Bright Data platform as of April 1, 2026. This includes managing accounts on platforms like TikTok, Instagram, or similar services. Bright Data proxies cannot be used for this purpose. See [Acceptable Use Policy](https://brightdata.com/acceptable-use-policy) for details.
</Warning>

<Accordion title="Expand to get your Bright Data Proxy Access Information">
  ### Your proxy access information

  Bright Data proxies are grouped in "Proxy zones". Each zone holds the configuration for the proxies it holds.

  To get access to the proxy zone:

  1. Login to Bright Data control panel
  2. Select the proxy zone or setup a new one
  3. Click on the new zone name, and select the **Overview** tab.
  4. In the overview tab, under **Access details** you can find the proxy access details, and copy them to clipboard on click.
  5. You will need: Proxy Host, Proxy Port, Proxy Zone username and Proxy Zone password.
  6. Click on the copy icons to copy the text to your clipboard and paste in your tool's proxy configuration.

  ### Access Details Section Example

  <img alt="" />

  ### Residential proxy access

  To access Bright Data's **Residential Proxies** you must be a KYC-verified business account. Complete KYC verification with the Bright Data compliance team; there is no automatic or no-KYC path. Without KYC, use ISP or Datacenter proxies. [Read more...](/proxy-networks/residential/network-access)

  ### Targeting search engines?

  If you target a search engine like google, bing or yandex, you need a special Search Engine Results Page (**SERP**) proxy API. Use Bright Data SERP API to target search engines.
  [Click here to read more about Bright Data SERP proxy API.](/scraping-automation/serp-api/introduction)

  ### Correct setup of proxy test to avoid "PROXY ERROR"

  In many tools you will see a "test proxy" function, which performs a conncectivity test to your proxy, and some add a geolocation test as well, to identify the location of the proxy.
  To correctly test your proxy you should target those search queries to:
  `https://geo.brdtest.com/welcome.txt` .

  Some tools use popular search engines (like google.com) as a default test target. Bright Data will block those requests and you tool will show **proxy error** although your proxy is perfectly fine.

  If your proxy test fails, this is probably the reason. Make sure that your test domain is not a search engine (this is done in the tool configuration, and not controlled by Bright Data).
</Accordion>

## What is GenLogin?

<Tip>
  Maintain a consistent IP throughout your browser session by using the `-session` parameter in your username. This is essential because BrightData proxies default to rotating IPs with each request. [Learn more](/proxy-networks/faqs#how-to-use-the-same-ip-for-an-extended-period-of-time-and-how-long-can-i-keep-it-long-session) <br />

  New users should begin with ISP or Datacenter proxies, which need no KYC. Residential proxies require a [KYC-verified business account](/proxy-networks/residential/network-access).<br />
</Tip>

**GenLogin** is an advanced browser profile management tool designed for professionals handling multiple browser profiles or projects. It enables the creation of isolated browser environments, ensuring each profile operates securely and independently. By integrating **Bright Data**, you can enhance GenLogin’s capabilities with reliable, anonymous proxy connections.

## How to Integrate Bright Data With GenLogin

<Steps>
  <Step title="Download and Open GenLogin">
    1. Visit the [GenLogin website](https://genlogin.com/) and download the application compatible with your operating system.
    2. Install GenLogin by following the on-screen instructions and launch the application.
    3. Log in to your GenLogin account. If you don’t have one, sign up for free.
  </Step>

  <Step title="Create or Edit a Browser Profile">
    1. From the GenLogin dashboard, click **Create Profile** to create a new profile or select an existing one to edit.
    2. In the profile settings, give your profile a unique and recognizable name in the **Name** field.

    <Frame>
      <img alt="How to Integrate Bright Data With GenLogin" />
    </Frame>
  </Step>

  <Step title="Configure Proxy Settings">
    1. Scroll to the **Network** section in the profile setup.

    2. Choose **Your Proxy** and input your Bright Data details:
       * **Proxy Type**: Select HTTP, HTTPS, or SOCKS5.
       * **Proxy Host**: Enter `http://brd.superproxy.io/`.
       * **Proxy Port**: Use the port provided in your [Bright Data dashboard](https://brightdata.com/cp/zones/page/plans).
       * **Username**: Input your Bright Data username.
       * **Password**: Enter your Bright Data password.

    3. To ensure accuracy, click **Check Proxy** to verify the connection.
  </Step>

  <Step title="Save and Launch the Profile">
    1. Once the proxy details are successfully verified, click **Create profile** to apply the settings.
    2. Navigate to the **Profiles** section and find the profile you just created.
    3. Click **Start** to open the browser with the configured settings.

    <Frame>
      <img alt="How to Integrate Bright Data With GenLogin" />
    </Frame>
  </Step>

  <Step title="Verify Proxy Connection">
    1. Within the launched profile, open a browser and navigate to [httpbin.org/ip](http://httpbin.org/ip).
    2. Confirm that the displayed IP matches your Bright Data proxy, verifying the setup.
  </Step>
</Steps>

Integrating Bright Data with GenLogin enhances your ability to manage multiple accounts securely and efficiently. With Bright Data’s reliable proxies and GenLogin’s robust browser profile management, you can achieve unparalleled privacy and productivity. Start leveraging the power of Bright Data and GenLogin today!


# Set up Bright Data with Ghost Browser
Source: https://docs.brightdata.com/integrations/ghost-browser

Configure Bright Data proxies in Ghost Browser to route multi-session browsing through residential, datacenter, ISP, or mobile IPs. Spans 195 countries.

<Warning>
  **Account management is not a supported use case** on the Bright Data platform as of April 1, 2026. This includes managing accounts on platforms like TikTok, Instagram, or similar services. Bright Data proxies cannot be used for this purpose. See [Acceptable Use Policy](https://brightdata.com/acceptable-use-policy) for details.
</Warning>

<Accordion title="Expand to get your Bright Data Proxy Access Information">
  ### Your proxy access information

  Bright Data proxies are grouped in "Proxy zones". Each zone holds the configuration for the proxies it holds.

  To get access to the proxy zone:

  1. Login to Bright Data control panel
  2. Select the proxy zone or setup a new one
  3. Click on the new zone name, and select the **Overview** tab.
  4. In the overview tab, under **Access details** you can find the proxy access details, and copy them to clipboard on click.
  5. You will need: Proxy Host, Proxy Port, Proxy Zone username and Proxy Zone password.
  6. Click on the copy icons to copy the text to your clipboard and paste in your tool's proxy configuration.

  ### Access Details Section Example

  <img alt="" />

  ### Residential proxy access

  To access Bright Data's **Residential Proxies** you must be a KYC-verified business account. Complete KYC verification with the Bright Data compliance team; there is no automatic or no-KYC path. Without KYC, use ISP or Datacenter proxies. [Read more...](/proxy-networks/residential/network-access)

  ### Targeting search engines?

  If you target a search engine like google, bing or yandex, you need a special Search Engine Results Page (**SERP**) proxy API. Use Bright Data SERP API to target search engines.
  [Click here to read more about Bright Data SERP proxy API.](/scraping-automation/serp-api/introduction)

  ### Correct setup of proxy test to avoid "PROXY ERROR"

  In many tools you will see a "test proxy" function, which performs a conncectivity test to your proxy, and some add a geolocation test as well, to identify the location of the proxy.
  To correctly test your proxy you should target those search queries to:
  `https://geo.brdtest.com/welcome.txt` .

  Some tools use popular search engines (like google.com) as a default test target. Bright Data will block those requests and you tool will show **proxy error** although your proxy is perfectly fine.

  If your proxy test fails, this is probably the reason. Make sure that your test domain is not a search engine (this is done in the tool configuration, and not controlled by Bright Data).
</Accordion>

## What is Ghost Browser?

<Tip>
  Maintain a consistent IP throughout your browser session by using the `-session` parameter in your username. This is essential because BrightData proxies default to rotating IPs with each request. [Learn more](/proxy-networks/faqs#how-to-use-the-same-ip-for-an-extended-period-of-time-and-how-long-can-i-keep-it-long-session) <br />

  New users should begin with ISP or Datacenter proxies, which need no KYC. Residential proxies require a [KYC-verified business account](/proxy-networks/residential/network-access).<br />
</Tip>

<Warning>
  Connections to the following social networks are not supported on Data Center and ISP proxy networks: Facebook, TikTok, Instagram, X (Twitter), LinkedIn, YouTube, Reddit, Pinterest, Snapchat, and Discord.
</Warning>

Ghost Browser is a productivity-driven web browser designed for users who need to manage multiple online accounts effortlessly. With its unique multi-session feature, you can open separate tabs, each acting as an independent browser session. This means you can log into multiple accounts on the same platform at once, without any cross-session interference.

While it doesn’t focus on advanced anti-detection features, Ghost Browser is ideal for those who want a simple, organized workflow. It’s perfect for professionals juggling multiple accounts or projects, all in one streamlined interface.

## Ghost Browser Proxy Integration

Here’s how to integrate Bright Data proxies into Ghost Browser:

<Steps>
  <Step title="Install Ghost Browser">
    1. Download and install [**Ghost Browser**](https://ghostbrowser.com/download/).
    2. Once installed, log in to your account to access the main interface.
  </Step>

  <Step title="Access Ghost Proxy Control">
    1. Click the **Ghost Proxy Control** icon in the top-right corner of the browser.
    2. Select **Add/Edit Proxies**.

    <Frame>
      <img alt="Ghost Browser Proxy Integration" />
    </Frame>
  </Step>

  <Step title="Add a New Proxy">
    In the **Proxy Manager**, select the option to **Add a Single Proxy**.

    <Frame>
      <img alt="Ghost Browser Proxy Integration" />
    </Frame>
  </Step>

  <Step title="Configure Your Bright Data Proxy">
    In the proxy setup window, fill out the fields with your Bright Data proxy details:

    * **Name**: Optional – give your proxy a descriptive name (e.g., "Bright Data").
    * **Host**: Enter `http://brd.superproxy.io/`.
    * **Port**: Use the port number provided in your [Bright Data dashboard](https://brightdata.com/cp/zones).
    * **Username**: Enter your Bright Data proxy `username`.
    * **Password**: Enter your Bright Data proxy `password`.

    Click **Add Proxy** to save your settings.

    <Info>
      For country-specific proxies, you can enter a format like `your-username-country-US` to receive a US exit node.
    </Info>
  </Step>

  <Step title="Activate Proxy in Ghost Browser">
    1. Go back to the **Ghost Proxy Control** menu.
    2. Select your newly added Bright Data proxy under the **Active Identity** and **Active Workspace** settings.
    3. Then, reload your tabs to apply the selected proxy to your browsing session.
  </Step>
</Steps>

**And that’s it!** Your Bright Data proxy is now integrated with Ghost Browser.


# How to set up Bright Data with GoLogin
Source: https://docs.brightdata.com/integrations/gologin

Configure Bright Data proxies (400M+ IPs) in GoLogin to route multi-profile browsing through residential, datacenter, ISP or mobile IPs for collection.

<Warning>
  **Account management is not a supported use case** on the Bright Data platform as of April 1, 2026. This includes managing accounts on platforms like TikTok, Instagram, or similar services. Bright Data proxies cannot be used for this purpose. See [Acceptable Use Policy](https://brightdata.com/acceptable-use-policy) for details.
</Warning>

<Accordion title="Expand to get your Bright Data Proxy Access Information">
  ### Your proxy access information

  Bright Data proxies are grouped in "Proxy zones". Each zone holds the configuration for the proxies it holds.

  To get access to the proxy zone:

  1. Login to Bright Data control panel
  2. Select the proxy zone or setup a new one
  3. Click on the new zone name, and select the **Overview** tab.
  4. In the overview tab, under **Access details** you can find the proxy access details, and copy them to clipboard on click.
  5. You will need: Proxy Host, Proxy Port, Proxy Zone username and Proxy Zone password.
  6. Click on the copy icons to copy the text to your clipboard and paste in your tool's proxy configuration.

  ### Access Details Section Example

  <img alt="" />

  ### Residential proxy access

  To access Bright Data's **Residential Proxies** you must be a KYC-verified business account. Complete KYC verification with the Bright Data compliance team; there is no automatic or no-KYC path. Without KYC, use ISP or Datacenter proxies. [Read more...](/proxy-networks/residential/network-access)

  ### Targeting search engines?

  If you target a search engine like google, bing or yandex, you need a special Search Engine Results Page (**SERP**) proxy API. Use Bright Data SERP API to target search engines.
  [Click here to read more about Bright Data SERP proxy API.](/scraping-automation/serp-api/introduction)

  ### Correct setup of proxy test to avoid "PROXY ERROR"

  In many tools you will see a "test proxy" function, which performs a conncectivity test to your proxy, and some add a geolocation test as well, to identify the location of the proxy.
  To correctly test your proxy you should target those search queries to:
  `https://geo.brdtest.com/welcome.txt` .

  Some tools use popular search engines (like google.com) as a default test target. Bright Data will block those requests and you tool will show **proxy error** although your proxy is perfectly fine.

  If your proxy test fails, this is probably the reason. Make sure that your test domain is not a search engine (this is done in the tool configuration, and not controlled by Bright Data).
</Accordion>

## What is GoLogin?

<Tip>
  Maintain a consistent IP throughout your browser session by using the `-session` parameter in your username. This is essential because BrightData proxies default to rotating IPs with each request. [Learn more](/proxy-networks/faqs#how-to-use-the-same-ip-for-an-extended-period-of-time-and-how-long-can-i-keep-it-long-session) <br />

  New users should begin with ISP or Datacenter proxies, which need no KYC. Residential proxies require a [KYC-verified business account](/proxy-networks/residential/network-access).<br />
</Tip>

GoLogin is a powerful tool designed to make managing multiple accounts easy and secure. It allows you to create separate browser profiles, each with its own unique fingerprints, IPs, and cookies, making each profile appear like an individual user. This is perfect for marketers, researchers, and data professionals who need isolated browsing environments for web scraping and competitive analysis.

With GoLogin, you can integrate proxies, automate tasks, and switch between profiles seamlessly, all while keeping each account completely anonymous. It’s a flexible solution that helps ensure account safety, and with its collaboration features, teams can securely share profiles. Whether you’re focused on digital marketing, data scraping, or competitive intelligence, GoLogin is a fantastic choice.

## GoLogin Proxy Integration

Follow these steps to integrate Bright Data proxies with GoLogin:

<Steps>
  <Step title="Install GoLogin">
    Download and install GoLogin from the [GoLogin website](https://gologin.com/).
  </Step>

  <Step title="Create an Account">
    Log in to GoLogin to get started with the setup.
  </Step>

  <Step title="Create a New Profile">
    Click **+Add profile** and enter the basic details for your new browser profile.

    <Frame>
      <img alt="GoLogin Proxy Integration" />
    </Frame>
  </Step>

  <Step title="Configure Proxy Settings">
    Enter your Bright Data proxy details:

    * **Proxy Type**: Choose from `HTTP`, `HTTPS`, or `SOCKS5` (based on your proxy type).
    * **Host**: Enter `http://brd.superproxy.io/`.
    * **Port**: Use the port number provided in your [Bright Data dashboard](https://brightdata.com/cp/zones).
    * **Login**: Enter your Bright Data proxy `username`.
    * **Password**: Enter your Bright Data proxy `password`.

    <Info>
      **You can also specify a country for your proxy. For instance, entering `your-username-country-US` will give you a US-based exit node.**
    </Info>

    <Frame>
      <img alt="GoLogin Proxy Integration" />
    </Frame>
  </Step>

  <Step title="Test the Proxy">
    Click **Check Proxy** to make sure everything is working as expected.
  </Step>

  <Step title="Save and Launch">
    Click **Create Profile** to save your settings, and then hit **Run** to open your new profile with secure browsing.

    <Frame>
      <img alt="GoLogin Proxy Integration" />
    </Frame>
  </Step>
</Steps>

**And that's it!** You've now successfully integrated Bright Data proxies with GoLogin.


# Set up Bright Data with Helium Scraper
Source: https://docs.brightdata.com/integrations/helium-scraper

Configure Bright Data proxies in Helium Scraper to route web scraping jobs through residential, datacenter, ISP, or mobile IPs at scale. Spans 195 countries.

<Accordion title="Expand to get your Bright Data Proxy Access Information">
  ### Your proxy access information

  Bright Data proxies are grouped in "Proxy zones". Each zone holds the configuration for the proxies it holds.

  To get access to the proxy zone:

  1. Login to Bright Data control panel
  2. Select the proxy zone or setup a new one
  3. Click on the new zone name, and select the **Overview** tab.
  4. In the overview tab, under **Access details** you can find the proxy access details, and copy them to clipboard on click.
  5. You will need: Proxy Host, Proxy Port, Proxy Zone username and Proxy Zone password.
  6. Click on the copy icons to copy the text to your clipboard and paste in your tool's proxy configuration.

  ### Access Details Section Example

  <img alt="" />

  ### Residential proxy access

  To access Bright Data's **Residential Proxies** you must be a KYC-verified business account. Complete KYC verification with the Bright Data compliance team; there is no automatic or no-KYC path. Without KYC, use ISP or Datacenter proxies. [Read more...](/proxy-networks/residential/network-access)

  ### Targeting search engines?

  If you target a search engine like google, bing or yandex, you need a special Search Engine Results Page (**SERP**) proxy API. Use Bright Data SERP API to target search engines.
  [Click here to read more about Bright Data SERP proxy API.](/scraping-automation/serp-api/introduction)

  ### Correct setup of proxy test to avoid "PROXY ERROR"

  In many tools you will see a "test proxy" function, which performs a conncectivity test to your proxy, and some add a geolocation test as well, to identify the location of the proxy.
  To correctly test your proxy you should target those search queries to:
  `https://geo.brdtest.com/welcome.txt` .

  Some tools use popular search engines (like google.com) as a default test target. Bright Data will block those requests and you tool will show **proxy error** although your proxy is perfectly fine.

  If your proxy test fails, this is probably the reason. Make sure that your test domain is not a search engine (this is done in the tool configuration, and not controlled by Bright Data).
</Accordion>

## What is Helium Scraper?

Helium Scraper is an intuitive, desktop-based web scraping tool designed to help you extract data from websites without needing any coding skills. Its visual interface makes it easy to select, extract, and organize data, perfect for both beginners and experienced users alike.

Helium Scraper is ideal for small to medium-scale scraping projects. Whether you're a freelancer, marketer, or business professional, it provides an efficient and straightforward way to collect and structure web data without the complexity of programming.

## Helium Scraper Proxy Integration

Follow these simple steps to set up Bright Data proxies with Helium Scraper:

<Steps>
  <Step title="Install Helium Scraper">
    1. [Download Helium Scraper](https://www.heliumscraper.com/eng/download.php) and install it on your computer.
    2. Launch Helium Scraper once the installation is complete.
  </Step>

  <Step title="Access the Proxy List">
    In Helium Scraper, click on **File > Proxy List** to open the proxy configuration panel.

    <Frame>
      <img alt="Helium Scraper Proxy Integration" />
    </Frame>
  </Step>

  <Step title="Configure Your Bright Data Proxy">
    Add your Bright Data proxy details to the fields provided:

    * **Host**: Enter `http://brd.superproxy.io/`.
    * **Port**: Use the port number provided in your [Bright Data dashboard](https://brightdata.com/cp/zones).
    * **Username**: Enter your Bright Data proxy `username`.
    * **Password**: Enter your Bright Data proxy `password`.

    Click **OK** to store your proxy settings.

    <Info>
      **For country-specific proxies, you can enter a format like `your-username-country-US` to receive a US exit node.**
    </Info>
  </Step>

  <Step title="Enable Proxies for Your Project">
    1. Go to **Project > Settings** from the menu.

    <Frame>
      <img alt="Helium Scraper Proxy Integration" />
    </Frame>

    2. In the settings window, set **Enable Proxies** to **True**.

    <Frame>
      <img alt="Helium Scraper Proxy Integration" />
    </Frame>
  </Step>

  <Step title="Verify the Proxy Setup">
    1. Open a website that displays your IP address using Helium Scraper’s built-in browser.
    2. Check if the displayed IP matches the Bright Data proxy settings to confirm the proxy integration.
  </Step>
</Steps>

**That’s it!** You've now successfully integrated Bright Data proxies with Helium Scraper.


# Set up Bright Data with HideMyAcc
Source: https://docs.brightdata.com/integrations/hidemyacc

Configure Bright Data proxies in HideMyAcc to route multi-account browsing through residential, datacenter, ISP, or mobile IPs. Spans 195 countries.

<Warning>
  **Account management is not a supported use case** on the Bright Data platform as of April 1, 2026. This includes managing accounts on platforms like TikTok, Instagram, or similar services. Bright Data proxies cannot be used for this purpose. See [Acceptable Use Policy](https://brightdata.com/acceptable-use-policy) for details.
</Warning>

<Accordion title="Expand to get your Bright Data Proxy Access Information">
  ### Your proxy access information

  Bright Data proxies are grouped in "Proxy zones". Each zone holds the configuration for the proxies it holds.

  To get access to the proxy zone:

  1. Login to Bright Data control panel
  2. Select the proxy zone or setup a new one
  3. Click on the new zone name, and select the **Overview** tab.
  4. In the overview tab, under **Access details** you can find the proxy access details, and copy them to clipboard on click.
  5. You will need: Proxy Host, Proxy Port, Proxy Zone username and Proxy Zone password.
  6. Click on the copy icons to copy the text to your clipboard and paste in your tool's proxy configuration.

  ### Access Details Section Example

  <img alt="" />

  ### Residential proxy access

  To access Bright Data's **Residential Proxies** you must be a KYC-verified business account. Complete KYC verification with the Bright Data compliance team; there is no automatic or no-KYC path. Without KYC, use ISP or Datacenter proxies. [Read more...](/proxy-networks/residential/network-access)

  ### Targeting search engines?

  If you target a search engine like google, bing or yandex, you need a special Search Engine Results Page (**SERP**) proxy API. Use Bright Data SERP API to target search engines.
  [Click here to read more about Bright Data SERP proxy API.](/scraping-automation/serp-api/introduction)

  ### Correct setup of proxy test to avoid "PROXY ERROR"

  In many tools you will see a "test proxy" function, which performs a conncectivity test to your proxy, and some add a geolocation test as well, to identify the location of the proxy.
  To correctly test your proxy you should target those search queries to:
  `https://geo.brdtest.com/welcome.txt` .

  Some tools use popular search engines (like google.com) as a default test target. Bright Data will block those requests and you tool will show **proxy error** although your proxy is perfectly fine.

  If your proxy test fails, this is probably the reason. Make sure that your test domain is not a search engine (this is done in the tool configuration, and not controlled by Bright Data).
</Accordion>

<Tip>
  Maintain a consistent IP throughout your browser session by using the `-session` parameter in your username. This is essential because BrightData proxies default to rotating IPs with each request. [Learn more](/proxy-networks/faqs#how-to-use-the-same-ip-for-an-extended-period-of-time-and-how-long-can-i-keep-it-long-session) <br />

  New users should begin with ISP or Datacenter proxies, which need no KYC. Residential proxies require a [KYC-verified business account](/proxy-networks/residential/network-access).<br />
</Tip>

## What is HideMyAcc?

**HideMyAcc** is an advanced anti-detect browser designed for managing multiple accounts securely. It helps users bypass restrictions, maintain anonymity, and avoid detection by offering a private browsing environment. Integrating Bright Data enhances HideMyAcc's capabilities, providing secure and geo-targeted connections.

## How to Integrate Bright Data With HideMyAcc

<Steps>
  <Step title="Download and Install HideMyAcc">
    1. Visit the [HideMyAcc website](https://hidemyacc.com/) and download the software compatible with your operating system.
    2. Install the application and log in with your account credentials.
  </Step>

  <Step title="Create a New Profile">
    1. Open HideMyAcc and navigate to the **Profiles** tab.
    2. Click **Create a new profile** to set up a new browsing instance.

    <Frame>
      <img alt="How to Integrate Bright Data With HideMyAcc" />
    </Frame>
  </Step>

  <Step title="Enable Proxy Configuration">
    1. Locate the **Proxy** section within the profile creation page.
    2. In the profile settings, enter a **Profile Name** to easily identify it later.
    3. Toggle **Your Proxy** to activate the configuration options.

    <Frame>
      <img alt="How to Integrate Bright Data With HideMyAcc" />
    </Frame>
  </Step>

  <Step title="Add Your Bright Data Proxy Details">
    1. Go to your [Bright Data dashboard](https://brightdata.com/cp/zones) and click the proxy zone you would like to use.
    2. Under the **Overview** tab, copy the proxy access details code provided in the required format: `host:port:username:password.`
    3. Paste this code into the **Quick add** field in HideMyAcc .
    4. Use the **Check Proxy** option to verify the connection.
    5. Once the proxy configuration is verified, click **Create** to save your proxy settings.&#x20;

    <Note>
      For geo-specific proxies, format your username as `your-username-country-XX` (e.g., `your-username-country-US`) to target a specific region.
    </Note>
  </Step>

  <Step title="Launch the Profile">
    Navigate to the **Profiles** tab, select your newly created profile, and click **Run** to start browsing securely with Bright Data.

    <Frame>
      <img alt="How to Integrate Bright Data With HideMyAcc" />
    </Frame>
  </Step>
</Steps>

By integrating **Bright Data** with **HideMyAcc**, you can enjoy enhanced privacy and seamless account management. Whether you're managing multiple profiles or performing geo-targeted tasks, this setup ensures your browsing experience is secure and efficient. Start today for reliable, private browsing!


# How to set up Bright Data with Incogniton
Source: https://docs.brightdata.com/integrations/incogniton

Integrate Bright Data with Incogniton for secure, anonymous browsing with enhanced protection against detection and bans. Spans 195 countries.

<Warning>
  **Account management is not a supported use case** on the Bright Data platform as of April 1, 2026. This includes managing accounts on platforms like TikTok, Instagram, or similar services. Bright Data proxies cannot be used for this purpose. See [Acceptable Use Policy](https://brightdata.com/acceptable-use-policy) for details.
</Warning>

<Accordion title="Expand to get your Bright Data Proxy Access Information">
  ### Your proxy access information

  Bright Data proxies are grouped in "Proxy zones". Each zone holds the configuration for the proxies it holds.

  To get access to the proxy zone:

  1. Login to Bright Data control panel
  2. Select the proxy zone or setup a new one
  3. Click on the new zone name, and select the **Overview** tab.
  4. In the overview tab, under **Access details** you can find the proxy access details, and copy them to clipboard on click.
  5. You will need: Proxy Host, Proxy Port, Proxy Zone username and Proxy Zone password.
  6. Click on the copy icons to copy the text to your clipboard and paste in your tool's proxy configuration.

  ### Access Details Section Example

  <img alt="" />

  ### Residential proxy access

  To access Bright Data's **Residential Proxies** you must be a KYC-verified business account. Complete KYC verification with the Bright Data compliance team; there is no automatic or no-KYC path. Without KYC, use ISP or Datacenter proxies. [Read more...](/proxy-networks/residential/network-access)

  ### Targeting search engines?

  If you target a search engine like google, bing or yandex, you need a special Search Engine Results Page (**SERP**) proxy API. Use Bright Data SERP API to target search engines.
  [Click here to read more about Bright Data SERP proxy API.](/scraping-automation/serp-api/introduction)

  ### Correct setup of proxy test to avoid "PROXY ERROR"

  In many tools you will see a "test proxy" function, which performs a conncectivity test to your proxy, and some add a geolocation test as well, to identify the location of the proxy.
  To correctly test your proxy you should target those search queries to:
  `https://geo.brdtest.com/welcome.txt` .

  Some tools use popular search engines (like google.com) as a default test target. Bright Data will block those requests and you tool will show **proxy error** although your proxy is perfectly fine.

  If your proxy test fails, this is probably the reason. Make sure that your test domain is not a search engine (this is done in the tool configuration, and not controlled by Bright Data).
</Accordion>

<Tip>
  Maintain a consistent IP throughout your browser session by using the `-session` parameter in your username. This is essential because BrightData proxies default to rotating IPs with each request. [Learn more](/proxy-networks/faqs#how-to-use-the-same-ip-for-an-extended-period-of-time-and-how-long-can-i-keep-it-long-session) <br />

  New users should begin with ISP or Datacenter proxies, which need no KYC. Residential proxies require a [KYC-verified business account](/proxy-networks/residential/network-access).<br />
</Tip>

## What is Incogniton?

Incogniton is a privacy-focused browser designed to keep you anonymous while you browse. It lets you create and manage multiple profiles, each with its own set of cookies, local storage, IP address (via proxy), and other browsing data. This means you can surf the web worry-free, knowing your activities and personal information stay private.

Incogniton is perfect for privacy-conscious users, marketers, and researchers who need secure, anonymous browsing for web scraping, market research, and competitive intelligence.

## Incogniton Proxy Integration

Setting up Bright Data proxies with Incogniton is a quick and easy process. Just follow these simple steps to get started:

<Steps>
  <Step title="Download Incogniton">
    Visit the [**Incogniton website**](https://incogniton.com/) to download and install the browser on your device.
  </Step>

  <Step title="Create a New Profile">
    1. Once installed, open Incogniton and go to the **Profile Management** section.
    2. Click **New Profile** to create your first profile.
  </Step>

  <Step title="Configure Proxy Settings">
    In the profile setup menu, click on **Proxy** on the left side. Enter your Bright Data proxy details:

    * **Proxy Type**: Choose from `HTTP`, `HTTPS`, or `SOCKS5` (based on your proxy type).
    * **Proxy Host**: Enter `http://brd.superproxy.io/`.
    * **Proxy Port**: Use the port number provided in your [Bright Data dashboard](https://brightdata.com/cp/zones).
    * **Proxy Username**: Enter your Bright Data proxy `username`.
    * **Proxy Password**: Enter your Bright Data proxy `password`.

    You can confirm the proxy is working by clicking **Check Proxy**.

    <Info>
      **For country-specific proxies, you can enter a format like `username-country-US` for a US-based IP**
    </Info>
  </Step>

  <Step title="Save Your Profile">
    1. Once all the details are entered, click **Create Profile** to save your settings.
    2. You’re now ready to browse securely!
  </Step>

  <Step title="Start Browsing">
    Click **Start** to launch your profile in a secure incognito browser window, and begin browsing with complete anonymity.
  </Step>
</Steps>

And that’s it! You’ve successfully integrated Bright Data proxies with Incogniton.


# How to set up Bright Data with Insomniac
Source: https://docs.brightdata.com/integrations/insomniac

Configure Bright Data proxies (400M+ IPs) in Insomniac to assign a unique IP per browser tab, reducing detection risk during multi-session automations.

<Accordion title="Expand to get your Bright Data Proxy Access Information">
  ### Your proxy access information

  Bright Data proxies are grouped in "Proxy zones". Each zone holds the configuration for the proxies it holds.

  To get access to the proxy zone:

  1. Login to Bright Data control panel
  2. Select the proxy zone or setup a new one
  3. Click on the new zone name, and select the **Overview** tab.
  4. In the overview tab, under **Access details** you can find the proxy access details, and copy them to clipboard on click.
  5. You will need: Proxy Host, Proxy Port, Proxy Zone username and Proxy Zone password.
  6. Click on the copy icons to copy the text to your clipboard and paste in your tool's proxy configuration.

  ### Access Details Section Example

  <img alt="" />

  ### Residential proxy access

  To access Bright Data's **Residential Proxies** you must be a KYC-verified business account. Complete KYC verification with the Bright Data compliance team; there is no automatic or no-KYC path. Without KYC, use ISP or Datacenter proxies. [Read more...](/proxy-networks/residential/network-access)

  ### Targeting search engines?

  If you target a search engine like google, bing or yandex, you need a special Search Engine Results Page (**SERP**) proxy API. Use Bright Data SERP API to target search engines.
  [Click here to read more about Bright Data SERP proxy API.](/scraping-automation/serp-api/introduction)

  ### Correct setup of proxy test to avoid "PROXY ERROR"

  In many tools you will see a "test proxy" function, which performs a conncectivity test to your proxy, and some add a geolocation test as well, to identify the location of the proxy.
  To correctly test your proxy you should target those search queries to:
  `https://geo.brdtest.com/welcome.txt` .

  Some tools use popular search engines (like google.com) as a default test target. Bright Data will block those requests and you tool will show **proxy error** although your proxy is perfectly fine.

  If your proxy test fails, this is probably the reason. Make sure that your test domain is not a search engine (this is done in the tool configuration, and not controlled by Bright Data).
</Accordion>

## What is Insomniac?

Insomniac is an online purchasing tool allowing you to hide your digital footprint through its multi-session browser. Insomniac browser allows you to apply one proxy per tab and hide your online footprint by applying a different IP address for every tab you open.

<Tip>
  Maintain a consistent IP throughout your browser session by using the `-session` parameter in your username. This is essential because BrightData proxies default to rotating IPs with each request. [Learn more](/proxy-networks/faqs#how-to-use-the-same-ip-for-an-extended-period-of-time-and-how-long-can-i-keep-it-long-session)

  New users should begin with ISP or Datacenter proxies, which need no KYC. Residential proxies require a [KYC-verified business account](/proxy-networks/residential/network-access).

  <br />
</Tip>

## How to setup Insomniac with Bright Data proxies

### Using the same proxy repeatedly or rotating with new proxy every time?

Bright data offers access to two main kinds of proxies:

1. A rotating pool of proxies
2. A set of fixed proxies (shared with others or dedicated to you)

When choosing a proxy pool like our Datacenter, ISP or Residential shared pools, your isomniac browser does not need to handle the rotation as Bright Data will assign a new proxy for you in every session.

When you need a set of fixed proxies, like for collecting data at scale, you can load all your proxies to insomniac, and it will rotate along them, as you configure it.

## Set-up for Insomniac browser

* Download and install the Insomniac browser
* Open **Insomniac browser**
* Click on "Global sess." :

<Frame>
  <img alt="Insomniac_setup_1.png" />
</Frame>

* Click on "Proxy List"

<Frame>
  <img alt="Insomniac_setup_2.png" />
</Frame>

* This setup window will open, requiring you to paste your proxy configuration here.

<Frame>
  <img alt="Insomniac_setup_3.png" />
</Frame>

The format required is **comma separated** proxy configuration: `host,port,user,password` .

## Integrating Insomniac with Bright Data Proxies

* Go to your Bright Data Dashboard and click **Create a Zone**
* Choose your configuration
* Click **Save**
* The zone now includes your proxy setup and in the access details you have the connection information.

If you want to use Bright Data's rotation and use a different proxy for every session, copy and paste this setup from Bright Data's control panel into insomniac.

<Frame>
  <img alt="Insomniac_setup_4.png" />
</Frame>

If you wish to load a specific proxies (with distinguished IPs) of Datacenter or ISP, open the zone Overview tab in Bright Data control panel, and click "Download" to download the proxy list. A popup window will open with 3 formats. Insomniac needs comma separates format whch will be available soon in Bright Data. So choose colon seprated as shown here:

<Frame>
  <img alt="Insomniac_setup_5_brd_dc_iplistdwnld.png" />
</Frame>

Open the file with a text editor, and using "Search and Replace" replace all colons with commas. Example in notepad (use `Ctrl+H` to open the Search and replace function):

<Frame>
  <img alt="insomniac_setup_7_proxylist_notepad.png" />
</Frame>

After you copy and paste the list, you will have multiple entries of proxies in insomniac which you can order insomniac to rotate on per your desired logic.

## Integrating Multiple Proxy Manager ports with Insomniac

* Download [Proxy Manager](https://brightdata.com/products/proxy-manager)
* Click **Add new Proxy** to create a new port
* Select the new port (24XXX)
* Go to the **General** tab in the port settings
* In the **Multiply proxy port** field select the number of proxy ports to create. This will create multiple proxy ports with the same settings
* Your Spreadsheet Contains the following columns:
  * Custom Name: Add a name for each proxy
  * Host: 127.0.0.1
  * Port: 24XXX
  * Username, Password, and Tags: leave EMPTY(the Proxy Manager has already been authenticated with the Super Proxy)
* Save the file as a **CSV** and not as an XLS or XLSX
* In Insomniac **Proxy per tab** extension select **Manage Proxy list**, and select **Add bulk proxies**
* Select **Import proxy list** and upload the CSV file

<Warning>
  **Important note**:

  If you are using Bright Data’s Residential Proxies, Web Unlocker API or SERP API, you need to install an SSL certificate to enable end-to-end secure connections to your target website(s).

  This is a simple process, see [this guide](/general/account/ssl-certificate#installation-of-the-ssl-certificate) for instructions.
</Warning>


# Set up Bright Data with IXBrowser
Source: https://docs.brightdata.com/integrations/ixbrowser

Configure Bright Data proxies (400M+ IPs) in IXBrowser to route multi-profile browsing through residential, datacenter, ISP or mobile IPs for collection.

<Warning>
  **Account management is not a supported use case** on the Bright Data platform as of April 1, 2026. This includes managing accounts on platforms like TikTok, Instagram, or similar services. Bright Data proxies cannot be used for this purpose. See [Acceptable Use Policy](https://brightdata.com/acceptable-use-policy) for details.
</Warning>

<Accordion title="Expand to get your Bright Data Proxy Access Information">
  ### Your proxy access information

  Bright Data proxies are grouped in "Proxy zones". Each zone holds the configuration for the proxies it holds.

  To get access to the proxy zone:

  1. Login to Bright Data control panel
  2. Select the proxy zone or setup a new one
  3. Click on the new zone name, and select the **Overview** tab.
  4. In the overview tab, under **Access details** you can find the proxy access details, and copy them to clipboard on click.
  5. You will need: Proxy Host, Proxy Port, Proxy Zone username and Proxy Zone password.
  6. Click on the copy icons to copy the text to your clipboard and paste in your tool's proxy configuration.

  ### Access Details Section Example

  <img alt="" />

  ### Residential proxy access

  To access Bright Data's **Residential Proxies** you must be a KYC-verified business account. Complete KYC verification with the Bright Data compliance team; there is no automatic or no-KYC path. Without KYC, use ISP or Datacenter proxies. [Read more...](/proxy-networks/residential/network-access)

  ### Targeting search engines?

  If you target a search engine like google, bing or yandex, you need a special Search Engine Results Page (**SERP**) proxy API. Use Bright Data SERP API to target search engines.
  [Click here to read more about Bright Data SERP proxy API.](/scraping-automation/serp-api/introduction)

  ### Correct setup of proxy test to avoid "PROXY ERROR"

  In many tools you will see a "test proxy" function, which performs a conncectivity test to your proxy, and some add a geolocation test as well, to identify the location of the proxy.
  To correctly test your proxy you should target those search queries to:
  `https://geo.brdtest.com/welcome.txt` .

  Some tools use popular search engines (like google.com) as a default test target. Bright Data will block those requests and you tool will show **proxy error** although your proxy is perfectly fine.

  If your proxy test fails, this is probably the reason. Make sure that your test domain is not a search engine (this is done in the tool configuration, and not controlled by Bright Data).
</Accordion>

## What is IXBrowser?

<Tip>
  Maintain a consistent IP throughout your browser session by using the `-session` parameter in your username. This is essential because BrightData proxies default to rotating IPs with each request. [Learn more](/proxy-networks/faqs#how-to-use-the-same-ip-for-an-extended-period-of-time-and-how-long-can-i-keep-it-long-session) <br />

  New users should begin with ISP or Datacenter proxies, which need no KYC. Residential proxies require a [KYC-verified business account](/proxy-networks/residential/network-access).<br />
</Tip>

<Warning>
  Connections to the following social networks are not supported on Data Center and ISP proxy networks: Facebook, TikTok, Instagram, X (Twitter), LinkedIn, YouTube, Reddit, Pinterest, Snapchat, and Discord.
</Warning>

**IXBrowser** is a privacy-focused anti-detect browser tailored for managing multiple browser profiles across different platforms. It provides advanced anonymity features, allowing users to bypass restrictions and avoid detection. Integrating Bright Data with IXBrowser further enhances privacy and enables geo-targeted browsing.

## How to Integrate Bright Data With IXBrowser

<Steps>
  <Step title="Download and Install IXBrowser">
    1. Visit the [IXBrowser website](https://ixbrowser.com/) and download the application.
    2. Install the software and log in using your account credentials.
  </Step>

  <Step title="Create a New Profile">
    1. Open IXBrowser and navigate to the **Profile List** section under **Browser Profile**.
    2. Click **Create New Profile** to begin setting up a new browser instance.
    3. In the profile settings, provide a descriptive name in the **Profile Name** field to easily identify your profile later.

    <Frame>
      <img alt="How to Integrate Bright Data With IXBrowser" />
    </Frame>
  </Step>

  <Step title="Configure Proxy Settings">
    1. Switch to the **Proxy Configuration** tab within the profile setup page.

    2. Toggle **Custom** to enable the proxy setup options.

    3. Fill in the following proxy details retrieved from your [Bright Data dashboard](https://brightdata.com/cp/zones):
       * **Proxy Type**: Choose HTTP, HTTPS, or SOCKS5 depending on your proxy type.
       * **Proxy Host**: `http://brd.superproxy.io/`
       * **Proxy Port**: Enter the port number from your Bright Data dashboard.
       * **Proxy Account**: Use your Bright Data `username`.
       * **Proxy Password**: Use your Bright Data `password`.

    4. Once you’ve entered the details, click **Create** to save the configuration.

    <Note>
      For geo-targeted proxies, format your username as `your-username-country-XX` (e.g., `your-username-country-US`) to access a specific region.
    </Note>
  </Step>

  <Step title="Launch the Profile">
    1. Navigate back to the **Profile List** section.
    2. Locate your newly created profile and click **Open** to launch the browser with the configured Bright Data proxy settings.

    <Frame>
      <img alt="How to Integrate Bright Data With IXBrowser" />
    </Frame>
  </Step>
</Steps>

Integrating Bright Data with IXBrowser ensures private and reliable account management while enhancing your online anonymity. Whether you’re managing multiple accounts or performing geo-targeted activities, this setup empowers you with secure and seamless browsing. Get started now for a more efficient experience!


# How to set up Bright Data with Kameleo
Source: https://docs.brightdata.com/integrations/kameleo

Configure Bright Data proxies in Kameleo to route anti-detect browser profiles through residential, datacenter, ISP, or mobile IPs. Spans 195 countries.

<Warning>
  **Account management is not a supported use case** on the Bright Data platform as of April 1, 2026. This includes managing accounts on platforms like TikTok, Instagram, or similar services. Bright Data proxies cannot be used for this purpose. See [Acceptable Use Policy](https://brightdata.com/acceptable-use-policy) for details.
</Warning>

<Accordion title="Expand to get your Bright Data Proxy Access Information">
  ### Your proxy access information

  Bright Data proxies are grouped in "Proxy zones". Each zone holds the configuration for the proxies it holds.

  To get access to the proxy zone:

  1. Login to Bright Data control panel
  2. Select the proxy zone or setup a new one
  3. Click on the new zone name, and select the **Overview** tab.
  4. In the overview tab, under **Access details** you can find the proxy access details, and copy them to clipboard on click.
  5. You will need: Proxy Host, Proxy Port, Proxy Zone username and Proxy Zone password.
  6. Click on the copy icons to copy the text to your clipboard and paste in your tool's proxy configuration.

  ### Access Details Section Example

  <img alt="" />

  ### Residential proxy access

  To access Bright Data's **Residential Proxies** you must be a KYC-verified business account. Complete KYC verification with the Bright Data compliance team; there is no automatic or no-KYC path. Without KYC, use ISP or Datacenter proxies. [Read more...](/proxy-networks/residential/network-access)

  ### Targeting search engines?

  If you target a search engine like google, bing or yandex, you need a special Search Engine Results Page (**SERP**) proxy API. Use Bright Data SERP API to target search engines.
  [Click here to read more about Bright Data SERP proxy API.](/scraping-automation/serp-api/introduction)

  ### Correct setup of proxy test to avoid "PROXY ERROR"

  In many tools you will see a "test proxy" function, which performs a conncectivity test to your proxy, and some add a geolocation test as well, to identify the location of the proxy.
  To correctly test your proxy you should target those search queries to:
  `https://geo.brdtest.com/welcome.txt` .

  Some tools use popular search engines (like google.com) as a default test target. Bright Data will block those requests and you tool will show **proxy error** although your proxy is perfectly fine.

  If your proxy test fails, this is probably the reason. Make sure that your test domain is not a search engine (this is done in the tool configuration, and not controlled by Bright Data).
</Accordion>

## What is Kameleo?

Kameleo is an advanced anti-detection browser designed for users who need to manage multiple online profiles without risking detection. Whether you’re an affiliate marketer, researcher, or web scraper, Kameleo gives you the tools to bypass IP bans, prevent device tracking, and maintain isolated browsing environments.

With Kameleo, you can customize your browser fingerprints, like user agents, screen resolutions, and fonts, so each profile looks completely unique. This ensures that your activities remain undetected. Kameleo supports a variety of proxies, including residential, datacenter, and ISP proxies, letting you assign different IPs and digital identities to each profile. This makes it perfect for data collection, competitive research, and web scraping at scale, all from a single session.

On top of its strong anti-detection features, Kameleo also supports automation tools, making it a powerful choice for bulk tasks like posting or data scraping. Whether you’re managing a handful of profiles or scaling up for larger operations, Kameleo ensures your privacy and security are protected while optimizing your online activities.

<Tip>
  Maintain a consistent IP throughout your browser session by using the `-session` parameter in your username. This is essential because BrightData proxies default to rotating IPs with each request. [Learn more](/proxy-networks/faqs#how-to-use-the-same-ip-for-an-extended-period-of-time-and-how-long-can-i-keep-it-long-session) <br />

  New users should begin with ISP or Datacenter proxies, which need no KYC. Residential proxies require a [KYC-verified business account](/proxy-networks/residential/network-access).<br />
</Tip>

## Kameleo Proxy Integration

Follow these simple steps to integrate Bright Data proxies into Kameleo:

<Steps>
  <Step title="Open Kameleo">
    Launch the [**Kameleo app**](https://kameleo.io/downloads/) and log in to your account.
  </Step>

  <Step title="Create a New Profile">
    Click on the **New Profile** option in the left navigation panel to start setting up a new browsing profile.
  </Step>

  <Step title="Configure Your Profile Preferences">
    Select the profile settings that match your preferred device type, operating system, browser, and language settings.
  </Step>

  <Step title="Configure Your Bright Data Proxy">
    Navigate to the **Connection** section in the profile settings and enter the following details to configure your Bright Data proxy:

    * **Proxy**: Choose from `HTTP`, `HTTPS`, or `SOCKS5` (based on your proxy type).
    * **Host:**  Enter `http://brd.superproxy.io/`.
    * **Port**: Use the port number provided in your [Bright Data dashboard](https://brightdata.com/cp/zones).
  </Step>

  <Step title="Enable Authentication">
    Toggle the **Authentication** button to reveal the `Username` and `Password` fields.\
    Enter your Bright Data proxy credentials here.

    To ensure everything works correctly, click the **Test Proxy** button to perform several tests for your proxy connection.

    <Info>
      **For country-specific proxies, you can enter a format like `your-username-country-US` to receive a US exit node.**
    </Info>
  </Step>

  <Step title="Save Your Settings">
    Once you’ve configured your proxy, click **OK** to save your settings.

    Alternatively, click **START** to launch the browser immediately with your configured profile.
  </Step>
</Steps>

And that’s it! You’ve successfully integrated Bright Data proxies with Kameleo.


# How to set up Bright Data with Lalicat
Source: https://docs.brightdata.com/integrations/lalicat

Configure Bright Data proxies (400M+ IPs) in Lalicat to route multi-profile browsing through residential, datacenter, ISP or mobile IPs for collection.

<Warning>
  **Account management is not a supported use case** on the Bright Data platform as of April 1, 2026. This includes managing accounts on platforms like TikTok, Instagram, or similar services. Bright Data proxies cannot be used for this purpose. See [Acceptable Use Policy](https://brightdata.com/acceptable-use-policy) for details.
</Warning>

<Accordion title="Expand to get your Bright Data Proxy Access Information">
  ### Your proxy access information

  Bright Data proxies are grouped in "Proxy zones". Each zone holds the configuration for the proxies it holds.

  To get access to the proxy zone:

  1. Login to Bright Data control panel
  2. Select the proxy zone or setup a new one
  3. Click on the new zone name, and select the **Overview** tab.
  4. In the overview tab, under **Access details** you can find the proxy access details, and copy them to clipboard on click.
  5. You will need: Proxy Host, Proxy Port, Proxy Zone username and Proxy Zone password.
  6. Click on the copy icons to copy the text to your clipboard and paste in your tool's proxy configuration.

  ### Access Details Section Example

  <img alt="" />

  ### Residential proxy access

  To access Bright Data's **Residential Proxies** you must be a KYC-verified business account. Complete KYC verification with the Bright Data compliance team; there is no automatic or no-KYC path. Without KYC, use ISP or Datacenter proxies. [Read more...](/proxy-networks/residential/network-access)

  ### Targeting search engines?

  If you target a search engine like google, bing or yandex, you need a special Search Engine Results Page (**SERP**) proxy API. Use Bright Data SERP API to target search engines.
  [Click here to read more about Bright Data SERP proxy API.](/scraping-automation/serp-api/introduction)

  ### Correct setup of proxy test to avoid "PROXY ERROR"

  In many tools you will see a "test proxy" function, which performs a conncectivity test to your proxy, and some add a geolocation test as well, to identify the location of the proxy.
  To correctly test your proxy you should target those search queries to:
  `https://geo.brdtest.com/welcome.txt` .

  Some tools use popular search engines (like google.com) as a default test target. Bright Data will block those requests and you tool will show **proxy error** although your proxy is perfectly fine.

  If your proxy test fails, this is probably the reason. Make sure that your test domain is not a search engine (this is done in the tool configuration, and not controlled by Bright Data).
</Accordion>

## What is Lalicat?

Lalicat is a simple, anti-detection browser designed to help you manage multiple accounts securely and anonymously. It creates unique browser profiles with isolated digital fingerprints, like IP addresses and device details, so you can bypass tracking systems and avoid detection with ease.

Whether you're performing web scraping, conducting market research, or gathering competitive intelligence, Lalicat offers a reliable and affordable solution for professionals who prioritize privacy and efficiency.

<Tip>
  Maintain a consistent IP throughout your browser session by using the `-session` parameter in your username. This is essential because BrightData proxies default to rotating IPs with each request. [Learn more](/proxy-networks/faqs#how-to-use-the-same-ip-for-an-extended-period-of-time-and-how-long-can-i-keep-it-long-session) <br />

  New users should begin with ISP or Datacenter proxies, which need no KYC. Residential proxies require a [KYC-verified business account](/proxy-networks/residential/network-access).<br />
</Tip>

## Lalicat Proxy Integration

Follow these steps to integrate Bright Data proxies with Lalicat:

<Steps>
  <Step title="Install Lalicat">
    1. [**Download**](https://www.lalicat.com/download), install, and launch Lalicat.
    2. Create and log into your account.
  </Step>

  <Step title="Add a Browser Profile">
    On the home screen, click **+Add Browser** to create a new browser instance.

    <Frame>
      <img alt="Lalicat Proxy Integration" />
    </Frame>
  </Step>

  <Step title="Configure Basic Settings">
    In the **Basic Configuration** section, enter your **Profile Name**, select the simulated **operating system**, and adjust other necessary settings for your task.

    <Frame>
      <img alt="Lalicat Proxy Integration" />
    </Frame>
  </Step>

  <Step title="Configure Your Bright Data Proxy">
    Scroll to the **Proxy Settings** section and input the following details:

    * **Proxy settings**: Choose from `HTTP`, `HTTPS`, or `SOCKS5` (based on your proxy type).
    * **IP Address**: Enter `http://brd.superproxy.io/`.
    * **Port**: Use the port number provided in your [Bright Data dashboard](https://brightdata.com/cp/zones).
    * **Login**: Enter your Bright Data proxy `username`.
    * **Password**: Enter your Bright Data proxy `password`.

    <Info>
      **For country-specific proxies, you can enter a format like `your-username-country-US` to receive a US exit node.**
    </Info>
  </Step>

  <Step title="Test Your Proxy">
    Click **Check the Proxy** to verify the connection.

    If everything is working, click **Save** to complete the configuration.
  </Step>
</Steps>

**And that’s it!** You’ve successfully integrated Bright Data proxies with Lalicat.


# Set up Bright Data with MarketerBrowser
Source: https://docs.brightdata.com/integrations/marketerbrowser

Step-by-step guide to configuring Bright Data proxies (400M+ IPs) in MarketerBrowser for managing multiple browser profiles and region-specific content.

<Warning>
  **Account management is not a supported use case** on the Bright Data platform as of April 1, 2026. This includes managing accounts on platforms like TikTok, Instagram, or similar services. Bright Data proxies cannot be used for this purpose. See [Acceptable Use Policy](https://brightdata.com/acceptable-use-policy) for details.
</Warning>

<Accordion title="Expand to get your Bright Data Proxy Access Information">
  ### Your proxy access information

  Bright Data proxies are grouped in "Proxy zones". Each zone holds the configuration for the proxies it holds.

  To get access to the proxy zone:

  1. Login to Bright Data control panel
  2. Select the proxy zone or setup a new one
  3. Click on the new zone name, and select the **Overview** tab.
  4. In the overview tab, under **Access details** you can find the proxy access details, and copy them to clipboard on click.
  5. You will need: Proxy Host, Proxy Port, Proxy Zone username and Proxy Zone password.
  6. Click on the copy icons to copy the text to your clipboard and paste in your tool's proxy configuration.

  ### Access Details Section Example

  <img alt="" />

  ### Residential proxy access

  To access Bright Data's **Residential Proxies** you must be a KYC-verified business account. Complete KYC verification with the Bright Data compliance team; there is no automatic or no-KYC path. Without KYC, use ISP or Datacenter proxies. [Read more...](/proxy-networks/residential/network-access)

  ### Targeting search engines?

  If you target a search engine like google, bing or yandex, you need a special Search Engine Results Page (**SERP**) proxy API. Use Bright Data SERP API to target search engines.
  [Click here to read more about Bright Data SERP proxy API.](/scraping-automation/serp-api/introduction)

  ### Correct setup of proxy test to avoid "PROXY ERROR"

  In many tools you will see a "test proxy" function, which performs a conncectivity test to your proxy, and some add a geolocation test as well, to identify the location of the proxy.
  To correctly test your proxy you should target those search queries to:
  `https://geo.brdtest.com/welcome.txt` .

  Some tools use popular search engines (like google.com) as a default test target. Bright Data will block those requests and you tool will show **proxy error** although your proxy is perfectly fine.

  If your proxy test fails, this is probably the reason. Make sure that your test domain is not a search engine (this is done in the tool configuration, and not controlled by Bright Data).
</Accordion>

## What is MarketerBrowser?

<Tip>
  Maintain a consistent IP throughout your browser session by using the `-session` parameter in your username. This is essential because BrightData proxies default to rotating IPs with each request. [Learn more](/proxy-networks/faqs#how-to-use-the-same-ip-for-an-extended-period-of-time-and-how-long-can-i-keep-it-long-session) <br />

  New users should begin with ISP or Datacenter proxies, which need no KYC. Residential proxies require a [KYC-verified business account](/proxy-networks/residential/network-access).<br />
</Tip>

<Warning>
  Connections to the following social networks are not supported on Data Center and ISP proxy networks: Facebook, TikTok, Instagram, X (Twitter), LinkedIn, YouTube, Reddit, Pinterest, Snapchat, and Discord.
</Warning>

**MarketerBrowser** is a specialized browser designed for professionals managing multiple browser profiles or campaigns. It lets you create isolated browser profiles, ensuring security and privacy for each session. By integrating **Bright Data**, you can enhance anonymity, access geo-restricted content, and reduce detection risks for your workflows.

## How to Integrate Bright Data With MarketerBrowser

<Step title="Install and Open MarketerBrowser">
  1. Download MarketerBrowser from the [official website](https://www.marketerbrowser.com/).
  2. Follow the on-screen installation instructions to set up the application on your device.
  3. Open MarketerBrowser and log in using your credentials. If you don’t have an account, register for one.
</Step>

<Step title="Create or Edit a Browser Profile">
  1. From the **Profiles**, click **Create Profile** to set up a new browser instance or select an existing profile to edit.
  2. Provide a descriptive name for the profile in the **Name** field to easily identify it later.

  <Frame>
    <img alt="How to Integrate Bright Data With MarketerBrowser" />
  </Frame>
</Step>

<Step title="Configure Proxy Settings">
  1. Locate the **Proxy** section within the profile configuration menu.

  2. Enter your Bright Data proxy details:
     * **Type**: Select HTTP, HTTPS, or SOCKS5.
     * **Server**: Input `http://brd.superproxy.io/`.
     * **Port**: Enter the port number from your [Bright Data dashboard](https://brightdata.com/cp/zones).
     * **Username**: Use your Bright Data `username`.
     * **Password**: Enter your Bright Data `password`.

  3. Test the proxy connection by clicking **Check** to ensure the setup is working correctly.

  4. Once you’ve entered and tested the proxy details, click **Create** to store the profile configuration.
</Step>

<Step title="Save and Activate the Profile">
  1. Go to the **Profiles** section and choose your newly configured profile.
  2. Toggle the **Launch** switch to *On* to activate the profile with your Bright Data settings.

  <Frame>
    <img alt="How to Integrate Bright Data With MarketerBrowser" />
  </Frame>
</Step>

<Step title="Verify the Proxy Setup">
  1. Within the launched profile, open the browser and navigate to [httpbin.org/ip](http://httpbin.org/ip).
  2. Confirm that the displayed IP address matches your Bright Data proxy to verify the setup.
</Step>

By integrating **Bright Data** with **MarketerBrowser**, you create a seamless and secure environment for managing multiple accounts, accessing geo-specific content, and maintaining anonymity. Follow these steps to optimize your workflows and enhance privacy with Bright Data and MarketerBrowser today!


# How to integrate Bright Data with Maskfog
Source: https://docs.brightdata.com/integrations/maskfog

Configure Bright Data proxies in Maskfog to route anti-detect browsing profiles through residential, datacenter, ISP, or mobile IPs. Spans 195 countries.

<Warning>
  **Account management is not a supported use case** on the Bright Data platform as of April 1, 2026. This includes managing accounts on platforms like TikTok, Instagram, or similar services. Bright Data proxies cannot be used for this purpose. See [Acceptable Use Policy](https://brightdata.com/acceptable-use-policy) for details.
</Warning>

<Accordion title="Expand to get your Bright Data Proxy Access Information">
  ### Your proxy access information

  Bright Data proxies are grouped in "Proxy zones". Each zone holds the configuration for the proxies it holds.

  To get access to the proxy zone:

  1. Login to Bright Data control panel
  2. Select the proxy zone or setup a new one
  3. Click on the new zone name, and select the **Overview** tab.
  4. In the overview tab, under **Access details** you can find the proxy access details, and copy them to clipboard on click.
  5. You will need: Proxy Host, Proxy Port, Proxy Zone username and Proxy Zone password.
  6. Click on the copy icons to copy the text to your clipboard and paste in your tool's proxy configuration.

  ### Access Details Section Example

  <img alt="" />

  ### Residential proxy access

  To access Bright Data's **Residential Proxies** you must be a KYC-verified business account. Complete KYC verification with the Bright Data compliance team; there is no automatic or no-KYC path. Without KYC, use ISP or Datacenter proxies. [Read more...](/proxy-networks/residential/network-access)

  ### Targeting search engines?

  If you target a search engine like google, bing or yandex, you need a special Search Engine Results Page (**SERP**) proxy API. Use Bright Data SERP API to target search engines.
  [Click here to read more about Bright Data SERP proxy API.](/scraping-automation/serp-api/introduction)

  ### Correct setup of proxy test to avoid "PROXY ERROR"

  In many tools you will see a "test proxy" function, which performs a conncectivity test to your proxy, and some add a geolocation test as well, to identify the location of the proxy.
  To correctly test your proxy you should target those search queries to:
  `https://geo.brdtest.com/welcome.txt` .

  Some tools use popular search engines (like google.com) as a default test target. Bright Data will block those requests and you tool will show **proxy error** although your proxy is perfectly fine.

  If your proxy test fails, this is probably the reason. Make sure that your test domain is not a search engine (this is done in the tool configuration, and not controlled by Bright Data).
</Accordion>

## What is Maskfog?

**Maskfog** is an anti-detect browser designed for managing multiple accounts securely and anonymously. It provides tools to prevent detection, protect your digital footprint, and simulate unique browser environments for each profile. Integrating Bright Data with Maskfog adds an extra layer of security and flexibility for geo-targeted activities.

<Tip>
  Maintain a consistent IP throughout your browser session by using the `-session` parameter in your username. This is essential because BrightData proxies default to rotating IPs with each request. [Learn more](/proxy-networks/faqs#how-to-use-the-same-ip-for-an-extended-period-of-time-and-how-long-can-i-keep-it-long-session) <br />

  New users should begin with ISP or Datacenter proxies, which need no KYC. Residential proxies require a [KYC-verified business account](/proxy-networks/residential/network-access).<br />
</Tip>

## How to Integrate Bright Data With Maskfog

<Step title="Download and Install Maskfog">
  1. Visit the [Maskfog website](https://www.maskfog.com/) and download the application for your operating system.
  2. Install the software and log in using your credentials.
</Step>

<Step title="Create a New Profile">
  1. Open Maskfog and navigate to the **Proxy Service** section.
  2. Click **Configure Device** to start setting up a new proxy.

  <Frame>
    <img alt="How to Integrate Bright Data With Maskfog" />
  </Frame>
</Step>

<Step title="Enter Proxy Details">
  1. Enter a recognizable name in the **Proxy Name** field to identify the configuration later.

  2. Input the following details retrieved from your [Bright Data dashboard](https://brightdata.com/cp/zones/page/plans):
     * **Proxy Type**: Select HTTP, HTTPS, or SOCKS5 based on your proxy type.
     * **Proxy Host**: Enter `http://brd.superproxy.io/`.
     * **Proxy Port**: Use the port number provided in your Bright Data dashboard.
     * **Proxy username**: Enter your Bright Data `username`.
     * **Proxy password**: Enter your Bright Data `password`.

  3. Test the proxy connection by clicking **Check Proxy**. Ensure the connection is successful before proceeding.

  4. After verifying, click **OK** to save the configuration.

  <Note>
    If you need proxies for a specific location, include the country code in your username. Format it as:
    `your-username-country-XX` (e.g., `your-username-country-US`) to select a proxy from the desired country.
  </Note>
</Step>

You're All Set! With your proxy successfully configured, Maskfog is now equipped with Bright Data for secure and anonymous connections. Enjoy enhanced privacy and seamless browsing.


# How to set up Bright Data with MoreLogin
Source: https://docs.brightdata.com/integrations/morelogin

Pair Bright Data (400M+ residential IPs) with MoreLogin for secure, anonymous browsing and better protection against detection in data collection.

<Warning>
  **Account management is not a supported use case** on the Bright Data platform as of April 1, 2026. This includes managing accounts on platforms like TikTok, Instagram, or similar services. Bright Data proxies cannot be used for this purpose. See [Acceptable Use Policy](https://brightdata.com/acceptable-use-policy) for details.
</Warning>

<Accordion title="Expand to get your Bright Data Proxy Access Information">
  ### Your proxy access information

  Bright Data proxies are grouped in "Proxy zones". Each zone holds the configuration for the proxies it holds.

  To get access to the proxy zone:

  1. Login to Bright Data control panel
  2. Select the proxy zone or setup a new one
  3. Click on the new zone name, and select the **Overview** tab.
  4. In the overview tab, under **Access details** you can find the proxy access details, and copy them to clipboard on click.
  5. You will need: Proxy Host, Proxy Port, Proxy Zone username and Proxy Zone password.
  6. Click on the copy icons to copy the text to your clipboard and paste in your tool's proxy configuration.

  ### Access Details Section Example

  <img alt="" />

  ### Residential proxy access

  To access Bright Data's **Residential Proxies** you must be a KYC-verified business account. Complete KYC verification with the Bright Data compliance team; there is no automatic or no-KYC path. Without KYC, use ISP or Datacenter proxies. [Read more...](/proxy-networks/residential/network-access)

  ### Targeting search engines?

  If you target a search engine like google, bing or yandex, you need a special Search Engine Results Page (**SERP**) proxy API. Use Bright Data SERP API to target search engines.
  [Click here to read more about Bright Data SERP proxy API.](/scraping-automation/serp-api/introduction)

  ### Correct setup of proxy test to avoid "PROXY ERROR"

  In many tools you will see a "test proxy" function, which performs a conncectivity test to your proxy, and some add a geolocation test as well, to identify the location of the proxy.
  To correctly test your proxy you should target those search queries to:
  `https://geo.brdtest.com/welcome.txt` .

  Some tools use popular search engines (like google.com) as a default test target. Bright Data will block those requests and you tool will show **proxy error** although your proxy is perfectly fine.

  If your proxy test fails, this is probably the reason. Make sure that your test domain is not a search engine (this is done in the tool configuration, and not controlled by Bright Data).
</Accordion>

## What is MoreLogin?

MoreLogin is a powerful tool designed to help you manage multiple online identities from a single device. Perfect for privacy-conscious users, marketers, and researchers, MoreLogin allows you to operate several profiles, each as a unique digital identity. Each profile has its own IPs, cookies, and device fingerprints, reducing the risk of detection and account bans.

With seamless proxy integration, MoreLogin adds another layer of anonymity to your online activities. Plus, it supports profile sharing, making it ideal for affiliate marketing, market research, and data collection. Whether you're scaling data collection or growing your research operations, MoreLogin helps you stay secure and efficient.

<Tip>
  Maintain a consistent IP throughout your browser session by using the `-session` parameter in your username. This is essential because BrightData proxies default to rotating IPs with each request. [Learn more](/proxy-networks/faqs#how-to-use-the-same-ip-for-an-extended-period-of-time-and-how-long-can-i-keep-it-long-session) <br />

  New users should begin with ISP or Datacenter proxies, which need no KYC. Residential proxies require a [KYC-verified business account](/proxy-networks/residential/network-access).<br />
</Tip>

## MoreLogin Proxy Integration

Here’s how you can easily integrate Bright Data proxies with MoreLogin:

<Steps>
  <Step title="Install MoreLogin">
    Visit the [MoreLogin website](https://www.morelogin.com/) to download and install the app.
  </Step>

  <Step title="Create an Account">
    Log in and get started with the setup process.
  </Step>

  <Step title="Create a New Profile">
    Click the **+New profile** button to set up your profile details.

    <Frame>
      <img alt="MoreLogin Proxy Integration" />
    </Frame>
  </Step>

  <Step title="Set Initial Profile Settings">
    Enter the profile name, select your desired browser fingerprint, and click **Advanced Create** to access additional settings.

    <Frame>
      <img alt="MoreLogin Proxy Integration" />
    </Frame>
  </Step>

  <Step title="Configure Proxy Settings">
    Scroll to the **Proxies** section and enter your Bright Data proxy details:

    * **Proxy Type**: Choose from `HTTP`, `HTTPS`, or `SOCKS5` (based on your proxy type).
    * **Proxy Server**: Enter `http://brd.superproxy.io/`.
    * **Proxy Port**: Use the port number provided in your [Bright Data dashboard](https://brightdata.com/cp/zones).
    * **Proxy Account**: Enter your Bright Data proxy `username`.
    * **Proxy Password**: Enter your Bright Data proxy `password`.

    <Info>
      **You can also specify a country for your proxy. For instance, entering `your-username-country-US` will give you a US-based exit node.**
    </Info>

    <Frame>
      <img alt="MoreLogin Proxy Integration" />
    </Frame>
  </Step>

  <Step title="Test the Proxy">
    Click **Check Proxy** to make sure everything is working correctly.
  </Step>

  <Step title="Save and Launch">
    Click **Confirm** to save your settings, then hit **Start** to open your profile in a secure browsing session.

    <Frame>
      <img alt="MoreLogin Proxy Integration" />
    </Frame>
  </Step>
</Steps>

And that's it! You've now successfully integrated Bright Data proxies with MoreLogin.


# How to use Bright Data with MuLogin
Source: https://docs.brightdata.com/integrations/mulogin

Configure Bright Data proxies (400M+ IPs) in MuLogin to assign isolated IPs to each browser profile for anonymous, geo-targeted multi-account workflows.

<Warning>
  **Account management is not a supported use case** on the Bright Data platform as of April 1, 2026. This includes managing accounts on platforms like TikTok, Instagram, or similar services. Bright Data proxies cannot be used for this purpose. See [Acceptable Use Policy](https://brightdata.com/acceptable-use-policy) for details.
</Warning>

<Accordion title="Expand to get your Bright Data Proxy Access Information">
  ### Your proxy access information

  Bright Data proxies are grouped in "Proxy zones". Each zone holds the configuration for the proxies it holds.

  To get access to the proxy zone:

  1. Login to Bright Data control panel
  2. Select the proxy zone or setup a new one
  3. Click on the new zone name, and select the **Overview** tab.
  4. In the overview tab, under **Access details** you can find the proxy access details, and copy them to clipboard on click.
  5. You will need: Proxy Host, Proxy Port, Proxy Zone username and Proxy Zone password.
  6. Click on the copy icons to copy the text to your clipboard and paste in your tool's proxy configuration.

  ### Access Details Section Example

  <img alt="" />

  ### Residential proxy access

  To access Bright Data's **Residential Proxies** you must be a KYC-verified business account. Complete KYC verification with the Bright Data compliance team; there is no automatic or no-KYC path. Without KYC, use ISP or Datacenter proxies. [Read more...](/proxy-networks/residential/network-access)

  ### Targeting search engines?

  If you target a search engine like google, bing or yandex, you need a special Search Engine Results Page (**SERP**) proxy API. Use Bright Data SERP API to target search engines.
  [Click here to read more about Bright Data SERP proxy API.](/scraping-automation/serp-api/introduction)

  ### Correct setup of proxy test to avoid "PROXY ERROR"

  In many tools you will see a "test proxy" function, which performs a conncectivity test to your proxy, and some add a geolocation test as well, to identify the location of the proxy.
  To correctly test your proxy you should target those search queries to:
  `https://geo.brdtest.com/welcome.txt` .

  Some tools use popular search engines (like google.com) as a default test target. Bright Data will block those requests and you tool will show **proxy error** although your proxy is perfectly fine.

  If your proxy test fails, this is probably the reason. Make sure that your test domain is not a search engine (this is done in the tool configuration, and not controlled by Bright Data).
</Accordion>

## What is MuLogin?

MuLogin is a multi-profile browser management tool that helps you run multiple online accounts without them interfering with each other. It’s designed to protect your privacy, prevent detection, and streamline your digital operations. With MuLogin, you can handle multiple sessions seamlessly, perfect for web scraping, market research, and other data collection projects.

<Tip>
  Maintain a consistent IP throughout your browser session by using the `-session` parameter in your username. This is essential because BrightData proxies default to rotating IPs with each request. [Learn more](/proxy-networks/faqs#how-to-use-the-same-ip-for-an-extended-period-of-time-and-how-long-can-i-keep-it-long-session) <br />

  New users should begin with ISP or Datacenter proxies, which need no KYC. Residential proxies require a [KYC-verified business account](/proxy-networks/residential/network-access).<br />
</Tip>

## Why Integrate Bright Data with MuLogin?

By adding Bright Data proxies to MuLogin, you’ll:

* **Protect Your Identity**: Keep your real IP hidden behind secure, anonymous proxies.
* **Reduce Detection Risks**: Spread out your activities over diverse IP addresses, minimizing the chance of blocks or bans.
* **Improve Reliability**: Access geo-targeted content smoothly and maintain stable connections across sessions.

## How to Integrate Bright Data with MuLogin

Follow these steps to configure Bright Data proxies in MuLogin:

<Steps>
  <Step title="Access the MuLogin Dashboard">
    1. Visit [MuLogin ](https://www.mulogin.com/) and sign in to your account.
    2. Once logged in, you’ll see your dashboard with existing browser profiles (if any).
  </Step>

  <Step title="Create or Edit a Browser Profile">
    1. If you need a new profile, click **"Quick create"** or a similar button.

    <Frame>
      <img alt="How to Integrate Bright Data with MuLogin" />
    </Frame>

    2. If you want to modify an existing profile, select it from the list and click on **"Edit"**, **"Settings"**, or the **gear icon**, the exact naming may vary based on MuLogin’s current UI.

    <Frame>
      <img alt="How to Integrate Bright Data with MuLogin" />
    </Frame>
  </Step>

  <Step title="Assign a Display Name and Access Proxy Settings">
    1. On the profile configuration page, under the **“Basic Configuration”** section, locate the **“Display name”** field.
    2. Enter a clear, recognizable name for your browser profile to make it easier to identify later.

    <Frame>
      <img alt="How to Integrate Bright Data with MuLogin" />
    </Frame>

    3. Scroll down the page to find the **“Proxy Settings”** option. Click on it to open the proxy configuration window.

    <Frame>
      <img alt="How to Integrate Bright Data with MuLogin" />
    </Frame>
  </Step>

  <Step title="Input Your Bright Data Proxy Details">
    1. Once you’ve opened the proxy configuration window, you should see fields for the following:

       * **Protocol/Type:** Choose HTTP, HTTPS, or SOCKS5 depending on the proxy type you have from Bright Data.
         <Frame>
           <img alt="How to Integrate Bright Data with MuLogin" />
         </Frame>

       * **Host:** Enter `http://brd.superproxy.io/` or the host provided by Bright Data.

       * **Port:** Input the port number from your [Bright Data dashboard](https://brightdata.com/cp/zones).

       * **Username & Password:** Type in your Bright Data credentials.

       <Note>If you need a region-specific node (e.g., US), adjust your username to `your-username-country-US`.</Note>

    2. After entering your Bright Data proxy details (Host, Port, Username, and Password), look for a **“Check the network”** or **“Test Proxy”** button. Click it to verify that the proxy connection works correctly.

    3. If the test is successful, confirm your setup by clicking **“Save”**.
  </Step>

  <Step title="Launch the Browser Profile and Verify">
    1. After saving, launch the profile from your MuLogin dashboard.
    2. Inside this isolated browser, navigate to a site like [httpbin.org/ip](http://httpbin.org/ip) to verify that the displayed IP matches your Bright Data proxy’s IP instead of your own.
    3. If the IP matches, congratulations, your MuLogin profile is now using Bright Data proxies.
  </Step>
</Steps>

With **Bright Data** integrated into **MuLogin**, you’ve taken your online operations up a notch. Now you can manage multiple profiles more confidently, enjoying greater privacy, fewer detection issues, and a smooth, reliable workflow.


# How to set up Bright Data with Multilogin
Source: https://docs.brightdata.com/integrations/multilogin

Integrate Bright Data (400M+ residential IPs) with Multilogin for secure, undetectable browsing and improved privacy in web scraping and data collection.

<Warning>
  **Account management is not a supported use case** on the Bright Data platform as of April 1, 2026. This includes managing accounts on platforms like TikTok, Instagram, or similar services. Bright Data proxies cannot be used for this purpose. See [Acceptable Use Policy](https://brightdata.com/acceptable-use-policy) for details.
</Warning>

<Accordion title="Expand to get your Bright Data Proxy Access Information">
  ### Your proxy access information

  Bright Data proxies are grouped in "Proxy zones". Each zone holds the configuration for the proxies it holds.

  To get access to the proxy zone:

  1. Login to Bright Data control panel
  2. Select the proxy zone or setup a new one
  3. Click on the new zone name, and select the **Overview** tab.
  4. In the overview tab, under **Access details** you can find the proxy access details, and copy them to clipboard on click.
  5. You will need: Proxy Host, Proxy Port, Proxy Zone username and Proxy Zone password.
  6. Click on the copy icons to copy the text to your clipboard and paste in your tool's proxy configuration.

  ### Access Details Section Example

  <img alt="" />

  ### Residential proxy access

  To access Bright Data's **Residential Proxies** you must be a KYC-verified business account. Complete KYC verification with the Bright Data compliance team; there is no automatic or no-KYC path. Without KYC, use ISP or Datacenter proxies. [Read more...](/proxy-networks/residential/network-access)

  ### Targeting search engines?

  If you target a search engine like google, bing or yandex, you need a special Search Engine Results Page (**SERP**) proxy API. Use Bright Data SERP API to target search engines.
  [Click here to read more about Bright Data SERP proxy API.](/scraping-automation/serp-api/introduction)

  ### Correct setup of proxy test to avoid "PROXY ERROR"

  In many tools you will see a "test proxy" function, which performs a conncectivity test to your proxy, and some add a geolocation test as well, to identify the location of the proxy.
  To correctly test your proxy you should target those search queries to:
  `https://geo.brdtest.com/welcome.txt` .

  Some tools use popular search engines (like google.com) as a default test target. Bright Data will block those requests and you tool will show **proxy error** although your proxy is perfectly fine.

  If your proxy test fails, this is probably the reason. Make sure that your test domain is not a search engine (this is done in the tool configuration, and not controlled by Bright Data).
</Accordion>

## What is Multilogin?

Multilogin is a powerful browser tool designed for managing multiple online accounts without the risk of detection or bans. It’s a popular choice for marketers, affiliate marketers, and researchers who need isolated browsing environments for data collection and competitive intelligence.

Multilogin works by creating isolated, unique browsing profiles that simulate separate devices. Each profile appears as if it’s being accessed from a different location or device, making it impossible for platforms to link accounts. This ensures safer, undetected browsing, so you can manage multiple accounts with confidence.

<Tip>
  Maintain a consistent IP throughout your browser session by using the `-session` parameter in your username. This is essential because BrightData proxies default to rotating IPs with each request. [Learn more](/proxy-networks/faqs#how-to-use-the-same-ip-for-an-extended-period-of-time-and-how-long-can-i-keep-it-long-session) <br />

  New users should begin with ISP or Datacenter proxies, which need no KYC. Residential proxies require a [KYC-verified business account](/proxy-networks/residential/network-access).<br />
</Tip>

<Warning>
  Connections to the following social networks are not supported on Data Center and ISP proxy networks: Facebook, TikTok, Instagram, X (Twitter), LinkedIn, YouTube, Reddit, Pinterest, Snapchat, and Discord.
</Warning>

## Multilogin Proxy Integration

Follow these simple steps to set up Bright Data proxies in Multilogin:

<Steps>
  <Step title="Open Multilogin">
    Launch the [**Multilogin app**](https://multilogin.com/) and log in to your account.
  </Step>

  <Step title="Create a New Profile">
    Click on **New Profile** and enter the following details:

    * **Profile Name:** Choose a name for your profile (e.g., *Bright Data*).

    * **Operating System:** Select the operating system that matches your original setup (macOS, Windows, or Linux) to avoid fingerprint discrepancies.

    * **Storage Type:** Choose **Cloud Storage** if you plan to work in a team or use the profile on multiple devices.

    * **Browser Type:** Select between **Mimic** (based on Chrome) or **Stealthfox** (based on Firefox). Both options offer excellent anti-detection features.
  </Step>

  <Step title="Add a New Proxy">
    Within the profile settings, navigate to the **Proxy** section and choose **Custom**.
  </Step>

  <Step title="Configure Your Bright Data Proxy">
    Follow these steps to enter your Bright Data proxy details:

    * **Proxy**: Choose from `HTTP`, `HTTPS`, or `SOCKS5` (based on your proxy type).
    * **New address:**  Enter `http://brd.superproxy.io/`.
    * **Port**: Use the port number provided in your [Bright Data dashboard](https://brightdata.com/cp/zones).
    * **Login**: Enter your Bright Data proxy `username`.
    * **Password**: Enter your Bright Data proxy `password`.

    Click **Check Proxy** to verify the connection.

    <Info>
      * For **country-specific** proxies, you can enter a format like `your-username-country-US` to receive a US exit node.
      * If you configure multiple sessions, and you would like to assign specific IP to each session, add the IP address of the specific proxy with the option `-ip` to the username. So if the IP you want to use is `1.2.3.4` it should be: `your-username-ip-1.2.3.4`.
    </Info>
  </Step>

  <Step title="Save Your Settings">
    Once you’ve entered all the proxy details, click **Create Profile** to save your settings.
  </Step>
</Steps>

And that's it! You’ve successfully integrated Bright Data proxies with Multilogin.


# Set up Bright Data with Octo Browser
Source: https://docs.brightdata.com/integrations/octobrowser

Integrate Bright Data proxies (400M+ IPs) with Octo Browser to add anti-detection-grade IP routing to multi-account browsing and scraping workflows.

<Warning>
  **Account management is not a supported use case** on the Bright Data platform as of April 1, 2026. This includes managing accounts on platforms like TikTok, Instagram, or similar services. Bright Data proxies cannot be used for this purpose. See [Acceptable Use Policy](https://brightdata.com/acceptable-use-policy) for details.
</Warning>

<Accordion title="Expand to get your Bright Data Proxy Access Information">
  ### Your proxy access information

  Bright Data proxies are grouped in "Proxy zones". Each zone holds the configuration for the proxies it holds.

  To get access to the proxy zone:

  1. Login to Bright Data control panel
  2. Select the proxy zone or setup a new one
  3. Click on the new zone name, and select the **Overview** tab.
  4. In the overview tab, under **Access details** you can find the proxy access details, and copy them to clipboard on click.
  5. You will need: Proxy Host, Proxy Port, Proxy Zone username and Proxy Zone password.
  6. Click on the copy icons to copy the text to your clipboard and paste in your tool's proxy configuration.

  ### Access Details Section Example

  <img alt="" />

  ### Residential proxy access

  To access Bright Data's **Residential Proxies** you must be a KYC-verified business account. Complete KYC verification with the Bright Data compliance team; there is no automatic or no-KYC path. Without KYC, use ISP or Datacenter proxies. [Read more...](/proxy-networks/residential/network-access)

  ### Targeting search engines?

  If you target a search engine like google, bing or yandex, you need a special Search Engine Results Page (**SERP**) proxy API. Use Bright Data SERP API to target search engines.
  [Click here to read more about Bright Data SERP proxy API.](/scraping-automation/serp-api/introduction)

  ### Correct setup of proxy test to avoid "PROXY ERROR"

  In many tools you will see a "test proxy" function, which performs a conncectivity test to your proxy, and some add a geolocation test as well, to identify the location of the proxy.
  To correctly test your proxy you should target those search queries to:
  `https://geo.brdtest.com/welcome.txt` .

  Some tools use popular search engines (like google.com) as a default test target. Bright Data will block those requests and you tool will show **proxy error** although your proxy is perfectly fine.

  If your proxy test fails, this is probably the reason. Make sure that your test domain is not a search engine (this is done in the tool configuration, and not controlled by Bright Data).
</Accordion>

## What is Octo Browser?

Octo Browser is a smart tool for managing multiple browser profiles without the risk of detection. It’s perfect for marketers, researchers, and web scrapers who need anonymous, geo-flexible browsing.

Octo Browser creates separate profiles, each with its own unique settings, such as IP addresses and device details, ensuring your accounts stay unlinked. It supports HTTP, HTTPS, and SOCKS5 proxies, and offers features like automation and team collaboration, making it a powerful, user-friendly solution for secure and efficient online activity.

<Tip>
  Maintain a consistent IP throughout your browser session by using the `-session` parameter in your username. This is essential because BrightData proxies default to rotating IPs with each request. [Learn more](/proxy-networks/faqs#how-to-use-the-same-ip-for-an-extended-period-of-time-and-how-long-can-i-keep-it-long-session) <br />

  New users should begin with ISP or Datacenter proxies, which need no KYC. Residential proxies require a [KYC-verified business account](/proxy-networks/residential/network-access).<br />
</Tip>

<Warning>
  Connections to the following social networks are not supported on Data Center and ISP proxy networks: Facebook, TikTok, Instagram, X (Twitter), LinkedIn, YouTube, Reddit, Pinterest, Snapchat, and Discord.
</Warning>

## Octo Browser Proxy Integration

Here’s how to integrate Bright Data proxies into Octo Browser:

<Steps>
  <Step title="Install Octo Browser">
    Download and install [**Octo Browser**](https://octobrowser.net/download/), then log in to your account.
  </Step>

  <Step title="Create Profile">
    1. Navigate to **Profiles** and click **Create Profile**.
    2. Name your profile and set your desired configuration.
  </Step>

  <Step title="Add a Proxy">
    1. Go to the **Connection** tab in the profile settings and click on the **Proxy** field.
    2. Click **+ Set a new proxy** to open the proxy configuration window.
  </Step>

  <Step title="Configure Your Bright Data Proxy">
    In the pop-up window, enter your Bright Data proxy details:

    * **Host**: Enter `http://brd.superproxy.io/`.
    * **Port**: Use the port number provided in your [Bright Data dashboard](https://brightdata.com/cp/zones).
    * **Login**: Enter your Bright Data proxy `username`.
    * **Password**: Enter your Bright Data proxy `password`.

    <Info>
      **For country-specific proxies, you can enter a format like `your-username-country-US` to receive a US exit node.**
    </Info>
  </Step>

  <Step title="Test the Proxy">
    1. Click **Check Proxy** to ensure the connection is active and working correctly.
    2. Once confirmed, click **Confirm** to save the proxy settings to the profile.
  </Step>

  <Step title="Save and Launch the Profile">
    1. Click **Create Profile** to save your setup.
    2. You can now launch your configured profile by clicking **Start** in the Profiles section.
  </Step>
</Steps>

And that’s it! You’ve successfully integrated Bright Data proxies with Octo Browser.


# How to set up Bright Data with Octoparse
Source: https://docs.brightdata.com/integrations/octoparse

Configure Bright Data proxies (400M+ residential IPs) inside Octoparse to extract data from complex sites without IP blocks, with geo-targeted exits.

<Accordion title="Expand to get your Bright Data Proxy Access Information">
  ### Your proxy access information

  Bright Data proxies are grouped in "Proxy zones". Each zone holds the configuration for the proxies it holds.

  To get access to the proxy zone:

  1. Login to Bright Data control panel
  2. Select the proxy zone or setup a new one
  3. Click on the new zone name, and select the **Overview** tab.
  4. In the overview tab, under **Access details** you can find the proxy access details, and copy them to clipboard on click.
  5. You will need: Proxy Host, Proxy Port, Proxy Zone username and Proxy Zone password.
  6. Click on the copy icons to copy the text to your clipboard and paste in your tool's proxy configuration.

  ### Access Details Section Example

  <img alt="" />

  ### Residential proxy access

  To access Bright Data's **Residential Proxies** you must be a KYC-verified business account. Complete KYC verification with the Bright Data compliance team; there is no automatic or no-KYC path. Without KYC, use ISP or Datacenter proxies. [Read more...](/proxy-networks/residential/network-access)

  ### Targeting search engines?

  If you target a search engine like google, bing or yandex, you need a special Search Engine Results Page (**SERP**) proxy API. Use Bright Data SERP API to target search engines.
  [Click here to read more about Bright Data SERP proxy API.](/scraping-automation/serp-api/introduction)

  ### Correct setup of proxy test to avoid "PROXY ERROR"

  In many tools you will see a "test proxy" function, which performs a conncectivity test to your proxy, and some add a geolocation test as well, to identify the location of the proxy.
  To correctly test your proxy you should target those search queries to:
  `https://geo.brdtest.com/welcome.txt` .

  Some tools use popular search engines (like google.com) as a default test target. Bright Data will block those requests and you tool will show **proxy error** although your proxy is perfectly fine.

  If your proxy test fails, this is probably the reason. Make sure that your test domain is not a search engine (this is done in the tool configuration, and not controlled by Bright Data).
</Accordion>

## What is Octoparse?

Octoparse is a user-friendly web scraping tool that allows you to collect data from websites without needing any coding knowledge. With its simple point-and-click interface, Octoparse enables you to extract information from even the most complex sites. It offers the flexibility to customize, automate, and schedule scraping tasks, saving the extracted data in formats such as CSV or Excel. Perfect for market research, price tracking, or lead generation, Octoparse makes data collection fast, easy, and efficient!

## Octoparse Proxy Integration

Follow these simple steps to integrate Bright Data proxies with Octoparse:

<Steps>
  <Step title="Install Octoparse">
    Visit the [Octoparse website](https://www.octoparse.com/download) to download and install Octoparse.
  </Step>

  <Step title="Create a New Task">
    Click the **+New** button in the top-left corner, then select **Custom Task**.

    <Frame>
      <img alt="Octoparse Proxy Integration" />
    </Frame>
  </Step>

  <Step title="Enter the Target URL">
    In the **URL Input** field, enter the URL of the website you wish to scrape, then click **Save**.
  </Step>

  <Step title="Access Proxy Settings">
    Once the page loads, navigate to **Task Settings > Anti-blocking**.

    <Frame>
      <img alt="Octoparse Proxy Integration" />
    </Frame>
  </Step>

  <Step title="Enable Proxy Usage">
    Check **Access websites via proxies** and select **Use my own proxies**. Then click **Configure**.

    <Frame>
      <img alt="Octoparse Proxy Integration" />
    </Frame>
  </Step>

  <Step title="Configure Your Bright Data Proxy">
    In the pop-up window, enter your Bright Data proxy details in the following format:

    ```sh theme={null}
    IP/host:port:username:password
    ```

    * **IP/host**: Enter `http://brd.superproxy.io/`.
    * **Port**: Use the port number provided in your [Bright Data dashboard](https://brightdata.com/cp/zones/page/plans).
    * **Username**: Enter your Bright Data proxy `username`.
    * **Password**: Enter your Bright Data proxy `password`.

    <Info>
      For country-specific proxies, you can enter a format like `your-username-country-US` to receive a US exit node.
    </Info>

    If you're using rotating proxies, set the **Switch interval** to specify how often the IPs should rotate. For sticky sessions, adjust it according to your preferred session length.

    <Frame>
      <img alt="Octoparse Proxy Integration" />
    </Frame>
  </Step>

  <Step title="Save Your Settings">
    Click **Confirm** to apply the changes, then click **Save**.
  </Step>
</Steps>

And that's it! You've now successfully integrated Bright Data proxies with Octoparse.


# How to set up Bright Data with ParseHub
Source: https://docs.brightdata.com/integrations/parsehub

Integrate Bright Data proxies (400M+ IPs) with ParseHub for secure, anonymous web scraping access, reducing the risk of detection and IP bans at scale.

<Accordion title="Expand to get your Bright Data Proxy Access Information">
  ### Your proxy access information

  Bright Data proxies are grouped in "Proxy zones". Each zone holds the configuration for the proxies it holds.

  To get access to the proxy zone:

  1. Login to Bright Data control panel
  2. Select the proxy zone or setup a new one
  3. Click on the new zone name, and select the **Overview** tab.
  4. In the overview tab, under **Access details** you can find the proxy access details, and copy them to clipboard on click.
  5. You will need: Proxy Host, Proxy Port, Proxy Zone username and Proxy Zone password.
  6. Click on the copy icons to copy the text to your clipboard and paste in your tool's proxy configuration.

  ### Access Details Section Example

  <img alt="" />

  ### Residential proxy access

  To access Bright Data's **Residential Proxies** you must be a KYC-verified business account. Complete KYC verification with the Bright Data compliance team; there is no automatic or no-KYC path. Without KYC, use ISP or Datacenter proxies. [Read more...](/proxy-networks/residential/network-access)

  ### Targeting search engines?

  If you target a search engine like google, bing or yandex, you need a special Search Engine Results Page (**SERP**) proxy API. Use Bright Data SERP API to target search engines.
  [Click here to read more about Bright Data SERP proxy API.](/scraping-automation/serp-api/introduction)

  ### Correct setup of proxy test to avoid "PROXY ERROR"

  In many tools you will see a "test proxy" function, which performs a conncectivity test to your proxy, and some add a geolocation test as well, to identify the location of the proxy.
  To correctly test your proxy you should target those search queries to:
  `https://geo.brdtest.com/welcome.txt` .

  Some tools use popular search engines (like google.com) as a default test target. Bright Data will block those requests and you tool will show **proxy error** although your proxy is perfectly fine.

  If your proxy test fails, this is probably the reason. Make sure that your test domain is not a search engine (this is done in the tool configuration, and not controlled by Bright Data).
</Accordion>

## What is ParseHub?

ParseHub stands out as a user-friendly, powerful web scraping tool that revolutionizes data extraction from the web. Its intuitive design allows users to effortlessly interact with complex sites, manage AJAX and JavaScript elements, and navigate through forms and infinite scrolls, all without writing a single line of code. By integrating Bright Data proxies with ParseHub, users gain an unmatched advantage, seamlessly handling even the most challenging data extraction tasks with ease. This combination ensures not only efficient data scraping but also a high level of privacy and security, making it an ideal solution for professionals seeking comprehensive data collection capabilities.

## Bright Data Proxies: Empowering Your ParseHub Experience

Integrating Bright Data [proxies](https://brightdata.com/proxy-types) with ParseHub transforms your web scraping capabilities, bringing a new level of efficiency and reliability to your data extraction tasks. Here’s why Bright Data’s proxy solutions are an ideal match for ParseHub’s powerful scraping features:

**Extensive Proxy Network**

* Global Reach: Access 400M+ monthly residential IPs across 195+ countries, ensuring you can scrape data from any geographic region.
* Diverse Proxy Types: Choose from residential, datacenter, static residential, and mobile proxies to fit the specific needs of your scraping projects.

**Enhanced Anonymity and Security**

* Robust Privacy: Protect your scraping activities from detection and blocking, maintaining the anonymity of your operations.
* Secure Data Collection: Confidently scrape sensitive data with the assurance of Bright Data’s advanced security measures.

**High Performance and Reliability**

* Speed and Efficiency: Experience fast and efficient data extraction, even from complex, JavaScript-heavy websites.
* Reliable Connectivity: Minimize disruptions and maintain consistent performance with Bright Data’s stable proxy infrastructure.

**Versatile and Scalable Solutions**

* Adaptable to Various Use Cases: Whether for market research, web scraping, SEO analysis, or competitive intelligence, Bright Data’s proxies are versatile enough to handle diverse scraping scenarios.
* Scalability: Effortlessly scale your scraping operations to handle large volumes of data without compromising on speed or accuracy.

**User-Friendly Integration**

* Simple Setup: Easily integrate Bright Data proxies with ParseHub, regardless of your technical expertise.
* Comprehensive Support: Benefit from Bright Data’s extensive documentation and customer support for a smooth integration process.

## How to integrate ParseHub proxies:

<Steps>
  <Step title="Sign up to Bright Data">
    1. After signing up, go to the Bright Data dashboard
    2. Navigate to the “**Proxy & Scraping Infrastructure**” section
    3. **Add** a new designated **Zone** for your proxy usage.

    <Frame>
      <img alt="ph-add-zone-2.png" />
    </Frame>
  </Step>

  <Step title="Select proxy type">
    In this example, we will show how to set up ISP proxies.

    <Frame>
      <img alt="ph-proxy-types.png" />
    </Frame>
  </Step>

  <Step title="Name proxy solution">
    <Frame>
      <img alt="ph-select-ip-type.png" />
    </Frame>
  </Step>

  <Step title="Select IP count">
    Fill in the number of IPs you need.

    <Frame>
      <img alt="ph-number-of-ips-1.png" />
    </Frame>
  </Step>

  <Step title="Country & city selection">
    Choose your desired country and city for the IP location.

    <Frame>
      <img alt="ph-city-ip.png" />
    </Frame>
  </Step>

  <Step title="Choose domain">
    Use specific domains or use ‘All domains’ for one IP to target websites using the same IP.

    <Frame>
      <img alt="ph-domains.png" />
    </Frame>
  </Step>

  <Step title="Add zone">
    Click the “**Add**” button to create the Zone.

    <Frame>
      <img alt="ph-click-add.png" />
    </Frame>
  </Step>

  <Step title="Access parameters">
    Click on the name of your Zone, navigate to the “Access Parameters” tab, and note down the proxy credentials:

    <Frame>
      <img alt="ph-access-parameters.png" />
    </Frame>

    1. host: brd.superproxy.io
    2. port: 44445
    3. username: `your-zone-username`
    4. password: `your-zone-password`
  </Step>

  <Step title="Download and Install ParseHub">
    <Frame>
      <img alt="ph-parsehub.png" />
    </Frame>

    * Visit the official website of ParseHub, download, and install the ParseHub application suitable for your operating system.
    * Launch ParseHub and either create a new account or log into your existing account.
  </Step>

  <Step title="Create a New Project">
    Click on the “+ New Project” button from the ParseHub home screen.

    <Frame>
      <img alt="ph-create-a-new-project.png" />
    </Frame>
  </Step>

  <Step title="Start a New Project with a URL">
    Insert a URL from which you wish to scrape data (for example, instagram.com) and press “Start project on this URL”.

    <Frame>
      <img alt="ph-start-new-project.png" />
    </Frame>
  </Step>

  <Step title="Navigate to Proxy Configuration in ParseHub">
    Switch to the Browser mode, slider turns green to indicate browsing mode.

    <Frame>
      <img alt="ph-broswer-mode.png" />
    </Frame>
  </Step>

  <Step title="Settings">
    Open the settings located at the top-right side of the Browser interface and click on “options”.

    <Frame>
      <img alt="ph-open-settings.png" />
    </Frame>
  </Step>

  <Step title="Access Advanced Network Settings">
    Select the “Advanced” tab.

    <Frame>
      <img alt="ph-advanced-network-settings.png" />
    </Frame>
  </Step>

  <Step title="Click on the “Network” tab">
    Under “Connection” choose “Settings”.

    <Frame>
      <img alt="ph-connection-settings.png" />
    </Frame>
  </Step>

  <Step title="Configure Manual Proxy Settings">
    In the network settings, select “Manual proxy configuration”.

    <Frame>
      <img alt="ph-configure-manual-settings.png" />
    </Frame>
  </Step>

  <Step title="Proxy settings">
    Under HTTP Proxy field enter the Bright Data proxy URL **brd.superproxy.io** and port as **44445**.

    <Frame>
      <img alt="ph-proxy-and-port.png" />
    </Frame>
  </Step>

  <Step title="Switch to SOCKS v4 and click ok">
    After you switched to the SOCKS v4, click the ‘OK’ button.

    <Frame>
      <img alt="ph-switch-to-socks.png" />
    </Frame>
  </Step>

  <Step title="Proxy zone credentials">
    Insert your proxy zone’s credentials , they can be found on your proxy zone’s access parameters.

    <Frame>
      <img alt="ph-access-param-parsehub.png" />
    </Frame>
  </Step>

  <Step title="Format Proxy Configuration">
    * Format your proxy details as IPAddress:Port:Username:Password:Realm.
    * In case of Bright Data Proxies it will be:\
      `brd.superproxy.io:44445:brd-customer-hl_******-zone-isp_proxy6:b1s*****:BrightData`

    Apply Configured Proxy to ParseHub Project:

    * Navigate to your project settings in ParseHub.

    <Frame>
      <img alt="ph-project-settings.png" />
    </Frame>
  </Step>

  <Step title="Enable Custom Proxies">
    Check “Rotate IP Addresses” to enable the “Custom Proxy” text box.

    <Frame>
      <img alt="ph-custom-proxies.png" />
    </Frame>
  </Step>

  <Step title="Custom proxies field">
    Paste your formatted proxy into the “Custom Proxies” field. For multiple proxies, list each one on a separate line.

    <Frame>
      <img alt="ph-custom-proxies-field.png" />
    </Frame>
  </Step>

  <Step title="Save your project settings">
    After saving, run it with your Bright Data Proxies.

    <Frame>
      <img alt="ph-save-project.png" />
    </Frame>
  </Step>
</Steps>

<Warning>
  **Important note**:

  If you are using Bright Data’s Residential Proxies, Web Unlocker API or SERP API, you need to install an SSL certificate to enable end-to-end secure connections to your target website(s).

  This is a simple process, see [this guide](/general/account/ssl-certificate#installation-of-the-ssl-certificate) for instructions.
</Warning>


# How to set up Bright Data with Postern
Source: https://docs.brightdata.com/integrations/postern

Configure Bright Data proxies in Postern on Android to route system-wide traffic through residential, datacenter, ISP, or mobile IPs. Spans 195 countries.

<Accordion title="Expand to get your Bright Data Proxy Access Information">
  ### Your proxy access information

  Bright Data proxies are grouped in "Proxy zones". Each zone holds the configuration for the proxies it holds.

  To get access to the proxy zone:

  1. Login to Bright Data control panel
  2. Select the proxy zone or setup a new one
  3. Click on the new zone name, and select the **Overview** tab.
  4. In the overview tab, under **Access details** you can find the proxy access details, and copy them to clipboard on click.
  5. You will need: Proxy Host, Proxy Port, Proxy Zone username and Proxy Zone password.
  6. Click on the copy icons to copy the text to your clipboard and paste in your tool's proxy configuration.

  ### Access Details Section Example

  <img alt="" />

  ### Residential proxy access

  To access Bright Data's **Residential Proxies** you must be a KYC-verified business account. Complete KYC verification with the Bright Data compliance team; there is no automatic or no-KYC path. Without KYC, use ISP or Datacenter proxies. [Read more...](/proxy-networks/residential/network-access)

  ### Targeting search engines?

  If you target a search engine like google, bing or yandex, you need a special Search Engine Results Page (**SERP**) proxy API. Use Bright Data SERP API to target search engines.
  [Click here to read more about Bright Data SERP proxy API.](/scraping-automation/serp-api/introduction)

  ### Correct setup of proxy test to avoid "PROXY ERROR"

  In many tools you will see a "test proxy" function, which performs a conncectivity test to your proxy, and some add a geolocation test as well, to identify the location of the proxy.
  To correctly test your proxy you should target those search queries to:
  `https://geo.brdtest.com/welcome.txt` .

  Some tools use popular search engines (like google.com) as a default test target. Bright Data will block those requests and you tool will show **proxy error** although your proxy is perfectly fine.

  If your proxy test fails, this is probably the reason. Make sure that your test domain is not a search engine (this is done in the tool configuration, and not controlled by Bright Data).
</Accordion>

## What is Postern?

Postern is an Android proxy manager that allows users to route app traffic through proxies for secure and private connections. Supporting HTTP, HTTPS, and SOCKS5 proxies, it’s a versatile tool for managing internet connections and optimizing workflows.

## How to Set Up Bright Data With Postern

<Steps>
  <Step title="Download and Install Postern">
    1. Find the app in the Google Play Store and install Postern on your Android device.
    2. Open the app and allow any required permissions.
  </Step>

  <Step title="Configure Proxy Settings">
    1. Open Postern and tap **Add Proxy** to start configuring a new proxy.

    <Frame>
      <img alt="How to Set Up Bright Data With Postern" />
    </Frame>

    2. Fill in your Bright Data proxy details:
       * **Server Name**: Enter a descriptive name (e.g., "Bright Data Proxy").
       * **Server Address**: `http://brd.superproxy.io/`.
       * **Server Port**: Use the port number provided in your [Bright Data dashboard](https://brightdata.com/cp/zones/page/plans).
       * **Server Type**: Choose HTTP, HTTPS, or SOCKS5 based on your proxy type.
       * **Username**: Input your Bright Data `username`.
       * **Password**: Input your Bright Data `password`.

    3. Tap **Save** to save the proxy configuration.
  </Step>

  <Step title="Configure Rules to Enable the Proxy">
    1. Go to the app menu and navigate to **Rules**.

    <Frame>
      <img alt="How to Set Up Bright Data With Postern" />
    </Frame>

    2. Tap **Add Rule** to create a new rule for your proxy.

    <Frame>
      <img alt="How to Set Up Bright Data With Postern" />
    </Frame>

    3. Set the following:

    * **Match Method**: Select **Match All** to route all traffic through the proxy.
    * **Rule Type**: Choose **Proxy/Tunnel**.
    * **Proxy/Proxy Group**: Ensure your configured proxy (e.g., `http://brd.superproxy.io/:port`) is selected.

    4. Tap **Save** to finalize the rule configuration.
  </Step>

  <Step title="Activate the Proxy">
    1. Open the app menu and toggle **VPN Off** to enable the connection.
    2. Once activated, all traffic will be routed through your Bright Data proxy.

    <Frame>
      <img alt="How to Set Up Bright Data With Postern" />
    </Frame>

    <Note>
      For geo-targeted proxies, update your username format to include a country code (e.g., `your-username-country-US`) to route through a specific location.
    </Note>
  </Step>
</Steps>

With Bright Data configured in Postern, your app traffic is now routed securely and anonymously. Whether you're managing proxies for personal use or business workflows, this setup ensures privacy and seamless connectivitкy.


# How to use Bright Data with Postman
Source: https://docs.brightdata.com/integrations/postman

Configure Bright Data proxies (port 44445) in Postman to route API tests through residential, datacenter, ISP or mobile IPs with geo-targeted exit nodes.

<Accordion title="Expand to get your Bright Data Proxy Access Information">
  ### Your proxy access information

  Bright Data proxies are grouped in "Proxy zones". Each zone holds the configuration for the proxies it holds.

  To get access to the proxy zone:

  1. Login to Bright Data control panel
  2. Select the proxy zone or setup a new one
  3. Click on the new zone name, and select the **Overview** tab.
  4. In the overview tab, under **Access details** you can find the proxy access details, and copy them to clipboard on click.
  5. You will need: Proxy Host, Proxy Port, Proxy Zone username and Proxy Zone password.
  6. Click on the copy icons to copy the text to your clipboard and paste in your tool's proxy configuration.

  ### Access Details Section Example

  <img alt="" />

  ### Residential proxy access

  To access Bright Data's **Residential Proxies** you must be a KYC-verified business account. Complete KYC verification with the Bright Data compliance team; there is no automatic or no-KYC path. Without KYC, use ISP or Datacenter proxies. [Read more...](/proxy-networks/residential/network-access)

  ### Targeting search engines?

  If you target a search engine like google, bing or yandex, you need a special Search Engine Results Page (**SERP**) proxy API. Use Bright Data SERP API to target search engines.
  [Click here to read more about Bright Data SERP proxy API.](/scraping-automation/serp-api/introduction)

  ### Correct setup of proxy test to avoid "PROXY ERROR"

  In many tools you will see a "test proxy" function, which performs a conncectivity test to your proxy, and some add a geolocation test as well, to identify the location of the proxy.
  To correctly test your proxy you should target those search queries to:
  `https://geo.brdtest.com/welcome.txt` .

  Some tools use popular search engines (like google.com) as a default test target. Bright Data will block those requests and you tool will show **proxy error** although your proxy is perfectly fine.

  If your proxy test fails, this is probably the reason. Make sure that your test domain is not a search engine (this is done in the tool configuration, and not controlled by Bright Data).
</Accordion>

## What is Postman?

Postman is a widely-used API platform that simplifies testing, developing, and managing APIs. It allows developers to send requests, monitor responses, and organize workflows efficiently. Integrating Bright Data with Postman ensures anonymity, security, and the ability to test APIs in different geo-locations.

## Why Use Bright Data With Postman?

* **Enhanced Privacy**: Mask your IP address to keep your API testing anonymous.

* **Geo-Specific Testing**: Use Bright Data proxies to simulate API calls from different countries.

* **Improved Security**: Safeguard your API requests with secure and private connections.

## How to Integrate Bright Data With Postman

<Steps>
  <Step title="Prerequisites">
    1. **Download Postman**: Install the latest version of [Postman](https://www.postman.com/downloads/). Once installed, launch the application and sign in to your account.
    2. **Bright Data Proxy Credentials**:
       * Log in to your [Bright Data dashboard](https://brightdata.com/cp/zones/page/plans) to retrieve your **Host**, **Port**, **Username**, and **Password**.
       * For geo-specific proxies, modify your username using the format `your-username-country-XX` (e.g., `your-username-country-US`).
  </Step>

  <Step title="Access Proxy Settings">
    1. In the Postman interface, click the **gear icon** in the top-right corner to access the **Settings** menu.

    <Frame>
      <img alt="How to Integrate Bright Data With Postman" />
    </Frame>
  </Step>

  <Step title="Configure Bright Data Details">
    1. Navigate to the **Proxy** tab on the left-hand menu.
    2. Toggle the "**Use custom proxy configuration**" to *On* if it’s not already enabled.
    3. Enter your Bright Data proxy details:
       * **Type**: Select either HTTP or HTTPS based on your Bright Data configuration.
       * **Host**: Enter `http://brd.superproxy.io/`.
       * **Port**: Use the port number provided in your [Bright Data dashboard](https://brightdata.com/cp/zones/page/plans).
       * **Username**: Enter your Bright Data `username`.
       * **Password**: Enter your Bright Data `password`.
  </Step>

  <Step title="Test Your Proxy Configuration">
    1. Create a new request in Postman and set the method to **GET**.
    2. Enter the following URL to test the proxy: [https://httpbin.org/ip](https://httpbin.org/ip).
    3. Click **Send** to execute the request.

    If the response shows the IP address of your Bright Data proxy, the configuration is successful.
  </Step>
</Steps>

By integrating Bright Data proxies with Postman, you enhance your API testing workflows with privacy and reliability. Whether you’re debugging, developing, or scaling API tasks, Bright Data proxies provide the secure and anonymous connection you need. Try it out today to streamline your API projects!


# Set up Bright Data with Proxifier
Source: https://docs.brightdata.com/integrations/proxifier

Step-by-step guide to configuring Bright Data proxies in Proxifier to route traffic from applications that lack native proxy support. Spans 195 countries.

<Accordion title="Expand to get your Bright Data Proxy Access Information">
  ### Your proxy access information

  Bright Data proxies are grouped in "Proxy zones". Each zone holds the configuration for the proxies it holds.

  To get access to the proxy zone:

  1. Login to Bright Data control panel
  2. Select the proxy zone or setup a new one
  3. Click on the new zone name, and select the **Overview** tab.
  4. In the overview tab, under **Access details** you can find the proxy access details, and copy them to clipboard on click.
  5. You will need: Proxy Host, Proxy Port, Proxy Zone username and Proxy Zone password.
  6. Click on the copy icons to copy the text to your clipboard and paste in your tool's proxy configuration.

  ### Access Details Section Example

  <img alt="" />

  ### Residential proxy access

  To access Bright Data's **Residential Proxies** you must be a KYC-verified business account. Complete KYC verification with the Bright Data compliance team; there is no automatic or no-KYC path. Without KYC, use ISP or Datacenter proxies. [Read more...](/proxy-networks/residential/network-access)

  ### Targeting search engines?

  If you target a search engine like google, bing or yandex, you need a special Search Engine Results Page (**SERP**) proxy API. Use Bright Data SERP API to target search engines.
  [Click here to read more about Bright Data SERP proxy API.](/scraping-automation/serp-api/introduction)

  ### Correct setup of proxy test to avoid "PROXY ERROR"

  In many tools you will see a "test proxy" function, which performs a conncectivity test to your proxy, and some add a geolocation test as well, to identify the location of the proxy.
  To correctly test your proxy you should target those search queries to:
  `https://geo.brdtest.com/welcome.txt` .

  Some tools use popular search engines (like google.com) as a default test target. Bright Data will block those requests and you tool will show **proxy error** although your proxy is perfectly fine.

  If your proxy test fails, this is probably the reason. Make sure that your test domain is not a search engine (this is done in the tool configuration, and not controlled by Bright Data).
</Accordion>

## What is Proxifier?

**Proxifier** is a powerful desktop application that allows programs without native proxy support to connect through HTTPS, HTTP, or SOCKS5 proxies. It’s ideal for routing traffic securely, managing application-specific connections, and providing an alternative to VPNs. Its rule-based setup lets you assign proxies to specific applications, giving you precise control over your internet usage.

## How to Integrate Bright Data With Proxifier

**Step 1. Download and Install Proxifier**

1. Visit the [Proxifier website](https://www.proxifier.com/download/) to download the application.

2. Follow the installation instructions and launch Proxifier on your system.

**Step 2. Access Proxy Settings**

1. Open Proxifier and navigate to the **Profile** menu.

2. Select **Proxy Servers** to manage your proxy configurations.

<Frame>
  <img alt="Proxifier Profile menu showing Proxy Servers option" />
</Frame>

**Step 3. Add Your Bright Data Proxy**

1. Click the **Add** button to configure a new proxy.

<Frame>
  <img alt="Proxifier Proxy Servers dialog with Add button highlighted" />
</Frame>

2. In the **Proxy Server** dialog, input the following details:

* **Type**: Select HTTP, HTTPS, or SOCKS5.
* **Address**: `http://brd.superproxy.io/`.
* **Port**: Enter the port from your [Bright Data dashboard](https://brightdata.com/cp/zones/page/plans).
* Enable **Authentication** and provide:
  * **Username**: Your Bright Data username.
  * **Password**: Your Bright Data password.

3. Click **OK** to save the settings. The proxy will now appear in the list.

<Note>
  **`For geo-targeted proxies, include the country code in your username (e.g., your-username-country-US for a US-based IP).`**
</Note>

**Step 4. Test the Proxy Connection**

1. In the **Proxy Servers** section, select your configured proxy.

2. Click **Check** and then **Start Testing**. Ensure the test is successful before proceeding.

<Frame>
  <img alt="Proxifier Check Proxy test result confirming a successful Bright Data connection" />
</Frame>

**Step 5. Create Proxy Rules for Applications**

1. Go to **Profile** > **Proxification Rules**.

<Frame>
  <img alt="Proxifier Profile menu showing Proxification Rules option" />
</Frame>

2. Click **Add** to set up a new rule.

<Frame>
  <img alt="Proxifier Proxification Rules dialog with Add button to create a new rule" />
</Frame>

3. Name the rule for clarity.

<Frame>
  <img alt="Proxifier rule configuration dialog showing the Name field" />
</Frame>

4. Use the **Browse** button to specify the application (e.g., Chrome, Firefox) for the rule.

<Frame>
  <img alt="Proxifier Applications field with Browse button to select target application" />
</Frame>

5. Choose how the traffic is routed:

* Through the proxy.
* Directly to the internet.
* Blocked entirely.

<Frame>
  <img alt="Proxifier rule Action options: Proxy, Direct, or Block traffic" />
</Frame>

6. Save the rule and move it to the top of the list for priority.

<Frame>
  <img alt="Proxifier rules list with the new Bright Data rule moved to the top" />
</Frame>

**Step 6. Verify and Start Browsing**

1. Launch the application associated with your rule.

2. Visit an IP-checking website (e.g., [httpbin.org/ip](http://httpbin.org/ip)) to confirm that the proxy is active.

With **Bright Data** set up in **Proxifier**, you can manage your network traffic with precision, route applications through secure proxies, and ensure privacy for even the most complex workflows. Whether you need anonymity, faster connections, or app-specific routing, this setup empowers you to control your internet experience with ease.

## Why I get wrong GeoLocation or blocked with Proxifier and BrightData?

Proxifier enables you to control applications running and selectively direct them to route their traffic via Bright Data's proxy. If the application is attempting to access and IP address and not a domain name, Bright Data may either block it or route the request thru our Superproxy servers and not the Proxy peers. It means that the target domain will see this request coming from Bright Data servers and not from your assigned proxy and may block it.

Bright Data does not allow targeting IP addresses due to our compliance rules and regulations.


# Proxy Manager integrations
Source: https://docs.brightdata.com/integrations/proxy-manager-integrations

Configure Bright Data proxies in proxy managers like FoxyProxy and Proxifier for system-wide, per-app or per-browser routing on Windows, macOS and Linux.

<CardGroup>
  <Card title="FoxyProxy" icon="https://mintcdn.com/brightdata/pq7wn7mJJj8UJsym/images/integrations/foxyproxy1.png?fit=max&auto=format&n=pq7wn7mJJj8UJsym&q=85&s=53800ad4881823fdef26a74df18d6fba" href="/integrations/foxyproxy">
    Manage and switch Bright Data proxy configurations in Firefox and Chrome with FoxyProxy.
  </Card>

  <Card title="Proxifier" icon="https://mintcdn.com/brightdata/z2V3XghEDR2bikNt/images/integrations/proxifier1.png?fit=max&auto=format&n=z2V3XghEDR2bikNt&q=85&s=78faf92ef402b9cb91e9d559446eeea3" href="/integrations/proxifier">
    Route any application's traffic through Bright Data proxies system-wide with Proxifier.
  </Card>

  <Card title="SwitchyOmega" icon="https://mintcdn.com/brightdata/z2V3XghEDR2bikNt/images/integrations/switchyomega1.png?fit=max&auto=format&n=z2V3XghEDR2bikNt&q=85&s=f1a3e55c0fc6cfbe7c43bbc65898a79c" href="/integrations/switchyomega">
    Manage and switch between Bright Data proxy profiles in Chrome with SwitchyOmega.
  </Card>

  <Card title="Shadowrocket" icon="https://mintcdn.com/brightdata/pq7wn7mJJj8UJsym/images/integrations/postern1.jpg?fit=max&auto=format&n=pq7wn7mJJj8UJsym&q=85&s=c9d7b9e1d4f6379fcc519dc36b88e09e" href="/integrations/shadowrocket">
    Configure Bright Data proxies on iOS with the Shadowrocket app.
  </Card>

  <Card title="Postern" icon="https://mintcdn.com/brightdata/pq7wn7mJJj8UJsym/images/integrations/postern1.jpg?fit=max&auto=format&n=pq7wn7mJJj8UJsym&q=85&s=c9d7b9e1d4f6379fcc519dc36b88e09e" href="/integrations/postern">
    Set up Bright Data proxies on Android with the Postern proxy manager.
  </Card>
</CardGroup>


# Scraping tools integrations
Source: https://docs.brightdata.com/integrations/scraping-tools-integrations

Use Bright Data proxies with web scraping frameworks like Scrapy, BeautifulSoup, Puppeteer, Playwright and Selenium for reliable, unblocked data collection.

<CardGroup>
  <Card title="Scrapy" icon="spider" href="/integrations/scrapy">
    Configure Bright Data residential or datacenter proxies in Scrapy spiders.
  </Card>

  <Card title="BeautifulSoup" icon="code" href="/integrations/beautifulsoup">
    Use Bright Data proxies with Python's BeautifulSoup parsing library.
  </Card>

  <Card title="Octoparse" icon="https://mintcdn.com/brightdata/pq7wn7mJJj8UJsym/images/integrations/octoparse1.png?fit=max&auto=format&n=pq7wn7mJJj8UJsym&q=85&s=43b9c31bb400f0658336d40237f8aae9" href="/integrations/octoparse">
    Add Bright Data proxy support to Octoparse no-code scraping workflows.
  </Card>

  <Card title="ParseHub" icon="https://mintcdn.com/brightdata/pq7wn7mJJj8UJsym/images/integrations/ph-parsehub.png?fit=max&auto=format&n=pq7wn7mJJj8UJsym&q=85&s=26a4e7b84f81389e54365fa7e41dac44" href="/integrations/parsehub">
    Route ParseHub scraping jobs through Bright Data proxies.
  </Card>

  <Card title="Screaming Frog" icon="https://mintcdn.com/brightdata/z2V3XghEDR2bikNt/images/integrations/screamingfrog1.png?fit=max&auto=format&n=z2V3XghEDR2bikNt&q=85&s=4bccd791fd603f359db168b51a52ab66" href="/integrations/screaming-frog">
    Configure Bright Data proxies in Screaming Frog SEO Spider.
  </Card>

  <Card title="WebHarvy" icon="https://mintcdn.com/brightdata/z2V3XghEDR2bikNt/images/integrations/webharvy_int1.png?fit=max&auto=format&n=z2V3XghEDR2bikNt&q=85&s=62db6315e7b913f1caf09b96a107686a" href="/integrations/webharvy">
    Use Bright Data proxies with WebHarvy visual scraping software.
  </Card>

  <Card title="Web Scraper" icon="https://mintcdn.com/brightdata/z2V3XghEDR2bikNt/images/integrations/webscraperio_integration1.png?fit=max&auto=format&n=z2V3XghEDR2bikNt&q=85&s=de5da1bd48181bf07c429be1194de8b3" href="/integrations/webscraper">
    Connect the Web Scraper Chrome extension to Bright Data proxies.
  </Card>

  <Card title="Helium Scraper" icon="https://mintcdn.com/brightdata/pq7wn7mJJj8UJsym/images/integrations/helium-scraper1.png?fit=max&auto=format&n=pq7wn7mJJj8UJsym&q=85&s=1a4776cc1bac43a22bc25ab504f39dcf" href="/integrations/helium-scraper">
    Configure Bright Data proxies in Helium Scraper desktop app.
  </Card>

  <Card title="ChangeDetection" icon="bell" href="/integrations/changedetection">
    Monitor web page changes through Bright Data proxies with ChangeDetection.io.
  </Card>
</CardGroup>


# How to use Bright Data with Scrapy
Source: https://docs.brightdata.com/integrations/scrapy

Configure Bright Data proxies (port 44445) in Scrapy projects to crawl sites with geo-targeted, rotating IPs in anonymous, large-scale Python pipelines.

<Accordion title="Expand to get your Bright Data Proxy Access Information">
  ### Your proxy access information

  Bright Data proxies are grouped in "Proxy zones". Each zone holds the configuration for the proxies it holds.

  To get access to the proxy zone:

  1. Login to Bright Data control panel
  2. Select the proxy zone or setup a new one
  3. Click on the new zone name, and select the **Overview** tab.
  4. In the overview tab, under **Access details** you can find the proxy access details, and copy them to clipboard on click.
  5. You will need: Proxy Host, Proxy Port, Proxy Zone username and Proxy Zone password.
  6. Click on the copy icons to copy the text to your clipboard and paste in your tool's proxy configuration.

  ### Access Details Section Example

  <img alt="" />

  ### Residential proxy access

  To access Bright Data's **Residential Proxies** you must be a KYC-verified business account. Complete KYC verification with the Bright Data compliance team; there is no automatic or no-KYC path. Without KYC, use ISP or Datacenter proxies. [Read more...](/proxy-networks/residential/network-access)

  ### Targeting search engines?

  If you target a search engine like google, bing or yandex, you need a special Search Engine Results Page (**SERP**) proxy API. Use Bright Data SERP API to target search engines.
  [Click here to read more about Bright Data SERP proxy API.](/scraping-automation/serp-api/introduction)

  ### Correct setup of proxy test to avoid "PROXY ERROR"

  In many tools you will see a "test proxy" function, which performs a conncectivity test to your proxy, and some add a geolocation test as well, to identify the location of the proxy.
  To correctly test your proxy you should target those search queries to:
  `https://geo.brdtest.com/welcome.txt` .

  Some tools use popular search engines (like google.com) as a default test target. Bright Data will block those requests and you tool will show **proxy error** although your proxy is perfectly fine.

  If your proxy test fails, this is probably the reason. Make sure that your test domain is not a search engine (this is done in the tool configuration, and not controlled by Bright Data).
</Accordion>

## What is Scrapy?

Scrapy is a powerful Python-based framework for web scraping and data extraction. Designed for speed and scalability, Scrapy helps developers crawl websites and collect structured data efficiently. By integrating Bright Data proxies into Scrapy, you can enhance your scraping tasks with secure, anonymous, and geo-targeted connections.

## Why Use Bright Data with Scrapy?

* **Enhanced Privacy**: Mask your IP to stay anonymous while scraping.

* **Geo-Targeted Data Access**: Use Bright Data’s country-specific proxies to gather data from different regions.

* **Improved Reliability**: Reduce the risk of detection or being blocked by distributing requests across Bright Data proxies.

## How to Set Up and Start a Scrapy Project

**Step 0. Prerequisites**

Before you begin, ensure you have:

1. **Python Installed**:

   * Download and install the latest version from [python.org](https://www.python.org/).

2. **Scrapy Installed**: Run the following command in your terminal to install Scrapy:

   ```bash theme={null}
   pip install scrapy
   ```

3. **Bright Data Proxy Credentials**:

   * Log in to your [Bright Data dashboard](https://brightdata.com/cp/zones/page/plans) and retrieve your proxy details (Host, Port, Username, and Password).
   * For region-specific proxies, modify your username using the format `your-username-country-XX` (e.g., `your-username-country-US` for a US proxy).

**Step 1. Create or Open Your Scrapy Project**

1. If you don’t have a Scrapy project, create one by running:

   ```bash theme={null}
   scrapy startproject myproject
   ```

   Replace "myproject" with a name that reflects the purpose of your project, such as "brightdata\_test" or "web\_scraper".

2. Navigate to your project folder:

   ```bash theme={null}
   cd myproject
   ```

**Step 2. Generate a Spider**

1. Use Scrapy’s command to create a spider:

   ```bash theme={null}
   scrapy genspider <spider_name> <target_url>
   ```

   For example, to scrape [httpbin.org/ip](http://httpbin.org/ip), you can run:

   ```bash theme={null}
   scrapy genspider BrightDataExample http://httpbin.org/ip
   ```

2. This generates a basic spider template located in the `spiders/` directory of your project. It looks something like this:

   ```python theme={null}
   import scrapy

   class BrightDataExampleSpider(scrapy.Spider):
   name = "BrightDataExample"
   allowed_domains = ["httpbin.org/ip"]
   start_urls = ["http://httpbin.org/ip"]

   def parse(self, response):
       pass
   ```

**Step 3. Configure Bright Data Proxies**

1. Open the generated spider file in a text editor (`spiders/BrightDataExample.py`) and update it to include Bright Data proxy settings. Here’s an example:

   ```python theme={null}
   import scrapy

   class BrightDataExampleSpider(scrapy.Spider):
       name = "BrightDataExample"
       start_urls = ['http://httpbin.org/ip']

       def start_requests(self):
           # Define the Bright Data proxy
           proxy = "http://[USERNAME]:[PASSWORD]@[HOST]:[PORT]"  # Replace with your Bright Data proxy details

           # Use the proxy for all requests
           for url in self.start_urls:
               yield scrapy.Request(url, meta={'proxy': proxy})

       def parse(self, response):
           # Parse and return the IP address
           yield {
               'proxy_ip': response.text
           }
   ```

2. Replace \[USERNAME], \[PASSWORD], \[HOST], and \[PORT] with your Bright Data credentials. If you need a country-specific proxy, modify the username (e.g., `your-username-country-US`).

**Step 4. Run Your Scrapy Spider**

1. Navigate to the project directory in your terminal:

   ```bash theme={null}
   cd myproject
   ```

2. Run the spider:

   ```bash theme={null}
   scrapy crawl BrightDataExample
   ```

3. To save the output to a file, use:

   ```bash theme={null}
   scrapy crawl BrightDataExample -o output.json
   ```

**Step 5. Verify the Output**

1. If everything is configured correctly, the spider will display the IP address of the Bright Data proxy it’s using. Example output:

   ```json theme={null}
   [
       {
           "proxy_ip": "{\n  \"origin\": \"123.45.67.89\"\n}"
       }
   ]
   ```

2. Open the output.json file (if you used the -o flag) to review the scraped data.

With **Bright Data** proxies integrated into **Scrapy**, your web scraping tasks become more secure, private, and efficient. Whether you’re collecting geo-specific data, managing high-volume scraping jobs, or avoiding detection, Bright Data provides the stability and anonymity you need. Start scraping smarter with Bright Data and Scrapy today!


# Set up Bright Data with Screaming Frog
Source: https://docs.brightdata.com/integrations/screaming-frog

Configure Bright Data proxies in Screaming Frog SEO Spider to route crawls through residential, datacenter, ISP, or mobile IPs at scale. Spans 195 countries.

<Accordion title="Expand to get your Bright Data Proxy Access Information">
  ### Your proxy access information

  Bright Data proxies are grouped in "Proxy zones". Each zone holds the configuration for the proxies it holds.

  To get access to the proxy zone:

  1. Login to Bright Data control panel
  2. Select the proxy zone or setup a new one
  3. Click on the new zone name, and select the **Overview** tab.
  4. In the overview tab, under **Access details** you can find the proxy access details, and copy them to clipboard on click.
  5. You will need: Proxy Host, Proxy Port, Proxy Zone username and Proxy Zone password.
  6. Click on the copy icons to copy the text to your clipboard and paste in your tool's proxy configuration.

  ### Access Details Section Example

  <img alt="" />

  ### Residential proxy access

  To access Bright Data's **Residential Proxies** you must be a KYC-verified business account. Complete KYC verification with the Bright Data compliance team; there is no automatic or no-KYC path. Without KYC, use ISP or Datacenter proxies. [Read more...](/proxy-networks/residential/network-access)

  ### Targeting search engines?

  If you target a search engine like google, bing or yandex, you need a special Search Engine Results Page (**SERP**) proxy API. Use Bright Data SERP API to target search engines.
  [Click here to read more about Bright Data SERP proxy API.](/scraping-automation/serp-api/introduction)

  ### Correct setup of proxy test to avoid "PROXY ERROR"

  In many tools you will see a "test proxy" function, which performs a conncectivity test to your proxy, and some add a geolocation test as well, to identify the location of the proxy.
  To correctly test your proxy you should target those search queries to:
  `https://geo.brdtest.com/welcome.txt` .

  Some tools use popular search engines (like google.com) as a default test target. Bright Data will block those requests and you tool will show **proxy error** although your proxy is perfectly fine.

  If your proxy test fails, this is probably the reason. Make sure that your test domain is not a search engine (this is done in the tool configuration, and not controlled by Bright Data).
</Accordion>

## What is Screaming Frog?

**Screaming Frog SEO Spider** is a versatile tool for SEO professionals and website managers. It helps audit websites, identify technical issues, and optimize performance by generating actionable insights. Combining Screaming Frog with **Bright Data** allows you to conduct secure, unrestricted, and geo-specific crawls, ensuring seamless SEO analysis.

## How to Set Up Bright Data With Screaming Frog

**Step 1. Download and Install Screaming Frog**

1. Visit the official [Screaming Frog website](https://www.screamingfrog.co.uk/seo-spider/).
2. Download and install the SEO Spider tool compatible with your operating system.
3. Launch the application once the installation is complete.

**Step 2. Access Proxy Settings**

1. In Screaming Frog, click on **File** in the top menu.
2. Select **Settings > Proxy** to open the proxy configuration window.

<Frame>
  <img alt="How to Set Up Bright Data With Screaming Frog" />
</Frame>

**Step 3. Enter Your Bright Data Proxy Details**

1. In the **Proxy** window, check **Use Proxy Server** to enable proxy usage.
2. If required, check **Use Proxy Credentials** and provide your login details.
3. Fill in the required proxy fields as follows:
   * **Address**: Input `http://brd.superproxy.io/`.
   * **Port**: Enter the port number found in your [Bright Data dashboard](https://brightdata.com/cp/zones/page/plans).
   * **Username**: Provide your Bright Data username.
   * **Password**: Enter your Bright Data password.
4. Once all details are entered, click **OK and Restart** to save your proxy settings.

<Note>
  For geo-specific proxies, append the country code to your username (e.g., `your-username-country-US`) to use a specific exit location.
</Note>

Your Bright Data proxies are now integrated with Screaming Frog, enabling more secure and efficient web crawling. With this setup, you can bypass restrictions, avoid IP blocks, and conduct geo-specific audits to enhance your SEO tasks effortlessly.


# How to set up Bright Data with SessionBox
Source: https://docs.brightdata.com/integrations/sessionbox

Configure Bright Data proxies (port 44445) in SessionBox to route multi-session browsing through residential, datacenter, ISP or mobile IPs for collection.

<Warning>
  **Account management is not a supported use case** on the Bright Data platform as of April 1, 2026. This includes managing accounts on platforms like TikTok, Instagram, or similar services. Bright Data proxies cannot be used for this purpose. See [Acceptable Use Policy](https://brightdata.com/acceptable-use-policy) for details.
</Warning>

<Accordion title="Expand to get your Bright Data Proxy Access Information">
  ### Your proxy access information

  Bright Data proxies are grouped in "Proxy zones". Each zone holds the configuration for the proxies it holds.

  To get access to the proxy zone:

  1. Login to Bright Data control panel
  2. Select the proxy zone or setup a new one
  3. Click on the new zone name, and select the **Overview** tab.
  4. In the overview tab, under **Access details** you can find the proxy access details, and copy them to clipboard on click.
  5. You will need: Proxy Host, Proxy Port, Proxy Zone username and Proxy Zone password.
  6. Click on the copy icons to copy the text to your clipboard and paste in your tool's proxy configuration.

  ### Access Details Section Example

  <img alt="" />

  ### Residential proxy access

  To access Bright Data's **Residential Proxies** you must be a KYC-verified business account. Complete KYC verification with the Bright Data compliance team; there is no automatic or no-KYC path. Without KYC, use ISP or Datacenter proxies. [Read more...](/proxy-networks/residential/network-access)

  ### Targeting search engines?

  If you target a search engine like google, bing or yandex, you need a special Search Engine Results Page (**SERP**) proxy API. Use Bright Data SERP API to target search engines.
  [Click here to read more about Bright Data SERP proxy API.](/scraping-automation/serp-api/introduction)

  ### Correct setup of proxy test to avoid "PROXY ERROR"

  In many tools you will see a "test proxy" function, which performs a conncectivity test to your proxy, and some add a geolocation test as well, to identify the location of the proxy.
  To correctly test your proxy you should target those search queries to:
  `https://geo.brdtest.com/welcome.txt` .

  Some tools use popular search engines (like google.com) as a default test target. Bright Data will block those requests and you tool will show **proxy error** although your proxy is perfectly fine.

  If your proxy test fails, this is probably the reason. Make sure that your test domain is not a search engine (this is done in the tool configuration, and not controlled by Bright Data).
</Accordion>

## What is SessionBox?

SessionBox is a browser extension that lets you manage multiple browser sessions at once. With SessionBox, you can log into several accounts on the same website without any conflicts, each tab runs as a separate, isolated session. It keeps cookies, cache, and login credentials contained within individual tabs, offering a simple yet effective solution for managing multiple browser sessions.

SessionBox focuses on simplicity and browser-native functionality, making it an ideal choice for lightweight tasks such as web scraping, data collection, and other straightforward online research activities.

<Tip>
  Maintain a consistent IP throughout your browser session by using the `-session` parameter in your username. This is essential because BrightData proxies default to rotating IPs with each request. [Learn more](/proxy-networks/faqs#how-to-use-the-same-ip-for-an-extended-period-of-time-and-how-long-can-i-keep-it-long-session) <br />

  New users should begin with ISP or Datacenter proxies, which need no KYC. Residential proxies require a [KYC-verified business account](/proxy-networks/residential/network-access).<br />
</Tip>

## SessionBox Proxy Integration

Follow these easy steps to integrate Bright Data proxies with SessionBox:

**Step 1. Install SessionBox.**\
Download and install the [SessionBox extension](https://chrome.google.com/webstore/detail/sessionbox-multi-login-to/megbklhjamjbcafknkgmokldgolkdfig) for Chrome.

**Step 2. Access Settings.**\
Click the **SessionBox icon** in your browser toolbar, then click the **three horizontal lines** to open the menu. Select **Settings**.

**Step 3. Add a Proxy.**\
Navigate to the **Proxy** tab within the settings and click **Add New** to create a new proxy profile.

<Frame>
  <img alt="SessionBox Proxy Integration" />
</Frame>

**Step 4. Configure Your Bright Data Proxy**.\
Fill in your Bright Data proxy details in the fields provided:

* **Address**: Enter `http://brd.superproxy.io/`.

* **Port**: Use the port number provided in your [Bright Data dashboard](https://brightdata.com/cp/zones/page/plans).

* **Username**: Enter your Bright Data proxy `username`.

* **Password**: Enter your Bright Data proxy `password`.

Click **Save** to store your proxy settings.

<Info>
  **For country-specific proxies, you can enter a format like `your-username-country-US` to receive a US exit node.**
</Info>

**Step 5. Create a New Session.**\
After adding the proxy, assign it to a new session:

1. Visit any website and open the SessionBox add-on.

2. Click the **New Stored Session** button to create a session.

**Step 6. Configure Proxy for the Session.**\
A new tab will open. To assign your proxy:

1. Open the add-on again.

2. Click the **three dots** next to the session and select **Settings**.

**Step 7. Enable the Proxy.**\
In the **Settings** menu, go to the **Other** tab. Under the **Proxy** section, select the proxy profile you created earlier.

**That’s it!** Your Bright Data proxies are now integrated with SessionBox.


# Set up Bright Data with Shadowrocket
Source: https://docs.brightdata.com/integrations/shadowrocket

Configure Bright Data proxies in Shadowrocket on iOS to route HTTP and SOCKS5 traffic through residential, datacenter, ISP, or mobile IPs.

<Accordion title="Expand to get your Bright Data Proxy Access Information">
  ### Your proxy access information

  Bright Data proxies are grouped in "Proxy zones". Each zone holds the configuration for the proxies it holds.

  To get access to the proxy zone:

  1. Login to Bright Data control panel
  2. Select the proxy zone or setup a new one
  3. Click on the new zone name, and select the **Overview** tab.
  4. In the overview tab, under **Access details** you can find the proxy access details, and copy them to clipboard on click.
  5. You will need: Proxy Host, Proxy Port, Proxy Zone username and Proxy Zone password.
  6. Click on the copy icons to copy the text to your clipboard and paste in your tool's proxy configuration.

  ### Access Details Section Example

  <img alt="" />

  ### Residential proxy access

  To access Bright Data's **Residential Proxies** you must be a KYC-verified business account. Complete KYC verification with the Bright Data compliance team; there is no automatic or no-KYC path. Without KYC, use ISP or Datacenter proxies. [Read more...](/proxy-networks/residential/network-access)

  ### Targeting search engines?

  If you target a search engine like google, bing or yandex, you need a special Search Engine Results Page (**SERP**) proxy API. Use Bright Data SERP API to target search engines.
  [Click here to read more about Bright Data SERP proxy API.](/scraping-automation/serp-api/introduction)

  ### Correct setup of proxy test to avoid "PROXY ERROR"

  In many tools you will see a "test proxy" function, which performs a conncectivity test to your proxy, and some add a geolocation test as well, to identify the location of the proxy.
  To correctly test your proxy you should target those search queries to:
  `https://geo.brdtest.com/welcome.txt` .

  Some tools use popular search engines (like google.com) as a default test target. Bright Data will block those requests and you tool will show **proxy error** although your proxy is perfectly fine.

  If your proxy test fails, this is probably the reason. Make sure that your test domain is not a search engine (this is done in the tool configuration, and not controlled by Bright Data).
</Accordion>

## What is Shadowrocket?

**Shadowrocket** is a powerful iOS app designed to route network traffic through proxies. It supports various proxy types, including HTTP, HTTPS, and SOCKS5, and is popular for its flexibility and ease of use, making it a favorite choice for secure browsing and data management.

<Warning>
  **Residential and Mobile proxies** require a KYC-verified business account. Shadowrocket does not support installing custom SSL certificates or bypassing SSL errors, and may use restricted HTTP methods (POST, PUT, DELETE) internally. Complete [KYC](https://brightdata.com/cp/kyc) before using Residential or Mobile proxies with Shadowrocket. Without KYC, use [ISP or Datacenter proxies](/proxy-networks/residential/network-access#what-can-i-use-without-kyc).
</Warning>

<Warning>
  **Account management is not a supported use case** on the Bright Data platform as of April 1, 2026. This includes managing accounts on platforms like TikTok, Instagram, or similar services. Bright Data proxies cannot be used for this purpose. See [Acceptable Use Policy](https://brightdata.com/acceptable-use-policy) for details.
</Warning>

<Tip>
  Maintain a consistent IP throughout your browser session by using the `-session` parameter in your username. This is essential because Bright Data proxies default to rotating IPs with each request. [Learn more](/proxy-networks/faqs#how-to-use-the-same-ip-for-an-extended-period-of-time-and-how-long-can-i-keep-it-long-session)

  New users should begin with ISP or Datacenter proxies for the best compatibility with Shadowrocket.
</Tip>

## How to Integrate Bright Data With Shadowrocket

### Step 1: Install Shadowrocket

1. Open the **App Store** on your iOS device.
2. Search for **Shadowrocket** and download the app.
3. Install the application and open it after installation.

### Step 2: Add a New Proxy Configuration

1. Open the **Shadowrocket** app.
2. Tap the **+** button in the top-right corner to add a new proxy.

### Step 3: Configure Proxy Settings

1. In the configuration window:
   * **Type**: Select HTTP, HTTPS, or SOCKS5 based on your proxy type.
   * **Server**: Enter `http://brd.superproxy.io/`.
   * **Port**: Use the port number provided in your [Bright Data dashboard](https://brightdata.com/cp/zones/page/plans).
   * **Username**: Input your Bright Data username.
   * **Password**: Input your Bright Data password.

2. Save the configuration by tapping **Done** or **Save** in the top-right corner.

### Step 4: Test Your Proxy

1. Go back to the main **Shadowrocket** screen.
2. Enable the proxy by toggling the switch next to your newly created configuration.
3. Open a browser or app and visit [httpbin.org/ip](http://httpbin.org/ip) to verify that the proxy is working correctly.

<Note>
  If you require proxies for specific locations, format your username as `your-username-country-XX` (e.g., `your-username-country-US`) to connect through a proxy from that region.
</Note>

### You're All Set!

Your Shadowrocket app is now integrated with Bright Data. Enjoy secure, private, and anonymous browsing, enhanced with flexible geo-targeting options and seamless performance.


# How to set up Bright Data with SMLogin
Source: https://docs.brightdata.com/integrations/smlogin

How to configure Bright Data proxies in SMLogin for secure multi-account management with anonymous browsing capabilities. Covers 195+ countries.

<Warning>
  **Account management is not a supported use case** on the Bright Data platform as of April 1, 2026. This includes managing accounts on platforms like TikTok, Instagram, or similar services. Bright Data proxies cannot be used for this purpose. See [Acceptable Use Policy](https://brightdata.com/acceptable-use-policy) for details.
</Warning>

<Accordion title="Expand to get your Bright Data Proxy Access Information">
  ### Your proxy access information

  Bright Data proxies are grouped in "Proxy zones". Each zone holds the configuration for the proxies it holds.

  To get access to the proxy zone:

  1. Login to Bright Data control panel
  2. Select the proxy zone or setup a new one
  3. Click on the new zone name, and select the **Overview** tab.
  4. In the overview tab, under **Access details** you can find the proxy access details, and copy them to clipboard on click.
  5. You will need: Proxy Host, Proxy Port, Proxy Zone username and Proxy Zone password.
  6. Click on the copy icons to copy the text to your clipboard and paste in your tool's proxy configuration.

  ### Access Details Section Example

  <img alt="" />

  ### Residential proxy access

  To access Bright Data's **Residential Proxies** you must be a KYC-verified business account. Complete KYC verification with the Bright Data compliance team; there is no automatic or no-KYC path. Without KYC, use ISP or Datacenter proxies. [Read more...](/proxy-networks/residential/network-access)

  ### Targeting search engines?

  If you target a search engine like google, bing or yandex, you need a special Search Engine Results Page (**SERP**) proxy API. Use Bright Data SERP API to target search engines.
  [Click here to read more about Bright Data SERP proxy API.](/scraping-automation/serp-api/introduction)

  ### Correct setup of proxy test to avoid "PROXY ERROR"

  In many tools you will see a "test proxy" function, which performs a conncectivity test to your proxy, and some add a geolocation test as well, to identify the location of the proxy.
  To correctly test your proxy you should target those search queries to:
  `https://geo.brdtest.com/welcome.txt` .

  Some tools use popular search engines (like google.com) as a default test target. Bright Data will block those requests and you tool will show **proxy error** although your proxy is perfectly fine.

  If your proxy test fails, this is probably the reason. Make sure that your test domain is not a search engine (this is done in the tool configuration, and not controlled by Bright Data).
</Accordion>

## What is SMLogin?

SMLOGIN, a cutting-edge anti-correlation fingerprint browser, offers a robust solution for users needing to operate multiple accounts across various platforms efficiently. By simulating real devices and providing a multi-account/multi-platform secure operation environment, SMLOGIN stands out for its ease of use, reduced resource consumption, and comprehensive security features.

Integrating SMLOGIN with Bright Data's proxies further amplifies these benefits, providing users with an unmatched level of anonymity, security, and flexibility in their online operations.

<Tip>
  Maintain a consistent IP throughout your browser session by using the `-session` parameter in your username. This is essential because BrightData proxies default to rotating IPs with each request. [Learn more](/proxy-networks/faqs#how-to-use-the-same-ip-for-an-extended-period-of-time-and-how-long-can-i-keep-it-long-session) <br />

  New users should begin with ISP or Datacenter proxies, which need no KYC. Residential proxies require a [KYC-verified business account](/proxy-networks/residential/network-access).<br />
</Tip>

## Benefits of Using Bright Data Proxies

The synergy between SMLOGIN and [Bright Data's proxy services](https://brightdata.com/proxy-types) brings forth an unparalleled solution for digital marketers, researchers, and data analysts. Here's why this combination is a game-changer:

* **Unmatched Global Network:** Bright Data offers access to a network of 400M+ monthly [real residential IPs worldwide](https://brightdata.com/proxy-types/residential-proxies) across 195+ countries, covering data centers, residential areas, and mobile networks. This vast selection ensures SMLOGIN users can seamlessly manage accounts from any geographic location, crucial for tasks requiring specific regional access.
* **Superior Anonymity and Security**: Operating multiple accounts demands a high level of anonymity to prevent detection and potential bans. Bright Data's proxies provide robust security features that safeguard users' digital footprints, ensuring each SMLOGIN session remains undetectable and secure from prying eyes.
* **High-Speed Performance:** Speed is of the essence in today's fast-paced digital environment. Bright Data's efficient proxy servers guarantee minimal latency and fast loading times, enhancing SMLOGIN's performance and allowing for quicker operations across multiple accounts.
* **Cost-Effective and Resource-Efficient:** Compared to the high costs associated with cloud servers and virtual machines, Bright Data's proxy solutions offer a more economical and resource-efficient alternative for managing multiple accounts. This efficiency is particularly beneficial for users leveraging SMLOGIN for large-scale data collection and competitive intelligence.
* **Flexible and Scalable Solutions:** Bright Data's proxy services are designed to be highly flexible, catering to a [wide array of use cases](https://brightdata.com/use-cases) from web scraping and competitive analysis to affiliate marketing and market research. Whether you're managing a handful of profiles or thousands, Bright Data's infrastructure can scale to meet your needs without compromising on quality or security.
* **Easy Integration and Comprehensive Support:** Integrating Bright Data proxies with SMLOGIN is straightforward, ensuring users can quickly set up and start managing their accounts with enhanced anonymity and efficiency. Furthermore, Bright Data offers extensive documentation and dedicated support, assisting users in maximizing their use of proxies with SMLOGIN for optimal results.

By integrating SMLOGIN with Bright Data's proxy solutions, users unlock a potent combination for web data collection and market research, bolstered by unmatched security, global reach, and operational efficiency.

## SMLOGIN Proxy Integration

Follow this step-by-step guide to integrate our proxy services with SMLOGIN in a few minutes.

<Frame>
  <img alt="SMLOGIN Proxy Integration" />
</Frame>

### Register and Download SMLOGIN

Begin by registering for an account at [SMLOGIN's registration page](https://sys.smlogin.cc/#/passport/register).

Download the SMLOGIN application compatible with Windows 7 and above from SMLOGIN Downloads.

<Frame>
  <img alt="Register and Download SMLOGIN" />
</Frame>

### Installation and Account Login

Install the SMLOGIN application following the on-screen instructions.

Launch SMLOGIN and log into your account using your credentials.

<Frame>
  <img alt="Installation and Account Login" />
</Frame>

### Creating a New Profile

In the SMLOGIN dashboard, click on the “+ one-click new profiles” button to create a new browser profile.

<Frame>
  <img alt="Creating a New Profile" />
</Frame>

### Setting Up the Profile

Customize your new profile according to your preferences, including setting up browser fingerprints, screen resolution, and any other specifics relevant to your browsing or operational needs.

<Frame>
  <img alt="Setting Up the Profile" />
</Frame>

### Binding IP to the Profile

Once the profile setup is complete, it will appear on the dashboard. Next to the newly created profile, find and click the “Bind IP” option to proceed with configuring the proxy settings.

<Frame>
  <img alt="Binding IP to the Profile" />
</Frame>

### Configuring the Proxy

From the “Proxy Type” dropdown menu select “HTTP” for default Bright Data proxy use. If using Bright Data's Residential Proxies, you may also choose “Luminati (Residential)” from the dropdown list.

<Frame>
  <img alt="Configuring the Proxy" />
</Frame>

### Entering Proxy Details

Fill in the proxy details: Host, Port, Username, and Password.

* **Host**: Enter the proxy server address brd.superproxy.io
* **Port**: Specify the proxy port as 44445
* **Username**: Your Bright Data username
* **Password**: Your Bright Data password

<Frame>
  <img alt="Entering Proxy Details" />
</Frame>

### Verifying the Proxy Connection

Click on the “check proxy” button to test the connectivity. You should see your proxy IP and location details if the setup is successful.

<Frame>
  <img alt="Verifying the Proxy Connection" />
</Frame>

### Saving the Proxy Configuration

After confirming the proxy details are correct and the test is successful, click on “Save proxy” to finalize the proxy settings for the profile.

<Frame>
  <img alt="Saving the Proxy Configuration" />
</Frame>

### Launching the Profile

Open the profile you've just configured by clicking on it. Now, you're all set to browse the internet securely and efficiently, powered by Bright Data proxies.

<Warning>
  **Important note**:

  If you are using Bright Data’s Residential Proxies, Web Unlocker API or SERP API, you need to install an SSL certificate to enable end-to-end secure connections to your target website(s).

  This is a simple process, see [this guide](/general/account/ssl-certificate#installation-of-the-ssl-certificate) for instructions.
</Warning>


# Set up Bright Data with Sphere Browser
Source: https://docs.brightdata.com/integrations/sphere-browser

Configure Bright Data proxies in Sphere Browser to route multi-account browsing through residential, datacenter, ISP, or mobile IPs. Spans 195 countries.

<Warning>
  **Account management is not a supported use case** on the Bright Data platform as of April 1, 2026. This includes managing accounts on platforms like TikTok, Instagram, or similar services. Bright Data proxies cannot be used for this purpose. See [Acceptable Use Policy](https://brightdata.com/acceptable-use-policy) for details.
</Warning>

<Accordion title="Expand to get your Bright Data Proxy Access Information">
  ### Your proxy access information

  Bright Data proxies are grouped in "Proxy zones". Each zone holds the configuration for the proxies it holds.

  To get access to the proxy zone:

  1. Login to Bright Data control panel
  2. Select the proxy zone or setup a new one
  3. Click on the new zone name, and select the **Overview** tab.
  4. In the overview tab, under **Access details** you can find the proxy access details, and copy them to clipboard on click.
  5. You will need: Proxy Host, Proxy Port, Proxy Zone username and Proxy Zone password.
  6. Click on the copy icons to copy the text to your clipboard and paste in your tool's proxy configuration.

  ### Access Details Section Example

  <img alt="" />

  ### Residential proxy access

  To access Bright Data's **Residential Proxies** you must be a KYC-verified business account. Complete KYC verification with the Bright Data compliance team; there is no automatic or no-KYC path. Without KYC, use ISP or Datacenter proxies. [Read more...](/proxy-networks/residential/network-access)

  ### Targeting search engines?

  If you target a search engine like google, bing or yandex, you need a special Search Engine Results Page (**SERP**) proxy API. Use Bright Data SERP API to target search engines.
  [Click here to read more about Bright Data SERP proxy API.](/scraping-automation/serp-api/introduction)

  ### Correct setup of proxy test to avoid "PROXY ERROR"

  In many tools you will see a "test proxy" function, which performs a conncectivity test to your proxy, and some add a geolocation test as well, to identify the location of the proxy.
  To correctly test your proxy you should target those search queries to:
  `https://geo.brdtest.com/welcome.txt` .

  Some tools use popular search engines (like google.com) as a default test target. Bright Data will block those requests and you tool will show **proxy error** although your proxy is perfectly fine.

  If your proxy test fails, this is probably the reason. Make sure that your test domain is not a search engine (this is done in the tool configuration, and not controlled by Bright Data).
</Accordion>

## What is Sphere Browser?

**Sphere Browser** is an anti-detect browser designed for managing multiple accounts without risking detection. It allows users to create unique browser profiles with isolated fingerprints, making it an ideal tool for marketing professionals, researchers, and privacy enthusiasts. Integrating Bright Data with Sphere Browser enhances anonymity and unlocks geo-targeted capabilities.

<Tip>
  Maintain a consistent IP throughout your browser session by using the `-session` parameter in your username. This is essential because BrightData proxies default to rotating IPs with each request. [Learn more](/proxy-networks/faqs#how-to-use-the-same-ip-for-an-extended-period-of-time-and-how-long-can-i-keep-it-long-session) <br />

  New users should begin with ISP or Datacenter proxies, which need no KYC. Residential proxies require a [KYC-verified business account](/proxy-networks/residential/network-access).<br />
</Tip>

<Warning>
  Connections to the following social networks are not supported on Data Center and ISP proxy networks: Facebook, TikTok, Instagram, X (Twitter), LinkedIn, YouTube, Reddit, Pinterest, Snapchat, and Discord.
</Warning>

## How to Integrate Bright Data With Sphere Browser

**Step 1. Download and Install Sphere Browser**

1. Visit the [Sphere Browser website](https://linkensphere.info/en/#) and download the application.
2. Install the software on your device and log in with your account credentials.
3. Open Sphere Browser and click **Proxy** to begin configuring your setup.

<Frame>
  <img alt="How to Integrate Bright Data With Sphere Browser" />
</Frame>

**Step 2. Configure Proxy Settings**

1. In the profile creation window, provide a unique and descriptive name in the **Profile Name** field to identify your browser instance easily.
2. Go to your [Bright Data dashboard](https://brightdata.com/cp/zones) 
3. Under the **Overview** tab, in the **Access Details** section, compose in a text editor the connect string in the following format: `` host:port:username:password` ``
4. Return to Sphere Browser and paste the credentials into the appropriate field.
5. Click the **Create** button (icon with a checkmark) to save the proxy settings.

<Note>
  For geo-targeted proxies, format your username as `your-username-country-XX` (e.g., `your-username-country-US`) to select a specific location.
</Note>

**Step 3. Launch and Verify**

1. Locate the profile you just configured.
2. Click **Check Proxy** to ensure the connection is successful.

<Frame>
  <img alt="How to Integrate Bright Data With Sphere Browser" />
</Frame>

Integrating Bright Data with Sphere Browser ensures a secure and anonymous browsing experience tailored to your needs. Whether managing multiple accounts or exploring geo-restricted content, this setup gives you the privacy and flexibility you need. Start leveraging the power of Bright Data and Sphere Browser today!


# Set up Bright Data with SwitchyOmega
Source: https://docs.brightdata.com/integrations/switchyomega

Step-by-step guide to configuring Bright Data proxies in SwitchyOmega for browser-based proxy switching and rule-based traffic routing. Spans 195 countries.

<Accordion title="Expand to get your Bright Data Proxy Access Information">
  ### Your proxy access information

  Bright Data proxies are grouped in "Proxy zones". Each zone holds the configuration for the proxies it holds.

  To get access to the proxy zone:

  1. Login to Bright Data control panel
  2. Select the proxy zone or setup a new one
  3. Click on the new zone name, and select the **Overview** tab.
  4. In the overview tab, under **Access details** you can find the proxy access details, and copy them to clipboard on click.
  5. You will need: Proxy Host, Proxy Port, Proxy Zone username and Proxy Zone password.
  6. Click on the copy icons to copy the text to your clipboard and paste in your tool's proxy configuration.

  ### Access Details Section Example

  <img alt="" />

  ### Residential proxy access

  To access Bright Data's **Residential Proxies** you must be a KYC-verified business account. Complete KYC verification with the Bright Data compliance team; there is no automatic or no-KYC path. Without KYC, use ISP or Datacenter proxies. [Read more...](/proxy-networks/residential/network-access)

  ### Targeting search engines?

  If you target a search engine like google, bing or yandex, you need a special Search Engine Results Page (**SERP**) proxy API. Use Bright Data SERP API to target search engines.
  [Click here to read more about Bright Data SERP proxy API.](/scraping-automation/serp-api/introduction)

  ### Correct setup of proxy test to avoid "PROXY ERROR"

  In many tools you will see a "test proxy" function, which performs a conncectivity test to your proxy, and some add a geolocation test as well, to identify the location of the proxy.
  To correctly test your proxy you should target those search queries to:
  `https://geo.brdtest.com/welcome.txt` .

  Some tools use popular search engines (like google.com) as a default test target. Bright Data will block those requests and you tool will show **proxy error** although your proxy is perfectly fine.

  If your proxy test fails, this is probably the reason. Make sure that your test domain is not a search engine (this is done in the tool configuration, and not controlled by Bright Data).
</Accordion>

<Warning>
  **Account management is not a supported use case** on the Bright Data platform as of April 1, 2026. This includes managing accounts on platforms like TikTok, Instagram, or similar services. Bright Data proxies cannot be used for this purpose. See [Acceptable Use Policy](https://brightdata.com/acceptable-use-policy) for details.
</Warning>

## What is SwitchyOmega?

**SwitchyOmega** is a browser extension for Chrome and Firefox designed to make proxy management easy and efficient. Supporting HTTP, HTTPS, SOCKS4, and SOCKS5, it allows you to create custom rules, switch between proxies effortlessly, and enhance your online activities. Whether you're bypassing geo-restrictions, managing multiple accounts, or safeguarding your privacy, SwitchyOmega is an essential tool for flexible proxy configurations.

<Tip>
  Maintain a consistent IP throughout your browser session by using the `-session` parameter in your username. This is essential because BrightData proxies default to rotating IPs with each request. [Learn more](/proxy-networks/faqs#how-to-use-the-same-ip-for-an-extended-period-of-time-and-how-long-can-i-keep-it-long-session) <br />

  New users should begin with ISP or Datacenter proxies, which need no KYC. Residential proxies require a [KYC-verified business account](/proxy-networks/residential/network-access).
</Tip>

## How to Set Up Bright Data With SwitchyOmega

**Step 1. Install SwitchyOmega**

1. Visit the relevant extension page for your browser:
   * [Chrome Extension](https://chrome.google.com/webstore/detail/proxy-switchyomega/padekgcemlokbadohgkifijomclgjgif?hl=en)
   * [Firefox Add-on](https://addons.mozilla.org/en-US/firefox/addon/switchyomega)

2. Add SwitchyOmega to your browser. After installation, the SwitchyOmega icon will appear in your toolbar.

**Step 2. Create a New Proxy Profile**

1. Click the **SwitchyOmega icon** in your browser’s toolbar and select **Options** to open the settings page.

<Frame>
  <img alt="How to Set Up Bright Data With SwitchyOmega" />
</Frame>

2. On the settings page, click **New Profile**.

<Frame>
  <img alt="How to Set Up Bright Data With SwitchyOmega" />
</Frame>

3. Provide a descriptive name for your profile (e.g., “Bright Data Proxy”), select **Proxy Profile**, and click **Create** to save.

<Frame>
  <img alt="How to Set Up Bright Data With SwitchyOmega" />
</Frame>

**Step 3. Configure Bright Data Proxy Details**

1. Enter the following Bright Data proxy details in the profile configuration fields:

   * **Protocol**: Choose HTTP, HTTPS, or SOCKS5 based on your proxy type.
   * **Server**: Input `http://brd.superproxy.io/`.
   * **Port**: Enter the port number provided in your [Bright Data dashboard](https://brightdata.com/cp/zones/page/plans).

2. Click the **Lock** icon to add authentication credentials:

   * **Username**: Your Bright Data username.
   * **Password**: Your Bright Data password.

3. Click **Save Changes** to store the proxy configuration.

<Frame>
  <img alt="How to Set Up Bright Data With SwitchyOmega" />
</Frame>

<Note>
  For country-specific proxies, append the country code to your username (e.g., `your-username-country-US`) to select a specific location.
</Note>

**Step 4. Apply and Activate the Proxy**

1. Click **Apply Changes** to finalize your setup.

<Frame>
  <img alt="How to Set Up Bright Data With SwitchyOmega" />
</Frame>

2. To enable the proxy, select your configured profile from the SwitchyOmega dropdown menu in the browser toolbar.

<Frame>
  <img alt="How to Set Up Bright Data With SwitchyOmega" />
</Frame>

Your Bright Data proxies are now fully integrated with SwitchyOmega. Whether you're managing multiple accounts, browsing securely, or scraping data efficiently, this setup ensures flexibility and control over your proxy configurations.


# Testing integrations
Source: https://docs.brightdata.com/integrations/testing-integrations

Test and debug Bright Data proxy and API configurations using Postman and other API testing tools, with ready-made collections for every Bright Data endpoint.

<CardGroup>
  <Card title="Postman" icon="https://mintcdn.com/brightdata/z2V3XghEDR2bikNt/images/integrations/postman1.png?fit=max&auto=format&n=z2V3XghEDR2bikNt&q=85&s=f0bec662ba0b35a84d51ba9695873449" href="/integrations/postman">
    Test Bright Data API endpoints and proxy configurations using Postman collections.
  </Card>
</CardGroup>


# Set up Bright Data with Undetectable
Source: https://docs.brightdata.com/integrations/undetectable

Configure Bright Data proxies (400M+ IPs) in the Undetectable antidetect browser to manage multiple profiles with isolated fingerprints and geo-targeted exits.

<Warning>
  **Account management is not a supported use case** on the Bright Data platform as of April 1, 2026. This includes managing accounts on platforms like TikTok, Instagram, or similar services. Bright Data proxies cannot be used for this purpose. See [Acceptable Use Policy](https://brightdata.com/acceptable-use-policy) for details.
</Warning>

<Accordion title="Expand to get your Bright Data Proxy Access Information">
  ### Your proxy access information

  Bright Data proxies are grouped in "Proxy zones". Each zone holds the configuration for the proxies it holds.

  To get access to the proxy zone:

  1. Login to Bright Data control panel
  2. Select the proxy zone or setup a new one
  3. Click on the new zone name, and select the **Overview** tab.
  4. In the overview tab, under **Access details** you can find the proxy access details, and copy them to clipboard on click.
  5. You will need: Proxy Host, Proxy Port, Proxy Zone username and Proxy Zone password.
  6. Click on the copy icons to copy the text to your clipboard and paste in your tool's proxy configuration.

  ### Access Details Section Example

  <img alt="" />

  ### Residential proxy access

  To access Bright Data's **Residential Proxies** you must be a KYC-verified business account. Complete KYC verification with the Bright Data compliance team; there is no automatic or no-KYC path. Without KYC, use ISP or Datacenter proxies. [Read more...](/proxy-networks/residential/network-access)

  ### Targeting search engines?

  If you target a search engine like google, bing or yandex, you need a special Search Engine Results Page (**SERP**) proxy API. Use Bright Data SERP API to target search engines.
  [Click here to read more about Bright Data SERP proxy API.](/scraping-automation/serp-api/introduction)

  ### Correct setup of proxy test to avoid "PROXY ERROR"

  In many tools you will see a "test proxy" function, which performs a conncectivity test to your proxy, and some add a geolocation test as well, to identify the location of the proxy.
  To correctly test your proxy you should target those search queries to:
  `https://geo.brdtest.com/welcome.txt` .

  Some tools use popular search engines (like google.com) as a default test target. Bright Data will block those requests and you tool will show **proxy error** although your proxy is perfectly fine.

  If your proxy test fails, this is probably the reason. Make sure that your test domain is not a search engine (this is done in the tool configuration, and not controlled by Bright Data).
</Accordion>

## What is Undetectable?

Undetectable is an anti-detect browser that enables secure and anonymous browsing by creating multiple browser profiles with unique digital fingerprints. It's perfect for web scraping, data collection, and other activities requiring privacy and security.

<Tip>
  Maintain a consistent IP throughout your browser session by using the `-session` parameter in your username. This is essential because BrightData proxies default to rotating IPs with each request. [Learn more](/proxy-networks/faqs#how-to-use-the-same-ip-for-an-extended-period-of-time-and-how-long-can-i-keep-it-long-session) <br />

  New users should begin with ISP or Datacenter proxies, which need no KYC. Residential proxies require a [KYC-verified business account](/proxy-networks/residential/network-access).<br />
</Tip>

## How to Integrate Bright Data With Undetectable

**Step 1. Download and Log In to Undetectable**

1. Visit the [Undetectable website](https://undetectable.io/) and download the application.
2. Install the software on your system and log in using your credentials.

**Step 2. Access Proxy Configuration**

1. Open Undetectable and go to the **Proxy** tab.

<Frame>
  <img alt="How to Integrate Bright Data With Undetectable" />
</Frame>

2. Click on the **Plus** button to add a new proxy.

<Frame>
  <img alt="How to Integrate Bright Data With Undetectable" />
</Frame>

**Step 3. Configure Bright Data Proxy Details**

1. In the proxy setup window:

* Provide a descriptive name in the **Proxy Name** field for easy identification.
* **Type**: Select HTTP or SOCKS5.
* **Host**: `http://brd.superproxy.io/`.
* **Port**: The port number from your [Bright Data dashboard](https://brightdata.com/cp/zones/page/plans).
* **Login**: Your Bright Data username.
* **Password**: Your Bright Data password.

2. Click **Check** to verify the connection.
3. Once verified, click **Save Proxy** to store your proxy settings.

<Note>
  For geo-targeted proxies, format your username as `your-username-country-XX` (e.g., `your-username-country-US`) to select a specific location.
</Note>

With your Bright Data successfully integrated into Undetectable, you’re now ready to browse securely and anonymously. Enjoy enhanced privacy and seamless operations!


# How to set up Bright Data with VMLogin
Source: https://docs.brightdata.com/integrations/vmlogin

Integrate Bright Data (400M+ residential IPs) with VMLogin for secure, anonymous browsing and efficient profile management with reduced detection risk.

<Warning>
  **Account management is not a supported use case** on the Bright Data platform as of April 1, 2026. This includes managing accounts on platforms like TikTok, Instagram, or similar services. Bright Data proxies cannot be used for this purpose. See [Acceptable Use Policy](https://brightdata.com/acceptable-use-policy) for details.
</Warning>

<Accordion title="Expand to get your Bright Data Proxy Access Information">
  ### Your proxy access information

  Bright Data proxies are grouped in "Proxy zones". Each zone holds the configuration for the proxies it holds.

  To get access to the proxy zone:

  1. Login to Bright Data control panel
  2. Select the proxy zone or setup a new one
  3. Click on the new zone name, and select the **Overview** tab.
  4. In the overview tab, under **Access details** you can find the proxy access details, and copy them to clipboard on click.
  5. You will need: Proxy Host, Proxy Port, Proxy Zone username and Proxy Zone password.
  6. Click on the copy icons to copy the text to your clipboard and paste in your tool's proxy configuration.

  ### Access Details Section Example

  <img alt="" />

  ### Residential proxy access

  To access Bright Data's **Residential Proxies** you must be a KYC-verified business account. Complete KYC verification with the Bright Data compliance team; there is no automatic or no-KYC path. Without KYC, use ISP or Datacenter proxies. [Read more...](/proxy-networks/residential/network-access)

  ### Targeting search engines?

  If you target a search engine like google, bing or yandex, you need a special Search Engine Results Page (**SERP**) proxy API. Use Bright Data SERP API to target search engines.
  [Click here to read more about Bright Data SERP proxy API.](/scraping-automation/serp-api/introduction)

  ### Correct setup of proxy test to avoid "PROXY ERROR"

  In many tools you will see a "test proxy" function, which performs a conncectivity test to your proxy, and some add a geolocation test as well, to identify the location of the proxy.
  To correctly test your proxy you should target those search queries to:
  `https://geo.brdtest.com/welcome.txt` .

  Some tools use popular search engines (like google.com) as a default test target. Bright Data will block those requests and you tool will show **proxy error** although your proxy is perfectly fine.

  If your proxy test fails, this is probably the reason. Make sure that your test domain is not a search engine (this is done in the tool configuration, and not controlled by Bright Data).
</Accordion>

## What is VMLogin?

VMLogin is a powerful anti-detection browser designed to help you manage multiple online accounts securely without the risk of detection. By creating virtual browser profiles with unique digital fingerprints, VMLogin ensures that websites treat each profile as a distinct, unrelated user.

VMLogin is perfect for industries that require high levels of anonymity and flexibility, such as market research, competitive intelligence, and web scraping. With robust anti-detection features and user-friendly tools, it’s an excellent choice for both teams and solo professionals looking for safe, efficient browser profile management.

<Tip>
  Maintain a consistent IP throughout your browser session by using the `-session` parameter in your username. This is essential because BrightData proxies default to rotating IPs with each request. [Learn more](/proxy-networks/faqs#how-to-use-the-same-ip-for-an-extended-period-of-time-and-how-long-can-i-keep-it-long-session) <br />

  New users should begin with ISP or Datacenter proxies, which need no KYC. Residential proxies require a [KYC-verified business account](/proxy-networks/residential/network-access).<br />
</Tip>

## VMLogin Proxy Integration

Follow these steps to set up Bright Data proxies in VMLogin:

**Step 1. Install** **VMLogin**\
Download and install [VMLogin](https://www.vmlogin.us/download.html). Launch the application and log in to your account.

**Step 2. Create a New Browser Profiles**\
From the main menu, click on the **New browser profile** button to open the setup page.

<Frame>
  <img alt="VMLogin Proxy Integration" />
</Frame>

**Step 3. Set Up the Profile**\
Enter a name for the browser profile in the **Display name** field. Next, click on the **Setting proxy server** button to configure your proxy settings.

<Frame>
  <img alt="VMLogin Proxy Integration" />
</Frame>

**Step 4. Configure Your Bright Data Proxy**\
Enable the **Proxy server** toggle and fill out the fields with your Bright Data proxy details:

* **Proxy type**: Choose from `HTTP`, `HTTPS`, or `SOCKS5` (based on your proxy type).
* **IP address**: Enter `http://brd.superproxy.io/`.
* **Port**: Use the port number provided in your [Bright Data dashboard](https://brightdata.com/cp/zones/page/plans).
* **Username**: Enter your Bright Data proxy `username`.
* **Password**: Enter your Bright Data proxy `password`.

<Info>
  **For country-specific proxies, you can enter a format like `your-username-country-US` to receive a US exit node.**
</Info>

**Step 5. Test Your Proxy**\
Click **Test Proxy** to test the connection. If the test is successful and displays detailed IP information, click **Confirm**. To finalize the proxy setup click **Save**.

**Step 6. Save the Profile**\
Once you’ve configured the proxy and set up other preferences, click the **Save profile** button to finalize your browser profile.

**That’s it!** You’ve successfully integrated your Bright Data proxy with VMLogin.


# How to set up Bright Data with WebHarvy
Source: https://docs.brightdata.com/integrations/webharvy

Configure Bright Data proxies in WebHarvy to route automated web scraping jobs through residential, datacenter, ISP, or mobile IPs. Spans 195 countries.

<Accordion title="Expand to get your Bright Data Proxy Access Information">
  ### Your proxy access information

  Bright Data proxies are grouped in "Proxy zones". Each zone holds the configuration for the proxies it holds.

  To get access to the proxy zone:

  1. Login to Bright Data control panel
  2. Select the proxy zone or setup a new one
  3. Click on the new zone name, and select the **Overview** tab.
  4. In the overview tab, under **Access details** you can find the proxy access details, and copy them to clipboard on click.
  5. You will need: Proxy Host, Proxy Port, Proxy Zone username and Proxy Zone password.
  6. Click on the copy icons to copy the text to your clipboard and paste in your tool's proxy configuration.

  ### Access Details Section Example

  <img alt="" />

  ### Residential proxy access

  To access Bright Data's **Residential Proxies** you must be a KYC-verified business account. Complete KYC verification with the Bright Data compliance team; there is no automatic or no-KYC path. Without KYC, use ISP or Datacenter proxies. [Read more...](/proxy-networks/residential/network-access)

  ### Targeting search engines?

  If you target a search engine like google, bing or yandex, you need a special Search Engine Results Page (**SERP**) proxy API. Use Bright Data SERP API to target search engines.
  [Click here to read more about Bright Data SERP proxy API.](/scraping-automation/serp-api/introduction)

  ### Correct setup of proxy test to avoid "PROXY ERROR"

  In many tools you will see a "test proxy" function, which performs a conncectivity test to your proxy, and some add a geolocation test as well, to identify the location of the proxy.
  To correctly test your proxy you should target those search queries to:
  `https://geo.brdtest.com/welcome.txt` .

  Some tools use popular search engines (like google.com) as a default test target. Bright Data will block those requests and you tool will show **proxy error** although your proxy is perfectly fine.

  If your proxy test fails, this is probably the reason. Make sure that your test domain is not a search engine (this is done in the tool configuration, and not controlled by Bright Data).
</Accordion>

## What is WebHarvy?

WebHarvy is a web scraping tool that can easily extract text, HTML, images, URLs, and emails from websites and save the extracted content in various formats. If you are running a large scraping operation, using one of the [proxy services](https://brightdata.com/proxy-types) Bright Data offers will help you increase the success rates and send a lot more concurrent requests to the same target.

## How to setup WebHarvy with Bright Data proxies:

* Download and install WebHarvy Web Scraper
* Go to Webharvy → Home tab → Settings → Proxy Settings

<Frame>
  <img alt="WebHarvy toolbar with home and settings options." />
</Frame>

* Sign up for Bright Data’s Proxy Network
* Go to your Bright Data dashboard
* In the **Integrate** **with Bright Data Proxy Network** section, select **With a crawler or a bot** option

<Frame>
  <img alt="webharvy_int1.png" />
</Frame>

* On the API Examples page, you will see the following details:
  * Proxy address, Port number, User name, and Password

<Frame>
  <img alt="Instructions for bot configuration with red arrows." />
</Frame>

* Go back to WebHarvy Proxy settings and paste the details from Bright Data to WebHarvy Proxy settings
* Click on the + button
* Click Apply

<Frame>
  <img alt="WebHarvy proxy settings configuration screen." />
</Frame>

<Note>
  **Please note**: Webharvy will use proxy servers only during mining. The configuration browser of Webharvy will not use this proxy server, so if you check the IP address within the configuration browser, it will still be the original IP of your computer. To make the configuration browser use the proxy server, you should set the proxy address directly in Windows.
</Note>

To **disable the proxy server**, you just need to **uncheck the Enable Network connection via Proxy server checkbox** at Webharvy → Home Menu → Settings → Proxy Settings Tab.

Alternatively, you can use our own data collection tool for a quicker and easier process.

<Warning>
  **Important note**:

  If you are using Bright Data’s Residential Proxies, Web Unlocker API or SERP API, you need to install an SSL certificate to enable end-to-end secure connections to your target website(s).

  This is a simple process, see [this guide](/general/account/ssl-certificate#installation-of-the-ssl-certificate) for instructions.
</Warning>


# Webscraper.io proxy integration
Source: https://docs.brightdata.com/integrations/webscraper

Integrate Bright Data proxies (400M+ IPs) with Webscraper.io to run no-code scraping jobs with geo-targeted IPs and reduced detection risk across sites.

<Accordion title="Expand to get your Bright Data Proxy Access Information">
  ### Your proxy access information

  Bright Data proxies are grouped in "Proxy zones". Each zone holds the configuration for the proxies it holds.

  To get access to the proxy zone:

  1. Login to Bright Data control panel
  2. Select the proxy zone or setup a new one
  3. Click on the new zone name, and select the **Overview** tab.
  4. In the overview tab, under **Access details** you can find the proxy access details, and copy them to clipboard on click.
  5. You will need: Proxy Host, Proxy Port, Proxy Zone username and Proxy Zone password.
  6. Click on the copy icons to copy the text to your clipboard and paste in your tool's proxy configuration.

  ### Access Details Section Example

  <img alt="" />

  ### Residential proxy access

  To access Bright Data's **Residential Proxies** you must be a KYC-verified business account. Complete KYC verification with the Bright Data compliance team; there is no automatic or no-KYC path. Without KYC, use ISP or Datacenter proxies. [Read more...](/proxy-networks/residential/network-access)

  ### Targeting search engines?

  If you target a search engine like google, bing or yandex, you need a special Search Engine Results Page (**SERP**) proxy API. Use Bright Data SERP API to target search engines.
  [Click here to read more about Bright Data SERP proxy API.](/scraping-automation/serp-api/introduction)

  ### Correct setup of proxy test to avoid "PROXY ERROR"

  In many tools you will see a "test proxy" function, which performs a conncectivity test to your proxy, and some add a geolocation test as well, to identify the location of the proxy.
  To correctly test your proxy you should target those search queries to:
  `https://geo.brdtest.com/welcome.txt` .

  Some tools use popular search engines (like google.com) as a default test target. Bright Data will block those requests and you tool will show **proxy error** although your proxy is perfectly fine.

  If your proxy test fails, this is probably the reason. Make sure that your test domain is not a search engine (this is done in the tool configuration, and not controlled by Bright Data).
</Accordion>

Webscraper.io extension and Webscraper.io Cloud can be your perfect tool for data extraction. With an easy point-and-click interface scraper gather website data in a few minutes.

With Webscraper.io Cloud, automate scraping tasks completely with scheduler, API, data parser, data export, and more.

## Getting started with Webscraper.io

1. Install Web Scraper browser extension via [Chrome Store](https://chrome.google.com/webstore/detail/web-scraper/jnhgnonknehpejjnehehllkliplmbmhn?hl=en)

2. Sign up for [Webscraper.io Cloud](https://cloud.webscraper.io/register?luminati)

3. Subscribe to [Scale](https://cloud.webscraper.io/subscription-manager?luminati) plan

4. Open “Proxy Manager” on the left-side toolbar

<Frame>
  <img alt="webscraperio_integration6.png" />
</Frame>

## Create a proxy in Bright Data

1. Go to your [Bright Data Dashboard](https://brightdata.com/cp/zones) and click **Add Zone**

2. Select a network type and press **Add Zone**

3. Back in your Bright Data dashboard, click a Zone name

4. Take note of your Zone username and password

5. Switch back to the Web Scraper Cloud Proxy Manager

6. Choose **Bright Data Proxy** as the designated Proxy Server

<Frame>
  <img alt="webscraperio_integration7.png" />
</Frame>

7. Input a custom name, the username, and password form Bright Data created zone.
   If needed, limit your proxy region by selecting a country in the drop-down menu.

<Frame>
  <img alt="webscraperio_integration5.png" />
</Frame>

8. Click **Add Proxy**

9. The custom proxy will now be listed down below

<Frame>
  <img alt="webscraperio_integration1.png" />
</Frame>

10. To use a proxy for a scraping job, go to “My Sitemaps” from the menu on the left side

<Frame>
  <img alt="webscraperio_integration4.png" />
</Frame>

11. Click **Details Page** next to the sitemap you want to scrape

<Frame>
  <img alt="webscraperio_integration2.png" />
</Frame>

12. From the **Proxy** drop-down menu select the created proxy and click **Scrape**

<Frame>
  <img alt="webscraperio_integration3.png" />
</Frame>

There you have it - Webscraper.io Cloud will run your scraper via Bright Data Proxy.
As easy as that!

### Webscraper.io is Not A Bright Data Product

Note: the webscraper.io is not Bright Data Scrapers utility - this article refers to the external Webscraper.io integration.&#x20;


# How to set up Bright Data on Windows
Source: https://docs.brightdata.com/integrations/windows

Configure Bright Data Datacenter, ISP and Residential proxies on Windows 10 or 11 to route browser and system traffic through geo-targeted IPs.

<Accordion title="Expand to get your Bright Data Proxy Access Information">
  ### Your proxy access information

  Bright Data proxies are grouped in "Proxy zones". Each zone holds the configuration for the proxies it holds.

  To get access to the proxy zone:

  1. Login to Bright Data control panel
  2. Select the proxy zone or setup a new one
  3. Click on the new zone name, and select the **Overview** tab.
  4. In the overview tab, under **Access details** you can find the proxy access details, and copy them to clipboard on click.
  5. You will need: Proxy Host, Proxy Port, Proxy Zone username and Proxy Zone password.
  6. Click on the copy icons to copy the text to your clipboard and paste in your tool's proxy configuration.

  ### Access Details Section Example

  <img alt="" />

  ### Residential proxy access

  To access Bright Data's **Residential Proxies** you must be a KYC-verified business account. Complete KYC verification with the Bright Data compliance team; there is no automatic or no-KYC path. Without KYC, use ISP or Datacenter proxies. [Read more...](/proxy-networks/residential/network-access)

  ### Targeting search engines?

  If you target a search engine like google, bing or yandex, you need a special Search Engine Results Page (**SERP**) proxy API. Use Bright Data SERP API to target search engines.
  [Click here to read more about Bright Data SERP proxy API.](/scraping-automation/serp-api/introduction)

  ### Correct setup of proxy test to avoid "PROXY ERROR"

  In many tools you will see a "test proxy" function, which performs a conncectivity test to your proxy, and some add a geolocation test as well, to identify the location of the proxy.
  To correctly test your proxy you should target those search queries to:
  `https://geo.brdtest.com/welcome.txt` .

  Some tools use popular search engines (like google.com) as a default test target. Bright Data will block those requests and you tool will show **proxy error** although your proxy is perfectly fine.

  If your proxy test fails, this is probably the reason. Make sure that your test domain is not a search engine (this is done in the tool configuration, and not controlled by Bright Data).
</Accordion>

<Warning>
  **Account management is not a supported use case** on the Bright Data platform as of April 1, 2026. This includes managing accounts on platforms like TikTok, Instagram, or similar services. Bright Data proxies cannot be used for this purpose. See [Acceptable Use Policy](https://brightdata.com/acceptable-use-policy) for details.
</Warning>

<Tip>
  Maintain a consistent IP throughout your browsing session by using the `-session` parameter in your username. Bright Data proxies rotate IPs by default.\
  [Learn more](/proxy-networks/faqs#how-to-use-the-same-ip-for-an-extended-period-of-time-and-how-long-can-i-keep-it-long-session)

  New users should begin with ISP or Datacenter proxies, which need no KYC. Residential proxies require a [KYC-verified business account](/proxy-networks/residential/network-access).
</Tip>

## Why Use Bright Data on Windows?

Configuring Bright Data on Windows allows you to:

* **Protect Your Privacy**: Mask your real IP address across browsers and applications
* **Access Geo-Restricted Content**: Route traffic through different countries or regions
* **System-Wide Proxy Support**: Apply proxy settings to all apps that follow Windows network configuration
* **Stable, Secure Connections**: Reduce detection risks during browsing or automation tasks

***

## Setting Up Bright Data Proxies on Windows

The proxy setup process is the same for **Windows 10 and Windows 11**. Follow the steps below to configure Bright Data at the system level.

### Step 1. Open Network & Internet Settings

1. Press **Windows + I** to open **Settings**.
2. Navigate to **Network & Internet**.

<Frame>
  <img alt="Step 1. Open Network & Internet Settings" />
</Frame>

***

### Step 2. Enable Automatic Detection

1. Select **Proxy** from the left-hand menu.
2. Under **Automatic proxy setup**, turn **Automatically detect settings** **On**.

<Frame>
  <img alt="Step 2. Enable Automatic Detection" />
</Frame>

***

### Step 3. Configure Manual Proxy Settings

1. Scroll down to **Manual proxy setup**.
2. Toggle **Use a proxy server** to **On**.
3. Enter the following values:

* **Address**: `brd.superproxy.io`
* **Port**: Use the port provided in your Bright Data dashboard

4. Click **Save** to apply the settings.

<Note>
  Windows does not store proxy usernames and passwords in system settings.\
  When prompted by a browser or application, enter your Bright Data **Username** and **Password** to authenticate.

  To maintain IP consistency or enable geo-targeting, append parameters to your username (for example, `-session-1` or `-country-US`).
</Note>

***

## Verify the Proxy Connection

After saving the settings:

1. Open a browser on your Windows device.
2. Visit:

[http://httpbin.org/ip](http://httpbin.org/ip)

3. Confirm that the displayed IP matches your Bright Data proxy.

***

## Best Practices

* Use **ISP or Datacenter proxies** for better stability on Windows
* Avoid frequently toggling proxy settings during active sessions
* Use one dedicated proxy per account for account-based workflows
* Keep Bright Data credentials secure
* Recheck proxy settings after Windows updates

***

## Conclusion

You’ve successfully configured **Bright Data on Windows**. Your system traffic is now routed through secure, anonymous proxy connections, enabling private browsing and geo-flexible access across applications. With Bright Data in place, you can work, browse, and automate confidently on Windows.


# How to use Bright Data with XLogin
Source: https://docs.brightdata.com/integrations/xlogin

Configure Bright Data proxies (400M+ IPs) in XLogin to assign isolated geo-targeted IPs to each antidetect browser profile for multi-account automation.

<Warning>
  **Account management is not a supported use case** on the Bright Data platform as of April 1, 2026. This includes managing accounts on platforms like TikTok, Instagram, or similar services. Bright Data proxies cannot be used for this purpose. See [Acceptable Use Policy](https://brightdata.com/acceptable-use-policy) for details.
</Warning>

<Accordion title="Expand to get your Bright Data Proxy Access Information">
  ### Your proxy access information

  Bright Data proxies are grouped in "Proxy zones". Each zone holds the configuration for the proxies it holds.

  To get access to the proxy zone:

  1. Login to Bright Data control panel
  2. Select the proxy zone or setup a new one
  3. Click on the new zone name, and select the **Overview** tab.
  4. In the overview tab, under **Access details** you can find the proxy access details, and copy them to clipboard on click.
  5. You will need: Proxy Host, Proxy Port, Proxy Zone username and Proxy Zone password.
  6. Click on the copy icons to copy the text to your clipboard and paste in your tool's proxy configuration.

  ### Access Details Section Example

  <img alt="" />

  ### Residential proxy access

  To access Bright Data's **Residential Proxies** you must be a KYC-verified business account. Complete KYC verification with the Bright Data compliance team; there is no automatic or no-KYC path. Without KYC, use ISP or Datacenter proxies. [Read more...](/proxy-networks/residential/network-access)

  ### Targeting search engines?

  If you target a search engine like google, bing or yandex, you need a special Search Engine Results Page (**SERP**) proxy API. Use Bright Data SERP API to target search engines.
  [Click here to read more about Bright Data SERP proxy API.](/scraping-automation/serp-api/introduction)

  ### Correct setup of proxy test to avoid "PROXY ERROR"

  In many tools you will see a "test proxy" function, which performs a conncectivity test to your proxy, and some add a geolocation test as well, to identify the location of the proxy.
  To correctly test your proxy you should target those search queries to:
  `https://geo.brdtest.com/welcome.txt` .

  Some tools use popular search engines (like google.com) as a default test target. Bright Data will block those requests and you tool will show **proxy error** although your proxy is perfectly fine.

  If your proxy test fails, this is probably the reason. Make sure that your test domain is not a search engine (this is done in the tool configuration, and not controlled by Bright Data).
</Accordion>

<Tip>
  Maintain a consistent IP throughout your browser session by using the `-session` parameter in your username. This is essential because BrightData proxies default to rotating IPs with each request. [Learn more](/proxy-networks/faqs#how-to-use-the-same-ip-for-an-extended-period-of-time-and-how-long-can-i-keep-it-long-session) <br />

  New users should begin with ISP or Datacenter proxies, which need no KYC. Residential proxies require a [KYC-verified business account](/proxy-networks/residential/network-access).<br />
</Tip>

## What is XLogin?

XLogin is a browser profile management tool designed to help you run multiple online accounts without them interfering with each other. Each profile acts like a separate, isolated browser environment, making it easier to handle tasks like web scraping, market research, and competitive intelligence. By integrating Bright Data proxies, you add an extra layer of privacy and reliability to every profile.

## Why Use Bright Data with XLogin?

Combining Bright Data proxies with XLogin gives you:

* **Enhanced Privacy**: Mask your real IP with secure, anonymous proxies.
* **Reduced Detection Risks**: Spread activities over different IPs to minimize bans or restrictions.
* **Stable Connections**: Access geo-specific content and maintain consistent, reliable sessions across multiple profiles.

## Prerequisites

Before you begin:

* **XLogin Account**: Sign up at [XLogin’s website](https://xlogin.us/) if you haven’t already.
* **Bright Data Proxy Credentials**: see instructions on the top of this page.&#x20;

## How to integrate XLogin step by step

**Step 1. Log In to XLogin**

1. Visit [XLogin](https://xlogin.us/) and enter your XLogin credentials.
2. Once inside the dashboard, you’ll see a list of browser profiles if you’ve created any before.

**Step 2. Create or Select a Browser Profile**

1. If you’re new to XLogin, click **"New browser profile"** (or a similar button) to set up a fresh browser profile.
2. If you already have profiles, choose one that you’d like to run through Bright Data proxies, then select **"Edit"** or **"Settings"** to access its configuration.

<Frame>
  <img alt="Step-by-Step Integration" />
</Frame>

**Step 3. Personalize and Configure Your Browser Profile**

First, type in a clear **“Display name”** for your browser profile so you’ll know exactly which one you’re working with. Then, hit the **“Setting proxy server”** button to open up the proxy configuration panel. If you can’t spot it, check advanced menus or peek at the XLogin documentation.

**Step 4. Enter Your Bright Data Proxy Details**

1. Select the correct protocol (`HTTP`, `HTTPS`, or `SOCKS5`) based on your Bright Data proxy type.

2. Fill in the required fields:
   * **Host**: Your Bright Data host (e.g., [`http://brd.superproxy.io/`).](http://brd.superproxy.io/\).)
   * **Port**: The port number provided by [Bright Data dashboard](https://brightdata.com/cp/zones).
   * **Username**: Your Bright Data proxy `username`.
   * **Password**: Your Bright Data proxy `password`.

3. Double-check for accuracy, typos or incorrect details will prevent successful connections.

<Note>
  Want a US-based exit node? Append `-country-US` to your username (e.g., `your-username-country-US`). This applies to other countries too, just swap the country code as needed.
</Note>

**Step 5. Save Your Settings**

Before completing the setup, click **"Test Proxy"** to verify that the connection is good. If everything checks out, select **"Save"** to finalize your configuration. Finally, ensure that the recorded details reflect your intended proxy settings.

**Step 6. Test the Proxy Connection**

1. Launch the updated browser profile.
2. Navigate to a site like [http://httpbin.org/ip](http://httpbin.org/ip).
3. Confirm that the displayed IP matches the Bright Data proxy’s IP, not your own. If it does, you’re all set.

By following these steps, you’ve successfully integrated **Bright Data** proxies into **XLogin**. You now have enhanced privacy, reduced detection risks, and more stable connections, allowing you to manage multiple profiles with greater confidence and efficiency. Enjoy a smoother, more secure browsing experience as you navigate your online tasks!